*** UNIX MANUAL PAGE BROWSER ***

voldiskadm(8) System Manager's Manual 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 opera- tions. 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 al- ternative require prompts to be answered by the user, with defaults supplied as appropriate. Help is made available at every prompt. En- tering ? in response to a prompt displays a context-sensitive help mes- sage. 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 per- forms 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, appro- priate warning and error messages are printed. Refer to vold- iskadd(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 en- capsulate 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 volmir- ror 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 op- eration 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 dis- play lists alternate disk groups and the disks (media name and access name) that they contain. The operation proceeds by call- ing 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 re- lated to the initialization operation. RELATED INFORMATION disklabel(8), volintro(8), voldg(8), voldisk(8), voldiskadd(8), vold- isksetup(8). delim off voldiskadm(8)