Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX 11i Version 1.5 Reference Volume 2, Section 1M: System Administration Commands > v

vxdiskadm(1M)

» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

vxdiskadm — menu driven Volume Manager disk administrator

SYNOPSIS

vxdiskadm

DESCRIPTION

vxdiskadm provides a menu-driven interface to perform common VxVM disk administration tasks.

The vxdiskadm script is interactive and prompts you for responses, supplying defaults where appropriate. There is a Help facility at every prompt. Enter a question mark ? at a prompt to display a context-sensitive help message.

To add disks, specify one or more disks with a disk-address-pattern-list. The basic format for disk addresses is c#t#d#. You can specify just the controller and target to add all the disks at that SCSI address. For example, use c2t0 to specify all disks on controller two, target zero. You can specify more than one disk address or address pattern on the command line. The word all specifies all disks on the system. Disk address names relate directly to device node names in the /dev/dsk and /dev/rdsk directories.

You can use the files /etc/vx/cntrls.exclude and /etc/vx/disks.exclude to exclude disks or controllers from use by vxdiskadm. Each line of cntrls.exclude specifies the address of a controller to exclude, for example, c2. Each line of disks.exclude specifies a disk to exclude, for example, c0t3d0.

OPERATIONS

Add or initialize one or more disks

Prompts for one or more disk device addresses. Prompts for a disk group (which defaults to rootdg). You are also given the alternative of initializing the disk but leaving it unallocated to a disk group. If a disk group is specified, you must name the disk. A default disk name in the form disk## is chosen for the root disk group. If you add a disk to a disk group other than rootdg, the name is in the form diskgroup##, such that the name are unique within all imported disk groups. If a disk group is specified for the disks, you are prompted to specify whether to designate the disks as spares for the disk group.

Remove a disk

Prompts for a disk, by disk media name. 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 group, you are also prompted whether to remove the disk group from the system.

The operation then calls vxdg rmdisk to remove the disk from its disk group. If this is the last disk in its disk group, vxdg deport is used instead.

Remove a disk for replacement

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, those volumes are listed and you are prompted whether to continue the operation.

The operation calls vxdg -k rmdisk to dissociate the media record from the physical disk. If there are formatted disks available that have disk headers but no disk group, you are prompted whether to use one of these disks as a replacement.

Replace a failed or removed disk

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 whether to reattach that disk.

If a matching disk is not used, you are 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, you are prompted whether to reinitialize the disk. If the named replacement disk is listed as allocated to a disk group or to another host, you are prompted whether to continue the operation.

If the device is initialized, vxdisksetup is called to set up public and private regions and to create the disk header.

Given an initialized disk, the operation replaces the disk in a disk group with vxdg -k adddisk.

Mirror volumes on a disk

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 can be the destination. The operation calls vxmirror to mirror the volumes.

Move volumes from a disk

Prompts for a disk, by 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. The operation calls vxevac to move subdisks off the disk.

Enable access to (import) a disk group

Prompts for a disk, by device address. The operation calls vxdg import to import the disk group stored on that disk.

Remove access to (deport) a disk group

Prompts for a disk group name. The prompt lists alternate disk groups and the disks (media name and access name) that they contain. The operation calls vxdg deport.

Enable (online) a disk device

Prompts for a disk device. The prompt lets you display the disks on the system. The operation functions only for disks currently offline. It then makes the disk accessible.

Disable (offline) a disk device

Prompts for a disk device. The prompt lets you display the disks on the system. The operation functions only for disks currently online, but not part of any disk group. It then marks the disk as offline such that Volume Manager no longer tries to access the disk.

Mark a disk as a spare for a disk group

Sets up a disk as a spare device for its disk group. A 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 spare.

Turn off the spare flag for a disk

Removes a disk from spares list and returns its space to the general pool of available space.

Remove (deport) and destroy a disk group

Removes access to and destroys a disk group that is currently enabled (imported). A disk group may be destroyed if the disks are needed for some other purpose.

Unrelocate subdisks back to a disk

Moves subdisks which were hot-relocated following a disk failure back to the original disk, or to a disk with a different name, possibly with a different offset.

Exclude a disk from hot-relocation use

Sets up a disk to be excluded from use by hot-relocation. The disk is marked as nohotuse and it cannot be used by hot-relocation to replace a disk that has failed. However, it remains available to be used as free space for its disk group.

Make a disk available for hot-relocation use

Turns off the nohotuse flag on a disk. Use this option to make a disk available for hot-relocation use. This only applies to disks that were previously excluded from hot-relocation use.

FILES

/etc/vx/cntrls.exclude

Specifies the address of controllers to exclude from vxdiskadm operations.

/etc/vx/disks.exclude

Specifies the address of disks to exclude from vxdiskadm operations.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2001 Hewlett-Packard Development Company, L.P.