Version Upgrade v0.2.1

9min

NOTE: Only use this guide to upgrade a validator that was installed and working using the previous v0.1 or v0.2 guide!

This process can be completed on a validator that is running but will require a restart after downloading and extracting new files.

Complete using xand user without sudo privledge.

Download archive:

Change directory into home directory

Download new Release tar.bz2 file from https://github.com/Xandeum/binaries/releases

Document image

CLI


Make your new directories

CLI


Extract the new release into the bin folder.

NOTE: Extracting can take a few minutes!

Wait for the hostname/cursor to return to normal before proceding to the symlink operations!

CLI


Remove old symlink

CLI


Create symlink to new binaries

CLI


Test you have new version by verifying before you restart:

CLI

Document image


Restart your validator when the delinquincy is below 10% to start using new version

NOTE: Using this exit command will check for cluster delinquincy, and check your validator for upcoming leader slots and will wait until you have a restart window to avoid missing block production!

After it's clear of leader slots, and epoch isn't ending soon, a new snapshot will be taken, then the validator will shut down.

It will only restart on its own if you have the system service up and running!

If you keep getting leader slots, you can try reducing --min-idle-time to zero and then the snapshot will still happen. The -f or --force flag can be added to skip checks for leader slots and epoch completion and it will not look for a suitable restart window or complete snapshotting. It will force the restart now.

CLI


Below is showing waiting due to an upcoming leader slot



Document image


Below is showing the validator has shut down. It is sitting idle until system service restarts the validator.

Document image


Below is showing the validator is back running and syncing the ledger with the cluster.

Document image


Below is showing the validator is back running and validating with the tip of the cluster. This is normal and using ctrl+c will exit the monitor command.

Upgrade is complete!

Document image