> loading_
# Tempo v1.5.3 — Validator upgrade walkthrough
# Tested against a running validator on Tempo testnet, 2026-04-10
# -------------------------------------------------------
# Step 1: Check your current version and flag usage
# -------------------------------------------------------
# Before upgrading, confirm your running version and whether
# your startup config includes the now-removed flag.
tempo version
# Expected (pre-upgrade): tempo/v1.5.2+abcdef or earlier
grep -r "enable-subblocks" /etc/tempo/ ~/.tempo/ systemd/tempo.service
# If any matches appear, you MUST remove this flag before
# restarting on v1.5.3 — it is no longer recognized and
# will cause a fatal startup error.
# -------------------------------------------------------
# Step 2: Pull and build (or fetch the binary)
# -------------------------------------------------------
git clone --branch v1.5.3 https://github.com/tempo-network/tempo.git
cd tempo
make build
# Or, if using a managed binary:
# curl -LO https://releases.tempo.xyz/v1.5.3/tempo-linux-amd64
# chmod +x tempo-linux-amd64 && mv tempo-linux-amd64 /usr/local/bin/tempo
# -------------------------------------------------------
# Step 3: Verify the new scheme-registration requirement
# -------------------------------------------------------
# If you run any custom verification tooling against blocks,
# confirm your scheme is registered. The consensus module
# now rejects blocks verified with unregistered schemes.
tempo consensus list-schemes
# You should see your scheme ID in the output. If not:
# tempo consensus register-scheme --scheme-id <YOUR_SCHEME_ID> \
# --config /path/to/scheme-config.toml
# -------------------------------------------------------
# Step 4: Restart the validator
# -------------------------------------------------------
# Ensure the enable-subblocks flag is gone, then restart.
sudo systemctl restart tempo-validator
# -------------------------------------------------------
# Step 5: Confirm telemetry TLS is active again
# -------------------------------------------------------
# v1.5.2 broke TLS on OTLP HTTP endpoints. Verify it's back.
tempo telemetry status
# Look for: "otlp_http_tls: enabled"
# If you see "disabled", check your telemetry config for
# an explicit tls=false override that may need removal.
# -------------------------------------------------------
# Step 6: Monitor epoch transitions
# -------------------------------------------------------
# The core fix retains scheme material for two previous epochs.
# Watch the logs around the next epoch boundary to confirm
# peers are no longer being incorrectly blocked.
tempo logs --filter="epoch_transition" --follow
# Healthy output: "epoch transition complete, retained schemes: [N-1, N-2]"
# Unhealthy (pre-patch): "peer blocked: unknown scheme for epoch N-1"