Update Node to 9.1.1

This guide will take you through the steps to update your node to 9.1.1. This guide is for the coincashew method users. Please double check file paths and file name and adjust as needed.

UPDATED: 9/5/2024

Binaries
Version
Mainnet

Node

9.1.1

✅

CLI

9.2.1.0

✅

Credits to Earn Coin Pool for documenting the procedure.

Step 1 - GHC and Cabal Check

Make sure you are using ghc 8.10.7 and cabal 3.8.1.0. If already installed you can skip this step.

ghcup upgrade
ghcup install ghc 8.10.7
ghcup set ghc 8.10.7
ghcup install cabal 3.8.1.0
ghcup set cabal 3.8.1.0

ghc --version
cabal --version

Step 2 - Backup your Configuration file:

cd $NODE_HOME
cp mainnet-config.json mainnet-config.bak
mv mainnet-conway-genesis.json mainnet-conway-genesis.bak

Step 3 - Download the new mainnet conway genesis file:

cd $NODE_HOME
wget https://book.play.dev.cardano.org/environments/mainnet/conway-genesis.json
mv conway-genesis.json mainnet-conway-genesis.json

Step 4 - Update Config file:

cd $NODE_HOME
nano mainnet-config.json

Edit or add THESE TWO LINES to the following:

"ConwayGenesisFile": "mainnet-conway-genesis.json",
"ConwayGenesisHash": "15a199f895e461ec0ffc6dd4e4028af28a492ab4e806d39cb674c88f7643ef62",

Step 5 - Download latest cardano-node git and checkout latest branch

cd $HOME/git

git clone https://github.com/IntersectMBO/cardano-node.git cardano-node2

cd cardano-node2/

cabal update

git fetch --all --recurse-submodules --tags

git checkout tags/9.1.1

Step 6 - Build the node

If you have tmux, it is recommended to open tmux by typing tmux this will allow to run these commands to build the node without terminal timing out.

cd $HOME/git/cardano-node2

cabal configure -O0 -w ghc-8.10.7

cabal build cardano-node

Step 7 - Check cardano-node that the build was successful

$(find $HOME/git/cardano-node2/dist-newstyle/build -type f -name "cardano-node") version

✅if 9.1.1 - move to next step

Step 8 - Download latest cardano-cli git and checkout latest branch

cd $HOME/git/cardano-node2/

git clone https://github.com/IntersectMBO/cardano-cli.git cardano-cli

cd cardano-cli/

cabal update

git fetch --all --recurse-submodules --tags

git checkout tags/cardano-cli-9.2.1.0

Step 9 - Build the CLI

cd $HOME/git/cardano-node2/cardano-cli

cabal configure -O0 -w ghc-8.10.7

cabal build cardano-cli

Step 10 - Check cardano-cli build was successful

$(find $HOME/git/cardano-node2/cardano-cli -type f -name "cardano-cli") version

✅if 9.2.1.0 - and you were using tmux, close tmux by typing exit

Step 11 - Shut down the node and move the binaries to your bin

If on 9.1.1 node and 9.2.1.0 cli, then shut down the node and move the binaries to your bin

sudo systemctl stop cardano-node
sudo cp $(find $HOME/git/cardano-node2/cardano-cli/dist-newstyle/build -type f -name "cardano-cli") /usr/local/bin/cardano-cli

sudo cp $(find $HOME/git/cardano-node2/dist-newstyle/build -type f -name "cardano-node") /usr/local/bin/cardano-node

Step 12 - Check that successful version upgrades then start back up Cardano node

cardano-node version
cardano-cli version

✅If on 9.1.1 node and 9.2.1.0 cli move to next step

Step 13 - Update and restart your instance

sudo apt-get update && sudo apt-get upgrade -y && sudo reboot

Step 14 - Clean up

cd $HOME/git/

rm -rf cardano-node-old

mv cardano-node cardano-node-old

mv cardano-node2 cardano-node

Additional Steps

Copy the cardano-cli binaries to your air gap machine. You can copy from your /usr/local/bin or from the new build to a USB drive

Check to see if you need to update other programs like CNCLI https://github.com/cardano-community/cncli

Congratulations you did it!

Additional Resources:

https://github.com/IntersectMBO/cardano-node/releases
https://github.com/IntersectMBO/cardano-cli/releases/
https://book.play.dev.cardano.org/env-mainnet.html

Contributors

Thanks to the following pools for helping to put together these guides. Please consider delegating to their pools to support them. Are you a pool? Consider buying them a coffee

Apex Cardano Pool - Ticker: APEX

Earn Coin Pool - Ticker: ECP

PANL Stake Pool - Ticker PANL

xSPO Alliance

Last updated