Skip to content

Conversation

Superjomn
Copy link
Collaborator

@Superjomn Superjomn commented Oct 22, 2025

Cherry-pick from #8497

Summary by CodeRabbit

  • Chores
    • Optimized internal process communication mechanisms for distributed deployments, improving efficiency in multi-GPU environments.

Description

Test Coverage

PR Checklist

Please review the following before submitting your PR:

  • PR description clearly explains what and why. If using CodeRabbit's summary, please make sure it makes sense.

  • PR Follows TRT-LLM CODING GUIDELINES to the best of your knowledge.

  • Test cases are provided for new code paths (see test instructions)

  • Any new dependencies have been scanned for license and vulnerabilities

  • CODEOWNERS updated if ownership changes

  • Documentation updated as needed

  • The reviewers assigned automatically/manually are appropriate for the PR.

  • Please check this after reviewing the above items as appropriate for this PR.

GitHub Bot Help

/bot [-h] ['run', 'kill', 'skip', 'reuse-pipeline'] ...

Provide a user friendly way for developers to interact with a Jenkins server.

Run /bot [-h|--help] to print this help message.

See details below for each supported subcommand.

run [--reuse-test (optional)pipeline-id --disable-fail-fast --skip-test --stage-list "A10-PyTorch-1, xxx" --gpu-type "A30, H100_PCIe" --test-backend "pytorch, cpp" --add-multi-gpu-test --only-multi-gpu-test --disable-multi-gpu-test --post-merge --extra-stage "H100_PCIe-TensorRT-Post-Merge-1, xxx" --detailed-log --debug(experimental)]

Launch build/test pipelines. All previously running jobs will be killed.

--reuse-test (optional)pipeline-id (OPTIONAL) : Allow the new pipeline to reuse build artifacts and skip successful test stages from a specified pipeline or the last pipeline if no pipeline-id is indicated. If the Git commit ID has changed, this option will be always ignored. The DEFAULT behavior of the bot is to reuse build artifacts and successful test results from the last pipeline.

--disable-reuse-test (OPTIONAL) : Explicitly prevent the pipeline from reusing build artifacts and skipping successful test stages from a previous pipeline. Ensure that all builds and tests are run regardless of previous successes.

--disable-fail-fast (OPTIONAL) : Disable fail fast on build/tests/infra failures.

--skip-test (OPTIONAL) : Skip all test stages, but still run build stages, package stages and sanity check stages. Note: Does NOT update GitHub check status.

--stage-list "A10-PyTorch-1, xxx" (OPTIONAL) : Only run the specified test stages. Examples: "A10-PyTorch-1, xxx". Note: Does NOT update GitHub check status.

--gpu-type "A30, H100_PCIe" (OPTIONAL) : Only run the test stages on the specified GPU types. Examples: "A30, H100_PCIe". Note: Does NOT update GitHub check status.

--test-backend "pytorch, cpp" (OPTIONAL) : Skip test stages which don't match the specified backends. Only support [pytorch, cpp, tensorrt, triton]. Examples: "pytorch, cpp" (does not run test stages with tensorrt or triton backend). Note: Does NOT update GitHub pipeline status.

--only-multi-gpu-test (OPTIONAL) : Only run the multi-GPU tests. Note: Does NOT update GitHub check status.

--disable-multi-gpu-test (OPTIONAL) : Disable the multi-GPU tests. Note: Does NOT update GitHub check status.

--add-multi-gpu-test (OPTIONAL) : Force run the multi-GPU tests in addition to running L0 pre-merge pipeline.

--post-merge (OPTIONAL) : Run the L0 post-merge pipeline instead of the ordinary L0 pre-merge pipeline.

--extra-stage "H100_PCIe-TensorRT-Post-Merge-1, xxx" (OPTIONAL) : Run the ordinary L0 pre-merge pipeline and specified test stages. Examples: --extra-stage "H100_PCIe-TensorRT-Post-Merge-1, xxx".

--detailed-log (OPTIONAL) : Enable flushing out all logs to the Jenkins console. This will significantly increase the log volume and may slow down the job.

--debug (OPTIONAL) : Experimental feature. Enable access to the CI container for debugging purpose. Note: Specify exactly one stage in the stage-list parameter to access the appropriate container environment. Note: Does NOT update GitHub check status.

