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

</HEAD>

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

<a name="438209"></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="vxpfto_vxvm_manpages55_427264.html" title="Previous - vxpfto">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxpool_vxvm_manpages57_430997.html" title="Next - vxpool">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="431636"></a>vxplex</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="431659"></a> NAME</font>
</h3>
<p>
<a name="431664"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxplex - perform VERITAS Volume Manager operations on plexes </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="431667"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="431672"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-fV</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d </b></font><em>defaults_file</em>] [<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>useopt</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font><em>srcplex1</em> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font><em>srcplex2</em>] ...] [<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>-T </b></font><em>taskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font><em>usetype</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att </b></font><em>volume plex</em>... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="431765"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-fV</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>useopt</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em>] [<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>-T </b></font><em>taskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font><em>usetype</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>convert state=ACTIVE</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPDIS</b></font>|<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPDONE </b></font><em>plex</em> [<em>plex1</em>...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="431849"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-fV</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>useopt</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em>] [<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>-T </b></font><em>taskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font><em>usetype</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cp </b></font><em>volume plex... </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="431924"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-fV</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>useopt</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em>] [<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>-T </b></font><em>taskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font><em>usetype</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v </b></font><em>volume</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>det </b></font><em>plex... </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="432008"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-fV</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>useopt</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em>] [<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>-T </b></font><em>taskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font><em>usetype</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v </b></font><em>volume</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis </b></font><em>plex... </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="432092"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-fV</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>useopt</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em>] [<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>-T </b></font><em>taskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font><em>usetype</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v </b></font><em>volume</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mv </b></font><em>oldplex newplex </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="432176"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-fV</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>useopt</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em>] [<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>-T </b></font><em>taskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font><em>usetype</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapabort </b></font><em>plex... </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="432251"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-fV</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c </b></font><em>checkpoint</em>] [<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>useopt</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em>] [<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>-T </b></font><em>taskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font><em>usetype</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot </b></font><em>plex [new_volume] [plex [new_volume]...] </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="432335"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-fV</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>useopt</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font><em>srcplex1</em> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font><em>srcplex2</em>] ...] [<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>-T </b></font><em>taskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font><em>usetype</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart </b></font><em>volume plex... </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="432419"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-fV</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>useopt</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em>] [<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>-T </b></font><em>taskid</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font><em>usetype</em>] <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback </b></font><em>volume plex...</em> 
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="432495"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432500"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> utility performs VERITAS Volume Manager (VxVM) operations on plexes and on volume-and-plex combinations.  The first operand is a keyword that determines the specific operation to perform.  The remaining operands specify the configuration objects to which the operation is to be applied. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432548"></a>Each operation can be applied to only one disk group at a time. Any <em>volume</em> or <em>plex </em>operands are used to determine a default disk group, according to the standard disk group selection rules described in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M).  A specific disk group can be forced with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="432596"></a> KEYWORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432602"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font></font>
</p>
<p>
<a name="439124"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Attaches each named plex to the named volume.  This can be applied to dissociated plexes, or to non-enabled plexes already associated with the named volume. If the volume is enabled, then the result of the successful operation is to associate the plex (if needed) and to recover the plex to have the same contents as all other attached plexes in the volume.  The rules for performing the attach depend upon the usage type of the named volume. </font>
</p>
<p>
<a name="425124"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Attaching a plex is the normal means of recovering a plex after a disk replacement, or after a plex offline. </font>
</p>
<p>
<a name="425127"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">By default, the FastResync feature (if licensed) is used to speed up the synchronization of re-attached plexes. This behavior can be changed by defining a value for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>usefmr</b></font> attribute in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> defaults file, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxplex</b></font>. </font>
</p>
<p>
<a name="425132"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If a valid license for the FastResync feature exists on the system, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> uses this feature under the following conditions: </font>
</p>
<p>
<ul type="disc"><p>
<ul type="disc"><p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425137"></a>If a defaults file does not exist. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425140"></a>If a defaults file exists, but no value is defined for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>usefmr</b></font> attribute. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425144"></a>If a defaults file exists, and contains the entry <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>usefmr=yes</b></font>. </font>
</li>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425147"></a>If a valid FastResync license is not found, or the defaults file contains the entry <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>usefmr=no</b></font>, FastResync is not used and a full resynchronization is performed. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425152"></a>A different defaults file can be specified by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font> option. See the description in the OPTIONS section for details. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432895"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>convert</b></font></font>
</p>
<p>
<a name="439188"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Converts a snapshot plex into a regular plex, or a regular plex into a snapshot plex. This operation allows you to create a snapshot plex for a volume that already has two or more mirrors without using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font>. </font>
</p>
<p>
<a name="425162"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The main difference between a snapshot plex and a regular plex is the plex state. A plex may be in one of many states depending on errors, detaches and other transactions. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex convert</b></font> operation is limited to moving plexes between the ACTIVE, SNAPDONE, and SNAPDIS plex states. The state of a regular plex that is attached to an open volume is ACTIVE. The state of a snapshot plex after the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font> operation has completed is usually SNAPDONE, although it may be in the SNAPDIS state if attached using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font>. </font>
</p>
<p>
<a name="425173"></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>state</b></font> attribute to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>convert</b></font> operation specifies the final state of the plex after conversion: <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ACTIVE</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPDIS</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPDONE</b></font>. A regular plex is usually converted to a snapshot plex in the SNAPDONE state, and a snapshot plex is usually converted to a regular plex in the ACTIVE state. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>SNAPDIS</b></font> option is provided for convenience of scripting. </font>
</p>
<p>
<a name="425181"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">As well as changing the plex state, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>convert</b></font> operation also changes the I/O mode and the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>noerror</b></font> flag for the plex. The I/O mode is set to read/write for a regular plex, and to read-only for a snapshot plex. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>noerror</b></font> flag is cleared for regular plexes, and set for snapshot plexes. Additionally, if Persistent FastResync is enabled on a volume (that is, a data change object (DCO) and DCO volume are associated with the volume), a DCO plex must be added if a regular plex is converted to a snapshot plex, and a DCO plex must be removed if a snapshot plex is converted to a regular plex. </font>
</p>
<p>
<a name="425193"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The following example shows how to convert the regular plex <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plex1</b></font> to a snapshot plex, which is associated with the DCO plex, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcoplex1</b></font>: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433256"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxplex&nbsp;-g&nbsp;mydg&nbsp;-o&nbsp;dcoplex=dcoplex1&nbsp;convert&nbsp;state=SNAPDONE&nbsp;plex1</font>
</font>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425205"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The last complete regular plex in a volume, an incomplete regular plex, or a dirty region logging (DRL) log plex cannot be converted into a snapshot plex. 
</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="425209"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> This discussion applies only to traditional third-mirror snapshots. It does not apply to full-sized instant snapshots that are created and administered using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap</b></font> command. Plexes that are broken off for use in instant snapshots must be in the ACTIVE and not the SNAPDONE state. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433374"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cp</b></font></font>
</p>
<p>
<a name="439295"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Copies the named volume to the named plexes.  The volume must be enabled, and the named plexes must not be associated.  The result of the operation is a set of dissociated plexes that is an exact copy of the volume at the time of completion of the operation.  The rules for performing the attach depend upon the usage type of the named volume.  To improve the quality of the copies, some usage types attempt to make the detached plex consistent with respect to in-memory data. </font>
</p>
<p>
<a name="425225"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This operation can be used to make a copy of a volume, for backup purposes, without mirroring the volume in advance. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433508"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>det</b></font></font>
</p>
<p>
<a name="439317"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Detaches each of the named plexes.  Detaching a plex leaves the plex associated with its volume, but prevents normal volume I/O from being directed to the plex. This operation can be applied to plexes that are enabled or disabled.  The rules for performing the detach depend upon the usage types of the volumes involved.  The operation does not apply to dissociated plexes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433601"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font></font>
</p>
<p>
<a name="439352"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Dissociates each of the named plexes.  Dissociating a plex breaks the link between the plex and its volume.  A dissociated plex is inaccessible until it is reassociated, which can be done either with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex att</b></font> or with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>.  Any checks and synchronizations that apply to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>det</b></font> operation also apply to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font> operation. </font>
</p>
<p>
<a name="425245"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Plex dissociation is the typical means of unmirroring a volume or reducing the mirror count for a volume. To do this, use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o rm </b></font>to dissociate and remove the plex (and its associated subdisks) in the same operation. This makes the space used by those subdisks usable for new allocations (such as with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>). </font>
</p>
<p>
<a name="425258"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Plex dissociation can also be used for file system backups of volumes that are normally mirrored.  Plex devices are not directly mountable, so the backup method described for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>det</b></font> operation does not work if the backup program requires a mounted file system.  To support such backup programs, a plex can be dissociated and can then be allocated to a new volume as in the following example: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433924"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxmake&nbsp;-U&nbsp;gen&nbsp;vol&nbsp;volume01&nbsp;plex=plex01</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425273"></a>The created volume can then be started and mounted for use by the backup program. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425276"></a>Another common use of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font> is to remove DCM plexes from data volumes.  Removing all the DCMs from a single data volume disables SRL overflow protection for all the data volumes in the RVG.  The dissociation fails if the DCM is active. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425281"></a>You can also remove a mirror from a volume, as shown in the following example: </font>
</blockquote>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="434073"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxplex&nbsp;-o&nbsp;rm&nbsp;dis&nbsp;vol01-02</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434090"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mv</b></font></font>
</p>
<p>
<a name="439425"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Attach the plex <em>newplex</em> to the volume that <em>oldplex</em> is associated with and dissociate <em>oldplex</em>.  The volume cannot be disabled, and <em>newplex</em> must name a dissociated plex. The operation ensures seamless replacement of the dissociated plex without loss of data in the volume and without significant delays in volume accessibility. </font>
</p>
<p>
<a name="425300"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A primary purpose for the plex move operation is to move a plex that is using a disk to another location.  In support of this purpose for the operation, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o rm</b></font> can be specified to remove the original plex after completion of the operation. </font>
</p>
<p>
<a name="425305"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For concatenated or striped plexes, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd mv</b></font> operation can be used to move individual subdisks off a disk. The rules for performing the move depend upon the usage types of the volume to which <em>oldplex</em> is associated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434279"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>oem</b></font></font>
</p>
<p>
<a name="439462"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Not used in this release. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434298"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapabort</b></font></font>
</p>
<p>
<a name="439485"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This operation can be used in order to cancel the effects of a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434329"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font></font>
</p>
<p>
<a name="439512"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These two operations form the two parts of a preferred means of copying a volume to a plex for backup purposes.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart </b></font>operation attaches a plex to a volume and, when the operation is complete, leaves the plex associated as a temporary plex. </font>
</p>
<p>
<a name="425323"></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>-s</b></font> option is used to specify one or more source plexes, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font> synchronizes the data in the newly attached snapshot plex from the source plexes. </font>
</p>
<p>
<a name="425327"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If you use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font> to attach a pre-existing plex, run the following command to convert the state of the plex to SNAPDONE when the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart </b></font>operation is complete: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="434484"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxplex&nbsp;-g&nbsp;</font><em>diskgroup</em><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;convert&nbsp;state=SNAPDONE&nbsp;</font><font face="Courier New, Courier, sansserif, sans serif" size="2">plex</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425339"></a>After the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart </b></font>operation completes and the temporary plex is in the SNAPDONE state, you can use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex snapshot</b></font> to convert it into a new volume. If identical <em>new_volume</em> names are specified for two or more SNAPDONE plexes, a mirrored snapshot volume is created. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425345"></a>For convenience of administration, you can use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o comment=</b></font><em>comment</em> option with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot </b></font>to define a comment for the snapshot volume. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425349"></a>To improve the quality of the copies, some usage types attempt to make the detached plex consistent with respect to in-memory data. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425352"></a>This method of backup is preferable to using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex cp</b></font> because it allows you to coordinate breaking off the plex from the original volume at a well-defined point in time.  This is important, since attaching a plex to a volume can take a considerable amount of time, and it is difficult to know when it will complete. Also, directly converting the plex into a new volume is more convenient than requiring additional steps. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434733"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font></font>
</p>
<p>
<a name="439599"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This operation dissociates one or more named plexes from their current volume and attaches them to the specified volume. If a plex is the last in its current volume, this volume is removed from the disk group. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425366"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The volumes containing the named plexes and destination volume must be in the same disk group. 
</font>
<hr noshade size="2" width="100%" color="#000000">
</ul>
</p>
</ul>
</p>
</ul>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="434819"></a> OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434825"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c </b></font><em>checkpoint</em></font>
</p>
<p>
<a name="439630"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sets a named checkpoint on a snapshot. Note: This option is a deprecated feature of VVR and should not be used. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434856"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d </b></font><em>defaults_file</em></font>
</p>
<p>
<a name="439665"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the absolute pathname of a defaults file to use instead of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxplex</b></font>. The value that is assigned to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>usefmr</b></font> attribute in the defaults file defines whether or not <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> should attempts to use the FastResync feature when re-attaching a plex. </font>
</p>
<p>
<a name="425382"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> fails with an error if the defaults file specified to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font> option does not exist. </font>
</p>
<p>
<a name="425385"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">See the description of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font> command for more details. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434991"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font></font>
</p>
<p>
<a name="439705"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Forces an operation that VxVM considers potentially dangerous or of questionable use.  This permits a limited set of operations that would otherwise be disallowed.  Some operations may be disallowed even with this flag. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435046"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em></font>
</p>
<p>
<a name="439732"></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.  By default, the disk group is chosen based on the <em>name</em> operands. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435089"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> <em>useopt</em></font>
</p>
<p>
<a name="439755"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Passes in usage-type-specific options to the operation.  A certain set of operations are expected to be implemented by all usage types: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435120"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>comment=</b></font><em>comment</em></font>
</p>
<p>
<a name="439782"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sets a comment on a snapshot volume during a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font> operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435139"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dcoplex=</b></font><em>dco_plex</em></font>
</p>
<p>
<a name="439809"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the DCO plex to be used with a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>convert</b></font> operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435158"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iosize=</b></font><em>size</em></font>
</p>
<p>
<a name="439840"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Performs copy operations in regions with the length specified by <em>size</em>, which is a standard VERITAS Volume Manager length number (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M)).  Specifying a larger number typically causes the operation to complete sooner, but with greater impact on other processes using the volume.  The default I/O size is 1 megabyte. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435225"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>noecopy</b></font></font>
</p>
<p>
<a name="439871"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Turns off Extended Copy Services for one invocation of an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cp</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mv</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font> operation. By default, the Extended Copy Services feature  of VxVM automatically offloads copy requests to an array's copy manager if both the source and destination disks are enabled for ecopy operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435292"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nofmr</b></font></font>
</p>
<p>
<a name="439898"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Forces a full resynchronization during a <em>snapback</em> or <em>att</em> operation even if FastResync is enabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435324"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>numchild=</b></font><em>number</em></font>
</p>
<p>
<a name="439945"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of child processes that are used to perform resynchronization during <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapback</b></font> operations. The default value of <em>number</em> is 1 (no child processes), which is the same as specifying a <em>number</em> of 0. Specifying a larger value for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>number </b></font>potentially speeds up resynchronization, although the effectiveness of this depends to some extent on the underlying characteristics of the disk array. No further benefit in performance may be noticeable for a value for <em>number</em> greater than 3. </font>
</p>
<p>
<a name="425440"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">By default, the child processes divide the volume into equally sized chunks, which they then resynchronize independently with the volume. This behavior may be modified using the <em>useopt</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sequential</b></font>. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425444"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> A large <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iosize</b></font> of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>1m</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>2m</b></font> is recommended for use with this option. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435525"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>renamesnapplex</b></font></font>
</p>
<p>
<a name="439999"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies that a snapshot plex is renamed when the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapshot</b></font> operation is used to create a snapshot volume. If this option is not specified, the plex retains the same name that it had in the original volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435580"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resyncfromoriginal</b></font></font>
</p>
<p>
<a name="440026"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Chooses the original volume as the preferred copy of data during a <em>snapback</em> or <em>att</em> operation. This is the default behavior. </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="425458"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Unmount the snapshot volume (if mounted) before performing this operation. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435656"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>resyncfromreplica</b></font> </font>
</p>
<p>
<a name="440065"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Chooses the replica plex as the preferred copy of data during a <em>snapback</em> or <em>att</em> operation. <em>resyncfromoriginal</em> is the default behavior. </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="425466"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> Unmount the original volume (if mounted) before performing this operation. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435732"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rm</b></font></font>
</p>
<p>
<a name="440100"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Removes the plexes after successful completion of a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex dis </b></font>operation.  Remove the source plex after successful completion of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex mv</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435775"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sequential</b></font></font>
</p>
<p>
<a name="440131"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When specified with the <em>useopt</em> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>numchild </b></font>for values of <em>number</em> greater than 1, the child processes co-operate in resynchronizing regions of the volume that are close together, starting at the beginning of the volume and moving to the end. This creates more overhead for the resynchronization, but it potentially makes better use of the sequential read-ahead buffer of the physical disks. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435866"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>slow</b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>=</b></font><em>iodelay</em>]</font>
</p>
<p>
<a name="440162"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Reduces the system performance impact of copy operations. Such operations are usually performed on small regions of the volume (normally from 16 kilobytes to 128 kilobytes). This option inserts a delay between the recovery of each such region. A specific delay can be specified with <em>iodelay</em> as a number of milliseconds; otherwise, a default is chosen (normally 250 milliseconds). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435947"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-R </b></font><em>request_portal</em></font>
</p>
<p>
<a name="440189"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a rendezvous file path name for regular configuration and query requests. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/vold_request </b></font>is the default. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436002"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font><em>srcplex1</em> [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font><em>srcplex2</em>] ...</font>
</p>
<p>
<a name="440228"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies one or more source plexes to be used for resynchronization in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapstart</b></font> operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436033"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font> <em>tasktag</em></font>
</p>
<p>
<a name="440259"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If any tasks are registered to track the progress of the operation, marks them with the tag <em>tasktag</em>. The tag specified by <em>tasktag</em> is a sequence of up to 16 alphanumeric characters. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436089"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T </b></font><em>taskid</em></font>
</p>
<p>
<a name="440282"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Associates new tasks with the specified parent task ID. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436108"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U</b></font> <em>usetype</em></font>
</p>
<p>
<a name="440305"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Limits the operation to apply to this usage type.  Attempts to affect volumes with a different usage type fail. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436139"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v</b></font> <em>volume</em></font>
</p>
<p>
<a name="440336"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Requires that the plex named by a <em>plex</em> or <em>oldplex</em> operand be associated with the named volume.  This option can be used as a sanity check, to ensure that the specified plex is actually the plex desired for the operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436194"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-V</b></font></font>
</p>
<p>
<a name="440363"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays a list of utilities that would be called from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font>, along with the arguments that would be passed.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-V</b></font> option performs a preview run so the utilities are not actually called. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="436237"></a> FSGEN AND GEN USAGE TYPES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436242"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>gen</b></font> usage types provide similar, though not identical, semantics for all operations of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> utility. In particular, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font> usage type attempts to flush in-memory data cached for the file system residing on the volume.  For most file systems, this consists of calling <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sync</b></font>(1M) to attempt to flush all in-memory data to disk.  For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxfs</b></font> file system type, special ioctls are called to ensure a reliable flush of the involved volume. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436332"></a>If a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> operation is interrupted by a signal, then an attempt is made to restore the disk group configuration to a state that is roughly equivalent to its original state.  If this attempt is interrupted (such as through another signal) then the user may need to perform some cleanup.  The specific cleanup actions that are needed are written to the standard error before <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> exits. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436398"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>gen</b></font> usage types provide the following options as arguments to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> in addition to the required options: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436417"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>force</b></font></font>
</p>
<p>
<a name="440430"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Forces an operation that VxVM considers potentially dangerous or of questionable use.  This applies to attempts to detach or dissociate the last (complete) plex in a volume, or to attempts to move a plex to a plex that has a different size.  This flag is the same as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436484"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mapzero</b></font></font>
</p>
<p>
<a name="440449"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If a plex is moved to a new plex that has regions that are mapped to a subdisk in the destination, but are not mapped to a subdisk for any enabled, readable plex in the volume, then zero out that mapped region in the destination plex.  Without this flag, the mapped region may be left unchanged from its original contents. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436551"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rerr</b></font></font>
</p>
<p>
<a name="440472"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Ignore volume or plex read errors when copying data onto a plex.  A warning message is written to standard error if a read error occurs, but the error does not affect success of the operation.  This operation can be used only with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cp</b></font> operation; the operation is ignored if used with other operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436618"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>werr</b></font></font>
</p>
<p>
<a name="440495"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Ignore plex write errors when copying data onto a plex.  A warning message is written to standard error if a write error occurs, but the error does not affect success of the operation.  This operation can be used only with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cp</b></font> operation; the operation is ignored if used with other operations. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436684"></a>Limitations and extensions for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>gen</b></font> usage types consist of the following: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436703"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font></font>
</p>
<p>
<a name="440538"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the volume is enabled and one of the named plexes is associated with the volume, then the plex must be <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STALE</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ACTIVE</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>OFFLINE</b></font>.  If the operation succeeds in attaching a plex, then any I/O fail condition for the plex is cleared. Also, attaching to an enabled volume requires that the volume have at least one enabled, read-write plex. </font>
</p>
<p>
<a name="425584"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the volume is not enabled, then the named plexes are associated with the volume (if not already associated) and are set to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STALE</b></font> state, so that the plex is fully attached by the next <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol start</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol startall</b></font> operation that is applied to the volume. </font>
</p>
<p>
<a name="425590"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the log type of the volume is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>UNDEF</b></font> and an unassociated plex with a log subdisk is attached, the volume is automatically converted to have a log type of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DRL</b></font>.  Logging of volume changes is enabled when the volume has at least one enabled, associated plex with an enabled log subdisk and at least two read-write mode plexes. </font>
</p>
<p>
<a name="425597"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An attempt to attach an unassociated plex fails if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0 </b></font>field is not empty.  This makes it possible to prevent use of a plex by using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit set </b></font> to set the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font> field to a non-empty string.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font> field can then be cleared with either <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit set</b></font> or with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmend clear putil0</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436995"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cp</b></font></font>
</p>
<p>
<a name="440622"></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>fsgen</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>gen</b></font> usage types do not add any specific restrictions to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cp</b></font> operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437026"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>det</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font></font>
</p>
<p>
<a name="440649"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A detach or dissociate of a plex can fail for one of two reasons. In an enabled volume a detach or dissociate fails if applied to a plex that is the last complete, enabled, read-write plex in the volume and the volume contains two or more non-complete, enabled, read-write plexes.  In other words, a volume cannot be left with two enabled, non-complete plexes.  A complete plex is one that is at least as long as the volume, and has subdisks mapped to the plex for all blocks up to the length of the volume.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option is required to reduce a volume to containing one enabled, read-write, non-complete plex, or to having no enabled, read-write plexes at all. The other way a detach or dissociate can fail is if the plex is of type DCM and it is active. A DCM is active if SRL overflow protection is active or if a resync of a replicated volume is in progress. </font>
</p>
<p>
<a name="425622"></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>det</b></font> operation changes the state for an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ACTIVE</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CLEAN</b></font> plex to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>STALE</b></font>.  The next time the volume is started, the plex is re-attached automatically. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437232"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mv</b></font></font>
</p>
<p>
<a name="440695"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the destination plex has unmapped regions (a range of blocks in the plex with no backing subdisk) that are not mapped in the source plex, or if the destination plex is shorter than the source plex, then the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option is required.  Even with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>, the operation prevents the plex from being sparsed such that the volume would be left with two or more sparse, enabled, read-write plexes, but no complete plexes. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437322"></a> RAID5 USAGE-TYPE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437327"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5</b></font> usage type provides the following options as arguments to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> in addition to the required options: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437346"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>force</b></font></font>
</p>
<p>
<a name="440730"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Forces an operation that VxVM considers potentially dangerous or of questionable use. This applies to attempts to dissociate the RAID-5 plex of a non-<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font> volume or to remove the last RAID-5 log plex of a non-<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font> volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437400"></a>As with other usage types, if a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> operation is interrupted by a signal, then an attempt is made to restore the disk group configuration to a state that is roughly equivalent to its original state.  If this attempt is interrupted (such as through another signal) then the user may need to perform some cleanup.  The specific cleanup actions that are needed are written to the standard error before <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> exits. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437479"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5</b></font> usage type supports the following keywords as described here: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437486"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>att</b></font></font>
</p>
<p>
<a name="440773"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Attaches the named plexes to the named volume. If a plex has a layout of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RAID</b></font>, the plex is attached as the RAID-5 plex of the RAID-5 volume. To attach a RAID-5 plex to the volume, the volume must be disabled and be in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font> state, and the RAID-5 plex is given a state of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font>. </font>
</p>
<p>
<a name="425661"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If a plex has a layout other than <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>RAID</b></font>, the plex is attached as a RAID-5 log plex for the RAID-5 volume. If the volume has no RAID-5 log plexes, the log length for the volume is set to the length of the smallest log plex being attached. If the volume already has at least one log plex, a plex can only be attached as a log plex if its contiguous length is at minimum the volume's log length. RAID-5 log plexes cannot be sparse in respect to the volume's log length; attempts to attach a sparse log plex fail. </font>
</p>
<p>
<a name="425671"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the RAID-5 volume is not enabled, log plexes are attached and marked as STALE. If the RAID-5 volume is enabled and has no log plexes, attaching a log plex causes plexes being attached as log plexes to be zeroed before they are enabled. Otherwise, the new log plexes are attached write-only and the contents of the existing log plexes are copied to the new log plexes using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC_COPY</b></font> ioctls, after which the logs are enabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437760"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font></font>
</p>
<p>
<a name="440818"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Dissociates the named plex from the RAID-5 volume to which it is attached. If the plex is the RAID-5 plex of the volume and the volume is not <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font>, this requires the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o force</b></font> option, as any data on the volume would be lost. If the plex is a log plex for the volume and would leave the RAID-5 volume with no usable log plexes, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o force</b></font> option is required. </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="437838"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The RAID-5 usage type does not support the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>det</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>copy</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cp</b></font> operations. 
</font>
<hr noshade size="2" width="100%" color="#000000">

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="437856"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437862"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/default/vxplex</b></font></font>
</p>
<p>
<a name="440858"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Standard defaults file that can be used to determine whether FastResync is used when attaching plexes. An alternative defaults file may be specified by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font> option. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437905"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/usr/lib/vxvm/type/</b></font><em>usetype</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/vxplex</b></font></font>
</p>
<p>
<a name="440889"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The utility that performs <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex</b></font> operations for a particular volume usage type. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="437936"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/usr/lib/vxvm/type/fsgen/fs.d/</b></font><em>fstype</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/vxsync</b></font></font>
</p>
<p>
<a name="440928"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Path to a program used with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsgen</b></font> usage type for synchronizing in-memory file system data with a volume, for the file system type <em>fstype</em>.  The program is given arguments of a volume name and one or more plex names. For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxfs</b></font> file system  type, this program uses the VERITAS File System (VxFS) freeze feature to ensure a perfect synchronized detach. </font>
</p>

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

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


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="438081"></a> EXAMPLES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438086"></a>Associate plex <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol02-03</b></font> with the existing volume <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol02</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438107"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxplex&nbsp;att&nbsp;vol02&nbsp;vol02-03</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438123"></a>Temporarily detach plex <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol03-03</b></font> from its volume: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438144"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxplex&nbsp;det&nbsp;vol03-03</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438160"></a>Dissociate plex <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol01-03</b></font> from the plexes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol01-01</b></font> through <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol01-03</b></font> on volume <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol01</b></font>: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="438193"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxplex&nbsp;dis&nbsp;vol01-03</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="438209"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="438214"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sync</b></font>(1M), <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="vxedit_vxvm_manpages41_434625.html#430530"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit </b></font></font></a>(1M), <a href="vxintro_vxvm_manpages47_452164.html#439378"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro </b></font></font></a>(1M), <a href="vxmend_vxvm_manpages52_430893.html#428626"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmend </b></font></font></a>(1M), <a href="vxsnap_vxvm_manpages72_441468.html#434380"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsnap </b></font></font></a>(1M), <a href="vxtask_vxvm_manpages76_430825.html#428703"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask </b></font></font></a>(1M), <a href="vxvol_vxvm_manpages85_441003.html#433596"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxvol </b></font></font></a>(1M) </font>
</blockquote>

<!-- End Main Topic Content -->

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

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

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