voldiskadd - Add a disk for use with the Logical Storage Manager (LSM)
The voldiskadd utility sets up new disks that are added to the system after the initial system installation and configures the disks for use by the Logical Storage Manager. A valid disklabel should exist on the disk before using the voldiskadd command.
The voldiskadd utility is an interactive command that prompts the user for information about disk setup. All courses of action that do not involve clear failure conditions require the user to answer prompts, with defaults supplied as appropriate. Help is available at every prompt. Entering ? in response to a prompt displays a context-sensitive help message.
Disk setup includes changing the disk's disklabel to include LSM disklabel tags, the size of the LSM private region, and the size of the LSM public region.
An argument passed to the voldiskadd command directs the command to the disk being added. The argument is a physical address, comprised of the following elements: the device mnemonic dd (rz for SCSI devices, re for SCSI RAID devices, and ra for MSCP devices), l for the LUN number for SCSI RAID devices, the unit number (n), and, optionally, the partition identifier (p). The partition identifier is a lowercase letter in the range a to h.
The voldiskadd utility supports the following general classes of actions: Initialization of a disk with reserved regions and partitions.
You may receive the following messages when using the voldiskadd command:
Initialization of disk device special-device failed. Error: special-device or an overlapping partition is open. Quitting ....
This message indicates that the partition you specified or an overlapping partition on the disk is actively in use. The partition could be a mounted UFS or AdvFS filesystem, initialized as an LSM disk or used as a swap device.
special-device is marked in use for fstype in the disklabel. If you continue with the operation you can possibly destroy existing data.
Would you like to continue?? [y,n,q,?] (default: n)
This message indicates that the fstype of a partition or an overlapping partition is set in the disk label. The voldiskadd command prints this message to warn that a disk partition may have valid data which could be destroyed.
If you are sure that the disk partition does not have valid data and
that the partition can be added to LSM, you can ignore the warning message
at the prompt. The
command will proceed to initialize the disk partition and add it to LSM.
volintro(8), volassist(8), voldisksetup(8), voldisk(8)