For guidance on mapping tests to stage names, see docs/source/reference/ci-overview.md
and the scripts/test_to_stage_mapping.py helper.

kill

kill

Kill all running builds associated with pull request.

skip

skip --comment COMMENT

Skip testing for latest commit on pull request. --comment "Reason for skipping build/test" is required. IMPORTANT NOTE: This is dangerous since lack of user care and validation can cause top of tree to break.

reuse-pipeline

reuse-pipeline

Reuse a previous pipeline to validate current commit. This action will also kill all currently running builds associated with the pull request. IMPORTANT NOTE: This is dangerous since lack of user care and validation can cause top of tree to break.

@Superjomn Superjomn requested a review from a team as a code owner October 22, 2025 10:58
@Superjomn Superjomn force-pushed the launch-uniq-addr2-rel branch from c7afb75 to aa01b9d Compare October 22, 2025 10:59
@Superjomn
Copy link
Collaborator Author

/bot run

@tensorrt-cicd
Copy link
Collaborator

PR_Github #22177 [ run ] triggered by Bot. Commit: aa01b9d

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Oct 22, 2025

📝 Walkthrough

Walkthrough

Replaces TCP port binding logic with Python-based IPC address generation stored in TLLM_SPAWN_PROXY_PROCESS_IPC_ADDR. Restricts address generation to MPI rank 0 (or when MPI rank is absent) with added conditional gating. Removes TCP port scanning loop and address formatting code while maintaining HMAC key creation.

Changes

Cohort / File(s) Change Summary
IPC Address Generation
tensorrt_llm/llmapi/trtllm-llmapi-launch
Replaces TCP port binding and scanning logic with unique IPC address generation via Python. Stores result in TLLM_SPAWN_PROXY_PROCESS_IPC_ADDR environment variable.
MPI Rank Gating
tensorrt_llm/llmapi/trtllm-llmapi-launch
Adds conditional check to only execute address generation on MPI rank 0 (or when mpi_rank is empty), with clarifying comment that IPC is localhost-only. Non-root MPI ranks skip proxy address function invocation.
HMAC Key Maintenance
tensorrt_llm/llmapi/trtllm-llmapi-launch
Preserves IPC HMAC key creation alongside new IPC address generation logic.

Sequence Diagram

sequenceDiagram
    participant Process as Launch Process
    participant MPI as MPI Rank Check
    participant IPC as IPC Generator
    participant Proxy as Proxy Process
    
    Process->>MPI: Determine MPI rank
    
    alt MPI Rank 0 or No MPI
        MPI->>IPC: Generate unique IPC address
        IPC->>IPC: Create HMAC key for IPC
        IPC->>Process: Export TLLM_SPAWN_PROXY_PROCESS_IPC_ADDR
        Process->>Proxy: Spawn with IPC configuration
    else Non-zero MPI Rank
        MPI->>Process: Skip address generation
        Note over Process: Non-root ranks do not export IPC address
    end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Description Check ⚠️ Warning The PR description fails to meet the required template structure. While the PR title appears to follow the correct format with a NVBugs ID and [fix] type indicator, the critical Description and Test Coverage sections are completely empty—containing only template placeholder comments with no substantive content. The author has marked the checklist as complete without actually addressing the individual items or filling in the required documentation sections. Given that the code changes are substantial (replacing TCP port binding with IPC address generation with high code review effort), the lack of explanation regarding what issue this solves and what tests cover these changes makes it impossible for reviewers to properly assess the PR. The author must complete the Description section to explain what the issue is and how the solution addresses it, and provide a Test Coverage section listing the relevant tests that safeguard the changes. Additionally, the individual PR Checklist items should be explicitly verified and addressed rather than just checking the final box. Since this is a cherry-pick from PR #8497, the description should clarify what was cherry-picked and why, especially given the high code review effort noted in the changes.
