NAME
vxdiskadd — add one or more disks for use with the Volume Manager
SYNOPSIS
vxdiskadd disk_address_pattern_list
DESCRIPTION
The vxdiskadd utility configures disks for use by the Volume Manager.
Disks must already have been formatted.
vxdiskadd prompts the user for
a disk group name and disk name for the disks. If no disk group name
specified, the disks will be left as unassigned
replacement disks for future use. A new disk group may be created that
will become the disks' disk group.
If a disk group is specified for the disks,
the user is prompted for whether the disks should be designated as spares
for the disk group.
For new disks, all space on the disk becomes free space
in the disk's disk group. vxdiskadd interactively allows
initialization to be done for all the disks specified or
allows the user to ask to make the decision for each disk individually.
One or more disks may be specified with a
disk_address_pattern_list.
The basic form of a disk address is
c C t T d D. Any leading portion of
this address may be specified to indicate that all disks that match
that leading portion should be used. For example c2t0 may be used
to specify all disks on controller 2, target 0. More than one disk
address or address pattern may be specified on the command line. The
word all may be used to specify all disks on the system. Disk
address names relate directly to device node names in the
/dev/dsk and /dev/rdsk directories. Here are more
examples:
all: all disks
c3 c4t2: all disks on controller 3 and controller 4, target 2
c3t4d2: a single disk
The files /etc/vx/cntrls.exclude and /etc/vx/disks.exclude may
be used to exclude controllers or disks from use by vxdiskadd.
Each line of cntrls.exclude specifies the address of a controller
to exclude, for example, c2. Each line of disks.exclude specifies
a disk to exclude, for example, c0t3d0.
All courses of action that do not involve clear failure conditions require
prompts from the user, with defaults supplied as appropriate. Help is made
available at every prompt. Entering ? in response to a prompt displays
a context-sensitive help message.
OPERATIONS
- Reconnecting a drive that was temporarily inaccessible
This situation is detected automatically by noting that
the specified drive has a disk ID that matches a disk media record
with no currently associated physical disk.
After reconnection,
any stale plexes referring the disk are reattached,
and any stopped volumes referring the disk are restarted.
This reattach action is performed by calling the
vxrecover
utility.
- Initialization of a disk with reserved regions
Initialization of the disk is
performed by calling vxdisksetup.
- Adding a disk to an existing disk group
This operation can be performed independently of the initialization of the
disk drive. The operation adds the disk to the group so that its
storage is added to the free space pool in that disk group.
The
vxassist
utility can 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,
the option of creating the disk group is offered.
FILES
- /etc/vx/cntrls.exclude
Specifies the address of controllers to exclude from
vxdiskadd operations.
- /etc/vx/disks.exclude
Specifies the address of disks to exclude from
vxdiskadd operations.