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

</HEAD>

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

<a name="430115"></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="vxrecover_vxvm_manpages61_429816.html" title="Previous - vxrecover">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxrelocd_vxvm_manpages63_431606.html" title="Next - vxrelocd">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="428262"></a>vxrelayout</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428292"></a> NAME</font>
</h3>
<p>
<a name="428297"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxrelayout - convert online storage from one layout to another </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428300"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428305"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o </b></font><em>useopt</em>] <br>[<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>reverse </b></font><em>volume </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428374"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g </b></font><em>diskgroup</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o </b></font><em>useopt</em>] <br>[<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>start </b></font><em>volume </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428443"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout status </b></font><em>volume </em>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428446"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout help | -H </b></font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428449"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428454"></a>Online relayout is a process where storage in a volume or a plex is converted from one layout to another maintaining data availability at all times. You can convert any supported VERITAS Volume Manager (VxVM) layout to another and change the stripe width or the number columns. You can also perform only stripe width and column changes. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428494"></a>The transformation of a volume or a plex must be initiated using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist</b></font>(1M) utility. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>creates necessary infrastructure and storage needed to perform the layout transformation and invokes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout </b></font>internally to actually perform the transformation. </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="425033"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The relayout operation internally generates unique data object names (for example, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>v2-Dp02</b></font>) when it converts a volume to a specified destination layout. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425037"></a>Because <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout </b></font>depends on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>to do all the setup before a layout transformation can begin, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxassist </b></font>utility must be used to initiate any layout transformation. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask</b></font>(1M) utility can monitor the state of an ongoing transformation. </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428696"></a>Because these transformations are time consuming (mainly depending on the volume size and chunk size), they can be interrupted because of a system crash, I/O failure, or the user voluntarily stopping the transformation process either by aborting the task associated with the transformation using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask</b></font> or by killing the transformation process. It is not advisable to use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>kill -9 </b></font>to stop the transformations. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout </b></font>utility can be used to continue or reverse a transformation process because of such interruptions. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428822"></a>VERITAS Volume Manager responses to possible interruptions are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428826"></a>I/O Failure</font>
</p>
<p>
<a name="430478"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> utility exits with an error on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">STDERR.</font> The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd</b></font>(1M) daemon tries to relocate the failed subdisks. If it succeeds, it invokes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover</b></font>(1M), which in turn invokes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> to continue the transformation. An I/O failure is transparent to the user if the relocation succeeds. If relocation fails, the transformation process is not restarted. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428898"></a>System Crash</font>
</p>
<p>
<a name="430501"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">On a reboot after a system crash, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover</b></font> starts all startable volumes, invoking <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout </b></font>on appropriate volumes and plexes. </font>
</p>
<p>
<a name="425082"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the user stops <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font>, then the transformation process can be reversed or continued by invoking <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> manually. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428983"></a>The first operand is a keyword that determines whether a layout conversion is to be continued, reversed, or to display the status of any existing transformation in the volume. For example, if a RAID-5 volume is being converted to STRIPED volume, reversal of such an operation will revert all data and storage in STRIPED format to the RAID-5 format. A reversal of a reversal is equivalent to a continue. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429036"></a>Even though such a capability of direction change can be used ad infinitum, it has been provided with an objective to react to unforeseen situations. It is advisable that such direction changes are done with care. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429059"></a>The direction of a transformation can be determined using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>status </b></font>operation provided in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> utility. This command will determine if any plex in the volume is being transformed and display its characteristics. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429080"></a>The second operand is the name of the topmost volume to which the plex undergoing relayout is attached. If there are multiple plexes in the volume and only one of them is being transformed, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> utility  will select the appropriate plex using the supplied volume name. It should be noted that there can only be one relayout operation happening in a volume at any instant of time. 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>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429142"></a>This operation can be applied only to disk groups with version 60 or above (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M)), and only to one disk group at a time. The supported storage layouts are: </font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425114"></a>concatenated </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425117"></a>striped </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425120"></a>RAID-5 </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425123"></a>mirrored </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425126"></a>striped-mirror </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425129"></a>concatenated-mirror </font>
</li>
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429260"></a>See the <em>VERITAS Volume Manager Administrator's Guide </em>for more information. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429281"></a> KEYWORDS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429287"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>help</b></font></font>
</p>
<p>
<a name="430563"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays information on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> usage. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429300"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reverse</b></font></font>
</p>
<p>
<a name="430582"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Reverses a discontinued layout conversion. This operation determines the current state and direction of a layout transformation and reverse where it was left off since it was last stopped. It is imperative that any existing layout transformation process is stopped before this operation is applied. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429349"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>start</b></font></font>
</p>
<p>
<a name="430601"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Continues a discontinued layout conversion. This operation determines the current state and direction of a layout transformation and continue where it was left off since it was last stopped. It is imperative that any existing layout transformation process is stopped before this operation is applied. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429398"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>status</b></font></font>
</p>
<p>
<a name="430620"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays the status of a discontinued or an ongoing layout conversion. This operation displays the characteristics of the source and the destination layout, such as the layout, number of columns, and stripe width. It also displays whether the transformation is ongoing or stopped, and the actual relayout percentage completed. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429448"></a> OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429454"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f</b></font></font>
</p>
<p>
<a name="430639"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Forces a continue or reverse of a layout transformation. This is considered potentially dangerous or questionable to use as using this flag may result in loss of data. This permits a limited set of operations that would otherwise be disallowed: </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="425170"></a>It is possible that an I/O failure during a layout transformation caused some plexes to detach, If the user still wants to continue or reverse such a transformation, this flag will have to be used to tell <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> to ignore the fact some plexes have failed. There is no guarantee that this operation will succeed. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425177"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> shrinks any existing file system on a volume if the layout transformation causes the volume size to decrease. If the user does not want <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> to shrink the file system but wants to still perform the layout conversion, this flag must be used. </font>
</li>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429599"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-g</b></font> <em>diskgroup</em></font>
</p>
<p>
<a name="430678"></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="429630"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font> <em>useopt</em></font>
</p>
<p>
<a name="430701"></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="429652"></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="430732"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Reduces 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; otherwise, a default is chosen (normally 250 milliseconds). </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429710"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>iosize</b></font>=<em>size</em></font>
</p>
<p>
<a name="430763"></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>
<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="425208"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> These parameters can also be changed using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask</b></font> utility during an online relayout. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429784"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>bg</b></font></font>
</p>
<p>
<a name="430798"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Run the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout </b></font>operation in the background. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429797"></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="430825"></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="429837"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t </b></font><em>tasktag</em></font>
</p>
<p>
<a name="430856"></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="429878"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T </b></font><em>taskid</em></font>
</p>
<p>
<a name="430879"></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="429891"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-U</b></font> <em>usetype</em></font>
</p>
<p>
<a name="430902"></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 will fail. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429913"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-H</b></font></font>
</p>
<p>
<a name="430925"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Displays information on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> usage. </font>
</p>
</ul>
</p>
</ul>
</p>
</ul>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429925"></a> EXIT CODES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429930"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelayout</b></font> exits with a non-zero status if the operation fails. A non-zero exit code is not a complete description of the problem; it only indicates the first condition that prevented further execution. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429960"></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="429963"></a> EXAMPLES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429968"></a>Check the progress of conversion of the volume homevol: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429986"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxrelayout&nbsp;status&nbsp;homevol</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429996"></a>Restart conversion of the volume homevol at a slow rate in the background (layout conversion having previously been stopped by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pause</b></font> keyword in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtask</b></font>): </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430041"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxrelayout&nbsp;-o&nbsp;slow,bg&nbsp;start&nbsp;homevol</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430054"></a>Reverse conversion of the volume homevol (layout conversion having previously been stopped): </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430099"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">vxrelayout&nbsp;reverse&nbsp;homevol</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430115"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430120"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>kill</b></font>(1), <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="vxdg_vxvm_manpages33_443062.html#434590"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg </b></font></font></a>(1M), <a href="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="vxrecover_vxvm_manpages61_429816.html#428010"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font></font></a>(1M), <a href="vxrelocd_vxvm_manpages63_431606.html#429130"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </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) </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430222"></a><em>VERITAS Volume Manager Administrator's Guide </em></font>
</blockquote>

<!-- End Main Topic Content -->

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

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

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