Displaying Volume Information

You can use the vxprint command to display information about how a volume is configured.

To display the volume, plex, and subdisk record information for all volumes in the system, use the following command:

# vxprint -ht

The following is example output from the vxprint command:

Disk group: rootdg
 
DG  NAME      NCONFIG    NLOG    MINORS      GROUP-ID
DM  NAME      DEVICE     TYPE    PRIVLEN     PUBLEN    STATE
V   NAME      USETYPE    KSTATE   STATE      LENGTH    READPOL     PREFPLEX
PL  NAME      VOLUME     KSTATE   STATE      LENGTH    LAYOUT      NCOL/WID    MODE
SD  NAME      PLEX       DISK     DISKOFFS   LENGTH    [COL/]OFF   DEVICE      MODE
dm  disk11    c1t0d0     sliced   559        1044400   -
dm  disk12    c1t1d0     sliced   559        1044400   -
 
v   pubs      fsgen      ENABLED  ACTIVE     2288      SELECT       -
pl  pubs-01   pubs       ENABLED  ACTIVE     2288      CONCAT       -          RW
sd  disk11-01 pubs-01    disk11   0          2288      0             clt0d0    ENA
v   voldef    sgen       ENABLED  ACTIVE     20480     SELECT       -
pl  voldef-01 voldef     ENABLED  ACTIVE     20480     CONCAT       -	          RW
sd  disk12-02  voldef-0    disk12    2288        20480       0               c1t1d0    ENA

where dg is a disk group, dm is a disk, v is a volume, pl is a plex, and sd is a subdisk. The top few lines indicate the headers that match each type of output line that follows. Each volume is listed along with its associated plexes and subdisks.

To display volume-related information for a specific volume, use the following command:

# vxprint -t volume

For example, to display information about the voldef volume, use the following command:

# vxprint -t voldef

This is example output from this command:

Disk group: rootdg
V  NAME    USETYPE  KSTATE   STATE    LENGTH  READPOL  PREFPLEX
v  voldef   fsgen     ENABLED   ACTIVE    20480   SELECT     -




	NOTE: If you enable enclosure-based naming, and use the vxprint command to display the structure of a volume, it shows enclosure-based disk device names (disk access names) rather than c#t#d# names. See “Using vxprint with Enclosure-Based Disk Names” for information on how to obtain the true device names.

The following section describes the meaning of the various volume states that may be displayed.

Volume States

The following volume states may be displayed by VxVM commands such as vxprint:

ACTIVE Volume State

The volume has been started (kernel state is currently ENABLED) or was in use (kernel state was ENABLED) when the machine was rebooted. If the volume is currently ENABLED, the state of its plexes at any moment is not certain (since the volume is in use).

If the volume is currently DISABLED, this means that the plexes cannot be guaranteed to be consistent, but are made consistent when the volume is started.

For a RAID-5 volume, if the volume is currently DISABLED, parity cannot be guaranteed to be synchronized.

CLEAN Volume State

The volume is not started (kernel state is DISABLED) and its plexes are synchronized. For a RAID-5 volume, its plex stripes are consistent and its parity is good.

EMPTY Volume State

The volume contents are not initialized. The kernel state is always DISABLED when the volume is EMPTY.

NEEDSYNC Volume State

The volume requires a resynchronization operation the next time it is started. For a RAID-5 volume, a parity resynchronization operation is required.

REPLAY Volume State

The volume is in a transient state as part of a log replay. A log replay occurs when it becomes necessary to use logged parity and data. This state is only applied to RAID-5 volumes.

SYNC Volume State

The volume is either in read-writeback recovery mode (kernel state is currently ENABLED) or was in read-writeback mode when the machine was rebooted (kernel state is DISABLED). With read-writeback recovery, plex consistency is recovered by reading data from blocks of one plex and writing the data to all other writable plexes. If the volume is ENABLED, this means that the plexes are being resynchronized through the read-writeback recovery. If the volume is DISABLED, it means that the plexes were being resynchronized through read-writeback when the machine rebooted and therefore still need to be synchronized.

For a RAID-5 volume, the volume is either undergoing a parity resynchronization (kernel state is currently ENABLED) or was having its parity resynchronized when the machine was rebooted (kernel state is DISABLED).




	NOTE: The interpretation of these flags during volume startup is modified by the persistent state log for the volume (for example, the DIRTY/CLEAN flag). If the clean flag is set, an ACTIVE volume was not written to by any processes or was not even open at the time of the reboot; therefore, it can be considered CLEAN. The clean flag is always set in any case where the volume is marked CLEAN.

Volume Kernel States

The volume kernel state indicates the accessibility of the volume. The volume kernel state allows a volume to have an offline (DISABLED), maintenance (DETACHED), or online (ENABLED) mode of operation.




	NOTE: No user intervention is required to set these states; they are maintained internally. On a system that is operating properly, all volumes are enabled.

The following volume kernel states are defined:

DETACHED Volume Kernel State

Maintenance is being performed on the volume. The volume cannot be read or written, but plex device operations and ioctl function calls are accepted.

DISABLED Volume Kernel State

The volume is offline and cannot be accessed.

ENABLED Volume Kernel State

The volume is online and can be read from or written to.