Upgrade to 10.3.1 - Coincashew users

Hi all,

Here’s another upgrade guide for 10.3.1 for Coincashew users.

As always, test first, then deploy.

Update your instance:

sudo apt-get update && sudo apt-get upgrade

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/
git fetch --all --recurse-submodules --tags
git checkout tags/10.3.1

Then upgrade ghcup and do a cabal update. Just a note, you can now use GHC 9.6.7 and cabal version 3.12.1.0

ghcup upgrade
ghcup install ghc 9.6.7
ghcup set ghc 9.6.7
ghcup install cabal 3.12.1.0
ghcup set cabal 3.12.1.0
cabal update
ghc --version
cabal --version

Note: make sure you have ghc 9.6.7 and cabal 3.12.1.0 before proceeding.

Build the node:

cd $HOME/git/cardano-node2
cabal configure -O0 -w ghc-9.6.7
cabal build cardano-node cardano-cli

Check cardano-cli and cardano-node that the build was successful:

$(./scripts/bin-path.sh cardano-node) version
$(./scripts/bin-path.sh cardano-cli) version

The cardano-node version should be 10.3.1 and cardano-cli is 10.7.0.0

There is a new tracing system, and you need to add a line into your config (or download a fresh config) to turn it on, or off.

"UseTraceDispatcher": false,

Stop your node

sudo systemctl stop cardano-node

Then copy over the new executables

sudo cp -p "$(./scripts/bin-path.sh cardano-node)" /usr/local/bin/cardano-node
sudo cp -p "$(./scripts/bin-path.sh cardano-cli)" /usr/local/bin/cardano-cli

Again, check that successful version is reported:

cardano-node version
cardano-cli version

Then start your node.

sudo systemctl start cardano-node

Monitor the progress by either using gliveview or journalctl, and check if there’s any errors starting:

journalctl --unit=cardano-node --follow

Warning - this requires a full replay, so make sure you have many hours free for your relays or BP to work through it.

Then a quick clean up:

cd $HOME/git/
rm -rf cardano-node-old
mv cardano-node cardano-node-old
mv cardano-node2 cardano-node
2 Likes

As always, thank you for the guidelines !

I believe 10.4.1 might be a little bit trickier :wink: