Update to 8.1.1 for Coincashew users

Hi all,

Here’s an upgrade guide for 8.1.1 for Coincashew users. This is a minor release but has “significant improvements at epoch boundary”, so IOG recommend updating.

The numbering has been updated to reflect the protocol version, i.e. version 8.X.X is protocol v8.

Update Instructions:

Update and restart your instance:

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

If you are still on a 1.35.X version, i.e. haven’t updated to 8.X.X, then you need to download and install the new branch of libsodium,

git clone https://github.com/input-output-hk/libsodium
cd libsodium
git checkout dbb48cc
make check
sudo make install

Download latest cardano-node git and checkout latest branch:

cd $HOME/git
git clone https://github.com/input-output-hk/cardano-node.git cardano-node2
cd cardano-node2/
git fetch --all --recurse-submodules --tags
git checkout tags/8.1.1

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

(Others have used 9.2.7 for ghc, so you can use that too)

ghcup upgrade
ghcup install ghc 8.10.7
ghcup set ghc 8.10.7
ghcup install cabal
ghcup set cabal
cabal update
ghc --version
cabal --version

Build the node:

cd $HOME/git/cardano-node2
cabal configure -O0 -w ghc-8.10.7
echo -e "package cardano-crypto-praos\n flags: -external-libsodium-vrf" >> cabal.project.local
cabal build cardano-node cardano-cli

This upgrade takes about 20 minutes.

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

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

If it shows 8.1.1, you can shut down the node and move the binaries to your bin:

sudo systemctl stop cardano-node

sudo cp $(find $HOME/git/cardano-node2/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

Check that successful version is reported:

cardano-node version
cardano-cli version

Again, if you are updating from 1.35.X, you also need to download the Conway Gensis file from here for your relevant network, e.g. pre-prod, mainnet, Environments - The Cardano Operations Book . If you’re updating from 8.0.0 you should have done this already and can skip this step.

And add

"ConwayGenesisFile": "conway-genesis.json",
"ConwayGenesisHash": "f28f1c1280ea0d32f8cd3143e268650d6c1a8e221522ce4a7d20d62fc09783e1", 

to your config.json file.

Now may be the time to setup p2p as well, as that is starting to be rolled out (on one relay only at the moment).

Then start your node.

Just be aware, it will replay the ledger, even from 8.0.0, which can take an hour or two, so make sure you are doing this when you aren’t scheduled for a block any time soon.

sudo systemctl start cardano-node

Clean up:

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

Monitor the progress by either using gliveview or journalctl:

journalctl --unit=cardano-node --follow


Just wanted to say thanks for the guide.

1 Like

Thank you for the guide!
I updated from 1.35.X and during the build I got stuck on “Building ouroboros-consensus-cardano- (lib)” on all 3 nodes. Seems like the rebuilds went fine but I have not run into an issue like that before and have no clue why that happened. Wonder if anyone else ran into this

DId you do the libsodium update? And cabal update before build?

Yep, I made sure to update libsodium and cabal update before build

1 Like

Followed exactly for 2 nodes, everything went perfectly. then it all fell apart when i checked the built version and it reported 8.1.1, then copied over the cardano-node and cli files, and verified version there. my cardano-node version is reporting 1.35.5, and cli is reporting 1.35.5. the build is reporting 8.1.1.
Ive repeated this multiple times, deleted the git folder, what am i missing?

Run “which cardano-cli” and look for the location that is running 1.35.5, same for “cardano-node” but should be the same location/problem.

There is also 8.1.2 available now, just change the checkout tag to 8.1.2 in the above guide,

git checkout tags/8.1.2