VxVM – vxdctl Command Syntax with Examples

vxdctl – UnixArena’s Manual Page

Product – Veritas Volume Manager 6.0 (Storage Foundation)

/usr/sbin/vxdctl

•  Manages aspects of the state of the volume configuration daemon ‘vxconfigd’.
•  Sets default disk group for the system.
•  Sets Boot Disk Group if the root disk is under VxVM Control.
•  It uses ‘/etc/volboot’ file to manage default & boot disk groups. It also uses the host ID to establish ownership of physical disks.

Tasks	Switches
Set Default Boot Diskgroup	vxdctl bootdg group
Set Default Diskgroup	vxdctl defaultdg diskgroup
Enable or disable command completion	vxdctl cmdcompletion enable|disable
Place ‘vxconfigd’ into ‘disabled’ mode for maintenance operations	vxdctl disable
Enable ‘vxconfigd’ to rebuild device node directories & DMP databases	vxdctl [-f] enable
Change the ‘hostid’ in volboot file	vxdctl hostid hostid
Reinitialize the volboot file	vxdctl init [hostid]
Recreate fresh nodes for DMP devices	vxdctl initdmp
List or Rescan VxVM licenses for usable features	vxdctl license [init]
Display ‘volboot’ file information	vxdctl list
Display or Set ‘vxconfigd’ log level(0-9)	vxdctl debug {[tagged=]level [pathname] | get}
Display Current Operating Mode	vxdctl [-c] mode
Print  cluster protocol range supported by the node	vxdctl protocolrange
Print  current cluster protocol version of the node	vxdctl protocolversion
Display or Set maximum number of threads available to process	vxdctl request_threads [count]
Display or Set Protocol version in ‘volboot’ file	vxdctl setversion [version]
Request ‘vxconfigd’ to exit	vxdctl [-k] stop
Displays  versions of VxVM objects & components that are supported	vxdctl support
Displays the shared transaction status of the node	vxdctl transstate
Remove an attribute from the volboot file	vxdctl [-F] unset attribute
Upgrade cluster to the highest cluster protocol possible	vxdctl upgrade

vxdctl  – Examples

Set Default Boot Diskgroup

  # vxdctl bootdg rootdg

Set Default Diskgroup

  # vxdctl defaultdg testdg

Enable or disable command completion

  # vxdctl cmdcompletion enable
	  VxVM vxdctl INFO V-5-2-0
	  Enabling command auto-completion feature with this interface will: 
	    - Newly create .bash_profile, if it is not present.
	    - If .profile file exists, it will copy the contents of .profile to .bash_profile.
	        So user need to use .bash_profile as a default profile file.
	    - Persistently enable the feature with every login to bash shell.

	  If you don't wish to newly create .bash_profile, then you need to either reinvoke
	    bash shell or source /etc/bash_completion.d/vx_bash manually each time you login.

	  Do you want to continue? [y,n,q,?]  (default: y) y
 	 VxVM vxdctl INFO V-5-2-0  VxVM command auto-completion successfully enabled.

   # vxdctl cmdcompletion disable
  	VxVM vxdctl INFO V-5-2-0   VxVM command auto-completion successfully disabled.

Place ‘vxconfigd’ into ‘disabled’ mode for maintenance operations

  # vxdctl disable

  	# vxprint -hvtg oradg
	VxVM vxprint ERROR V-5-1-684 IPC failure: Configuration daemon is not accessible

Enable ‘vxconfigd’ to rebuild device node directories & DMP databases

  # vxdctl enable

Change the ‘hostid’ in volboot file

  # vxdctl hostid s10u11.vxtestserver

List  VxVM licenses for usable features

  # vxdctl license
  	All features are available:
	 Mirroring
	 Root Mirroring
	 Concatenation
	 Disk-spanning
	 Striping
	 RAID-5
	 RAID-5 Snapshot
	 VxSmartSync
	 Array Snapshot Integration Feature
	 FastResync
	 DGSJ
	 Site Awareness
	 DMP (multipath enabled)
	 CDS
	 Dynamic LUN Expansion
	 Hardware assisted copy
	 DMP Native Support

Re-scan VxVM licenses for usable features

  # vxdctl license init

Display ‘volboot’ file information

  # vxdctl list
  	Volboot file
	version: 3/1
	seqno:   0.3
	cluster protocol version: 120
	hostid:  vxserver
	defaultdg:  oradg
	bootdg:  rootdg
	hostguid:  {0a580b84-397b-11e4-a991-000c29656c89}

Display or Set ‘vxconfigd’ log level(0-9)

  # vxdctl debug get
	loglevel: 0 taggedlevel: 0 logfile:

Display Current Operating Mode

  # vxdctl mode
  	mode: enabled

Print the cluster protocol range supported by the node

  # vxdctl protocolrange
  	minprotoversion: 90, maxprotoversion: 120

Print the current cluster protocol version of the node

  # vxdctl protocolversion

Display or Set maximum number of threads available to process

  # vxdctl request_threads 
  	2

Display or Set Protocol version in ‘volboot’ file

  # vxdctl setversion 
	100
  # vxdctl setversion 120

  # vxdctl setversion 
	120

Displays the versions of VxVM objects and components that are supported

  # vxdctl support
  	Support information:
	  vxconfigd_vrsn:   34
	  dg_minimum:       20
	  dg_maximum:       180
	  kernel:           33
	  protocol_minimum: 90
	  protocol_maximum: 120
	  protocol_current: 0

Displays the shared transaction status of the node

  # vxdctl transstate
	transaction state: cluster inactive