Manual Page Result
0
Command: voldiskadd | Section: 8 | Source: Digital UNIX | File: voldiskadd.8.gz
voldiskadd(8) System Manager's Manual voldiskadd(8)
NAME
voldiskadd - Add a disk for use with the Logical Storage Manager (LSM)
SYNOPSIS
/usr/sbin/voldiskadd [dd[l]n[nnn][p]]
DESCRIPTION
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 in-
volve 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 ac-
tions: "Initialization of a disk with reserved regions and partitions."
Initialization of the disk will be performed by calling vold-
isksetup. "Adding a disk to an existing disk group."
This operation can be performed independently of the initializa-
tion of the disk drive, and will add the disk to the group so
that it's storage will be added to the free space pool in that
disk group. The volassist utility may subsequently allocate
from that free space. "Creation of new disk groups in which to
import a new disk."
If disks are added that are required to be put into a disk group
that does not exist, then the option of creating the disk group
will be offered.
ERRORS
You may receive the following messages when using the voldiskadd com-
mand: 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 par-
tition 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 by entering y at the prompt. The voldiskadd
command will proceed to initialize the disk partition and add it
to LSM.
RELATED INFORMATION
volintro(8), volassist(8), voldisksetup(8), voldisk(8) delim off
voldiskadd(8)