Prepare a PCIe EM for Hot Plug in Oracle Solaris 10 and Solaris 11

The PCIe EM hot plug capability is built into the supported Oracle Solaris OS for your server. Use this procedure to prepare the server with Oracle Solaris OS for hot-plugging PCIe EMs.

Before You Begin

Before you remove a PCIe EM, ensure that dependent critical resources are accessible through an alternate path, or plan for service downtime.

1. Log in to the superuser account.
2. To verify that the hotplug service is running:

   # svcs hotplug

   STATE        STIME        FMRI
   online        15:47:02        svc:/system/hotplyg:default

3. If the hotplug is not running (disabled), start it:

   # svcadm enable hotplug

4. To determine the PCIe EM slot number, use the cfgadm command.

   For example:

   # cfgadm -s "match=partial,select=ap_id"

   Sample output from the command:

   Ap_Id  Type     Receptacle   Occupant      Condition
   slot1  unknown  etherne/hp   configured    ok
   slot2  unknown  etherne/hp   configured    ok
   slot3  unknown  etherne/hp   configured    ok
   slot4  unknown  etherne/hp   configured    ok
   slot5  unknown  empty        unconfigured  unknown
   slot6  unknown  empty        unconfigured  unknown
   slot7  unknown  empty        unconfigured  unknown
   slot8  unknown  empty        unconfigured  unknown

   The sample output shows populated and unpopulated devices.

5. Identify the slot number in the Ap_Id column.

   For more information about PCIe EM designations, see PCIe EM Designations, Slot Numbering, and Population Rules.

6. To stop the application that has the device open, do one of the following:
   • Press the PCIe EM's Attention button.

     The LED blinks for approximately five seconds and then turns off.

     —or—

   • To unconfigure the device manually, use the cfgadm command :
     1. Enter the command:

        # cfgadm -c unconfigure slot#

        where slot# is the Ap_Id as determined in the previous steps.

        For example:

        cfgadm -c unconfigure slot4

     2. Confirm that the device has been unconfigured:

        For example:

        # cfgadm -s "match=partial,select=ap_id"

        Sample output from the command:

        Ap_Id  Type     Receptacle   Occupant      Condition
        slot1  unknown  etherne/hp   configured    ok
        slot2  unknown  etherne/hp   configured    ok
        slot3  unknown  etherne/hp   configured    ok
        slot4  unknown  etherne/hp   unconfigured  unknown
        slot5  unknown  empty        unconfigured  unknown
        slot6  unknown  empty        unconfigured  unknown
        slot7  unknown  empty        unconfigured  unknown
        slot8  unknown  empty        unconfigured  unknown

        In the output from the command, verify that the Type and Condition are shown as unknown, and that the Occupant value indicates that the device is unconfigured.

     3. Disconnect the device from the slot:

        # cfgadm -c disconnect slot#

     4. Confirm that the device has been disconnected.

        # cfgadm -s "match=partial,select=ap_id"

        Sample output from the command:

        Ap_Id  Type     Receptacle   Occupant      Condition
        slot1  unknown  etherne/hp   configured    ok
        slot2  unknown  etherne/hp   configured    ok
        slot3  unknown  etherne/hp   configured    ok
        slot4  unknown  disconnected unconfigured  unknown
        slot5  unknown  empty        unconfigured  unknown
        slot6  unknown  empty        unconfigured  unknown
        slot7  unknown  empty        unconfigured  unknown
        slot8  unknown  empty        unconfigured  unknown

        In the output of the command, verify that the Receptacle value is shown as disconnected.

7. Remove the PCIe EM from the system. See How to Remove a PCIe EM.

Next Steps

• How to Remove a PCIe EM

• How to Install a PCIe EM or PCIe EM Filler