Upgrade XCO on TPVM in a Single-Node Deployment

You can upgrade single-node XCO on TPVM.

About this task

Follow this procedure to upgrade XCO in TPVM in a single-node deployment.

Procedure

  1. 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.4.0-digests.tar.gz  efa-3.4.0.tar.gz
  2. Verify the PGP signature as described in article 48172 on the Extreme Portal.
  3. 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.
  4. Enter SLX Linux mode, and transfer the tarball to the SLX using SCP.
    Note

    Note

    You can copy multiple XCO tarballs to the /efaboot/ directory.
    SLX# start-shell
        device$ scp user@remote-server:~/builds/efa/efa-3.4.0.tar.gz /efaboot/
  5. 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

    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.4.0.tar.gz
        2. /efaboot/efa-3.4.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.4.0.tar.gz to TPVM 10.x.x.x... done.
        Extracting EFA package efa-3.4.0.tar.gz on TPVM 10.x.x.x... done.
        Starting EFA installer.
        
        The EFA Installer will continue with a series of dialogs.
  6. When prompted, select Single-node deployment and OK.
    Tip

    Tip

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

  7. 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

  8. 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 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.
    3. Run the show efa status command to view the status information.
      Ensure that all nodes are up.
      SLX# show efa status
          ===================================================
                      EFA version details                  
          ===================================================
          Version : 3.4.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.4.0      app=goopenstack-service
          daemonset.apps/efa-api-docs             1         1         1       1            1           <none>             12m   efa-api-docs             efa-api-docs:3.4.0     app=efa-api-docs
          daemonset.apps/govcenter-service        0         0         0       0            0           non-existing=true  12m   vcenter                  govcenter:3.4.0        app=govcenter-service
          daemonset.apps/gohyperv-service         0         0         0       0            0           non-existing=true  12m   hyperv                   gohyperv:3.4.0         app=gohyperv-service
          daemonset.apps/gosystem-service         1         1         1       1            1           <none>             12m   gosystem                 gosystem:3.4.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.4.0   app=gonotification-service
          daemonset.apps/goinventory-service      1         1         1       1            1           <none>             12m   goinventory-service      goinventory:3.4.0      app=goinventory-service
          daemonset.apps/goauth-service           1         1         1       1            1           <none>             12m   go-auth                  goauth:3.4.0           app=goauth-service
          daemonset.apps/gofaultmanager-service   1         1         1       1            1           <none>             12m   gofaultmanager-service   gofaultmanager:3.4.0   app=gofaultmanager-service
          daemonset.apps/gofabric-service         1         1         1       1            1           <none>             12m   gofabric-service         gofabric:3.4.0         app=gofabric-service
          daemonset.apps/gopolicy-service         1         1         1       1            1           <none>             12m   gopolicy-service         gopolicy:3.4.0         app=gopolicy-service
          daemonset.apps/goraslog-service         1         1         1       1            1           <none>             12m   goraslog-service         goraslog:3.4.0         app=goraslog-service
          daemonset.apps/gotenant-service         1         1         1       1            1           <none>             12m   gotenant-service         gotenant:3.4.0         app=gotenant-service
          daemonset.apps/gosnmp-service           1         1         1       1            1           <none>             12m   gosnmp-service           gosnmp:3.4.0           app=gosnmp-service
          daemonset.apps/gorbac-service           1         1         1       1            1           <none>             12m   go-rbac                  gorbac:3.4.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 ---