Home / Syntax / vxdisk Syntax with Examples

vxdisk Syntax with Examples

vxdisk – UnixArena’s Manual Page 

/usr/sbin/vxdisk – Define and manage VERITAS Volume Manager disks

The vxdisk utility performs basic administrative operations on disks. Operations include initializing and replacing disks, as well as taking care of some book-keeping necessary for the disk model presented by VERITAS Volume Manager (VxVM).

Note: A disk does not have a disk media name until it has been initialized by VxVM. For vxdisk operations on an initialized disk (disk), the disk may be specified either by its disk access name or by its disk media name.Physical disks in VxVM are assumed to be movable, and are usually identified by a unique disk ID stored on the physical disk, rather than by a disk device node. This allows disks to be moved to different SCSI target IDs or to different controllers without affecting correct operation.
Tasks Switches
Determine the usability of the specified disks vxdisk [-f] [-g diskgroup] check disk
Clear the host-specific import information stored on the  disks vxdisk [-f] clearimport accessname …
Define disk access record, but do not initialize vxdisk [-f] define accessname [attribute …]
Uninitializes a disk from VxVM vxdisk [-f] destroy accessname …
Rewrite all CDS ID information to the specified disk vxdisk [-f] flush accessname …
Initializes regions of a disk used by VxVM. vxdisk [-f] [-r] init accessname [attribute …]
Display disk summary vxdisk [-g diskgroup] list
Display detailed information about the specified disks vxdisk [-g diskgroup] list accessname
Display OS native name based output vxdisk [-g diskgroup] -e list
Display Disk summary information about specified disk vxdisk  [-g diskgroup] -s list [accessname]
Display discovery information about disks vxdisk  [-g diskgroup] -p list  [accessname]
Customized discovery information vxdisk [-x name1 -x name2] -p list
Display all disk association information vxdisk -o alldgs list
Take the disk offline vxdisk [-f] [-l filename] offline [accessname …]
Bring the disk’s to online vxdisk [-f] [-a] [-l filename] online [accessname …]
Resize Disks or LUNS vxdisk [-f] [-g diskgroup] resize {accessname|medianame} [length=value]
Remove disk from VxVM’s view vxdisk [-f] rm accessname …
Initiates the rescanning of devices vxdisk [-f] scandisks [ [!]device=…| [!]ctlr=…| [!]pctlr=…|new|fabric]
Updates the unique disk identifier vxdisk [-g diskgroup] updateudid disk …

Determine the usability of the specified disks

  # vxdisk check c3t1d0  
	c3t1d0: Error: Disk is not usable

  # vxdisk check c3t2d0
	c3t1d0s2: Okay

Clear the host-specific import information stored on the indicated disks

Example scenario,

VxVM vxdg ERROR V-5-1-10978 Disk group testdg: import failed: Disk is in use by another host
  # vxdisk -f clearimport c3t1d0 c3t2d0

Define disk access record, but do not initialize

  # vxdisk define c4t13d0 format=cdsdisk
  	DEVICE       TYPE            DISK         GROUP        STATUS
  	c4t13d0s2    auto:cdsdisk    -            -            error

  	Device:    c4t13d0s2
	devicetag: c4t13d0
	type:      auto
	info:      format=cdsdisk,privoffset=256,pubslice=2,privslice=2
	flags:     error private
	pubpaths:  block=/dev/vx/dmp/c4t13d0s2 char=/dev/vx/rdmp/c4t13d0s2
	guid:      -
	udid:      -
	site:      -
	errno:     Disk is not useable, bad format
	Multipathing information:
	numpaths:   1
	c4t13d0s2       state=enabled

Un-initializes a disk from VxVM

	DEVICE       TYPE            DISK         GROUP        STATUS
	c4t13d0s2    auto:cdsdisk    -            -            online 

  # vxdisk destroy c4t13d0

	DEVICE       TYPE            DISK         GROUP        STATUS
	c4t13d0s2    auto:none       -            -            online invalid

Rewrite all CDS ID information to the specified disk

  # vxdisk -f flush c4t13d0

