unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 vxdctl(1M)			  VxVM 3.5			  vxdctl(1M)
				 1 Jun 2002



 NAME
      vxdctl - control the volume configuration daemon

 SYNOPSIS
      vxdctl [ -c ] mode

      vxdctl [ -k ] stop

      vxdctl add disk accessname [ attr[=value] ]...

      vxdctl disable

      vxdctl enable

      vxdctl hostid hostid

      vxdctl init [ hostid ]

      vxdctl initdmp

      vxdctl license [init]

      vxdctl list

      vxdctl mode

      vxdctl protocolrange

      vxdctl protocolversion

      vxdctl rm disk accessname...

      vxdctl support

      vxdctl upgrade

 DESCRIPTION
      The vxdctl utility manages aspects of the state of the volume
      configuration daemon, vxconfigd, and also manages aspects of
      configuration for bootstrapping the rootdg disk group.

      The volboot file forms a key element in managing the state of
      vxconfigd and bootstrapping the rootdg disk group.  This file contains
      a host ID that VERITAS Volume Manager (VxVM) uses to establish
      ownership of physical disks.  The host ID is used to ensure that two
      or more hosts do not interfere with each other when accessing disks on
      a shared SCSI bus or Storage Area Network (SAN).	VxVM also uses host
      IDs to generate unique ID strings for stamping disks and disk groups.

      Note: The purpose of the cluster environment is to allow hosts that
      can access disks on a shared bus to do so in a coordinated way.  In



				    - 1 -	  Formatted:  August 2, 2006






 vxdctl(1M)			  VxVM 3.5			  vxdctl(1M)
				 1 Jun 2002



      this environment, the host ID is not used to prevent shared access;
      however, it is used for other internal functions.

      The volboot file also contains a list of disks to scan in search of
      the rootdg disk group. Unless at least one disk in this list is both
      readable and is part of the rootdg disk group, VxVM cannot start up
      correctly.

      vxconfigd operates in one of the following modes: enabled, disabled or
      booted.

      The enabled state is the normal operating state.	Most configuration
      operations are allowed in this state.  Entering the enabled state
      imports all disk groups, and begins the management of device nodes
      stored in the /dev/vx/dsk and /dev/vx/rdsk directories.

      In the disabled state, vxconfigd does not retain configuration
      information for the imported disk groups, and does not maintain the
      volume device directories.  Most operations are disallowed in this
      state.  Certain failures, most commonly the loss of all disks or
      configuration copies in the rootdg disk group, cause vxconfigd to
      enter the disabled state automatically.

      The booted state is entered as part of normal system startup, prior to
      checking the root file system with fsck. Entering the booted mode
      imports the rootdg disk group, and then waits for a request to enter
      the enabled mode.	 The volume device node directories are not
      maintained in booted mode, because it may not be possible to write to
      the root file system.

      The action performed by vxdctl depends upon the specified keyword
      operand(s).

 KEYWORDS
      add disk	Adds one of more disks specified by their disk access names
		to the list of disks in the volboot file.  (A disk access
		name identifies the physical address of the disk.) For
		example, to add disk 0 at SCSI target 1 on SCSI controller
		2, enter:


		     vxdctl add disk c2t1d0


		This adds the disk c2t1d0.  If there is a disk access record
		in the rootdg configuration for the named disk,
		configuration parameters are taken from that record.
		Otherwise, it may be necessary to specify some attributes to
		vxdctl add disk.





				    - 2 -	  Formatted:  August 2, 2006






 vxdctl(1M)			  VxVM 3.5			  vxdctl(1M)
				 1 Jun 2002



      disable	Requests that vxconfigd enter disabled mode.  This may be
		necessary to perform some maintenance operations.  This does
		not disable any configuration state loaded into the kernel.
		It only prevents further configuration changes to loaded
		disk groups until vxconfigd is re-enabled.

      enable	Requests that vxconfigd enter enabled mode, import all disk
		groups, and rebuild the volume device node directories.
		This operation can be used even if vxconfigd is already in
		enabled mode.  The primary purpose for using this operation
		when in enabled mode is to rebuild the volume device nodes.
		This operation causes vxconfigd to scan for any disks that
		were newly added since vxconfigd was last started.  In this
		manner, disks can be dynamically configured to the system
		and then recognized by VxVM.  If the multipathing support is
		available, this option also causes vxconfigd to rebuild the
		DMP internal database to reflect the new state of the system
		after addition of the disk devices.  The new disk devices
		detected by vxconfigd are added in the DMP database with
		their associated subpaths and parent DMP device.

      hostid	Changes the host ID in the volboot file, and on all disks in
		disk groups currently imported on this machine.	 It may be
		desirable to change the VxVM host ID for your machine if you
		change the network node name of your machine.

		If some disks are inaccessible at the time of a hostid
		operation, it may be necessary to use the vxdisk clearimport
		operation to clear out the old host ID on those disks when
		they become reaccessible.  Otherwise, you may not be able to
		re-add those disks to their disk groups.

		Note: Be careful when using this command.  If the system
		crashes before the hostid operation completes, some disk
		groups may not reimport automatically.

      init	Reinitializes the volboot file with a new host ID, an empty
		list of disks, and with the highest supported cluster
		protocol version.  If a hostid operand is specified, this
		string is used; otherwise, a default host ID is used.  The
		default host ID is normally taken as the network node name
		for the host (see uname(1M)).  On systems with a hardware-
		defined system ID, the default host ID might be derived from
		this hardware ID.

      initdmp	Creates user level nodes for all DMP devices that the kernel
		has detected.  This removes all existing DMP nodes in the
		/dev/vx/[r]dmp directory, and creates fresh nodes for the
		DMP devices that have been detected.





				    - 3 -	  Formatted:  August 2, 2006






 vxdctl(1M)			  VxVM 3.5			  vxdctl(1M)
				 1 Jun 2002



      license [init]
		Without any arguments, the vxdctl license command prints the
		list of features which are currently available based on
		known licensing information.

		Note: If only a Base VxVM license is installed, the vxdctl
		license command displays "DMP (single path enabled)".  If
		either the Full VxVM license or an automatically generated
		license (such as that for the PHOTON array) is installed,
		the command displays "DMP (multipath enabled)".

		With the init argument specified, the vxdctl license init
		command requests that vxconfigd re-read any persistently
		stored license information.  If licenses have expired, this
		can make some features unavailable.  If new licenses were
		added, but are not yet recognized by vxconfigd, this command
		forces vxconfigd to rescan the licenses, and to make the new
		licenses available.

      list	Lists the contents of the volboot file including the host
		ID, some sequence numbers, the cluster protocol version and
		a list of disks and disk attributes.

      mode	Prints the current operating mode of vxconfigd.	 The output
		format is:


		     mode: operating_mode


		where operating_mode is one of enabled, disabled, booted, or
		not-running.

		If the -c flag is specified and vxconfigd is in the enabled
		mode, the clustered state of vxconfigd is displayed.  The
		output format is:


		     mode: enabled: clustered_state


		where clustered_state is one of cluster inactive, cluster
		active - role not set, cluster active - MASTER, cluster
		active - SLAVE.	 This information is only available if the
		VxVM cluster feature is enabled.

      protocolrange
		Print the cluster protocol range supported by the node.	 The
		output format is:





				    - 4 -	  Formatted:  August 2, 2006






 vxdctl(1M)			  VxVM 3.5			  vxdctl(1M)
				 1 Jun 2002



		     minprotoversion: minimum protocol version, \
		     maxprotoversion: maximum protocol version

      protocolversion
		Prints the current cluster protocol version of the node.
		The output format is:

		     cluster running at protocol protocolversion

		The protocolversion is a value in the range listed by vxdctl
		protocolrange.	This information is only available if the
		VxVM cluster feature is enabled.

      rm disk	Removes one or more disks from the volboot file.  Disks are
		specified based on the name used in the corresponding vxdctl
		add disk operation.

      support	Displays information about the versions of VxVM objects and
		components that are supported by the configuration daemon
		that is currently running.  Versions are printed as colon-
		separated name/value pairs:

		vxconfigd_vrsn	      Version of vxconfigd that is currently
				      running.

		dg_minimum	      Lowest disk group version supported by
				      vxconfigd.

		dg_maximum	      Highest disk group version supported
				      by vxconfigd.

		kernel		      Highest kernel version supported by
				      vxconfigd.

		protocol_minimum      Lowest cluster protocol version
				      supported by the node.

		protocol_maximum      Highest cluster protocol version
				      supported by the node.

		protocol_current      Cluster protocol version currently
				      running on the node.

		The protocol version information is only meaningful for the
		VxVM cluster feature.

      stop	Requests that vxconfigd exit.  This may be necessary to
		reset VxVM, such as when the -r reset option is specified to
		vxconfigd.  This command does not disable any configuration
		state that is loaded into the kernel.  It only affects the
		ability to make configuration changes until vxconfigd is



				    - 5 -	  Formatted:  August 2, 2006






 vxdctl(1M)			  VxVM 3.5			  vxdctl(1M)
				 1 Jun 2002



		restarted.  If the -k option is used, vxconfigd is stopped
		by sending it a SIGKILL signal. The command pauses for up to
		one second to verify that vxconfigd has exited. It returns
		an error if vxconfigd has not exited after one second's
		delay has elapsed.

      upgrade	Requests that the cluster be upgraded to the highest cluster
		protocol possible. This is only available if the VxVM
		cluster feature is enabled.

 FILES
      /etc/vx/volboot

 SEE ALSO
      fsck(1M), signal(5), uname(1M), vxconfigd(1M), vxdg(1M), vxdisk(1M),
      vxdmp(7), vxintro(1M), vxlicinst(1), vxlicrep(1)






































				    - 6 -	  Formatted:  August 2, 2006