Update Cardano Node to 1.34.1 - for CoinCashew users

Hey everyone, here is my guide for compiling and upgrading to Cardano Node 1.34.1 for CoinCashew users.

If you are a CNTOOLS user, here is a great guide by BlocksWell:

If you are a CNTOOLS user and would like a more seamless approach for upgrading, Alexd1985 has a great script here:
https://forum.cardano.org/t/script-for-node-software-upgrade-cntools-users/91065

If you run into issues, some solutions can be found in the Additional Help section below.

Ready to start? Let’s go!

Cardano Node 1.34.1

Latest

@LaurenceIO LaurenceIO released this 25 minutes ago

· 33 commits to master since this release

1.34.1

73f9a74

Node version 1.34.1 is a minor release that fixes two issues:

  1. the tracer configuration settings were not respected, meaning that tracing was always enabled;
  2. the node start time and basic information (version etc) were not recorded in EKG logs.

Known Issues

To avoid increased synchronisation times, we recommended that Windows users DO NOT upgrade to this node version. We recommend instead that they continue to run node 1.33.0. Future releases will address this issue which is specific to Windows.

Technical Specification

Minimum System Requirements

  • An Intel or AMD x86 processor with two or more cores, at 1.6GHz or faster (2GHz or faster for a stake pool or relay)
  • 12GB of RAM
  • 50GB of free storage

Prepare for Upgrade 1.34.1

  • If available, create snapshots of your servers
  • Upgrade a relay first!
  • Update your server/OS

Update Instructions:

  1. Update and restart your instance:
sudo apt-get update && sudo apt-get upgrade -y && sudo reboot
  1. 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/1.34.1

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

(There is a newer version of ghc 9.2.2 but it does not work for this version of Cardano Node, so do not upgrade to this version of ghc.)

ghcup upgrade
ghcup install ghc 8.10.7
ghcup set ghc 8.10.7
ghcup install cabal 3.6.2.0
ghcup set cabal 3.6.2.0
cabal update
ghc --version
cabal --version
  1. 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.

  1. 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
  1. If on 1.34.1, 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
  1. Check that successful version upgrades then start back up Cardano node:
cardano-node version
cardano-cli version
sudo systemctl start cardano-node
  1. 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 

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

sudo cp $(find $HOME/git/cardano-node2/dist-newstyle/build -type f -name "cardano-cli") 
/media/usb

On the airgap - plug in USB to airgap and copy files to /usr/local/bin:

sudo cp cardano-cli /usr/local/bin

Afterthoughts

This upgrade takes about 20 minutes, and the standard 10 minutes for the node to fully start up.

Make sure to update your version of gLiveView.sh to v1.26.3 or later, as previous versions of gLiveView won’t load.

Additional Help

If you are running into issues with your cabal, ghc, cardano-node, or cardano-cli versions being incorrect, your file path locations are likely different.

To find out where your cabal, ghc, cardano-node, and cardano-cli are running from:

which cabal
which ghc
which cardano-node
which cardano-cli

To find the location of all files of the same type:

whereis cabal
whereis ghc
whereis cardano-node
whereis cardano-cli

Once you know where your files are stored, you can copy the new versions over to where they should be running from.

Sometimes you may need to use “sudo” before your copy command depending on your write permissions.

Deleting your old binaries can also be helpful if the wrong versions are being picked up.

Good luck everyone, I hope you find this useful! :slightly_smiling_face:

13 Likes

Hi,

Revised Coin Cashew documentation for upgrading to a new Cardano Node version, including a review of the forum posts above, is now available at Upgrading a Node - CoinCashew

The revised documentation is version agnostic, meaning that procedures are intended to work without specific adaptations for each new Cardano Node release.

[CHG] Change Pool

3 Likes