How to update Cardano Node 1.19.0 to 1.19.1?

Knowledge Base

How to update Cardano Node 1.19.0 to 1.19.1?

Sep 5, 2020, by Chris

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!

written by: Chris     published at: Sep 5, 2020
Further articles you might be interested in

Update grafana metrics when updating to cardano-node 1.25.1

Feb 2, 2021 by Chris

Cardano's [CAFE] and [CAFE2] are updated to newest version 1.25.1. For all stake pool operators (SPOs) it is important to know that with release of 1.25.1 the mainnet-config.json in the repository of CF / IOHK was consolidated and is a lot slimmer than previous! Some names of statistic variables have changed. In most cases the wording "ChainDB_" was removed. So be sure to update your grafana dashboard so that you can still enjoy your statistics after update to 1.25.1.

How to setup prometheus and grafana on a dedicated machine to monitor your cardano nodes

Nov 21, 2020 by Chris

Prometheus and grafana are helpful tools to monitor your nodes. They have a built-in alert function which notifies you about arising problems. This guide will show how to setup your infrastructure to do this monitoring with a separate machine thus not requiring additional installations on your vital cardano nodes.

Converting YAML to JSON when configuring RTView

Nov 8, 2020 by Chris

RTView is a new monitoring tool released by IOHK. When configuring or installing RTView, you might need the help of yaml to json converters.

Cardano Stake Pool Course

Oct 3, 2020 by Chris

A great way to help new stake pool operators in setting up their own stake pool is learning from the docs of the official Cardano Stake Pool School. It was launched by the Cardano Foundation in August 2020.

Security Tipps for Stake Pool Operators (SPOs)

Sep 21, 2020 by Chris

This article aims to provide an additional layer of security to your nodes according to swiss cheese model by preventing SSH login via public WAN. Using VPN and (V)LANs both relay- and block-producing nodes get isolated from the web.