Knowledge Base
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 |
Knowledge Base
Dec 3, 2023, by Eric Hill
Knowledge Base
Sep 7, 2023, by Eric Hill
Knowledge Base
Apr 9, 2023, by Eric Hill
Knowledge Base
Mar 22, 2023, by Eric Hill
Knowledge Base
Oct 22, 2022, by Eric Hill