How do I upgrade my cardano-node from version 1.18.0 or 1.18.1 to 1.19.0?
NOTE: The instructions below presuppose that you followed the Guild Operators Guide here.
Let's start by stopping our node
sudo pkill cardano-node
Since you have installed your node along the guidelines of the Guild Operators Guide go ahead and run your prereqs.sh script first.
cd ~/tmp ./prereqs.sh
This may or may not update your Cabal and GHC (see output below):
(If it doesn't install any updated ghc or cabal that is also OK as you will be up to date according to Guild Operators checks).
The above installation is taken care of by the prereqs.sh script in your ~/tmp folder.
After that has completed/skipped we go ahead with the node upgrade.
If you installed your node according to the Guild Operators Guide then your binaries are located in this folder off your home directory: ~/.cabal/bin
Move into that directory and remove the contents. Then clean cabal.
cd ~/.cabal/bin sudo rm * cabal clean
Then you need to move to your git directory and (optionally) remove the cardano-node directory
cd ~/git # change to git directory sudo rm -rf cardano-node # not necessary but many operators prefer to start clean
Now we go ahead and git clone the latest cardano-node version
cd ~/git git clone https://github.com/input-output-hk/cardano-node cd cardano-node git fetch --tags --all git checkout tags/1.19.0 git pull echo -e "package cardano-crypto-praos\n flags: -external-libsodium-vrf" > cabal.project.local
Now we run the script (pre-installed as per your Guild Operators Guide) to install the updated version:
This install will typically take a while now as it is a huge release after 1.18.0. (about 20 - 25 minutes).
Once completed you can check the updated versions.
cardano-cli version # should show this: cardano-node 1.19.0
cardano-node version # should show this: cardano-node 1.19.0
If both the above commands show their versions as 1.19.0 you are done. You can restart your node, if you like, now.
cd $CNODE_HOME/scripts ./cnode.sh # or whatever you copied/renamed your script here (ex. producer-cnode.sh, or relay-cnode.sh, etc.)
Some notes on this install
- Do not delete the db ever (unless you can't get it to come up for some other reason). We only deleted the DB during the HTN when they made changes that were incompatible. All changes should be compatible from here on out.
- Restart your node(s) to test that everything is working fine.
- If you experience any errors or doubts please inquire about those on this Telegram channel: https://t.me/StakePool247help
Alternatives to this method:
You can follow ADAM DEAN's version (he wrote a script to automate all of the upgrading for you). But It is not a Guild Operators structure script. You need to edit it according to your paths. Please visit his CardanoNodeUpgrade.sh script by clicking here.