disagg_router.sh 4.52 KB
Newer Older
1
#!/bin/bash
2
# SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
3
# SPDX-License-Identifier: Apache-2.0
4
5
6
#
# Disaggregated serving with KV-aware routing: 2 prefill + 2 decode workers.
# GPUs: 4
7

8
9
10
11
12
set -e
trap 'echo Cleaning up...; kill 0' EXIT

SCRIPT_DIR="$(dirname "$(readlink -f "$0")")"
source "$SCRIPT_DIR/../../../common/launch_utils.sh"
13

14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# Parse command line arguments
ENABLE_OTEL=false
while [[ $# -gt 0 ]]; do
    case $1 in
        --enable-otel)
            ENABLE_OTEL=true
            shift
            ;;
        -h|--help)
            echo "Usage: $0 [OPTIONS]"
            echo "Options:"
            echo "  --enable-otel        Enable OpenTelemetry tracing"
            echo "  -h, --help           Show this help message"
            echo ""
            echo "Note: System metrics are enabled by default on ports:"
29
            echo "  8081-8082 (prefill workers), 8083-8084 (decode workers)"
30
31
32
33
34
35
36
37
38
39
40
            exit 0
            ;;
        *)
            echo "Unknown option: $1"
            echo "Use --help for usage information"
            exit 1
            ;;
    esac
done

# Enable tracing if requested
41
TRACE_ARGS=()
42
43
44
45
if [ "$ENABLE_OTEL" = true ]; then
    export DYN_LOGGING_JSONL=true
    export OTEL_EXPORT_ENABLED=1
    export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=${OTEL_EXPORTER_OTLP_TRACES_ENDPOINT:-http://localhost:4317}
46
    TRACE_ARGS+=(--enable-trace --otlp-traces-endpoint localhost:4317)
47
48
fi

49
50
MODEL="Qwen/Qwen3-0.6B"
HTTP_PORT="${DYN_HTTP_PORT:-8000}"
51
print_launch_banner "Launching Disaggregated + KV Routing (4 GPUs)" "$MODEL" "$HTTP_PORT"
52

53
54
# Start frontend with KV routing
# The frontend will automatically detect prefill workers and activate an internal prefill router
55
# No standalone prefill router needed - the frontend handles prefill routing internally
56
# dynamo.frontend accepts either --http-port flag or DYN_HTTP_PORT env var (defaults to 8000)
57
OTEL_SERVICE_NAME=dynamo-frontend \
58
python3 -m dynamo.frontend \
59
60
    --router-mode kv \
    --router-reset-states &
61

62
63
64
65
# NOTE: Each worker picks a random NCCL port (get_free_port) for torch.distributed.
# This has a TOCTOU race — the port can be grabbed before init_process_group binds it,
# causing sporadic EADDRINUSE.  Pass --nccl-port <unique_port> per worker to avoid this.

66
# run prefill worker
67
OTEL_SERVICE_NAME=dynamo-worker-prefill-1 DYN_SYSTEM_PORT=${DYN_SYSTEM_PORT1:-8081} \
68
python3 -m dynamo.sglang \
69
70
  --model-path Qwen/Qwen3-0.6B \
  --served-model-name Qwen/Qwen3-0.6B \
71
72
73
74
75
76
  --page-size 64 \
  --tp 1 \
  --trust-remote-code \
  --disaggregation-mode prefill \
  --host 0.0.0.0 \
  --kv-events-config '{"publisher":"zmq","topic":"kv-events","endpoint":"tcp://*:5557"}' \
77
  --disaggregation-transfer-backend nixl \
78
  --enable-metrics \
79
  --disable-piecewise-cuda-graph \
80
  "${TRACE_ARGS[@]}" &
81
82

# run prefill worker
83
OTEL_SERVICE_NAME=dynamo-worker-prefill-2 DYN_SYSTEM_PORT=${DYN_SYSTEM_PORT2:-8082} \
84
CUDA_VISIBLE_DEVICES=1 python3 -m dynamo.sglang \
85
86
  --model-path Qwen/Qwen3-0.6B \
  --served-model-name Qwen/Qwen3-0.6B \
87
88
89
90
91
92
  --page-size 64 \
  --tp 1 \
  --trust-remote-code \
  --disaggregation-mode prefill \
  --host 0.0.0.0 \
  --kv-events-config '{"publisher":"zmq","topic":"kv-events","endpoint":"tcp://*:5558"}' \
93
  --disaggregation-transfer-backend nixl \
94
  --enable-metrics \
95
  --disable-piecewise-cuda-graph \
96
  "${TRACE_ARGS[@]}" &
97
98

# run decode worker
99
OTEL_SERVICE_NAME=dynamo-worker-decode-1 DYN_SYSTEM_PORT=${DYN_SYSTEM_PORT3:-8083} \
100
CUDA_VISIBLE_DEVICES=3 python3 -m dynamo.sglang \
101
102
  --model-path Qwen/Qwen3-0.6B \
  --served-model-name Qwen/Qwen3-0.6B \
103
104
105
106
107
108
  --page-size 64 \
  --tp 1 \
  --trust-remote-code \
  --disaggregation-mode decode \
  --host 0.0.0.0 \
  --kv-events-config '{"publisher":"zmq","topic":"kv-events","endpoint":"tcp://*:5560"}' \
109
  --disaggregation-transfer-backend nixl \
110
  --enable-metrics \
111
  --disable-piecewise-cuda-graph \
112
  "${TRACE_ARGS[@]}" &
113
114

# run decode worker
115
OTEL_SERVICE_NAME=dynamo-worker-decode-2 DYN_SYSTEM_PORT=${DYN_SYSTEM_PORT4:-8084} \
116
CUDA_VISIBLE_DEVICES=2 python3 -m dynamo.sglang \
117
118
  --model-path Qwen/Qwen3-0.6B \
  --served-model-name Qwen/Qwen3-0.6B \
119
120
121
122
123
124
  --page-size 64 \
  --tp 1 \
  --trust-remote-code \
  --disaggregation-mode decode \
  --host 0.0.0.0 \
  --kv-events-config '{"publisher":"zmq","topic":"kv-events","endpoint":"tcp://*:5559"}' \
125
  --disaggregation-transfer-backend nixl \
126
  --enable-metrics \
127
  --disable-piecewise-cuda-graph \
128
129
130
  "${TRACE_ARGS[@]}" &

# Wait for any worker to exit (keeps script running)
131
132
# Exit on first worker failure; kill 0 in the EXIT trap tears down the rest
wait_any_exit