TPVM Incremental Upgrade

Before you begin

EFA 3.0.0 and later releases support incremental upgrade. Ensure that the TPVM is running and the SLX version is 20.4.1 or later.

About this task

The TPVM incremental upgrade enables you to upgrade both active and standby TPVM nodes. The TPVM incremental upgrade is applicable for both multi-node and single node deployment with EFA running. This upgrade drastically reduces the upgrade time (around 3 minutes) compared to the full upgrade.

EFA automatically determines whether the TPVM upgrade is an incremental upgrade or a full upgrade based on the TPVM image name. If the image name contains inc_upg, then EFA determines that the upgrade as an incremental upgrade.

Note

Note

  • You can perform the incremental upgrade on either one of the TPVMs (active or standby) or on both the TPVMs at same time.
  • The efa inventory device tpvm-upgrade show command displays the failed state in case of upgrade failures.

    The efa inventory device tpvm-upgrade show command displays the TPVM information including version, IP address, device IP, TPVM hostname, and SLX version.

  • The TPVM upgrade can be restarted in case of EFA restart or inventory service restart.
  • TPVM upgrade execution detailed status (Detailed Status) shows whether a reboot is required for the incremental upgrade. If the incremental upgrade output shows that reboot is required for both active and standby nodes, ensure that you reboot the standby TPVM first, and then the active TPVM.

