Skip to content

Commit 6d42d08

Browse files
committed
update README in dashboard
1 parent 800832d commit 6d42d08

2 files changed

Lines changed: 31 additions & 4 deletions

File tree

dashboard/README.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,15 @@ All commands below run **on the GPU node**.
104104

105105
```bash
106106
cd backend/
107-
./redis-7.2.7/src/redis-server --daemonize yes --bind 127.0.0.1
107+
export LC_ALL=C
108+
mkdir -p tmp/redis
109+
./redis-7.2.7/src/redis-server \
110+
--daemonize yes \
111+
--bind 127.0.0.1 \
112+
--dir "$(pwd)/tmp/redis" \
113+
--pidfile "$(pwd)/tmp/redis/redis.pid" \
114+
--logfile "$(pwd)/tmp/redis/redis.log"
115+
./redis-7.2.7/src/redis-cli -h 127.0.0.1 ping # → PONG
108116

109117
. .venv/bin/activate
110118
export ONECOMP_DEVICE=cuda
@@ -294,6 +302,7 @@ See [troubleshooting in docs/setup-hpc.md](docs/setup-hpc.md#5-troubleshooting)
294302

295303
| Symptom | Fix |
296304
|---|---|
305+
| Redis won't start (`Failed to configure LOCALE`) | `export LC_ALL=C` before `redis-server` ([#1b](docs/setup-hpc.md#1b-redis-exits-immediately--invalid-locale)) |
297306
| Redis `Error 97` / Celery reconnect failure | Use `127.0.0.1` in the Redis URL and `--bind` |
298307
| vLLM `/health` returns Squid 403 | `no_proxy` (set automatically in code) |
299308
| Deploy fails because `vllm_python` path is missing | Align `config` with the venv layout and restart the worker (#7) |

dashboard/docs/setup-hpc.md

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -155,11 +155,18 @@ Once a node is allocated (e.g. `gpu08`), run every command below
155155

156156
```bash
157157
cd backend/
158-
./redis-7.2.7/src/redis-server --daemonize yes --bind 127.0.0.1
158+
export LC_ALL=C
159+
mkdir -p tmp/redis
160+
./redis-7.2.7/src/redis-server \
161+
--daemonize yes \
162+
--bind 127.0.0.1 \
163+
--dir "$(pwd)/tmp/redis" \
164+
--pidfile "$(pwd)/tmp/redis/redis.pid" \
165+
--logfile "$(pwd)/tmp/redis/redis.log"
166+
./redis-7.2.7/src/redis-cli -h 127.0.0.1 ping # → PONG
159167
```
160168

161-
> **Important**: always pass `--bind 127.0.0.1` (see Troubleshooting below
162-
> for the reason).
169+
> **Important**: `--bind 127.0.0.1` ([#1](#1-redis-connection-error--address-family-not-supported-by-protocol-errno-97)) and `LC_ALL=C` ([#1b](#1b-redis-exits-immediately--invalid-locale)) on HPC nodes.
163170
164171
### 2.3 Start the worker
165172

@@ -468,6 +475,17 @@ redis_url: str = "redis://127.0.0.1:6379/0"
468475
./redis-7.2.7/src/redis-server --daemonize yes --bind 127.0.0.1
469476
```
470477

478+
### #1b: Redis exits immediately — invalid locale
479+
480+
**Symptom**: `redis-cli ping``Connection refused`. Log:
481+
`Failed to configure LOCALE for invalid locale name.`
482+
483+
**Cause**: Redis 7.x needs a valid locale at startup; HPC nodes often have
484+
`LANG` set to a locale that is not installed.
485+
486+
**Fix**: `export LC_ALL=C`, then start Redis again (§2.2). If Celery already
487+
failed, restart the API and worker too.
488+
471489
### #2: vLLM health check is routed through the HTTP proxy
472490

473491
**Symptom**:

0 commit comments

Comments
 (0)