Replace a Node in a Multi-node TPVM Deployment

You can use the upgrade process to replace a faulty node in a multi-node TPVM deployment.

Before you begin

  • Ensure that the cluster with faulty node is running EFA 2.5.5 or later.
  • Ensure that you have completed the high-availability prerequisites described in TPVM High-Availability Requirements.
  • Ensure that XCO is not deployed on the replacement node.

About this task

During node replacement process, the faulty node is decommissioned, the replacement node is provisioned, and the active node is reconfigured to form a cluster.

Perform this procedure on the active node where XCO is installed.

Procedure

  1. Enter SLX Linux mode and copy the XCO tar file to the SLX device.
    device# start-shell
    
    scp <username>@<hostip>:<buildpath>/efa-3.3.0.tar.gz
  2. Deploy XCO on TPVM from the SLX shell.
    device# efa deploy
    Starting "efa deploy", DO NOT hit CTRL+C
    Step 1: Checking if TPVM is deployed ...
    Step 2: Get IP Addressed assigned to TPVM to deploy EFA
    IP Address of the TPVM 10.x.x.x
    Step 3: Checking for EFA packages in /efaboot directory
    Step 4: Deploying EFA package efa-3.x.x.tar.gz on 10.x.x.x

    The XCO Installer begins in a series of dialogs.

  3. When prompted, select Multi Node Build Upgrade with Node Replacement and OK.
    Tip

    Tip

    Use arrow keys to move between options. Press the space bar to select an option.
  4. When prompted, enter the IP address or host name of the replacement peer node depending on the IP stack selected. Select OK.
    As the node replacement proceeds, messages display showing the replacement progress.
  5. Verify the status of XCO after the node replacement.
    device# sudo efactl status
    Note

    Note

    To recover the SLX configuration, see the "Replace a Faulty Device" topic in the ExtremeCloud Orchestrator CLI Administration Guide, 3.3.0 .