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 | --prepared-list-name prepared-list-name |[--group group number ] --force --firmware-host firmware download host --firmware-directory path to target firmware build ]

Command Default

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

Parameters

--fabric fabric name
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.
--ip device ip address
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 XCO hosted node‘s SLX firmware to be upgraded simultaneously.
--prepared-list-name prepared-list-name
Prepared list name.
--group group number
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
Firmware download host IP address.
--firmware-directory path to target firmware build
Path to the target firmware build.

Usage Guidelines

Note

Note

  • The 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 both MCT leaf pairs to be prepared together.
  • Do not allow all spines in the same pod of the same fabric to be prepared together.
  • Do not allow all super-spines in the fabric to be prepared together.
  • XCO performs a sanity check using the firmware-host and firmware-directory that are specified in the command to ensure that the switch takes the firmware from that host and directory.

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 XCO 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]

This example prepares an NPB device for firmware upgrade.

efa inventory device firmware-download prepare add --firmware-host=10.37.135.12 --firmware-directory=/var/lib/tftpboot/SLXOS3C/slxos18s.1.03c --prepared-list-name testList --ip 10.37.128.72
+-------+--------------+-----------+-------+--------------+-----+------+------------------+---------------+------------------------------------------+-----------------+-------+--------------+-------------------------------+
| Group |  IP Address  | Host Name | Model | Chassis Name | ASN | Role | Current Firmware | Firmware Host |            Firmware Directory            | Target Firmware | Force | Full Install |       Last Update Time        |
+-------+--------------+-----------+-------+--------------+-----+------+------------------+---------------+------------------------------------------+-----------------+-------+--------------+-------------------------------+
| 1     | 10.37.128.72 | SLX       | 3000  | BR-SLX9240   | 0   |      | 18s.1.03e        | 10.37.135.12  | /var/lib/tftpboot/SLXOS3C/slxos18s.1.03c | 18s.1.03c       | false | false        | 2022-11-02 04:01:32 -0400 EDT |
+-------+--------------+-----------+-------+--------------+-----+------+------------------+---------------+------------------------------------------+-----------------+-------+--------------+-------------------------------+
Firmware Download Prepare Add Details
Validate Firmware Download Prepare Add [success]
9037860-01 Rev AA