Story Cosmovisor

• Check go version #requirement go version above v.1.22 if you have Go v.1.22 already. Please skip install Go step.

1. Install go

cd $HOME && \
ver="1.22.0" && \
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz" && \
sudo rm -rf /usr/local/go && \
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz" && \
rm "go$ver.linux-amd64.tar.gz" && \
[ ! -f ~/.bash_profile ] && touch ~/.bash_profile && \
echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> ~/.bash_profile && \
source ~/.bash_profile && \
go version

2. Install Cosmovisor

#cosmovisor version 1.7
source $HOME/.bash_profile
go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@latest

• Check cosmovisor version:

cosmovisor version

3. Init Cosmovisor

• Set DAEMON_HOME:

export DAEMON_NAME=story
echo "export DAEMON_NAME=story" >> $HOME/.bash_profile
export DAEMON_HOME=$HOME/.story/story
echo "export DAEMON_HOME=$HOME/.story/story" >> $HOME/.bash_profile

• Initialize Cosmovisor with DAEMON_HOME:

cosmovisor init $(whereis -b story | awk '{print $2}')

• Create the backup directory: Now that DAEMON_HOME is defined, you can create the necessary directories.

mkdir -p $DAEMON_HOME/cosmovisor/backup
echo "export DAEMON_DATA_BACKUP_DIR=$DAEMON_HOME/cosmovisor/backup" >> $HOME/.bash_profile
echo "export DAEMON_ALLOW_DOWNLOAD_BINARIES=false" >> $HOME/.bash_profile

After setting up, reload your environment variables with:

source $HOME/.bash_profile

4. Create upgrades folder

mkdir -p $HOME/.story/story/cosmovisor/genesis/bin

• Stop node

sudo systemctl stop story

• Download Story binary v1.1.0

#download binay
cd $HOME
rm story-linux-amd64
wget https://github.com/piplabs/story/releases/download/v1.1.0/story-linux-amd64
chmod +x story-linux-amd64

• Copy new binary to upgrades folder

# Copy new version binary to upgrade folder
sudo cp $HOME/story-linux-amd64 $HOME/.story/story/cosmovisor/upgrades/v1.1.0/bin/story

• Add Upgrade Information for new version

echo '{"name":"v1.1.0","time":"0001-01-01T00:00:00Z","height":677886}' > $HOME/.story/story/cosmovisor/upgrades/v1.1.0/upgrade-info.json

5. Verify the Setup

# Check current symlink
ls -l /root/.story/story/cosmovisor/current

# Check the story version in genesis folder. It should be old version is v1.1.0
$HOME/.story/story/cosmovisor/genesis/bin/story version

# Check the new binary version in upgrade folder. It should be new version v1.1.0
$HOME/.story/story/cosmovisor/upgrades/v1.1.0/bin/story version

# Check upgrade info
cat $HOME/.story/story/cosmovisor/upgrades/v1.1.0/upgrade-info.json

• Update service file:

sudo tee /etc/systemd/system/story.service > /dev/null <<EOF
[Unit]
Description=Story Consensus Client
After=network.target

[Service]
User=root
Environment="DAEMON_NAME=story"
Environment="DAEMON_HOME=/root/.story/story"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=true"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="DAEMON_DATA_BACKUP_DIR=/root/.story/story/data"
Environment="UNSAFE_SKIP_BACKUP=true"
ExecStart=/root/go/bin/cosmovisor run run
Restart=always
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl start story && sudo systemctl status story

5. Set schedule for upgrade:

Note

To schedule an upgrade to a new client version at a specific block height, cosmovisor should already be running.

source $HOME/.bash_profile
cosmovisor add-upgrade v1.1.0 $HOME/.story/story/cosmovisor/upgrades/v1.1.0/bin/story --force --upgrade-height 677886

Output sample:

 ⚡ root@josephtran  ~  source $HOME/.bash_profile
cosmovisor add-upgrade v1.1.0 $HOME/.story/story/cosmovisor/upgrades/v1.1.0/bin/story --force --upgrade-height 677886
8:16AM INF Using /root/.story/story/cosmovisor/upgrades/v1.1.0/bin/story for v1.1.0 upgrade module=cosmovisor
8:16AM INF Upgrade binary located at /root/.story/story/cosmovisor/upgrades/v1.1.0/bin/story module=cosmovisor
8:16AM INF /root/.story/story/data/upgrade-info.json created, v1.1.0 upgrade binary will switch at height 677886 module=cosmovisor