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

</HEAD>

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

<a name="431606"></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="vxrelayout_vxvm_manpages62_430115.html" title="Previous - vxrelayout">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxres_lvmroot_vxvm_manpages64_429137.html" title="Next - vxres_lvmroot">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="429130"></a>vxrelocd</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429160"></a> NAME</font>
</h3>
<p>
<a name="429165"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxrelocd - monitor VERITAS Volume Manager for failure events and relocate failed subdisks  </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429168"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="429173"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/bin/vxrelocd </b></font>[<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o </b></font><em>vxrecover_argument</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-O </b></font><em>old_version</em>] [<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font><em>save_max</em>] [<em>mail_address</em>...] 
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429212"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429217"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd</b></font> command monitors VERITAS Volume Manager (VxVM) by analyzing the output of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxnotify</b></font> command, and waits for a failure. When a failure occurs, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>sends mail via <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mailx </b></font>to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>root </b></font>(by default) or to other specified users and relocates failed subdisks. After completing the relocation, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>sends more mail indicating the status of each subdisk replacement. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font>utility is then run on volumes with relocated subdisks to restore data. Mail is sent after <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font>executes. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429419"></a> OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429425"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font></font>
</p>
<p>
<a name="431828"></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>-o </b></font>option and its argument are passed directly to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font>if <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font>is called. This allows specifying <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o slow</b></font>[=<em>iodelay</em>] to keep <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font>from overloading a busy system during recovery. The default value for the delay is 250 milliseconds. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429548"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-O</b></font></font>
</p>
<p>
<a name="431855"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Reverts back to an older version. Specifying <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-O VxVM_version </b></font>directs <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>to use the relocation scheme in that version. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429606"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font></font>
</p>
<p>
<a name="431882"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Before <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>attempts a relocation, a snapshot of the current configuration is saved in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/saveconfig.d</b></font>. This option specifies the maximum number of configurations to keep for each diskgroup. The default is 32. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429682"></a> MAIL NOTIFICATION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429687"></a>By default, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>sends mail to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>root </b></font>with information about a detected failure and the status of any relocation and recovery attempts. To send mail to other users, add the user login name to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>startup line in the startup script <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/sbin/init.d/vxvm-recover </b></font>and reboot the system. For example, if the line appears as: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429825"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">nohup&nbsp;vxrelocd&nbsp;root&nbsp;&amp;</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429835"></a>and you want mail also to be sent to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>user1</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>user2</b></font>, change the line to read: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429871"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">nohup&nbsp;vxrelocd&nbsp;root&nbsp;user1&nbsp;user2&nbsp;&amp;</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429881"></a>Alternatively, you can kill the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>process and restart it as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd root </b></font><em>mail_address</em>, where <em>mail_address </em>is a user's login name. Do not kill the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd</b></font> process while a relocation attempt is in progress. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429958"></a>The mail notification that is sent when a failure is detected follows this format: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429985"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">Failures&nbsp;have&nbsp;been&nbsp;detected&nbsp;by&nbsp;the&nbsp;VERITAS&nbsp;Volume&nbsp;Manager:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429995"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">failed&nbsp;disks:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430000"></a><em>medianame</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430005"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430010"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">failed&nbsp;plexes:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430015"></a><em>plexname</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430020"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430025"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">failed&nbsp;log&nbsp;plexes:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430030"></a><em>plexname</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430035"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430040"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">failing&nbsp;disks:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430045"></a><em>medianame</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430050"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430055"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">failed&nbsp;subdisks:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430060"></a><em>subdiskname</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430065"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430075"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">The&nbsp;Volume&nbsp;Manager&nbsp;will&nbsp;attempt&nbsp;to&nbsp;find&nbsp;spare&nbsp;disks,</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430080"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">relocate&nbsp;failed&nbsp;subdisks&nbsp;and&nbsp;then&nbsp;recover&nbsp;the&nbsp;data&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430085"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">in&nbsp;the&nbsp;failed&nbsp;plexes.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430095"></a>The <em>medianame </em>list under <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>failed disks </b></font>specifies disks that appear to have completely failed; the <em>medianame </em>list under <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>failing disks </b></font>indicates a partial disk failure or a disk that is in the process of failing. When a disk has failed completely, the same <em>medianame </em>list appears under both <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>failed disks</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>failing disks</b></font>. The <em>plexname </em>list under <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>failed plexes </b></font>shows plexes that were detached due to I/O failures that occurred while attempting to do I/O to subdisks they contain. The <em>plexname </em>list under <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>failed log plexes </b></font>indicates RAID-5 or DRL (dirty region logging) log plexes that have failed. The <em>subdiskname </em>list specifies subdisks in RAID-5 volumes that were detached due to I/O errors. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430382"></a> SPARE SPACE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430387"></a>A disk can be marked as ''spare.'' This makes the disk available as a site for relocating failed subdisks.  Disks that are marked as spares are not used for normal allocations unless you explicitly specify them. This ensures that there is a pool of spare space available for relocating failed subdisks and that this space does not get consumed by normal operations.  Spare space is the first space used to relocate failed subdisks.  However, if no spare space is available, or the available spare space is not suitable or sufficient, free space is also used except for those marked with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>nohotuse</b></font> flag. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M) and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm</b></font>(1M) manual pages for more information on marking a disk as a spare or nohotuse. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430500"></a> NOHOTUSE SPACE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430505"></a>A disk can be marked as ''nohotuse.'' This excludes the disk from being used by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd</b></font>, but it is still available as free space. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit</b></font>(1M) and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm</b></font>(1M) manual pages for more information on marking a disk as a spare or nohotuse. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430566"></a> REPLACEMENT PROCEDURE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430571"></a>After mail is sent, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>relocates failed subdisks (those listed in the <em>subdisks</em> list). This requires finding appropriate spare or free space in the same disk group as the failed subdisk. A disk is eligible as replacement space if it is a valid VERITAS Volume Manager disk (VM disk) and contains enough space to hold the data contained in the failed subdisk. If no space is available on spare disks, the relocation uses free space that is not marked nohotuse. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430684"></a>To determine which of the eligible disks to use, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>first tries the disk that is closest to the failed disk. The value of ''closeness'' depends on the controller, target, and disk number of the failed disk. A disk on the same controller as the failed disk is closer than a disk on a different controller; a disk under the same target as the failed disk is closer than one under a different target. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430769"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>moves all subdisks from a failing drive to the same destination disk if possible. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430790"></a>If no spare or free space is found, mail is sent explaining the disposition of volumes that had storage on the failed disk: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430817"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">Hot-relocation&nbsp;was&nbsp;not&nbsp;successful&nbsp;for&nbsp;subdisks&nbsp;on&nbsp;disk</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430822"></a><em>dm_name</em>&nbsp;in&nbsp;volume&nbsp;<em>v_name</em>&nbsp;in&nbsp;disk&nbsp;group&nbsp;<em>dg_name</em><font face="Courier New, Courier, sansserif, sans serif" size="2">.</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430827"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">No&nbsp;replacement&nbsp;was&nbsp;made&nbsp;and&nbsp;the&nbsp;disk&nbsp;is&nbsp;still&nbsp;unusable.</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430837"></a>The&nbsp;following&nbsp;volumes&nbsp;have&nbsp;storage&nbsp;on&nbsp;<em>medianame</em><font face="Courier New, Courier, sansserif, sans serif" size="2">:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430847"></a><em>volumename</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430852"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430862"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">These&nbsp;volumes&nbsp;are&nbsp;still&nbsp;usable,&nbsp;but&nbsp;the&nbsp;redundancy&nbsp;of</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430867"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">those&nbsp;volumes&nbsp;is&nbsp;reduced.&nbsp;Any&nbsp;RAID-5&nbsp;volumes&nbsp;with&nbsp;storage&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430872"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">on&nbsp;the&nbsp;failed&nbsp;disk&nbsp;may&nbsp;become&nbsp;unusable&nbsp;in&nbsp;the&nbsp;face&nbsp;of&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430877"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">further&nbsp;failures.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430887"></a>If any non-RAID-5 volumes were made unusable due to the disk failure, the following message is included: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430915"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">The&nbsp;following&nbsp;volumes:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430925"></a><em>volumename</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430930"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430940"></a>have&nbsp;data&nbsp;on&nbsp;<em>medianame</em><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;but&nbsp;have&nbsp;no&nbsp;other&nbsp;usable&nbsp;mirrors&nbsp;on&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430945"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">other&nbsp;disks.&nbsp;These&nbsp;volumes&nbsp;are&nbsp;now&nbsp;unusable&nbsp;and&nbsp;the&nbsp;data&nbsp;on&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430950"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">them&nbsp;is&nbsp;unavailable.&nbsp;These&nbsp;volumes&nbsp;must&nbsp;have&nbsp;their&nbsp;data&nbsp;restored.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430960"></a>If any RAID-5 volumes were made unavailable due to the disk failure, the following message is included: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430987"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">The&nbsp;following&nbsp;RAID-5&nbsp;volumes:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430997"></a><em>volumename</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431002"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431012"></a>had&nbsp;storage&nbsp;on&nbsp;<em>medianame</em><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;and&nbsp;have&nbsp;experienced&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431017"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">other&nbsp;failures.&nbsp;These&nbsp;RAID-5&nbsp;volumes&nbsp;are&nbsp;now&nbsp;unusable&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431022"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">and&nbsp;data&nbsp;on&nbsp;them&nbsp;is&nbsp;unavailable.&nbsp;These&nbsp;RAID-5&nbsp;volumes&nbsp;must</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431027"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">have&nbsp;their&nbsp;data&nbsp;restored.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431037"></a>If there is spare space available, a snapshot of the current configuration is saved in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/saveconfig.d</b></font>/<em>dg_name.yymmdd_hhmmss</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>.mpvsh </b></font>before attempting a subdisk relocation. Relocation requires setting up a subdisk on the spare or free space not marked with nohotuse and using it to replace the failed subdisk. If this is successful, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover </b></font>command runs in the background to recover the data in volumes that had storage on the disk. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431131"></a>If the relocation fails, the following message is sent: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431158"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">Hot-relocation&nbsp;was&nbsp;not&nbsp;successful&nbsp;for&nbsp;subdisks&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431163"></a>on&nbsp;disk&nbsp;<em>dm_name</em>&nbsp;in&nbsp;volume&nbsp;<em>v_name</em><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;in&nbsp;disk&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431168"></a>group&nbsp;<em>dg_name</em><font face="Courier New, Courier, sansserif, sans serif" size="2">.&nbsp;No&nbsp;replacement&nbsp;was&nbsp;made</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431173"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">and&nbsp;the&nbsp;disk&nbsp;is&nbsp;still&nbsp;unusable.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431183"></a>If any volumes (RAID-5 or otherwise) become unusable due to the failure, the following message is included: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431210"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">The&nbsp;following&nbsp;volumes:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431220"></a><em>volumename</em>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431225"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431235"></a>have&nbsp;data&nbsp;on&nbsp;<em>dm_name</em><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;but&nbsp;have&nbsp;no&nbsp;other&nbsp;usable&nbsp;mirrors&nbsp;on&nbsp;other</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431240"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">disks.&nbsp;These&nbsp;volumes&nbsp;are&nbsp;now&nbsp;unusable&nbsp;and&nbsp;the&nbsp;data&nbsp;on&nbsp;them&nbsp;is</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431245"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unavailable.&nbsp;These&nbsp;volumes&nbsp;must&nbsp;have&nbsp;their&nbsp;data&nbsp;restored.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431255"></a>If the relocation procedure was successful and recovery has begun, the following mail message is sent: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431282"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">Volume&nbsp;</font><em>v_name</em>&nbsp;Subdisk&nbsp;<em>sd_name</em><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;relocated&nbsp;to&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431287"></a><em>newsd_name</em><font face="Courier New, Courier, sansserif, sans serif" size="2">,&nbsp;but&nbsp;not&nbsp;yet&nbsp;recovered.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431297"></a>After recovery completes, a mail message is sent relaying the result of the recovery procedure. If the recovery is successful, the following message is included in the mail: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431342"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">Recovery&nbsp;complete&nbsp;for&nbsp;volume&nbsp;</font><em>v_name</em><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;in&nbsp;disk&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431347"></a>group&nbsp;<em>dg_name</em><font face="Courier New, Courier, sansserif, sans serif" size="2">.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431357"></a>If the recovery was not successful, the following message is included in the mail: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431384"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">Failure&nbsp;recovering&nbsp;</font><em>v_name</em>&nbsp;in&nbsp;disk&nbsp;group&nbsp;<em>dg_name</em><font face="Courier New, Courier, sansserif, sans serif" size="2">.</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="431394"></a> DISABLING VXRELOCD</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431399"></a>If you do not want automatic subdisk relocation, you can disable the hot-relocation feature by killing the relocation daemon, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd</b></font>, and preventing it from restarting.  However, do not kill the daemon while it is doing the relocation.  To kill the daemon, run the command: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431453"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">ps&nbsp;-ef</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431463"></a>from the command line and find the two entries for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd</b></font>. Execute the command: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="431490"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">kill&nbsp;-9&nbsp;PID1&nbsp;PID2</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431500"></a>(substituting PID1 and PID2 with the process IDs for the two <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd</b></font> processes). To prevent <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd</b></font> from being started again, you must comment out the line that starts up <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd</b></font> in the startup script <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/sbin/init.d/vxvm-recover</b></font>. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="431548"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431554"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/sbin/init.d/vxvm-recover</b></font></font>
</p>
<p>
<a name="432259"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The startup file for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431567"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/saveconfig.d</b></font>/<em>dg_name.yymmdd_hhmmss</em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>.mpvsh</b></font></font>
</p>
<p>
<a name="432290"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">File where <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrelocd </b></font>saves a snapshot of the current configuration before performing a relocation. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="431606"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431611"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>kill</b></font>(1), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mailx</b></font>(1), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ps</b></font>(1), <a href="vxdiskadm_vxvm_manpages36_430557.html#428346"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdiskadm </b></font></font></a>(1M), <a href="vxedit_vxvm_manpages41_434625.html#430530"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxedit </b></font></font></a>(1M), <a href="vxintro_vxvm_manpages47_452164.html#439378"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxintro </b></font></font></a>(1M), <a href="vxnotify_vxvm_manpages54_430651.html#428549"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxnotify </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="vxsparecheck_vxvm_manpages73_429800.html#428311"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsparecheck </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) </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="vxrelocd_vxvm_manpages63_431606.html" title="vxrelocd">Return to Top</a></font>

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