VXPRINT – UnixArena’s Manual Page .
Product – Veritas Volume Manager-vxvm (Storage Foundation)
“vxprint” command will displays the volume’s,plex’s and sub disk’s record information.
vxprint’s options |
|
Option |
Description |
| -A | Print all disk groups |
| -h | List record hierarchies |
| -r | Print Related information |
| -n | Restrict output to record names |
| -l | List all record information in a verbose format |
| -f | Use simple one line list format |
| -m | List all record information as a make description |
| -t | Use one-line format tailored for each record type |
| – q | Suppress output field header |
| -Q | Suppresses disk group header |
| -g diskgroup | Specify a disk group to print |
| -e pattern | List records that match this search pattern |
| -N | Display only SAN information. default is nonSan only |
| -S | Print configuration summary information |
| -u h|H|unit | Print sizes with user readable extensions |
Disk Media State’s |
|
STATE’s |
Description |
| FAILING | Disk media is failing. |
| LFAILED | The node does not have local access to the disk. The node is sending private region I/Os through the network to a remote node that has local access to the disk. |
| LMISSING | The disk was not discovered locally by DMP. The node does not have a corresponding DMP device for the disk. |
| LOCAL_FAILING | Disk is fenced off. |
| NODEVICE | Disk is not valid. |
| NOHOTUSE | Disk cannot be used for Hot Relocation. |
| REMOVED | Disk is being removed from disk group. |
| RESERVED | Disk is reserved. |
| SPARE | Disk is marked as a spare for disk group. |
| ST_SPARE | Disk is marked as spare for storage pool. |
| VOLATILE | Disk state is changing. |
Volume States |
|
State |
Description |
| CLEAN | 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. |
| ACTIVE | The volume has been started (kernel state is currently ENABLED) |
| EMPTY | The volume contents are not initialized. The kernel state is always DISABLED when the volume is EMPTY. |
| INVALID | The contents of an instant snapshot volume no longer represent a true point-in-time image of the original volume. |
| NEEDSYNC | The volume requires a resynchronization operation the next time it is started. For a RAID-5 volume, a parity resynchronization operation is required. |
| REPLAY | 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 | 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). |
Volume Kernel States |
|
| State |
Description |
| DETACHED | Maintenance is being performed on the volume. The volume cannot be read from or written to, but certain plex operations and ioctl function calls are accepted. |
| DISABLED | The volume is offline and cannot be accessed. |
| ENABLED | The volume is online and can be read from or written to. |
Plex States |
|
State |
Description |
| ACTIVE | 1. When the volume is started and the plex fully participates in normal volume I/O 2. When the volume is stopped as a result of a system crash and the plex is ACTIVE at the moment of the crash |
| CLEAN | When it is known to contain a consistent copy (mirror) of the volume contents and an operation has disabled the volume. As a result, when all plexes of a volume are clean, no action is required to guarantee that the plexes are identical when that volume is started. |
| DCOSNP | Data change object (DCO) plex attached to a volume can be used by a snapshot plex to create a DCO volume during a snapshot operation. |
| EMPTY | Volume creation sets all plexes associated with the volume to the EMPTY state to indicate that the plex is not yet initialized. |
| IOFAIL | When the vxconfigd daemon detects an uncorrectable I/O failure on an ACTIVE plex, it places the plex in the IOFAIL state to exclude it from the recovery selection process at volume start time. |
| LOG | The state of a dirty region logging (DRL) or RAID-5 log plex is always set to LOG. |
| OFFLINE | The vxmend off task indefinitely detaches a plex from a volume by setting the plex state to OFFLINE. |
| SNAPATT | A snapshot plex that is being attached by the snapstart operation, when the attach is complete, the state for the plex is changed to SNAPDONE. If the system fails before the attach completes, the plex and all of its subdisks are removed. |
| SNAPDIS | A snapshot plex that is fully attached. If the system fails before the attach completes, the plex is dissociated from the volume. |
| SNAPDONE | A snapshot plex is ready for a snapshot to be taken |
| SNAPTMP | The SNAPTMP plex state is used during a vxassist snapstart operation when a snapshot is being prepared on a volume. |
| STALE | A plex does not have the complete and current volume contents, that plex is placed in the STALE state. Also, if an I/O error occurs on a plex, the kernel stops using and updating the contents of that plex, and the plex state is set to STALE. |
| TEMP | Setting a plex to the TEMP state eases some plex operations that cannot occur in a truly atomic fashion. |
Plex Kernel States |
|
State |
Description |
| DETACHED | Maintenance is being performed on the plex. |
| DISABLED | The plex is offline and cannot be accessed. |
| ENABLED | The plex is online. A write request to the volume is reflected in the plex. A read request from the volume is satisfied from the plex. |
SubCache & SubDisk Modes |
|
State |
Description |
| DET | The subdisk has been detached. |
| DIS | The subdisk is disabled. |
| dS | The subdisk in a RAID5 plex has failed and the RAID5 volume is in degraded mode (d indicates that the subdisk is detached, and S indicates that its contents are stale). |
| ENA | The subdisk is usable. |
| FAIL | The subdisk has been detached in the kernel due to an error. |
| NDEV | The media record on which the subdisk is defined has no associated access record. |
| RCOV | The subdisk is part of a RAID5 plex and has stale content. |
| RLOC | The subdisk has failed and is waiting to be relocated. |
| RMOV | The media record on which the subdisk is defined has been removed from its disk access record by a utility. |
SubVolume Modes |
|
State |
Description |
| ENA | The subvolume is usable. |
| DIS | The subvolume is disabled. |
| IOFAIL | The subvolume has been detached in the kernel due to an error. |
Command output with Examples:
To Display VxVM configuration Summary:
# vxprint -S Disk group: oradg VOLUMES PLEXES SUBDISKS PLEXFREE SDFREE DISKS RVGS RLINKS STPOOLS VSET CACHES EXPORTS 3 5 6 0 0 4 0 0 0 0 0 0
Display Disk Media Records:
# vxprint -d Disk group: oradg TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTIL0 PUTIL0 dm oradisk01 c3t1d0s2 - 4128288 - - - - dm oradisk02 c3t2d0s2 - 4128288 - - - - dm oradisk03 c2t9d0s2 - 2031232 - - - - # vxprint -l oradisk03 Disk group: oradg Disk: oradisk03 info: diskid=1408760143.38.vxserver1 assoc: device=c2t9d0s2 type=auto flags: autoconfig device: path=/dev/vx/dmp/c2t9d0s2 devinfo: publen=2031232 privlen=65536 mediatype: hdd
Display Disk Group Records:
# vxprint -G TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTIL0 PUTIL0 dg oradg oradg - - - - - - # vxprint -l oradg Disk group: oradg Group: oradg info: dgid=1408715327.33.vxserver1 version: 180 alignment: 8192 (bytes) detach-policy: global dg-fail-policy: dgdisable ioship: off copies: nconfig=default nlog=default devices: max=32767 cur=1 minors: >= 15000 cds=on # vxprint -g oradg TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTIL0 PUTIL0 dg oradg oradg - - - - - - dm oradisk01 c3t1d0s2 - 4128288 - - - - dm oradisk02 c3t2d0s2 - 4128288 - - - - dm oradisk03 c2t9d0s2 - 2031232 - - - - v oravol fsgen ENABLED 204800 - ACTIVE - - pl oravol-01 oravol ENABLED 204800 - ACTIVE - - sd oradisk01-01 oravol-01 ENABLED 204800 0 - - -
Display Volume Records:
# vxprint -v
Disk group: oradg
TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTIL0 PUTIL0
v appsvol fsgen ENABLED 204800 - ACTIVE - -
v oravol fsgen ENABLED 204800 - ACTIVE - -
# vxprint -g oradg -t oravol
V NAME RVG/VSET/CO KSTATE STATE LENGTH READPOL PREFPLEX UTYPE
v oravol - ENABLED ACTIVE 204800 SELECT - fsgen
# vxprint -l oravol
Disk group: oradg
Volume: oravol
info: len=204800
type: usetype=fsgen
state: state=ACTIVE kernel=ENABLED cdsrecovery=0/0 (clean)
assoc: plexes=oravol-01
exports=(none)
policies: read=SELECT (round-robin) exceptions=GEN_DET_SPARSE
flags: closed writeback
logging: type=REGION loglen=0 serial=0/0 mapalign=0 maplen=0 nummaps=64 (disabled)
apprecov: seqno=0/0
recovery: mode=default
recov_id=0
device: minor=15000 bdev=274/15000 cdev=274/15000 path=/dev/vx/dsk/oradg/oravol
perms: user=root group=root mode=0600
guid: {cb16f2d8-2a6a-11e4-8488-000c299c547d}
Display SubDisk Records:
# vxprint -s Disk group: oradg TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTIL0 PUTIL0 sd oradisk01-01 oravol-01 ENABLED 204800 0 - - - sd oradisk03-01 appsvol-01 ENABLED 204800 0 - - - # vxprint -l oradisk01-01 Disk group: oradg Subdisk: oradisk01-01 info: disk=oradisk01 offset=0 len=204800 assoc: vol=oravol plex=oravol-01 (offset=0) flags: enabled device: device=c3t1d0s2 path=/dev/vx/dmp/c3t1d0s2 diskdev=273/130 mediatype: hdd
Display Plexes Related Records:
# vxprint -p Disk group: oradg TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTIL0 PUTIL0 pl appsvol-01 appsvol ENABLED 204800 - ACTIVE - - pl oravol-01 oravol ENABLED 204800 - ACTIVE - - # vxprint -l appsvol-01 Disk group: oradg Plex: appsvol-01 info: len=204800 type: layout=CONCAT state: state=ACTIVE kernel=ENABLED io=read-write assoc: vol=appsvol sd=oradisk03-01 flags: complete mediatype: hdd
Display Configuration records in Human readable format:(Display VXVM Object Size in MB/GB/KB)
# vxprint -hvt -u h -t oravol
Disk group: oradg
V NAME RVG/VSET/CO KSTATE STATE LENGTH READPOL PREFPLEX UTYPE
PL NAME VOLUME KSTATE STATE LENGTH LAYOUT NCOL/WID MODE
SD NAME PLEX DISK DISKOFFS LENGTH [COL/]OFF DEVICE MODE
SV NAME PLEX VOLNAME NVOLLAYR LENGTH [COL/]OFF AM/NM MODE
SC NAME PLEX CACHE DISKOFFS LENGTH [COL/]OFF DEVICE MODE
DC NAME PARENTVOL LOGVOL
SP NAME SNAPVOL DCO
EX NAME ASSOC VC PERMS MODE STATE
v oravol - ENABLED ACTIVE 100.00m SELECT oravol-03 fsgen
pl oravol-03 oravol ENABLED ACTIVE 100.00m STRIPE 2/64.00k RW
sv oravol-S01 oravol-03 oravol-L01 1 50.00m 0/0.00 2/2 ENA
sv oravol-S02 oravol-03 oravol-L02 1 50.00m 1/0.00 2/2 ENA
Note : Use {m - MB, g - GB, k-KB}
Display Records in Line list format:
# vxprint -g oradg -f TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTIL0 PUTIL0 dg oradg oradg - - - - - - dm oradisk01 c3t1d0s2 - 4128288 - - - - dm oradisk02 c3t2d0s2 - 4128288 - - - - dm oradisk03 c2t9d0s2 - 2031232 - - - - dm oradisk04 c3t3d0s2 - 4128288 - - - - sd oradisk01-02 oravol-P03 ENABLED 102400 0 - - - sd oradisk02-02 oravol-P02 ENABLED 102400 0 - - - sd oradisk03-02 oravol-P01 ENABLED 102400 0 - - - sd oradisk04-02 oravol-P04 ENABLED 102400 0 - - - sv oravol-S01 oravol-03 ENABLED 102400 0 - - - sv oravol-S02 oravol-03 ENABLED 102400 0 - - - pl oravol-P01 oravol-L01 ENABLED 102400 - ACTIVE - - pl oravol-P02 oravol-L01 ENABLED 102400 - ACTIVE - - pl oravol-P03 oravol-L02 ENABLED 102400 - ACTIVE - - pl oravol-P04 oravol-L02 ENABLED 102400 - ACTIVE - - pl oravol-03 oravol ENABLED 204800 - ACTIVE - - v oravol fsgen ENABLED 204800 - ACTIVE - - v oravol-L01 fsgen ENABLED 102400 - ACTIVE - - v oravol-L02 fsgen ENABLED 102400 - ACTIVE - -
Display Cache Volumes:
# vxprint -C Disk group: oradg TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTIL0 PUTIL0 co cacheobj - ENABLED - - ACTIVE - -
To display the names of all associated plexes:
# vxprint -n -p -e assoc cachevol-01 oravol-P01 oravol-P02 oravol-P03 oravol-P04 oravol-03
To display the names of all unassociated plexes:
# vxprint -n -p -e \!assoc
To display all unassociated subdisks:
# vxprint -s -e \!assoc
To Display related record to the specified object:
# vxprint -r cachevol Disk group: oradg TY NAME ASSOC KSTATE LENGTH PLOFFS STATE TUTIL0 PUTIL0 dm oradisk02 c3t2d0s2 - 4128288 - - - - v cachevol cacheobj ENABLED 40960 - ACTIVE - - pl cachevol-01 cachevol ENABLED 40960 - ACTIVE - - sd oradisk02-01 cachevol-01 ENABLED 40960 0 - - -