Install XCO on TPVM in a Multi-Node Deployment

You can install XCO on a TPVM (Third-Party Virtual Machine) in a two-node deployment for high availability.

Before you begin

Ensure that the EFA tar file is available on the /efaboot partition of the SLX device. XCO on TPVM is supported only on the platforms described in Supported Platforms and Deployment Models for Fabric Skill.

About this task

Follow this procedure to install XCO on a TPVM in a multi-node deployment.

Procedure

  1. Run the show tpvm status command and verify that the TPVM is set up for an XCO deployment.
    1. Verify the versions of TPVM and SLX-OS.
      For the supported version information, see Supported Platforms and Deployment Models for Fabric Skill.
    2. Verify that the TPVM has an assigned IP address.
    3. Verify that the SSH keys are uploaded.
    4. (For SLX-OS releases earlier than 20.2.3) Verify that the passwordless access is configured.
    5. (For SLX-OS 20.2.3 and later with TPVM version 4.2.2 and later) Verify that the passwordless access is configured for the peer.
    6. Verify that the NTP is configured on TPVM by running the show run tpvm command. If NTP is not configured, configure it by running the following command.
      device# tpvm config ntp add server <ip>
    7. Verify that NTP is synchronized.
    8. (Optional) Log in to TPVM and configure the NTP time zone from SLX.
      device# tpvm config timezone
    9. (Optional) Configure unique TPVM host names.
      device# tpvm config host
  2. Enter SLX Linux mode.
    device# start-shell
  3. Copy the XCO tar file to the SLX device.
    # scp efa-x.x.x.tar.gz
  4. Deploy XCO on TPVM from the SLX command line.
    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-2.x.x.tar.gz on 10.x.x.x
    Note

    Note

    From SLX version 20.4.1 and above, any new install or upgrade of XCO on TPVM in a multi-node deployment displays the following warning banner:
    **********************************************************************
    *                 ! ! ! WARNING ! ! !                                *
    *  Proceeding with Extreme Fabric Automation deployment              *
    *       1. Do not reboot device(s) or TPVM(s)                        *
    *       2. Do not toggle management port on device(s) or TPVM(s)     *
    *       3. Avoid CTRL+C on the installer window                      *
    **********************************************************************

    The XCO Installer begins in a series of dialogs.

  5. When prompted, select Multi-node deployment and OK.
    Tip

    Tip

    Use arrow keys to move between options. Press the space bar to select an option.
  6. When prompted, select the IP mode and OK.
    Tip

    Tip

    Use arrow keys to move between options. Press the space bar to select an option.
  7. When prompted, enter the peer IP address or FQDN of the other node in the cluster.
  8. When prompted, enter the virtual IP address for the cluster.
  9. When prompted, enter the virtual IPv6 address for the cluster.
    • Select Yes and then provide the virtual IPv6 addresses.
    • Select No to ignore this optional step.
  10. When prompted to configure additional IP addresses for a health check, take one of the following steps.
    • Select Yes and then provide the IPv4 or IPv6 addresses.
    • Select No to ignore this optional step.
  11. When prompted to configure additional management IP networks, take one of the following steps.
    • Select Yes and then provide the following information when prompted. Repeat as often as necessary.
      • Sub-interface name, which is a unique name that contains no more than 11 characters, no white space, and no % or / characters.
      • ID of the VLAN that the management network uses to tag traffic. Valid values range from 2 through 4093.
      • IP subnet address in CIDR format. The subnet must not overlap with any IP subnet that you have already provided.
      • An IPv6 address is optional, but an IPv4 address is mandatory.
    • Select No to ignore this optional step or when you have finished entering network information.
  12. When prompted to configure additional management IP network routes, take one of the following steps.
    Note

    Note

    XCO Management Interface must have IPv4 address configured. Adding IPv6 address is optional while IPv4 is mandatory.

    • Select Yes and then provide the following information when prompted. Repeat as often as necessary.
      • Target network IP address in CIDR format
      • Source IP address for outbound traffic
      • Next-hop or gateway IP address through which access to the destination network is provided
    • Select No to ignore this optional step or when you have finished entering route information.
    As the installation proceeds, messages display showing the installation progress.
  13. Verify the installation.
    1. On the SLX device, run the show efa status command to see details of the installation and the state of services.
    2. From the XCO command line, run the efactl status command to see the status of nodes, pods, and services.
    3. From the XCO command line, run the efa status command for concise status information.