vxdiskadm menu

Volume Manager Support Operations
Menu: VolumeManager/Disk
1 Add or initialize one or more disks
2 Remove a disk
3 Remove a disk for replacement
4 Replace a failed or removed disk
5 Mirror volumes on a disk
6 Move volumes from a disk
7 Enable access to (import) a disk group
8 Remove access to (deport) a disk group
9 Enable (online) a disk device
10 Disable (offline) a disk device
11 Mark a disk as a spare for a disk group
12 Turn off the spare flag on a disk
13 Remove (deport) and destroy a disk group
14 Unrelocate subdisks back to a disk
15 Exclude a disk from hot-relocation use
16 Make a disk available for hot-relocation use

list List disk information

? Display help about menu
?? Display help about the menuing system
q Exit from menus

Select an operation to perform

The vxdiskadm 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 vxdiskadm 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 vxdiskadm script presents the following list of operations:

Add or initialize a disk

This menu option prompts for a disk, by device address. It then checks the disk to ensure that there is no information on the disk. If there is, the operation prompts the user to ensure that the operation should proceed. 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 calling vxdisksetup to partition the disk and to install a disk header. If a disk group was specified, the last step is to add the disk to the indicated disk group.

Encapsulate a disk

This operation prompts for a disk, by device address. It then calls vxencap to encapsulate partitions on the named disk.

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 vxdg rmdisk to remove the disk from its disk group. If this is the last disk in its disk group, then vxdg 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 vxdg -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, vxdisksetup is called to partition it and to create the disk header.

Given an initialized disk, the operation proceeds by replacing the disk in a disk group with vxdg -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 vxmirror to mirror the volumes.

Mirroring volumes from the boot disk will produce a disk that can be used as an alternate boot disk. This will be done by calling the vxrootmir command.

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 vxevac to move subdisks off the disk.

Enable access to (import) a disk group

This menu option prompts for a disk, by device address. The operation proceeds by calling vxdg import to import the disk group stored on that disk.

Disable access to (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 vxdg deport .

Enable (online) a disk device

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 device

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 Volume Manager will make no further attempt at accessing the disk.

Mark a disk as a hot spare

This option sets up a disk to be used as a hot spare device for it’s disk group. A hot spare disk can be used to automatically replace a disk that has failed. No space can be used on a disk that is marked as a hot spare.

Turn off the hot spare flag for a disk

This option removes a disk from those that can be used as a hot spare and returns its space to the general pool of available space.

Add or initialize all disks on a controller

This option allows the user to add or initialize all disks on a controller. This option is provided to avoid having to answer redundant questions about the disposition of disks when many disks are being added to the system. The vxdiskadm 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 vxdiskadm 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 vxdiskadm script presents the following list of operations:

Add or initialize a disk

This menu option prompts for a disk, by device address. It then checks the disk to ensure that there is no information on the disk. If there is, the operation prompts the user to ensure that the operation should proceed. 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 calling vxdisksetup to partition the disk and to install a disk header. If a disk group was specified, the last step is to add the disk to the indicated disk group.

Encapsulate a disk

This operation prompts for a disk, by device address. It then calls vxencap to encapsulate partitions on the named disk.

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 vxdg rmdisk to remove the disk from its disk group. If this is the last disk in its disk group, then vxdg 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 vxdg -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, vxdisksetup is called to partition it and to create the disk header.

Given an initialized disk, the operation proceeds by replacing the disk in a disk group with vxdg -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 vxmirror to mirror the volumes.

Mirroring volumes from the boot disk will produce a disk that can be used as an alternate boot disk. This will be done by calling the vxrootmir command.

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 vxevac to move subdisks off the disk.

Enable access to (import) a disk group

This menu option prompts for a disk, by device address. The operation proceeds by calling vxdg import to import the disk group stored on that disk.

Disable access to (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 vxdg deport .

Enable (online) a disk device

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 device

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 Volume Manager will make no further attempt at accessing the disk.

Mark a disk as a hot spare

This option sets up a disk to be used as a hot spare device for it’s disk group. A hot spare disk can be used to automatically replace a disk that has failed. No space can be used on a disk that is marked as a hot spare.

Turn off the hot spare flag for a disk

This option removes a disk from those that can be used as a hot spare and returns its space to the general pool of available space.

Add or initialize all disks on a controller

This option allows the user to add or initialize all disks on a controller. This option is provided to avoid having to answer redundant questions about the disposition of disks when many disks are being added to the system.

SEE ALSO

vxintro(1M), vxdg(1M), vxdisk(1M), vxdisk(1M), vxdisksetup(1M), vxrootmir(1M).

Leave a Reply

Your email address will not be published. Required fields are marked *