Skip to main content

3.2.18 Configuring an I/O Device


3.2.18 Configuring an I/O Device
Use the following commands to configure an I/O device.
Table 3-21  Commands for Configuring an I/O Device
Command Functional Outline
ldm add-io Adds an I/O device.
ldm remove-io Deletes an I/O device.
Note that I/O devices can be reconfigured dynamically depending on the version of Oracle VM Server for SPARC. For details, see Table 1-2, the latest Product Notes of the server used, the Oracle VM Server for SPARC Release Notes of the version used, and the Oracle VM Server for SPARC Administration Guide.
ldm add-io command
Use the ldm add-io command to add an I/O device to a logical domain.
# ldm add-io (bus | device | vf-name) ldom
  1. bus
    Specify the PCIe bus (root complex).
  2. device
    Specify a name (PCIe endpoint device name) for a direct I/O-assignable device.
  3. vf-name
    Specify a virtual function name of the PCIe SR-IOV.
  4. ldom
    Specify a logical domain to which a bus, device, or SR-IOV virtual function is added.
ldm remove-io command
Use the ldm remove-io command to delete an I/O device from a logical domain.
# ldm remove-io [-n] (bus | device | vf-name) ldom
  1. -n

    Checks in advance whether the command is successfully executed.
  2. bus
    Specify the PCIe bus (root complex).
  3. device
    Specify a name (PCIe endpoint device name) for a direct I/O-assignable device.
  4. vf-name
    Specify a virtual function name of the PCIe SR-IOV.
  5. ldom
    Specify a logical domain from which a bus, device, or SR-IOV virtual function is removed.
The following example shows the procedure for deleting a PCIe bus (PCIE1) from the control domain (primary) and assigning it to an I/O domain. Also, the procedure is the same for the PCIe endpoint.
Note - With the default values at factory shipment (factory-default), all the I/O devices are assigned to the primary domain.
  1. Execute the fmadm faulty command of Oracle Solaris and the showstatus command of the XSCF firmware to confirm that the device has no error information.
# fmadm faulty
XSCF> showstatus
  1. If it has error information, execute the fmadm repair command to clear the error information after performing hardware maintenance work.
# fmadm repaired fmri | lable
  1. Set the control domain to delayed reconfiguration state.
    If the I/O device is reconfigured dynamically, you can omit this procedure.
# ldm start-reconf primary
  1. Release the assigned PCIe endpoint (PCIE1) from the control domain.
# ldm remove-io PCIE1 primary
  1. Restart the control domain.
    If the I/O device is reconfigured dynamically, you can omit this procedure.
# shutdown -y -g0 -i6
  1. If Oracle Solaris at the assignment destination I/O domain is running, stop it.
    If the I/O device is reconfigured dynamically, you can omit this procedure.
# ldm stop-domain ldom1
  1. Add the assignment of the PCIe endpoint (PCIE1) to the I/O domain.
# ldm add-io PCIE1 ldom1
  1. Start Oracle Solaris of the assignment destination I/O domain.
    If the I/O device is reconfigured dynamically, you can omit this procedure.
# ldm start-domain ldom1