Upgrade nodectl Quick Start Guide

This guide is specifically for upgrading your node to to the latest version of nodectl with opinionated sensible defaults.

◽ SSH into Your VPS

Review your notes for the connection string.

ssh -i /path/to/ssh/private/key nodeadmin@vps_ip_address

Refer to SSH Explanation, Mac SSH Guide, and Windows SSH Guide for detailed understanding.

◽ Begin upgrade process

sudo nodectl upgrade_nodectl

◽ Confirm upgrade request

nodectl should offer you 2 versions to choose from. The latest version of nodectl and the last known upgrade path version.

UPGRADE PATH

Make sure you use the proper upgrade path, upgrading to the latest while ignoring the upgrade path, may create undesired effects.

We will press key ( no need to hit enter ) the number option related to the verson that best suit our needs and follows the upgrade path accordingly.

Press y to confirm.

◽ Confirm Authentic Release

After the newest version of nodectl is downloaded make sure your receive the message.

SUCCESS - AUTHENTIC NODECTL

We can continue the process.

INVALID SIGNATURE - WARNING

Before using any other nodectl commands, refer to Constellation Network's official Discord channel for assistance. Avoid issuing additional commands to prevent potential interference from nefarious actors impersonating nodectl's functionality.

◽ Upgrade Tessellation Request

🛑 No upgrade required

Skip to the congratulations step.

✅ Upgrade required

If we are prompted to upgrade our node, we must perform the upgrade.

Enter y and follow the prompts.

Optionally, you may follow upgrade step-by-step and return back here when complete.

◽ Migration Request

🛑 No Migration requested

Skip to congratulations step.

✅ Migration requested

If we are prompted to migrate our node's configuration, we must perform the migration.

Enter y

Review new configuration

This is optional Enter n

◽ Auto restart

If you use the auto_restart feature of nodectl, it’s a good idea to force a restart of this feature to ensure it incorporates any changes that may affect the feature's performance.

sudo nodectl auto_restart restart

COMPLETED

◽ Congratulations!

Your node should now be upgraded to the latest nodectl version.