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 hdisk18, use the following command:

    # vxdisk list hdisk18

    Typical output from the vxdisk list command is as follows:

    Device:    hdisk18
    devicetag: hdisk18
    type:      simple
    hostid:    zort
    disk:      name=mydg04 id=962923652.362193.zort
    timeout:   30
    group:     name=mydg id=962212937.1025.zort
    info:      privoffset=128
    flags:     online ready private autoconfig autoimport imported
    pubpaths:  block=/dev/vx/dmp/hdisk18 
    privpaths: char=/dev/vx/rdmp/hdisk18
    version:   2.1
    iosize:    min=1024 (bytes) max=64 (blocks)
    public:    slice=0 offset=1152 len=4101723
    private:   slice=0 offset=128 len=1024
    update:    time=962923719 seqno=0.7
    headers:   0 248
    configs:   count=1 len=727
    logs:      count=1 len=110
    Defined regions:
    config   priv 000017-000247[000231]:copy=01 offset=000000 
    disabled
    config   priv 000249-000744[000496]:copy=01 offset=000231 
    disabled
    log      priv 000745-000854[000110]:copy=01 offset=000000 
    disabled
    lockrgn  priv 000855-000919[000065]: part=00 offset=000000
    Multipathing information:
    numpaths:   2
    hdisk18 state=enabled  type=secondary
    hdisk26 state=disabled type=primary

    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 emc_clariion0_17, use the following command:

    # vxdmpadm getsubpaths dmpnodename=emc_clariion0_17

    Typical output from the vxdmpadm getsubpaths command is as follows:

    NAME       STATE[A]   PATH-TYPE[M] CTLR-NAME  ENCLR-TYPE   ENCLR-NAME     ATTRS
    ================================================================================
    hdisk107   ENABLED(A)  PRIMARY     fscsi1     EMC_CLARiiON  emc_clariion0     -
    hdisk17    ENABLED     SECONDARY   fscsi0     EMC_CLARiiON  emc_clariion0     -
    hdisk2     ENABLED     SECONDARY   fscsi0     EMC_CLARiiON  emc_clariion0     -
    hdisk32    ENABLED(A)  PRIMARY     fscsi0     EMC_CLARiiON  emc_clariion0     -