Content-type: text/html
Man page of voldiskadm
voldiskadm
Section: Maintenance Commands (8)
Index
Return to Main Contents
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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- ERRORS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 02:40:39 GMT, October 02, 2010