You can determine and configure Oracle Solaris OS multipathing support by using the mpathadm command, which enables multipathing administration through the ANSI standard Multipath Management API. The terms used in this chapter to denote a path, initiator port, target port, and logical unit are consistent with the T10 specification.
You can display the list of logical units (LUs) by using the mpathadm list lu command. The displayed list of LUs contain names that can also be used to display the properties of a particular LU.
You can display detailed information of LUs with multiple paths such as path and target port group information.
To list all the LUs with multiple paths, use the mpathadm list lu command.
For example:
# mpathadm list lu
/dev/rdsk/c0t5000CCA00ABBDDA8d0s2
Total Path Count: 1
Operational Path Count: 1
/dev/rdsk/c0t5000CCA00ABBDC08d0s2
Total Path Count: 1
Operational Path Count: 1
/dev/rdsk/c0t5000CCA00ABC5EDCd0s2
Total Path Count: 1
Operational Path Count: 1
/dev/rdsk/c0t5000CCA00ABCECACd0s2
Total Path Count: 1
Operational Path Count: 1
/dev/rdsk/c0t600144F0DDA8BB1A000057208C880001d0s2
Total Path Count: 1
Operational Path Count: 1
/dev/rdsk/c0t600C0FF0000000000011C51EDAA44600d0s2
Total Path Count: 3
Operational Path Count: 3
/dev/rdsk/c0t5000CCA00ABBABDCd0s2
Total Path Count: 1
Operational Path Count: 1
.
.
.
To display detailed information about all LUs, use the mpathadm show lu command. To display information about a specific LU, use the mpathadm show lu LU-name command.
For example:
# mpathadm show lu /dev/rdsk/c0t600144F0DDA8BB1A000057208C880001d0s2
Logical Unit: /dev/rdsk/c0t600144F0DDA8BB1A000057208C880001d0s2
mpath-support: libmpscsi_vhci.so
Vendor: SUN
Product: ZFS Storage 7420
Revision: 1.0
Name Type: unknown type
Name: 600144f0dda8bb1a000057208c880001
Asymmetric: yes
Current Load Balance: shortest-path
Logical Unit Group ID: NA
Auto Failback: on
Auto Probing: NA
Paths:
Initiator Port Name: iqn.1986-03.com.sun:01:21866c42ab36.5710b544,4000002a00ff
Target Port Name: 4000002a0000,iqn.1986-03.com.sun:02:56bf24c4-e3e3-4ff0-e7b0-a6e6880e461d
Override Path: NA
Path State: OK
Disabled: no
Target Port Groups:
ID: 0
Explicit Failover: no
Access State: active optimized
Target Ports:
Name: 4000002a0000,iqn.1986-03.com.sun:02:56bf24c4-e3e3-4ff0-e7b0-a6e6880e461d
Relative ID: 3
You can specify the –e or --path-missing option with the mpathadm show lu command to display the logical units with missing paths.
To display information about a specific LU, use the mpathadm list lu –n port-name command.
For example:
# mpathadm list lu -n 600a0b800026d63a0000a4994e2342d4
mpath-support: libmpscsi_vhci.so
/dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
Total Path Count: 4
Operational Path Count: 4
To display the detailed configuration information for all LUs, use the mpathadm show lu command. For more information, see the mpathadm(1M) man page.
To display logical units associated with a specific target, use the mpathadm list lu –t target-port-name command.
For example:
# mpathadm list lu -t 20030003ba27d212
mpath-support: libmpscsi_vhci.so
/dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
Total Path Count: 4
Operational Path Count: 4
mpath-support: libmpscsi_vhci.so
/dev/rdsk/c0t600A0B800029065C00007CF54E234013d0s2
Total Path Count: 4
Operational Path Count: 4
mpath-support: libmpscsi_vhci.so
/dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
Total Path Count: 4
Operational Path Count: 4
mpath-support: libmpscsi_vhci.so
/dev/rdsk/c0t600A0B800029065C00007CF44E233FCFd0s2
Total Path Count: 4
Operational Path Count: 4
.
.
.
To list all the initiator ports in the system, use the mpathadm list initiator-port command.
For example:
# mpathadm list initiator-port Initiator Port: iqn.1986-03.com.sun:01:ffffffffffff.4e94f9bd,4000002a00ff Initiator Port: 210100e08ba41feb Initiator Port: 210000e08b841feb
To display the properties of a specific initiator port, use the mpathadm show initiator-port initiator-port-name command.
For example:
# mpathadm show initiator-port 2000000173018713
Initiator Port: 210100e08ba41feb
Transport Type: Fibre Channel
OS Device File: /devices/pci@1,0/pci1022,7450@1/pci1077,141@2,1/fp@0,0
If you do not specify the initiator port with the mpathadm show initiator-port command, all the discovered initiator ports and their properties are displayed.
The Oracle Solaris OS supports all T10 ALUA compliant devices by default and do not require any configuration. Also, Oracle Solaris supports a few third-party T10 ALUA noncomplaint devices. You can use the mpathadm command to display the list of T10 ALUA non-compliant devices, that are supported by the Oracle Solaris OS.
To identify the multipathing support on your system, use the mpathadm list mpath-support command.
For example:
# mpathadm list mpath-support mpath-support: libmpscsi_vhci.so
To display the multipathing support properties for a specified multipathing support name, use the mpathadm show mpath-support multipathing-support-name command.
For example:
# mpathadm show mpath-support libmpscsi_vhci.so
Vendor: Sun Microsystems
Driver Name: scsi_vhci
Default Load Balance: round-robin
Supported Load Balance Types:
round-robin
logical-block
shortest-path
Allows To Activate Target Port Group Access: yes
Allows Path Override: no
Supported Auto Failback Config: 1
Auto Failback: on
Failback Polling Rate (current/max): 0/0
Supported Auto Probing Config: 0
Auto Probing: NA
Probing Polling Rate (current/max): NA/NA
Supported Devices:
Vendor: SUN
Product: T300
Revision:
Supported Load Balance Types:
round-robin
Vendor: SUN
Product: T4
Revision:
Supported Load Balance Types:
round-robin
Vendor: LSI
Product: INF-01-00
Revision:
Supported Load Balance Types:
round-robin
Vendor: NETAPP
Product: INF-01-00
Revision:
Supported Load Balance Types:
round-robin
.
.
This example does not show the entire output that is displayed when you run the mpathadm show mpath-support libmpscsi_vhci.so command. For documentation purposes, it shows only the initial part of the output that is displayed. For symmetric third-party devices not listed in the library, see Configuring Third-Party Storage Devices.