Reset Search



KB13727 - [Clustering] I have received my replacement PPS, how do I join it to my existing cluster?

« Go Back


Last Modified Date8/9/2015 1:36 AM
How to add a new or a replacement (RMA) unit to an Infranet Controller (PPS) cluster.
Problem or Goal
You would like to add a new node to your cluster via CLI or you have received a new RMA device and you would like to join it to an existing cluster.
There are two scenario's that you should consider before undertaking this task, as care must be exercised so that you do not inadvertently delete your running configuration. 
  • The first scenario - when replacing the Secondary Node or the device containing the Clustering license. 
  • The second scenario  - when replacing the Primary Node (the device without Clustering license). 

Instructions for replacing the Secondary Node or the device which contains your Clustering license:
  1. Create a backup of the system and user configs from the remaining node in the cluster; this is to be kept for backup purposes.  We also suggest that you capture a screenshot of the licensing page from the remaining node.
  2. While viewing the clustering page of the leader IC, ensure that the RMA'd device has been removed from the cluster by logging into the Cluster Leader and going to System > Clustering > Status. If the RMA'd appliance is still present but simply disabled, please check the box next to the disabled device and click “Remove”.  At this point set the sync rank to a value of 50 on the “Leader” and then click Update; this will ensure that the configuration from this PPS is written to the device we are about to add.

    User-added image
  3. Add the replacement device as a cluster member.  Take note of the “Cluster Name”, the IP Address of the “Leader” and also ensure that you have the cluster password before proceeding to the next step.
  4. Connect to console of the new device and power it up. Shortly after the “starting system software version X.XX” message you will see the option to “Hit Tab for clustering options” prompt.  Press the “Tab” key.
  5. At the next prompt select option 2, “Join an existing cluster”.
  6. When prompted, enter the cluster name, the cluster password, the internal IP Address of the Cluster Leader, and finally the IP Address, Netmask and Gateway for the new (replacement) device.
  7. After adding the requested information, continue with the cluster join operation.  If you believe that the configuration has been entered correctly, please press option 1 and then hit enter.  You should now see the cluster members and their status listed as "on" (in the enabled column).  See sample below:
  8. The final step is to connect to the new (replacement) PPS, https://<NewDeviceIP>/admin and apply the correct license.  Note that your hardware ID will have changed and that a new license will need to be provided.  This can be acquired by logging into the License Management System.
  9. A healthy cluster license page will look like this, without any red Xs
    User-added image

Instructions for replacing the Primary Node or the device which does not contain your Clustering license:
  1. Create a backup of the system and user configurations from the remaining node in the cluster; this is to be kept as a backup. We also suggest that you backup the screenshot of the licensing page from the remaining node.
  2. Generate new licenses for this RMA unit via the License Management System.
  3. On the RMA device, configure the IP settings so that they match the IP configuration on the defective device.
  4. Upgrade the RMA unit to the same software level as the working node (the passive node with only CL license).  Note that after the upgrade, the RMA device will have no license, a basic configuration and no cluster information.
  5. After the upgrade has been completed, check the IP configuration of the RMA unit, making sure it is configured to match the device that it is replacing.

    Ensure that you have all of the cluster information; this data will be used in the next step.
    • Cluster name
    • Cluster password
    • IP address of internal port of existing working node
    • IP address of internal port of this RMA node
    • Subnet mask of the RMA node (same as the other node since this is A/P)
    • Gateway of the RMA node (same as the other node since this is A/P)
  6. Then, with the serial console device monitoring the RMA Device, reboot the IC (power this down and then up). When asked about clustering, press “TAB” key, then choose to join an existing cluster. You will then be prompted for the Cluster information that you collected in the step above, please enter it as appropriate.
  7. Choose option 1 to continue joining the cluster.
  8. The cluster will restart and the RMA unit will be restored to be the primary.  All configs will be synchronized from the PASSIVE node to this new ACTIVE node.  If you login to the VIP, you will see the status of cluster to be transitioning and then becomes ready or enabled.
  9. Next, apply the license which you created in the steps above. The current “Temporary License” will be replaced with your permanent license upon completion of this step.
  10. The final step is to verify that the configuration was successful; this can be done through a visual inspection of the device's configuration.
Related Links
Attachment 1 
Created ByData Deployment



Was this article helpful?



Please tell us how we can make this article more useful.

Characters Remaining: 255