unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 vxdiskadd(1M)			  VxVM 3.5		       vxdiskadd(1M)
				 1 Jun 2002



 NAME
      vxdiskadd - add one or more disks for use with VERITAS Volume Manager

 SYNOPSIS
      vxdiskadd disk_address_pattern_list

 DESCRIPTION
      The vxdiskadd utility configures disks for use by VERITAS Volume
      Manager (VxVM).  Disks must already have been formatted.	vxdiskadd
      prompts the user for a disk group name and disk name for the disks. If
      no disk group name specified, the disks will be left as unassigned
      replacement disks for future use. A new disk group may be created that
      will become the disks' disk group.  If a disk group is specified for
      the disks, the user is prompted for whether the disks should be
      designated as spares for the disk group.	For new disks, all space on
      the disk becomes free space in the disk's disk group. vxdiskadd
      interactively allows initialization to be done for all the disks
      specified or allows the user to ask to make the decision for each disk
      individually.

      One or more disks may be specified with a disk_address_pattern_list.
      The basic form of a disk address is c#t#d#. Any leading portion of
      this address may be specified to indicate that all disks that match
      that leading portion should be used. For example c2t0 may be used to
      specify all disks on controller 2, target 0. More than one disk
      address or address pattern may be specified on the command line.	In
      case of enclosure-based names, the disk address will be of the form
      enclosurename_diskno. The enclosurename indicates that all disks in
      the specified enclosure are used. For example, emc1_ is used to
      specify all disks in the enclosure emc1. The word all may be used to
      specify all disks on the system.	Disk address names relate directly
      to device node names in the /dev/dmp and /dev/rdmp directories.  Here
      are more examples:

	   all:	     all disks
	   c3 c4t2:  all disks on controller 3 and controller 4, target 2
	   c3t4d2:   a single disk (in the c#t#d# naming scheme)
	   xyz_0 :   a single disk (in the enclosure based naming scheme)
	   xyz_ :    all disks on the enclosure whose name is xyz


      The files /etc/vx/cntrls.exclude, /etc/vx/disks.exclude and
      /etc/vx/enclr.exclude may be used to exclude controllers or disks from
      use by vxdiskadd.	 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. Each
      line of enclr.exclude specifies the name of an enclosure to exclude,
      for example, enc0.

      All courses of action that do not involve clear failure conditions
      require prompts from the user, with defaults supplied as appropriate.



				    - 1 -	  Formatted:  August 2, 2006






 vxdiskadd(1M)			  VxVM 3.5		       vxdiskadd(1M)
				 1 Jun 2002



      Help is made available at every prompt.  Entering ? in response to a
      prompt displays a context-sensitive help message.

 OPERATIONS
      Reconnecting a drive that was temporarily inaccessible
	   This situation is detected automatically by noting that the
	   specified drive has a disk ID that matches a disk media record
	   with no currently associated physical disk.	After reconnection,
	   any stale plexes referring the disk are reattached, and any
	   stopped volumes referring the disk are restarted.  This reattach
	   action is performed by calling the vxrecover utility.

      Initialization of a disk with reserved regions
	   Initialization of the disk is performed by calling vxdisksetup.

      Adding a disk to an existing disk group
	   This operation can be performed independently of the
	   initialization of the disk drive. The operation adds the disk to
	   the group so that its storage is added to the free space pool in
	   that disk group.  The vxassist utility can subsequently allocate
	   from that free space.

      Creation of new disk groups in which to import a new disk
	   If disks are added that are required to be put into a disk group
	   that does not exist, the option of creating the disk group is
	   offered.

 Hardware-Specific Note
      Some environments provide guidelines to optimize VxVM's interaction
      with intelligent storage systems. If these guidelines are present,
      VxVM follows the guidelines when adding disks to disk groups. 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
      /etc/vx/cntrls.exclude	    Specifies the address of controllers to
				    exclude from vxdiskadd operations.

      /etc/vx/disks.exclude	    Specifies the address of disks to
				    exclude from vxdiskadd operations.

      /etc/vx/enclr.exclude	    Specifies the address of enclosures to
				    exclude from vxdiskadd operations.

 SEE ALSO
      vxassist(1M), vxdisk(1M), vxdiskadm(1M), vxdisksetup(1M), vxintro(1M),
      vxrecover(1M)






				    - 2 -	  Formatted:  August 2, 2006