Cosmovisor

cosmovisor is a small process manager for Cosmos SDK application binaries that monitors the governance module for incoming chain upgrade proposals. If it sees a proposal that gets approved, cosmovisor can automatically download the new binary, stop the current binary, switch from the old binary to the new one, and finally restart the node with the new binary.
We will explain how to use it based on version 0.1.0 of cosmovisor.
Cosmovisor Setup
Install the cosmovisor binary.
You will find a cosmovisor in path $GOPATH/bin.
go get github.com/cosmos/cosmos-sdk/cosmovisor/cmd/[email protected]
Set the required environment variabes.
There are four variables. (two are requirement, and two are optional)
DAEMON_HOME (Requirement)
This includes genesis binary and upgrade binaries.
export DAEMON_HOME=$HOME/.panacea
DAEMON_NAME (Requirement)
It's the name of binary.
export DAEMON_NAME=panacead
DAEMON_ALLOW_DOWNLOAD_BINARIES (Optional)
Whether to automatically download the new binary.
The default value is false.
Unfortunately, automatic download is not available yet.(by libwasmvm.so)
DAEMON_RESTART_AFTER_UPGRADE (Optional)
Whether to restart the process after the upgrade is completed.
The default value is false, so the administrator must manually restart after the upgrade.
export DAEMON_RESTART_AFTER_UPGRADE=true
We make setting to manually download the binary and to automatically proceed with the upgrade.
export DAEMON_HOME=$HOME/.panacea
export DAEMON_NAME=panacead
export DAEMON_RESTART_AFTER_UPGRADE=true
export DAEMON_ALLOW_DOWNLOAD_BINARIES=false
Create a directory for the genesis binary and upgrade binary.
mkdir -p $DAEMON_HOME/cosmovisor/genesis/bin
mkdir -p $DAEMON_HOME/cosmovisor/upgrades/v2.0.2/bin
Clone and check out the current panacead mainnet version. (v2.0.1)
git clone -b v2.0.1 https://github.com/medibloc/panacea-core.git
cd panacea-core
Build a binary and copy it to the genesis path of the cosmovisor.
make clean && make build
cp ./build/panacead $DAEMON_HOME/cosmovisor/genesis/bin
Build the upgraded version(v2.0.2) and copy it to the cosmovisor.
git checkout tags/v2.0.2
make clean && make build
cp ./build/panacead $DAEMON_HOME/cosmovisor/upgrades/v2.0.2/bin
Verify that the cosmovisor is applied as the mainnet version normally.
cosmovisor version
2.0.1 # output
Discontinue the currently running panacead and run it with cosmovisor.
stop panacead
cosmovisor start
When this proposal passes and the upgrade date(2021-10-01T07:00:00Z) arrives, the upgrade will automatically proceed to v2.0.2.
Example
Show an example of upgrading the version of panacead in a local environment.
go get github.com/cosmos/cosmos-sdk/cosmovisor/cmd/[email protected]
​
export DAEMON_HOME=$HOME/.panacea
export DAEMON_NAME=panacead
export DAEMON_RESTART_AFTER_UPGRADE=true
export DAEMON_ALLOW_DOWNLOAD_BINARIES=false
​
mkdir -p $DAEMON_HOME/cosmovisor/genesis/bin
mkdir -p $DAEMON_HOME/cosmovisor/upgrades/v2.0.2/bin
Clone and check out the current panacead mainnet version. (v2.0.1)
Then, build it and copy it.
git clone -b v2.0.1 https://github.com/medibloc/panacea-core.git
cd panacea-core
​
make clean && make build
cp ./build/panacead $DAEMON_HOME/cosmovisor/genesis/bin
Create a new key for the validator, then add a genesis account and transaction:
./build/panacead init test --chain-id test --overwrite
./build/panacead keys add validator
./build/panacead add-genesis-account validator 1000000000umed --keyring-backend test
./build/panacead gentx validator 1000000umed --chain-id test
./build/panacead collect-gentxs
​
cat <<< $(jq '.app_state.gov.voting_params.voting_period = "20s" | .app_state.gov.deposit_params.min_deposit[].amount = "10000000"' $DAEMON_HOME/config/genesis.json) > $DAEMON_HOME/config/genesis.json
You need to run binary with cosmovisor.
cosmovisor version
2.0.1 # output
cosmovisor start
Submit upgrade proposal along with a deposit and a vote.
./build/panacead tx gov submit-proposal software-upgrade v2.0.2 \
--title upgrade \
--description upgrade \
--upgrade-height 30 \
--from validator \
--chain-id test \
--yes
​
./build/panacead tx gov deposit 1 10000000umed --from validator --chain-id test --yes
./build/panacead tx gov vote 1 yes --from validator --chain-id test --yes
Build the upgraded version(v2.0.2) and copy it to the cosmovisor.
git checkout tags/v2.0.2
make clean && make build
cp ./build/panacead $DAEMON_HOME/cosmovisor/upgrades/v2.0.2/bin
The upgrade will be performed automatically at height 30.
cosmovisor version
2.0.2 # output
Guide - Previous
Ledger Nano Support
Next - Specifications
AOL
Last modified 5mo ago
Copy link
On this page
Cosmovisor Setup
Example