Previous  |  Next  >  
Product: Volume Manager Guides   
Manual: Volume Manager 4.1 Hardware Notes   

The DMP Administration Utility --- vxdmpadm

The vxdmpadm utility administers the DMP functionality of VxVM. Refer to the "Administering Dynamic Multipathing (DMP)" chapter in the VERITAS Volume Manager Administrator's Guide, and the vxdmpadm(1M) manual page for detailed descriptions of the options and attributes of this command.

You can use the vxdmpadm utility option listctlr to list all controllers connected to disks that are attached to the host. For example, to list all controllers connected to disks on the host, use the following command:


# vxdmpadm listctlr all

to display the output from the above command:


CTLR-NAME       ENCLR-TYPE      STATE      ENCLR-NAME
=====================================================
c0              OTHER             ENABLED    Disk
c1              Disk              ENABLED    Disk
c2              Disk              ENABLED    Disk

This output shows that:

  • The first controller c0 is connected to disks that are not under any recognized DMP category.
  • The second and third controllers (c1 and c2) are connected to a JBOD (indicated by an enclosure type of "Disk").

All the above controllers are in the ENABLED state which indicates that they are available for I/O operations.

The state DISABLED is used to indicate that controllers are unavailable for I/O operations. The unavailability can be due to a hardware failure or due to I/O operations being disabled on that controller by the System Administrator. The controller state can be changed by using the vxdmpadm utility.

To list all the paths that are connected to a particular controller, you can use the getsubpaths option with the ctlr attribute. For example, use the following command:


# vxdmpadm getsubpaths ctlr=c1

to display the output from the above command:


NAME       STATE     PATH-TYPE  DMPNODENAME  ENCLR-TYPE   ENCLR-NAME
==================================================================
c1t0d0     ENABLED     -        c2t0d0       Disk          Disk0
c1t1d0     ENABLED     -        c2t1d0       Disk          Disk
c1t2d0     ENABLED     -        c2t2d0       Disk          Disk
c1t3d0     ENABLED     -        c2t3d0       Disk          Disk
c1t4d0     ENABLED     -        c2t4d0       Disk          Disk
c1t5d0     ENABLED     -        c2t5d0       Disk          Disk
c1t6d0     ENABLED     -        c2t6d0       Disk          Disk
c1t16d0    ENABLED     -        c2t16d0      Disk          Disk
c1t17d0    ENABLED     -        c2t17d0      Disk          Disk
c1t18d0    ENABLED     -        c2t18d0      Disk          Disk
c1t19d0    ENABLED     -        c2t19d0      Disk          Disk
c1t20d0    ENABLED     -        c2t20d0      Disk          Disk
c1t21d0    ENABLED     -        c2t21d0      Disk          Disk
c1t22d0    ENABLED     -        c2t22d0      Disk          Disk

The output display shows the paths that are connected to the controller named c1.

You can use the getsubpaths option combined with the dmpnodename attribute to list all paths that are connected to a LUN (represented by a DMP device). For example, to list information about paths that lead to the LUN named c1t0d0, use the following command:


# vxdmpadm getsubpaths dmpnodename=c1t0d0
to display the output from the above command:

NAME       STATE     PATH-TYPE  CTLR-NAME  ENCLR-TYPE   ENCLR-NAME
==================================================================
c2t0d0     DISABLED    -        c2         Disk          Disk
c1t0d0     ENABLED     -        c1         Disk          Disk

The listing above shows that the DMP device c1t0d0 has two paths to it that are named c1t0d0 and c2t0d0. Additional information indicates that only one of these paths is available for I/O operations. One of these paths is in the ENABLED state and the other is in the DISABLED state. Both paths are in a SEAGATE disk array.

To retrieve the name of the DMP device that controls a particular path, the getdmpnode option can be combined with the nodename attribute by using the following command:


# vxdmpadm getdmpnode nodename=c1t0d0

to display the output from the above command:


NAME       STATE     ENCLR-TYPE   PATHS  ENBL  DSBL  ENCLR-NAME
===============================================================
c2t0d0     ENABLED   Disk       2      2     0         Disk

This example output shows that the physical path c1t0d0 is owned by the DMP device c2t0d0, which has two paths to it.

 ^ Return to Top Previous  |  Next  >  
Product: Volume Manager Guides  
Manual: Volume Manager 4.1 Hardware Notes  
VERITAS Software Corporation
www.veritas.com