unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



voldctl(8)							   voldctl(8)



NAME

  voldctl - Controls the Logical Storage Manager volume	configuration daemon

SYNOPSIS

  /sbin/voldctl	init [hostid]

  /sbin/voldctl	hostid hostid

  /sbin/voldctl	add disk accessname [attr[=value]]...

  /sbin/voldctl	rm disk	accessname...

  /sbin/voldctl	list

  /sbin/voldctl	enable

  /sbin/voldctl	disable

  /sbin/voldctl	[-k] stop

  /sbin/voldctl	mode

  /sbin/voldctl	license	[init]

DESCRIPTION

  The voldctl utility manages some aspects of the state	of the Logical
  Storage Manager volume configuration daemon, vold, and manages configura-
  tion aspects related to bootstrapping	the rootdg disk	group configuration.

  A key	part of	the state of vold and of bootstrapping the rootdg disk group
  is the /etc/vol/volboot file.	This file contains a host ID, which is usu-
  ally the host	name, which LSM	uses to	establish ownership of physical
  disks. This host ID is used to ensure	that two or more hosts that can
  access disks on a shared SCSI	bus will not interfere with each other in
  their	use of those disks. This host ID is also important in the generation
  of some unique ID strings that are used internally by	the Logical Storage
  Manager for stamping disks and disk groups.

  The /etc/vol/volboot file might also contain a list of disks to scan in
  search of the	rootdg disk group.  This list is needed	only if	the autocon-
  figuration functionality of LSM is disabled (see vold(8) for details). At
  least	one disk in the	list must be both readable and a part of the rootdg
  disk group, or the Logical Storage Manager will not be able to start up
  correctly.

  The vold daemon operates in one of three modes: enabled, disabled, or
  booted.  The enabled state is	the normal operating state. Most configura-
  tion operations are allowed in the enabled state. Entering the enabled
  state	imports	all disk groups	that were previously imported on this host,
  and begins the management of device nodes stored in the /dev/vol and
  /dev/rvol directories.

  In the disabled state, vold does not retain configuration information	for
  the imported disk groups, and	does not maintain the volume device direc-
  tories. Most operations are disallowed in the	disabled state.	Certain
  failures, most commonly the loss of all disks	or configuration copies	in
  the rootdg disk group, will cause vold to enter the disabled state automat-
  ically.

  The booted state is entered as part of normal	system startup,	prior to
  checking the root file system	(see fsck(1)). 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 might	not be possible	to write to the	root file
  system.

KEYWORDS

  The action performed by voldctl depends upon the keyword specified as	the
  first	operand. Supported keywords are:

  init
      Reinitializes the	/etc/vol/volboot file with a new host ID (which	is
      usually the host name), and an empty list	of disks. If a hostid operand
      is specified, this string	is used; otherwise, a default host ID is
      used. On systems with a hardware-defined system ID, the default host ID
      might be derived from this hardware ID.

  hostid
      Changes the host ID, which is usually the	host name, in the
      /etc/vol/volboot file and	on all disks in	disk groups currently
      imported on this machine.	You might want to change the Logical Storage
      Manager host ID for your machine if you are also changing	the network
      node name	of your	machine.

      If some disks are	inaccessible at	the time of a hostid operation,	you
      might need to use	the voldisk clearimport	operation to clear out the
      old host ID on those disks when they become accessible.  Otherwise, you
      might not	be able	to readd those disks to	their disk groups.


				       Note

	 Take care when	using this command. If the system crashes before the
	 hostid	operation completes, some disk groups might not	reimport
	 automatically.

  add disk
      Adds to the list of disks	in the /etc/vol/volboot	file. Disks are
      specified	based on their disk access name. This name identifies the
      physical address of the disk. For	example, to add	disk dsk3c, use	the
      command:
	   /sbin/voldctl add disk dsk3c

      If there is a disk access	record in the rootdg configuration for the
      named disk, configuration	parameters are taken from that record. Other-
      wise, you	might need to specify some attributes to voldctl add disk.

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

  list
      Lists the	contents of the	/etc/vol/volboot file. This list includes the
      host ID (which is	usually	the host name),	some sequence numbers, and
      the list of disks	and disk attributes stored in the /etc/vol/volboot
      file.

  enable
      Requests that vold enter enabled mode, import all	disk groups that were
      previously imported on this host,	and rebuild the	volume device node
      directories. This	operation can be used even if vold is already in
      enabled mode, however any	deported disk groups remain deported. The
      primary purpose for using	this operation when in enabled mode is to
      cause vold to scan for any disks that were newly added since vold	was
      last started.  This operation will also rebuild the volume device
      nodes. In	this manner, disks can be dynamically configured to the	sys-
      tem and then recognized by the Logical Storage Manager.

      If this operation	fails, voldctl exits with the appropriate error
      status and displays an error message.

  disable
      Requests that vold enter disabled	mode. This might be necessary to per-
      form some	maintenance operations.	This does not disable any configura-
      tion state loaded	into the kernel. It only prevents further configura-
      tion changes to loaded disk groups until vold is reenabled.

  stop
      Requests that vold exit. This might be necessary to reset	the Logical
      Storage Manager, such as using the -r reset option to vold. This does
      not disable any configuration state loaded into the kernel. It only
      affects the ability to make configuration	changes	until vold is res-
      tarted. If the -k	option is used vold will be stopped by sending it a
      SIGKILL signal. The command will delay for up to 1 second	to verify
      that vold	has exited. After 1 second if vold has not exited an error
      will be returned.

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

      mode: operating_mode

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

  license [init]
      With an argument of init,	requests that vold reread any persistently
      stored license information. If licenses have expired, this might cause
      some features to become unavailable. If new licenses have	been added,
      this will	make the features defined in those licenses available.

      With no arguments, voldctl license prints	the list of features that are
      currently	available based	on known licensing information.

SEE ALSO

  volintro(8), vold(8),	voldg(8), voldisk(8), signal(4)