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

</HEAD>

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

<a name="458378"></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="vxaslkey_vxvm_manpages13_426453.html" title="Previous - vxaslkey">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxbootsetup_vxvm_manpages15_426957.html" title="Next - vxbootsetup">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="441128"></a>vxassist</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="441151"></a> NAME</font>
</h3>
<p>
<a name="441156"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxassist - create, relayout, convert, mirror, backup, grow, shrink, delete, and move volumes </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="441159"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441164"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addlog</b></font><em> volume </em>[<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441176"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>convert</b></font><em> volume </em>[<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441188"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growby</b></font> <em>volume lengthchange</em> [<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441200"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growto</b></font><em> volume newlength</em> [<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441212"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist help</b></font> { <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>attrs</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>options</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>showattrs</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>space</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>usage</b></font> } 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441294"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font><em> volume length</em> [<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441306"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxgrow </b></font><em>volume</em> [ <em>attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441318"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxsize </b></font>[<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441330"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font><em> volume </em>[<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441342"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>move</b></font> <em>volume storage-spec</em>... [<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441354"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout </b></font>{<em> volume</em>|<em> plex</em>} [<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441366"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] <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> volume | mirror | log </b></font>} <em>volume</em> [<em>storage-spec</em>...] [<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441378"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shrinkby</b></font> <em>volume lengthchange</em> [<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441390"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shrinkto</b></font> <em>volume newlength</em> [<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441402"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapabort</b></font> <em>volume </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441405"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font> <em>snapvolume </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441408"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapclear </b></font><em>volume</em> [<em>snap_object</em>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441420"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapprint</b></font> [<em>volume</em>]  
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441423"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font> <em>volume </em>[<em>snapvolume</em>] [<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441435"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b> -b</b></font> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font><em>number</em>] <em>volume</em> [<em> attribute</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="441456"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> [<em> options</em> ] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapwait</b></font> <em>volume </em>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="441459"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441464"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>utility is a command-line interface to the VERITAS Volume Manager (VxVM) that: </font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425065"></a>Finds space for and creates volumes </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425068"></a>Performs volume conversion </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425071"></a>Adds mirrors and logs to existing volumes </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425074"></a>Extends and shrinks existing volumes </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425077"></a>Migrates data from a specified set of disks </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425080"></a>Provides facilities for the online backup of existing volumes </font>
</li>
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441590"></a>Specify the appropriate keyword to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>to select an action to perform. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441611"></a>Each operation can be applied to only one disk group at a time. For most keywords, the <em>volume</em> operand specifies the volume on which to operate. For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation, attributes that name specific disks can be used to determine a default disk group, according to the standard disk group selection rules described in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M). A specific disk group can be specified with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>. If this option is not specified, and an alternate default disk group is not defined by specifying the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskgroup</b></font> attribute on the command line or in a defaults file (usually <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxassist</b></font>), the default disk group is determined using the rules given in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) manual page. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441749"></a>Many <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> operations can take a set of attributes that specify such things as how to lay out volumes, or on which sets of disks to build them. There are two basic types of attributes: </font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425111"></a><em>storage specifications </em></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425114"></a><em>attribute settings </em></font>
</li>
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441811"></a>Storage specification attributes are either simple disk names (for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk01</b></font>), or groups of disks selected by controller or target. For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ctlr:c1</b></font> specifies all disks on controller 1. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441841"></a>You can exclude (negate) storage specification by specifying the exclamation character (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font>) prefix. (Note: You may also need to escape the ! character to prevent it being interpreted by the shell.) For example, you can combine the arguments <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ctlr:c1</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!target:c1t5 </b></font>to indicate that storage be allocated from controller 1, but not from SCSI target 5 on that controller. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441907"></a>Other attributes are of the form <em>attrname=value</em>; these additional attributes can specify the type of a volume (mirrored, RAID-5, striped, logged), layout policies (contiguous, spanning), mirroring requirements (mirror across controllers), and constraint parameters (constrain allocations to a single controller). See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATTRIBUTES</b></font> section below for a complete list of attribute specifications. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441973"></a>If no non-excluded storage specification attributes are given, any non-reserved, non-volatile, non-spare, non-excluded disk can be used to allocate storage. Attributes may constrain the selection, particularly with respect to the selection of multiple disks. For example, the command: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="442063"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;make&nbsp;mirvol&nbsp;500m&nbsp;layout=mirror,log&nbsp;mirror=ctlr&nbsp;!ctlr:c2</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442073"></a>requests that <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> create a new mirrored volume on any disks that are not on controller 2. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror=ctlr</b></font> attribute constrains the selection of disks so that the mirrors are created on different controllers. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="442103"></a> KEYWORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442109"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addlog</b></font></font>
</p>
<p>
<a name="459270"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Adds a log or DCO to a volume. </font>
</p>
<p>
<a name="425167"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">DCO is a data change object, used for Persistent FastResync. Note: This operation is only supported for version 0 DCOs. </font>
</p>
<p>
<a name="425170"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">DRL is a dirty region log, used for speedy recovery of mirrors after a system crash. </font>
</p>
<p>
<a name="425173"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sequential DRL is a form of DRL that is optimized for volumes that are written to sequentially, such as database log volumes. </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="425176"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> For volumes with version 20 DCOs, DRL and sequential DRL are supported within the DCO volume itself. You can specify the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcoversion=20</b></font> attribute to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist make </b></font>command to create a volume with a version 20 DCO, or you can use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap prepare</b></font> command to add a version 20 DCO to a volume. You cannot use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist addlog</b></font> command to add a version 20 DCO to a volume. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425184"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">DCM is a data change map, used for fast resynchronization of a secondary RVG with its primary. </font>
</p>
<p>
<a name="425187"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Mirrored volumes are associated with DRL or sequential DRL logs. </font>
</p>
<p>
<a name="425189"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">RAID-5 volumes are associated with RAID-5 logs. </font>
</p>
<p>
<a name="425191"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Replicated volumes are associated with DCM logs. </font>
</p>
<p>
<a name="425193"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">By default, when adding a log, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> attempts to determine the correct type of log to add, even if no <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logtype</b></font> attribute is specified. For example, if the volume is part of an RVG, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> attempts to create a DCM log. </font>
</p>
<p>
<a name="425198"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When adding a DRL, RAID-5 or DCM log to a volume for the first time, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>loglen</b></font> attribute can be used to specify the length of the log; on adding additional logs, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>loglen</b></font> attribute is ignored and the existing log length is used. If a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>loglen</b></font> which is too large or small to be practical is specified, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> may adjust the length to a reasonable size. If no <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>loglen</b></font> attribute is supplied, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> picks an appropriate log size. Other attributes can be specified to indicate desired properties for the new allocations. Mirroring constraints do not apply to logs, though storage constraints can be specified that limit the logs to disk sets already used by the volume. </font>
</p>
<p>
<a name="425210"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Adding a version 0 DCO to a volume creates a DCO object that is associated with the volume, and a DCO volume that is associated with the DCO object. When created for a non-layered volume with at least 2 data plexes or for any layered volume, the default DCO volume has 2 DCO plexes (mirrors for redundancy), each of length 132 blocks. When created for a non-layered volume with a single data plex, the default DCO volume has a single unmirrored DCO plex of length 132 blocks. </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="425219"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The actual length may be rounded up to the disk group alignment value (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M)). 
</font>
<hr noshade size="2" width="100%" color="#000000">
<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="425222"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> To allow operation of the dynamic disk group split/join feature (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) for more information), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> attempts to place version 0 DCO plexes on the same disks as the plexes of the corresponding data volume. This allocation policy may not succeed if there is insufficient disk space. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> then uses available space in the remaining disks of the disk group. This may prevent certain disk group split or move operations if the DCO plexes cannot accompany their parent data volume. To overcome this, you can use storage specifications to specify explicitly the disks on which the DCO plexes are to be configured. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<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="425233"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Adding a DCO does not enable Persistent FastResync on the parent volume unless <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fastresync=yes</b></font> is also specified. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425236"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Adding a DRL log to a mirrored volume creates a single log subdisk and a new plex to contain that subdisk. The new plex is then attached to the volume. Note: For volumes with version 20 DCOs, DRL is supported within the DCO volume itself. Dedicated DRL log plexes should not be created for such volumes. </font>
</p>
<p>
<a name="425243"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Adding a RAID-5 log to a RAID-5 volume involves creating a new plex that is attached to the volume as a log plex. </font>
</p>
<p>
<a name="425247"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Adding a DCM log to a replicated volume adds two logs (by default), each consisting of a log plex and associated subdisk. DCM logging can co-exist with DCO. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442845"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>convert</b></font></font>
</p>
<p>
<a name="459432"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Converts a volume layout to a mirror-stripe from a stripe-mirror, or from a mirror-stripe to a stripe-mirror. Also converts to mirror-concat from a concat-mirror, or from a mirror-concat to a concat-mirror. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="442887"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growby</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growto</b></font></font>
</p>
<p>
<a name="459483"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Increases the length of the named volume to the length specified by <em>newlength</em> (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growto</b></font>), or by the length specified by <em>lengthchange</em> (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growby</b></font>). Specify the new length, or change in length, in VERITAS Volume Manager standard lengths (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M)). The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growto </b></font>operation fails if the new length is not greater than the current volume length. The length of the volume is increased by extending existing subdisks in the volume, or by adding and associating new subdisks. Plexes that are not already fully populated (that is, <em>sparse</em>) are left unchanged. Log-only plexes are also left unchanged. </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="425279"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Following a relayout, specify the attribute <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout=nodiskalign </b></font>to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growby</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growto</b></font> commands if you want the subdisks to be grown using contiguous disk space. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<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="425283"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> When you grow a volume, it is recommended that you also grow any file system that is configured on that volume (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxresize(1M)</b></font>). <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> does not resize file systems (or other uses of the volume, such as databases) that reside on the volume. If necessary, use the appropriate application command to adjust the layout of data in the volume <em>after</em> the grow operation has finished. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425292"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When a volume is grown, the volume may be converted from one layout to another as a side effect. For example, a volume that has the mirror-stripe layout may be converted to stripe-mirror when it is grown. This kind of conversion is done if <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>determines that the new volume is too small or large for the original layout. If the new volume layout is inappropriate, use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>convert</b></font> operation between layered and non-layered forms. See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Layout Specifications</b></font> for a description of the methods used to determine disk layouts. </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="425305"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font> operation requires all mirrors in a volume to have the same layout. If a mirrored volume is composed of mixed plex layouts, relayout the mirror plexes to the same layout before attempting to relayout the volume. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425310"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">You can specify attributes to indicate properties for the new allocations. Any mirroring constraints still apply between all extensions to the existing mirrors and the other mirrors. Growing of a volume requires that the volume be enabled. </font>
</p>
<p>
<a name="425315"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When the size of a replicated volume changes, you can ensure that the size of the DCM is appropriate by removing all the DCM logs and adding them back without specifying the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>loglen </b></font>attribute. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443446"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>help</b></font></font>
</p>
<p>
<a name="459587"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays information on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>usage and VERITAS Volume Manager attributes. For example, to display information about using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>attributes, enter: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="443536"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;help&nbsp;attributes</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443553"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font></font>
</p>
<p>
<a name="459620"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Creates a volume with the specified name and the specified length. The length is specified as a standard VERITAS Volume Manager length (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M)). You can specify attributes to indicate various properties and storage locations for the created volume. See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Layout Specifications </b></font>for a description of the methods used to determine disk layouts. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443638"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxgrow</b></font></font>
</p>
<p>
<a name="459639"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Reports the maximum size a volume can grow given its attributes and given the free storage available. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443661"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxsize</b></font></font>
</p>
<p>
<a name="459658"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Reports the maximum size a volume could be created with given the attributes specified and given the free storage available. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443683"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font></font>
</p>
<p>
<a name="459677"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Creates a new mirror (or plex) and attaches it to the volume. This operation is allowed only if the volume is enabled. Attributes can be specified to indicate various desired properties and storage locations for the created volume. Attributes that constrain mirroring (such as requiring that mirrors be on separate groups of disks) apply between the existing mirrors of the volume and the new mirror. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="443750"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>move</b></font></font>
</p>
<p>
<a name="459700"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Moves subdisks within the named volume off the excluded storage specified on the command line. Excluded storage is specified with a prefix of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font>. The move operation requires that at least one excluded storage specification be given. </font>
</p>
<p>
<a name="425377"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the volume is enabled, subdisks within detached or disabled plexes (or detached log or RAID-5 subdisks) are moved without recovery of data. If the volume is not enabled, stale log or RAID-5 subdisks, or subdisks within <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">STALE</font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">OFFLINE</font> plexes, are moved without recovery; if there are other subdisks within a non-enabled volume that require moving, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>move </b></font>operation fails. </font>
</p>
<p>
<a name="425395"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For enabled subdisks in enabled plexes within an enabled volume, the data within subdisks are moved to the new location, without loss of availability (or redundancy) of the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444004"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font></font>
</p>
<p>
<a name="459729"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Changes a volume layout or properties. This operation changes the number of columns in a stripe or the stripe width of a volume. It also converts a volume to or from RAID-5, concatenated-mirror, striped, striped-mirror or any similar layout. </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="425406"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The relayout operation internally generates unique data object names (for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v2-Dp02</b></font>) when it converts a volume to a specified destination layout. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<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="425410"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Following a relayout, specify the attribute <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout=nodiskalign </b></font>to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growby</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growto</b></font> commands if you want the subdisks to be grown using contiguous disk space. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425414"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">After relayout to a layered form, a volume may be converted to a non-layered form. For example, to convert from a 4-column mirror-stripe to a 5-column mirror-stripe, first relayout the volume as a stripe-mirror: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="444179"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;relayout&nbsp;vol1&nbsp;nstripe=5</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425427"></a>If you view the volume with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> during relayout, the volume shows several subvolumes that are used during the change, and a more complex configuration than usual. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425432"></a>After the new column is added, the volume is in stripe-mirror layout. Use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist convert </b></font>to convert back to a mirror-stripe layout: </font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="444281"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;convert&nbsp;vol1&nbsp;layout=mirror-stripe</font>
</font>
<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="425445"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> If the system crashes during relayout or conversion, the process continues when the system is rebooted. However, if the crash occurred during the first stage of a two-stage relayout and convert operation, only the first stage is subsequently completed after rebooting. You must run <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist convert</b></font> manually to complete the second stage. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444359"></a><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>volume</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log</b></font></font>
</p>
<p>
<a name="459840"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Deletes the entire volume, one or more mirrors, or one or more logs, according to the argument. When deleting a mirror or a log, specify the storage to be removed using the attribute form <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font><em>diskname </em>(see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Storage Specifications</b></font> below). For example, to remove a mirror on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk01</b></font>, enter: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="444476"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;remove&nbsp;mirror&nbsp;vol01&nbsp;!disk01</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425473"></a>See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font>(1M) for an example of an alternative method of removing a mirror from a volume. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425478"></a>Use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logtype=</b></font> attribute to specify the type of log to be removed. For example, specify <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logtype=drl</b></font> to remove a DRL log. </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="425482"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Specifying <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logtype=dco</b></font> completely removes a version 0 DCO object, DCO volume and any snap objects that are associated with the specified volume, and also disables FastResync on the volume. To remove a version 20 DCO and DCO volume, use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap unprepare</b></font> command. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425487"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc=</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nlog=</b></font> attributes also determine the number of mirrors or logs remaining after the remove operation completes. When the number of mirrors drops to 1, logs are also removed. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425493"></a>By default, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>removes 1 mirror or 1 log. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="444702"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shrinkby</b></font> | <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shrinkto</b></font></font>
</p>
<p>
<a name="459934"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Decreases the length of the named volume to the length specified by <em>newlength</em> (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shrinkto</b></font>), or by the length specified by <em>lengthchange</em> (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shrinkby</b></font>). Specify the new length, or change in length, in VERITAS Volume Manager standard lengths (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M)). The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shrinkto</b></font> operation fails if the new length is not less than the current volume length. </font>
</p>
<p>
<a name="425511"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The length of a volume is decreased by removing and shortening subdisks to leave each plex with the requested volume length. The freed space can then be allocated for use by other volumes. Log-only plexes are left unchanged. </font>
</p>
<p>
<a name="425516"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When a volume is shrunk, the volume may be converted from one layout to another as a side effect. For example, a volume that has the mirror-stripe layout may be converted to stripe-mirror when it is shrunk. This kind of conversion is done if <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>determines that the new volume is too small or large for the original layout. If the new volume layout is inappropriate, use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>convert</b></font> operation between layered and non-layered forms. See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Layout Specifications</b></font> for a description of the methods used to determine disk layouts. </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="425529"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> You cannot resize volumes comprised of different plex layouts. If you try to do so, an error message displays stating that the volume contains differing layouts. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425533"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Caution: Data can be lost or corrupted if file systems or other organized data residing on a volume are not shrunk before shrinking the volume. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> does not resize file systems (or other uses of the volume, such as databases) that reside on the volume. You can use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxresize </b></font>command to shrink file systems on the volume (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxresize</b></font>(1M)). Otherwise, use the appropriate application command to adjust the layout of data in the volume <em>before</em> initiating the shrink operation. You must specify the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option to forcibly shrink volumes of usage type <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445112"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapabort</b></font></font>
</p>
<p>
<a name="460014"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Removes the mirror snapshot when a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font> mirror has been started (and eventually completed). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445134"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font></font>
</p>
<p>
<a name="460037"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">By default, finds one plex in the snapshot volume that has the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap_rid </b></font>field set, and attaches it to the original volume. If the plex is the last in a volume, that volume is removed from the 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="425556"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The snapshot volume and the original volume must be in the same disk group. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425559"></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>-o allplexes</b></font> option is specified, all snapshot plexes in the same disk group are reattached. Alternatively, if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font><em>number</em> attribute is specified, only <em>number</em> plexes are reattached. </font>
</p>
<p>
<a name="425564"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The direction of the resynchronization can be determined by specifying either <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resyncfromoriginal</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resyncfromreplica </b></font>as the <em>useopt</em> argument to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> option. To choose the original volume as the preferred copy of the data, use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o resyncfromoriginal</b></font>. To choose the replica as the preferred copy of the data, use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o resyncfromreplica</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="425572"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Always unmount the snapshot volume (if mounted) before using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font>. You must also unmount the original volume (if mounted) before using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o resyncfromreplica</b></font> option. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445359"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapclear</b></font> </font>
</p>
<p>
<a name="460130"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Clears the FastResync map, removes any snap objects, and clears the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap_rid</b></font> field of the volume. </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="425581"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font> cannot be invoked after <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapclear</b></font> is used. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425583"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If Persistent FastResync is enabled and the original volume and the snapshot volume are in different disk groups, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapclear</b></font> removes the snap object and clears the FastResync map for the snapshot volume that corresponds to the snapshot object. To stop tracking on the original volume for the snapshot volume, specify the snap object, <em>snap_object</em>, in the original volume that refers to the snapshot volume. You must also run <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist snapclear</b></font> separately on the snapshot volume. For example, if <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>myvol1</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAP-myvol1 </b></font>are in separate disk groups <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mydg1</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mydg2</b></font> respectively, the following command stops tracking on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>myvol1</b></font> with respect to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAP-myvol1</b></font>: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="445527"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;-g&nbsp;mydg1&nbsp;snapclear&nbsp;myvol1&nbsp;SNAP-myvol1_snp</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425604"></a>However, tracking is still enabled on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAP-myvol1</b></font> with respect to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>myvol1</b></font>. The following command turns this tracking off by specifying the snap object, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>myvol1_snp</b></font>, in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAP-myvol1</b></font> that points to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>myvol1</b></font>: </font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="445610"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;-g&nbsp;mydg2&nbsp;snapclear&nbsp;SNAP-myvol1&nbsp;myvol1_snp</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425617"></a>If Persistent FastResync is enabled and the original volume and the snapshot volume are in the same disk group, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapclear</b></font> removes the snap records for both the original volume and the snapshot volume in addition to clearing their FastResync maps. </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="425623"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Either of the two previous examples stops Persistent FastResync tracking for <em>both</em> the snapshot volume (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAP-myvol1</b></font>) and the original volume (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>myvol1</b></font>) if they are in the same disk group. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425627"></a>To support Non-Persistent FastResync and to be compatible with previous versions of VxVM, a single snapshot volume can be specified as the argument to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapclear</b></font>, for example: </font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="445794"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;-g&nbsp;myolddg&nbsp;snapclear&nbsp;SNAP-myoldvol</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="445817"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapprint</b></font></font>
</p>
<p>
<a name="460267"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the associations between the original volumes and their respective replicas. If a volume is specified, output is displayed only for that volume. An error message is displayed if FastResync is not enabled on the volume. </font>
</p>
<p>
<a name="425646"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The following information is displayed: </font>
</p>
<p>
<ul type="disc"><p>
<ul type="disc"><p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425650"></a>Name of the original volume. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425653"></a>Names of all snapshot volumes. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425662"></a>Length in blocks of the volume, detached plex, or snapshot plex. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425665"></a>Percentage of the snapshot plex or detached plex that is considered to have been changed (<em>dirty</em>). For Non-Persistent FastResync, which keeps information about changed regions in a single map for the original volume and its snapshot volumes, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%DIRTY</b></font> value is the same for the original volume as for a snapshot volume even if writes are only made to the snapshot volume. For Persistent FastResync, which maintains separate tracking maps for the original volume and each of its snapshot volumes, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%DIRTY</b></font> value is based only on what has been written to an individual volume. </font>
</li>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425683"></a>In the following example, Persistent FastResync is enabled on volume <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v1</b></font>, and Non-Persistent FastResync on volume <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v2</b></font>. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>V</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v</b></font> indicate the volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DP</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dp</b></font> indicate detached plexes, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SS</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ss</b></font> indicate snapshot plexes. </font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446146"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#&nbsp;vxassist&nbsp;-g&nbsp;mydg&nbsp;snapprint&nbsp;v1</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446159"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">V&nbsp;&nbsp;NAME&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;USETYPE&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LENGTH</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446167"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">SS&nbsp;SNAPOBJ&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NAME&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LENGTH&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;%DIRTY</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446175"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">DP&nbsp;NAME&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VOLUME&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LENGTH&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;%DIRTY</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446188"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">v&nbsp;&nbsp;v1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fsgen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446196"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">ss&nbsp;SNAP-v1_snp&nbsp;&nbsp;SNAP-v1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446204"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">dp&nbsp;v1-01&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;v1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446212"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">dp&nbsp;v1-02&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;v1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446225"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">v&nbsp;&nbsp;SNAP-v1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fsgen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446233"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">ss&nbsp;v1_snp&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;v1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446246"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#&nbsp;vxassist&nbsp;-g&nbsp;mydg&nbsp;snapprint&nbsp;v2</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446259"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">V&nbsp;&nbsp;NAME&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;USETYPE&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LENGTH</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446267"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">SS&nbsp;SNAPOBJ&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NAME&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LENGTH&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;%DIRTY</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446275"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">DP&nbsp;NAME&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VOLUME&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LENGTH&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;%DIRTY</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446288"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">v&nbsp;&nbsp;v2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fsgen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446296"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">ss&nbsp;--&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SNAP-v2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446304"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">dp&nbsp;v2-01&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;v2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446317"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">v&nbsp;&nbsp;SNAP-v2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fsgen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446325"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">ss&nbsp;--&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;v2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;20480&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446342"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font></font>
</p>
<p>
<a name="460355"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Creates a new volume by taking one or more attached temporary mirrors (with state SNAPDONE) to use as its plexes. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font><em>number</em> attribute can be used to specify the number of mirrors in a snapshot volume. At least <em>number</em> SNAPDONE plexes must be available in the original volume. By default, one plex is used if <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirrors</b></font> is not specified. </font>
</p>
<p>
<a name="425736"></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>comment</b></font> attribute may also be used to set the comment field for the snapshot volume. </font>
</p>
<p>
<a name="425739"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The following are examples of the use of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment</b></font> attributes: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446521"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;snapshot&nbsp;nmirror=2&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="446529"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">comment=&quot;mirrored&nbsp;snapvol&nbsp;for&nbsp;myvol&quot;&nbsp;myvol&nbsp;snapvol</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425751"></a>Some usage types attempt to synchronize any in-memory data associated with the volume (such as unwritten file system modifications) when the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font> operation is done. In particular, if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font> usage type is used with a volume containing a VERITAS File System (VxFS), then cooperating procedures ensure that all file system data is consistently flushed to the volume. For <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>hfs</b></font> and other file system types, the synchronization operation calls <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sync</b></font>. This makes the snapshot a better image, but it may leave some inconsistencies between in-memory file system data and the data residing on the backup image. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425764"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font> command accepts more than one volume. All the given volumes are split atomically (in a single transaction). That is, all the given volumes are relatively consistent as a result of taking the snapshot. If you specify the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o allvols </b></font>option without giving any volume names, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> attempts to create a sufficiently long <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> command to take a snapshot of all the volumes in the disk group. You can use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o name=</b></font><em>pattern</em> option to specify a name for the new volume. Otherwise, the default name assigned to the new volume has the form <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAP%d-%v</b></font>. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="446841"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font></font>
</p>
<p>
<a name="460446"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Creates a plex and attaches it to the named volume as a snapshot mirror. When the attach completes, the plex has state SNAPDONE and is a candidate for selection by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font> operation. Attributes can be specified to indicate the desired properties of the snapshot mirror. </font>
</p>
<p>
<a name="425783"></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>nmirror=</b></font><em>number</em> attribute can be used to specify the number of snapshot plexes to be attached to a volume. By default, <em>number</em> is 1. </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="425787"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> For this command, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font><em>number</em> attribute is specified before the volume name. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<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="425790"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> To allow operation of the dynamic disk group split/join feature (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) for more information), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> attempts to avoid placing snapshot plexes on the same disks as the plexes of the original volume or the plexes of its associated DCO volume. This allocation policy may not succeed if there is insufficient disk space. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> then uses any other available space in the disk group. This may prevent certain disk group split or move operations if the snapshot plexes and their associated DCO plexes cannot be physically separated from the plexes of the original volume or the plexes of its DCO volume. To overcome this, you can use storage specifications to specify explicitly the disks on which the snapshot plexes are to be configured. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447145"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapwait</b></font></font>
</p>
<p>
<a name="460524"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Waits for an attached mirror to become available on a volume if a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font> mirror attach is done as a background task (such as using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-b</b></font> option). The operation exits when the snapshot is complete. Available snapshot plexes are flagged with state SNAPDONE. </font>
</p>
</ul>
</p>
</ul>
</p>
</ul>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="447212"></a> OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447218"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-b</b></font></font>
</p>
<p>
<a name="460591"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Performs extended operations in the background. This option applies to plex consistency recovery operations for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growto</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>growby</b></font>, to plex attach operations started by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font>, to relayout operations started by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font>, and to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addlog</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>convert</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxgrow</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxsize</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>move </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>remove </b></font>operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447405"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font> <em>defaults</em></font>
</p>
<p>
<a name="460618"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a file containing defaults for various attributes related to volume creation and space allocation. If not specified, this defaults to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxassist</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447472"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font></font>
</p>
<p>
<a name="460641"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Forces operations not usually allowed by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447503"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em></font>
</p>
<p>
<a name="460676"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the disk group for the operation, either by disk group ID or by disk group name. If this option is not specified, and an alternate default disk group is not defined by specifying the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskgroup</b></font> attribute on the command line or in a defaults file (usually <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxassist</b></font>), the default disk group is determined using the rules given in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) manual page. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447606"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n</b></font></font>
</p>
<p>
<a name="460695"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prevents the system defaults file being read. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447625"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> <em>useopt</em></font>
</p>
<p>
<a name="460718"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Passes in options specific to a usage type to the operation. A certain set of operations are expected to be implemented by all usage types: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447656"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>allplexes</b></font></font>
</p>
<p>
<a name="460741"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that all available snapshot plexes in a disk group are to be reattached to their original volume during a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font> operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447687"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>allvols</b></font></font>
</p>
<p>
<a name="460760"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Takes a snapshot of all the volumes in the disk group. An error results if one or more volumes do not have a plex that is usable for the snapshot. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447731"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iosize=</b></font><em>size</em></font>
</p>
<p>
<a name="460791"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Performs copy and recovery operations in regions with the length specified by <em>size</em>, which is a standard VERITAS Volume Manager length number (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M)). Specifying a larger number typically causes the operation to complete sooner, but with greater impact on other processes using the volume. The default I/O size is 1 megabyte. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447798"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>name=</b></font><em>pattern</em></font>
</p>
<p>
<a name="460814"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the template for naming new snapshot volumes. The pattern consists of characters and one or more of the following specifiers: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447842"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%%</b></font></font>
</p>
<p>
<a name="460833"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Single percent character. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447861"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%d</b></font></font>
</p>
<p>
<a name="460852"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Unique serialization number expressed as a decimal integer. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447893"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%g</b></font> </font>
</p>
<p>
<a name="460871"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Disk group name. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447912"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%m</b></font> </font>
</p>
<p>
<a name="460890"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Mirror's original name. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447931"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%s</b></font></font>
</p>
<p>
<a name="460909"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Serialization string expressed as a sequence of one or more lower case letters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447962"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%S</b></font> </font>
</p>
<p>
<a name="460928"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Serialization string expressed as a sequence of one or more upper case letters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="447993"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%v</b></font> </font>
</p>
<p>
<a name="460947"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Volume name. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448013"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%x</b></font></font>
</p>
<p>
<a name="460966"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Unique serialization number expressed as a lower-case hexadecimal integer. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448045"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%X</b></font> </font>
</p>
<p>
<a name="460985"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Unique serialization number expressed as an upper case hexadecimal integer. </font>
</p>
<p>
<a name="448077"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The default template name for a new snapshot volume is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAP%d-%v</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448084"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>numchild=</b></font><em>number</em></font>
</p>
<p>
<a name="461032"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of child processes that are used to perform resynchronization during a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font> operation. The default value of <em>number</em> is 1 (no child processes), which is the same as specifying a <em>number</em> of 0. Specifying a larger value for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>number </b></font>potentially speeds up resynchronization, although the effectiveness of this depends to some extent on the underlying characteristics of the disk array. No further benefit in performance may be noticeable for a value for <em>number</em> greater than 3. </font>
</p>
<p>
<a name="425926"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">By default, the child processes divide the volume into equally sized chunks, which they then resynchronize independently with the volume. This behavior may be modified using the <em>useopt</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sequential</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="425930"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> A large <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iosize</b></font> of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>1m</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>2m</b></font> is recommended for use with this option. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448285"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ordered</b></font></font>
</p>
<p>
<a name="461086"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that ordered allocation should be used to create a new volume. For more information, see the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Ordered Allocation</b></font> section below. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448316"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>readonly</b></font></font>
</p>
<p>
<a name="461109"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that a read-only replica volume is created during a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448347"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>renamesnapplex</b></font></font>
</p>
<p>
<a name="461132"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that a snapshot plex is renamed when the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font> operation is used to create a snapshot volume. If this option is not specified, the plex retains the same name that it had in the original volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448402"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resyncfromoriginal</b></font></font>
</p>
<p>
<a name="461155"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Performs a resync using the data in the original volume during a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448433"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resyncfromreplica</b></font></font>
</p>
<p>
<a name="461178"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Performs a resync using the data in the snap plex during a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448464"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sequential</b></font></font>
</p>
<p>
<a name="461209"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When specified with the <em>useopt</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>numchild </b></font>for values of <em>number</em> greater than 1, the child processes co-operate in resynchronizing regions of the volume that are close together, starting at the beginning of the volume and moving to the end. This creates more overhead for the resynchronization, but it potentially makes better use of the sequential read-ahead buffer of the physical disks. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448555"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>slow</b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>=</b></font><em>iodelay</em>]</font>
</p>
<p>
<a name="461240"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Reduces the impact on system performance of copy operations. Copy and plex consistency recovery operations are usually a set of short operations on small regions of the volume (typically 1 megabyte). This option inserts a delay between the recovery of each such region. A specific delay can be specified with <em>iodelay</em> as a number of milliseconds, or a default is chosen (normally 250 milliseconds). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448646"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-p</b></font></font>
</p>
<p>
<a name="461267"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prints only the maximum size with no text wrappers (used with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxsize</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxgrow</b></font>). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448677"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r</b></font></font>
</p>
<p>
<a name="461286"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Includes spare disks (reserved for hot-relocation) in the calculation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448696"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font> <em>tasktag</em></font>
</p>
<p>
<a name="461325"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Marks any tasks that are registered to track the progress of an operation with the tag <em>tasktag</em>. This option is passed to utilities called by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font>, so any child tasks are also tagged with <em>tasktag</em>. The tag specified by <em>tasktag</em> is a sequence of up to 16 alphanumeric characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448775"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U</b></font> <em>usetype</em></font>
</p>
<p>
<a name="461348"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Limits the operation to volumes that have this usage type. Any attempt to operate on volumes that have a different usage type fails. </font>
</p>
<p>
<a name="425993"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation, this option specifies the usage type of the volume to be created. Otherwise, the default usage type set in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxassist</b></font> file is used, or if such an entry does not exist, the usage type is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448861"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v</b></font></font>
</p>
<p>
<a name="461386"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Traces calls to other utilities to determine which VERITAS Volume Manager commands <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> is executing. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="448903"></a> HARDWARE-SPECIFIC OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448908"></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 volumes or allocating space for volumes. By default, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> only creates volumes that conform with these guidelines. The following options change the behavior of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> operations <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>grow</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shrink</b></font> : </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="448987"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o override</b></font></font>
</p>
<p>
<a name="461433"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Performs the specified <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> task for the specified volume 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 and any associated software that exploit storage-specific features. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449054"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o verify</b></font></font>
</p>
<p>
<a name="461460"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Verifies that the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> task for the specified volume can be performed without violating any storage-specific guidelines, but does not commit or perform any task.  If any guidelines are violated, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</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="426024"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> These options need a separate license. Without the license, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</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="449139"></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="449157"></a> ATTRIBUTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449162"></a>Attribute values for various purposes can be specified with arguments of the form <em>attribute=value</em>. Attributes can also be passed in through a defaults file. Default attribute values can be stored in the file <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxassist</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449204"></a>Attributes are selected according to the order in which they are scanned. In general they are taken in decreasing priority of being specified on: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449223"></a>1. </font>
</p>
<p>
<a name="461499"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The command line. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449242"></a>2. </font>
</p>
<p>
<a name="461518"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The specified defaults file (as supplied with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font> command line argument). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449273"></a>3.</font>
</p>
<p>
<a name="461537"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The system defaults file (as specified in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxassist</b></font>). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449303"></a>Attributes from all sources have the same form. However, in some cases, command-line attributes change default behaviors in ways that attributes in the defaults file do not. In particular, references to mirroring (such as specifying a mirror count) or logging (such as specifying a log count or length) on the command line cause mirroring or logging to happen by default. If such attributes are specified in a defaults file, they indicate the attributes that would be used if mirroring or logging were enabled. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449393"></a>Attributes are either storage specifications (possibly negated), or are in the form <em>attribute=value</em>. In a defaults file, attributes are separated by a space or are on separate lines. Blank lines in a defaults file are ignored, and comments can be included with the standard <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>#</b></font> convention. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="449447"></a> STORAGE SPECIFICATIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449452"></a>Storage specification attributes have one of the following forms: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449459"></a>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font>]<em>diskname</em></font>
</p>
<p>
<a name="461576"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies (or excludes) a disk. <em>diskname</em> refers to a disk media record name in a VERITAS Volume Manager disk group. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449490"></a>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>!</b></font>]<em>diskclass</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>:</b></font><em>instance</em></font>
</p>
<p>
<a name="461623"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies (or excludes) a set of disks. <em>diskclass</em> names a particular type of disk grouping (for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ctlr</b></font> to indicate groups of disks on a single controller), and <em>instance</em> specifies which grouping of that type (for example <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c1</b></font>). Each type of disk class has a particular format for specifying instances of the class. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449581"></a><em>diskclass</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>:same</b></font></font>
</p>
<p>
<a name="461650"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that the allocation must be constrained to include disks from the same instance of the given class. For example, a storage specification of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskparam:same</b></font> indicates that all disks selected must have the same basic parameters (tracksize, cylinder size, size, and revolutions-per-minute), but does not specify which specific parameters to use. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449659"></a>The defined disk classes (and alternate names, or aliases, for those classes) are as follows: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449678"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ctlr</b></font> (alias: <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>ctrl</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cntrl</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>controller</b></font>)</font>
</p>
<p>
<a name="461685"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies disks accessible through a controller group. All disks accessible through the specified controller name(c#) are selected for the operation. </font>
</p>
<p>
<a name="426097"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For example, consider a configuration where two enclosures are connected to a host. The first through controllers c1, c2 and the second through controllers c3, c4. The command: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="449780"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;make&nbsp;vol1&nbsp;1024&nbsp;!ctlr:c1</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="426109"></a>results in disks from the first enclosure being excluded from the operation because all disks in the first enclosure are accessible through c1(and c2). The command: </font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="449856"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;make&nbsp;vol1&nbsp;1024&nbsp;!ctlr:c2</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="426121"></a>has the same effect (of excluding disks in the first enclosure) in the above configuration. The command: </font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="449920"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;make&nbsp;vol1&nbsp;1024&nbsp;layout=mirror&nbsp;nmirror=2&nbsp;mirror=ctlr</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="426132"></a>results in the mirrors being placed across the controller groups c1, c2 and c3, c4. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="449968"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>da</b></font></font>
</p>
<p>
<a name="461733"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a VERITAS Volume Manager disk (VM disk) by device name (disk access record name). For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c2t1d0</b></font> indicates a VM disk defined on disk <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c2t1d0</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450011"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>device</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>d</b></font>)</font>
</p>
<p>
<a name="461780"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies all VM disks on a physical disk. The physical disk is specified in the form <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>d</b></font><em>#</em>, which indicates the controller, target ID, and disk number. Typically, only one VM disk device is created for each physical disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450092"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskrpm</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rpm</b></font>)</font>
</p>
<p>
<a name="461807"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies disks with a given rotation speed in revolutions per minute (for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>7200</b></font>). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450123"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk</b></font>)</font>
</p>
<p>
<a name="461838"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a VM disk by disk name (disk media record name) in the disk group of the volume. Specifying a disk class type of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk</b></font> is equivalent to giving a storage specification with no disk class name. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450178"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enclr</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>e</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enclr</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enclosure</b></font>)</font>
</p>
<p>
<a name="461869"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies disks belonging to a particular enclosure. The enclosure name is obtained using the command: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="450225"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxdmpadm&nbsp;listenclosure&nbsp;all</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="426170"></a>For example, the following command excludes disks in the enclosure <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enc1</b></font> from the operation. </font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="450289"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;make&nbsp;vol1&nbsp;1024&nbsp;layout=mirror&nbsp;nmirror=2&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="450297"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;!enclr:enc1</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450314"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>target</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t</b></font>)</font>
</p>
<p>
<a name="461928"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies disks with the same SCSI target address on the same controller. The target is specified in the form <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t</b></font><em>#</em>. For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t:c2t4</b></font> selects disks on target 4 of controller 2. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="450356"></a> OTHER ATTRIBUTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450361"></a>Other attributes are of the form <em>attribute=value</em>. The <em>attribute</em> name in an attribute value pair never contains a colon, so it is possible to specify a disk that has an equal sign in its name using the storage specification <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm:disk01=a</b></font>. Without the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dm:</b></font> prefix, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk01=a</b></font> would cause an error indicating an unrecognized attribute. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450440"></a>Defined attributes (and common aliases) are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450447"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc=</b></font><em>storage-spec</em>[,<em>storage-spec</em>,...]</font>
</p>
<p>
<a name="461977"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies disks with the same SCSI target address on the same controller. The target is specified in the form <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c</b></font><em>#</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t</b></font><em>#</em>. For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t:c2t4</b></font> selects disks on target 4 of controller 2. </font>
</p>
<p>
<a name="426199"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies storage as single attributes. This is useful in a defaults file, so that all attributes (including storage specifications) are in the <em>attribute=value</em> format. Any number of storage specifications can be specified, separated by commas. More than one <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc</b></font> attribute can be specified, in which case they are logically concatenated to form one longer list. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450545"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>col_switch=</b></font><em>size1</em>,<em>size2</em>[,...]</font>
</p>
<p>
<a name="462039"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When creating a volume using ordered allocation (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o ordered</b></font>), specifies how much space to allocate from each listed disk to a concatenated column before switching to the next disk. The number of <em>size</em> arguments (<em>switch points</em>) determines how many disks are concatenated to form a column. <em>size1</em> space is allocated from the first disk, <em>size2 </em>space is then allocated from the second disk, and so on. The switch points are applied identically to all columns in the volume being created. </font>
</p>
<p>
<a name="426219"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For more information, see the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Ordered Allocation</b></font> section below. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450692"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment=</b></font><em>comment</em></font>
</p>
<p>
<a name="462085"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a comment to give to a volume when it is created. This comment can be displayed with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint -l</b></font>, and can be changed, at a later time, with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit set</b></font>. This attribute can be used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font> operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450747"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcolen=</b></font><em>number</em> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcologlen</b></font>)</font>
</p>
<p>
<a name="462112"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the length of each plex in a version 0 DCO volume. By default, specifying a length on the command line creates a DCO volume. The default length is 132 blocks, and any specified value should be an integral multiple of 33 blocks between 33 and 2112 blocks. </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="426233"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The actual length may be rounded up to the value of the disk group alignment (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M)). 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450833"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcoversion=0</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>20</b></font></font>
</p>
<p>
<a name="462151"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the type of DCO and DCO volume to be created for a volume when using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> command. A version 0 DCO supports Persistent FastResync. A version 20 DCO supports Persistent FastResync, instant snapshots, and DRL and sequential DRL logs within the DCO volume. If not specified, the default DCO version is 0. </font>
</p>
<p>
<a name="426243"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Creating a version 20 DCO associates a DCO object with a volume, and associates a DCO volume with the DCO object. When created for a non-layered volume with at least 2 data plexes or for any layered volume, the default DCO volume has 2 DCO plexes (mirrors for redundancy) with a default region size of 64KB. A different region size can be specified by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionsz</b></font> attribute. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="450991"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskgroup=</b></font><em>disk-group</em> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dg</b></font>)</font>
</p>
<p>
<a name="462183"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the type of DCO and DCO volume to be created for a volume when using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> command. A version 0 DCO supports Persistent FastResync. A version 20 DCO supports Persistent FastResync, instant snapshots, and DRL and sequential DRL logs within the DCO volume. If not specified, the default DCO version is 0. </font>
</p>
<p>
<a name="426253"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the disk group for an operation. If a disk group is specified in a defaults file, then it just specifies the default disk group to use for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation, if no other means of determining the disk group can be used. If specified as a command line attribute, it has the same effect as specifying a disk group with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> option (the operation is forced to apply to the given disk group). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451077"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>excl=yes|y|on|true|no|n|off|false</b></font></font>
</p>
<p>
<a name="462225"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sets or clears the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EXCLUSIVE</b></font> flag on the volume. A volume in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>exclusive open</b></font> state can be opened by only one node in the cluster at a time. Multiple opens of an exclusive volume from the same node are permitted. Non-exclusive volumes can be simultaneously opened by more than one node. After a node opens an exclusive volume, every other node's open attempt fails until the last close of the volume by the first opener. Such an open failure returns a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EBUSY</b></font> error code. </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="426270"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Only available if the VERITAS Volume Manager cluster feature is enabled. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451199"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fastresync=yes|y|on|true|no|n|off|false</b></font> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fmr</b></font>)</font>
</p>
<p>
<a name="462256"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Enables or disables both Persistent and Non_Persistent FastResync. If enabled, FastResync is non-persistent if a DCO object and a DCO volume are not associated with a volume, and it is persistent if a DCO object and DCO volume are associated with a volume. </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="426278"></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 FastResync feature. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451273"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fstype=</b></font><em>file-system-type</em></font>
</p>
<p>
<a name="462303"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the file system type for a new volume (this is used only with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation). The file system type for a volume is usually determined when needed by running the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fstyp</b></font> utility (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fstyp</b></font>(1M)), but can be specified explicitly. The file system type parameter is used with the VERITAS Volume Manager <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxresize</b></font> utility, as well as with volume snapshots, copies, and dissociates (to select features that are used with VERITAS File System (VxFS)). </font>
</p>
<p>
<a name="426291"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The file system type can be changed at any later time with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit set</b></font> operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451419"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>group=</b></font><em>owning-group</em></font>
</p>
<p>
<a name="462337"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sets the group ID for a new volume. The group ID can be specified numerically or with a system group name. This attribute is used only with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation. By default, volumes are created with group 0. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451474"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init=</b></font><em>initialization-type</em></font>
</p>
<p>
<a name="462376"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies how to initialize a new volume. The default method (which can be selected explicitly with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init=default</b></font>) is to call <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol start</b></font> to perform a default initialization that is specific to a usage type. A new volume can be left uninitialized with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init=none</b></font>. The most useful non-default initialization that can be specified is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init=zero</b></font>, to clear the volume before enabling it for general use. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451577"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout=</b></font><em>layout-spec</em>[,<em>layout-spec</em>,...]</font>
</p>
<p>
<a name="462407"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a plex layout type (RAID-5, mirrored, unmirrored, striped, cylinder alignment), and turn some features on and off (such as logging). The list of layout specifications is given in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Layout Specifications</b></font> section. By default, unmirrored, non-striped volumes are created without a log. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451644"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logdisk=</b></font><em>disk</em>[,<em>disk</em>,...]</font>
</p>
<p>
<a name="462446"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When creating volumes using ordered allocation (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o ordered</b></font>), specifies on which disks logs should be created. This attribute must be specified for RAID-5 volumes unless <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nolog </b></font>or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>noraid5log</b></font> is specified. For other types of volume layout, this attribute is optional, and if not specified any required logs are co-located with the data. </font>
</p>
<p>
<a name="426325"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For more information, see the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Ordered Allocation</b></font> section below. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451742"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>loglen=</b></font><em>length</em></font>
</p>
<p>
<a name="462476"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a log length to use for dirty-region log (DRL) subdisks for mirrored volumes, for RAID-5 log plexes, or for DCM log plexes for replicated volumes. By default, specifying a log length on the command line creates a log. Associating a log with a mirrored or RAID-5 volume is sufficient to enable its use. </font>
</p>
<p>
<a name="426335"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A DCM log must be enabled using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrlink</b></font> command. This is because it is used for failure recovery and synchronization of replicated volumes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451864"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logtype=</b></font><em>type</em></font>
</p>
<p>
<a name="462506"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the type of log to use with a mirrored or replicated volume: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451883"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcm</b></font></font>
</p>
<p>
<a name="462525"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Select DCM (data change map). This is the default log type for replicated volumes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="451914"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dco</b></font></font>
</p>
<p>
<a name="462576"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Select DCO (data change object). (This is used to implement Persistent FastResync, which is enabled by additionally specifying <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fastresync=on</b></font>.) This creates a DCO object and a DCO volume with a plex size specified by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcologlen</b></font> attribute, and number of plexes specified using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcomirror</b></font> attribute. The default names for the DCO object and DCO volume are <em>vol</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>_dco</b></font> and <em>vol</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>_dcl </b></font>respectively for a volume, <em>vol</em>. </font>
</p>
<p>
<a name="426357"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If additional logging is required, it can be added to a volume by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist addlog</b></font> command. DCO can co-exist with DCM logging for replicated volumes, or with DRL logging for mirrored volumes. </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="426362"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Additional version 20 DCO maps can be added by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap addmap</b></font> command. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452103"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>drl</b></font></font>
</p>
<p>
<a name="462614"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Select DRL (dirty region logging). This is the default log type for mirrored volumes. </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="426369"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> For volumes with version 20 DCOs, DRL is supported within the DCO volume itself. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452165"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>drlseq</b></font></font>
</p>
<p>
<a name="462649"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Select sequential dirty region logging. This is identical to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>drl</b></font> except that the number of dirty bits that can be set in the DRL is limited to the value of the tunable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>voldrl_max_seq_dirty</b></font> (default value is 3). This is useful on volumes that are usually written to sequentially, such as database log volumes. Limiting the number of dirty regions allows for faster recovery if a crash occurs. However, if applied to volumes that are written to randomly, this type of logging can be a performance bottleneck as it limits the number of parallel writes that can be carried out. </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="426384"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> For volumes with version 20 DCOs, sequential DRL is supported within the DCO volume itself. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452323"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>none</b></font></font>
</p>
<p>
<a name="462676"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Do not create a log. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452342"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>region</b></font></font>
</p>
<p>
<a name="462699"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Select dirty region logging; identical to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>drl</b></font>. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="426395"></a>RAID-5 logging is automatically selected when a log plex is added to a RAID-5 volume; it has no specific <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logtype</b></font>. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="426398"></a>If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logtype</b></font> is not specified for a volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>attempts to create the optimal type of log. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452435"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logmap_len=</b></font><em>size</em></font>
</p>
<p>
<a name="462742"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the maximum usable size in bytes of a DRL log to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addlog</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operations. This value is not constrained by any disk group alignment value. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452478"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>max_nraid5column=</b></font><em>number</em> </font>
</p>
<p>
<a name="462793"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxraid5columns</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>max_nraidcolumn</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>max_nraid5stripe</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>max_nraidstripe</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxraidcolumns</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxraid5stripes</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxraidstripes</b></font>) </font>
</p>
<p>
<a name="426409"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the default maximum number of stripe columns for a RAID-5 volume (default value is 8). The rules for selecting the default number of RAID-5 stripe columns are described in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nstripe</b></font> attribute. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452540"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>max_ncolumn=</b></font><em>number</em> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxcolumns</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>max_nstripe</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxstripes</b></font>)</font>
</p>
<p>
<a name="462843"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the default maximum number of stripe columns, either for a RAID-5 volume (if <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>max_nraid5stripe</b></font> is not also specified) or for a striped plex (default value is 8). The rules for selecting the default number of stripe columns is described in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nstripe</b></font> attribute. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452595"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>max_regionloglen=</b></font><em>length</em> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxregionloglen</b></font>)</font>
</p>
<p>
<a name="462878"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the maximum default dirty region logging log subdisk length. If the user does not specify the dirty region log length for a volume, when creating the first log for a mirrored volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> uses a simple formula based on the log length. The default length is not be bounded by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>max_regionloglen</b></font> (default value is 32k (32 kilobytes)). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452662"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>min_ncolumn=</b></font><em>number</em> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mincolumns</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>min_nstripe</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>minstripes</b></font>)</font>
</p>
<p>
<a name="462917"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the default minimum number of stripe columns for either a RAID-5 volume (if <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>min_nraid5stripe</b></font> is not also specified) or for a striped plex (default value is 2). The policy for selecting a default number of stripe columns is not allowed to select fewer than this number of columns. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452729"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>min_nraid5column=</b></font><em>number</em></font>
</p>
<p>
<a name="462968"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>minraid5columns</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>min_nraidcolumn</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>min_nraid5stripe</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>min_nraidstripe</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>minraidcolumns</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>minraid5stripes</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>minraidstripes</b></font>) </font>
</p>
<p>
<a name="426436"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the default minimum number of stripe columns for a RAID-5 volume (default value is 3). The policy for selecting a default number of RAID-5 stripe columns is not allowed to create a RAID-5 volume with fewer than <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>min_nraid5stripe</b></font> stripe columns. </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="426441"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> It is notionally possible to create a RAID-5 volume with 2 columns in VxVM. This is effectively a 2-way mirror with reads directed to alternate stripe units on the two columns. This can improve read performance over that of a unstriped 2-way mirror. However, such a layout is usually much more inefficient in CPU usage when writing to the volume and is not generally recommended. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="452906"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror=</b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font>]<em>number</em>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>|<em>diskclass</em>[,...]</font>
</p>
<p>
<a name="463050"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies various mirroring parameters. Multiple mirroring parameters can be given, each separated by a comma. A decimal number indicates a specific number of mirrors to create, when creating a mirrored volume (equivalent to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font><em>number</em>). <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font> indicates that volumes should be mirrored by default (equivalent to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout=mirror</b></font>). <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font> indicates that volumes should be unmirrored by default (equivalent to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout=nomirror</b></font>). </font>
</p>
<p>
<a name="426459"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Any other mirroring parameters specify that volumes should be mirrored across instances of a particular disk class (such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>enclr</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ctlr</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>target</b></font>). For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror=target</b></font> specifies that volumes should be mirrored between SCSI target addresses, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror=ctlr</b></font> specifies that disks in a mirror should not be on the same controller as disks in other mirrors within the same volume. Similarly, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror=enclr</b></font> specifies that disks in a mirror should not be from the same enclosure as disks in other mirrors within the same volume. </font>
</p>
<p>
<a name="426472"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each mirror can contain disks from any number of instances of the disk class, but different mirrors cannot use disks from the same instance of the disk class. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453191"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirrorconfine=</b></font><em>diskclass</em>[,<em>diskclass,...</em>]</font>
</p>
<p>
<a name="463107"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a required list of disk classes for mirror confinement constraints. If this attribute is specified, a single mirror is confined to (that is, allocated from) a group of disks belonging to a specific disk class. Multiple mirrors can be allocated from a single disk class. Multiple disk classes cannot be used to allocate a mirror. The following example specifies that each mirror is allocated from devices belonging to a single SCSI target; and multiple mirrors can be allocated from devices belonging to a single SCSI target: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="453346"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">mirrorconfine=scsi_target</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453363"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mode=</b></font><em>permissions</em></font>
</p>
<p>
<a name="463144"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the permissions for the block and character device nodes created for a new volume. The mode can be specified either as an octal number or symbolically. A symbolic mode is specified using the syntax given in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>chmod</b></font>(1). This attribute is used only with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation. The default mode for a volume gives read and write access only to the owner. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453442"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcmlog=</b></font><em>number</em> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcmlogs</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcms</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcm</b></font>)</font>
</p>
<p>
<a name="463179"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of DCM log plexes to create. The default number is 2 which creates a mirrored DCM log. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453473"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcomirror=</b></font><em>number</em> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndco</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcos</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcolog</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcologs</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcomirrors</b></font>)</font>
</p>
<p>
<a name="463226"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of DCO plexes to create for a DCO volume. A value for <em>number</em> of 2 or greater creates a mirrored DCO volume. For non-layered volumes, the default number is set to the lesser of the number of data plexes in the parent volume or 2. For layered volumes, the default number is set to 2. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453540"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nlog=</b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font>]<em>number</em>, (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nlogs</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>logs</b></font>)</font>
</p>
<p>
<a name="463277"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of logs to create, by default, for a RAID-5, mirrored, or replicated volume (assuming that logs are to be created). The number of logs to create can be specified independently for RAID-5 or mirrored volumes using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nraid5log</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nregionlog</b></font> attributes. For a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font>, this value can be preceded by a + or a - to add or subtract logs. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453619"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font>]<em>number</em>, (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirrors</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirrors</b></font>)</font>
</p>
<p>
<a name="463316"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of mirrors to create when mirroring a volume (default value is 2). </font>
</p>
<p>
<a name="426529"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font>, this value can be preceded by a + or a - to add or subtract mirrors. The value can also be specified as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>src_nmirror</b></font> to preserve the number of mirrors. </font>
</p>
<p>
<a name="426533"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This attribute is also used to specify the number of snapshot plexes to be attached to a volume by a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font> operation, and the number of plexes in a snapshot volume for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font> operations. For a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font>, there must be <em>number</em> SNAPDONE plexes available in the original volume. For a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font>, there must be <em>number</em> snapshot plexes available in the snapshot volume (which must also be in the same disk group as the original volume). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453832"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nraid5log=</b></font><em>number</em></font>
</p>
<p>
<a name="463401"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nraid5logs</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5logs</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nraidlog</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nraidlogs</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raidlogs</b></font>) </font>
</p>
<p>
<a name="426548"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of log plexes to create for a new RAID-5 volume (default value is 1). This attribute is used only with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453894"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nraid5stripe=</b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font>]<em>number</em></font>
</p>
<p>
<a name="463467"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5stripes</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nraid5column</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nraidstripe</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raidstripes</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raidcolumns</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nraidcolumn</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5columns</b></font>) </font>
</p>
<p>
<a name="426555"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of stripe columns to use when creating a new RAID-5 volume (the default is to adjust the number to available disks). This attribute is used only with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font> operations. For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font> operation, the default is the same number of stripe columns the volume has. For a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font>, this value can be preceded by a + or a - to add or subtract columns. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="453992"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nregionlog=</b></font><em>number</em> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nregionlogs</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionlogs</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndrl</b></font>)</font>
</p>
<p>
<a name="463525"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of log subdisks to create for a new mirrored volume (default value 1). This attribute is used only with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make </b></font>operation, and only if logging is requested for the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454035"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nstripe=</b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font>]<em>number</em></font>
</p>
<p>
<a name="463584"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripes</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ncolumn</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ncolumns</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ncol</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ncols</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>columns</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cols</b></font>) </font>
</p>
<p>
<a name="426570"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of stripe columns to use when creating a new RAID-5 volume (with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation) or when creating a striped plex (with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart </b></font>operations). The usual default behavior is to adjust to the number of available disks, but there are exceptions to this rule. </font>
</p>
<p>
<a name="426577"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When creating an unmirrored striped volume, the default behavior is to adjust to half the number of available disks. This allows for the subsequent addition of a mirror to the volume. (A volume that does not have data redundancy cannot recover from disk failure.) </font>
</p>
<p>
<a name="426582"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font> operations, the default behavior is to conserve the number of stripe columns in the volume. In such operations, the value of <em>number </em>can be preceded by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>+</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font> to specify a number of columns that are to be added or subtracted. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454255"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>probe_granularity=</b></font><em>size</em></font>
</p>
<p>
<a name="463656"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the granularity for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>maxsize</b></font> request. The default size value is 1 megabyte. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454286"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5_stripeunit=</b></font><em>width</em></font>
</p>
<p>
<a name="463723"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5_stwid</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5_st_width</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5_stwidth</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid_st_width</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid_stripeunitsize</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5_stripeunitsize</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5_stripeunitwidth</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid_stwid</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid_stwidth</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid_stripeunit</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid_stripeunitwidth</b></font>) </font>
</p>
<p>
<a name="426595"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the stripe unit size to use when creating a new RAID-5 volume (default value is 16k (16 kilobytes)). This attribute is used only with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make </b></font>operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454386"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5loglen=</b></font><em>length</em> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raidloglen</b></font>)</font>
</p>
<p>
<a name="463757"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the log length to use when adding the first log to a RAID-5 volume. The default is four times the full stripe width (the stripe unit size times the number of stripe columns). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454441"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionloglen=</b></font><em>length</em> (alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>drlloglen</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>drllen</b></font>)</font>
</p>
<p>
<a name="463788"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the log subdisk length to use when adding the first log subdisk to a mirrored volume. The default is chosen based on a formula involving the volume length. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454484"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionsz=</b></font><em>size</em></font>
</p>
<p>
<a name="463823"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the size of each region that is tracked by a bit in the maps within a version 20 DCO volume. The value of <em>size</em> must be a power of 2 and be greater than or equal to 16k (16KB). The default value is 64k (64KB). The region size must also be no greater than half the value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>voliomem_maxpool_sz</b></font> tunable. Otherwise, only a limited set of instant snapshot operations are permitted on the volume. For more information, see the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap</b></font>(1M) manual page. </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="426623"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The region size can only be specified for version 20 DCOs. It cannot be specified for version 0 DCOs. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454618"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>spare=no</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>only</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font></font>
</p>
<p>
<a name="463858"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Controls the use of spare disks when hot-relocation is performed. </font>
</p>
<p>
<a name="426629"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font>, spare disks are used. If necessary, free space is also used on disks that have been marked <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nohotuse=off</b></font>. This is the default behavior. </font>
</p>
<p>
<a name="426633"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>only</b></font>, relocation storage is allocated using only spare disks. </font>
</p>
<p>
<a name="426636"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>, spare disks are not used. Alternatively, do not mark any of your disks as spares and do not mark them as available for use by hot relocation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454754"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe=</b></font><em>diskclass</em>[,...]</font>
</p>
<p>
<a name="463910"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that volumes should be striped across instances of a particular disk class. For example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe=target</b></font> specifies that volumes should be striped between SCSI target addresses. Each column can contain disks from any number of instances of the disk class, but different columns cannot use disks from the same instance of the disk class. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454859"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-trigger-pt=</b></font><em>size</em></font>
</p>
<p>
<a name="463933"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a size that triggers the creation of a stripe-mirror volume. If the size of the volume is greater than the size specified in this attribute, then a stripe-mirror volume is created. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454914"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-split-trigger-pt=</b></font><em>size</em></font>
</p>
<p>
<a name="463956"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a size that triggers the creation of a stripe-mirror-sd volume. If the size of each column is greater than the size specified in this attribute, then a stripe-mirror-sd volume is created. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="454969"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe_stripeunit=</b></font><em>width</em></font>
</p>
<p>
<a name="463999"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe_stwid</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe_stwidth</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe_st_width</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe_stripeunitsize</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe_stripeunitwidth</b></font>) </font>
</p>
<p>
<a name="426665"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the stripe unit size to use when creating striped plexes to attach to a volume. When attaching a new plex, the default is to use the same stripe unit size as any other striped plexes in the volume. If the volume does not already contain striped plexes, the default value is 64k (64 kilobytes). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455055"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripeunit=</b></font><em>width</em></font>
</p>
<p>
<a name="464053"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">(alias: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stwid</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripewidth</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stwidth</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>st_width</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe_width</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripeunitsize</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripeunitwidth</b></font>) </font>
</p>
<p>
<a name="426674"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the stripe unit size to use for either a RAID-5 volume or for striped plexes. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripeunit</b></font> can be used to set the values for both <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5_stripeunit</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe_stripeunit</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455117"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tmpsize=</b></font><em>size</em></font>
</p>
<p>
<a name="464091"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the size of the temporary storage used to perform a relayout operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455148"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tmpalloc=</b></font><em>storage-spec</em>[,<em>storage-spec</em>,...]</font>
</p>
<p>
<a name="464122"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a set of storage specifications for the temporary storage required during a relayout operation. The format is the same as for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc</b></font> attribute (a comma-separated list of storage specifications). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455203"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>user=</b></font><em>owning-user</em></font>
</p>
<p>
<a name="464153"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the user ID for a new volume (default value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>root</b></font>). The user ID can be specified numerically or it can be a system login name. This attribute is used only with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455282"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>usetype=</b></font><em>volume-usage-type</em></font>
</p>
<p>
<a name="464192"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the usage type to use when creating a new volume (default value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5</b></font> for RAID-5 volumes; otherwise <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font>s the default). This attribute is only used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation. The usage type can also be specified using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U</b></font> option. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455361"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>wantalloc=</b></font><em>storage-spec</em>[,<em>storage-spec</em>,...]</font>
</p>
<p>
<a name="464225"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a set of desired storage specifications. This is useful in a defaults file to indicate desired storage specifications that should be discarded if they fail to yield a reasonable set of allocations. The format is the same as for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc</b></font> attribute (a comma-separated list of storage specifications). </font>
</p>
<p>
<a name="426713"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For example, a defaults file can name a specific controller type to use for allocations, if possible. When all disks on that type of controller are full, other controllers are used. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455496"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>wantmirror=</b></font><em>diskclass</em>[,<em>diskclass</em>,...]</font>
</p>
<p>
<a name="464255"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a desired list of disk class mirroring specifications. This is useful in a defaults file to indicate a set of desired mirroring constraints that can be dropped if they fail to yield a reasonable set of allocations. </font>
</p>
<p>
<a name="426723"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For example, a defaults file can specify that volumes should be mirrored between disks on different controllers in the system. The constraint is dropped if the set of volumes builds up in such a way that a new volume cannot be mirrored across controllers. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455618"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>wantmirrorconfine=</b></font><em>diskclass</em>[,<em>diskclass</em>,...]</font>
</p>
<p>
<a name="464285"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a list of disk classes for mirror confinement constraints. A single mirror is confined to (that is, allocated entirely from) a group of disks belonging to a single disk class. </font>
</p>
<p>
<a name="426735"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This is useful in a defaults file to indicate a set of mirror confinement constraints that can be dropped if they fail to yield a reasonable set of allocations. For example, a defaults file can specify that a single mirror be confined to disks of the same vendor: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="455754"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">wantmirrorconfine=vendor</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="426749"></a>If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> cannot allocate a mirror from disk devices of one vendor, this constraint is dropped and the mirror is allocated from disk devices of other vendors. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455814"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>wantstripe=</b></font><em>diskclass</em>[,<em>diskclass</em>,...]</font>
</p>
<p>
<a name="464325"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a desired list of disk class stripping specifications. This is useful in a defaults file to indicate a set of desired stripping constraints that can be dropped if they fail to yield a reasonable set of allocations. </font>
</p>
<p>
<a name="426759"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For example, a defaults file can specify that volumes should be striped between disks on different controllers in the system. The constraint is dropped if the set of volumes builds up in such a way that a new volume cannot be striped across controllers. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="455924"></a> LAYOUT SPECIFICATIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455929"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout</b></font> attribute specifies a comma-separated list of simple parameters (with no arguments) that apply to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>operations. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="455959"></a>Two new layouts were added in the 3.0 release of VxVM: stripe-mirror and concat-mirror. In previous releases, whenever mirroring was used, the mirroring had to happen above striping or concatenation. Now there can be mirroring both above and below striping and concatenation. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="456037"></a>Putting mirroring below striping mirrors each column of the stripe. If the stripe is large enough to have multiple subdisks per column, each subdisk can be individually mirrored. A similar concatenated volume would also mirror each subdisk individually. These new layouts enhance redundancy and reduce recovery time in case of an error. In a mirror-stripe layout, if a disk fails, the entire plex is detached, thereby losing redundancy on the entire volume. When the disk is replaced, the entire plex must be brought up to date. Recovering the entire plex can take a substantial amount of time. If a disk fails in a stripe-mirror layout, only the failing subdisk must be detached, and only that portion of the volume loses redundancy. When the disk is replaced, only a portion of the volume needs to be recovered. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="456247"></a>The new volume layouts are more complex than the older volume layouts. Because the advantages of recovery time and improved redundancy are more important for larger volumes, it is best to continue using mirror-stripe and mirror-concat for most volumes and only use stripe-mirror and concat-mirror for very large volumes. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="456337"></a>You can specify <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout=mirror-stripe</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout=stripe-mirror</b></font> to implement the desired layout. If you specify <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout=stripe,mirror</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>layout=mirror,stripe</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> automatically determines the best layout for the volume. Unless there is a reason to implement a particular layout, it is best to let <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> create the layout for each volume. Because the advantages of the new layouts are related to the size of the volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> creates the simplest configuration for smaller volumes and the more complex stripe-mirror for larger volumes. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="456451"></a>The attributes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-trigger-pt </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-split-trigger-pt</b></font> control the selection. They can be set in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxassist</b></font>. Volumes that are smaller than <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-trigger-pt</b></font> are created as mirror-stripe, and volumes that are larger are created as stripe-mirror. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> creates the stripe-mirror and the columns are larger than <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-split-trigger-pt</b></font>, the individual subdisks are mirrored instead of mirroring the columns of the stripe. By default, both of these attributes are set to one gigabyte. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="456617"></a>The disk group must be created on a 3.0 or later release to use the new layouts, but older disk groups can be updated. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg upgrade</b></font> command for more information on upgrading disk groups. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="456660"></a>Defined layout specifications are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="456667"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>concat-mirror</b></font></font>
</p>
<p>
<a name="464415"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that new volumes should be concatenated and mirrored. The mirroring is handled at each subdisk level. The attribute <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-split-trigger-pt </b></font>is applied. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="456722"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>contig</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nocontig</b></font></font>
</p>
<p>
<a name="464446"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Disallows or allows (default) plexes, regular stripe columns, or RAID-5 stripe columns from using multiple regions of disk. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>contig </b></font>is specified, then plexes and columns must be allocated from a single contiguous region of disk. If this is not possible, the allocation fails. By default, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> tries to allocate space contiguously, but it can use multiple regions or multiple disks if required. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="456813"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dgalign_checking=</b></font>{<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>round</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>strict</b></font>}</font>
</p>
<p>
<a name="464485"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Controls how <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> handles attributes that are subject to disk group alignment restrictions. If set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>strict</b></font>, the volume length and values of attributes must be integer multiples of the disk group alignment value. If set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>round</b></font> (default), attribute values are rounded up as required. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="456893"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskalign</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nodiskalign</b></font></font>
</p>
<p>
<a name="464508"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Aligns (default for all volumes except layered volumes) or does not align subdisks on cylinder boundaries. When alignment is not disabled, subdisks are created beginning on cylinder boundaries and are extended to match the end of a cylinder. Dirty region log subdisks, however, are not cylinder aligned (they are usually only 2 or 3 blocks long). Instead, when creating log subdisks, spaces are located from the available disks that could not be turned into regular subdisks because the spaces are not cylinder aligned. For example, once one cylinder is used for a log subdisk, that cylinder cannot be used to create an aligned data (or RAID-5 log) subdisk, so other log subdisks are created there until that cylinder fills up. </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="426875"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> always uses the disk group alignment value for EFI disks. If the value of the disk group alignment is greater than 1, specifying <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>diskalign</b></font> for EFI disks results in an error. The disk and cylinder alignment values for EFI disks are always set to 1. See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) for more information. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="426881"></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>diskalign</b></font> attribute is not supported for layered volumes (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>concat-mirror</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror</b></font>). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457143"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>grow</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nogrow</b></font></font>
</p>
<p>
<a name="464570"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Allows a volume to grow during a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font> operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457162"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>log</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nolog</b></font></font>
</p>
<p>
<a name="464601"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Creates (or does not create) dirty region logs (for mirrored volumes) or log plexes (for RAID-5 volumes) when creating a new volume. This attribute can be specified independently for mirrored and RAID-5 volumes with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5log</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionlog</b></font> layout specifications. The current implementation does not support the creation of DCM logs in the layout specification. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457241"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nomirror</b></font></font>
</p>
<p>
<a name="464636"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that new volumes should be mirrored or unmirrored (default) respectively. For <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font>, the attribute <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-split-trigger-pt </b></font>is applied, and the attribute <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-trigger-pt</b></font> is ignored. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457296"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror-concat</b></font></font>
</p>
<p>
<a name="464663"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that new volumes should be mirrored. The mirroring is done at the volume level. The attributes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-trigger-pt</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-split-trigger-pt</b></font> are ignored with this layout. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457351"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror-stripe</b></font></font>
</p>
<p>
<a name="464690"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that new volumes should be mirrored and striped. The mirroring is done at the volume level. The attributes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-trigger-pt</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-split-trigger-pt</b></font> are ignored with this layout. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457406"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5</b></font></font>
</p>
<p>
<a name="464709"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that new volumes should be RAID-5. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457425"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5log</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>noraid5log</b></font></font>
</p>
<p>
<a name="464732"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Creates (default) or does not create log plexes for RAID-5 volumes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457444"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionlog</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>noregionlog</b></font></font>
</p>
<p>
<a name="464755"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Creates or does not create (default) dirty-region log subdisks for mirrored volumes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457475"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>shrink</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>noshrink</b></font></font>
</p>
<p>
<a name="464782"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Allows or disallows shrinking of a volume during a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>relayout</b></font> operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457494"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>span</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nospan</b></font></font>
</p>
<p>
<a name="464809"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Allows (default) or disallows plexes, regular stripe columns, or RAID-5 stripe columns from spanning multiple disks. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nospan</b></font> is indicated, then plexes or columns can be formed from multiple regions of the same disk, but cannot be formed from more than one disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457549"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nostripe</b></font></font>
</p>
<p>
<a name="464860"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that new plexes should be striped or unstriped, respectively. When creating a new volume, the default is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nostripe</b></font>. When adding a new plex to an existing volume, the default is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe</b></font> if the volume already has one or more striped plexes, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nostripe </b></font>in other cases. For <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe</b></font> (when combined with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font>, the attributes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-trigger-pt</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-split-trigger-pt</b></font> are applied. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457652"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror</b></font></font>
</p>
<p>
<a name="464883"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that new volumes should be striped and mirrored. The mirroring is handled at each column level or subdisk level depending on the attribute <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-split-trigger-pt</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457707"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col</b></font></font>
</p>
<p>
<a name="464910"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that new volumes should be striped and mirrored. The mirroring is handled at each column level. The attributes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-trigger-pt</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-col-split-trigger-pt</b></font> are ignored with this layout. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457762"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stripe-mirror-sd</b></font></font>
</p>
<p>
<a name="464929"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that new volumes should be striped and mirrored. The mirroring is handled at each subdisk level. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="457804"></a> ORDERED ALLOCATION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457809"></a>If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o ordered</b></font> option is specified when creating a volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> uses the specified storage in the following order: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457828"></a>1.</font>
</p>
<p>
<a name="464952"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Concatenate disks. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457847"></a>2.</font>
</p>
<p>
<a name="464967"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Form columns. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457866"></a>3.</font>
</p>
<p>
<a name="464982"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Form mirrors. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457884"></a>For example, the following command creates a mirrored-stripe volume with 3 columns and 2 mirrors on 6 disks: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="457917"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;-o&nbsp;ordered&nbsp;make&nbsp;mirstrvol&nbsp;10g&nbsp;layout=mirror-stripe&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="457925"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;nstripe=3&nbsp;disk01&nbsp;disk02&nbsp;disk03&nbsp;disk04&nbsp;disk05&nbsp;disk06</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457941"></a>This command places columns 1, 2 and 3 of the first mirror on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk01</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk02</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk03</b></font> respectively, and columns 1, 2 and 3 of the second mirror on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk04</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk05</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk06</b></font> respectively. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="457984"></a>For layered volumes, the same rules are used to allocate storage as for non-layered volumes. For example, the following command creates a striped-mirror volume with 2 mirrored columns: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="458029"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;-o&nbsp;ordered&nbsp;make&nbsp;strmirvol&nbsp;10g&nbsp;layout=stripe-mirror&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="458037"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;nstripe=2&nbsp;disk01&nbsp;disk02&nbsp;disk03&nbsp;disk04</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="458053"></a>This command mirrors column 1 across <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk01</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk03</b></font>, and column 2 across <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk02</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk04</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="458071"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>col_switch</b></font> attribute can additionally be used to specify how space on the disks is to be concatenated into columns. For example, the following command creates a mirrored-stripe volume with 2 columns: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="458116"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;-o&nbsp;ordered&nbsp;make&nbsp;strmir2vol&nbsp;10g&nbsp;layout=mirror-stripe&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="458124"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;nstripe=2&nbsp;col_switch=3g,2g&nbsp;disk01&nbsp;disk02&nbsp;disk03&nbsp;disk04&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="458132"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;disk05&nbsp;disk06&nbsp;disk07&nbsp;disk08</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="458148"></a>This command allocates 3 gigabytes from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk01</b></font> and 2 gigabytes from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk02</b></font> to column 1, and 3 gigabytes from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk03</b></font> and 2 gigabytes from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk04</b></font> to column 2. The mirrors of these columns are then similarly formed from disks <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk05</b></font> through <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>disk08</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="458202"></a>Other storage specification classes for controllers, enclosures, targets and trays can be used with ordered allocation. For example, the following command creates a 3-column mirrored-stripe volume between specified controllers: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="458247"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;-o&nbsp;ordered&nbsp;make&nbsp;mirstr2vol&nbsp;10g&nbsp;layout=mirror-stripe&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="458255"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;nstripe=3&nbsp;ctlr:c1&nbsp;ctlr:c2&nbsp;ctlr:c3&nbsp;ctlr:c4&nbsp;ctlr:c5&nbsp;ctlr:c6</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="458271"></a>This command allocates space for column 1 from disks on controller <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c1</b></font>, for column 2 from disks on controller <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>c2</b></font>, and so on. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="458301"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="458307"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxassist</b></font></font>
</p>
<p>
<a name="465105"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">System default settings file for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> attributes. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="458325"></a> EXIT CODES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="458330"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> utility exits with a non-zero status if the attempted operation fails. A non-zero exit code is not a complete indicator of the problems encountered, but rather denotes the first condition that prevented further execution of the utility. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="458372"></a>See <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M) for a list of standard exit codes. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="458378"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="458383"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>chmod</b></font>(1), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fstyp</b></font>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sync</b></font>(1M), <a href="vxedit_vxvm_manpages41_434625.html#430530"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit </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="vxmake_vxvm_manpages50_437196.html#431699"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake </b></font></font></a>(1M), <a href="vxmend_vxvm_manpages52_430893.html#428626"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmend </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="vxrelayout_vxvm_manpages62_430115.html#428262"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout </b></font></font></a>(1M), <a href="vxresize_vxvm_manpages65_428209.html#427289"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxresize </b></font></font></a>(1M), <a href="vxsd_vxvm_manpages69_433542.html#429949"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd </b></font></font></a>(1M), <a href="vxsnap_vxvm_manpages72_441468.html#434380"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font></font></a>(1M), <a href="vxtask_vxvm_manpages76_430825.html#428703"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask </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="vxassist_vxvm_manpages14_458378.html" title="vxassist">Return to Top</a></font>

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