How to Configure Virtual SCSI HBA Multipathing

This procedure describes how to create the virtual SCSI HBA multipathing configuration that is shown in the figure titled Configuring Virtual SCSI HBA Multipathing in a Guest Domain. This example is just one of many possible multipathing configurations.

Create an I/O domain with the physical SCSI HBA assigned to it.

See Configuring I/O Domains.
Export the virtual SAN for the first initiator port path from the first service domain.
```
ldm add-vsan vSAN-path1 vSAN-name domain-name
```
vSAN-path1 is the first initiator port path to the SAN.

For example, the following command exports the vsan-mpxio1 virtual SAN from the svcdom1 domain:
```
primary# ldm add-vsan /SYS/MB/RISER0/PCIE1/SUNW,emlxs@0/fp@0,0 vsan-mpxio1 svcdom1
```
Export the virtual SAN for the second initiator port path from the second service domain.
```
ldm add-vsan vSAN-path2 vSAN-name domain-name
```
vSAN-path2 is the second initiator port path to the SAN.

For example, the following command exports the vsan-mpxio2 virtual SAN from the svcdom2 domain:
```
primary# ldm add-vsan /SYS/MB/RISER0/PCIE3/SUNW,emlxs@0/fp@0,0 vsan-mpxio2 svcdom2
```
Export the virtual SCSI HBAs to the guest domain.
```
ldm add-vhba vHBA-name vSAN-name domain-name
```
For example, the following commands export the vhba-mpxio1 and vhba-mpxio2 virtual SCSI HBAs to the gdom domain:
```
primary# ldm add-vhba vhba-mpxio1 vsan-mpxio1 gdom
primary# ldm add-vhba vhba-mpxio2 vsan-mpxio2 gdom
```
Specify the timeout property value for the virtual SCSI HBAs on the guest domain.
```
ldm set-vhba timeout=seconds vHBA-name domain-name
```
For example, the following commands set the timeout property value to 30 for the vsan-mpxio1 and vsan-mpxio2 virtual SCSI HBAs on the gdom domain:
```
primary# ldm set-vhba timeout=30 vhba-mpxio1 gdom
primary# ldm set-vhba timeout=30 vhba-mpxio2 gdom
```
Reboot the guest domain.

Example 12-1 Adding a Virtual SCSI HBA and a Virtual SAN

The following example shows how to create a virtual SAN for a specific SCSI HBA initiator port and how to associate that virtual SAN with a virtual SCSI HBA in the ldg1 domain.

Use the ldm list-hba command to identify the physical SCSI HBA initiator ports in the ldg1 domain:

primary# ldm list-hba -l ldg1
NAME                                                 VSAN
----                                                 ----
/SYS/MB/SASHBA0/scsi@0/iport@1
[/pci@300/pci@1/pci@0/pci@2/scsi@0/iport@1]
/SYS/MB/SASHBA0/scsi@0/iport@2
[/pci@300/pci@1/pci@0/pci@2/scsi@0/iport@2]
/SYS/MB/SASHBA0/scsi@0/iport@4
[/pci@300/pci@1/pci@0/pci@2/scsi@0/iport@4]
/SYS/MB/SASHBA0/scsi@0/iport@8
[/pci@300/pci@1/pci@0/pci@2/scsi@0/iport@8]
/SYS/MB/PCIE1/SUNW,emlxs@0/fp@0,0
[/pci@300/pci@1/pci@0/pci@4/SUNW,emlxs@0/fp@0,0]
/SYS/MB/PCIE1/SUNW,emlxs@0,1/fp@0,0
[/pci@300/pci@1/pci@0/pci@4/SUNW,emlxs@0,1/fp@0,0]

Create a virtual SAN in the ldg1 domain that you can use to manage all of the SCSI devices that are associated with the last initiator port in the previous output.

The following command exports the vsan-mpxio1 virtual SAN from the ldg1 domain:

primary# ldm add-vsan /SYS/MB/PCIE1/SUNW,emlxs@0,1/fp@0,0 vsan-mpxio1 ldg1
/SYS/MB/PCIE1/SUNW,emlxs@0,1/fp@0,0 resolved to device:
/pci@300/pci@1/pci@0/pci@4/SUNW,emlxs@0,1/fp@0,0