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

</HEAD>

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

<a name="429800"></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="vxsnap_vxvm_manpages72_441468.html" title="Previous - vxsnap">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxsplitlines_vxvm_manpages74_427039.html" title="Next - vxsplitlines">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="428311"></a>vxsparecheck</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428334"></a> NAME</font>
</h3>
<p>
<a name="428339"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxsparecheck - monitor VERITAS Volume Manager for failure events and replace failed disks </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428342"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="428347"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/bin/vxsparecheck </b></font>[<em>mail-address</em>...] 
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428359"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428364"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsparecheck</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, waiting for failures to occur. It then sends mail via <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mailx</b></font> to the logins specified on the command line, or (by default) to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>root</b></font>. It then replaces any failed disks. After an attempt at replacement is complete, mail will be sent indicating the status of each disk replacement. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428440"></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="428467"></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="428477"></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="428482"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">medianame</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428487"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428492"></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="428497"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">plexname</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428502"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428507"></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="428512"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">subdiskname</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428517"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428522"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">failed&nbsp;volumes:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428527"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">volumename</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428532"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;...</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428542"></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;hot-spare&nbsp;disks&nbsp;to&nbsp;replace&nbsp;any</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428547"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">failed&nbsp;disks&nbsp;and&nbsp;attempt&nbsp;to&nbsp;reconstruct&nbsp;any&nbsp;data&nbsp;in&nbsp;volumes&nbsp;that&nbsp;have</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428552"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">storage&nbsp;on&nbsp;the&nbsp;failed&nbsp;disk.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428562"></a>The <em>medianame</em> list specifies disks that appear to have completely failed. The <em>plexname</em> list show plexes of mirrored volumes that have been detached due to I/O failures experienced while attempting to do I/O to subdisks they contain. The <em>subdiskname </em>list specifies subdisks in RAID-5 volumes that have been detached due to I/O errors. The <em>volumename</em> list shows non-RAID-5 volumes that have become unusable because disks in all of their plexes have failed (and are listed in the ''failed disks'' list) and shows those RAID-5 volumes that have become unusable because of multiple failures. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428637"></a>If any volumes appear to have failed, the following paragraph will be included in the mail: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428664"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">The&nbsp;data&nbsp;in&nbsp;the&nbsp;failed&nbsp;volumes&nbsp;listed&nbsp;above&nbsp;is&nbsp;no&nbsp;longer</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428669"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">available.&nbsp;It&nbsp;will&nbsp;need&nbsp;to&nbsp;be&nbsp;restored&nbsp;from&nbsp;backup.</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="428679"></a> REPLACEMENT PROCEDURE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428684"></a>After mail has been sent, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsparecheck</b></font> finds a hot spare replacement for any disks that appear to have failed (that is, those listed in the <em>medianame</em> list). This involves finding an appropriate replacement for those eligible hot spares in the same disk group as the failed disk. A disk is eligible as a replacement if it is a valid VERITAS Volume Manager disk (VM disk), has been marked as a hot-spare disk and contains enough space to hold the data contained in all the subdisks on the failed disk. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428759"></a>To determine which disk from among the eligible hot spares to use, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxsparecheck</b></font> first checks the file <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/sparelist</b></font> (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>Sparelist File </b></font>below). If this file does not exist or lists no eligible hot spares for the failed disk, the disk that is ''closest'' to the failed disk is chosen. 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; and 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="428843"></a>If no hot spare disk can be found, the following mail is sent: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428861"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">No&nbsp;hot&nbsp;spare&nbsp;could&nbsp;be&nbsp;found&nbsp;for&nbsp;disk&nbsp;medianame&nbsp;in</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428866"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">diskgroup.&nbsp;No&nbsp;replacement&nbsp;has&nbsp;been&nbsp;made&nbsp;and&nbsp;the&nbsp;disk&nbsp;is&nbsp;still</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428871"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unusable.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428881"></a>The mail then explains the disposition of volumes that had storage on the failed disk. The following message lists disks that had storage on the failed disk, but are still usable: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428917"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">The&nbsp;following&nbsp;volumes&nbsp;have&nbsp;storage&nbsp;on&nbsp;medianame:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428927"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">volumename</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428932"></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="428942"></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="428947"></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="428952"></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;further&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428957"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">failures.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="428967"></a>If any non-RAID-5 volumes were made unusable due to the failure of the disk, the following message is included: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="428994"></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="429004"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">volumename</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429009"></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="429019"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">have&nbsp;data&nbsp;on&nbsp;medianame&nbsp;but&nbsp;have&nbsp;no&nbsp;other&nbsp;usable&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429024"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">mirrors&nbsp;on&nbsp;other&nbsp;disks.&nbsp;These&nbsp;volumes&nbsp;are&nbsp;now&nbsp;unusable&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429029"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">and&nbsp;the&nbsp;data&nbsp;on&nbsp;them&nbsp;is&nbsp;unavailable.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429039"></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="429066"></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="429076"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">volumename</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429081"></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="429091"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">had&nbsp;storage&nbsp;on&nbsp;medianame&nbsp;and&nbsp;have&nbsp;experienced&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429096"></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="429101"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">and&nbsp;data&nbsp;on&nbsp;them&nbsp;is&nbsp;unavailable.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429111"></a>If a hot-spare disk was found, a hot-spare replacement is attempted. This involves associating the device marked as a hot spare with the media record that was associated with the failed disk. If this is successful, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrecover</b></font>(1M) command is used in the background to recover the contents of any 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="429159"></a>If the hot-spare replacement fails, the following message is sent: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429177"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">Replacement&nbsp;of&nbsp;disk&nbsp;medianame&nbsp;in&nbsp;group&nbsp;diskgroup</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429182"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">failed.&nbsp;The&nbsp;error&nbsp;is:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429192"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">error&nbsp;message</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429202"></a>If any volumes (RAID-5 or otherwise) are rendered 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="429229"></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="429239"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">volumename</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429244"></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="429254"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">occupy&nbsp;space&nbsp;on&nbsp;the&nbsp;failed&nbsp;disk&nbsp;and&nbsp;have&nbsp;no&nbsp;other&nbsp;available</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429259"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">mirrors&nbsp;or&nbsp;have&nbsp;experienced&nbsp;other&nbsp;failures.&nbsp;These&nbsp;volumes&nbsp;are</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429264"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unusable,&nbsp;and&nbsp;the&nbsp;data&nbsp;they&nbsp;contain&nbsp;is&nbsp;unavailable.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429274"></a>If the hot-spare replacement procedure completed successfully and recovery is under way, a final mail message is sent: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429301"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">Replacement&nbsp;of&nbsp;disk&nbsp;medianame&nbsp;in&nbsp;group&nbsp;diskgroup&nbsp;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429306"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">with&nbsp;disk&nbsp;device&nbsp;sparedevice&nbsp;has&nbsp;successfully&nbsp;completed</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429311"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">and&nbsp;recovery&nbsp;is&nbsp;under&nbsp;way.</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429321"></a>If any non-RAID-5 volumes were rendered unusable by the failure despite the successful hot-spare procedure, the following message is included in the mail: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429357"></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="429367"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">volumename</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429372"></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="429382"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">occupy&nbsp;spare&nbsp;on&nbsp;the&nbsp;replaced&nbsp;disk,&nbsp;but&nbsp;have&nbsp;no&nbsp;other&nbsp;enabled</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429387"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">mirrors&nbsp;on&nbsp;other&nbsp;disks&nbsp;from&nbsp;which&nbsp;to&nbsp;perform&nbsp;recovery.&nbsp;These</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429392"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">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="429402"></a>If any RAID-5 volumes were rendered unusable by the failure despite the successful hot-spare procedure, the following message is included in the mail: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429438"></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="429448"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">volumename</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429458"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">have&nbsp;subdisks&nbsp;on&nbsp;the&nbsp;replaced&nbsp;disk&nbsp;and&nbsp;have&nbsp;experienced</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429463"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">other&nbsp;failures&nbsp;that&nbsp;prevent&nbsp;recovery.&nbsp;These&nbsp;RAID-5&nbsp;volumes</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429468"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">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="429478"></a>If any volumes (RAID-5 or otherwise) were rendered unusable, the following message is also included: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429505"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">To&nbsp;restore&nbsp;the&nbsp;contents&nbsp;of&nbsp;any&nbsp;volumes&nbsp;listed&nbsp;above,&nbsp;the</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429510"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">volume&nbsp;should&nbsp;be&nbsp;started&nbsp;with&nbsp;the&nbsp;command:</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429520"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;vxvol&nbsp;-f&nbsp;start&nbsp;volumename</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429530"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">and&nbsp;the&nbsp;data&nbsp;restored&nbsp;from&nbsp;backup.</font>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429540"></a> SPARELIST FILE</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429545"></a>The sparelist file is a text file that specifies an ordered list of disks to be used as hot spares when a specific disk fails. The system-wide sparelist file is located in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/sparelist</b></font>. Each line in the sparelist file specifies a list of spares for one disk. Lines beginning with the pound (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>#</b></font>) character and empty lines are ignored. The format for a line in the sparelist file is: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429635"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">[&nbsp;diskgroup:]&nbsp;diskname&nbsp;:&nbsp;spare1&nbsp;[&nbsp;spare2&nbsp;...&nbsp;]</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429645"></a>The <em>diskgroup</em> field, if present, specifies the disk group within which the disk and designated spares reside. If this field is not specified, the default disk group is determined using the rules given in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdg</b></font>(1M) manual page. The <em>diskname</em> specifies the disk for which spares are being designated. The <em>spare</em> list after the colon lists the disks to be used as hot spares. The list is order dependent; in case of failure of <em>diskname</em>, the spares are tried in order. A spare will be used only if it is a valid hot spare (see above). If the list is exhausted without finding any spares, the default policy of using the closest disk is used. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429747"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429753"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vx/sparelist</b></font></font>
</p>
<p>
<a name="430056"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies a list of disks to serve as hot spares for a disk. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429765"></a> NOTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429770"></a>The sparelist file is not checked in any way for correctness until a disk failure occurs. It is possible to inadvertently specify a non-existent disk or inappropriate disk or disk group. Malformed lines are also ignored. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429800"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429805"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mailx</b></font>(1), <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="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="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="vxsparecheck_vxvm_manpages73_429800.html" title="vxsparecheck">Return to Top</a></font>

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