vxdctl(1M)

Add to the list of disks in the 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 0 at SCSI target 1 on SCSI controller 2, enter:

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

Request 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.

Request that vxconfigd enter enabled mode, import all disk groups, and rebuild the volume and plex 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 and plex device nodes. This operation will cause 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 the Volume Manager. If the Multipathing support is available, this option will also cause 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.

Change 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 Volume 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, 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.

Reinitialize 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, 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.

Create user level nodes for all the DMP devices that have been detected by the kernel. This will remove all the existing DMP nodes in /dev/vx[r]dmp directory, and create fresh nodes for the DMP devices that have been detected.

With an argument of init, 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, vxdctl license init forces vxconfigd to rescan the licenses and make the new licenses available.

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

List the contents of the volboot file. This list includes the host ID, some sequence numbers, the cluster protocol version and the list of disks and disk attributes stored in the volboot file.

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

where operating_mode is either 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:

The clustered_state is one of cluster inactive, cluster active - role not set, cluster active - MASTER, cluster active - SLAVE. Available only if the Volume Manager cluster feature is enabled.

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

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

The protocolversion is a value in the range listed by vxdctl protocolrange. Available only if Volume Manager cluster feature is enabled.

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

Display information about what versions of various VxVM objects or components are supported by the configuration daemon currently running. Versions are printed as colon-separated name/value pairs. vold_vrsn indicates the version of vxconfigd that is currently running; dg_minimum and dg_maximum indicate the lowest and highest diskgroup versions supported by vxconfigd; and the kernel: indicates the highest kernel version supported by vxconfigd. protocol_minimum and protocol_maximum indicate the lowest and highes cluster protocol versions supported by the node. protocol_current indicates the cluster protocol version that is currently running on the node. The protocol version information is meaningful only for the Volume Manager Cluster feature.

Request that vxconfigd exit. This may be necessary to reset the Volume Manager, such as using the -r reset option to vxconfigd. This does not disable any configuration state loaded into the kernel. It only affects the ability to make configuration changes until vxconfigd is restarted. If the -k option is used vxconfigd will be stopped by sending it a SIGKILL signal. The command will delay for up to one second to verify that vxconfigd has exited. After one second if vxconfigd has not exited an error will be returned.

Request that the cluster be upgraded to the highest cluster protocol possible. Available only if Volume Manager cluster feature is enabled.