Node Upgrade

We will occasional upgrade and patch Nocturne with new features and patches to improve the overall network.

To make the upgrade process as flawless as possible, we will update the node installer script from time to time. This script can be ran in a non-destructive way, meaning it changes only what is needed. It will gracefully shut down Rusk for you.

Migrating from ITN to Nocturne? See Nocturne Migration.

To upgrade to the latest Nocturne version, run:

curl --proto '=https' --tlsv1.2 -sSfL https://github.com/dusk-network/node-installer/releases/download/v0.2.0/node-installer.sh | sudo sh

Once it’s done and gives no errors, start Rusk again:

service rusk start

If everything is up and running again, query the node a couple of times to see if the block height is progressing:

ruskquery block-height

Or keep an eye on the logs to see if it’s making and accepting new blocks:

tail -F /var/log/rusk.log

If you see new blocks being accepted, you’re up and running again. Is your node stuck, or are you not sure if it is?

You can see the status of the Rusk service here:

service rusk status

If it is not running after starting it, and reports an error, you can check your logs to see if something is wrong, like a wrong password or no peers being found:

tail -n 30 /var/log/rusk.log

Unable to figure it out yourself? Visit our Node Runner Troubleshooting on Discord.

If everything else fails, check out the manual resync instructions.

Nocturne Migration

Note

We migrated stakes and rewards that accumulatively were higher than 5000 tDUSK to nDUSK. This was done to prevent the high amount of ghost provisioners with small stakes that we observed during ITN2.

The list of migrated stakes can be found here. Check with your provisioner key to see if you’re included.

1. To migrate from ITN to Nocturne, download the latest version of our installer:

curl --proto '=https' --tlsv1.2 -sSfL https://github.com/dusk-network/node-installer/releases/download/v0.2.0/node-installer.sh | sudo sh

2. Reset all the data on your node:

ruskreset

3. Start Rusk:

service rusk start

4. Check if your staking rewards are in your wallet:

rusk-wallet stake-info --reward

5. To claim your rewards, request nDUSK from the faucet. A guide can be found here.

6. Withdraw your staking rewards:

rusk-wallet withdraw

6. Stake your nDUSK:

rusk-wallet stake --amt 1000 # Or however much you want to stake