Skip to content

[TRTLLM-7964][infra] Set nixl to default cache transceiver backend #7926

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bo-nv merged 5 commits into from
Oct 19, 2025
Merged

[TRTLLM-7964][infra] Set nixl to default cache transceiver backend #7926

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
425df48
[TRTLLM-7964][infra] set nixl to default cache transceiver backend
bo-nv Oct 17, 2025
75b31f7
remove mooncake
bo-nv Oct 17, 2025
50f55ab
update docker images
bo-nv Oct 18, 2025
809292c
remove some changes
bo-nv Oct 18, 2025
dc72927
fix some changes
bo-nv Oct 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion cpp/tensorrt_llm/batch_manager/cacheTransceiver.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ std::unique_ptr<BaseCacheTransceiver> CacheTransceiverFactory::createCacheTransc
}
else
{
backendType = executor::CacheTransceiverConfig::BackendType::UCX;
backendType = executor::CacheTransceiverConfig::BackendType::NIXL;
}
}
cacheTransceiverConfig.value().setBackendType(backendType);
Expand Down
20 changes: 11 additions & 9 deletions docker/Dockerfile.multi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,17 @@ RUN if [ -f /etc/redhat-release ]; then \
grep "^Name:" METADATA; \
fi

# Install UCX first
COPY docker/common/install_ucx.sh install_ucx.sh
RUN bash ./install_ucx.sh && rm install_ucx.sh

# Install NIXL
COPY docker/common/install_nixl.sh install_nixl.sh
RUN bash ./install_nixl.sh && rm install_nixl.sh

# Install etcd
COPY docker/common/install_etcd.sh install_etcd.sh
RUN bash ./install_etcd.sh && rm install_etcd.sh
Comment on lines +94 to +104
Copy link
Collaborator

@MartinMarciniszyn MartinMarciniszyn Oct 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@bo-nv , the installation files should be copied in a COPY instruction and the installation should be consolidated into a single RUN command to reduce the number of layers. Also, please avoid copying these installation files in the tritondevel stage below.

Copy link
Collaborator Author

@bo-nv bo-nv Oct 30, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let me fix it in another PR.

Copy link
Collaborator

@MartinMarciniszyn MartinMarciniszyn Nov 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@bo-nv , do you have a PR up for that?

Copy link
Collaborator Author

@bo-nv bo-nv Nov 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@MartinMarciniszyn it has been fixed in 4de31be

Copy link
Collaborator

@MartinMarciniszyn MartinMarciniszyn Nov 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The COPY statements have been combined, but not the RUN statements. These still produce separate layers.

Copy link
Collaborator

@MartinMarciniszyn MartinMarciniszyn Nov 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have created #9077 to fix this. Could you please take that over? It remains to regenerate the docker images and to rerun CI.


FROM ${TRITON_IMAGE}:${TRITON_BASE_TAG} AS triton

Expand All @@ -111,15 +122,6 @@ COPY docker/common/install_triton.sh \

RUN bash ./install_triton.sh && rm install_triton.sh

# Install UCX first
RUN bash ./install_ucx.sh && rm install_ucx.sh

# Install NIXL
RUN bash ./install_nixl.sh && rm install_nixl.sh

# Install etcd
RUN bash ./install_etcd.sh && rm install_etcd.sh

FROM ${DEVEL_IMAGE} AS wheel
WORKDIR /src/tensorrt_llm
COPY benchmarks benchmarks
Expand Down
2 changes: 1 addition & 1 deletion docs/source/features/disagg-serving.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ cache_transceiver_config:
max_tokens_in_buffer: <int>
```

`backend` specifies the communication backend for transferring the kvCache, valid options include `DEFAULT`,`UCX`, `NIXL`, and `MPI`, the default backend is UCX.
`backend` specifies the communication backend for transferring the kvCache, valid options include `DEFAULT`,`UCX`, `NIXL`, and `MPI`, the default backend is NIXL.

`max_tokens_in_buffer` defines the buffer size for kvCache transfers, it is recommended to set this value greater than or equal to the maximum ISL (Input Sequence Length) of all requests for optimal performance.

Expand Down
3 changes: 3 additions & 0 deletions docs/source/installation/linux.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,9 @@
pip3 install torch==2.7.1 torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128

sudo apt-get -y install libopenmpi-dev

# Optional step: Only required for disagg-serving
sudo apt-get -y install libzmq3-dev
```

PyTorch CUDA 12.8 package is required for supporting NVIDIA Blackwell GPUs and SBSA platform. On prior GPUs or Linux x86_64 platform, this extra installation is not required.
Expand Down
2 changes: 1 addition & 1 deletion examples/disaggregated/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The `trtllm-serve` command supports the `extra-llm-config.yaml` parameter. In th

```yaml
cache_transceiver_config:
# KV cache transmission backend. Valid options include `DEFAULT` (i.e., UCX), `UCX`, `NIXL`.
# KV cache transmission backend. Valid options include `DEFAULT` (i.e., NIXL), `UCX`, `NIXL`.
backend: <str>
# KV cache buffer size. Set it ≥ the maximum ISL (Input Sequence Length) for best performance.
max_tokens_in_buffer: <int>
Expand Down
6 changes: 3 additions & 3 deletions tensorrt_llm/_torch/pyexecutor/kv_cache_transceiver.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,10 +38,10 @@ def create_kv_cache_transceiver(

if cache_transceiver_config.backend == BackendTypeCpp.DEFAULT:
# When cache_transceiver_config.backend is not set, fallback to env_vars settings
# UCX is the default backend
cache_transceiver_config.backend = BackendTypeCpp.UCX
# NIXL is the default backend
cache_transceiver_config.backend = BackendTypeCpp.NIXL
# Ordered by priority
env_vars = [("TRTLLM_USE_NIXL_KVCACHE", BackendTypeCpp.NIXL),
env_vars = [("TRTLLM_USE_UCX_KVCACHE", BackendTypeCpp.UCX),
("TRTLLM_USE_MPI_KVCACHE", BackendTypeCpp.MPI)]
for env_var, be_type in env_vars:
if getenv(env_var) == "1":
Expand Down
3 changes: 3 additions & 0 deletions tests/integration/defs/disaggregated/test_disaggregated.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -426,6 +426,9 @@ def run_disaggregated_test(example_dir,
config_file
]
else:
pytest.skip(
"https://nvbugs/5584607 Ray orchestrator is not supported with NIXL(DEFAULT) cache transceiver backend."
)
with open(config_file, 'r') as f:
config = yaml.safe_load(f)

Expand Down