Procedure

  1. Run the efa inventory device tpvm-upgrade execute command.

    The CLI fetches either the active TPVM IP address or the standby TPVM IP address or both for a TPVM incremental upgrade. EFA does not allow more than one instance of TPVM incremental upgrade per device.

    efa inventory device tpvm-upgrade execute --10.24.44.66
  2. Run the efa inventory device tpvm-upgrade show command.

    The efa inventory device tpvm-upgrade show command shows the device status for a tpvm-upgrade operation.

    efa inventory device tpvm-upgrade show
    The following are the examples of a TPVM upgrade show:
    • TPVM Upgrade show with one TPVM IP address
      efa inventory device tpvm-upgrade show --ip 10.24.80.58
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------------+-----------------+-------------------------------+-------------------------------+-------------------------------+
      | IP Address  | Host Name | Model | Chassis Name |    ASN     | Role | Current TPVM Version | Target TPVM Version | Update State |             Status              | Detailed Status |          Start Time           |       Last Update Time        |          Failed  State        |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------------+-----------------+-------------------------------+-------------------------------+-------------------------------+
      | 10.24.80.58 | SLX       | 4001  | BR-SLX9640   | 4200000000 | Leaf | 4.5.0                | 4.5.0               | Completed    | TPVM Upgrade Workflow Completed | None            | 2022-05-19 08:31:11 -0700 PDT | 2022-05-19 08:33:52 -0700 PDT | TPVM Config Validation Failed |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------------+-----------------+-------------------------------+-------------------------------+-------------------------------+
      

      Failed State: Shows the last failed state, if upgrade fails. On a successful run, this is a null string.

    • TPVM Upgrade show with two TPVM IP addresses
      efa inventory device tpvm-upgrade show --ip 10.24.80.58,10.24.80.56
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------+-----------------+-------------------------------+-------------------------------+--------------+
      | IP Address  | Host Name | Model | Chassis Name |    ASN     | Role | Current TPVM Version | Target TPVM Version | Update State |          Status           | Detailed Status |          Start Time           |       Last Update Time        | Failed State |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------+-----------------+-------------------------------+-------------------------------+--------------+
      | 10.24.80.58 | SLX       | 4001  | BR-SLX9640   | 4200000000 | Leaf | 4.5.0                |                     | In Progress  | Device Validation Started | None            | 2022-05-26 13:41:14 -0700 PDT | 2022-05-26 13:41:19 -0700 PDT |              |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------+-----------------+-------------------------------+-------------------------------+--------------+
      | 10.24.80.56 | SLX       | 4001  | BR-SLX9640   | 4200000000 | Leaf | 4.5.0                |                     | In Progress  | Device Validation Started | None            | 2022-05-26 13:41:14 -0700 PDT | 2022-05-26 13:41:18 -0700 PDT |              |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------+-----------------+-------------------------------+-------------------------------+--------------+
      
    • TPVM Upgrade show with two TPVM IP addresses and image path
      efa inventory device tpvm-upgrade show --ip 10.24.80.58,10.24.80.56 --firmware-host 10.31.80.101 --tpvm-image <image_path>
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------+-----------------+-------------------------------+-------------------------------+--------------+
      |  IP Address | Host Name | Model | Chassis Name |     ASN    | Role | Current TPVM Version | Target TPVM Version | Update State |           Status          | Detailed Status |          Start Time           |         Last Update Time      | Failed State |
      +-------------+-----------+-------+--------------+-----+------+------+----------------------+---------------------+--------------+---------------------------+-----------------+-------------------------------+-------------------------------+--------------+
      | 10.24.80.58 |    SLX    | 4001  |  BR-SLX9640  | 4200000000 | Leaf | 4.5.0                |                     | In Progress  | Device Validation Started | None            | 2022-05-26 13:41:14 -0700 PDT | 2022-05-26 13:41:19 -0700 PDT |              |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------+-----------------+-------------------------------+-------------------------------+--------------+
      | 10.24.80.56 |    SLX    | 4001  |  BR-SLX9640  | 4200000000 | Leaf | 4.5.0                |                     | In Progress  | Device Validation Started | None            | 2022-05-26 13:41:14 -0700 PDT | 2022-05-26 13:41:18 -0700 PDT |              |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------+-----------------+-------------------------------+-------------------------------+--------------+
    • TPVM Upgrade show with execution ID
      efa inventory device tpvm-upgrade show --execution-id 670cb89e-d8d1-4213-ac97-20403458627f
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+----------------------+-----------------+-------------------------------+-------------------------------+--------------+
      | IP Address  | Host Name | Model | Chassis Name |    ASN     | Role | Current TPVM Version | Target TPVM Version | Update State |        Status        | Detailed Status |          Start Time           |       Last Update Time        | Failed State |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+----------------------+-----------------+-------------------------------+-------------------------------+--------------+
      | 10.24.80.58 | SLX       | 4001  | BR-SLX9640   | 4200000000 | Leaf | 4.5.0                |                     | In Progress  | TPVM Upgrade Started | None            | 2022-05-26 13:41:14 -0700 PDT | 2022-05-26 13:41:58 -0700 PDT |              |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+----------------------+-----------------+-------------------------------+-------------------------------+--------------+
      | 10.24.80.56 | SLX       | 4001  | BR-SLX9640   | 4200000000 | Leaf | 4.5.0                |                     | In Progress  | TPVM Upgrade Started | None            | 2022-05-26 13:41:14 -0700 PDT | 2022-05-26 13:41:54 -0700 PDT |              |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+----------------------+-----------------+-------------------------------+-------------------------------+--------------+
      TPVM Upgrade Show Details
      --- Time Elapsed: 124.961824ms ---
    • TPVM Upgrade show with reboot required information
      (efa:extreme)extreme@node180:~$ efa inventory device tpvm-upgrade show --ip 10.24.80.56,10.24.80.58
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------------+-----------------------------------+--------------+---------------------+-------------------------------+-------------------------------+
      | IP Address  | Host Name | Model | Chassis Name |    ASN     | Role | Current TPVM Version | Target TPVM Version | Update State |             Status              |          Detailed Status          | Failed State |    Upgrade Type     |          Start Time           |       Last Update Time        |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------------+-----------------------------------+--------------+---------------------+-------------------------------+-------------------------------+
      | 10.24.80.56 | SLX       | 4001  | BR-SLX9640   | 4200000000 | Leaf | 4.5.2                | 4.5.2               | Completed    | TPVM Upgrade Workflow Completed | Reboot Required for TPVM Instance |              | Incremental Upgrade | 2022-07-28 16:19:46 -0700 PDT | 2022-07-28 16:25:34 -0700 PDT |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------------+-----------------------------------+--------------+---------------------+-------------------------------+-------------------------------+
      | 10.24.80.58 | SLX       | 4001  | BR-SLX9640   | 4200000000 | Leaf | 4.5.2                | 4.5.2               | Completed    | TPVM Upgrade Workflow Completed | None                              |              | Incremental Upgrade | 2022-07-28 16:19:46 -0700 PDT | 2022-07-28 16:26:24 -0700 PDT |
      +-------------+-----------+-------+--------------+------------+------+----------------------+---------------------+--------------+---------------------------------+-----------------------------------+--------------+---------------------+-------------------------------+-------------------------------+
      TPVM Upgrade Show Details
      --- Time Elapsed: 156.8739ms ---
      (efa:extreme)extreme@node180:~$ 
  3. Run the efa inventory device tpvm list command.

    The efa inventory device tpvm list command shows the TPVM list information such as TPVM IP address, SLX IP address, TPVM hostname, TPVM version, and SLX firmware version.

     efa inventory device tpvm list
    ---------------------------------+----------------------------------------------------+--------------+
    | Device IP Address | TPVM IP Address | TPVM Hostname |      SLX Firmware Version     | TPVM Version |
    +-------------------+-----------------+---------------+-------------------------------+--------------+
    |    10.24.80.56    |    10.24.80.180 |     node180   | 20.4.2slxos20.4.2_220614_1000 |      4.5.0   |
    +-------------------+-----------------+---------------+-------------------------------+--------------+
    |    10.24.80.58    |    10.24.80.181 |     node181   | 20.4.1 | 4.5.0 |              |              |
    +-------------------+-----------------+---------------+-------------------------------+--------------+