lei.chen/myxce
1
0
Fork 1
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(ha-config-bootstrap): only primary needs initial config — standbys get it via replication

Browse source
This commit is contained in:
Rongsong Shen 2026-05-29 10:59:51 +00:00
parent f465af0c0c
commit bc2aaff089
1 changed files with 20 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

37
.kiro/specs/ha-config-bootstrap/manual-tests.md
View file

@ -84,35 +84,38 @@ done
> All nodes share the same self-signed cert so they mutually trust each other.
> In production each node has its own cert signed by a shared CA.
### Initial Cluster Configuration (required)
### Initial Cluster Configuration (primary node only)
The controller looks for its cluster config at:
Thanks to config replication, **only the primary node (ctrl-a) needs the initial
config file.** Nodes B and C start with `config_tag=0`, defer the config fetch,
yield the election to the primary, and automatically receive the config via
`push_config_to_standbys()` after catch-up.
The controller looks for config at:
```
{workdir}/{myname}/conf/current ← pointer file (contains the config filename)
{workdir}/{myname}/conf/cluster.bin.<hex_tag> ← actual capnp config blob
{workdir}/{myname}/conf/current ← pointer file
{workdir}/{myname}/conf/cluster.bin.<hex_tag> ← capnp config blob
```
The `<hex_tag>` is the first 8 bytes of the SHA-256 of the config blob, as 16 hex digits.
The `<hex_tag>` is the first 16 hex chars of the SHA-256 of the config blob
(= first 8 bytes).
**Steps (using your existing config file):**
**Install config on Node A only:**
```bash
# 1. Compute the config tag from your config blob
TAG=$(sha256sum /path/to/your_config.bin | awk '{print $1}' | cut -c1-16)
echo "Config tag: $TAG"
# 2. Install config into each node's workdir
for node in a b c; do
NODE_NAME="ctrl-${node}"
CONF_DIR="/tmp/xce-${node}/${NODE_NAME}/conf"
mkdir -p "$CONF_DIR"
cp /path/to/your_config.bin "${CONF_DIR}/cluster.bin.${TAG}"
printf "cluster.bin.${TAG}" > "${CONF_DIR}/current"
done
CONF_DIR="/tmp/xce-a/ctrl-a/conf"
mkdir -p "$CONF_DIR"
cp /path/to/your_config.bin "${CONF_DIR}/cluster.bin.${TAG}"
printf "cluster.bin.${TAG}" > "${CONF_DIR}/current"
```
> The `current` file must contain exactly the filename (no trailing newline,
> no path separators). `printf` (not `echo`) avoids the trailing newline.
> `printf` (not `echo`) avoids a trailing newline that would corrupt the pointer.
>
> Nodes B and C need **no** config pre-installed — they will receive it from
> the primary automatically after election completes.
### Start the 3-node cluster (3 terminals)