[CAFE] Blog & Knowledge Base

Latest news from CardanoCafe & useful information for stake pool operators

How to update Cardano Node 1.19.0 to 1.19.1?

written by CardanoCafe Team published at 2020-09-05

This guide helps when updating cardano-node to latest version 1.19.1.

Update: We received some questions about the update process. Therefore we updated this guide to make things more clear to you!

Updating your cardano node is simple. Nevertheless we suggest to create a backup of your node before starting the update process!

First of all, assure that your OS is up to date. In case you're using Ubuntu 20.04.1 LTS you have to run following commands. Select "y" / "yes" in case your asked to continue:

sudo apt-get update
sudo apt-get upgrade

After the update is completed change your working directory to your cardano-node folder. When you have followed closely the official documentation this folder should be located in your home folder.

Change to your home/cardano-node folder:

cd ~/cardano-node

In there, checkout the latest version of cardano-node. As of now, the latest version is 1.19.1:

git fetch --all --tags
git tag
git checkout tags/1.19.1

Thereafter start building

cabal build all

The update process can take some time. Please note that there are ways to create the new binaries faster than described here. However we would like to make the update process as simple as possible - therefore we stick as closely as possible to the official cardano documentation.

After build is completed you have to copy the newly created binaries to your .local/bin folder.

Before doing so, we suggest to create a backup of your cardano-cli and cardano-node file in .local/bin folder.

Be sure that latest at this point your node must be stopped. Otherwise the following mv won't work!

cd ~/.local/bin
mv cardano-cli cardano-cli-backup-2020-sept
mv cardano-node cardano-node-backup-2020-sept

Then, go back to your cardano-node folder and copy the newly created cardano-files into the .local/bin folder.

You can do so by:

cd ~/cardano-node
cp -p dist-newstyle/build/x86_64-linux/ghc-8.6.5/cardano-node-1.19.1/x/cardano-node/build/cardano-node/cardano-node ~/.local/bin/
cp -p dist-newstyle/build/x86_64-linux/ghc-8.6.5/cardano-cli-1.19.1/x/cardano-cli/build/cardano-cli/cardano-cli ~/.local/bin/

Thereafter start again your cardano process as described in the official documentation.

Start your relay node with:

cardano-node run \
--topology mainnet-topology.json \
--database-path /db \
--socket-path /db/node.socket \
--host-addr <PUBLIC IP> \
--port <PORT> \
--config mainnet-config.json

Start your block producing node with:

cardano-node run \ --topology mainnet-topology.json \
--database-path /db \
--socket-path /db/node.socket \
--host-addr <PUBLIC IP> \
--port <PORT> \
--config mainnet-config.json \
--shelley-kes-key kes.skey \
--shelley-vrf-key vrf.skey \
--shelley-operational-certificate node.cert

And that's it! Congratulations, your node is up to date again!