efa inventory device firmware-download prepare add

Prepares a device for a firmware download. Firmware host sanity validations are done at this time. If the validations are successful, the device is prepared.

Syntax

efa inventory device firmware-download prepare add --fabric fabric name [ --ip device ip address | --group group number | --force |--firmware-host firmware download host ip address | --firmware-directory path to the target firmware build | --help ]

Command Default

Traffic loss expected for non-redundant devices (single non-MCT leaf, spine, or super spine).

Parameters

--fabric
Name of the fabric. Using the --fabric parameter automatically generates a group-based prepared list. The --group parameter is not permitted with the --fabric parameter.
--group
Group number. Using the --ip and optionally --group parameters adds the specified devices in the prepared list group. Group 1 is implicitly used if not specified with the --ip parameter.
--force
Bypasses all validations and forcefully prepares the device. The --force parameter can be used to download the same existing firmware version on the device. Normally, this is not allowed. However, using the --force parameter implicitly performs a full installation to carry out the same firmware version download.
--firmware-host
Firmware download host IP address
--firmware-directory
Path to the target firmware build
--ip
Specifies a comma-separated list of device IP addresses.
  • Using the --ip and optionally --group parameters adds the specified devices in the prepared list group. Group 1 is implicitly used if not specified with the --ip parameter.
  • Using the --ip and optionally --force parameters bypasses all validations and forcefully prepare the device in the default group 1 or in any group number if the --group parameter is specified. This can be used if the user does not care about traffic loss and wants to perform the firmware download simultaneously on all devices. The firmware restart-ability should allow for both EFA hosted node‘s SLX firmware to be upgraded simultaneously.
--help
Help for add

Usage Guidelines

Firmware host must be registered.

Device IPs belong to the same fabric (for Clos topologies).

Do not allow devices to be prepared if a firmware-download is in progress.

Allow a device to be prepared after a firmware-download has completed or in an unprepared state.

Do not allow for both MCT leaf pairs to be prepared together.

Do not allow for all spines in the same pod of the same fabric to be prepared together.

Do not allow for all super-spines in the fabric to be prepared together.

Firmware sanity check performed for the registered firmware-host and firmware-directory on the given device.

Examples

This example prepares half of the devices in Group 1. Group 1 is default when a --group parameter is not provided.
$ efa inventory device firmware-download prepare add --ip 10.20.245.1,10.20.245.3,10.20.245.5,10.20.245.9 --firmware-host 10.20.241.101 --firmware-directory /build/slx/slxos20.2.3a
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| Group |  IP Address  |  Host Name  | Model | Chassis Name | ASN | Role  | Current Firmware | Firmware Host |   Firmware Directory    | Target Firmware |       Last Update Time        |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.1  | L1          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:30 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.3  | L3          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:30 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.5  | L5          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:30 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.9  | S1          | 3012  | SLX9250-32C  | 0   | Spine | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:30 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
Firmware Download Prepare Add Details
Validate Firmware Download Prepare Add [success]
This example prepares the remaining half of devices in Group 3.
$ efa inventory device firmware-download prepare add --ip 10.20.245.2,10.20.245.4,10.20.245.6,10.20.245.10 --group 3 --firmware-host 10.20.241.101 --firmware-directory /build/slx/slxos20.2.3a
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| Group |  IP Address  |  Host Name  | Model | Chassis Name | ASN | Role  | Current Firmware | Firmware Host |   Firmware Directory    | Target Firmware |       Last Update Time        |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 3     | 10.20.245.2  | L2          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:38 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 3     | 10.20.245.4  | L4          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:38 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 3     | 10.20.245.6  | L6          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:38 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 3     | 10.20.245.10 | S2          | 3012  | SLX9250-32C  | 0   | Spine | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:38 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
Firmware Download Prepare Add Details
Validate Firmware Download Prepare Add [success]
This example lists all groups of devices that are prepared in the fabric.
$ efa inventory device firmware-download prepare list --fabric fab_3stg
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| Group |  IP Address  |  Host Name  | Model | Chassis Name | ASN | Role  | Current Firmware | Firmware Host |   Firmware Directory    | Target Firmware |       Last Update Time        |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.1  | L1          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:30 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.3  | L3          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:30 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.5  | L5          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:30 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.9  | S1          | 3012  | SLX9250-32C  | 0   | Spine | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:30 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 3     | 10.20.245.2  | L2          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:38 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 3     | 10.20.245.4  | L4          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:38 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 3     | 10.20.245.6  | L6          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:38 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 3     | 10.20.245.10 | S2          | 3012  | SLX9250-32C  | 0   | Spine | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:14:38 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
Firmware Download Prepare List Details
Validate Firmware Download Prepare List [success]
This example prepares the fabric and lets EFA automatically generate the group-based prepared list for the fabric.
$ efa inventory device firmware-download prepare add --fabric fab_3stg --firmware-host 10.20.241.101 --firmware-directory /build/slx/slxos20.2.3a
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| Group |  IP Address  |  Host Name  | Model | Chassis Name | ASN | Role  | Current Firmware | Firmware Host |   Firmware Directory    | Target Firmware |       Last Update Time        |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.1  | L1          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:36:21 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.3  | L3          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:36:21 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 1     | 10.20.245.5  | L5          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:36:21 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 2     | 10.20.245.2  | L2          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:36:22 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 2     | 10.20.245.4  | L4          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:36:22 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 2     | 10.20.245.6  | L6          | 3012  | SLX9250-32C  | 0   | Leaf  | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:36:22 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 3     | 10.20.245.9  | S1          | 3012  | SLX9250-32C  | 0   | Spine | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:36:23 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
| 4     | 10.20.245.10 | S2          | 3012  | SLX9250-32C  | 0   | Spine | 20.2.3           | 10.20.241.101 | /build/slx/slxos20.2.3a | 20.2.3a         | 2021-03-19 20:36:24 +0000 UTC |
+-------+--------------+-------------+-------+--------------+-----+-------+------------------+---------------+-------------------------+-----------------+-------------------------------+
Firmware Download Prepare Add Details
Validate Firmware Download Prepare Add [success]