Managing SAN Devices and Multipathing in Oracle® Solaris 11.2

Exit Print View

 
Updated: December 2014
 
 

Displaying Multipathing Support Information

You can use the mpathadm command to display multipathing support information and also manage multipathing discovery. Multipathing support and property information is identified with the Multipath Management API plug-in library name, which is displayed by using the mpathadm command.

How to Display Multipathing Support Information

  1. Become an administrator.
  2. Identify the multipathing support on your system.
    # mpathadm list mpath-support
mpath-support: libmpscsi_vhci.so
  3. 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 library file 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.

  1. List the initiator ports.
    # mpathadm list initiator-port
Initiator Port:  iqn.1986-03.com.sun:01:ffffffffffff.4e94f9bd,4000002a00ff
Initiator Port:  210100e08ba41feb
Initiator Port:  210000e08b841feb
  2. 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

    If you do not specify the initiator port with the mpathadm show initiator-port command, the properties of all the discovered initiator ports are displayed.

How to Display Specific LU Information

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

  1. Display a list of multipathed LUs.
    # 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
.
.
.
  2. Display configuration information about a specific LU using the LU name from the list. 
    # 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

    If you do not specify the LU name with the mpathadm show lu command, the information about all the discovered logical units are displayed.

How to Display All LUs Associated With a Specific Target Port

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

  1. Display a list of LUs.
    # 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
.
.
.
  2. Display specific LU 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
  3. 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 LU With a Specific Name

Display detailed information on multipathed LUs, including path and target port group information. Note that the name property in the information represents the identifier for this LU, 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.

  1. Display a list of multipathed LUs.
    # 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
.
.
.
  2. Display a selected LU'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

    You can specify the –e or –-path-missing option with the mpathadm show lu command to display the logical units only for missing paths.

  3. Display the selected LU information.
    # mpathadm list lu -n 600a0b800026d63a0000a4994e2342d4
mpath-support:  libmpscsi_vhci.so
        /dev/rdsk/c0t600A0B800026D63A0000A4994E2342D4d0s2
                Total Path Count: 4
                Operational Path Count: 4
Copyright © 2009, 2014, Oracle and/or its affiliates. All rights reserved. Legal Notices
Previous
Next