Administering Multipathing Devices

Perform the following tasks to administer any multipathing devices.

How to Display Multipathing Support Information

Multipathing support and property information is identified with the Multipath Management API plug-in library name.

Become an administrator.

Identify the multipathing support on your system.

# mpathadm list mpath-support
mpath-support: libmpscsi_vhci.so

Display the multipathing support properties for a specified mpath support name.

# mpathadm show mpath-support libmpscsi_vhci.so
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
        Allows To Activate Target Port Group Access:  yes
        Allows Path Override:  no
        Supported Auto Failback Config:  yes
        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
.
.
.

The command output also shows a list of device products that is supported by the multipathing support software. The multipathing support libmpscsi_vhci.so supports T10 target port group compliant devices by default.

How to Display Properties of a Specific Initiator Port

The following steps describe how to display the properties of an initiator port.

Identify the initiator port.

# mpathadm list initiator-port
Initiator Port:  iqn.1986-03.com.sun:01:ffffffffffff.4e94f9bd,4000002a00ff
Initiator Port:  210100e08ba41feb
Initiator Port:  210000e08b841feb

Display the specific initiator port's properties.

# 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

How to Display Specific LUN Information

Display the list of LUNs, along with the properties for each LUN by using the mpathadm command. The displayed list of LUNs contain names that in turn can be used to display the properties of a particular LUN.

Display a list of multipathed LUNs.

# mpathadm list lu
        /dev/rdsk/c0t600144F08069703400004E828EE10004d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600144F08069703400004E8183DF0002d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800029065C00007CF54E234013d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800029065C00007CF44E233FCFd0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800026D63A0000A4974E23424Ed0s2
                Total Path Count: 4
                Operational Path Count: 4
.
.
.

Display configuration information about a specific LUN.

# mpathadm show lu /dev/rdsk/c4t60003BA27D2120004204AC2B000DAB00d0s2
        mpath-support:  libmpscsi_vhci.so
        Vendor:  SUN     
        Product:  Sun Storage NAS
        Revision:  1.0 
        Name Type:  unknown type
        Name:  600144f08069703400004e828ee10004
        Asymmetric:  yes
        Current Load Balance:  round-robin
        Logical Unit Group ID:  NA
        Auto Failback:  on
        Auto Probing:  NA

        Paths:  
                Initiator Port Name:  210100e08ba41feb
                Target Port Name:  2100001b329b6c3f
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210100e08ba41feb
                Target Port Name:  2101001b32bb6c3f
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210100e08ba41feb
                Target Port Name:  2100001b329b793c
                Override Path:  NA
                Path State:  OK
                Disabled:  no
.
.
.

        Target Port Groups:  
                ID:  0
                Explicit Failover:  no
                Access State:  active optimized
                Target Ports:
                        Name:  2100001b329b6c3f
                        Relative ID:  1

                        Name:  2101001b32bb6c3f
                        Relative ID:  2

                ID:  1
                Explicit Failover:  no
                Access State:  standby
                Target Ports:
                        Name:  2100001b329b793c
                        Relative ID:  257

                        Name:  2101001b32bb793c
                        Relative ID:  256

How to Display All LUNs Associated With a Specific Target Port

Use the steps below to display paths through a target port.

Display a list of LUNs.

# mpathadm list lu
       /dev/rdsk/c0t600144F08069703400004E828EE10004d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600144F08069703400004E8183DF0002d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800029065C00007CF54E234013d0s2
                Total Path Count: 4
                Operational Path Count: 4
.
.
.

Display specific LUN information to determine the target ports.

# mpathadm show lu /dev/rdsk/c0t600A0B800029065C00007CF54E234013d0s2
Logical Unit:  /dev/rdsk/c0t600A0B800029065C00007CF54E234013d0s2
        mpath-support:  libmpscsi_vhci.so
        Vendor:  SUN     
        Product:  CSM200_R        
        Revision:  0660
        Name Type:  unknown type
        Name:  600a0b800029065c00007cf54e234013
        Asymmetric:  yes
        Current Load Balance:  round-robin
        Logical Unit Group ID:  NA
        Auto Failback:  on
        Auto Probing:  NA

        Paths:  
                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no
.
.
.

        Target Port Groups:  
                ID:  4
                Explicit Failover:  yes
                Access State:  standby
                Target Ports:
                        Name:  200800a0b826d63b
                        Relative ID:  0

                        Name:  200800a0b826d63c
                        Relative ID:  0

                ID:  14
                Explicit Failover:  yes
                Access State:  active
                Target Ports:
                        Name:  200900a0b826d63b
                        Relative ID:  0

                        Name:  200900a0b826d63c
                        Relative ID:  0

Display the specific target port information.

# 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
.
.
.

How to Display a LUN With a Specific Name

Display detailed information on multipathed LUNs, including path and target port group information. Note that the name property in the information represents the identifier for this LUN, derived from the hardware, and used by this system. If the name is derived from SCSI Inquiry Vital Product Data (VPD) page 83h, the name type property represents an associated identifier type defined by the SCSI standards.

