# man vxdiskadm Reformatting page. Wait... done Maintenance Commands vxdiskadm(1M) 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 ? at a prompt to display a context-sensitive help message. To add or encapsulate 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 or encapsulate all the disks at that SCSI address. For example, use c2t0 to specify all disks on con- troller 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 exam- ple, 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. 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 them. VxVM 3.0 Last change: 11 Dec 1998 1 Maintenance Commands vxdiskadm(1M) Encapsulate one or more disks Prompts for one or more disk addresses. It then calls vxencap to encapsulate partitions on the named disk. 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 replace- ment. 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 VxVM 3.0 Last change: 11 Dec 1998 2 Maintenance Commands vxdiskadm(1M) 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 destina- tion 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 opera- tion calls vxdg import to import the disk group stored on that disk. Disable 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. VxVM 3.0 Last change: 11 Dec 1998 3 Maintenance Commands vxdiskadm(1M) 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. FILES /etc/vx/cntrls.exclude Specifies the address of con- trollers to exclude from vxdiskadm operations. /etc/vx/disks.exclude Specifies the address of disks to exclude from vxdiskadm operations. SEE ALSO vxintro(1M), vxdg(1M), vxdisk(1M), vxdiskadd(1M), vxdisksetup(1M) vxencap(1M) vxevac(1M) vxrootmir(1M) VxVM 3.0 Last change: 11 Dec 1998 4 #