<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Transitional//EN">
<HTML>
<HEAD>
  <!--
    *************************************************************************************
    * Copyright (c) 2005 VERITAS Software Corporation. All rights reserved. *

      For third-party license citations, please see the bottom of this file.
    *************************************************************************************
  -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="TEMPLATEBASE" content="DocCD Manual Pages 1.4">
<meta name="LASTUPDATED" content="06/13/05 11:53:55">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="vxdiskadd.fm">
     
<title>vxdiskadd</title>

</HEAD>

<BODY bgcolor="#FFFFFF" link="#000066" vlink="#0000ff" marginheight="0" topmargin="0">
<basefont=1>

<a name="427929"></a>

<div align="left">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
 <tr>
   <td height="2" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#000000">
   </td>
 </tr>
 <tr>
   <td height="15" width="50%" border="0" cellspacing="0" cellpadding="0" bgcolor="#cccccc">
    <img src="images/vxsymbol.gif" height="20" width="31" border="0" cellspacing="0" cellpadding="0" align="left">
     
     
   </td>
   <td align="right" width="50%" bgcolor="#cccccc">

<!-- Header Breadcrumbs -->
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vxdisk_vxvm_manpages34_439794.html" title="Previous - vxdisk">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxdiskadm_vxvm_manpages36_430557.html" title="Next - vxdiskadm">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
   </td>
 </tr>

 <tr>
  <td bgcolor="#CCCCCC" colspan="2" height="15" align="right">
  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Product:  
<a href="vxvm_manpages_splashpage_docCD_vxvm_manpages1_103036.vxhd" title="Volume Manager Manual Pages for Storage Foundation title page ">Volume Manager Manual Pages for Storage Foundation</a>
  &nbsp;&nbsp;
  </font>
  </td>
 </tr>
 <tr>
  <td bgcolor="#CCCCCC" colspan="2" height="15" align="right">
  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Manual:  
<a href="man1m_titlepage_docCD_vxvm_manpages2_73700.vxhd" title="Maintenance Commands (1m) title page ">Maintenance Commands (1m)</a>
  &nbsp;&nbsp;
  </font>
  </td>
 </tr>


</table>
</div>

<div align="left">
 <table border="0" width="100%" bgcolor="#FFFFFF">
  <tr>
   <td width="100%" valign="top" bgcolor="#FFFFFF">

<!-- Start Main Topic Content -->
        <a name="startcontent"></a>
	
<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="426960"></a>vxdiskadd</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="426990"></a> NAME</font>
</h3>
<p>
<a name="426995"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxdiskadd - add one or more disks for use with VERITAS Volume Manager </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="426998"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="427003"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadd</b></font> <em>disk_address_pattern_list </em>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="427006"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427011"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadd</b></font> utility configures disks for use by VERITAS Volume Manager (VxVM). Disks must already have been formatted. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadd</b></font> 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. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadd</b></font> 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. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427143"></a>One or more disks may be specified with a <em>disk_address_pattern_list</em>. The basic form of a disk address is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>d</b></font><em>#</em>. Any leading portion of this address may be specified to indicate that all disks that match that leading portion should be used. For example <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c2t0</b></font> 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 <em>enclosurename_diskno</em>. The <em>enclosurename</em> indicates that all disks in the specified enclosure are used. For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>emc1_</b></font> is used to specify all disks in the enclosure <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>emc1</b></font>. The word <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>all</b></font> may be used to specify all disks on the system.  Disk address names relate directly to device node names in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/dmp</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/rdmp</b></font> directories.  Here are more examples: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="427287"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">all:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;all&nbsp;disks</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="427292"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">c3&nbsp;c4t2:&nbsp;&nbsp;all&nbsp;disks&nbsp;on&nbsp;controller&nbsp;3&nbsp;and&nbsp;controller&nbsp;4,&nbsp;target&nbsp;2</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="427300"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">c3t4d2:&nbsp;&nbsp;&nbsp;a&nbsp;single&nbsp;disk&nbsp;(in&nbsp;the&nbsp;c#t#d#&nbsp;naming&nbsp;scheme)</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="427308"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">xyz_0&nbsp;:&nbsp;&nbsp;&nbsp;a&nbsp;single&nbsp;disk&nbsp;(in&nbsp;the&nbsp;enclosure&nbsp;based&nbsp;naming&nbsp;scheme)</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="427316"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">xyz_&nbsp;:&nbsp;&nbsp;&nbsp;&nbsp;all&nbsp;disks&nbsp;on&nbsp;the&nbsp;enclosure&nbsp;whose&nbsp;name&nbsp;is&nbsp;xyz</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427332"></a>The files <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/cntrls.exclude</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/disks.exclude</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/enclr.exclude</b></font> may be used to exclude controllers or disks from use by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadd</b></font>.  Each line of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cntrls.exclude </b></font>specifies the address of a controller to exclude, for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c2</b></font>. Each line of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disks.exclude</b></font> specifies a disk to exclude, for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c0t3d0</b></font>. Each line of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enclr.exclude</b></font> specifies the name of an enclosure to exclude, for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enc0</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427410"></a>All courses of action that do not involve clear failure conditions require prompts from the user, with defaults supplied as appropriate.  Help is made available at every prompt.  Entering <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>?</b></font> in response to a prompt displays a context-sensitive help message. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="427452"></a> OPERATIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427458"></a><em>Reconnecting a drive that was temporarily inaccessible</em></font>
</p>
<p>
<a name="428167"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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 <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font>utility. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427573"></a><em>Initialization of a disk with reserved regions</em></font>
</p>
<p>
<a name="428190"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Initialization of the disk is performed by calling <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisksetup</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427604"></a><em>Adding a disk to an existing disk group</em></font>
</p>
<p>
<a name="428213"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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 <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>utility can subsequently allocate from that free space. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427683"></a><em>Creation of new disk groups in which to import a new disk</em></font>
</p>
<p>
<a name="428232"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">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. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="427725"></a> HARDWARE-SPECIFIC NOTE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427730"></a>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. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="427796"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427802"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/cntrls.exclude</b></font></font>
</p>
<p>
<a name="428255"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the address of controllers to exclude from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadd</b></font> operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427833"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/disks.exclude</b></font></font>
</p>
<p>
<a name="428278"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the address of disks to exclude from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadd</b></font> operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427864"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/enclr.exclude</b></font></font>
</p>
<p>
<a name="428301"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the address of enclosures to exclude from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadd </b></font>operations. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="427894"></a> NOTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427899"></a>EFI disks cannot be added to a disk group that is compatible with the Cross-platform Data Sharing (CDS) feature, nor can they be formatted as CDS disks. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="427929"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="427934"></a><a href="vxassist_vxvm_manpages14_458378.html#441128"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font></font></a>(1M), <a href="vxdisk_vxvm_manpages34_439794.html#433127"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk </b></font></font></a>(1M), <a href="vxdiskadm_vxvm_manpages36_430557.html#428346"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm </b></font></font></a>(1M), <a href="vxdisksetup_vxvm_manpages37_430296.html#428388"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisksetup </b></font></font></a>(1M), <a href="vxintro_vxvm_manpages47_452164.html#439378"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro </b></font></font></a>(1M), <a href="vxrecover_vxvm_manpages61_429816.html#428010"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font></font></a>(1M) </font>
</blockquote>

