vxdiskadm(1M) VxVM 3.5 vxdiskadm(1M)
1 Jun 2002
NAME [Toc] [Back]
vxdiskadm - menu-driven VERITAS Volume Manager disk administrator
SYNOPSIS [Toc] [Back]
vxdiskadm
DESCRIPTION [Toc] [Back]
vxdiskadm provides a menu-driven interface to perform common VERITAS
Volume Manager (VxVM) disk administration tasks.
The vxdiskadm script is interactive and prompts you for responses,
supplying defaults where appropriate. Help is available at every
prompt by entering a question mark (?) 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# or enclosurebased
names such as enc1_0. 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/disks.exclude, /etc/vx/cntrls.exclude
and /etc/vx/enclr.exclude to exclude disks, controllers and enclosures
from use by vxdiskadm. Each line of disks.exclude specifies a disk to
exclude, for example, c0t3d0. Each line of cntrls.exclude specifies
the address of a controller to exclude, for example, c2. Each line of
enclr.exclude specifies an enclosure to be excluded, for example,
enc1.
OPERATIONS [Toc] [Back]
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 names 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 [Toc] [Back]
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
- 1 - Formatted: January 24, 2005
vxdiskadm(1M) VxVM 3.5 vxdiskadm(1M)
1 Jun 2002
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 [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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 can be the destination. The operation calls vxmirror
to mirror the volumes.
Move volumes from a disk [Toc] [Back]
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
- 2 - Formatted: January 24, 2005
vxdiskadm(1M) VxVM 3.5 vxdiskadm(1M)
1 Jun 2002
suitable. The operation calls vxevac to move subdisks off
the disk.
Enable access to (import) a disk group [Toc] [Back]
Prompts for a disk group name. The operation calls vxdg
import to import the disk group stored on that disk.
Remove access to (deport) a disk group [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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 VxVM no longer tries to
access the disk.
Mark a disk as a spare for a disk group [Toc] [Back]
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 [Toc] [Back]
Removes a disk from the list of spare disks, and returns its
space to the general pool of available space.
Remove (deport) and destroy a disk group [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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.
- 3 - Formatted: January 24, 2005
vxdiskadm(1M) VxVM 3.5 vxdiskadm(1M)
1 Jun 2002
Make a disk available for hot-relocation use [Toc] [Back]
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 hotrelocation
use.
Prevent multipathing/Suppress devices from VxVM's view
Excludes devices from VxVM's view, or prevents them from
being multipathed by the dynamic multipathing (DMP) driver,
vxdmp.
There are three ways of specifying the devices on which
these operations are to be performed:
+ As a controller for all devices connected through the
controller.
+ As a physical pathname for all devices under that path.
+ As a combination of the Vendor ID and Product ID
(VID:PID) for all devices of that type.
This option also provides a method to define pathgroups in
case of disks which are not multipathed by VxVM. Only one
path from a pathgroup will be made visible to VxVM. This is
useful to avoid duplicate entries for devices that are not
multipathed by vxdmp.
Allow multipathing/Unsuppress devices from VxVM's view
Makes devices visible to VxVM again or makes vxdmp multipath
these devices again. This can be performed only on devices
that have already been specified using the "Prevent
multipathing/Suppress devices from VxVM's view" option.
List currently suppressed/non-multipathed devices
Lists all devices suppressed from VxVM's view and all
devices prevented from being multipathed by vxdmp.
Change the disk naming scheme [Toc] [Back]
Changes the disk naming scheme from the c#t#d# format to
enclosure-based. Alternatively, if the existing naming
scheme is enclosure-based, it is changed to c#t#d# format.
List disk information [Toc] [Back]
Displays a list of disks. You can also choose to list
detailed information about the disk at a specific disk
device address.
Hardware-Specific Note [Toc] [Back]
Some environments provide guidelines to optimize VxVM's interaction
with intelligent storage systems. If these guidelines are present,
- 4 - Formatted: January 24, 2005
vxdiskadm(1M) VxVM 3.5 vxdiskadm(1M)
1 Jun 2002
VxVM follows the guidelines when adding disks to disk groups and when
mirroring the volumes on a disk. If the operation fails due to these
guideline(s), you are prompted to use the force option. The force
option ignores any such storage-specific guidelines.
FILES [Toc] [Back]
/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.
/etc/vx/enclr.exclude Specifies the names of enclosures to
exclude from vxdiskadm operations.
SEE ALSO [Toc] [Back]
vxdg(1M), vxdisk(1M), vxdiskadd(1M), vxdisksetup(1M), vxevac(1M),
vxintro(1M)
- 5 - Formatted: January 24, 2005 [ Back ] |
