Upgrade Your Node Running via Systemd¶

Introduction¶

Keeping your node up-to-date is an important part of being a Tanssi validator. Not only does it help ensure that your node stays healthy, but it also contributes to keeping the entire Tanssi Network running smoothly.

This tutorial covers upgrading your Tanssi validator node that was configured using Systemd. It assumes you have already set up your account and launched a validator node using Systemd.

Upgrading Your Systemd Node¶

If you're running your validator via the Systemd service, you must take steps to upgrade your node correctly. In short, you'll need to stop the service, replace the Tanssi binary with the updated version, and restart the service.

You can stop your Tanssi Systemd service with the following command:

systemctl stop tanssi.service

Then, navigate to the directory where your Tanssi binaries are stored and remove them.

cd /var/lib/tanssi-data

If you haven't changed your Tanssi binary file names, they will be named tanssi-relay, tanssi-relay-execute-worker, and tanssi-relay-prepare-worker. Otherwise, you can replace tanssi-relay* in the command below with the correct names of your Tanssi binary files.

rm tanssi-relay*

To download the latest release and change permissions on it so the Tanssi service can use it, run the following command that corresponds to your environment:

wget https://github.com/moondance-labs/tanssi/releases/download/v0.12.0/tanssi-relay && \
wget https://github.com/moondance-labs/tanssi/releases/download/v0.12.0/tanssi-relay-execute-worker && \
wget https://github.com/moondance-labs/tanssi/releases/download/v0.12.0/tanssi-relay-prepare-worker && \
chmod +x ./tanssi-relay*

wget https://github.com/moondance-labs/tanssi/releases/download/v0.12.0/tanssi-relay-skylake -O tanssi-relay && \
wget https://github.com/moondance-labs/tanssi/releases/download/v0.12.0/tanssi-relay-execute-worker-skylake -O tanssi-relay && \
wget https://github.com/moondance-labs/tanssi/releases/download/v0.12.0/tanssi-relay-prepare-worker-skylake -O tanssi-relay && \
chmod +x ./tanssi-relay*

wget https://github.com/moondance-labs/tanssi/releases/download/v0.12.0/tanssi-relay-znver3 -O tanssi-node && \
wget https://github.com/moondance-labs/tanssi/releases/download/v0.12.0/tanssi-relay-execute-worker-znver3 -O tanssi-node && \
wget https://github.com/moondance-labs/tanssi/releases/download/v0.12.0/tanssi-relay-prepare-worker-znver3 -O tanssi-node && \
chmod +x ./tanssi-relay*

You can restart your Tanssi Systemd service with the following command:

systemctl start tanssi.service

The node will resume syncing blocks from where it left off when the Systemd service was stopped. To verify that it is running correctly, you can use the following command to check the logs:

systemctl status tanssi.service

And that's it! You've successfully upgraded your Tanssi node.