<!-- End Main Topic Content -->

   </td>
  </tr>
 </table>
</div>

<div>
<table border="0" cellspacing="0" cellpadding="0" width="100%">
 <tr>
  <td height="18" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#FFFFFF">
  </td>
 </tr>
  <td align="left"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&nbsp;&#94;&nbsp;<a href="vxdiskadd_vxvm_manpages35_427929.html" title="vxdiskadd">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vxdisk_vxvm_manpages34_439794.html" title="Previous - vxdisk">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxdiskadm_vxvm_manpages36_430557.html" title="Next - vxdiskadm">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
  </td>
 <tr>
   <td height="9" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#FFFFFF">
   </td>
 </tr>

<!-- Footer Breadcrumbs -->
<tr>
<td bgcolor="#FFFFFF" colspan="2" height="15" align="right">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Product:  
<a href="vxvm_manpages_splashpage_docCD_vxvm_manpages1_103036.vxhd" title="Volume Manager Manual Pages for Storage Foundation title page ">Volume Manager Manual Pages for Storage Foundation</a>&nbsp;&nbsp;</font></td>
</tr>

<tr>
<td bgcolor="#FFFFFF" colspan="2" height="15" align="right">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Manual:  
<a href="man1m_titlepage_docCD_vxvm_manpages2_73700.vxhd" title="Maintenance Commands (1m) title page ">Maintenance Commands (1m)</a>&nbsp;&nbsp;</font></td>
</tr>


 <tr>
  <td colspan="2" align="left"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" color="#000000" align="right" size="-2">
<em>VERITAS Software Corporation
</em></font><br>

<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">www.veritas.com</font><br>
  </td>
 </tr>
</table>
</div>

</BODY>
  <!--
    *************************************************************************************
    * Copyright (c) 2005 VERITAS Software Corporation. All rights reserved. *

    VERITAS, VERITAS SOFTWARE, the VERITAS Logo, and VERITAS Software Documentation 
    are trademarks or registered trademarks of VERITAS Software Corporation 
    or its affiliates in the U.S. and other countries. Other names may be 
    trademarks of their respective owners. 

    Apache Jakarta Lucene:
    Apache Software License
    Version 1.1

    Copyright (c) 2000 The Apache Software Foundation. All rights reserved.

    Redistribution and use in source and binary forms, with or without modification, 
    are permitted provided that the following conditions are met:

    1. Redistributions of source code must retain the above copyright notice, this 
    list of conditions and the following disclaimer.

    2. Redistributions in binary form must reproduce the above copyright notice, this 
    list of conditions and the following disclaimer in the documentation and/or other 
    materials provided with the distribution.

    3. The end-user documentation included with the redistribution, if any, must include 
    the following acknowledgment: "This product includes software developed by the Apache 
    Software Foundation (http://www.apache.org/)." Alternately, this acknowledgment may 
    appear in the software itself, if and wherever such third-party acknowledgments 
    normally appear.

    4. The names "Apache" and "Apache Software Foundation" must not be used to endorse or 
    promote products derived from this software without prior written permission. For 
    written permission, please contact apache@apache.org.

    5. Products derived from this software may not be called "Apache", nor may "Apache" 
    appear in their name, without prior written permission of the Apache Software Foundation.

    THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, 
    BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
    PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION 
    OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, 
    OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 
    OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 
    ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
    ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    This software consists of voluntary contributions made by many individuals on behalf 
    of the Apache Software Foundation. For more information on the Apache Software Foundation, 
    please see <http://www.apache.org/>. Portions of this software are based upon public domain 
    software originally written at the National Center for Supercomputing Applications, University 
    of Illinois, Urbana-Champaign.
    
    This product includes WebWindow Software developed by Horst Heistermann.
    *************************************************************************************
  -->
</HTML>
