Upgrade EFA, SLX-OS, and TPVM Option 2

Use this upgrade option if the latest version of EFA is supported on your version of TPVM.

About this task

This option is the preferred method for upgrading EFA, SLX-OS, and TPVM. For more information about supported versions, see Supported Platforms and Deployment Models.

In the following procedure, SLX1 refers to the active EFA node (TPVM1). SLX2 refers to the standby EFA node (TPVM2).

Procedure

  1. Upgrade EFA to the latest version.
    1. Back up EFA.
      efa system backup
    2. SCP the backup file to a location outside of TPVM, such as the /efaboot partition of SLX-OS where the EFA image is kept.
    3. Copy the EFA 2.5.x image to the /efaboot directory on SLX1.
    4. Deploy EFA on SLX1.
      efa deploy
    5. When prompted, select Multi Node Build Upgrade.
  2. Upgrade SLX-OS to the latest version.

    SLX upgrade from v20.2.3x to v20.3.2a needs fullinstall. The procedure performs fabric-wide firmware download by staging the devices in multiple groups with no traffic disruption. Complete the following steps to run the firmware download on all the devices in fabric:

    1. Run the following commands on SLX1 (the active node, TPVM1) to upgrade SLX2 to the latest version.
      efa inventory firmware-host register --ip <fw-host-ip> --protocol scp --username <username> --password <password>
      
    2. Run the following commands on TPVM1 via EFA to upgrade SLX from 20.2.3f to 20.3.2a:
      efa inventory device firmware-download prepare add --fabric <fabric name> --firmware-host <fw-host-ip> --firmware-directory <fw-path>
      efa inventory device firmware-download prepare list --fabric <fabric name>
      efa inventory device firmware-download execute --fabric <fabric name> 
      efa inventory device firmware-download show --fabric <fabric name>
      
  3. Upgrade TPVM2 to the latest version.
    Upgrade TPVM2 first, because it is in the standby node.
    Note

    Note

    • SLX 20.3.2a and later configures TPVM in configuration mode, persisting the configuration in subsequent SLX upgrades. You do not need to change the configuration in subsequent TPVM upgrades. When an SLX device that hosts TPVM is upgraded from an earlier release to 20.3.2a, the existing TPVM continues to run and all TPVM parameters configured using tpvm config command get converted to TPVM config block commands. An exception to this is "trusted-peer" configuration, which you must manually redo after the upgrade.

      For information on TPVM configuration block and migration details, see the SLX 20.3.2a TPVM documentation.

    • If you have deployed TPVM using SLX configuration mode, copying a default configuration or remote configuration without TPVM config block into SLX startup config, rebooting of device has clearing effect on the running TPVM, and the TPVM gets removed from the device. For preserving the running TPVM, you must add the TPVM configuration block into the configuration file.
    1. On SLX2, run the following commands.
      device# tpvm stop
      device# tpvm uninstall force
    2. Copy the new TPVM build (replace tpvm-4.2.4.deb with tpvm-4.2.5.deb) to the /tftpboot/SWBD2900/ directory.
    3. Set all TPVM2-related parameters in SLX2 config mode.
      SLX2(config-tpvm-TPVM)# no deploy
      SLX2(config-tpvm-TPVM)# auto-boot
      SLX2(config-tpvm-TPVM)# ntp <ip add>
      SLX2(config-tpvm-TPVM)# hostname <unique hostname>
      SLX2(config-tpvm-TPVM)# trusted-peer ip <peer-ip> password  <password>
      SLX2(config-tpvm-TPVM)# interface management ip <ip add>/<subnet mask> gw <gw IP>
      SLX2(config-tpvm-TPVM)# deploy
      
    4. Copy the EFA 2.5.x image to the /efaboot directory on SLX1.
    5. Run the SLX CLI to deploy EFA on SLX1.
      efa deploy
    6. When prompted, select Multi Node Build Upgrade with Node Replacement.

    TPVM1 is considered next for the upgrade.

  4. Upgrade TPVM1 to the latest version.
    1. On SLX1, run the following commands.
      device# tpvm stop
      device# tpvm uninstall force
    2. Copy the new TPVM build (replace tpvm-4.2.4.deb with tpvm-4.2.5.deb) to the /tftpboot/SWBD2900/ directory.
    3. Set all the TPVM1-related parameters in SLX1 config mode.
    4. Perform a fresh installation of TPVM.
      SLX1(config-tpvm-TPVM)# no deploy
      SLX1(config-tpvm-TPVM)# auto-boot
      SLX1(config-tpvm-TPVM)# ntp <ip add>
      SLX1(config-tpvm-TPVM)# hostname <unique hostname>
      SLX1(config-tpvm-TPVM)# trusted-peer ip <peer-ip> password  <password>
      SLX1(config-tpvm-TPVM)# interface management ip <ip add>/<subnet mask> gw <gw IP>
      SLX1(config-tpvm-TPVM)# deploy
      
    5. Copy the EFA 2.5.x image to the /efaboot directory on SLX2.
    6. Deploy EFA on SLX2.
      efa deploy
    7. When prompted, select Multi Node Build Upgrade with Node Replacement.