Initializes regions of a disk used by VxVM.

	DEVICE       TYPE            DISK         GROUP        STATUS
	c4t13d0s2    auto:cdsdisk    -            -            error

  # vxdisk -f init c4t13d0 format=cdsdisk

	DEVICE       TYPE            DISK         GROUP        STATUS
	c4t13d0s2    auto:cdsdisk    -            -            online

Display disk summary

  # vxdisk list

	DEVICE       TYPE            DISK         GROUP        STATUS
	c1t0d0s2     auto:sliced     rootdisk01   rootdg       online
	c2t0d0s2     auto:sliced     rootdisk02   rootdg       online
	c3t1d0s2     auto:cdsdisk    c3t1d0       testdg       online
	c3t2d0s2     auto:cdsdisk    c3t2d0       testdg       online
	c3t3d0s2     auto:cdsdisk    c3t3d0       testdg       online nohotuse
	c3t4d0s2     auto:cdsdisk    c3t4d0       testdg       online spare
	c3t5d0s2     auto            -            -            offline
	c3t6d0s2     auto:cdsdisk    disk1        newdg        online
	c4t10d0s2    auto:simple     -            -            online
	c4t11d0s2    auto:sliced     -            -            online
	c4t12d0s2    auto:none       -            -            online invalid
	c4t13d0s2    auto:cdsdisk    -            -            error
	c4t14d0s2    auto:none       -            -            online invalid
	-            -         disk2        newdg        failed was:c4t9d0s2

Display detailed information about the specified disks

  # vxdisk list 

  	Device:    c3t1d0s2
	devicetag: c3t1d0
	type:      auto
	hostid:    vxserver
	disk:      name=c3t1d0 id=1411575503.166.vxserver
	group:     name=testdg id=1411577705.178.vxserver
	info:      format=cdsdisk,privoffset=256,pubslice=2,privslice=2
	flags:     online ready private autoconfig autoimport imported
	pubpaths:  block=/dev/vx/dmp/c3t1d0s2 char=/dev/vx/rdmp/c3t1d0s2
	guid:      {68391d66-4406-11e4-a991-000c29656c89}
	udid:      VMware%2C%5FVMware%20Virtual%20S%5FDISKS%5F6000C299459294E7CD53E0D3DEECC10C
	site:      -
	version:   3.1
	iosize:    min=512 (bytes) max=2048 (blocks)
	public:    slice=2 offset=65792 len=2031232 disk_offset=0
	private:   slice=2 offset=256 len=65536 disk_offset=0
	update:    time=1411587144 seqno=0.27
	ssb:       actual_seqno=0.0
	headers:   0 240
	configs:   count=1 len=48144
	logs:      count=1 len=7296
	Defined regions:
	 config   priv 000048-000239[000192]: copy=01 offset=000000 enabled
	 config   priv 000256-048207[047952]: copy=01 offset=000192 enabled
	 log      priv 048208-055503[007296]: copy=01 offset=000000 enabled
	 lockrgn  priv 055504-055647[000144]: part=00 offset=000000
	Multipathing information:
	numpaths:   1
	c3t1d0s2        state=enabled

Display OS native name based output

  # vxdisk -e list

	DEVICE       TYPE           DISK        GROUP        STATUS               OS_NATIVE_NAME   ATTR        
	disk_0       auto:sliced    rootdisk02   rootdg      online               c2t0d0s2         -            
	disk_1       auto:cdsdisk   disk1        newdg       online               c3t6d0s2         -            
	disk_2       auto           -            -           offline              c3t5d0s2         -            
	disk_3       auto:sliced    rootdisk01   rootdg      online               c1t0d0s2         -            
	disk_4       auto:cdsdisk   c3t4d0       testdg      online spare         c3t4d0s2         -            
	disk_5       auto:cdsdisk   c3t1d0       testdg      online               c3t1d0s2         -            
	disk_6       auto:cdsdisk   c3t3d0       testdg      online nohotuse      c3t3d0s2         -            
	disk_7       auto:cdsdisk   c3t2d0       testdg      online               c3t2d0s2         -            
	disk_8       auto:simple    -            -           online               c4t10d0s2        -            
	disk_9       auto:none      -            -           online invalid       c4t12d0s2        -            
	disk_10      auto:cdsdisk   -            -           error                c4t13d0s2        -            
	disk_11      auto:sliced    -            -           online               c4t11d0s2        -            
	disk_12      auto:none      -            -           online invalid       c4t14d0s2        -            
		-            -         disk2        newdg        failed was:c4t9d0s2

