Replacing nodes

  • Updated on Dec 9, 2024
  • Published on Dec 6, 2024
  • 2 minute(s) read

The replacement functionality allows you to replace an existing Edge Node (formerly Edge iNode), Cloud Connector (formerly Virtual iNode), or Virtual Edge Node (formerly Virtual Edge iNode) with a new one while maintaining its configuration. All tunnels, networks, and services associated with the original node will be preserved on the new node.

Pre-provision a new Edge Node WAN

Note
This step is required only if your original Edge Node was configured with static network addressing. For Edge Nodes using dynamic network addressing (via DHCP), you can proceed directly to Replace the Edge Node serial number below.

If your old Edge Node was configured with static network addressing, follow these steps to pre-provision the new Edge Node WAN with the same static configuration:

  1. Use SSH to connect to the new Edge Node. (Learn how in Accessing an Edge Node console.) 
  2. Follow the instructions in Configuring static IP for a node uplink interface. If you use static configuration for your name servers, make sure to also complete the steps under Configuring a name server.
  3. If applicable to your static WAN configuration, also update your time server and proxy server configurations.

Once the new Edge Node WAN is configured, continue to the next steps to replace the Edge Node serial number.

Replace the Edge Node serial number

To update the Edge Node serial number, complete these steps in the recommended sequence:

  1. Go to the details page of the Edge Node that you want to replace. Click on the pencil icon next to Serial Number.
  2. Enter the serial number of the new hardware, then select Replace Hardware Serial Number.
    Important
    Make sure to follow the sequence as indicated in the dialog box.

  3. Once the replacement is successful, the Edge Node details page will display the updated serial number for the new hardware.
The new Edge Node, if connected, will automatically reboot to apply the changes.

Regenerate credentials for Cloud Connectors and Virtual Edge Nodes

For Cloud Connectors and Virtual Edge Nodes, replacing the node will also regenerate its credentials.

  1. Go to the details page of the node that you want to replace. Click on the pencil icon next to the node Serial Number.
  2. Replacing Cloud Connectors and Virtual Edge Nodes will regenerate the credentials and update the serial number. Specify the cloud provider and type "Regenerate Credentials" in the text box. Then select Regenerate & Download Credentials.
    Warning
    This action is irreversible. When you regenerate credentials, it will change the new node's serial number and download the credentials.
  3. Once the replacement is successful, the details page will show the new serial number, and the new credentials will be downloaded. Store this information in a secure location.

The node will automatically reboot to apply the new credentials.