How to Manage Multipathing for Virtual SCSI HBAs in a Guest Domain

  1. Copy the /platform/sun4v/kernel/drv/vhba.conf file to the /etc/driver/drv directory.
    # cp /platform/sun4v/kernel/drv/vhba.conf /etc/driver/drv
  2. Configure multipathing by modifying the /etc/driver/drv/vhba.conf file.

    You can configure virtual HBA initiator port (port) multipathing on a per-port or global basis. Per-port settings have priority over the global setting.

    • Enable multipathing for all vhba instances in a guest domain.

      Add only the following line to the vhba.conf file:

      mpxio-disable="no"
    • Disable multipathing for all vhba instances in a guest domain.

      Add only the following line to the vhba.conf file:

      mpxio-disable="yes"
    • Enable all vhba instances except vhba@1.

      Add the following lines to the vhba.conf file:

      mpxio-disable="yes"
      compatible="/virtual-devices@100/channel-devices@200/scsi@1/iport@0" mpxio-disable="no";

      Note that vhba@1 is what is shown in the ldm list -o hba command output, but scsi@1 is how vhba@1 is known to the operating system.

    • Disable all vhba instances except vhba@1.

      Add the following lines to the vhba.conf file:

      mpxio-disable="no"
      compatible="/virtual-devices@100/channel-devices@200/scsi@1/iport@0" mpxio-disable="yes";
  3. Reboot the guest domain.