Display Disk summary information about specified disk

  # vxdisk -s list c3t1d0s2

	Disk:   c3t1d0s2
	type:   auto
	flags:  online ready private autoconfig autoimport imported
	guid:   {68391d66-4406-11e4-a991-000c29656c89}
	udid:   VMware%2C%5FVMware%20Virtual%20S%5FDISKS%5F6000C299459294E7CD53E0D3DEECC10C
	site:    -
	diskid: 1411575503.166.vxserver
	dgname: testdg
	dgid:   1411577705.178.vxserver
	hostid: vxserver
	info:   format=cdsdisk,privoffset=256,pubslice=2,privslice=2
	vxdisk -o mediatype list

Display discovery information about disks

  # vxdisk -p list c4t9d0s2

	DISK           : c4t9d0s2
	DISKID         : 1411587602.274.vxserver
	VID            : OPNFILER
	UDID           : OPNFILER%5FVIRTUAL-DISK%5FDISKS%5FOPNFILERUEWMXR-tkYE-EV5k
	SCSI_VERSION   : 4
	REVISION       : 0   
	PID            : VIRTUAL-DISK
	PHYS_CTLR_NAME : /iscsi
	MEDIA_TYPE     : hdd
	LUN_SNO_ORDER  : 12
	LUN_SERIAL_NO  : OPNFILERUEWMXR-tkYE-EV5k
	LIBNAME        : scsi3_jbod
	DMP_DEVICE     : c4t9d0
	CAB_SERIAL_NO  : DISKS
	ATYPE          : Disk
	ARRAY_PORT_PWWN: 
	ANAME          : Disk
	TRANSPORT      : iSCSI
	ENCLOSURE_NAME : disk
	DMP_SINGLE_PATH: /dev/rdsk/c4t9d0s2
	NUM_PATHS      : 1

Customized discovery information

  # vxdisk -x DMP_SINGLE_PATH -x NUM_PATHS -p list     

	DEVICE       DMP_SINGLE_PATH NUM_PATHS    
	c1t0d0s2     1            /dev/rdsk/c1t0d0s2 
	c2t0d0s2     1            /dev/rdsk/c2t0d0s2 
	c4t9d0s2     1            /dev/rdsk/c4t9d0s2 
	c4t10d0s2    1            /dev/rdsk/c4t10d0s2 
	c4t11d0s2    1            /dev/rdsk/c4t11d0s2 
	c4t12d0s2    2            NULL  
	c4t13d0s2    2            NULL  
	c4t14d0s2    2            NULL

Display all disk association information

  # vxdisk -o alldgs list

	DEVICE       TYPE            DISK         GROUP        STATUS
	c1t0d0s2     auto:sliced     rootdisk01   rootdg       online
	c2t0d0s2     auto:sliced     rootdisk02   rootdg       online
	c3t1d0s2     auto:cdsdisk    -            (testdg)     online
	c3t2d0s2     auto:cdsdisk    -            (testdg)     online
	c3t3d0s2     auto:cdsdisk    -            (testdg)     online
	c3t4d0s2     auto:cdsdisk    -            (testdg)     online
	c3t5d0s2     auto:cdsdisk    -            -            online
	c3t6d0s2     auto:cdsdisk    -            -            online

Take the disk offline:

