The TPVM incremental upgrade
allows you to upgrade active and standby TPVM nodes. It is applicable for multi-node and
single-node deployment where XCO is running. It reduces the upgrade time (around 3
minutes) compared to the full upgrade.
Before you begin
- Ensure that you are using EFA
3.0.0 and later.
- Ensure that the TPVM is running and the SLX version is 20.4.1 or later.
About this task
XCO 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 the
upgrade is 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 the 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 XCO restart or inventory service restart.
- The Detailed Status of TPVM
upgrade shows whether a reboot is required for an incremental upgrade. If
the output of an incremental upgrade 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 command fetches either the active TPVM IP address or the standby TPVM IP
address or both for a TPVM incremental upgrade. XCO does not allow more
than one instance of TPVM incremental upgrade per device.
efa inventory device tpvm-upgrade execute --ip 10.20.48.162 --firmware-host 10.31.2.101 \ > --tpvm-image /buildsjc/sre_fusion/Nightly/tpvm/tpvm4.5.6/tpvm4.5.6_221103_2338/dist/ SWBD2900/tpvm_inc_upg-4.5.6-0.amd64.deb
-
Run the efa inventory device tpvm-upgrade show
command.
The command shows the device status for a TPVM upgrade operation.
efa inventory device tpvm-upgrade show
The following are the output examples of a TPVM upgrade show command:
- 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| Model |Chassis | ASN | Role | Current TPVM| Target TPVM| Update | Status | Detailed| Start Time | Last Update Time | Failed|
| | Name| |Name | | | Version | Version | State | | Status | | | State |
+-------------+-----+-------+----------+-----------+------+-------------+------------+--------+-------------+---------+-------------------+--------------------+-------+
| 10.24.80.58 | SLX | 4001 |BR-SLX9640| 4200000000| Leaf | 4.5.0 | |In | TPVM Upgrade| None | 2022-05-26 | 2022-05-26 | |
| | | | | | | | |Progress| Started | | 13:41:14 -0700 PDT| 13:41:58 -0700 PDT | |
+-------------+-----+-------+----------+-----------+------+-------------+------------+--------+-------------+---------+-------------------+--------------------+-------+
| 10.24.80.56 | SLX | 4001 |BR-SLX9640| 4200000000| Leaf | 4.5.0 | |In | TPVM Upgrade| None | 2022-05-26 | 2022-05-26 | |
| | | | | | | | |Progress| Started | | 13:41:14 -0700 PDT| 13:41:58 -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| Model |Chassis | ASN | Role | Current TPVM| Target TPVM| Update | Status | Detailed Status | Failed| Upgrade | Start Time | Last Update Time |
| | Name| |Name | | | Version | Version | State | | | State | Type | | |
+-------------+-----+-------+----------+-----------+------+-------------+------------+---------+-------------------+------------------+-------+------------+-------------------+-------------------+
| 10.24.80.56 | SLX | 4001 |BR-SLX9640| 4200000000| Leaf | 4.5.2 | 4.5.2 |Completed| TPVM Upgrade | Reboot Required | | Incremental| 2022-07-28 | 2022-07-28 |
| | | | | | | | | | Workflow Completed| for TPVM Instance| | Upgrade | 16:19:46 -0700 PDT| 16:25:34 -0700 PDT|
+-------------+-----+-------+----------+-----------+------+-------------+------------+---------+-------------------+------------------+-------+------------+-------------------+-------------------+
| 10.24.80.58 | SLX | 4001 |BR-SLX9640| 4200000000| Leaf | 4.5.2 | 4.5.2 |Completed| TPVM Upgrade | None | | Incremental| 2022-07-28 | 2022-07-28 |
| | | | | | | | | | Workflow Completed| | | Upgrade | 16:19:46 -0700 PDT| 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 command shows the information, such as TPVM IP address, SLX IP address,
TPVM hostname, TPVM version, and SLX firmware version.
efa inventory device tpvm list
+------------+-------------+---------+-------------------------------+-------+
| Device IP | TPVM IP | TPVM | SLX Firmware Version | TPVM |
| Address | Address | Hostname| | Verson|
+------------+-------------+---------+-------------------------------+-------+
| 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 | | |
+------------+-------------+---------+-------------------------------+-------+
