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