The Cosmos team provides a tool named Cosmovisor that allows your node to perform some automatic operations when needed. This is particularly useful when dealing with on-chain upgrades, because Cosmovisor can help you by taking care of downloading the updated binary and restarting the node for you.
If you want to learn how to setup Cosmovisor inside your full or validator node, please follow the guide below.
The first thing you have to do is downloading the
cosmovisor binary file. To do this you can execute the following command:
go get github.com/cosmos/cosmos-sdk/cosmovisor/cmd/cosmovisor
This will download all the dependencies and build
cosmovisor for your machine. Once that's done, you can execute the following command to make sure that
cosmovisor is installed:
It should print
DAEMON_NAME is not set. If that's the case, you have installed
Cosmovisor relies on the following environmental variables to work properly:
DAEMON_HOMEis the location where upgrade binaries should be kept (e.g.
DAEMON_NAMEis the name of the binary itself (eg.
DAEMON_ALLOW_DOWNLOAD_BINARIES(optional) if set to
truewill enable auto-downloading of new binaries (for security reasons, this is intended for full nodes rather than validators).
DAEMON_RESTART_AFTER_UPGRADE(optional) if set to
trueit will restart the sub-process with the same command line arguments and flags (but new binary) after a successful upgrade. By default,
cosmovisordies afterwards and allows the supervisor to restart it if needed. Note that this will not auto-restart the child if there was an error.
To properly set those variables, we suggest you to edit the
~/.profile file so that they are loaded when you log into your machine. To edit this file you can simply run
sudo nano ~/.profile
Once you're in, we suggest you to set the following values:
export DAEMON_HOME=$HOME/.desmosexport DAEMON_NAME=desmosexport DAEMON_ALLOW_DOWNLOAD_BINARIES=trueexport DAEMON_RESTART_AFTER_UPGRADE=true
Once you're done, please reload the
~/.profile file by running
You can verify the values set by running
If this outputs
desmos you are ready to go.
In order to work properly, Cosmovisor needs the
desmos binary to be placed in the
~/.desmos/cosmovisor/genesis/bin folder. To do this you can simply run the following command:
mkdir -p ~/.desmos/cosmovisor/genesis/bin/cp $(which desmos) ~/.desmos/cosmovisor/genesis/bin/
To verify that you have setup everything correctly, you can run the following command:
This should output the Desmos version.
Finally, if you've setup everything correctly you can now restart your node. To do this you can simply stop the running
desmos start and re-start your Desmos node using the following command:
If you are running your node using a service, you need to update your service file to use
cosmovisor instead of
desmos. To do this you can simply run the following command:
sudo tee /etc/systemd/system/desmosd.service > /dev/null <<EOF [Unit]Description=Desmos Full NodeAfter=network-online.target [Service]User=$USERExecStart=$(which cosmovisor) startRestart=alwaysRestartSec=3LimitNOFILE=4096 Environment="DAEMON_HOME=$HOME/.desmos"Environment="DAEMON_NAME=desmos"Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=true"Environment="DAEMON_RESTART_AFTER_UPGRADE=true" [Install]WantedBy=multi-user.targetEOF
Once you have edited your system file, you need to reload it using the following command:
sudo systemctl daemon-reload
Finally, you can restart is as follows:
sudo systemctl restart desmosd