Content-type: text/html
voldctl - Control the volume configuration daemon
/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
The voldctl utility manages some aspects of the state of the volume configuration daemon, vold, and manages configuration 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 that is used by the Logical Storage Manager 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 also contains a list of disks to scan in search of the rootdg disk group. At least one disk in this 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 /etc/vol/volboot file is stored in a system-dependent location. On systems that have usable NVRAM for storing configuration parameters, the volboot file may be stored in NVRAM. On other systems, the /etc/vol/volboot file is usually stored on the root file system in the /etc/vol directory.
vold operates in one of three modes: enabled, disabled, or booted. The enabled state is the normal operating state. Most configuration operations are allowed in the enabled state. Entering the enabled state imports all disk groups, and begins the management of device nodes stored in the /dev/vol, /dev/rvol, and /dev/plex directories.
In the disabled state, vold does not retain configuration information for the imported disk groups, and does not maintain the volume and plex device directories. 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 automatically.
The action performed by voldctl depends upon the keyword specified as the first operand. Supported operations are: Reinitialize the /etc/vol/volboot file with a new host ID, and with an empty list of disks. If a hostid operand is specified, then 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(1)). On systems with a hardware-defined system ID, the default host ID might be derived from this hardware ID. Change the host ID in the /etc/vol/volboot file and on all disks in disk groups currently imported on this machine. It may be desirable to change the Logical Storage Manager host ID for your machine if you are also changing the network node name of your machine.
volintro(8), vold(8), voldg(8), voldisk(8)