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.
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 DeviceThe 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 DeviceThe 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.