step-by-step.md

Namada Step-By-step Update v1.0.0 > v1.1.1

###############################################################################

1. Steps before the Block reached 894000:

###############################################################################

Tested on: Ubuntu 24.04.1 LTS (GNU/Linux 6.8.0-41-generic x86_64)

Updating all packages and dependencies

sudo apt update && sudo apt install make unzip clang pkg-config git-core libudev-dev libssl-dev build-essential libclang-18-dev protobuf-compiler git jq ncdu bsdmainutils htop lsof net-tools -y

Check CometBFT

cometbft version #must be v0.37.15

& If needed to Updating CometBFT to v0.37.15

cd /root
sudo rm -rf cometbft_bin
mkdir -p /root/cometbft_bin
cd /root/cometbft_bin
wget -O cometbft.tar.gz https://github.com/cometbft/cometbft/releases/download/v0.37.15/cometbft_0.37.15_linux_amd64.tar.gz
tar xvf cometbft.tar.gz
sudo chmod +x cometbft
sudo mv ./cometbft /usr/local/bin/

Update Rust

curl https://sh.rustup.rs -sSf | sh -s -- -y
source "/root/.cargo/env"
rustup update
rustc --version
cargo --version

Check the version

namadan -V # Must be v1.0.0 before block 894000

Make a backup

cp $(which namadan) /root/namadan_v1.0.0_backup

Build namada from source

cd /root
mkdir -p /root/namada_src
cd /root/namada_src
git clone https://github.com/anoma/namada.git
cd namada
git fetch --all
git checkout tags/v1.1.1
make build

Check binaries on the place & node version

[[ -f /root/namada_src/namada/target/release/namada ]] && ls -lah /root/namada_src/namada/target/release/
[[ -f /root/namada_src/namada/target/release/namada ]] && /root/namada_src/namada/target/release/namada -V

Check the Current block & you can monitor it later

curl -s http://localhost:26657/status | jq -r '.result.sync_info.latest_block_height'

Setup the systemd service and wait the halt

sudo sed -i 's|^ExecStart=.*|ExecStart=/usr/local/bin/namadan ledger run-until --block-height 894000 --halt|' /etc/systemd/system/namadad.service && \
sudo sed -i 's|^Restart=.*|Restart=on-failure|' /etc/systemd/system/namadad.service && \
sudo systemctl daemon-reload && sudo systemctl restart namadad

Monitor logs

sudo journalctl -u namadad -f -o cat

!!! WARNING !!! Your node will halt after committing block 893999, not 894000. DO NOT restart it until you've completed the upgrade!

###############################################################################

2. Steps After the Block reached 894000 - 1:

###############################################################################

Stop the node before upgrade

sudo systemctl stop namadad

Move binaries

cd /root
cd /root/namada_src/namada
sudo mv target/release/namada* /usr/local/bin/

Check the version again

namada -V #should be v1.1.1

Revert systemd service & restart

sudo sed -i 's|^ExecStart=.*|ExecStart=/usr/local/bin/namadan ledger run|' /etc/systemd/system/namadad.service && \
sudo sed -i 's|^Restart=.*|Restart=always|' /etc/systemd/system/namadad.service && \
sudo systemctl daemon-reload && sudo systemctl restart namadad

!!! WARNING!!! Wait! Your node may not start producing blocks immediately. Block production resumes only after 2/3 of the network completes the upgrade.

###############################################################################

3. Steps After the Node start producing the blocks:

###############################################################################

Check the node status

curl -s http://localhost:26657/status | jq -r '.result.sync_info.catching_up'

Monitor logs

sudo journalctl -u namadad -f -o cat

!!! WARNING!!! Wait! Your node may not start producing blocks immediately.

In case of fail

sudo systemctl restart namadad

or

sudo systemctl stop namadad
sudo systemctl disable namadad
sudo systemctl enable namadad
sudo systemctl start namadad
sudo journalctl -u namadad -f -o cat

Clean up the leftovers

rm -rf /root/cometbft_bin
rm -rf /root/namada_src