✅ Passed checks (2 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
Title Check ✅ Passed The PR title "[https://nvbugs/5569754][fix] trtllm llmapi launch port conflict" directly addresses the main change in the pull request. The changeset replaces TCP port binding logic with IPC address generation to resolve port conflicts in the trtllm-llmapi-launch component. The title clearly identifies the issue being fixed (port conflict), the component involved (trtllm llmapi launch), and includes the ticket reference and fix tag. It is specific, concise, and would allow a teammate reviewing the commit history to immediately understand that this change addresses a port conflict problem.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
tensorrt_llm/llmapi/trtllm-llmapi-launch (1)

26-33: Harden IPC endpoint generation; fix naming; drop OpenSSL dependency.

  • Current var/function names say “tcp/free_port” but we now use IPC. Rename for clarity.
  • Long TMPDIR paths on HPC can exceed Unix domain socket limits (~108 bytes), causing bind failures. Prefer a short, controllable directory (default /tmp) and shorter UUID form.
  • Avoid external dependency on openssl; use Python’s secrets.

Apply:

-function export_free_tcp_addr_for_spawn_proxy_process {
-    # Generate unique IPC address without importing tensorrt_llm to avoid MPI initialization conflicts
-    local free_port=$(python3 -c "import uuid, tempfile, os; print(f'ipc://{os.path.join(tempfile.gettempdir(), \"rpc_test_\" + str(uuid.uuid4()))}')")
-    export TLLM_SPAWN_PROXY_PROCESS_IPC_ADDR=$free_port
-    log_stderr "TLLM_SPAWN_PROXY_PROCESS_IPC_ADDR: $TLLM_SPAWN_PROXY_PROCESS_IPC_ADDR"
-
-    export TLLM_SPAWN_PROXY_PROCESS_IPC_HMAC_KEY=$(openssl rand -hex 32)
-}
+function export_ipc_addr_for_spawn_proxy_process {
+    # Generate unique IPC address without importing tensorrt_llm to avoid MPI init conflicts
+    # Use a short, controllable dir to avoid UNIX socket path length limits.
+    local ipc_addr
+    ipc_addr=$(python3 - <<'PY'
+import os, uuid
+dir = os.environ.get('TLLM_IPC_DIR', '/tmp')
+name = 'tllm_rpc_' + uuid.uuid4().hex  # shorter than str(uuid4)
+print(f'ipc://{os.path.join(dir, name)}')
+PY
+)
+    export TLLM_SPAWN_PROXY_PROCESS_IPC_ADDR="$ipc_addr"
+    log_stderr "TLLM_SPAWN_PROXY_PROCESS_IPC_ADDR: $TLLM_SPAWN_PROXY_PROCESS_IPC_ADDR"
+
+    # Generate HMAC key without external deps
+    export TLLM_SPAWN_PROXY_PROCESS_IPC_HMAC_KEY="$(python3 -c "import secrets; print(secrets.token_hex(32))")"
+}
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 09349cc and aa01b9d.

📒 Files selected for processing (1)
  • tensorrt_llm/llmapi/trtllm-llmapi-launch (2 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Pre-commit Check

Signed-off-by: Yan Chunwei <[email protected]>
@Superjomn Superjomn force-pushed the launch-uniq-addr2-rel branch from aa01b9d to b6e1f5e Compare October 22, 2025 14:04
@Superjomn
Copy link
Collaborator Author

/bot run

@tensorrt-cicd
Copy link
Collaborator

PR_Github #22190 [ run ] triggered by Bot. Commit: b6e1f5e

@tensorrt-cicd
Copy link
Collaborator

PR_Github #22177 [ run ] completed with state ABORTED. Commit: aa01b9d
LLM/release-1.1/L0_MergeRequest_PR #226 (Blue Ocean) completed with status: ABORTED

@tensorrt-cicd
Copy link
Collaborator

PR_Github #22190 [ run ] completed with state SUCCESS. Commit: b6e1f5e
/LLM/release-1.1/L0_MergeRequest_PR pipeline #230 completed with status: 'SUCCESS'
Pipeline passed with automatic retried tests. Check the rerun report for details.

@Superjomn Superjomn enabled auto-merge (squash) October 23, 2025 01:09
@Superjomn Superjomn changed the title [https://nvbugs/5569754][fix] trtllm-llmapi-launch port conflict [https://nvbugs/5569754][fix] trtllm llmapi launch port conflict Oct 23, 2025
@Superjomn Superjomn merged commit 0d929f8 into NVIDIA:release/1.1 Oct 23, 2025
6 of 9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants