Akash Mainnet5 Node Upgrade Guide
This document provides guidelines for node operators upgrading to version 0.20.0
Countdown to network upgrade is listed below.
- Upgrade Height:
In the sections that follow both
non-Cosmovisorupgrade paths are provided. Prior to detailing specifics steps for these upgrade paths, in this section we cover steps required regardless of upgrade path chosen.
Note: The following steps are not required if the auto-download option is enabled for Cosmovisor.
Either download the Akash binary (v0.20.0) or build it from source:
git clone https://github.com/ovrclk/akash
git fetch --all
git checkout v0.20.0
GO_LINKMODE="internal" CGO_ENABLED=0 make akash
The following instructions assume the
cosmovisorbinaries are already installed and cosmovisor is set up as a systemd service.
The section that follows will detail the install/configuration of Cosmovisor. If additional details are necessary, visit Start a node with Cosmovisor for instructions on how to install and set up the binaries.
NOTE - Cosmovisor 1.0 is required
Note: The following steps are not required if Cosmovisor v1.0 is already installed and configured to your preferred settings.
cosmovisorby running the following command:
Check to ensure the installation was successful:
DAEMON_NAME=akash DAEMON_HOME=~/.akash cosmovisor version
cosmovisorsystemd service file and make sure the environment variables are set to the appropriate values (the following example includes the recommended settings).
- NOTE -
UNSAFE_SKIP_BACKUP=falseis set to false indicating that a backup is enabled. The
DAEMON_DATA_BACKUP_DIRwill dictate where the backup is stored.
- NOTE - with
UNSAFE_SKIP_BACKUPset to false, Cosmovisor will make a copy of the entire chain. Please ensure that your node has sufficient space to accommodate this chain backup which may be large.
- NOTE - It is preferable if you start your service under a dedicated non-system user other than root.
Description=Akash with cosmovisor
ExecStart=/root/go/bin/cosmovisor run start
Cosmovisor can be configured to automatically download upgrade binaries. It is recommended that validators do not use the auto-download option and that the upgrade binary is compiled and placed manually.
If you would like to enable the auto-download option, update the following environment variable in the systemd configuration file:
Cosmovisor will automatically create a backup of the data directory at the time of the upgrade and before the migration.
If you would like to disable the auto-backup, update the following environment variable in the systemd configuration file:
Move the file to the systemd directory:
sudo mv cosmovisor.service /etc/systemd/system/akash.service
cosmovisorto ensure the environment variables have been updated:
systemctl start akash
systemctl enable akash
Check the status of the
sudo systemctl status cosmovisor
cosmovisorto start automatically when the machine reboots:
sudo systemctl enable cosmovisor.service
Create the folder for the upgrade binary (v0.20.0) - cloned in this step - and copy the akash binary into the folder.
This next step assumes that the akash binary was built from source and stored in the current (i.e., akash) directory:
mkdir -p $HOME/.akash/cosmovisor/upgrades/v0.20.0/bin
cp ./.cache/bin $HOME/.akash/cosmovisor/upgrades/v0.20.0/bin
At the proposed block height,
cosmovisorwill automatically stop the current binary (v0.18.X), set the upgrade binary as the new current binary (v0.20.0), and then restart the node.\
Using Cosmovisor to perform the upgrade is not mandatory.
Node operators also have the option to manually update the
akashbinary at the time of the upgrade. Doing it before the upgrade height will stop the node.
When the chain halts at the proposed upgrade height, stop the current process running
Either download the Akash upgrade binary (v0.20.0) or build from source - completed in this step - and ensure the
akashbinary has been updated:
Update configuration with
NOTE - we strong suggest using environment variables over manually modifying the config.toml / app.toml
- To prevent
panic: cannot delete latest saved versionerror
- To prevents
panic: runtime error: invalid memory address or nil pointer dereferenceerror
- To prevent panic:
runtime error: invalid memory address or nil pointer dereference error on cosmos-sdk's createSnapshot ... incrVersionReaders
Restart the process running