Add Devices To Your Fabric

About this task

Add devices to a new fabric or to an existing fabric. Do the following:

Procedure

  1. Use the efa fabric device add command to add a single device. To add multiple devices in a single command, use the add-bulk option instead.
    efa fabric device add
    efa fabric device add-bulk
  2. Use the efa fabric configure command with the --force option to force the fabric to update itself by removing and adding all devices that make up the fabric. When the fabric comes up again, it will include the newly added devices.

Example

The following command adds two leaf devices and a spine device to an existing fabric.

$ efa fabric device add-bulk --name efa-fabric-1 --leaf 10.9.9.80,10.9.9.90 --spine 10.10.10.30 --username
administrator@mshyperv.local --password 'aBc123#'  

$ efa fabric show

Fabric Name: efa-fabric-1, Fabric Description: Fabric #1, Fabric Stage: 3, Fabric Type: clos
+--------------+-----+--------------+-------+-------+--------------+-------------+-------------------+-----------------+---------+-------+
| IP ADDRESS   | POD | HOST NAME    | ASN   | ROLE  | DEVICE STATE | APP STATE   | CONFIG GEN REASON | PENDING CONFIGS | VTLB ID | LB ID |
+--------------+-----+--------------+-------+-------+--------------+-------------+-------------------+-----------------+---------+-------+
| 10.10.10.10  |     | SLX          | 64512 | spine | provisioned  | cfg in-sync | NA                | NA              | NA      | 1     |
| 10.10.10.20  |     | SLX          | 64512 | spine | provisioned  | cfg in-sync | NA                | NA              | NA      | 1     |
| 10.10.10.30  |     | SLX          | 64512 | spine | provisioned  | cfg in-sync | NA                | NA              | NA      | 1     |
| 10.9.9.20    |     | FRE-134      | 65001 | leaf  | provisioned  | cfg in-sync | NA                | NA              | 2       | 1     |
| 10.9.9.30    |     | FRE-135      | 65001 | leaf  | provisioned  | cfg in-sync | NA                | NA              | 2       | 1     |
| 10.9.9.40    |     | Orca-74      | 65000 | leaf  | provisioned  | cfg in-sync | NA                | NA              | 2       | 1     |
| 10.9.9.50    |     | Orca-76      | 65000 | leaf  | provisioned  | cfg in-sync | NA                | NA              | 2       | 1     |
| 10.9.9.60    |     | Avalanche-11 | 65002 | leaf  | provisioned  | cfg in-sync | NA                | NA              | 2       | 1     |
| 10.9.9.70    |     | Avalanche-46 | 65002 | leaf  | provisioned  | cfg in-sync | NA                | NA              | 2       | 1     |
| 10.9.9.80    |     | Orca-78      | 65002 | leaf  | provisioned  | cfg in-sync | NA                | NA              | 2       | 1     |
| 10.9.9.90    |     | Avalanche-72 | 65002 | leaf  | provisioned  | cfg in-sync | NA                | NA              | 2       | 1     |
+--------------+-----+--------------+-------+-------+--------------+-------------+-------------------+-----------------+---------+-------+

CONFIG GEN REASON:
LD - Link Delete, LA - Link Add, IU - Interface Update
MD - MCT Delete, OD - Overlay Gateway Delete, OU - Overlay Gateway Update, ED - Evpn Delete
DD - Dependent Device Update, DA - Device Add, DR - Device ReAdd, ASN - Asn Update, HN - HostName Update, NA - Not Applicable

PENDING CONFIGS:
MCT - MCT Cluster, O - Overlay Gateway, SYSP - System Properties, INTIP - Interface IP
C/D/U - Create/Delete/Update, PA/PD - Port Add/Port Delete

For App or Device Error/Failure reason, run "efa fabric error show" for details
For config refresh reason, run "efa fabric debug config-gen-reason" for details

--- Time Elapsed: 6.1824056s ---
            

Example

This command forces all the devices to be removed and added back to the fabric. This step is necessary to ensure that the overlay and underlay information for the newly added devices are propagated throughout the fabric.

$ efa fabric configure --name efa-fabric-1 --force