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
- 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
-
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
-
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:~$
-
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 | | |
+-------------------+-----------------+---------------+-------------------------------+--------------+