Go to main content
Oracle® VM Server for SPARC 3.4 Administration Guide

Exit Print View

Updated: August 2016

Planning PCIe Endpoint Device Configuration

Carefully plan ahead when you assign or remove PCIe endpoint devices to avoid root domain downtime. The reboot of the root domain not only affects the services that are available on the root domain itself but also the I/O domains that have PCIe endpoint devices assigned. Though the changes to each I/O domain do not affect the other domains, planning ahead helps to minimize the consequences on the services that are provided by that domain.

When in a delayed reconfiguration, you can continue to add or remove more devices and then reboot the root domain only one time to make all the changes take effect.

For an example, see How to Create an I/O Domain by Assigning a PCIe Endpoint Device.

You must take the following general steps to plan and perform a DIO device configuration:

  1. Understand and record your system hardware configuration.

    Specifically, record information about the part numbers and other details of the PCIe cards in the system.

    Use the ldm list-io -l and prtdiag -v commands to obtain the information and save it for future reference.

  2. Determine which PCIe endpoint devices are required to be in the primary domain.

      For example, determine the PCIe endpoint devices that provide access to the following:

    • Boot disk device

    • Network device

    • Other devices that the primary domain offers as services

  3. Remove all PCIe endpoint devices that you might use in I/O domains.

    This step helps you to avoid performing subsequent reboot operations on the root domain, because reboots affect I/O domains.

    Use the ldm remove-io command to remove the PCIe endpoint devices. Use pseudonyms rather than device paths to specify the devices to the remove-io and add-io subcommands.

    Note - After you have removed all the devices you want during a delayed reconfiguration, you need to reboot the root domain only one time to make all the changes take effect.
  4. Save this configuration to the service processor (SP).

    Use the ldm add-config command.

  5. Reboot the root domain to release the PCIe endpoint devices that you removed in Step 3.

  6. Confirm that the PCIe endpoint devices you removed are no longer assigned to the root domain.

    Use the ldm list-io -l command to verify that the devices you removed appear as SUNW,assigned-device in the output.

  7. Assign an available PCIe endpoint device to a guest domain to provide direct access to the physical device.

    After you make this assignment, you can no longer migrate the guest domain to another physical system by means of the domain migration feature.

  8. Add a PCIe endpoint device to or remove one from a guest domain.

    Use the ldm add-io command.

    Minimize the changes to I/O domains by reducing the reboot operations and by avoiding downtime of services offered by that domain.

  9. (Optional) Make changes to the PCIe hardware.

    See Making PCIe Hardware Changes.