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

</HEAD>

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

<a name="441468"></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="vxserial_vxvm_manpages71_426866.html" title="Previous - vxlicense">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxsparecheck_vxvm_manpages73_429800.html" title="Next - vxsparecheck">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="434380"></a>vxsnap</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434403"></a> NAME</font>
</h3>
<p>
<a name="434408"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxsnap - enable DRL on a volume, and create and administer instant snapshots </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434411"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434416"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addmap</b></font> <em>volume</em> <em>number </em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc=</b></font><em>storage_attributes</em>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434446"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<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>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addmir </b></font>{<em>snapvol</em>|<em>snapobject</em>} [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font><em>N</em>] [<em>attributes</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434503"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font> {<em>volume</em>|<em>volset</em>} [<em>snapvol</em>|<em>snapobject</em>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434542"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> <em>optarg</em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>,</b></font><em>optarg</em>]...] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make <br></b></font><em>snapshot_tuple</em> [<em>snapshot_tuple</em>]... <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc=</b></font><em>storage_attributes</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment=\&quot;</b></font><em>comment</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>\&quot;</b></font>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434588"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap -d</b></font> <em>description_file </em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> <em>optarg</em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>,</b></font><em>optarg</em>]...] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make <br></b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc=</b></font><em>storage_attributes</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment=\&quot;</b></font><em>comment</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>\&quot;</b></font>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434634"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> <em>optarg</em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>,</b></font><em>optarg</em>]...] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make - </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434665"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>prepare <br></b></font>{<em>volume</em>|<em>volset</em>} [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionsize=</b></font><em>size</em>] <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>drl=</b></font>{<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>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sequential</b></font>}] <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcomirs=</b></font><em>number</em>] [<em>attribute</em> ...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434713"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-m</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>print</b></font> [<em>snapvol</em>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434743"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reattach <br></b></font>{<em>snapvol</em>|<em>snapvolset</em>} <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source=</b></font>{<em>volume</em>|<em>volset</em>} <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font><em>number</em>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434788"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> <em>optarg</em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>,</b></font><em>optarg</em>]...] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>refresh <br></b></font>{<em>snapvol</em>|<em>snapvolset</em>} <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source=</b></font>{<em>volume</em>|<em>volset</em>} <br>[[{<em>snapvol</em>|<em>snapvolset</em>} <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source=</b></font>{<em>volume</em>|<em>volset</em>}]...] <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncing=yes</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434837"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> <em>optarg</em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>,</b></font><em>optarg</em>]...] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore <br></b></font>{<em>volume</em>|<em>volset</em>} <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source=</b></font>{<em>snapvol</em>|<em>snapvolset</em>} <br>[{<em>volume</em>|<em>volset</em>} <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source=</b></font>{<em>snapvol</em>|<em>snapvolset</em>}]... <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>destroy=yes</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncing=yes</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font><em>number</em>] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434904"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmmir</b></font> {<em>snapvol</em>|<em>snapobject</em>} 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434925"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font> {<em>volume</em>|<em>volset</em>} 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434955"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncpause </b></font>{<em>volume</em>|<em>volset</em>} 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="434985"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncresume </b></font>{<em>volume</em>|<em>volset</em>} 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="435015"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<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>-g</b></font> <em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> <em>optarg</em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>,</b></font><em>optarg</em>]...] <br>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font> <em>tasktag</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstart </b></font>{<em>volume</em>|<em>volset</em>} 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="435067"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstop </b></font>{<em>volume</em>|<em>volset</em>} 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="435097"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncwait </b></font>{<em>volume</em>|<em>volset</em>} 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="435127"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>unprepare </b></font>{<em>volume</em>|<em>volset</em>} 
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="435157"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435162"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap</b></font> command is used to associate a version 20 data change object (DCO) and DCO volume with a volume. A DCO volume allows dirty region logging (DRL; used for fast mirror recovery) to be used with a volume. It also allows full-sized and space-optimized instant snapshots to be created and administered for a volume. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435219"></a>Full-sized instant snapshots, like traditional third-mirror snapshots, requires as much storage space for each of their plexes as a plex in the parent volume. Unlike traditional snapshots, however, instant snapshots are immediately available for use on being created. Synchronization of the snapshot volume can be performed in the background, or deferred until synchronization is necessary to dissociate the snapshot volume from its parent volume, or to move it into a separate disk group for off-host processing. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435286"></a>Space-optimized instant snapshots are also immediately available for use on being created, but they are typically configured to use a fraction of the storage space that is required by full-sized instant snapshots. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="435316"></a> KEYWORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435322"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addmap</b></font></font>
</p>
<p>
<a name="442708"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Adds a number of per-volume maps to the DCO volume of the specified volume. This may be necessary if no maps are available for use in the DCO volume. (By default, a DCO volume contains 32 per-volume maps.) The disks that are to be used for the maps may be specified as a list of comma-separated <em>storage_attribute</em> arguments. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435371"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addmir</b></font></font>
</p>
<p>
<a name="442735"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Adds one or more mirrors to a volume for use in creating full-sized break-off snapshots. (This operation is similar to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist snapstart</b></font> command.) The number of mirrors to be added may be specified by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror</b></font> attribute. The default number is 1. </font>
</p>
<p>
<a name="425172"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command also adds an equal number of mirrors to the DCO volume, and creates an association between each data mirror and a DCO mirror. When a data mirror is broken off to take a snapshot, the corresponding DCO mirror accompanies it. You can use storage attributes to control the allocation of disk space to the mirrors. </font>
</p>
<p>
<a name="425178"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The newly created data plexes remain in the SNAPATT state until they have been fully synchronized from the original data plexes. Synchronization is carried out as a background task if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-b </b></font>option is specified. Once the data plexes have been fully synchronized, they are placed in the SNAPDONE state. The state of the DCO plexes is DCOSNP until they are associated with the DCO of the original volume. </font>
</p>
<p>
<a name="425187"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The volume must have been prepared (using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxnap prepare</b></font>) for this command to succeed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435576"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font></font>
</p>
<p>
<a name="442771"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Dissociates an instant snapshot volume from its parent volume, and removes it from the snapshot hierarchy. The parent volume of the snapshot volume adopts any snapshot hierarchy that exists beneath the snapshot volume. </font>
</p>
<p>
<a name="425197"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This operation fails if the snapshot volume has any unsynchronized child snapshots immediately below it in a snapshot hierarchy. </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="425201"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> A snapshot volume must be dissociated from its snapshot hierarchy before it can be deleted by using a command such as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit rm</b></font>. 
</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="425204"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> When applied to a volume set or to a component volume of a volume set, this operation can result in inconsistencies in the snapshot hierarchy in the case of a system crash or hardware failure. If the operation is applied to a volume set, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> (force) option must be specified. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435736"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font></font>
</p>
<p>
<a name="442817"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Creates full-sized or space-optimized instant snapshot volumes. </font>
</p>
<p>
<a name="425215"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each snapshot that is to be created is defined by a snapshot tuple, <em>snapshot_tuple</em>. A tuple consists of a number of <em>attribute</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>=</b></font><em>value</em> fields. Within each tuple, the fields are separated by slashes (/). </font>
</p>
<p>
<a name="425220"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The following attributes can be defined for snapshot tuples. All attributes are optional except where specified. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435817"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc=</b></font><em>storage_attributes</em></font>
</p>
<p>
<a name="442862"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a comma-separated list of storage attributes (disks, controllers, enclosures, and trays) from which storage for the snapshot volume (and any required cache object) is to be allocated. </font>
</p>
<p>
<a name="425230"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font>(1M) manual page for more information about storage attributes. (Note that such attributes are silently ignored if they do not apply or are not required.) </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435892"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>autogrow=</b></font>{<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>}</font>
</p>
<p>
<a name="442900"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies whether the dedicated (non-shared) cache that is associated with a space-optimized snapshot can be grown automatically when extra space is required. The default value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>. </font>
</p>
<p>
<a name="425239"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This attribute does not apply to full-sized instant snapshots. </font>
</p>
<p>
<a name="425241"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxcached</b></font>(1M) manual page for more information on the operation of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>autogrow</b></font> feature. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435964"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cache=</b></font><em>cache_object</em></font>
</p>
<p>
<a name="442937"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the name of the cache object to be used by a space-optimized snapshot. The named cache object can be one shared between several space-optimized snapshots within the same disk group, or it can be a cache object that is dedicated for use by a single snapshot. </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="425250"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The cache object must already exist. 
</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="425252"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> This attribute is not required for volumes created by the VERITAS Intelligent Storage Provisioning (ISP) feature (for example, by running the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvoladm</b></font> command) as both space-optimized snapshots and their cache volume must be pre-prepared. In addition, this attribute cannot be specified with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cachesize</b></font> attribute. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436081"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cachesize=</b></font><em>size</em></font>
</p>
<p>
<a name="442984"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the size of the cache to be created for use by a space-optimized snapshot. The minimum cache size is 10m (10MB). </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="425264"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> This attribute is not supported for volumes created by the VERITAS Intelligent Storage Provisioning (ISP) feature (for example, by running the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvoladm</b></font> command), nor full-sized instant snapshots, and it cannot be specified with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cache</b></font> attribute. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436164"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment=\&quot;</b></font><em>comment</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>\&quot;</b></font></font>
</p>
<p>
<a name="443027"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Associates a description with the snapshot volume. </font>
</p>
<p>
<a name="425273"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The double quotation marks around the comment string must be escaped with backslashes to protect them from the shell. The comment itself must not contain double quotation marks. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436211"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>infrontof=</b></font><em>frontvol</em></font>
</p>
<p>
<a name="443057"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Places a volume in front of the specified volume, <em>frontvol</em>, in a snapshot cascade. </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="425281"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Snapshot cascades improve write performance for applications that take regular online snapshots of volumes. They are not suitable for use where the snapshots may be dissociated from the snapshot hierarchy. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436267"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ncachemirror=</b></font><em>number</em></font>
</p>
<p>
<a name="443092"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the degree of redundancy to be configured in the cache volume that underlies the cache object. By default, an unmirrored cache volume is created (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ncachemirror=1</b></font>). </font>
</p>
<p>
<a name="425290"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This attribute does not apply to full-sized instant snapshots. It cannot be specified with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cache</b></font> attribute. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436323"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>newvol=</b></font>{<em>snapvol</em>|<em>snapvolset</em>}</font>
</p>
<p>
<a name="443124"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the degree of redundancy to be configured in the cache volume that underlies the cache object. By default, an unmirrored cache volume is created (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ncachemirror=1</b></font>). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436327"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>new=</b></font>{<em>snapvol</em>|<em>snapvolset</em>}</font>
</p>
<p>
<a name="443187"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the name of the new space-optimized or full-sized break-off snapshot volume that is to be created. If not specified, the snapshot is assigned a name of the form <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAP</b></font><em>%d</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font><em>%v</em>, where <em>%d</em> is a unique serial number, and <em>%v</em> is the name of the original volume. You can use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o name=&quot;</b></font><em>pattern</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&quot;</b></font> option to specify a different format to use for new snapshot volumes. </font>
</p>
<p>
<a name="425305"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>new</b></font> is an alias for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>newvol</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="425307"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> For a full-sized break-off snapshot volume, either the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex </b></font>or the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror</b></font> attribute must also be specified. 
</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="425310"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> This attribute is not supported for volumes created by the VERITAS Intelligent Storage Provisioning (ISP) feature (for example, by running the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvoladm</b></font> command), and it cannot be specified with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol</b></font> attribute. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436487"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=</b></font><em>number</em></font>
</p>
<p>
<a name="443251"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the name of the new space-optimized or full-sized break-off snapshot volume that is to be created. If not specified, the snapshot is assigned a name of the form <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAP</b></font><em>%d</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font><em>%v</em>, where <em>%d</em> is a unique serial number, and <em>%v</em> is the name of the original volume. You can use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o name=&quot;</b></font><em>pattern</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&quot;</b></font> option to specify a different format to use for new snapshot volumes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436491"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirrors=</b></font><em>number</em></font>
</p>
<p>
<a name="443282"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the degree of redundancy to be configured in a snapshot volume by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation. By default, an unmirrored snapshot volume is created (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=1</b></font>). </font>
</p>
<p>
<a name="425322"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This attribute is also used to specify the number of snapshot mirrors that are to be added to a volume in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addmir</b></font> operation. By default, one snapshot mirror is added to a volume (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror=1</b></font>). </font>
</p>
<p>
<a name="425326"></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>newvol</b></font> attribute is specified to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation instead of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol</b></font> attribute, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror</b></font> specifies the number of plexes in the original volume that are to be broken off for use as snapshot plexes. </font>
</p>
<p>
<a name="425331"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirrors</b></font> is an alias for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror</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="425333"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The original volume must have a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mirror-stripe </b></font>layout, or it must be a RAID-5 volume that has been converted to a layered layout by running the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap prepare</b></font> command. The volume must also have a sufficient number of plexes available that are in the SNAPDONE state (see the description of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap addmir</b></font>). 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425339"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This attribute only applies to full-sized break-off mirror snapshots. It can also be used when creating snapshots of volume sets. It cannot be specified with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex</b></font> attribute. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436701"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex=</b></font><em>plex</em>[,<em>plex</em>...] </font>
</p>
<p>
<a name="443381"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies one or more plexes in the original volume that are to be used as snapshot plexes. </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="425347"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The data in the plexes must already be synchronized, and the plexes must be in the ACTIVE state. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425350"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This attribute applies only to full-sized break-off snapshots. It cannot be specified with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror</b></font> attribute. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436773"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol=</b></font><em>volume</em></font>
</p>
<p>
<a name="443417"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies one or more plexes in the original volume that are to be used as snapshot plexes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436777"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap=</b></font><em>volume</em></font>
</p>
<p>
<a name="443440"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a volume that is to be used as a full-sized snapshot of the source volume. (For ISP application volumes, this attribute is also used to specify a prepared space-optimized snapshot.) The specified volume must have the same length as the source volume. The region size of the DCO volume of the snapshot volume must also be the same as that of the DCO volume of the source volume. </font>
</p>
<p>
<a name="425364"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap</b></font> is an alias for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol</b></font>. </font>
</p>
<p>
<a name="425366"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This attribute applies only to full-sized snapshots that are created on a pre-prepared volume. It cannot be specified with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>newvol</b></font> attribute. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436894"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source=</b></font><em>volume</em></font>
</p>
<p>
<a name="443481"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the name of the volume for which the snapshot is being taken. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436907"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncing=</b></font>{<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font>}</font>
</p>
<p>
<a name="443514"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the name of the volume for which the snapshot is being taken. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436911"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sync=</b></font>{<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font>}</font>
</p>
<p>
<a name="443553"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies whether synchronization is to be started for a full-sized instant snapshot (default value is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>). </font>
</p>
<p>
<a name="425383"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sync</b></font> is an alias for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncing</b></font>. </font>
</p>
<p>
<a name="425385"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The value <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font> is equivalent to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font> is equivalent to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</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="425388"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> An instant snapshot must be fully synchronized before the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font> operations can be performed on it, or before it can be moved into a separate disk group. To reduce system overhead, synchronization may be disabled if the snapshot volume is to remain dependent on the original volume in the same disk group. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425395"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This attribute applies only to full-sized instant snapshots. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425398"></a>To summarize, the following options <em>must</em> be specified for the different types of instant snapshot: </font>
</blockquote>
<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425403"></a>Space-optimized on a newly created cache (non-ISP volumes only): <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cachesize</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>newvol</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>new</b></font>. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425409"></a>Space-optimized on a pre-prepared cache: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cache</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>newvol</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>new</b></font> (non-ISP volumes only), and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap</b></font> (ISP volumes only). </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425416"></a>Full-sized break-off (non-ISP volumes only): <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>newvol</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>new</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex</b></font>. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425422"></a>Full-sized on a pre-prepared volume: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>source</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snap</b></font>. </font>
</li>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425427"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>autogrow</b></font> option applies only to space-optimized snapshots, and the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ncachemirror</b></font> option applies only to space-optimized snapshots for which a cache is created at the same time. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425431"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncing</b></font> option applies only to full-sized instant snapshots. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425433"></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>comment</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>infrontof</b></font> attributes may optionally be specified for all instant snapshots. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425436"></a>The following global attributes may be specified at the end of the command and are applied to all snapshots that are to be created: </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437357"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>alloc=</b></font><em>attributes</em></font>
</p>
</ul>
</p>
<p>
<a name="443725"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a comma-separated list of storage attributes (disks, controllers, enclosures, and trays) from which storage for the snapshot volumes (and any required cache objects) is to be allocated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437397"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment=\&quot;</b></font><em>comment</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>\&quot;</b></font></font>
</p>
<p>
<a name="443752"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Associates a description with all the snapshot volumes. </font>
</p>
<p>
<a name="425449"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The double quotation marks around the comment string must be escaped with backslashes to protect them from the shell. The comment itself must not contain double quotation marks. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425454"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> command also enables FastResync on the snapshot, and sets the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>instant</b></font> flag to indicate that it is ready for access. For full-sized instant snapshots, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>incomplete </b></font>flag is also set to indicate that the snapshot has not been fully synchronized with its parent volume. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>incomplete</b></font> flag is unset when synchronization (if any) is complete. You can check for these flags using the vxprint command as shown here: </font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437528"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxprint&nbsp;-g&nbsp;</font><em>diskgroup</em><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;-F&nbsp;%instant&nbsp;</font><em>volume</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="437539"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxprint&nbsp;-g&nbsp;</font><em>diskgroup</em><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;-F&nbsp;%incomplete&nbsp;</font><em>volume</em>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425472"></a>The returned value indicates whether the flag is set (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>on</b></font>) or not set (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>off</b></font>). </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425475"></a>If the argument to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> is a dash character (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-</b></font>), snapshot tuple arguments and other attributes are read from the standard input. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437611"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>prepare</b></font></font>
</p>
<p>
<a name="443844"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Prepares a volume for instant snapshot and space-optimized snapshot operations, and for dirty region logging (DRL). A new-style data change object (DCO) and DCO volume are associated with 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="425486"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> If an old-style DRL log or DCO is present on the volume, the operation fails. These must be removed from the volume before instant snapshots can be used. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425490"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the volume is RAID-5, it is converted into a layered volume with mirroring at the top layer and the original RAID-5 volume in the lower layer. This volume cannot be resized nor can its layout be changed unless the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>unprepare</b></font> operation is used to convert it back to a non-layered RAID-5 volume. </font>
</p>
<p>
<a name="425497"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The size of DCO volume is determined by the size of each volume region that is mapped by a single bit in a FastResync map, and by the number of mirrors in the DCO volume. By default, each mirror requires space for 32 per-volume maps plus an accumulator and DRL log that require an additional amount of space that is equivalent to 3 per-volume maps. </font>
</p>
<p>
<a name="425503"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The number of mirrors in the DCO volume may be specified by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ndcomirs </b></font>attribute. For non-layered volumes, the default number of DCO mirrors is set to the lesser of the number of data plexes in the parent volume or 2. For layered volumes, the default number of DCO mirrors is set to 2. </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="425510"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> It is recommended that you give the DCO volume the same level of redundancy as the parent volume. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425513"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The default region size is 64k (64KB). If a different region size is specified by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>regionsize</b></font> attribute, this must be a power of 2 and greater than or equal to 16k. </font>
</p>
<p>
<a name="425517"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>drl</b></font> attribute specifies how DRL is to be applied to the volume: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437943"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font></font>
</p>
<p>
<a name="443910"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">DRL is not enabled on the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437956"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sequential</b></font></font>
</p>
<p>
<a name="443929"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sequential DRL is enabled on the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437969"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font></font>
</p>
<p>
<a name="443948"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">DRL is enabled on the volume. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425531"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>instant</b></font> flag is set on the volume to indicate that the volume can be used for instant snapshot operations. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425534"></a>Other attributes can include storage attributes as used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> command. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438032"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>print</b></font></font>
</p>
<p>
<a name="443979"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays information about volumes and their instant snapshots in a similar manner to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist snapprint</b></font>. Additional information includes whether synchronization of a volume is complete, together with the percentage of regions that are synchronized. </font>
</p>
<p>
<a name="425545"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If no argument is specified, the command displays snapshot-related information for all volumes in a disk group. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438106"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reattach</b></font></font>
</p>
<p>
<a name="444001"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Reattaches the plexes of a snapshot volume to the specified source volume in a snapshot hierarchy, and synchronizes them from that volume. The DCO plexes that are associated with the plexes being reattached are also reassociated with the DCO volume of the source 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="425556"></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>reattach</b></font> operation is permitted between unrelated volumes provided that their sizes are compatible. 
</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="425559"></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>reattach</b></font> operation is not supported for space-optimized snapshots. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425562"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Caution: For volumes created using the VERITAS Intelligent Storage Provisioning (ISP) feature, this operation requires the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> (force) option to be specified as it violates the intent of the volume. The operation has the side effect of moving the disks underlying the snapshot to the storage pool in which the source volume is located. The operation fails if the snapshot and the source volume are in different pools, but the snapshot volume does not have exclusive use of the underlying disks. </font>
</p>
<p>
<a name="425573"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The plexes of the snapshot volume are put into the SNAPTMP state while they are being synchronized, and are set to the ACTIVE state when synchronization is complete. </font>
</p>
<p>
<a name="425577"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">By default, all the plexes of the snapshot volume are reattached. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nmirror</b></font> attribute can be used to return a subset of the plexes in the snapshot volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438371"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>refresh</b></font></font>
</p>
<p>
<a name="444065"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Refreshes a snapshot volume from the specified source volume. The snapshot volume is immediately available with the new contents. By default, synchronization of the snapshot volume is started. If you require that synchronization should not be started, specify the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncing=no</b></font> attribute. </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="425589"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The snapshot volume must be closed (for example, it must not be mounted as a file system, or be accessed by a database or other application) before running this command. However, the snapshot volume may be re-opened immediately after running this command. 
</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="425595"></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>refresh</b></font> operation is permitted between unrelated volumes provided that their sizes are compatible. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438497"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font></font>
</p>
<p>
<a name="444104"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Restores one or more volumes from the specified source snapshot volumes. The volume is immediately available with the new contents, and synchronization of the volume is started unconditionally. </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="425604"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> This operation is not supported for space-optimized snapshots, and is not permitted between unrelated volumes. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425607"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">By default, full synchronization is started unless the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncing=no</b></font> attribute is specified. </font>
</p>
<p>
<a name="425610"></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>destroy</b></font> attribute is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font>, the snap volume is removed when the synchronization is complete, and its plexes are attached to the parent volume. By default, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>destroy</b></font> attribute is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font>, which preserves the snapshot volume. </font>
</p>
<p>
<a name="425616"></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>incomplete</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font> flags are set on the volume while it is being restored. </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="425619"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The volume must be closed (for example, it must not be mounted as a file system, or be accessed by a database or other application) before running this command. However, the volume may be re-opened immediately after running this command, before synchronization is complete. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438708"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmmir</b></font></font>
</p>
<p>
<a name="444184"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Removes one snapshot mirror that was previously added to a volume by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap addmir</b></font> command. (This operation is similar to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist snapabort</b></font> command.) The DCO plex that is associated with the mirror is also removed. </font>
</p>
<p>
<a name="425632"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The command fails if no such mirror exists, or if the volume has not been prepared for use with instant snapshots. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438779"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font></font>
</p>
<p>
<a name="444209"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Splits a snapshot hierarchy into two independent snapshot hierarchies. The per-volume map for this volume in its parent volume is deactivated, and the linking snap objects are removed from both the volume and its parent. </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="425642"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> This operation is not supported for space-optimized snapshots. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425644"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The specified volume and its descendents form an independent snapshot hierarchy. This requires that synchronization of the volume is complete. </font>
</p>
<p>
<a name="425647"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">As a result of this operation, the volume is dissociated from its parent. The operation fails if the volume is dependent on its parent. </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="425650"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> When applied to a volume set or to a component volume of a volume set, this operation can result in inconsistencies in the snapshot hierarchy in the case of a system crash or hardware failure. If the operation is applied to a volume set, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> (force) option must be specified. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438937"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncpause</b></font></font>
</p>
<p>
<a name="444254"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Pauses a synchronization operation that is in progress. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438950"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncresume</b></font></font>
</p>
<p>
<a name="444277"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Resumes a synchronization operation that was paused by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncpause</b></font> command. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438972"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstart</b></font></font>
</p>
<p>
<a name="444300"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Starts synchronization of an instant snapshot. This command checks that the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>incomplete</b></font> flag is set on the snapshot, and removes this flag when synchronization is complete. </font>
</p>
<p>
<a name="425672"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Resynchronization must not have been started earlier by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> command (by specifying <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncing=yes</b></font>), or stopped by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstop</b></font> command. </font>
</p>
<p>
<a name="425676"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The command returns immediately if synchronization is in progress, or if synchronization is already complete (that is, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>incomplete</b></font> flag is not set). </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="425684"></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>vxtask</b></font> command can be used to pause, resume, or stop the synchronization operation. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439096"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstop</b></font></font>
</p>
<p>
<a name="444357"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Stops synchronization of an instant snapshot. The command returns immediately if no synchronization is in progress, or if synchronization is already complete (that is, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>incomplete</b></font> flag is not set). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439136"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncwait</b></font></font>
</p>
<p>
<a name="444380"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Waits for synchronization to complete on the specified volume. This command works by periodically checking for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>incomplete</b></font> flag to be removed from the volume. </font>
</p>
<p>
<a name="425700"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command fails for a space-optimized snapshot, or for a snapshot on which synchronization is not in progress. It also cannot be used to wait for reattached plexes to be resynchronized. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439201"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>unprepare</b></font></font>
</p>
<p>
<a name="444406"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Removes the DCO and DCO volume that are associated with a volume. This disables DRL, FastResync and instant snapshot functionality for the volume, and unsets the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>instant</b></font> flag on the volume. </font>
</p>
<p>
<a name="425711"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the volume is part of a snapshot hierarchy, the operation fails. Use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font> operation to remove the volume from the snapshot hierarchy before using this command. </font>
</p>
<p>
<a name="425715"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the volume was originally a RAID-5 volume that was converted to a layered volume by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>prepare</b></font> command, the layout reverts to non-layered RAID-5. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439308"></a> OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439314"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-b</b></font></font>
</p>
<p>
<a name="444443"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Performs any necessary synchronization in the background, instead of blocking. This option only applies to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstart</b></font> operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439336"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font> <em>description_file</em></font>
</p>
<p>
<a name="444470"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation, allows tuple definitions to be read from a description file instead of from the command line. The tuples may be placed on separate lines in this file. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439376"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em></font>
</p>
<p>
<a name="444497"></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, 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="439425"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> <em>optarg</em>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>,</b></font><em>optarg</em>]...]</font>
</p>
<p>
<a name="444532"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies arguments that alter the behavior of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make </b></font>operation. The following arguments may be specified: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439447"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iosize=</b></font><em>size</em></font>
</p>
<p>
<a name="444571"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the size of each I/O request that is to be used when synchronizing the regions of the volume. This option may be specified 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>refresh</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstart</b></font> operations. The specified value is rounded to a multiple of the volume's region size. The default value is 1m (1MB). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439505"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>name=&quot;</b></font><em>pattern</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>&quot;</b></font></font>
</p>
<p>
<a name="444602"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a format template for naming new snapshot volumes. This option may be used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operation. 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="439554"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%%</b></font></font>
</p>
<p>
<a name="444621"></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="439567"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%d</b></font></font>
</p>
<p>
<a name="444640"></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="439589"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%g</b></font></font>
</p>
<p>
<a name="444659"></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="439602"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%m</b></font></font>
</p>
<p>
<a name="444678"></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="439615"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%s</b></font></font>
</p>
<p>
<a name="444697"></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="439637"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%S</b></font></font>
</p>
<p>
<a name="444716"></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="439659"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%v</b></font></font>
</p>
<p>
<a name="444735"></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="439672"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%x</b></font></font>
</p>
<p>
<a name="444754"></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="439694"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>%X</b></font></font>
</p>
<p>
<a name="444773"></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>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439716"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>slow=</b></font><em>iodelay</em></font>
</p>
<p>
<a name="444820"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the delay in milliseconds between synchronizing successive sets of regions as specified by the value of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iosize</b></font>. This can be used to change the impact of synchronization on system performance. This option may be specified 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>refresh</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstart</b></font> operations. The default value of <em>iodelay</em> is 0 milliseconds (no delay). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439780"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-m</b></font></font>
</p>
<p>
<a name="444843"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>print</b></font> operation, displays detailed information about a volume's DCO, including the region size, the number of regions represented by each map, and the number of per volume maps. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439811"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font> <em>tasktag</em></font>
</p>
<p>
<a name="444870"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstart</b></font> operation, defines a tag that can be used to track the synchronization task. The specified tag is a sequence of up to 16 alphanumeric characters. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="439841"></a> EXAMPLES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439846"></a>Create a volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsssvolx</b></font>, with 2 mirrors that is to be used as the full-sized snapshot of the volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volx</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="439882"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">LEN='vxprint&nbsp;-g&nbsp;mydg&nbsp;-F%len&nbsp;volx'</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="439887"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;-g&nbsp;mydg&nbsp;-b&nbsp;make&nbsp;fsssvolx&nbsp;$LEN&nbsp;layout=mirror&nbsp;nmirror=2</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="439895"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">DCOVOL='vxprint&nbsp;-g&nbsp;mydg&nbsp;-F%dconame&nbsp;volx'</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="439903"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">RSZ='vxprint&nbsp;-g&nbsp;mydg&nbsp;-F%regionsz&nbsp;$DCOVOL'</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="439911"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;prepare&nbsp;volume&nbsp;regionsize=$RSZ&nbsp;ndcomirs=2</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439927"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxprint</b></font> commands are used to discover the length of the original volume, the name of its DCO volume, and the region size of that DCO volume. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> command is used to create a new volume with the required redundancy. Finally, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap prepare</b></font> command sets up a DCO volume with the correct region size on the newly created volume. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="439993"></a>Having performed the previous steps, the full-sized instant snapshot can be created (this example also starts synchronization using an I/O size of 10MB): </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440026"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;-o&nbsp;iosize=10m&nbsp;make&nbsp;source=volx/snapvol=fsssvolx/sync=yes</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440042"></a>Add 2 mirror plexes to the volume <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol1</b></font> for use as break-off snapshots:  </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440063"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;addmir&nbsp;vol1&nbsp;nmirror=2</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440079"></a>Remove one snapshot mirror plex from the volume <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol1</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440100"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;rmmir&nbsp;vol1</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440116"></a>Create full-sized instant snapshots of volumes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol2</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol3</b></font> with specified names by breaking off one plex from each original volume: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440161"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;make&nbsp;source=vol1/newvol=snapvol1/nmirror=1&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440169"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;source=vol2/newvol=snapvol2/nmirror=1&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440177"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;source=vol3/newvol=snapvol3/nmirror=1</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440193"></a>Create a space-optimized snapshot, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sossvolx</b></font>, of the volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volx</b></font>, and also set up a 1GB growable cache for use by the snapshot: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440238"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;make&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440246"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;source=volx/newvol=sossvolx/cachesize=1g/autogrow=yes</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440262"></a>Use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> command to create a 20GB cache volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mydgcvol</b></font>, with 2 mirrors: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440295"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxassist&nbsp;-g&nbsp;mydg&nbsp;-b&nbsp;make&nbsp;mydgcvol&nbsp;20g&nbsp;layout=mirror&nbsp;nmirror=2</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440311"></a>Use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> command to set the region size of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mydgcvol </b></font>to 32KB, and to associate the volume with the cache object, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mydgcache</b></font>, for use by space-optimized snapshots in the disk group, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mydg</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440356"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxmake&nbsp;-g&nbsp;mydg&nbsp;cache&nbsp;mydgcache&nbsp;cachevolname=mydgcvol&nbsp;regionsize=32k</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440372"></a>Use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxcache</b></font> command to start the cache: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440393"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxcache&nbsp;-g&nbsp;mydg&nbsp;start&nbsp;mydgcache</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440409"></a>Create space-optimized snapshots of volumes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol1</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol2</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol3</b></font> with a mixture of default and specified names. Default snapshot names are assigned using the specified template. Each snapshot shares the prepared cache, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mydgcache</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440466"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;-o&nbsp;name=&quot;so%v-%d&quot;&nbsp;make&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440474"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;source=vol1/cache=mydgcache&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440482"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;source=vol2/newvol=sosnapvol2/cache=mydgcache&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440490"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;source=vol3/cache=mydgcache</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440506"></a>Create a space-optimized snapshot, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sossvoly</b></font>, of the volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>voly</b></font>, on the cache, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mydgcache</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440539"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;make&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440547"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;source=voly/newvol=sossvoly/cache=mydgcache</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440563"></a>Create a space-optimized snapshot, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sos2voly</b></font>, of the volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>voly</b></font>, and place this in front of snapshot, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sossvoly</b></font>, to create a snapshot cascade: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440608"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;make&nbsp;\</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440616"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;source=voly/newvol=sos2voly/infrontof=sossvoly/cache=mydgcache</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440632"></a>Refresh the contents of the full-sized snapshot, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol1</b></font>, and the spaced-optimized snapshot, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sosnapvol2</b></font>, from their original volumes, using an I/O size of 5MB: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440689"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;-o&nbsp;iosize=5m&nbsp;refresh&nbsp;snapvol1&nbsp;sosnapvol2</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440705"></a>Synchronize the contents of the full-sized snapshot volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol2</b></font>, from its original volume using an I/O size of 10MB, wait for the synchronization to complete, and then turn <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol2</b></font> into an independent volume: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440762"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;-b&nbsp;-o&nbsp;iosize=10m&nbsp;syncstart&nbsp;snapvol2</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440770"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;syncwait&nbsp;snapvol2</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440778"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;dis&nbsp;snapvol2</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440794"></a>Reattach the full-sized snapshot, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol1</b></font>, to its original volume: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440815"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;reattach&nbsp;snapvol1&nbsp;source=vol1</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440831"></a>Restore <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol3</b></font> from the full-sized snapshot volume, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapvol3</b></font>, using an I/O size of 2MB, and remove the snapshot volume when restoration is complete: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="440876"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;-o&nbsp;iosize=2m&nbsp;restore&nbsp;vol3&nbsp;source=snapvol3&nbsp;destroy=yes</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="440892"></a> NOTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440897"></a>If a valid FlashSnap(TM) license for FastResync is not present on the system, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>prepare</b></font> operation turns on dirty region logging (DRL) but not FastResync for a volume. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440927"></a>If FastResync is turned off, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addmir</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font> (for leaf nodes only), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> (for break-off snapshots only), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>print</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reattach</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmmir</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font> operations are permitted. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reattach</b></font> operation requires a full resynchronization. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440969"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>refresh</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font> operations, and the creation using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> of full-sized or space-optimized instant snapshots are not permitted if FastResync is turned off. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="440999"></a>A volume that is a member of a snapshot hierarchy must be dissociated from the hierarchy before FastResync can be enabled or disabled on the volume (using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol set fastresync=on</b></font> command). </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441041"></a>When using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap prepare</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist make</b></font> commands to make a volume ready for instant snapshot operations, if the specified region size exceeds half the value of the tunable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>voliomem_maxpool_sz</b></font>, the operation succeeds but gives a warning such as the following (for a system where <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>voliomem_maxpool_sz</b></font> is set to 12MB): </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="441122"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">Specified&nbsp;region-size&nbsp;is&nbsp;larger&nbsp;than&nbsp;the&nbsp;limit&nbsp;on&nbsp;the&nbsp;system</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="441130"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">(voliomem_maxpool_sz/2=6144k).</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441146"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap make</b></font> operations to create full-sized or space-optimized instant snapshots, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>refresh</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font> operations on such volumes fail as they might potentially hang the system. Such volumes can be used only for breakoff-type snapshot operations using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reattach</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>make</b></font> operations. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441200"></a>To make the volumes usable for instant snapshot operations, use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap unprepare</b></font> on the volume, and then use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap prepare </b></font>to re-prepare the volume with a region size that is less than half the size of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>voliomem_maxpool_sz</b></font> (in this example, 1MB): </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="441257"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;-f&nbsp;unprepare&nbsp;vol1</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="441265"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsnap&nbsp;-g&nbsp;mydg&nbsp;prepare&nbsp;vol1&nbsp;regionsize=1M</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441281"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>prepare</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addmir</b></font> operations require an additional license when applied to a RAID-5 volume. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441299"></a>The instant snapshot and space-optimized snapshot operations are intended eventually to replace the traditionally third-mirror snapshot operations that are provided by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> commands. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441341"></a>Volume sets can be used in place of volumes with the following <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap</b></font> operations on instant volume snapshots: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>addmir</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font>, <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>prepare</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reattach</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>refresh</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>restore</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmmir</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncpause</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncresume</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstart</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncstop</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>syncwait</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>unprepare</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441407"></a>A full-sized snapshot of a volume set must itself be a volume set. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvset</b></font>(1M) manual page for more information about administering volume sets. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441438"></a>The value of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volpagemod_max_memsz</b></font> tunable affects the performance of the instant snapshots feature. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtune</b></font>(1M) manual page and the <em>VERITAS Volume Manager Administrator's Guide</em> for details. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="441468"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441473"></a><a href="vxassist_vxvm_manpages14_458378.html#441128"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font></font></a>(1M), <a href="vxcache_vxvm_manpages17_429232.html#427933"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxcache </b></font></font></a>(1M), <a href="vxcached_vxvm_manpages18_427367.html#426743"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxcached </b></font></font></a>(M), <a href="vxdg_vxvm_manpages33_443062.html#434590"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </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="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="vxtune_vxvm_manpages80_428301.html#427387"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtune </b></font></font></a>(1M), <a href="vxvset_vxvm_manpages88_429763.html#428038"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvset </b></font></font></a>(1M) </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="441590"></a><em>VERITAS Volume Manager Administrator's Guide </em></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="vxsnap_vxvm_manpages72_441468.html" title="vxsnap">Return to Top</a></font>

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