Display a list of multipathed LUNs.

# mpathadm list lu
        /dev/rdsk/c0t600144F08069703400004E828EE10004d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600144F08069703400004E8183DF0002d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800029065C00007CF54E234013d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800029065C00007CF44E233FCFd0s2
                Total Path Count: 4
                Operational Path Count: 4
.
.
.

Display a selected LUN's configuration information.

# mpathadm show lu /dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
Logical Unit:  /dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
        mpath-support:  libmpscsi_vhci.so
        Vendor:  SUN     
        Product:  CSM200_R        
        Revision:  0660
        Name Type:  unknown type
        Name:  600a0b800026d63a0000a4994e2342d4
        Asymmetric:  yes
        Current Load Balance:  round-robin
        Logical Unit Group ID:  NA
        Auto Failback:  on
        Auto Probing:  NA

        Paths:  
                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63c
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63c
                Override Path:  NA
                Path State:  OK
                Disabled:  no

        Target Port Groups:  
                ID:  3
                Explicit Failover:  yes
                Access State:  active
                Target Ports:
                        Name:  200800a0b826d63b
                        Relative ID:  0

                        Name:  200800a0b826d63c
                        Relative ID:  0

                ID:  13
                Explicit Failover:  yes
                Access State:  standby
                Target Ports:
                        Name:  200900a0b826d63b
                        Relative ID:  0

                        Name:  200900a0b826d63c
                        Relative ID:  0

Display the selected LUN information.

# mpathadm list lu -n 600a0b800026d63a0000a4994e2342d4
mpath-support:  libmpscsi_vhci.so
        /dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
                Total Path Count: 4
                Operational Path Count: 4

How to Configure Automatic Failback for Specific Multipathing Support

Symmetrical devices allow for automatic failback to a possible optimal path. If a failover occurs on the initial path, the standby path becomes the new online path. Usually the standby path is a suboptimal path. When auto-failback is enabled, the initial path comes back online, failover to the initial path automatically occurs.

Become an administrator.

Display the supported multipath driver information.

# mpathadm list mpath-support
mpath-support: libmpscsi_vhci.so

Enable automatic failback support for the supported multipath driver.
```
# mpathadm modify mpath-support -a on libmpscsi_vhci.so
 
```

Confirm the configuration change.

# mpathadm show mpath-support libmpscsi_vhci.so
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
        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
.
.
.

Note - The auto-failback display initiated by the mpathadm modify command setting is effective while the system is running. However, to keep the changed setting persistent, you must update the /etc/driver/drv/scsi_vhci.conf file. Refer to Configuring Automatic Failback.

How to Fail Over a LUN

This operation is applicable only to devices in the following two categories:

Asymmetric devices with a proprietary failover mechanism recognized and supported by multipathing support
Devices conforming to the T10 Standard Target Port Group Support libmpscsi_vhci.so and providing explicit mode asymmetric LUN access

Display a list of multipathed LUNs.

# mpathadm list lu
        /dev/rdsk/c0t600144F08069703400004E828EE10004d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600144F08069703400004E8183DF0002d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800029065C00007CF54E234013d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
                Total Path Count: 4
                Operational Path Count: 4
.
.
.

Display the selected LUN's configuration information.

# mpathadm show lu /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
Logical Unit:  /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
        mpath-support:  libmpscsi_vhci.so
        Vendor:  SUN     
        Product:  CSM200_R        
        Revision:  0660
        Name Type:  unknown type
        Name:  600a0b800026d63a0000a4984e234298
        Asymmetric:  yes
        Current Load Balance:  round-robin
        Logical Unit Group ID:  NA
        Auto Failback:  on
        Auto Probing:  NA

        Paths:  
                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63c
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63c
                Override Path:  NA
                Path State:  OK
                Disabled:  no

        Target Port Groups:  
                ID:  5
                Explicit Failover:  yes
                Access State:  active
                Target Ports:
                        Name:  200800a0b826d63b
                        Relative ID:  0

                        Name:  200800a0b826d63c
                        Relative ID:  0

                ID:  15
                Explicit Failover:  yes
                Access State:  standby
                Target Ports:
                        Name:  200900a0b826d63b
                        Relative ID:  0

                        Name:  200900a0b826d63c
                        Relative ID:  0

Manually force a LUN failover.
```
# mpathadm failover lu /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
```
If this operation is successful, the access state of the devices’ target port groups changes as a result of the logical unit failover.

Confirm the access state change.

