Migrate Validator

How to migrate an Autonity validator node to a new instance or to a new IP/Port address

Prerequisites

Migrating validator node to a new IP/Port address

This guide describes how to migrate a validator node to an environment with a new IP/Port network address by updating the validator’s registered enode URL.

Important

Only the network connection information - IP and/or port - of a registered validator enode can be updated. You cannot change the validator’s address (i.e. the PUBKEY part of the validator enode URL).

When performing the update the validator must not not be an active member of the consensus committee. It is recommended that you pause your validator before migration. This is to prevent your node being elected as a committee member while you are in the process of migration.

Step 1: Pause the validator

Pause the validator as described in the guide Pause as a validator.

If your validator is an active member of the consensus committed, wait for the epoch to end before proceeding further.

Verify your validator node is not in the active consensus committee

Call aut protocol get-committee to verify that your validator address does not appear in the list of committee validators returned.

Step 2: Update enode URL with new IP/Port address

Call updateEnode() passing in parameters for:

  • <NODE_ADDRESS>: the validator identifier address of the validator node
  • <ENODE>: the new enode URL value
aut validator update-enode --validator <NODE_ADDRESS> <ENODE> | aut tx sign - | aut tx send -

On commit, the transaction will update the validator’s registered enode URL in system state. you can view the updated enode using aut validator info --validator.

Step 3: Migrate to new environment

Migrate the node to the environment with the new IP/Port address configuration as described in the guide Migrating validator node to a new environment on this page.

Step 4: Start validator node

Start the validator as described in the guide Run Autonity.

Step 5: Re-activate the validator

Reactivate the validator as described in the guide Reactivate as a validator.

The validator has resumed an active state and can join the consensus committee if selected.

Migrating validator node to a new environment

To migrate a node to a new instance follow the steps described in the node operator’s guide Migrate Autonity.

Important

If your node is in an active state, you must pause the validator node before migration. Reactivate the validator after migration.

Be sure to fully decommission the original node installation!

If you need help, you can chat to us on Autonity Discord Server!