<!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:54">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="vxdg.fm">
     
<title>vxdg</title>

</HEAD>

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

<a name="443062"></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="vxdestroy_lvmroot_vxvm_manpages32_427120.html" title="Previous - vxdestroy_lvmroot">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxdisk_vxvm_manpages34_439794.html" title="Next - vxdisk">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="434590"></a>vxdg</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434613"></a> NAME</font>
</h3>
<p>
<a name="434618"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxdg - manage VERITAS Volume Manager disk groups </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434621"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434626"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -g </b></font><em>diskgroup </em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -kp </b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o verify</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>adddisk <br></b></font>[<em> medianame=</em>]<em>accessname</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434641"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg bootdg </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434644"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg defaultdg </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434647"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -n </b></font><em>newname </em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -h </b></font><em>newhostid </em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>deport</b></font> <em>diskgroup</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434660"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o verify</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>destroy </b></font><em>diskgroup</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434672"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg flush</b></font> [<em>diskgroup</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434675"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -g </b></font><em>diskgroup </em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -qa </b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>free</b></font> [<em> medianame</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434688"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -Cfst </b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -n</b></font> <em>newname</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o clearreserve</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o groupreserve=</b></font><em>fencekey</em>] <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o selectcp=</b></font><em>diskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o noreonline</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>import</b></font> <em>diskgroup </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434730"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -T</b></font> <em>version</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o groupreserve=</b></font><em>fence_key</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o verify</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init <br></b></font><em>groupname </em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cds=</b></font>{<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>}] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>minor=</b></font><em>base-minor</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nconfig=</b></font><em>config-copies</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nlog</b></font>=<em>log-copies </em>] <br>[<em>medianame</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>=</b></font>]<em>accessname</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434794"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>verify</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join </b></font><em>sourcedg</em> <em>targetdg </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434806"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -q </b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o listreserve</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>list </b></font>[<em>diskgroup</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434827"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>expand</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>listmove</b></font> <em>sourcedg</em> <em>targetdg</em> <em>object</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434830"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>expand</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>verify</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>move <br></b></font><em>sourcedg</em> <em>targetdg</em> <em>object</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434845"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -g</b></font> <em>diskgroup </em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -q </b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nohotuse </b></font>[<em> medianame</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434857"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>clean</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>remove</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>recover</b></font> <em>diskgroup </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434860"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -g</b></font> <em>diskgroup </em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -f </b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> reminor  <br></b></font>[<em>diskgroup </em>] <em> new-base-minor </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434866"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup </em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-k </b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>repldisk <br></b></font><em>unassoc-medianame=spare-medianame</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434872"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -g </b></font><em>diskgroup </em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -k </b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o verify</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmdisk <br></b></font><em>medianame</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434896"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg -g </b></font><em>diskgroup </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>set </b></font><em>attribute</em>=<em>value</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434899"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -g</b></font> <em>diskgroup </em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -q </b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>spare  </b></font>[<em> medianame</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434911"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -Cft </b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>expand</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -o</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>override</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>verify</b></font>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split <br></b></font><em>sourcedg</em> <em>targetdg</em> <em>object</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434926"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -T </b></font><em>version </em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> upgrade</b></font> <em>diskgroup </em>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434929"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434934"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font> utility performs basic administrative operations on disk groups. Operations include the creation of disk groups, the addition of disks to a disk group, disk group split/join, and disk group imports and deports. </font>
</p>

<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434973"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> A license is necessary to use the Disk Group Split/Join feature. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434976"></a>The behavior of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font> utility depends upon the keyword specified as the first operand. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434988"></a>A <em>diskgroup</em> argument can be either a disk group name or a disk group ID. A <em>groupname</em> argument is a disk group name, not a disk group ID. An <em>accessname</em> argument refers to a system-dependent disk access name (also referred to as a disk device name), as stored in the root configuration by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font> utility. A <em>medianame</em> argument is an administrative name used to define a disk within a disk group. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="435072"></a> ELIMINATION OF THE ROOTDG DISK GROUP</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435077"></a>In releases of VERITAS Volume Manager (VxVM) prior to 4.0, a system installed with VxVM was configured with a default disk group, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rootdg</b></font>, that had to contain at least one disk. By default, operations were directed to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rootdg</b></font> disk group. From release 4.0 onward, VxVM can function without any disk group having been configured. Only when the first disk is placed under VxVM control must a disk group be configured. There is no longer a requirement that you name any disk group <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rootdg</b></font>, and any such named disk group has no special properties. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435161"></a>The following sections describe reserved disk group names and the rules that commands use to determine which disk group to use if this is not specified. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="435182"></a> &QUOT;SYSTEM-WIDE RESERVED DISK GROUPS&QUOT;</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435187"></a>The following disk group names are reserved, and cannot be used to name any disk groups that you create: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435200"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font></font>
</p>
<p>
<a name="444043"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the boot disk group. This is an alias for the disk group that contains the volumes that are used to boot the system. VxVm sets <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font> to the appropriate disk group when the root disk is put under VxVM control. Otherwise, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font> is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodg</b></font>. </font>
</p>
<p>
<a name="425129"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Caution: Do not attempt to change the value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font>. You may render your system unbootable. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435283"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>defaultdg</b></font></font>
</p>
<p>
<a name="444081"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the default disk group. This is an alias for the disk group name that should be assumed if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> option is not specified to a command, or if the VXVM_DEFAULTDG environment variable is undefined. By default, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>defaultdg</b></font> is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodg</b></font> (that is, no disk group). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435332"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodg</b></font></font>
</p>
<p>
<a name="444108"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies to an operation that no disk group has been defined. For example, if the root disk is not under VxVM control, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font> is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodg</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435362"></a>If you have upgraded your system to VxVM 4.0, you may find it convenient to continue to configure a disk group named <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rootdg</b></font> as the default disk group (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>defaultdg</b></font>). </font>
</p>

<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="435383"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> There is no requirement that both <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>defaultdg</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg </b></font>refer to the same disk group, nor that either the default disk group or the boot disk group be named <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rootdg</b></font>. 
</font>
<hr noshade size="2" width="100%" color="#000000">

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="435404"></a> &QUOT;RULES FOR DETERMINING THE DEFAULT DISK GROUP&QUOT;</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435409"></a>It is recommended that you use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> option to specify a disk group to VxVM commands. If you do not specify the disk group, VxVM uses the following rules in order until it determines a disk group name: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435440"></a>1.</font>
</p>
<p>
<a name="444168"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Use the default disk group name that is specified by the environment variable VXVM_DEFAULTDG. This variable can also be set to one of the reserved system-wide disk group names: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>defaultdg</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodg</b></font>. See the section <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>System-Wide Reserved Disk Groups</b></font> above for details. If this variable is undefined, the following rule is applied. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435498"></a>2.</font>
</p>
<p>
<a name="444199"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Use the disk group that has been assigned to the system-wide default disk group alias, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>defaultdg</b></font>. Use the command <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdctl defaultdg</b></font> <em>diskgroup </em>to change the name of the default disk group that is assigned to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>defaultdg</b></font>. If this alias is undefined, the following rule is applied. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435556"></a>3.</font>
</p>
<p>
<a name="444214"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the operation can be performed without requiring a disk group name (for example, an edit operation on disk access records), do so. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435577"></a>If none of these rules succeeds, the requested operation fails. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435580"></a>Caution: In releases of VxVM prior to 4.0, a subset of commands attempted to deduce the disk group by searching for the object name that was being operated upon by a command. This functionality is no longer supported. Scripts that rely on deducing the disk group from an object name may fail. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="435619"></a> KEYWORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435625"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>adddisk</b></font></font>
</p>
<p>
<a name="444245"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Adds the specified disk or disks to a disk group. The disk must not already be part of a disk group. The <em>accessname</em> component to a disk specification argument names a disk access record (essentially a device address specification) used to access the disk. If a <em>medianame</em> component is specified, then it names the disk media record used to define the disk within the disk group. If no <em>medianame</em> component is specified, then the disk media record is given the same name as the disk access record. </font>
</p>
<p>
<a name="425201"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Adding a disk to a disk group causes the disk group's configuration to be copied onto the disk (if the disk has regions for configuration copies). Also, the disk is stamped with the system's host ID, as defined in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volboot</b></font> file. </font>
</p>
<p>
<a name="425207"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-k</b></font> flag is specified, then the disk media name must represent a disk media record that was previously dissociated from its disk access record with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-k rmdisk</b></font>; otherwise, a new disk media record is created to represent the disk. With the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-k </b></font>option, plexes requiring recovery are flagged as stale. </font>
</p>
<p>
<a name="425214"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifying the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-p</b></font> flag with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-k</b></font> packs contiguous subdisks into one subdisk and aligns them consecutively on their respective disks. </font>
</p>
<p>
<a name="425218"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">In a cluster environment, adding a disk to a cluster-shared disk group fails if the disk is not physically accessible from all joined nodes in the cluster. If the addition is successful, the disk is stamped with the cluster ID and marked with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shared</b></font> flag. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425224"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> EFI disks cannot be added to CDS-compatible disk groups. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435935"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font></font>
</p>
<p>
<a name="444316"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the currently defined system-wide boot disk group that is aliased by the reserved name, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font>. The boot disk group contains the volumes that are required to boot a system if its root disk is under VxVM control. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435975"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>defaultdg</b></font></font>
</p>
<p>
<a name="444335"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the currently defined system-wide default disk group. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425235"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> You can use the command <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdctl defaultdg</b></font> <em>diskgroup </em>to change the currently defined default disk group. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436013"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>deport</b></font></font>
</p>
<p>
<a name="444374"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Disables access to the specified disk group. A disk group cannot be deported if any volumes in the disk group are currently open (for example, they are mounted as file systems, or are in use by an application such as a database). When a disk group is deported, the host ID stored on all disks in the disk group are cleared (unless a new host ID is specified with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-h</b></font>), so the disk group is not reimported automatically when the system is rebooted. </font>
</p>
<p>
<a name="425250"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A disk group can be renamed on deport by specifying a new disk group name with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n </b></font><em>newname</em>. A lock can be assigned to an alternate host by specifying the host ID (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdctl</b></font>(1M)) of the alternate host. This allows the disk group to be auto-imported when the alternate host reboots. For example, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-h</b></font> options can be combined to export a disk group to be used as a disk group for a new machine. </font>
</p>
<p>
<a name="425261"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">In a cluster environment, when a cluster-shared disk group is deported, the cluster ID and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shared</b></font> flag stored on all disks in the disk group are cleared, so the disk group is not imported automatically when the cluster is next started. </font>
</p>
<p>
<a name="425266"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Trying to deport a shared disk group during a cluster reconfiguration fails. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436272"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>destroy</b></font></font>
</p>
<p>
<a name="444430"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Removes a disk group from the system. Use this option when a disk group and the information on the disks is no longer needed. This frees up space for use by other disk groups. A disk group cannot be destroyed if any volumes in the disk group are open (for example, they are mounted as file systems, or are in use by an application such as a database). <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font>destroy can be used only on imported disk groups. </font>
</p>
<p>
<a name="425282"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>destroy</b></font> operation clears the disk group name, and makes the disks available for use in other disk groups. However, the disk group ID is not cleared, so the disk group can be imported by specifying this value if the disk group has been accidentally destroyed (assuming that the disks have not already been added to another disk group). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436437"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>flush</b></font></font>
</p>
<p>
<a name="444456"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Rewrites all disk on-disk structures managed by VERITAS Volume Manager (VxVM) for the named disk groups. This rewrites all disk headers, configuration copies, and kernel log copies. Also, if any configuration copies were disabled (for example as a result of I/O failures), this command rewrites those configuration copies, and attempts to enable them. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436504"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>free</b></font></font>
</p>
<p>
<a name="444475"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Lists free space that can be used for allocating subdisks. If a disk group is specified, limit the output to the indicated disk group, otherwise list space from all disk groups. If disks are specified, by disk media name, then restrict the output to the indicated disks. A region of free space is identified by disk media name, a physical device tag, an offset relative to the beginning of the public region for the media, and a length. </font>
</p>
<p>
<a name="425317"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-q</b></font> option is specified, then no header is printed describing output fields. If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-a</b></font> option is specified, then space on spare disks (which is not really allocatable) is listed in addition to regular free space; otherwise, space on spare disks is <em>not</em> listed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436641"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>import</b></font></font>
</p>
<p>
<a name="444513"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Imports a disk group to make the specified disk group available on the local machine. This makes accessible any configuration information stored with the disk group, including any disk and volume configurations. The disk group to import is indicated by the <em>diskgroup</em> argument, which can be either an administrative disk group name or a disk group unique ID. </font>
</p>
<p>
<a name="425334"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Typically, a disk group is not imported if some disks in the disk group cannot be found by the local host. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option can be used to force an import if, for example, one of the disks is currently unusable or inaccessible. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425340"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Be careful when using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> flag because it can import the same disk group twice from disjointed sets of disks. This can make the disk group inconsistent. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425344"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When a disk group is imported, all disks in the disk group are stamped with the host's host ID. Typically, a disk group cannot be imported if any of its disks are stamped with a non-matching host ID. This provides a sanity check in cases where disks can be accessed from more than one host. </font>
</p>
<p>
<a name="425352"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If it is certain that a disk is not in use by another host (such as because a disk group was not cleanly deported), then the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-C </b></font>option can be used to clear the existing host ID on all disks in the disk group as part of the import. A host ID can also be cleared using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk clearimport</b></font>. </font>
</p>
<p>
<a name="425359"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Attempting to import a disk group with one of the reserved names (such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bootdg</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodg</b></font>) or with the same name as an existing disk group fails. A new name can be given to the disk group on import using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n </b></font><em>newname</em>. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n</b></font> is used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t </b></font>option, the stored name of the disk group remains unchanged, but the importing host knows the disk group under the new name; otherwise, the name change is permanent. </font>
</p>
<p>
<a name="425369"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Typically, an imported disk group is reimported automatically when the system is rebooted, if at least some of the disks in the disk group remain accessible and usable. This can be disabled using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font> option, which causes the import to be persistent only until the system is rebooted. </font>
</p>
<p>
<a name="425376"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">As an example of the use of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font>, a disk group from one host can be imported on a second host, operations (such as making repairs to the root volume if this is under VxVM control) can be performed on the second host. The repaired disk group can then be returned to the originating host. To do this, identify the disk group ID for the disk group with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk\ -s\ list</b></font>, and import the disk group using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-C</b></font> to clear import locks, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font> for a temporary name, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n</b></font> to specify an alternate name (to avoid collision with a similarly named disk group on the second host). After repair, deport the disk group using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-h</b></font> to restore the import lock from the first host. </font>
</p>
<p>
<a name="425390"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">In a cluster environment, use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> option to import a disk group as cluster-sharable. This is only valid if the cluster is active on the host where the import takes place. Ensure that all the disks in a shared disk group are physically accessible by all hosts. A host which cannot access all the disks in a shared disk group cannot join the cluster. </font>
</p>
<p>
<a name="425400"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The disks in a shared disk group are stamped with the ID of the cluster to which the hosts belong and are marked with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shared</b></font> flag. When a host joins a cluster, it automatically imports disk groups whose disks are stamped with the cluster ID. </font>
</p>
<p>
<a name="425405"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Trying to import a shared disk group during a cluster reconfiguration fails. </font>
</p>
<p>
<a name="425408"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the disks in a deported disk group have recently been scanned by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigd</b></font>, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o noreonline</b></font> option may be specified to avoid having to rescan all the disks to make them online again. This can greatly speed up the importing of a large disk group. </font>
</p>
<p>
<a name="425414"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Caution: Only use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>noreonline </b></font>if you know that a re-online has recently been performed on the disks (for example, by running the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdctl enable</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg import</b></font> commands), and that the configuration of the disks has not changed since that time. </font>
</p>
<p>
<a name="425421"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o selectcp</b></font> option is used to specify a disk ID, <em>diskid</em>, for the disk that has the preferred configuration copy. This option is used to force the import of a disk group after a serial split brain error condition has been detected. (Note that this condition can happen for any disk group; not just for private or shared disk groups in a cluster.) To help in choosing a preferred configuration copy, you can use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsplitlines</b></font> script to examine the IDs of the configuration copies on the disks. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsplitlines</b></font>(1M) manual page and the <em>VERITAS Volume Manager Administrator's Guide </em>for more information. </font>
</p>
<p>
<a name="425433"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o groupreserve=</b></font><em>fence_key</em> option specifies the I/O fencing key for a disk group. </font>
</p>
<p>
<a name="425436"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When importing a private disk group on which I/O fencing is enabled, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o groupreserve</b></font> option must be used to specify the I/O fencing key explicitly. The specified I/O fencing key, <em>fence_key</em>, must be no longer than 7 bytes. </font>
</p>
<p>
<a name="425441"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When importing a shared disk group on which I/O fencing is enabled, there is no need to specify the key explicitly provided that the appropriate I/O fencing licenses have been installed, and cluster-wide fencing has been enabled. The I/O fencing key is automatically created on import. </font>
</p>
<p>
<a name="425447"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o clearreserve</b></font> option can be used to clear pre-existing reservations on the disks that comprise the disk group. </font>
</p>
<p>
<a name="425451"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See the description of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg init </b></font>for more information about I/O fencing. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437762"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font></font>
</p>
<p>
<a name="444735"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Defines a new disk group composed of the indicated disks, identified by disk access names. This involves assigning an internal unique ID to the group, storing a pointer to that group in the root configuration, storing a reference to the group on all of the named disks that have a disk header, and storing a disk group record in the disk group's configuration database. At least one of the disks specified must have space allocated for a configuration copy. </font>
</p>
<p>
<a name="425465"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An existing deported disk group may be imported under a different name if it has the same name as that specified for the new disk group. </font>
</p>
<p>
<a name="425468"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> cannot complete if a disk is being used by a disk group, deported or otherwise. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font> finds an unneeded disk group on the disk, it can be cleaned with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk -f init</b></font> command. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg init</b></font> can then be run again. </font>
</p>
<p>
<a name="425474"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If a <em>medianame</em> is specified for use with a particular disk, then that <em>medianame</em> names the disk media record used to reference the disk within the disk group (for operations such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmdisk</b></font> and subdisk creations). If no <em>medianame</em> is specified, then the disk media name defaults to <em>accessname</em>. See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font>(1M) for a discussion of definition and initialization of disk access records. </font>
</p>
<p>
<a name="425483"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The following additional attributes may be specified to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> operation: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438030"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cds=</b></font>{<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>}</font>
</p>
<p>
<a name="444826"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies whether the disk group being created is compatible with the Cross-platform Data Sharing (CDS) feature. If not specified on the command line, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxdg</b></font> file is searched for a definition of this attribute. If no such definition is found, the value <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cds=on</b></font> is assumed. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425495"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> EFI disks cannot be added to CDS-compatible disk groups. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438104"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>minor=</b></font><em>base-minor</em></font>
</p>
<p>
<a name="444857"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a base volume device minor number for a disk group. Volume device numbers for a disk group are chosen to have minor numbers starting at this base minor number. Minor numbers can range up to 16,777,216, so if it is presumed that no more than 1000 volumes would ever be created in any one disk group, 16,777 different ranges of minor numbers are available for different disk groups. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425511"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The minor number range for disk groups that support the Cross-platform Data Sharing (CDS) feature is restricted to 65535 for compatibility with other platforms. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425515"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A reasonably sized range should be left at the end for temporary device number remappings (in the event that two device numbers still conflict). </font>
</p>
<p>
<a name="425519"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If no <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>minor</b></font> operand is specified on the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> command line, then VxVM chooses a random number of at least 1000 that is a multiple of 1000, and yields a usable range of 1000 device numbers. This default number is chosen such that it does not overlap within a range of 1000 of any currently imported disk groups, and does not overlap any currently allocated volume device numbers. </font>
</p>
<p>
<a name="425527"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Since disk groups can be moved between systems, it is desirable that device numbers used for volumes be allocated in separate ranges for each disk group. That way, you can choose ranges such that all disk groups in a group of machines can be moved around without causing device number collisions. Collisions may occur because VxVM stores device numbers in disk group configurations, so that the same numbers can be used after a reboot (which is necessary for use with NFS, which requires persistency of device numbers). If two systems use the same device numbers for a set of volumes, and if a disk group from one machine is moved to the other, then VxVM may be forced to temporarily remap some devices. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425541"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The default policy is likely to ensure that a small number of disk groups can be merged successfully between a set of machines. However, in cases where disk groups are merged automatically using fail-over mechanisms, the administrator should select ranges that are known to avoid overlap. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425548"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Trying to create a shared disk group during a cluster reconfiguration fails. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425551"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Volumes in shared disk groups must have the same minor number on all nodes in the cluster. If there is a conflict when a node attempts to join the cluster, the join fails. In that case, the administrator should use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reminor</b></font> operation on the joined node(s) to resolve the conflict. In a cluster where more than one node is joined, the administrator should use a base minor number which does not conflict on any node. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425563"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o groupreserve=</b></font><em>fence_key</em> option specifies the I/O fencing key for a disk group. The specified I/O fencing key, <em>fence_key</em>, must be no longer than 7 bytes. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425567"></a>To create the 8-byte SCSI-3 Persistent Reservation key, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font> adds the character 'A' to the node ID (0 to number of nodes minus 1) of the host within the cluster to form the first byte, and uses the I/O fencing key for the last 7 bytes (padding with NULL characters as appropriate). </font>
</blockquote>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425574"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The node ID is obtained from the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxfen</b></font> driver. This driver must have been been installed and configured to allow I/O fencing to be used with disk groups. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425578"></a>See the description of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg import </b></font>for more information about I/O fencing. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438819"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nconfig=</b></font><em>config-copies</em></font>
</p>
<p>
<a name="444955"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a base volume device minor number for a disk group. Volume device numbers for a disk group are chosen to have minor numbers starting at this base minor number. Minor numbers can range up to 16,777,216, so if it is presumed that no more than 1000 volumes would ever be created in any one disk group, 16,777 different ranges of minor numbers are available for different disk groups. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438823"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nlog=</b></font><em>log-copies</em></font>
</p>
<p>
<a name="444978"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of configuration database copies and kernel log copies respectively that are maintained for a disk group. </font>
</p>
<p>
<a name="425587"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <em>config-copies</em> and <em>log-copies</em> values can be a decimal number (including 0 or -1), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>all</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>default</b></font>. A value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>all </b></font>or -1 signifies that all configuration or log copies on all disks in the disk group are to be maintained. A value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>default</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>0 </b></font>(this is also the default value) signifies that VxVM is to manage copies that are distributed in a reasonable pattern throughout the disks, controllers and enclosures on the system. Any other number signifies that a particular number of copies should be maintained (or all copies, if that number is larger than the number of available configuration or log copies on all disks). </font>
</p>
<p>
<a name="425602"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When a  specific  number (or  default) is  requested, configuration copies are  distributed  across the  enclosures on  the system. The number of copies  in  each  enclosure is  proportional to  the  number of disks in that  enclosure. With  the  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>default</b></font> policy, at  least one configuration and log  copy is  maintained for  each enclosure. It is ensured  that at least one configuration  and log copy is maintained for each host controller connected to an enclosure. If  this  does not result in allocating at least 4 copies, then  additional copies are spread uniformly across enclosures. </font>
</p>
<p>
<a name="425612"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Refer to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdisk</b></font>(1M) for more information on configuration and log copies, and for information on how to create them. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425615"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> If a policy other than <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>all</b></font> is used, then some disks do not have up-to-date, online configuration and log copies. As a result, it is possible that some number of disk failures can leave a disk group unusable, even if some disks in the disk group remain usable. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>default</b></font> policy allocates a sufficient number of copies, in a sufficient spread of locations, that such a scenario is very unlikely to occur. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425626"></a>If a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>version</b></font> is specified with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font> option, the disk group is initialized with that disk group version. This limits the operations that can be performed and features that can be used to those supported by the specified disk group version. This makes the disk group compatible with releases of VxVM that support that version. If no <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>version</b></font> is specified, the disk group is initialized with the highest versions supported by the release of VxVM currently running on the system. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg upgrade </b></font>operation for more information. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425637"></a>In a cluster environment, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> option defines a new disk group which is cluster-sharable while the cluster is active. It is the responsibility of the user to ensure that disks specified as members of a cluster-sharable disk group are physically accessible from the hosts that make up the cluster. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425644"></a>The disks in a shared disk group are stamped with the ID of the cluster to which the hosts belong and are marked with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shared</b></font> flag. When a host joins a cluster, it automatically imports disk groups whose disks are stamped with the cluster ID. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439388"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join</b></font></font>
</p>
<p>
<a name="445094"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Moves all objects from the imported source disk group, <em>sourcedg</em>, to the imported target disk group, <em>targetdg</em>. At the conclusion of the move, <em>sourcedg</em> is removed. </font>
</p>
<p>
<a name="425655"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The source disk group and target disk group to be joined must both be either private or shared. If one disk group is private and the other is shared, deport and reimport the private disk group as shared before performing the join. </font>
</p>
<p>
<a name="425660"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o verify</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o override</b></font> options modify the default behavior of a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>move</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join</b></font> operation that includes disks from an EMC array. Usually, if the EMC license is present, the EMC disk compatibility check is performed for each disk that is involved in a move. If the compatibility check succeeds, the normal operation takes place. An internal check is made to ensure the configuration has not changed since the compatibility check was performed. If it was changed, the entire process is retried. </font>
</p>
<p>
<a name="425672"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o verify</b></font> is specified, the access names of the disks to be moved are returned but the operation does not take place. </font>
</p>
<p>
<a name="425676"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o override</b></font> is specified, the operation is performed without any EMC checking. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439627"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>list</b></font></font>
</p>
<p>
<a name="445161"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Lists the contents of disk groups. If no <em>diskgroup</em> arguments are specified, then all disk groups are listed in an abbreviated one-line format. If <em>diskgroup</em> arguments are specified, then a longer format is used to indicate the status of the disk group, and of the specified disk group configuration. </font>
</p>
<p>
<a name="425688"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-q</b></font> option is specified, then no header is printed describing output fields. This option has no effect with the long formats generated with <em>diskgroup</em> arguments. </font>
</p>
<p>
<a name="425693"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">In a cluster environment, if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> option is specified, all cluster-shared disk groups are listed in a one-line format. If <em>diskgroup</em> arguments are specified, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> has no effect. </font>
</p>
<p>
<a name="425699"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">You can use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o listreserve</b></font> option to discover if I/O fencing has been enabled for a disk group. If I/O fencing is enabled, the command also displays the current reservations and registered keys for the disks in the disk group. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439832"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>listmove</b></font></font>
</p>
<p>
<a name="445225"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays a list of all objects, including all objects in hierarchies, that would move from the imported source disk group, <em>sourcedg</em>, to the imported target disk group, <em>targetdg</em>, as implied by the specified list of <em>objects</em>. The items in the specified object list must be top-level objects, disk media objects or disk access objects. </font>
</p>
<p>
<a name="425712"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command is used to confirm the validity and object content of a proposed move operation without actually moving any objects. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439915"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>move</b></font></font>
</p>
<p>
<a name="445255"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Moves the specified objects together with their hierarchies from the imported source disk group, <em>sourcedg</em>, to the imported target disk group, <em>targetdg</em>. </font>
</p>
<p>
<a name="425720"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The items in the <em>object</em> list must be top-level objects, disk media objects or disk access objects. The list must define a set of <em>self-contained</em> objects, unless the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o expand</b></font> option is specified. (Self-contained means that the disks used by the selected objects should not contain any objects that are not selected for the move.) If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o expand</b></font> option is specified, the object set is expanded to be self-contained. </font>
</p>
<p>
<a name="425729"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The source disk group and target disk group must both be either private or shared. If one disk group is private and the other is shared, deport and reimport the private disk group as shared before performing the move. </font>
</p>
<p>
<a name="425734"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg join</b></font> for a description of the usage of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o override</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o verify</b></font> options. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440102"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nohotuse</b></font></font>
</p>
<p>
<a name="445327"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Lists free space that cannot be used by hot-relocation to replace failed subdisks. If a <em>diskgroup</em> is specified, the output is limited to the indicated <em>diskgroup</em>, otherwise nohotuse space from all disk groups is listed. If disks are specified, by disk <em>medianame</em>, then the output is restricted to  the  indicated  disks. A region of nohotuse space is identified by disk <em>medianame</em>, a physical  device  tag, an  offset  relative  to  the  beginning  of the public region for the media, and a length. </font>
</p>
<p>
<a name="425750"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The physical device tag is a reference that indicates which physical device the disk media is defined on. It appears as a truncated disk access name. </font>
</p>
<p>
<a name="425755"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-q</b></font> option is specified, then no header is printed describing output fields. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440264"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>recover</b></font></font>
</p>
<p>
<a name="445368"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Attempts to manually recover an incomplete <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>move</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join</b></font> operation using either of the disk groups that was involved in the operation. </font>
</p>
<p>
<a name="425763"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">In the event that the recovery cannot complete the operation, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o clean</b></font> option clears the MOVE flags from the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tutil0 </b></font>fields of the objects in the disk group. </font>
</p>
<p>
<a name="425767"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o remove</b></font> option removes all objects marked with the MOVE flag from the disk group. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440354"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reminor</b></font></font>
</p>
<p>
<a name="445409"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Changes the base minor number for a disk group, and renumbers all devices in the disk group to a range starting at that number. If the device for a volume is open, then the old device number remains in effect until the system is rebooted or until the disk group is deported and re-imported. Also, if you close an open volume, then the user can execute <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg\ reminor</b></font> again to cause the renumbering to take effect without rebooting or reimporting. </font>
</p>
<p>
<a name="425781"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A new device number may also overlap with a temporary renumbering for a volume device. This also requires a reboot or reimport for the new device numbering to take effect. A temporary renumbering can happen in the following situations: when two volumes (for example, volumes in two different disk groups) share the same permanently assigned device number, in which case one of the volumes is renumbered temporarily to use an alternate device number; or when the persistent device number for a volume was changed, but the active device number could not be changed to match. The active number may be left unchanged after a persistent device number change either because the volume device was open, or because the new number was in use as the active device number for another volume. </font>
</p>
<p>
<a name="425796"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font> fails if you try to use a range of numbers that is currently in use as a persistent (not a temporary) device number. You can force use of the number range by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option. With <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>, some device renumberings may not take effect until a reboot or a re-import (just as with open volumes). Also, if you force volumes in two disk groups to use the same device number, then one of the volumes is temporarily renumbered on the next reboot. Which volume device is renumbered should be considered random. The only exception is when the system is booted from a root disk that is under VxVM control. In this case, the device numbers for the boot disk group take precedence over all others. </font>
</p>
<p>
<a name="425809"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option should be used only when swapping the device number ranges used by two or more disk groups. To swap the number ranges for two disk groups, you would use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> when renumbering the first disk group to use the range of the second disk group. Renumbering the second disk group to the first range does not require the use of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440757"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>repldisk</b></font></font>
</p>
<p>
<a name="445493"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Dissociates the DA record from the DM record named by <em>spare-medianame</em>, and reassociates it with the unassociated DM record named by  <em>unassoc-medianame</em>. Both <em>unassoc-medianame </em>and <em>spare-medianame</em> must be members of the disk group named by the <em>diskgroup</em> argument. However, if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-k</b></font> flag is specified, then the disk media records for the <em>spare-medianame</em> are retained, although in a <em>removed</em> state. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440842"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmdisk</b></font></font>
</p>
<p>
<a name="445512"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Removes the specified disk or disks from a disk group. The last disk cannot be removed from its disk group. It is not possible to remove the last disk containing a valid disk group configuration or log copy from its disk group. </font>
</p>
<p>
<a name="425834"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Typically, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmdisk</b></font> operation fails if subdisk records point to the named disk media records. However, if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-k</b></font> flag is specified, then the disk media records are kept, although in a <em>removed</em> state, and the subdisk records still point to them. The subdisks, and any plexes that refer to them, remain unusable until the disk is re-added using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-k</b></font> option to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>adddisk</b></font> operation. Any volumes are disabled that become unusable because all plexes become unusable. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440979"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>set</b></font></font>
</p>
<p>
<a name="445566"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Changes disk group characteristics. Specify changes by entering arguments after the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>set</b></font> keyword in the form <em>attribute</em>=<em>value</em>. </font>
</p>
<p>
<a name="425851"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The following attributes may be set: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441036"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>activation</b></font>=<em>mode</em></font>
</p>
<p>
<a name="445592"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The activation mode of a disk group determines whether applications are permitted to read and write to volumes in the disk group. </font>
</p>
<p>
<a name="425858"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The following are the valid activation modes and corresponding read/write capability for non-shared disk groups: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441084"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font></font>
</p>
<p>
<a name="445614"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Volumes in the disk group are not available for read or write access. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441097"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>readonly </b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> ro</b></font></font>
</p>
<p>
<a name="445637"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Volumes in the disk group are available for read access only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441110"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>readwrite </b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> rw</b></font></font>
</p>
<p>
<a name="445660"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Volumes in the disk group are available for read and write access. </font>
</p>
<p>
<a name="425872"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For a shared disk group, the activation mode is on a per node basis. The following are the valid activation modes and corresponding read/write capability for shared disk groups: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441158"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>exclusivewrite </b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> ew</b></font></font>
</p>
<p>
<a name="445683"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The node has exclusive write access to volumes in the disk group. No other node in the cluster can activate the disk group for write access. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441180"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>readonly </b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> ro</b></font></font>
</p>
<p>
<a name="445706"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The node has read access to volumes in the disk group. It has no write access and denies write access to all other nodes in the cluster. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441212"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sharedread </b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> sr</b></font></font>
</p>
<p>
<a name="445729"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The node has read access to volumes in the disk group, but no write access, However, other nodes can activate the disk group for write access. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441243"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sharedwrite </b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> sw</b></font></font>
</p>
<p>
<a name="445752"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The node has write access to volumes in the disk group. Other nodes can activate the disk group for shared write access. </font>
</p>
<p>
<a name="425896"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The related attributes-value pairs, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enable_activation</b></font>=<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>true </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>default_activation_mode</b></font>=<em>mode</em>, can be used to enable and define a default activation mode for shared disk groups. These attributes can only be set by adding their definitions to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxdg</b></font> defaults file. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441335"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>align=</b></font>{<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>1</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>8k</b></font>}</font>
</p>
<p>
<a name="445797"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The node has write access to volumes in the disk group. Other nodes can activate the disk group for shared write access. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441339"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alignment=</b></font>{<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>1</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>8k</b></font>}</font>
</p>
<p>
<a name="445836"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the alignment value for the disk group. Possible values are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>1</b></font> (one block) or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>8k</b></font> (8KB). For a disk group to be compatible with the Cross-platform Data Sharing (CDS) feature, the alignment value must be set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>8k</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441379"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cds=</b></font>{<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>}</font>
</p>
<p>
<a name="445863"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies whether a disk group is compatible with the Cross-platform Data Sharing feature. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441401"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dgfailpolicy=</b></font><em>policy</em></font>
</p>
<p>
<a name="445886"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sets the disk group failure policy in the case that the master node loses connectivity to the configuration and log copies within a shared disk group. This attribute is ignored for private disk groups, and requires that the disk group version is 120 or greater. The following policies may be set: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441441"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dgdisable</b></font></font>
</p>
<p>
<a name="445905"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The master node disables the disk group for all user or kernel-initiated transactions. First write and final close fail. </font>
</p>
<p>
<a name="425927"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is the default policy. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441479"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>leave</b></font></font>
</p>
<p>
<a name="445927"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The master node panics instead of disabling the disk group if a log update fails for a user or kernel-initiated transaction (including first write or final close). If the failure to access the log copies is global, all nodes panic in turn as they become the master node. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441534"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskdetpolicy=</b></font><em>policy</em></font>
</p>
<p>
<a name="445950"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sets the disk group detach policy, which determines the way that unusable disks are detached in a shared disk group. This attribute is ignored for private disk groups. The following policies may be set: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441583"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>global</b></font></font>
</p>
<p>
<a name="445969"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For a shared disk group, if any node in the cluster reports a disk failure, the detach occurs in the entire cluster. An I/O error results if the disk was in the final active plex of a volume. </font>
</p>
<p>
<a name="425952"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is the default policy. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441639"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>local</b></font></font>
</p>
<p>
<a name="445991"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If a disk fails for a single node only, the I/O failure is confined to that node. If all nodes report a problem with the failed disk, the disk is detached throughout the cluster. An I/O error results if the disk was in the final active plex of a volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441694"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxdev=</b></font><em>number</em></font>
</p>
<p>
<a name="446014"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the maximum number of VxVM devices that are permitted in a disk group. This value must be a positive integer that is greater than the number of such devices that are currently configured in the disk group. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425970"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cds</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>default_activation_mode </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enable_activation</b></font> attribute values may be defined in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxdg</b></font> defaults file. Values that are defined in this file override the built-in default values, and persist across reboots of the system. Attribute values that are defined in the defaults file may themselves be overridden by values specified on the command line. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441804"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>spare</b></font></font>
</p>
<p>
<a name="446049"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Lists spare space that can be used for relocating subdisks during recovery. If a disk group is specified, the output is limited to the indicated disk group, otherwise spare space is listed from all disk groups. If disks are specified, by disk media name, the output is restricted to the indicated disks. A region of spare space is identified by disk media name, a physical device tag, an offset relative to the beginning of the public region for the media, and a length. </font>
</p>
<p>
<a name="425989"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The physical device tag is a reference that indicates which physical device the disk media is defined on. It appears as a truncated disk access name. </font>
</p>
<p>
<a name="425994"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-q</b></font> option is specified, then no header is printed describing output fields. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441957"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font></font>
</p>
<p>
<a name="446086"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Moves the specified objects together with their hierarchies from the imported source disk group, <em>sourcedg</em>, to a newly created target disk group, <em>targetdg</em>. </font>
</p>
<p>
<a name="426002"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This operation fails if it would remove all the disks from the source disk group, or if an imported disk group exists with the same name as the target disk group. </font>
</p>
<p>
<a name="426006"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An existing deported disk group may be imported under a different name if it has the same name as the target disk group (as is the case for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg init</b></font> command). </font>
</p>
<p>
<a name="426010"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The items in the <em>object</em> list must be top-level objects, disk media objects or disk access objects. The list must define a set of <em>self-contained</em> objects, unless the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o expand</b></font> option is specified. (Self-contained means that the disks used by the selected objects should not contain any objects that are not selected for the move.) If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o expand</b></font> option is specified, the object set is expanded to be self-contained. </font>
</p>
<p>
<a name="426019"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The newly created target disk group is imported as shared if the source disk group is shared; otherwise, it is imported as private. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-C</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font> options are import options for the new disk group. See the description of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg import</b></font> for details of their use. </font>
</p>
<p>
<a name="426025"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg join</b></font> for a description of the usage of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o override</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o verify</b></font> options. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442221"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>upgrade</b></font></font>
</p>
<p>
<a name="446172"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Upgrades the disk group to the latest VERITAS Volume Manager version. By default, the disk group version is updated to the running version of VxVM. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T </b></font>option upgrades the disk group to a specified version. The following section lists each disk group version, the features it supports, and the VERITAS Volume Manager release that introduced it. Note: Some VERITAS Volume Manager versions are not available on all supported OS platforms. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442324"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>10</b></font></font>
</p>
<p>
<a name="446195"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Supports only the most basic volume management features of mirroring and simple striping. This format was introduced in VxVM Release 1.2. Starting with VxVM Release 3.0, disk groups of version 10 can be imported, but <em>no operations can be performed on the objects it </em>contains (for example, starting volumes or adding mirrors). The only operation supported is to upgrade the disk group to a later release. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442382"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>20</b></font></font>
</p>
<p>
<a name="446214"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Introduced support for RAID-5 Volumes, new-style stripes, recovery checkpointing, disk group configuration/klog copy limiting, and Dirty Region Logging. This version was introduced in VxVM Release 2.0 and is supported by all subsequent releases of VxVM. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442422"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>30</b></font></font>
</p>
<p>
<a name="446233"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Enabled support for the Oracle Resilvering Interface. This version was introduced in VxVM Release 2.2 and is supported by all subsequent releases of VxVM. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442453"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>40</b></font></font>
</p>
<p>
<a name="446252"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Support for Hot Relocation. Introduced in VxVM Release 2.3 and is supported by all subsequent releases of VxVM. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442475"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>60</b></font></font>
</p>
<p>
<a name="446271"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Support for Online Relayout, safe RAID-5 subdisk moves, Striped Mirrors, and RAID-5 Snapshots. Introduced in Release 3.0. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442497"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>70</b></font></font>
</p>
<p>
<a name="446290"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Non-Persistent FastResync, VERITAS Volume Replicator (VVR) enhancements, and Unrelocate. Introduced in Release 3.1. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442528"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>80</b></font></font>
</p>
<p>
<a name="446309"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">VERITAS Volume Replicator (VVR) Enhancements. Introduced in Release 3.1.1. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442541"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>90</b></font></font>
</p>
<p>
<a name="446328"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Cluster support for Oracle Resilvering, disk group move, split and join, Device Discovery Layer (DDL), layered volume support in clusters, ordered allocation, OS independent Naming support, and Persistent FastResync. Introduced in Release 3.2. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442599"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>110</b></font></font>
</p>
<p>
<a name="446351"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Cross-platform Data Sharing (CDS), Device Discovery Layer (DDL) 2.0, disk group configuration backup and restore, elimination of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rootdg</b></font> as a special disk group, full-sized and space-optimized instant snapshots, VERITAS Intelligent Storage Provisioning (ISP), volume sets (Multiple Device support for VERITAS File System). Introduced in Release 4.0. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442675"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>120</b></font></font>
</p>
<p>
<a name="446370"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Automatic cluster-wide failback for A/P arrays, DMP co-existence with third-party drivers, migration of volumes to ISP, persistent DMP policies, shared disk group failure policy, support for EFI disks. Introduced in Release 4.1. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442741"></a>To determine the version of a disk group, use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg list</b></font> <em>diskgroup</em> command. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="442753"></a> HARDWARE-SPECIFIC OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442758"></a>Some environments provide guidelines to optimize VxVM's interaction with intelligent storage systems. If these guidelines are present, VxVM follows the guidelines when creating disk groups and adding disks to disk groups. By default, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font> only allows disk groups to contain disks that conform with these guidelines. The following options change the behavior of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442825"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o override</b></font></font>
</p>
<p>
<a name="446405"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Performs the disk group task and ignores any storage-specific guidelines. Overriding the guidelines is not recommended as it can result in incompatible objects, or objects that cannot be administered by VxVM. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442874"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o verify</b></font></font>
</p>
<p>
<a name="446428"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Verifies that the specified disk group task can be performed without violating any storage-specific guidelines, but does not perform the task. If any guidelines are violated, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font> exits with an error message. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="426131"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> These options need a specific license. Without the license, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font> ignores the specified option. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442929"></a>Refer to the vendor-specific documentation for more information on how intelligent storage systems can interact with VxVM. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="442941"></a> I/O FENCING OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442946"></a>In clusters that are configured using VERITAS Cluster Server (VCS) as the cluster monitor, the I/O fencing feature uses the underlying hardware disk reservation mechanism to avoid the split brain problem. </font>
</p>

<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="426142"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The SCSI-3 Persistent Reservation (PR) mechanism is currently supported for disk reservation. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="426145"></a>See the description of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg import</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>list </b></font>commands for information about the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>clearreserve</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>groupreserve</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>listreserve </b></font>options that are used with I/O fencing. </font>
</blockquote>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="443044"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443050"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxdg</b></font></font>
</p>
<p>
<a name="446496"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Default attribute definitions file for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font> command. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="443062"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443067"></a><a href="vxcdsconvert_vxvm_manpages19_429531.html#427996"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxcdsconvert </b></font></font></a>(1M), <a href="vxconfigd_vxvm_manpages25_433964.html#430068"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigd </b></font></font></a>(1M), <a href="vxdctl_vxvm_manpages30_431266.html#429207"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdctl </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="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="vxplex_vxvm_manpages56_438209.html#431636"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font></font></a>(1M), <a href="vxprint_vxvm_manpages58_439087.html#433463"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint </b></font></font></a>(1M), <a href="vxvol_vxvm_manpages85_441003.html#433596"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol </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="vxdg_vxvm_manpages33_443062.html" title="vxdg">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vxdestroy_lvmroot_vxvm_manpages32_427120.html" title="Previous - vxdestroy_lvmroot">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxdisk_vxvm_manpages34_439794.html" title="Next - vxdisk">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>
