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

</HEAD>

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

<a name="433542"></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="vxrvg_vxvm_manpages68_434599.html" title="Previous - vxrvg">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxse_vxvm_manpages70_427988.html" title="Next - vxse">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="429949"></a>vxsd</font>
</h2>

        

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

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429980"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="429985"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-Vf</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>-t </b></font><em>tasktag</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>aslog </b></font><em>plex subdisk </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430051"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-Vf</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>-l </b></font><em>offset </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>-t </b></font><em>tasktag</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>assoc </b></font><em>plex subdisk... </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430126"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-Vf</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>-l </b></font><em>column</em>[<em>/offset </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>-t </b></font><em>tasktag</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>assoc </b></font><em>plex subdisk </em>[:<em>column</em>[<em>/offset </em>]]... 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430210"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-Vf</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>-p </b></font><em>plex </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>-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>subdisk... </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430285"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-Vf</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>-p </b></font><em>plex </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>-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>join </b></font><em>sd1 sd2...newsd </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430360"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-Vf</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>-p </b></font><em>plex </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>-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>oldsd newsd </em>[newsd...] 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430444"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-Vf</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>-p </b></font><em>plex </em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font><em>size</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>-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>split </b></font><em>subdisk newsd </em>[<em>newsd2</em>] 
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430537"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430542"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd</b></font> utility performs VERITAS Volume Manager (VxVM) operations on subdisks and on plex-and-subdisk 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="430590"></a>Each operation can be applied to only one disk group at a time. Any plex or subdisk name operands will be used to determine a default disk group, according to the standard disk group selection rules described in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M).  A specific disk group can be selected with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430638"></a>If a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd</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>vxsd</b></font> exits. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430686"></a> KEYWORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430692"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>aslog</b></font></font>
</p>
<p>
<a name="434162"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Associates the named subdisk with the named plex as a log area for the plex.  At most, one log subdisk can be associated with a plex at any given time.  Currently, log subdisks can be used only with the dirty region logging feature, as defined by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DRL</b></font> volume logging type.  If the named plex is associated with a volume, then the rules for performing the operation depend upon the usage type of the volume.  A subdisk cannot be associated if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font> field is set on the subdisk, just as with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd assoc</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430768"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>assoc</b></font></font>
</p>
<p>
<a name="434193"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Associates each named subdisk operand with the specified plex. The first form applies to concatenated plexes (that is, with a layout of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>concat</b></font>).  The offset within the plex for the association can be specified with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-l</b></font>, which takes a standard VERITAS Volume Manager length number (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro(1M)</b></font>).  If no offset is specified, then the default is to associate the subdisk at the end of the plex, thus extending the length of the plex by the length of the new subdisk. </font>
</p>
<p>
<a name="425107"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For striped plexes, a column number for the subdisk association may be specified. The offset is interpreted as the column offset for the subdisk. If only one number is specified with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-l</b></font> for striped plexes, the number is interpreted as a column number and the subdisk is associated at the end of the column. </font>
</p>
<p>
<a name="425114"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The column or column/offset at which a subdisk is to be associated can also be specified as part of the subdisk name in the same manner as subdisks associations are specified for plex creations in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font> (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake</b></font>(4)). When specifying multiple subdisks, if no column or column/offset is specified for a subdisk, it is associated after the previous subdisk. </font>
</p>
<p>
<a name="425121"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A subdisk cannot be associated to overlap with an another associated subdisk in the same plex. </font>
</p>
<p>
<a name="425124"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the named plex is associated with a volume, then the rules for performing the operation depend upon the usage type of the volume.  A subdisk cannot be associated to a plex if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0</b></font> field for the subdisk is not empty.  Creating a subdisk with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>putil0 </b></font>field set to a non-empty value is a sufficient means of ensuring that no VERITAS Volume Manager operation will write to the region of disk blocks allocated to the subdisk because the subdisk cannot be associated through any means to a plex, and because subdisks cannot be used directly to read from or write to a disk. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431080"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font></font>
</p>
<p>
<a name="434244"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Dissociates each specified subdisk from the plex that it is associated with. If a subdisk is associated (through its plex) with a volume, then the rules for performing the operation depend upon the usage type of the volume. </font>
</p>
<p>
<a name="425141"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Subdisk dissociation can be used as part of tearing down a plex, or as part of reorganization of disk space usage.  Typically, the subdisk is no longer needed after dissociation.  To support this type of use, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o rm</b></font> can be specified to remove the named subdisks after successful dissociation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431181"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join</b></font></font>
</p>
<p>
<a name="434302"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Joins the subdisks named by the <em>sd</em> operands to form a new subdisk named <em>newsd</em>.  The <em>sd</em> operands must specify subdisks that represent contiguous sections of the same device, and of the same plex (if they are associated).  For a striped plex, the <em>sd</em> operands must be in the same column. At least two <em>sd</em> operands are required.  At the end of the operation, the <em>sd</em> configuration objects are removed.  The <em>newsd</em> operand can have the same name as one of the <em>sd</em> operands, or it can have a different name. </font>
</p>
<p>
<a name="425157"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the <em>sd</em> operands are associated with an associated plex, then the rules for performing the operation depend upon the usage type of the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431291"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mv</b></font></font>
</p>
<p>
<a name="434340"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Moves the contents of <em>oldsd</em> onto the new subdisks and replaces <em>oldsd</em> with the new subdisks for any associations.  If multiple new subdisks are specified, they are associated starting where the old subdisk began and placed consecutively with no space between them. The operation requires that <em>oldsd</em> be associated with an associated plex and that all new subdisks be dissociated.  The operation can be used on a subdisk that is used by an active volume, and will ensure that data is copied and associations are changed without loss or corruption of data. The rules for performing the operation depend upon the usage type of the volume. </font>
</p>
<p>
<a name="425174"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Moving a subdisk is the normal means of reorganizing disk space.  For example, move regions of disk used by one volume to another disk to reduce contention on the original disk.  Typically, once the operation completes, the original subdisk is no longer needed and can be removed.  To support this use of the operation, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o rm</b></font> can be specified to remove <em>oldsd</em> after successful completion of the operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431473"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font></font>
</p>
<p>
<a name="434406"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Split the subdisk <em>subdisk</em> into two subdisks that reside on the same section of the same device, and that have contiguous plex associations (if the named subdisk is associated).  The first of the two resultant subdisks will have a length of <em>size</em>, and the second will take up the remainder of the space used by the original subdisk.  If both <em>newsd</em> and <em>newsd2</em> are specified, then the resulting subdisks are <em>newsd</em> and <em>newsd2</em>.  If no <em>newsd2</em> operand was specified, then the resultant subdisks are named <em>subdisk</em> and <em>newsd</em>. </font>
</p>
<p>
<a name="425194"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the named subdisk is associated with an associated plex, then the rules for performing the operation depend upon the usage type of the volume.  Log subdisks cannot be split. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="431591"></a> OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431597"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font></font>
</p>
<p>
<a name="434432"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Discard the relocation origin information in the subdisk record. When a user attempts to manually move a subdisk that has been hot-relocated, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d </b></font>option can be specified to discard the relocation origin information in the subdisk record. When this option is specified, the subdisk will not be unrelocated to its original disk using the vxunreloc utility. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431682"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font></font>
</p>
<p>
<a name="434451"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Force 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="431722"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font> <em>diskgroup</em></font>
</p>
<p>
<a name="434478"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specify 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="431753"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-l </b></font> [<em>column</em>]<em>offset</em></font>
</p>
<p>
<a name="434513"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specify the offset of a subdisk within a plex address space for the <em>vxsd assoc</em> operation. For striped plexes, a column number may be optionally specified. If one number is given for striped plexes the number is interpreted as a column number and the subdisk is associated at the end of the column. The offset is a standard length number in VxVM (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro(1M)</b></font>). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431811"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o </b></font> <em>useopt</em></font>
</p>
<p>
<a name="434536"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Pass 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="431833"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iosize=</b></font><em>size</em></font>
</p>
<p>
<a name="434567"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Perform 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="431882"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>noecopy</b></font></font>
</p>
<p>
<a name="434590"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Turns off Extended Copy Services for one invocation of a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd mv </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="431931"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rm</b></font></font>
</p>
<p>
<a name="434617"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Remove the subdisks after successful completion of a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd dis </b></font>operation.  Remove the source subdisk after successful completion of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd mv</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431962"></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="434648"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Reduce the system performance impact of copy operations.  Copy operations are usually a set of short copy operations 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, or a default is chosen (normally 250 milliseconds). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432020"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-p </b></font> <em>plex</em></font>
</p>
<p>
<a name="434683"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Require that a named subdisk (source subdisk for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd split</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mv</b></font>) be associated with this plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432042"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-r</b></font></font>
</p>
<p>
<a name="434706"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Retain the relocation origin information in the subdisk record. When a user attempts to manually move a subdisk that has been hot-relocated, either the -r or the -d option has to be provided to specify the disposition of the origin information, otherwise, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd</b></font> command returns an error. The -r option provides the user a way to retain the relocation origin information during a manual move. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432109"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font> <em>size</em></font>
</p>
<p>
<a name="434737"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specify the size for the subdisk <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font> operation.  This option takes a standard VERITAS Volume Manager length number (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro</b></font>(1M)). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432140"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t </b></font> <em>tasktag</em></font>
</p>
<p>
<a name="434768"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If any tasks are registered to track the progress of the operation, mark 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="432181"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U </b></font> <em>usetype</em></font>
</p>
<p>
<a name="434791"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Limit the operation to apply to this usage type.  Attempts to affect volumes with a different usage type will fail. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432203"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-v </b></font> <em>volume</em></font>
</p>
<p>
<a name="434826"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Require that a named plex be associated with this volume, or that a named subdisk (source subdisk for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd split</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mv</b></font>) be associated with a plex that is associated with this volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432243"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-V </b></font></font>
</p>
<p>
<a name="434853"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Write a list of utilities that would be called from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd</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> 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="432273"></a> FSGEN AND GEN USAGE TYPES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432278"></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 identical semantics for all operations of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd</b></font> utility. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432290"></a>In addition to the standard <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> options required for all usage types, 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 additional option: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432312"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>force</b></font></font>
</p>
<p>
<a name="434900"></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 subdisks (making a plex sparse) and to attempts to move subdisks onto subdisks that have 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="432360"></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="432373"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>aslog</b></font></font>
</p>
<p>
<a name="434935"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If a log subdisk is associated with a plex that is associated with a volume that has a logging type of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>UNDEF</b></font>, then the logging type of the volume is converted to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>DRL</b></font>.  Logging of volume changes is not enabled until there are at least two read-write mode plexes attached to the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432422"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>assoc</b></font></font>
</p>
<p>
<a name="434986"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the named plex is enabled, and is associated with an enabled plex, then the named plex must be <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>EMPTY</b></font>.  Subdisks can be associated with a non-enabled plex only if the utility state of the plex is <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>STALE</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>OFFLINE</b></font>, or if the plex is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CLEAN</b></font> and no other plexes associated with the volume are <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CLEAN</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ACTIVE</b></font>. </font>
</p>
<p>
<a name="425333"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the subdisk is associated with a non-enabled plex, or if it is associated with the only enabled, read-write plex in a volume, then the operation completes without copying any data onto the subdisk.  If the subdisk is associated with an enabled plex in a mirrored volume, then the operation may have to copy data from the volume onto the new subdisk before the operation can complete. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432541"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font></font>
</p>
<p>
<a name="435024"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Dissociating a subdisk requires use of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> if it would cause an enabled plex in an enabled volume to become sparse relative to the volume.  Even with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>, it is not possible to make two plexes sparse if no complete, enabled, read-write plexes would remain associated.  For disabled volumes, a similar check is made with respect to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ACTIVE</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>CLEAN</b></font> plexes. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432599"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mv</b></font></font>
</p>
<p>
<a name="435051"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the total size of the destination subdisks differs from that of the source subdisk, then the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> option must be specified.  The operation still fails if the total size of the destination subdisks is larger than the source subdisk and if the address range of any destination subdisk would conflict with another subdisk that is associated with the plex.  The total size of the destination subdisks cannot be larger than the source subdisk if the kernel state of the volume or plex is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>detached</b></font>. </font>
</p>
<p>
<a name="425359"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The operation fails if the total size of the  destination subdisks is smaller than the source subdisk and the operation would cause the total number of complete, enabled, read-mode plexes in the volume to drop to zero, while leaving more than one sparse, enabled, read-write plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432737"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join</b></font></font>
</p>
<p>
<a name="435093"></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 apply no additional restrictions and add no extensions to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join </b></font>operations. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="432767"></a> RAID-5 USAGE TYPE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432772"></a>In addition to the standard <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> options required for all usage types, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5</b></font> usage type provides the following additional option: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432794"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>force</b></font></font>
</p>
<p>
<a name="435124"></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 move a subdisk in a RAID-5 plex if the volume the plex is associated with does not have a log plex. 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="432833"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5</b></font> usage type supports the following keywords: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432837"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>assoc</b></font></font>
</p>
<p>
<a name="435167"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Associate the named subdisks with the named RAID-5 plex. If plex is enabled and is associated with an enabled volume, then any data that maps onto the subdisk will be regenerated from the other columns of the RAID-5 plex. This is done by marking the subdisk as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stale</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writeonly</b></font>, regenerating the data via <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOL_R5_RECOVER</b></font> ioctls, and then turning off the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stale</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writeonly</b></font> flags. </font>
</p>
<p>
<a name="425391"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the RAID-5 plex is not associated or the RAID-5 volume is not <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENABLED</b></font>, the subdisk is associated and marked as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stale</b></font>. The subdisk's contents will be recovered when the volume is started. </font>
</p>
<p>
<a name="425395"></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>assoc</b></font> operation may not be used on a log plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432954"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dis</b></font></font>
</p>
<p>
<a name="435216"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Dissociate the named subdisks from the named RAID-5 plex. If removing the subdisk would make the volume unusable (because other subdisks in other columns at the same altitude are unusable or missing) and the volume is not disabled and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font>, the operation is not allowed. If the volume is disabled and non-<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMPTY</b></font> the operation requires use of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>. </font>
</p>
<p>
<a name="425405"></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>dis</b></font> operation may not be used on a log plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433029"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mv</b></font></font>
</p>
<p>
<a name="435250"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the old subdisk is associated with a RAID-5 plex that is associated to a RAID-5 volume, the volume must be enabled for the move operation to complete. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mv</b></font> operation creates a redundant subvolume structure and synchronizes the new subdisk(s) using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOL_R5_RECOVER</b></font> ioctls. This makes the operation safe in case of failures in the new subdisks, and does not put the integrity of the data at risk. </font>
</p>
<p>
<a name="425416"></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>mv</b></font> operation may be used on a log plex. Similar rules as those defined 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 type plexes apply to log plexes. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>force</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font> must be used to make a log plex sparse. </font>
</p>
<p>
<a name="425421"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Note that there is no <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>aslog</b></font> operation for the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>raid5</b></font> usage type. Logging is done on a plex level and therefore <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd</b></font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>aslog</b></font> is not needed. Log plexes can be associated with RAID-5 volumes using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxplex att</b></font> command. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433182"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join</b></font></font>
</p>
<p>
<a name="435331"></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>raid5</b></font> usage type applies no additional restrictions and adds no extensions to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>split</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>join</b></font> operations. These operations may not be used on a log plex. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433212"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433218"></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>/vxsd</b></font></font>
</p>
<p>
<a name="435362"></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>vxsd</b></font> operations for a particular volume usage type. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433239"></a> EXIT CODES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433244"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsd</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="433274"></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="433295"></a> EXAMPLES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433300"></a>Split subdisk disk03-02 (with size 2000 megabytes) into subdisks disk03-02, disk03-03, disk03-04 and disk03-05 (each with size 500 megabytes): </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433345"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsd&nbsp;-s&nbsp;1000m&nbsp;split&nbsp;disk03-02&nbsp;disk03-02&nbsp;disk03-04</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433350"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsd&nbsp;-s&nbsp;500m&nbsp;split&nbsp;disk03-02&nbsp;disk03-02&nbsp;disk03-03</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433355"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsd&nbsp;-s&nbsp;500m&nbsp;split&nbsp;disk03-04&nbsp;disk03-04&nbsp;disk03-05</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433365"></a>Join contiguous subdisks disk03-02, disk03-03, disk03-04 and disk03-05 as subdisk disk03-02: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433392"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsd&nbsp;join&nbsp;disk03-02&nbsp;disk03-03&nbsp;disk03-02</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433397"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsd&nbsp;join&nbsp;disk03-02&nbsp;disk03-04&nbsp;disk03-02</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433402"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsd&nbsp;join&nbsp;disk03-02&nbsp;disk03-05&nbsp;disk03-02</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433412"></a>Move the contents of subdisk disk02-02 slowly to subdisk disk03-01, and then remove disk02-02: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433439"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsd&nbsp;-o&nbsp;rm,slow&nbsp;mv&nbsp;disk02-02&nbsp;disk03-01</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433449"></a>Add subdisk disk03-02 to the end of the concatenated plex, agg-01: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433467"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsd&nbsp;assoc&nbsp;agg-01&nbsp;disk03-02</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433477"></a>Add subdisks disk03-03, disk04-03, and disk05-03 to the ends of the three columns in the striped plex, okapi-01: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433504"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsd&nbsp;assoc&nbsp;okapi-01&nbsp;disk03-03:0&nbsp;disk04-03:1&nbsp;disk05-03:2</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433514"></a>Dissociate subdisk disk04-01 from its plex, and then remove it altogether: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433532"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxsd&nbsp;-o&nbsp;rm&nbsp;dis&nbsp;disk04-01</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433542"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433547"></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="vxintro_vxvm_manpages47_452164.html#439378"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro </b></font></font></a>(1M), <a href="vxmake_vxvm_manpages50_437196.html#431699"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxmake </b></font></font></a>(1M), <a href="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="vxunreloc_vxvm_manpages81_428110.html#427142"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxunreloc </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="vxsd_vxvm_manpages69_433542.html" title="vxsd">Return to Top</a></font>

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