Home / Syntax / vxprint – syntax with examples

vxprint – syntax with examples

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        -        -       -
VMTURBO-CLOUD-CAPACITY

Leave a Reply

Your email address will not be published. Required fields are marked *