Skip to main content

6.5.2 Incorporating an I/O device


6.5.2 Incorporating an I/O device
This section describes the procedure (workflow) for incorporating an I/O device by using the hot plug function.
To use the hot plug function, the hotplug service of Oracle Solaris needs to be enabled. Check the status of the service. If it is disabled, enable the hotplug service in the following procedure. The hot plug function is available only on the control domain and root domain.
# svcs hotplug ← If the STATE is disabled, enable the service.
# svcadm enable hotplug ← Enables the hotplug service.
For details on the cfgadm command used here, see "2 Dynamically Configuring Devices" in the Managing Devices in Oracle Solaris 11.2 or "Dynamically Configuring Devices (Tasks)" in the Oracle Solaris Administration: Devices and File Systems.
Note - To perform PCIe card maintenance using the hot plug function, confirm that the card is PHP enabled. To do so, check "Appendix A  Cards That Support PCI Hot Plug and Dynamic Reconfiguration" in the Fujitsu M10/SPARC M10 Systems PCI Card Installation Guide.
Incorporation of a PCI Express card
Mount the PCI Express card in the target PCI slot. Then, incorporate it into a logical domain in the following procedure.
  1. Log in as a super-user to Oracle Solaris on the logical domain (control domain or root domain) into which the target PCI Express card is to be incorporated.
  2. Check the mounting position Ap_Id of the target PCI Express card.
# cfgadm -a
Ap_Id               Type         Receptacle   Occupant     Condition
BB#0-PCI#0          unknown      disconnected unconfigured unknown
  1. Start the power supply to the target PCI Express card.
# cfgadm -c connect <‌Ap_Id>‌
  1. Incorporate the target PCI Express card into the logical domain.
# cfgadm -c configure <‌Ap_Id>‌
  1. Confirm that the target PCI Express card has been incorporated into the logical domain.
# cfgadm -a
Ap_Id               Type         Receptacle   Occupant     Condition
BB#0-PCI#0          pci-pci/hp   connected    configured   ok
  1. If the ATTENTION LED of the target cassette is blinking when you replace the PCI Express card, turn off the ATTENTION LED.
# cfgadm -x led=attn,mode=off <Ap_Id>
  1. If you have enabled the hotplug service, execute the svcadm command to disable the hotplug service.
  2. Assign the I/O device of the incorporated PCIe card to the logical domain.
    a. If you have released the I/O device assigned to an I/O domain before maintenance, restore the physical I/O device (PCIe end point device) to its original status.
    For details, see "Returning the physical I/O device to the I/O domain."

    b. Suppose that the SR-IOV function was used to delete and discard a virtual function (VF) before maintenance. In this case, create the virtual function again and assign it to the domain based on the retained output results from the idm list-io command.
    For details, see "Restoring the SR-IOV function."

    c. If a virtual device (vnet, vdisk) of a guest domain has been kept unused before maintenance, return it to its original status.
    For details, see "Restoring a virtual device."
  3. If you have added a new PCI Express card, see the following manual to perform appropriate operations:
    - When using dynamic reconfiguration of the PCIe end point device
    See "15.3.1  Adding a Physical I/O Device to an I/O Domain" in the Fujitsu SPARC M12 and Fujitsu M10/SPARC M10 System Operation and Administration Guide.

    - When not using dynamic reconfiguration of the PCIe end point device
    See "3.2.18  Configuring an I/O Device" and "3.2.19  Creating or Destroying the SR-IOV Virtual Function" in the Fujitsu SPARC M12 and Fujitsu M10/SPARC M10 Domain Configuration Guide.
Note - Dynamic reconfiguration of the PCIe end point device is supported by XCP 2230 or later and Oracle VM Server for SPARC 3.1.1.1 or later.
Incorporation of an internal disk
  1. Log in as a super-user to Oracle Solaris on the logical domain (control domain or root domain) into which the target internal disk is to be incorporated.
  2. Execute the cfgadm command to check the status of the incorporated internal disk.
    With the cfgadm -al command, confirm that AP_ID of the replacement internal disk has been changed.
    Confirm that Occupant shows "configured." If it does not show "configured," perform step 3.
# cfgadm -al
Ap_Id                         Type      Receptacle Occupant   Condition
 <Omitted>
c2                            scsi-sas  connected configured   unknown
c2::dsk/c2t50000394281B50C6d0 disk      connected configured   unknown
c2::es/ses0                   ESI       connected configured   unknown
c2::smp/expd0                 smp       connected configured   unknown
c3                            scsi-sas  connected unconfigured unknown
c4                            scsi-sas  connected unconfigured unknown
c5                            fc        connected unconfigured unknown
c6                            fc        connected unconfigured unknown
c7                            scsi-sas  connected unconfigured unknown
 <Omitted> 
  1. If the system does not recognize the incorporated internal disk, make it recognized in the system.
    a. Execute the cfgadm -c configure command to incorporate the target internal disk into the logical domain.
# cfgadm -c configure <‌Ap_Id>‌
  1. b. With the cfgadm -al command, check the status of the internal disk.
  1. If the CHECK LED on the mounted internal disk is not off, execute the cfgadm -x command to turn off the CHECK LED on that internal disk.
# cfgadm -x led=fault,mode=off <‌Ap_Id>‌
  1. If you have enabled the hotplug service, execute the svcadm command to disable the hotplug service.
svcadm disable hotplug
  1. Assign the I/O device of the incorporated internal disk to the logical domain.
    - If you have replaced a faulty internal disk, proceed to "6.5.3  Restoring a logical domain to the pre-maintenance state."

    - If you have added a new internal disk, perform operations according to the descriptions in "14.2  Configuring Hardware RAID" in the Fujitsu SPARC M12 and Fujitsu M10/SPARC M10 System Operation and Administration Guide.