Upgrade nodectl - Upgrade
Upgrade
In the background, nodectl will download the latest version of nodectl.
POSSIBLE ERROR
We may encounter an error cfg-199 depending on the version of nodectl you are utilizing. This is an error message that lets us know that we need to upgrade our node after the utility (nodectl) upgrade is completed.
We can safely ignore this message and continue.
If the version you are running does not need an upgrade, you will not receive an error.
Validate
nodectl will download the digital signature files from the nodectl repository
fetching digital signature hash ............... complete
fetching digital signature .................... complete
It will then display the contents and instructions on how to be extra secure in verifying that you have a valid copy of nodectl.
Please see the nodectl validate documentation for details and then return to this guide.
Success
If we get a SUCCESS, we can continue.
SUCCESS - AUTHENTIC NODECTL
In our example, we have downloaded v2.15.2 of nodectl. nodectl will execute the new v2.15.2 binary and display the versioning to help us verify we have downloaded the correct version.
The below example shows us on the major version of 2, minor version of 15 and 0 patch level. It also indicates that we are running v2.1.1 of the nodectl configuration.
VERSIONÂ Â Â Â Â Â Â Â MAJORÂ Â Â Â Â Â Â MINORÂ Â Â Â Â Â Â PATCHÂ Â Â Â Â Â CONFIG
v2.15.2Â Â Â Â Â Â Â Â 1Â Â Â Â Â Â Â Â Â Â Â 15Â Â Â Â Â Â Â Â Â Â 0Â Â Â Â Â Â Â Â Â Â v2.1.1
nodeadmin@Constellation-Node:~#
IMPORTANT
Even if you see a SUCCESS message when validating your copy of nodectl via a digital signature, you should still compare the public key and hash value between the output displayed on your node during the upgrade and the values in the official repository.
Links are provided in the output. Access these links, ensure you are on the correct repository (not a phishing site), and compare the hashes and keys for verification.
Upgrade Required
In some cases, nodectl will recognize that an upgrade is required.
In this example, an upgrade of the node is required. This will help nodectl to run properly on your node whether it is an upgrade needed for nodectl, or changes to the Tessellation protocol that may require some updates.
Press Y then [ENTER] to upgrade or N then [ENTER] to cancel:
Upgrading node after nodectl
You can press Y+Enter to accept and allow nodectl to enter directly into the upgrade command, or N+Enter if we want to wait until later.
If we choose not to upgrade the node after the nodectl upgrade, we must return to the upgrade process when ready and issue a sudo nodectl upgrade to allow our node to finish the upgrade.
Upgrade Not Required
Congratulations, you have completed this step-by-step guide!
Upgrade Required
Once the upgrade begins, we can refer to the upgrade guide to for a detailed step-by-step on the process of upgrading your node.