🐎Upgrade Tessellation Quick Start

Introduction

This guide walks you through upgrading your Validator node to the latest version of Tessellation using nodectl, leveraging non-interactive mode with recommended defaults. Please refer to the full upgrade guide for a more detailed walk-through.

🏭Upgrade Tessellation Guide
1

SSH Into Your VPS

ssh -i /path/to/ssh/private/key nodeadmin@<vps_ip_address> -p <port>
2

Begin the Upgrade

Execute the following command to begin a non-interactive upgrade. This will automatically pull and install the latest Tessellation release using default settings.

sudo nodectl upgrade --ni
3

Single Layer Nodes

If you're running a single-layer Validator (Layer0 or Layer1 only), you can skip directly to the Confirm Status step below.

4

Hybrid Node Considerations

If your node operates in hybrid mode (participating in both Layer0 and Layer1):

  • You must wait for the Layer0 profile to reach the Ready state before attempting to connect Layer1.

  • Layer1 cannot join the cluster until the full Layer0 chain is downloaded and synchronized.

5

Auto Restart (If Enabled)

If you have the auto_restart feature enabled:

  • Your node will detect when Layer0 reaches Ready state.

  • It will automatically initiate the Layer1 connection.

6

Watch for Layer0 to Reach Ready

Use the command below to monitor the Layer0 profile. Adjust the -p flag to match your profile name.

sudo nodectl status -p dag-l0 -w 120
7

Manually join Layer1

Once Layer0 is in the Ready state, attempt to join Layer1:

sudo nodectl join -p dag-l0
8

Confirm Status

Check the final status of all profiles:

sudo nodectl status

Expected output

JOIN STATE     Ready
IN CONSENSUS   True

Last updated

Was this helpful?