docs(ha-config-bootstrap): add path verification warning — config must be in workdir/myname/conf/

This commit is contained in:
Rongsong Shen 2026-05-29 11:11:29 +00:00
parent 25c71adffb
commit 96df7285da

View file

@ -117,6 +117,23 @@ printf "cluster.bin.${TAG}" > "${CONF_DIR}/current"
> Nodes B and C need **no** config pre-installed — they will receive it from
> the primary automatically after election completes.
**Verify before starting (common mistake: wrong subdirectory):**
```bash
# The path MUST include the node name as a subdirectory:
# {workdir}/{myname}/conf/current ✓ /tmp/xce-a/ctrl-a/conf/current
# {workdir}/conf/current ✗ /tmp/xce-a/conf/current ← WRONG
ls -la /tmp/xce-a/ctrl-a/conf/
# Must show: current cluster.bin.<tag>
```
If you see the files at `/tmp/xce-a/conf/` instead, move them:
```bash
mkdir -p /tmp/xce-a/ctrl-a/conf
mv /tmp/xce-a/conf/* /tmp/xce-a/ctrl-a/conf/
```
### Start the 3-node cluster (3 terminals)
**Terminal 1 — Node A (priority 0 = highest):**