Install XCO on TPVM in a Single-Node Deployment

You can install XCO on an SLX TPVM in a single-node deployment.

Before you begin

The XCO tar must be available on the /efaboot partition of the SLX device.

About this task

XCO on TPVM is supported only on the platforms described in Supported Platforms and Deployment Models for Fabric Skill.

Procedure

Verify that the TPVM is set up for an XCO deployment.
1. Verify that the version, SSH keys, and passwordless access configuration are correct for the TPVM via the SLX console or SSH.
  For the latest supported version information, see Supported Platforms and Deployment Models for Fabric Skill.
```
device# show tpvm status
device# show version
```
2. Verify the versions via the TPVM console or SSH.
```
device# lsb_release -a
```
3. Verify that NTP is synchronized.
```
device# show tpvm config ntp 
```
4. If necessary, log in to TPVM and configure the NTP time zone.
```
device# tpvm config timezone
```
Enter SLX Linux mode.
```
device# start-shell
# cd /efaboot
```

Copy the XCO tar file to the SLX device.

device# start-shell
device# scp user@remote-server:~/builds/efa/efa-3.1.0.tar.gz /efaboot/

Verify the PGP signature as described in article 48172 on the Extreme Portal.

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-2.x.x.tar.gz on 10.x.x.x

Note

From SLX version 20.4.1 and above, new install or upgrade of XCO on TPVM in a single-node deployment displays the following warning banner on the console:

**********************************************************************
*                 ! ! ! 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 continues in a series of dialogs.

When prompted, select Single-node deployment and OK.

Tip
Use arrow keys to move between options and the space bar to select an option.
(Optional) When prompted to configure additional management IP networks, take one of the following steps.
- Select Yes and then provide the following information when prompted.
  - 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 sub-interface information.
The installation proceeds. Messages summarize your selections, describe the progress, and indicate when XCO is deployed.
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 sudo efactl status command to see the status of nodes, pods, and services.
3. Run the efa status command for concise status information.