Go to main content

Managing SAN Devices and Multipathing in Oracle® Solaris 11.3

Exit Print View

Updated: March 2018
 
 

How to Disable Multipathing for a Specific Device

You can disable Oracle Solaris I/O multipathing for a specific device with a certain vendor ID and product ID combination. This exclusion is specified in the scsi_vhci.conf file.

  1. Become an administrator.

    For more information, see Using Your Assigned Administrative Rights in Securing Users and Processes in Oracle Solaris 11.3.

  2. Copy the /kernel/drv/scsi_vhci.conf file to the /etc/driver/drv/scsi_vhci.conf file.
  3. Add the vendor ID and product ID entries to the /etc/driver/drv/scsi_vhci.conf file.

    The vendor ID and product ID are the vendor and product identification strings that the device returns in SCSI INQUIRY data. The vendor ID must be eight characters long. You must specify all eight characters even if the trailing characters are spaces. The product ID can be up to 16 characters long.

    scsi-vhci-failover-override =
    "VendorID1ProductID1", "NONE",
    "VendorID2ProductID2", "NONE",
    ...
    "VendorIDnProductIDn", "NONE";
    

    The entries in the preceding example are separated by a comma (,) and the last vendor/product entry is terminated by a semicolon (;). For example, to add a device from vendor ACME with a product ID of MSU, and a vendor device from vendor XYZ with product ID ABC, you would add the following lines to the file.

    /etc/driver/drv/scsi_vhci.conf:
    scsi-vhci-failover-override =
    "ACME    MSU", "NONE",
    "XYZ     ABC", "NONE";

    For more information about tuning the target disk driver properties, see Tuning Disk Target Driver Properties.

  4. Save and exit the scsi_vhci.conf file.
  5. Start the reboot and configuration process.
    # stmsboot -u

    During the reboot, the /etc/vfstab file and the dump configuration are updated to reflect the device name changes and the zpools are imported from the new device names.

  6. If necessary, configure your applications to use new device names.