Validator upgrade guide
For non-breaking changes, you can minimize the downtime by keeping your existing validator node running while you download and configure the new version according to the steps below. Once the upgrade is fully configured and ready to run, stop the old node and start the new one.
A fully Zero-downtime upgrade procedure is coming in a future update.
v0.2 → v0.3 (Breaking Change)
v0.3 switches to a new consensus deployment. For this reason, the validator must be set up from scratch without reusing the old database stored at data/node/genlayer.db.
You do not need to keep your existing validator node running while you download and configure the new version.
- Stop the node if it is running.
- Back up the configs/node/config.yaml file so that you can refer to any values you have set in the previous version.
- Download the packaged binary.
- Install the new version.
- Remove the storage folder
data/node/genlayer.db. - Check that configuration is correct by running
genlayernode doctorcommand. - Start the node.
Install the new version in the same directory as the previous installation. This ensures that any paths referenced in the configuration remain the same and
helps maintain continuity in your setup.
If you want to install the new version in a different directory, copy your data/keystore and configs/node/wallet.yaml to the new directory to keep using
the same wallet.
v0.1.0-testnet008 → v0.2.0-testnet001
- GenVM configuration has changed, please follow the new instructions in the GenVM configuration section in the validator setup guide.
- Back up the
configs/node/config.yaml,configs/node/wallet.yaml, anddata/node/keystorefolders so you can retain your previous configuration and wallet access.