Configuring or Unconfiguring IB Devices

Language:

You use the following commands to configure or unconfigure IB devices. The commands apply to IB port, HCA_SVC, or VPPA devices.

cfgadm -c configure device configures the IB device.
cfgadm -c unconfigure device unconfigures the IB device.

In both commands, the device is represented by its Ap_Id.

Note - To perform DR on HCAs, you use the bus-specific cfgadm plugin such as the cfgadm_pci command for a PCI based HCA. However, the procedures are beyond the scope of this documentation. For more information, refer to the appropriate man page, for example, the cfgadm_pci(1M) man page.

As a useful practice, you should display information about the system devices before and after the actual step of configuring or unconfiguring a device. The information helps you in the following ways:

Properly identify the bus or device to dynamically reconfigure.
Verify from the state of the bus or device that the reconfiguration completed successfully.

The following examples show how to use the cfgadm command to perform DR on IB devices.

Example 3-5 Configuring an IB Port Device

The following example configures the IB port device ib::1730000007F51,*0*,ipib and includes verification of the operation.

# cfgadm -c configure ib::1730000007F51,*0*,ipib
# cfgadm -a ib::1730000007F51,*0*,ipib
Ap_Id                       Type      Receptacle Occupant   Condition
ib::1730000007F51,*0*,ipib  IB-Port   connected  configured okThe port device is configured.

Note that if EoIB datalinks were configured over the IB Port when the port was previously unconfigured, you must re-create the vnics corresponding to those EoIB datalinks on the EoIB Gateway with the new IB HCA port GUIDs. You must re-create the vnics before re-configuring the IB Port. For information about how to create vnics on the Gateway, refer to the Sun Network QDR InfiniBand Gateway Switch Administration Guide.

Example 3-6 Unconfiguring an IB Port Device

The following example unconfigures the IB port device ib::1730000007F51,*0*,ipib and includes verification of the operation.

# cfgadm -c unconfigure ib::1730000007F51,*0*,ipib
Unconfigure the device: /devices/ib:fabric::1730000007F51,*0*,ipib
This operation will suspend activity on the IB device
Continue (yes/no)? Y
# cfgadm -a ib::1730000007F51,*0*,ipib
Ap_Id                       Type    Receptacle Occupant     Condition
ib::1730000007F51,*0*,ipib IB-Port  connected  unconfigured unknownThe port device is unconfigured.

Example 3-7 Configuring an IB Pseudo Device

The following example configures the pseudo device ib::ibgen,0 and includes verification of the operation.

# cfgadm -yc configure ib::ibgen,0
# cfgadm -a ib::ibgen,0
Ap_Id                  Type       Receptacle Occupant   Condition
ib::ibgen,0            IB-PSEUDO  connected  configured okThe device is configured.

Example 3-8 Unconfiguring an IB Pseudo Device

The following example unconfigures the pseudo device ib::ibgen,0 and includes verification of the operation.

# cfgadm -c unconfigure ib::ibgen,0
Unconfigure the device: /devices/ib:fabric::ibgen,0
This operation will suspend activity on the IB device
Continue (yes/no)? Y
# cfgadm -a ib::ibgen,0
Ap_Id                  Type      Receptacle Occupant     Condition
ib::ibgen,0            IB-PSEUDO connected  unconfigured unknownThe device is unconfigured.