 |
Index for
Section 8 |
|
 |
Alphabetical
listing for V |
|
 |
Bottom of
page |
|
voldiskadm(8)
NAME
voldiskadm - Menu interface for LSM disk administration
SYNOPSIS
/usr/sbin/voldiskadm
DESCRIPTION
The voldiskadm script is an interactive tool that presents you with a menu
of possible operations. When you select an operation, the script guides you
through the necessary steps, and prompts for data needed to complete the
operation.
The voldiskadm interface is intended mainly for beginning users and for
those who prefer a simple method for doing common operations. The
interface uses query-based prompts to gather input, with defaults supplied
when possible. Context-sensitive help is available at every prompt by
typing ?. Also, you can enter l or list to get information on available
target disks for an operation.
For operations that require a device name, you can specify one or more
names using a space-separated list. Names in the list can have the form
dskn or rdskn (for an entire disk) or dsknp or rdsknp (for a specific disk
partition). Disk names relate directly to device names in the /dev/disk and
/dev/rdisk directories.
The file /etc/vol/disks.exclude may be used to exclude disks from use by
voldiskadm. Each line of the file specifies the name of a disk to exclude
(for example, dsk5).
The voldiskadm menu includes the following numbered options:
1. Add or initialize one or more disks
This option prompts for one or more disk device addresses, which must
have valid disk labels. You can add the specified disks to an existing
disk group, add them to (create) a new disk group, add them to a disk
group as spares, or initialize them but do not add them to a disk
group (to reserve them for use as replacement disks).
After specifying the disks, you are prompted for a disk group (rootdg
by default) and a disk name. If no name is specified, a default disk
name is assigned (diskn for disks in the rootdg disk group and
diskgroupn for disks in other disk groups).
The disks are then checked to ensure that there is no information
already on them. If there is, you are given the option of
encapsulating the disks or proceeding with the initialization. If you
want to preserve the information on the disk, encapsulate it.
2. Encapsulate one or more disks
This option prompts for one or more disk addresses. It then calls
volencap to encapsulate the specified partitions.
3. Remove a disk
This option prompts for a disk, by disk media name, to completely
remove from LSM. The disk is checked to ensure that no subdisks reside
on the disk. If the disk is in use, 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, you are 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, voldg
deport is used, instead, to remove the disk group from use.
4. Remove a disk for replacement
This option prompts for a disk, by disk media name. The disk is
checked for volumes that would lose all mirrors as a result of the
operation. If such volumes exist, they are listed and you are 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 under
LSM control but not assigned to a disk group, you are prompted for
whether one of these disks should be used as a replacement.
5. Replace a failed or removed disk
This option 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, unused disks are scanned for matching disk IDs. If a disk with
a matching disk ID is found, you are prompted for whether that disk
should be reattached.
If a matching disk is not used, you are prompted for a new disk, by
device name. If the named replacement disk has a valid disk header,
but is not allocated to a disk group, you are 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, you are prompted to
ensure that the operation should proceed.
If the device is to be initialized, a new disk label 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.
6. Mirror volumes on a disk
This option prompts for a disk, by disk media name. It then prompts
for a destination disk within the same disk group, also by disk media
name. Make sure that the destination disk has enough space for the
mirror. Specifying no destination disks indicates that any disk is
suitable. The operation proceeds by calling volmirror to mirror the
volumes. You cannot use this option if the volume is already mirrored,
or if the volume consists of more than one subdisk.
Mirroring volumes from the boot disk will produce a disk that can be
used as an alternate boot disk. This is done by calling the volrootmir
command.
7. Move volumes from a disk
This option prompts for a disk, by disk media name. It then prompts
for a possible list of destination disks, also by disk media name.
Specifying no destination disks indicates that any disk is suitable.
If the specified disk is large enough, or if there is enough available
space if you did not specify a disk, the operation proceeds by calling
volevac to move subdisks off the disk.
If the original disk remains under LSM control, future move or mirror
operations could put the volume back onto that disk. If the disk is
suspect, remove it (option 4) or place it offline (option 11).
8. Enable access to (import) a disk group
This option prompts for a disk, by device address. The operation
proceeds by calling voldg import to import the disk group stored on
that disk.
Use this option to import a disk group that you deported from another
system. If two hosts share a SCSI bus, make sure the other host failed
or deported the disk group before you import it. If two hosts import a
disk group at the same time, the disk group will become corrupted and
unusable.
9. Remove access to (deport) a disk group
This 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.
Use this option to deport a disk group that you plan to move to a
different system, or to effectively remove the last disk from a disk
group. You cannot deport the rootdg disk group.
10. Enable (online) a disk device
This option prompts for a disk device. The prompt display allows for a
display of disks on the system. The operation only functions for disks
currently in an offline state. It then proceeds to make the disk
accessible.
11. Disable (offline) a disk device
This option prompts for a disk device. The prompt display allows for a
display of disks on the system. The operation only functions for disks
currently in an online state but not part of any disk group. It then
proceeds to mark the disk as offline such that the Logical Storage
Manager makes no further attempt at accessing the disk.
12. Mark a disk as a spare for a disk group
This option sets up a disk to be used as a spare device for its disk
group. A spare disk can be used to automatically replace a disk that
has failed. LSM cannot use space on a disk that is marked as a spare.
13. Turn off the spare flag for a disk
This option removes a disk from those that can be used as a spare and
returns its space to the general pool of available space.
14. Recover plexes and volumes after disk replacement
This operation performs plex attachment, RAID-5 subdisk recovery, and
resynchronize operations for the named volumes, or for volumes
residing on the named disks (media name). If no media name or volume
operands are specified, the operation applies to all volumes (or to
all volumes in the specified disk group).
The voldiskadm menu also includes the following word and character menu
choices:
list (or l) List disk information
Displays a list of candidate disks for voldiskadm operations. From
this list, you can display detail information about a specific disk
by entering the disk name at the prompt.
? Display help about menu
Displays detailed information about each of the 14 menu operations,
and a glossary of LSM terminology.
?? Display help about the menuing system
Displays a list of inputs you can supply at any time: q to quit the
operation, x to exit from the voldiskadm menu interface, ? to
display help for the current operation, or ?? to display general
help for the Logical Storage Manager administration menus.
q Exit from menus
Exits from the voldiskadm menu interface.
ERRORS
See the voldiskadd(8) reference page for a description of errors related to
the initialization operation.
FILES
/etc/vol/disks.exclude
A list of disks to exclude from voldiskadm use.
SEE ALSO
disklabel(8), volintro(8), voldg(8), voldisk(8), voldiskadd(8),
voldisksetup(8), volrootmir(8)
|
Index for
Section 8 |
|
|
Alphabetical
listing for V |
|
 |
Top of
page |
|