# mpathadm show lu /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
Logical Unit:  /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
        mpath-support:  libmpscsi_vhci.so
        Vendor:  SUN     
        Product:  CSM200_R        
        Revision:  0660
        Name Type:  unknown type
        Name:  600a0b800026d63a0000a4984e234298
        Asymmetric:  yes
        Current Load Balance:  round-robin
        Logical Unit Group ID:  NA
        Auto Failback:  on
        Auto Probing:  NA

        Paths:  
                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63c
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63c
                Override Path:  NA
                Path State:  OK
                Disabled:  no

        Target Port Groups:  
                ID:  5
                Explicit Failover:  yes
                Access State:  standby
                Target Ports:
                        Name:  200800a0b826d63b
                        Relative ID:  0

                        Name:  200800a0b826d63c
                        Relative ID:  0

                ID:  15
                Explicit Failover:  yes
                Access State:  active
                Target Ports:
                        Name:  200900a0b826d63b
                        Relative ID:  0

                        Name:  200900a0b826d63c
                        Relative ID:  0

How to Enable a LUN Path

If the path to a LUN is disabled, the enable command changes the path back to enabled. The full path must be specified using the initiator port name, target port name, and the LUN. To verify the change, run the show command for the logical unit.

Display a list of multipathed LUNs.

# mpathadm list lu
        /dev/rdsk/c0t600144F08069703400004E828EE10004d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600144F08069703400004E8183DF0002d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800029065C00007CF54E234013d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800029065C00007CF44E233FCFd0s2
                Total Path Count: 4
                Operational Path Count: 4
.
.
.

Display the selected LUN's configuration information.

# mpathadm show lu 
Logical Unit:  /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
        mpath-support:  libmpscsi_vhci.so
        Vendor:  SUN     
        Product:  CSM200_R        
        Revision:  0660
        Name Type:  unknown type
        Name:  600a0b800026d63a0000a4984e234298
        Asymmetric:  yes
        Current Load Balance:  round-robin
        Logical Unit Group ID:  NA
        Auto Failback:  on
        Auto Probing:  NA

        Paths:  
                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63c
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63c
                Override Path:  NA
                Path State:  OK
                Disabled:  no

        Target Port Groups:  
                ID:  5
                Explicit Failover:  yes
                Access State:  standby
                Target Ports:
                        Name:  200800a0b826d63b
                        Relative ID:  0

                        Name:  200800a0b826d63c
                        Relative ID:  0

                ID:  15
                Explicit Failover:  yes
                Access State:  active
                Target Ports:
                        Name:  200900a0b826d63b
                        Relative ID:  0

                        Name:  200900a0b826d63c
                        Relative ID:  0

Enable the selected LUN path.

# mpathadm enable path -i 210000e08b841feb -t 200900a0b826d63b \ -l /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2

How to Disable a LUN Path

This operation makes the path unavailable for the LUN, regardless of its operational state.

Note - The disabled state is not persistent across rebooting. If the path is operational before the next boot sequence, it is enabled by default. This operation is not allowed when the given path is the last operational path remaining.

Display a list of multipathed LUNs.

# mpathadm list lu
        /dev/rdsk/c0t600144F08069703400004E828EE10004d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600144F08069703400004E8183DF0002d0s2
                Total Path Count: 8
                Operational Path Count: 8
        /dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800029065C00007CF54E234013d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800026D63A0000A4984E234298d0s2
                Total Path Count: 4
                Operational Path Count: 4
        /dev/rdsk/c0t600A0B800029065C00007CF44E233FCFd0s2
                Total Path Count: 4
                Operational Path Count: 4
.
.
.

Display the selected LUN's configuration information.

# mpathadm show lu /dev/rdsk/c0t600A0B800029065C00007CF34E233F89d0s2
Logical Unit:  /dev/rdsk/c0t600A0B800029065C00007CF34E233F89d0s2
        mpath-support:  libmpscsi_vhci.so
        Vendor:  SUN     
        Product:  CSM200_R        
        Revision:  0660
        Name Type:  unknown type
        Name:  600a0b800029065c00007cf34e233f89
        Asymmetric:  yes
        Current Load Balance:  round-robin
        Logical Unit Group ID:  NA
        Auto Failback:  on
        Auto Probing:  NA

        Paths:  
                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63b
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200800a0b826d63c
                Override Path:  NA
                Path State:  OK
                Disabled:  no

                Initiator Port Name:  210000e08b841feb
                Target Port Name:  200900a0b826d63c
                Override Path:  NA
                Path State:  OK
                Disabled:  no

        Target Port Groups:  
                ID:  8
                Explicit Failover:  yes
                Access State:  standby
                Target Ports:
                        Name:  200800a0b826d63b
                        Relative ID:  0

                        Name:  200800a0b826d63c
                        Relative ID:  0

                ID:  18
                Explicit Failover:  yes
                Access State:  active
                Target Ports:
                        Name:  200900a0b826d63b
                        Relative ID:  0

                        Name:  200900a0b826d63c
                        Relative ID:  0

Select an initiator port and a target port name.

Disable the selected LUN path.

# mpathadm disable path -i 210000e08b841feb -t 200900a0b826d63b \ -l /dev/rdsk/c0t600A0B800029065C00007CF34E233F89d0s2

Skip Navigation Links
Exit Print View
	Oracle Solaris Administration: SAN Configuration and Multipathing Oracle Solaris 11 Information Library