Try   HackMD

DEVNET-5 TrichomeMonster-ICA Upgrade

We've developed a new version with some updates (regarding SDK, Tendermin & IBC/GO) called TrichomeMonster-ICA release to integrate the ICA (Interchain Account) module.

We will upgrade to DEVNET-5 by governance. If tests results are as expected, we will update the Mainnet as soon as possible.

To emphasize, this guide is for our TESTNET (devnet) users. No action required yet by MAINNET validators / node operators.

Governance proposal: halt-height XXXXXXXX

https://testnet.ping.pub/bitcanna/gov/8

Attended (manually) upgrade.

This section of the guide shows how to perform a manual update of the binaries after a governance proposal has been approved for a chain update. If you want to build the binary from the source, detailed instructions can be found in the README of our GitHub:

    git clone https://github.com/BitCannaGlobal/bcna.git
    cd bcna
    git checkout  v1.5.1
    make build && make install 
  1. Stop your bcnad service after you see this in your logs ERR UPGRADE "trichomemonster-ica" NEEDED at height: XXXXX
sudo service bcnad stop
  1. Download the binary (or compile it from the source).
cd ~
rm -f bcnad
wget -nc https://github.com/BitCannaGlobal/bcna/releases/download/v1.5.1/bcna_linux_amd64.tar.gz
  1. Check the sha256sum.
sha256sum bcna_linux_amd64.tar.gz

It must return: 61cc23efd818184370ec3f43cd9c9ba731978874d54e370b3b4f8c6f724a75ec

  1. Verify that the version is v1.5.1
rm -f ./bcnad
tar zxvf  bcna_linux_amd64.tar.gz
rm bcna_linux_amd64.tar.gz
chmod +x bcnad
./bcnad version
  1. Move the new binary to your machine's PATH and overwrite the previous version
sudo mv bcnad $(which bcnad)   #copy&paste don't replace anything

If you know the exact destination you could also run:

sudo mv bcnad /usr/local/bin/ #or wherever you have it
  1. Start the bcnad service
sudo service bcnad start

Of course, if you are familiar with the Cosmos environment, you can keep daemon running while you are compiling/downloading and later make in the same line:

sudo service bcnad stop && sudo mv bcnad $(which bcnad) && sudo service bcnad start
  1. Ensure that everything is OK by checking the logs
sudo journalctl -u bcnad -f

Unattended (Cosmovisor) upgrade.

For extended instructions about config Cosmovisor v1.3 from the scratch check this doc

Step 1. Setup Cosmovisor folder

  1. Create new directory
mkdir -p ${HOME}/.bcna/cosmovisor/upgrades/trichomemonster-ica/bin
  1. Download & copy the current version 1.5.1 to the upgrades folder.
    This guide shows how to download the binary. If you want to build the binary from the source, detailed instructions can be found in the README of our GitHub (git checkout v1.5.1)
cd ~
rm -f bcna_linux_amd64.tar.gz
wget -nc wget -nc https://github.com/BitCannaGlobal/bcna/releases/download/v1.5.1/bcna_linux_amd64.tar.gz

Check the sha256sum.

sha256sum ./bcna_linux_amd64.tar.gz

It must return: 61cc23efd818184370ec3f43cd9c9ba731978874d54e370b3b4f8c6f724a75ec

Verify that the version is:1.5.1

rm -rf ./bcnad
tar zxvf  bcna_linux_amd64.tar.gz
rm bcna_linux_amd64.tar.gz
./bcnad version
  1. Move the newly downloaded/built binary to the upgrades directory.
mv ./bcnad ${HOME}/.bcna/cosmovisor/upgrades/trichomemonster-ica/bin/

If you build the binary from the code source, move it to the same folder

  1. Check after upgrade:

If you want to know if Cosmovisor handles the right binary file exec:

sudo service cosmovisor status

And check the path of the binary file.

If you need start from scratch

https://hackmd.io/g7pENy73RFKkcCYIKFzZrw#Start-from-the-scratch

tags: bitcanna, devnet, upgrade