This operation cannot be applied to disks that are members of an imported disk group

  # cat /access_names.txt

	c3t1d0s2
	c3t2d0s2
	c3t3d0s2
	c3t4d0s2

 # vxdisk -f -l /access_names.txt offline

 	DEVICE       TYPE            DISK         GROUP        STATUS
	c3t1d0s2     auto            -            -            offline
	c3t2d0s2     auto            -            -            offline
	c3t3d0s2     auto            -            -            offline
	c3t4d0s2     auto            -            -            offline

Bring the disk’s to online

  # vxdisk -f -l /access_names.txt online

	DEVICE       TYPE            DISK         GROUP        STATUS
	c3t1d0s2     auto:cdsdisk    -            -            online
	c3t2d0s2     auto:cdsdisk    -            -            online
	c3t3d0s2     auto:cdsdisk    -            -            online
	c3t4d0s2     auto:cdsdisk    -            -            online

Re-sizing Disks or LUNS

Note:

  • If you dont specify the length, all additional usable space on the device is claimed. – If you shrink a LUN, you must specify the new length explicitly.
  • Any volumes on the device should only be grown after the device itself has first been grown. Otherwise, storage other than the device may be used to grow the volumes, or the volume resize may fail if no free storage is available.
  • Resizing should only be performed on devices that preserve data. Consult the array documentation to verify that data preservation is supported. – It is possible to resize LUNs that are online but not part of any disk group.
  • Do not perform this operation when replacing a physical disk with a disk of a different size as data is not preserved. – Before reducing the size of a device, any volumes on the device should first be reduced in size or moved off the device.
  • If the device that is being resized has the only valid configuration copy for a disk group, the -f option may be specified to forcibly resize the device.
  • Resizing a device that contains the only valid configuration copy for a disk group can result in data loss if a system crash occurs during the resize.
	TY NAME         ASSOC        KSTATE   LENGTH   PLOFFS   STATE    TUTIL0  PUTIL0
	dm disk1        c4t9d0s2     -        2031232  -        -        -       -
	dm disk2        c4t18d0s2    -        982672   -        -        -       -

  # vxdisk -f -g testdg resize disk2

	TY NAME         ASSOC        KSTATE   LENGTH   PLOFFS   STATE    TUTIL0  PUTIL0
	dm disk1        c4t9d0s2     -        2031232  -        -        -       -
	dm disk2        c4t18d0s2    -        2031232  -        -        -       -

Removing disk from VxVM’s view

	DEVICE       TYPE            DISK         GROUP        STATUS
	c3t1d0s2     auto:cdsdisk    -            -            online
	c3t2d0s2     auto:cdsdisk    -            -            online
	c4t14d0s2    auto:none       -            -            online invalid
	c4t16d0s2    auto:none       -            -            online invalid

 # vxdisk rm c4t14d0s2 

	DEVICE       TYPE            DISK         GROUP        STATUS
	c3t1d0s2     auto:cdsdisk    -            -            online
	c3t2d0s2     auto:cdsdisk    -            -            online
	c4t16d0s2    auto:none       -            -            online invalid

Initiates the re-scanning of devices

	DEVICE       TYPE            DISK         GROUP        STATUS
	c3t1d0s2     auto:cdsdisk    -            -            online
	c3t2d0s2     auto:cdsdisk    -            -            online

  # vxdisk scandisks
	DEVICE       TYPE            DISK         GROUP        STATUS
	c3t1d0s2     auto:cdsdisk    -            -            online
	c3t2d0s2     auto:cdsdisk    -            -            online
	c4t16d0s2    auto:none       -            -            online invalid

You can also use the following to re-scan the disks.

  # vxdisk scandisks new
  # vxdisk scandisks fabric
  # vxdisk scandisks ctlr=c1,c2
  # vxdisk scandisks !device=c1t1d0,c2t1d0

Updates the unique disk identifier

  # vxdisk updateudid c4t18d0s2
  # vxdisk list c4t18d0s2 | grep -i udid
	udid:      OPNFILER%5FVIRTUAL-DISK%5FDISKS%5FOPNFILERlEz1fa-xZaX-5wpw

 

VMTURBO-CLOUD-CAPACITY

Leave a Reply

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