<!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="vx_vxhelp_2005c">
<meta name="LASTUPDATED" content="06/17/05 09:52:27">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="08_fence_admin.fm">
     
<title>Using the vxfentsthdw Utility</title>

</HEAD>

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

<a name="158833"></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="08_fence_admin_sfcfs44_143012.html" title="Previous - Before You Configure Coordinator Disks">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="08_fence_admin_sfcfs46_156452.html" title="Next - Adding or Removing Coordinator Disks">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="sfcfs_splashpage_docCD_sfcfs1_103036.vxhd" title="Storage Foundation Cluster File System Guides title page ">Storage Foundation Cluster File System Guides</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="sfcfs_iag_titlepage_docCD_sfcfs2_73700.vxhd" title="Cluster File System 4.1 Installation and Administration Guide title page ">Cluster File System 4.1 Installation and Administration Guide</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="158833"></a> Using the vxfentsthdw Utility</font>
</h2>

        
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="158892"></a>Use the vxfentsthdw utility to verify that the shared storage arrays support SCSI-3 persistent reservations and I/O fencing. VERITAS recommends testing several disks in each array. Only supported storage devices can be used with I/O fencing of shared storage.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="158895"></a>The vxfentsthdw utility, which can be run from a single system in the cluster, tests storage by setting SCSI-3 registrations on the specified disk, verifying the registrations, and removing them from the disk. </font>
</p>

<hr noshade size="2" width="100%" color="#000000">
<img src="images/caution.gif" alt="Caution " height="16" width="16">&nbsp;<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="159756"></a><b>Caution  &nbsp;&nbsp;</b></font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> The vxfentsthdw utility overwrites and destroys existing data on the disks. Use the -r option to ensue non-destructive testing.</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="159779"></a>In the following example, assume you are checking the shared device that both systems recognize. (It is also possible that each system would use a different name for the same physical device.)</font>
</p>

</ol>
<p><img src="images/stepintro.gif" height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="158903"></a>&nbsp;&nbsp;<b>To verify support for SCSI-3 persistent reservations</b></font>
</p>
<ol>
<li value="1">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="158904"></a>Start the utility on a single system:
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="158905"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>cd&nbsp;/opt/VRTSvcs/vxfen/bin</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="158906"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>./vxfentsthdw</b></font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="158907"></a>The utility provides an overview of its function and behavior. It warns you that the tests it performs overwrites any data on the disks you check. Output resembles:</font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="158909"></a>&nbsp;&nbsp;********&nbsp;WARNING!!!!!!!!&nbsp;********&nbsp;THIS&nbsp;UTILITY&nbsp;WILL&nbsp;DESTROY&nbsp;THE
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="158910"></a>DATA&nbsp;ON&nbsp;THE&nbsp;DISK!!
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="158911"></a>Do&nbsp;you&nbsp;still&nbsp;want&nbsp;to&nbsp;contnue&nbsp;:&nbsp;[y/n]&nbsp;(default:&nbsp;n)
</font>
<li value="2">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="158912"></a>Enter <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>y</b></font> to continue.
</font>
<li value="3">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="158913"></a>When prompted, enter the name of the first cluster node. In this example, &quot;star33.&quot;
</font>
<li value="4">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="159123"></a>When prompted, enter the name of the second cluster node. In this example, &quot;star34.&quot;
</font>
<li value="5">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="159124"></a>You are then prompted to enter the first and second disk names (see above). Verify the same disk is recognized by star33 and star34. Note the disk names, whether or not they are identical, must refer to the same physical disk. If they do not, testing terminates. The utility begins its check and reports its activities.
</font>
<li value="6">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="158919"></a>Run the vxfentsthdw utility on each disk to be verified.
</font>
<li value="7">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="158864"></a>Continue to the next section to configure coordinator disks.
</font>
</ol>



<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="148155"></a>Configuring Coordinator Disks</font>
</h2>
 
<ol>
<li value="1">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="143029"></a>Create a disk group <font face="Courier New, Courier, sansserif, sans serif" size="2">vxfencoorddg</font> on any cluster node.
</font>
<li value="2">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="143031"></a>Deport the disk group:
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="143032"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>vxdg&nbsp;deport&nbsp;vxfencoorddg</b></font>
</font>
<li value="3">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="143033"></a>Import the disk group with the <font face="Courier New, Courier, sansserif, sans serif" size="2">-t</font> option to avoid automatically importing it when the systems are rebooted:
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="143034"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>vxdg&nbsp;-t&nbsp;import&nbsp;vxfencoorddg</b></font>
</font>
<li value="4">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="143035"></a>Deport the disk group. Deporting the disk group prevents the coordinator disks from being used for other purposes.
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="143036"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>vxdg&nbsp;deport&nbsp;vxfencoorddg</b></font>
</font>
<li value="5">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="143037"></a>On each system, enter the command:
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="143038"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>echo&nbsp;&quot;vxfencoorddg&quot;&nbsp;&gt;&nbsp;/etc/vxfendg</b></font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="143039"></a>No spaces should appear between the quotes in the <font face="Courier New, Courier, sansserif, sans serif" size="2"><b>&quot;vxfencoorddg&quot;</b></font> text. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="143040"></a>This command creates the file <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/vxfendg</font>, which includes the name of the coordinator disk group. Based on the <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/vxfendg</font> file, the <font face="Courier New, Courier, sansserif, sans serif" size="2">rc</font> script creates the file <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/vxfentab</font> for use by the <font face="Courier New, Courier, sansserif, sans serif" size="2">vxfen</font> driver. The <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/vxfentab</font> file is a generated file and should not be modified.</font>
</p>
<li value="6">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="143041"></a>Issue the following command on each system to start I/O fencing:
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="143043"></a>&nbsp;&nbsp;#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>/etc/init.d/vxfen&nbsp;start</b></font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="143045"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">rc</font> startup script automatically creates <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/vxfentab</font> by reading the disks contained in the disk group listed in <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/vxfendg</font>. The script then invokes the <font face="Courier New, Courier, sansserif, sans serif" size="2">vxfenconfig</font> command, which configures the <font face="Courier New, Courier, sansserif, sans serif" size="2">vxfen</font> driver to start and use the coordinator disks listed in <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/vxfentab</font>. The same disks may be listed using different names on each system.</font>
</p>
</ol>

<!-- 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="08_fence_admin_sfcfs45_158833.html" title="Using the vxfentsthdw Utility">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="08_fence_admin_sfcfs44_143012.html" title="Previous - Before You Configure Coordinator Disks">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="08_fence_admin_sfcfs46_156452.html" title="Next - Adding or Removing Coordinator Disks">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="sfcfs_splashpage_docCD_sfcfs1_103036.vxhd" title="Storage Foundation Cluster File System Guides title page ">Storage Foundation Cluster File System Guides</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="sfcfs_iag_titlepage_docCD_sfcfs2_73700.vxhd" title="Cluster File System 4.1 Installation and Administration Guide title page ">Cluster File System 4.1 Installation and Administration Guide</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>
