# @(#)src/sol/cmd/vxvm/voladm/disk.init.help	1.6 03/14/01 13:30:57 - Copyright (c) 1999 VERITAS Software Corp.
#ident "@(#)unixvm:src/sol/cmd/vxvm/voladm/disk.init.help 1.6"

# Copyright (c) 2001 VERITAS Software Corporation.  ALL RIGHTS RESERVED.
# UNPUBLISHED -- RIGHTS RESERVED UNDER THE COPYRIGHT
# LAWS OF THE UNITED STATES.  USE OF A COPYRIGHT NOTICE
# IS PRECAUTIONARY ONLY AND DOES NOT IMPLY PUBLICATION
# OR DISCLOSURE.
# 
# THIS SOFTWARE CONTAINS CONFIDENTIAL INFORMATION AND
# TRADE SECRETS OF VERITAS SOFTWARE.  USE, DISCLOSURE,
# OR REPRODUCTION IS PROHIBITED WITHOUT THE PRIOR
# EXPRESS WRITTEN PERMISSION OF VERITAS SOFTWARE.
# 
#               RESTRICTED RIGHTS LEGEND
# USE, DUPLICATION, OR DISCLOSURE BY THE GOVERNMENT IS
# SUBJECT TO RESTRICTIONS AS SET FORTH IN SUBPARAGRAPH
# (C) (1) (ii) OF THE RIGHTS IN TECHNICAL DATA AND
# COMPUTER SOFTWARE CLAUSE AT DFARS 252.227-7013.
#               VERITAS SOFTWARE
# 1600 PLYMOUTH STREET, MOUNTAIN VIEW, CA 94043

  This operation can be used to do the following:

  1.  Initialize one or more disks for use with the Volume Manager.

  2.  Add one or more disks to an existing disk group.

  3.  Create a new disk group containing one ore more specified disks.

  4.  Encapsulate one or more disks and add them to a disk group. 
      Encapsulation is the process of converting a disk such that existing
      partitions on a disk are replaced by volumes.

  5.  Reattach disks to a disk group, for disks that were temporarily
      inaccessible (such as due to a temporary cabling failure).

  This operation takes as input a disk device address or disk address
  pattern.  For example, the device name c0t2d0 specifies the disk at
  SCSI target ID 2 on the first controller attached to the system. 
  The operation examines the disk at this address to see what operations
  may be appropriate, asking questions based on what it finds. One or
  more disk address patterns may be specified to select a group of disks.
  For example, "c0 c1t0" selects all disks on controller 0 and all disks
  on controller 1, target 0.

  To determine whether a reattach is appropriate, the operation checks
  the set of failed disks to see if any of them appear to match a
  selected device. If there is a match, you are asked whether a reattach
  operation is appropriate. The reattach operation may fail, due to
  corruption of the disk. If so, you may want to start the operation
  over and avoid trying a reattach.

  If a disk is already initialized for use with the Volume Manager,
  you will be given the choice of reinitializing the disk.  You may
  need to reinitialize the disk if it has been corrupted in some way.
  Normally, it doesn't hurt to reinitialize the disk; however it can
  take several minutes to a half hour to reinitialize a disk.

  If a disk is already initialized, but not for use with the Volume
  Manager, you can choose to encapsulate the disk and to add it to a
  disk group.

  If you do not choose to reattach a disk, you will be asked for a
  disk group name to add the disk to.  The default is "rootdg", which
  is the base system disk group. If you want to create a new disk group,
  specify the name of a disk group that does not yet exist.

  The selected disks may be left as replacement disks by specifying
  a disk group name of "none".  If you choose "none" then the disk will
  be available for a disk replacement operation without the need for
  repartitioning. There is a Disk replacement option in the vxdiskadm
  main menu.

  Each disk name can be specified interactively or be given a default value
  by the Volume Manager.

  The selected disks may be added to a disk group as spares for the disk
  group. This will cause these disks to be used to automatically relocate
  subdisks that fail in the disk group. 

  The selected disks may be added to a disk group as nohotuses for the disk
  group. This will exclude these disks from being used to relocate
  subdisks that fail in the disk group.

  Using a Hardware-specific option to a add disk in a disk group:
  Some environments provide guidelines to optimize the  Volume Manager's
  interaction  with intelligent storage systems. If these guidelines are
  present, the Volume Manager follows the guidelines  while  creating  disk
  groups and adding disks to disk groups. By default, vxdiskadm only
  allows  disk groups  to contain  disks that conform with these guidelines.
  The use of force option ignores  any such storage-specific guidelines. 
  Overriding the guidelines is not  recommended  as  it  can  result  in 
  incompatible objects,  or objects that cannot be administered by some 
  utilities.

