 |
Index for Section 8 |
|
 |
Alphabetical listing for V |
|
voldiskadm(8)
NAME
voldiskadm - Administrate disks
SYNOPSIS
/usr/sbin/voldiskadm
DESCRIPTION
The voldiskadm script presents a menu of possible operations to the user.
Based on the selection of operations, the script guides the user through
the necessary steps, and prompts for data that must be user-supplied for
completion of the operation. This script is intended for users that
understand only a limited set of concepts, and also for users that simply
wish to use a simple method for doing common operations.
The voldiskadm script is interactive in nature. It is intended to lead the
user of the script through the various possible courses of action that
might be taken with a disk that is not currently part of an active disk
group. Courses of action that do not involve a clear single alternative
require prompts to be answered by 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.
The voldiskadm script presents the following list of operations:
· Add or initialize a new disk
This menu option prompts for a disk, by device name or partition name.
The user is prompted for a disk group (which defaults to rootdg). The
user is also given the alternative of initializing the disk but
leaving it unallocated to a disk group. If a disk group is specified,
the user is then asked to name the disk. A default disk name of the
form disknumber is chosen for the root disk group. If the disk is to
be added to another disk group, then the name will be of the form
diskgroupnumber such that the name will be unique within all imported
disk groups.
The operation proceeds by changing the disklabel of the disk to
initialize private and public regions. The operation also performs
additional LSM initialization tasks that include adding a disk header
and writing an empty configuration on the disk. If a disk group was
specified, the last step is to add the disk to that disk group.
If the disk is currently in use or was previously in use, appropriate
warning and error messages are printed. Refer to voldiskadd(8) for
descriptions of these messages.
· Encapsulate a disk
This operation prompts for a disk, by device name or partition
identifier. The operation then invokes volencap to either encapsulate
all partitions on the named disk if a disk name was specified, or
encapsulate a specific partition if a partition identifier was
specified.
· Remove a disk
This operation prompts for a disk, by media name. The disk is checked
to ensure that no subdisks reside on the disk. If the disk is in use,
then the operation fails with a recommendation to first move all
volumes off the disk. If this disk is the last disk in a disk group,
the user is prompted for whether the disk group should be removed from
the system, as well.
The operation proceeds by calling voldg rmdisk to remove the disk from
its disk group. If this is the last disk in its disk group, then voldg
deport is used, instead, to remove the disk group from use.
· Remove a disk for replacement
This operation prompts for a disk, by media name. The disk is checked
for volumes that would lose all mirrors as a result of the operation.
If such volumes exist, those volumes are listed and the user is
prompted to ensure that the operation should proceed.
The operation proceeds by calling voldg -k rmdisk to dissociate the
media record from the physical disk. If some formatted disks are
available that have disk headers but no disk group, then the user is
prompted for whether one of these disks should be used as a
replacement.
· Replace a failed or removed disk
This operation prompts for a disk media name. The named media record
must be dissociated from a disk. If the media record is not in the
removed state, then unused disks are scanned for matching disk IDs.
If a disk with a matching disk ID is found, the user is prompted for
whether that disk should be reattached.
If a matching disk is not used, the user is prompted for a new disk,
by device address. If the named replacement disk has a valid disk
header, but is not allocated to a disk group, the user is prompted for
whether the disk should be reinitialized. If the named replacement
disk is listed as allocated to a disk group or to another host, then
the user is prompted to ensure that the operation should proceed.
If the device is to be initialized, then a new disklabel is written to
the disk to reflect its private and public regions.
Given an initialized disk, the operation proceeds by replacing the
disk in a disk group with voldg -k adddisk.
· Mirror volumes on a disk
This menu option prompts for a disk, by media name. It then prompts
for a destination disk within the same disk group, also by media name.
Specifying no destination disks indicates that any disk is suitable.
The operation proceeds by calling volmirror to mirror the volumes.
· Move volumes from a disk
This menu option prompts for a disk, by media name. It then prompts
for a possible list of destination disks, also be media name.
Specifying no destination disks indicates that any disk is suitable.
The operation proceeds by calling volevac to move subdisks off the
disk.
· Enable (import) a disk group
This menu option prompts for a disk, by device address. The operation
proceeds by calling voldg import to import the disk group stored on
that disk.
· Disable (deport) a disk group
This menu option prompts for a disk group name. The prompt display
lists alternate disk groups and the disks (media name and access name)
that they contain. The operation proceeds by calling voldg deport.
· Enable (online) a disk
This option prompts for a disk device. The prompt display will allow
for a display of disks on the system. The operation will only function
for disks currently in an offline state. It will then proceed to make
the disk accessible.
· Disable (offline) a disk
This option prompts for a disk device. The prompt display will allow
for a display of disks on the system. The operation will only function
for disks currently in an online state but not part of any disk group.
It will then proceed to mark the disk as offline such that the Logical
Storage Manager will make no further attempt at accessing the disk.
ERRORS
See the voldiskadd(8) reference page for a description of errors related to
the initialization operation.
SEE ALSO
disklabel(8), volintro(8), voldg(8), voldisk(8), voldiskadd(8),
voldisksetup(8)