ExtremeCloud Orchestrator Deployment Guide

Download the XCO tar file and the digests file to a Linux server. Use these files to transfer the tar file to the SLX as a remote host.

```bash
remote-server$ ls
efa-3.3.0-digests.tar.gz  efa-3.3.0.tar.gz

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

While the upgrade process does make a backup of the XCO state, as a best practice, perform a manual backup before every upgrade to create a remote copy of the backup.

Enter SLX Linux mode, and transfer the tarball to the SLX using SCP.

Note

You can copy multiple XCO tarballs to the /efaboot/ directory.

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

To deploy XCO on TPVM from the SLX command line, run the efa deploy command.

If you have multiple XCO tarballs in the /efaboot/ directory, choose a target version of XCO to install from the version selection menu.

Note

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

SLX# efa deploy
    Step 1: Get IP Address assigned to TPVM to deploy EFA 10.x.x.x.
    Step 2: Checking for EFA packages in /efaboot directory
    1. /efaboot/efa-3.3.0.tar.gz
    2. /efaboot/efa-3.3.0.tar.gz
    Enter option: 1
    **********************************************************************
    *                 ! ! ! 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                      *
    **********************************************************************
    Copying EFA package efa-3.3.0.tar.gz to TPVM 10.x.x.x... done.
    Extracting EFA package efa-3.3.0.tar.gz on TPVM 10.x.x.x... done.
    Starting EFA installer.
    
    The EFA Installer will continue with a series of dialogs.

When prompted, select Single-node deployment and OK.

Tip

Use arrow keys to move between options. Press the space bar to select an option.

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 for IPv4 mode or IPv6 subnet address for IPv6 mode in CIDR format. The subnet must not overlap with any IP subnet that you have already provided.
- In Dual mode, an IPv6 address is optional, but an IPv4 address is mandatory.
Select No to ignore this optional step or when you have finished entering subinterface information.

As the installation proceeds, messages display showing the installation progress

Verify the installation.

On the SLX device, run the show efa status command to see details of the installation and the state of services.
From the EFA command line on the TPVM console or SSH session, run the sudo efactl status command to see the status of nodes, pods, and services.
Ensure that all the containers are in the "Running" state.

Run the show efa status command to view the status information.

Ensure that the status of all the nodes are up.

SLX# show efa status
    ===================================================
                EFA version details                  
    ===================================================
    Version : 3.3.0
    Build: GA
    Time Stamp: 23-8-8:17:11:29
    Mode: Secure
    Deployment Type: single-node
    Deployment Platform: TPVM
    Deployment Suite: Fabric Automation
    Node IP: 10.20.229.54
    --- Time Elapsed: 848.174µs ---

    ===================================================
                EFA Status                          
    ===================================================

    +-----------------+--------+--------+--------------+
    | Node Name       | Role   | Status | IP           |
    +-----------------+--------+--------+--------------+
    | tpvm-xco-229-54 | active | up     | 10.20.229.54 |
    +-----------------+--------+--------+--------------+
    --- Time Elapsed: 6.260854749s ---
        
    extreme@tvpm$ sudo efactl status
    Node: efa
    NAME                               READY   STATUS    RESTARTS   AGE   IP             NODE   NOMINATED NODE   READINESS GATES
    pod/efa-api-docs-sbg9x             1/1     Running   0          12m   10.42.194.71   efa    <none>           <none>
    pod/gosystem-service-m7245         1/1     Running   0          12m   10.42.194.74   efa    <none>           <none>
    pod/rabbitmq-cf57z                 1/1     Running   0          13m   10.42.194.68   efa    <none>           <none>
    pod/gonotification-service-5nhqb   1/1     Running   0          11m   10.20.229.54   efa    <none>           <none>
    pod/goinventory-service-m8fgm      1/1     Running   0          12m   10.42.194.69   efa    <none>           <none>
    pod/goauth-service-qr7zs           1/1     Running   0          12m   10.42.194.70   efa    <none>           <none>
    pod/gofaultmanager-service-gszrm   1/1     Running   0          12m   10.42.194.72   efa    <none>           <none>
    pod/gofabric-service-wrl6z         1/1     Running   0          12m   10.42.194.76   efa    <none>           <none>
    pod/gopolicy-service-4llmn         1/1     Running   0          12m   10.42.194.75   efa    <none>           <none>
    pod/goraslog-service-2w8hj         1/1     Running   0          12m   10.20.229.54   efa    <none>           <none>
    pod/gotenant-service-zhbp2         1/1     Running   0          12m   10.42.194.77   efa    <none>           <none>
    pod/gosnmp-service-5jnqv           1/1     Running   0          11m   10.20.229.54   efa    <none>           <none>
    pod/gorbac-service-jnttb           1/1     Running   0          12m   10.42.194.73   efa    <none>           <none>

    NAME                             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                          AGE   SELECTOR
    service/rabbitmq                 ClusterIP   10.43.219.62    <none>        15672/TCP,5672/TCP               13m   app=rabbitmq
    service/rabbitmq-local           NodePort    10.43.200.66    <none>        15672:30673/TCP,5672:30672/TCP   13m   app=rabbitmq
    service/goinventory-service      ClusterIP   10.43.96.100    <none>        8082/TCP                         12m   app=goinventory-service
    service/efa-api-docs             ClusterIP   10.43.127.190   <none>        80/TCP                           12m   app=efa-api-docs
    service/goraslog-service         ClusterIP   10.43.19.118    <none>        8091/TCP                         12m   app=goraslog-service
    service/gonotification-service   ClusterIP   10.43.11.74     <none>        8088/TCP                         12m   app=gonotification-service
    service/goauth-service           ClusterIP   10.43.133.78    <none>        8080/TCP                         12m   app=goauth-service
    service/gorbac-service           ClusterIP   10.43.228.98    <none>        8089/TCP                         12m   app=gorbac-service
    service/gofaultmanager-service   ClusterIP   10.43.58.187    <none>        8094/TCP                         12m   app=gofaultmanager-service
    service/gosystem-service         ClusterIP   10.43.141.200   <none>        8090/TCP                         12m   app=gosystem-service
    service/gofabric-service         ClusterIP   10.43.245.50    <none>        8081/TCP                         12m   app=gofabric-service
    service/gopolicy-service         ClusterIP   10.43.36.27     <none>        8093/TCP                         12m   app=gopolicy-service
    service/gotenant-service         ClusterIP   10.43.52.211    <none>        8083/TCP                         12m   app=gotenant-service
    service/goopenstack-service      ClusterIP   10.43.26.123    <none>        8085/TCP                         12m   app=goopenstack-service
    service/govcenter-service        ClusterIP   10.43.21.5      <none>        8086/TCP                         12m   app=govcenter-service
    service/gohyperv-service         ClusterIP   10.43.43.180    <none>        8087/TCP                         12m   app=gohyperv-service
    service/gosnmp-service           ClusterIP   10.43.78.109    <none>        8092/TCP                         12m   app=gosnmp-service

    NAME                                    DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR      AGE   CONTAINERS               IMAGES                 SELECTOR
    daemonset.apps/goopenstack-service      0         0         0       0            0           non-existing=true  12m   openstack                goopenstack:3.3.0      app=goopenstack-service
    daemonset.apps/efa-api-docs             1         1         1       1            1           <none>             12m   efa-api-docs             efa-api-docs:3.3.0     app=efa-api-docs
    daemonset.apps/govcenter-service        0         0         0       0            0           non-existing=true  12m   vcenter                  govcenter:3.3.0        app=govcenter-service
    daemonset.apps/gohyperv-service         0         0         0       0            0           non-existing=true  12m   hyperv                   gohyperv:3.3.0         app=gohyperv-service
    daemonset.apps/gosystem-service         1         1         1       1            1           <none>             12m   gosystem                 gosystem:3.3.0         app=gosystem-service
    daemonset.apps/rabbitmq                 1         1         1       1            1           <none>             13m   rabbitmq-node            rabbitmq:33.0         app=rabbitmq
    daemonset.apps/gonotification-service   1         1         1       1            1           <none>             12m   gonotification-service   gonotification:3.3.0   app=gonotification-service
    daemonset.apps/goinventory-service      1         1         1       1            1           <none>             12m   goinventory-service      goinventory:3.3.0      app=goinventory-service
    daemonset.apps/goauth-service           1         1         1       1            1           <none>             12m   go-auth                  goauth:3.3.0           app=goauth-service
    daemonset.apps/gofaultmanager-service   1         1         1       1            1           <none>             12m   gofaultmanager-service   gofaultmanager:3.3.0   app=gofaultmanager-service
    daemonset.apps/gofabric-service         1         1         1       1            1           <none>             12m   gofabric-service         gofabric:3.3.0         app=gofabric-service
    daemonset.apps/gopolicy-service         1         1         1       1            1           <none>             12m   gopolicy-service         gopolicy:3.3.0         app=gopolicy-service
    daemonset.apps/goraslog-service         1         1         1       1            1           <none>             12m   goraslog-service         goraslog:3.3.0         app=goraslog-service
    daemonset.apps/gotenant-service         1         1         1       1            1           <none>             12m   gotenant-service         gotenant:3.3.0         app=gotenant-service
    daemonset.apps/gosnmp-service           1         1         1       1            1           <none>             12m   gosnmp-service           gosnmp:3.3.0           app=gosnmp-service
    daemonset.apps/gorbac-service           1         1         1       1            1           <none>             12m   go-rbac                  gorbac:3.3.0           app=gorbac-service
    extreme@tpvm:~$ efa login
    Password:
    Login successful.
    --- Time Elapsed: 4.121103171s ---
    (efa:extreme)extreme@tpvm:~$ efa status
    +-----------------+--------+--------+--------------+
    | Node Name       | Role   | Status | IP           |
    +-----------------+--------+--------+--------------+
    | tpvm-xco-229-54 | active | up     | 10.20.229.54 |
    +-----------------+--------+--------+--------------+
    --- Time Elapsed: 4.656427295s ---

Upgrade XCO on TPVM in a Single-Node Deployment

About this task

Procedure