Troubleshooting

Docker or Compose Is Unavailable

Run:

docker version
docker compose version

If missing, run:

./install.sh

ARM64 Image Cannot Run

Running ARM64 images on x86_64 requires binfmt/qemu:

docker run --rm --privileged tonistiigi/binfmt --install arm64
docker run --rm --platform linux/arm64 debian:bookworm-slim uname -m

Expected output: aarch64.

First Snapshot Times Out

All-five snapshot can be slow, especially under QEMU. Increase timeout:

./start.sh --timeout-secs 14400

Output Counts Are Too Low

Check:

grep LIVE_TA_REFRESH_BEFORE_SNAPSHOT .env
ls -l /var/lib/ours-rp-arm64/state/live-ta
tail -100 /var/lib/ours-rp-arm64/logs/live-ta-refresh-*.log

In file-live-ta mode, snapshot should wait until live TA refresh succeeds.

Check .env:

GRAFANA_ADMIN_USER=admin
GRAFANA_ADMIN_PASSWORD=admin

If Grafana has already started, changing .env may not reset the existing Grafana database. Stop services and back up/clean ${HOST_DATA_DIR}/grafana if needed.

A Finite Acceptance Test Starts an Extra Run

If .env sets a finite MAX_RUNS=3 while SOAK_RESTART_POLICY=unless-stopped, Docker Compose restarts the soak container after it exits successfully.

For finite tests, set:

SOAK_RESTART_POLICY=no

1.3 KiB Raw Blame History