Replace Volterra Node
Table Of Contents
This guide provides instructions on how to replace a pool node and a master node in a Volterra multi-node cluster site and a single-node site respectively. To know more about sites and nodes, see Volterra Site.
In case you need to replace a Volterra node in your site due to reasons such as a hardware failure or any other issues, use the instructions provided in this document to perform the replacement.
- A valid VES account is required.
Note: In case you do not have an account, see Create a VES Account.
- The Volterra site should be registered and running.
The following figure shows the sequence of steps in replacing a pool node and a master node.
Node replacement for pool or master node includes performing the following sequence of actions:
|Remove Node||Removal of Node is includes powering off and handling physical connections if it is a hardware node.|
|Install Volterra Node||Replacing a node requires installing another Volterra Node on the same site.|
|Update the Node||Add the replaced node to the existing cluster.|
Note: Procedure to replace pool node is different to that of master node. However, the sequence of actions is same.
Replace Pool Node in a Multi-Node Site
Perform the following steps to replace a pool node.
Step 1: Log in to the Volterra Console and Select the
system namespace. Navigate to
Site Management ->
Step 2: Click on the
Other Registrations tab and find the pool node. Click
Decomission in the confirmation window.
Note: Confirm that the de-registered node shows up with the
RETIREDstate in the
Step 3: Delete the pool node from your public cloud location or enterprise locations as per your setup. In case of physical hardware, You may have to poweroff the node as part of decommissioning.
Note: You can also use Volterra terraform to destroy the node. See the Destroy chapter for Azure or AWS in Installation documents.
Step 4: Install another Volterra Node depending on the type of your setup and once the installation is complete, accept the registration from the console.
Note: During registration, ensure that the cluster name and size are same as that of the other nodes in the cluster. Also, ensure that the same image is used in case of certified hardware.
Replace Master Node in a Single-Node Site
Perform the following steps to replace a master node in a single-node site.
Step 1: Log in to the Volterra console and select the
system namespace. Navigate to
Step 2: Select your site from the displayed list. Click
Reregister again in the confirmation window.
Note: Confirm that the site shows up with the
Step 3: Shutdown and delete the node.
Note: Depending on the type of node, physical decommissioning may be required.
Step 4: Install another Volterra node as per the following guidelines:
- Use the same image as that of the replaced node in case of certified hardware.
- Configure the same site token as that of the node that is decommissioned.
- Set the site name same as that of the node that is decommissioned.
Note: See Installation for detailed installation instructions.
Step 5: Log in to the Volterra console with your tenant credentials to complete site registration.