Displaying the paths to a disk

The vxdisk command is used to display the multipathing information for a particular metadevice. The metadevice is a device representation of a particular physical disk having multiple physical paths from one of the system's HBA controllers. In VxVM, all the physical disks in the system are represented as metadevices with one or more physical paths.

To display the multipathing information on a system

To view multipathing information for a particular metadevice

  1. Use the following command:

    # vxdisk list devicename

    For example, to view multipathing information for c2t0d0s2, use the following command:

    # vxdisk list c2t0d0s2

    Typical output from the vxdisk list command is as follows:

    Device     c2t0d0
    devicetag  c2t0d0
    type       sliced
    hostid     aparajita
    disk       name=mydg01 id=861086917.1052.aparajita
    group      name=mydg id=861086912.1025.aparajita
    flags      online ready autoconfig autoimport imported
    pubpaths   block=/dev/vx/dmp/c2t0d0s4 char=/dev/vx/rdmp/c2t0d0s4
    privpaths  block=/dev/vx/dmp/c2t0d0s3 char=/dev/vx/rdmp/c2t0d0s3
    version    2.1
    iosize     min=512 (bytes) max=2048 (blocks)
    public     slice=4 offset=0 len=1043840
    private    slice=3 offset=1 len=1119
    update     time=861801175 seqno=0.48
    headers    0 248
    configs    count=1 len=795
    logs       count=1 len=120
    Defined regions
    config     priv 000017-000247[000231]:copy=01 offset=000000 
    enabled
    config     priv 000249-000812[000564]:copy=01 offset=000231 
    enabled
    log        priv 000813-000932[000120]:copy=01 offset=000000 
    enabled
    Multipathing information:
    numpaths:       2
    c2t0d0s2        state=enabled       type=primary
    c1t0d0s2        state=disabled      type=secondary

    In the Multipathing information section of this output, the numpaths line shows that there are 2 paths to the device, and the following two lines show that one path is active (state=enabled) and that the other path has failed (state=disabled).

    The type field is shown for disks on Active/Passive type disk arrays such as the EMC CLARiiON, Hitachi HDS 9200 and 9500, Sun StorEdge 6xxx, and Sun StorEdge T3 array. This field indicates the primary and secondary paths to the disk.

    The type field is not displayed for disks on Active/Active type disk arrays such as the EMC Symmetrix, Hitachi HDS 99xx and Sun StorEdge 99xx Series, and IBM ESS Series. Such arrays have no concept of primary and secondary paths.

  2. Alternately, you can use the following command to view multipathing information:

    # vxdmpadm getsubpaths dmpnodename=devicename

    For example, to view multipathing information for eva4k6k0_6, use the following command:

    # vxdmpadm getsubpaths dmpnodename=eva4k6k0_6

    Typical output from the vxdmpadm getsubpaths command is as follows:

    NAME                    STATE[A]   PATH-TYPE[M] CTLR-NAME ENCLR-TYPE ENCLR-NAME ATTRS
    ======================================================================================
    c0t50001FE1500A8F08d7s2 ENABLED(A) PRIMARY      c0        EVA4K6K    eva4k6k0      -
    c0t50001FE1500A8F09d7s2 ENABLED(A) PRIMARY      c0        EVA4K6K    eva4k6k0      -
    c0t50001FE1500A8F0Cd7s2 ENABLED    SECONDARY    c0        EVA4K6K    eva4k6k0      -
    c0t50001FE1500A8F0Dd7s2 ENABLED    SECONDARY    c0        EVA4K6K    eva4k6k0      -