# 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

#  

