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
./autogen.sh
./configure
make
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 3.8.1.0 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 3.8.1.0
ghcup set cabal 3.8.1.0
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