Skip to main content

6.3.1 Mounting a Link Card Using PCI Hot Plug (PHP)


6.3.1 Mounting a Link Card Using PCI Hot Plug (PHP)
This section describes the procedure for mounting a link card on the server using PCI hot plug (PHP).
For details on the cfgadm command used here, see "2. Dynamically Configuring Devices" in the Managing Devices in Oracle Solaris 11.2. In the case of Oracle Solaris 10, see "SCSI Hot-Plugging With the cfgadm Command (Task Map)" in the Oracle Solaris Administration: Devices and File Systems.
Note - If you use PCI hot plug (PHP) to mount the link card on the server, pull all the PCIe cassettes containing PCIe cards out of the PCI expansion unit in advance. Mount the link card on the server before installing the pulled-out PCIe cassettes in the PCI expansion unit. Then, use PHP to incorporate them into the server.
  1. Log in as an Oracle Solaris super-user.
  1. Execute the svcadm enable hotplug command to activate the hotplug service.
# svcadm enable hotplug
  1. Execute the cfgadm command to mount the link card connected to the PCI expansion unit on the logical domain.
    For the Ap_ID, enter the Ap_ID of the link card you noted down before the start of maintenance.
# cfgadm -c configure Ap_ID
  1. If you have replaced a link card or I/O board, match the firmware version of the replaced card or board.

    If the version is the same as that on this replaced part, go to step 5.

    b. If the version is different from that on this replaced part, match the firmware version of the replaced part. See "6.6.4 Updating the Firmware" for details to perform work up to step 3.
  1. c. To reflect the firmware, release the link card using PHP.
# cfgadm -c disconnect Ap_ID
  1. d. Execute the cfgadm command to incorporate the link card into the logical domain.
# cfgadm -c configure Ap_ID
  1. e. Confirm that the firmware version is now the same as that on the replaced part. For details, see "Check Method When the System Has been Started" in "6.6.1 How to Check the Serial Number and Firmware Version of the PCI Expansion Unit."
  1. Install all the PCIe card cassettes into the PCI expansion unit.
    Lower the lever while pressing the latch of the PCIe card cassette to secure it.
  1. Execute the cfgadm command to supply power to the PCIe card.
    For the Ap_ID, enter the PCIe card Ap_ID you noted before the start of maintenance.
# cfgadm -c connect Ap_ID
  1. Execute the cfgadm command to incorporate the PCIe card into the logical domain.
    For the Ap_ID, enter the PCIe card Ap_ID you noted before the start of maintenance.
# cfgadm -c configure Ap_ID
  1. Execute the cfgadm command to confirm that the PCIe card requiring maintenance has been incorporated into the logical domain.
    In the following example, the [Receptacle] is displayed as "connected" and the [Occupant] as "configured," indicating that the PCIe card requiring maintenance is incorporated into the logical domain.
# cfgadm -a
Ap_Id Type Receptacle Occupant Condition
BB#0-PCI#0:iobE7a77.pcie4 etherne/hp connected configured ok
  1. If you released the I/O device assigned to an I/O domain before maintenance, return the physical I/O device (PCIe end point device) to its original state.
    For details, see "6.4.3 Work to Return the Physical I/O Device to the I/O Domain."
  2. Suppose that the virtual function (VF) using the SR-IOV function was removed or destroyed before maintenance. Based on the retained output results of the ldm list-io command, create and assign the virtual function to the domain again.
    For details, see "6.4.4 Work to Restore the SR-IOV Function."
  3. Before maintenance, a virtual device (vnet, vdisk) of a guest domain may have been kept unused. Return it back to the unused state.
    For details, see "6.4.5 Work to Restore a Virtual Device."
  1. If you have enabled the hotplug service, execute the svcadm command to disable the hotplug service.
# svcadm disable hotplug