<!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 10:11:06">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="04_pkg_install.fm">
     
<title>Configuring Membership Heartbeat Regions on Disk (optional)</title>

</HEAD>

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

<a name="246090"></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="04_pkg_install_vcs48_114282.html" title="Previous - Configuring LLT and GAB">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="04_pkg_install_vcs50_122483.html" title="Next - Configuring VCS">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="vcs_splashpage_docCD_vcs1_103036.vxhd" title="Cluster Server Guides title page ">Cluster Server 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="vcs_install_titlepage_docCD_vcs2_73700.vxhd" title="Cluster Server 4.1 Installation Guide title page ">Cluster Server 4.1 Installation 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>
	
<h1><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="+1" color="#000000"><a name="246090"></a> Configuring Membership Heartbeat Regions on Disk (optional)</font>
</h1>
         
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246091"></a>You can set up disk heartbeating on a shared disk to provide an additional path for VCS heartbeating (see <a href="01_intro_vcs9_101061.html#108164">Two Types of Channels: Network and Shared Disks</a>). With disk heartbeating configured in addition to the private network connections, VCS has multiple heartbeat paths available. For example, if one of two private network connections fails, VCS has the remaining network connection and the disk heartbeat region that allow heartbeating to continue normally.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246095"></a>With disk heartbeating configured, each system in the cluster periodically writes to and reads from specific regions on a dedicated shared disk. This exchange consists of heartbeating only, and does not include communication about cluster status.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246096"></a>Because disk heartbeats do not support cluster communication, a failure of private network links that leaves only a disk heartbeat link between one system and the remaining nodes in the cluster causes the system to have a special jeopardy status. The system is excluded from regular cluster membership with the other systems because the status of its resources cannot be known by other systems. While the system in special jeopardy can continue to function, its resources are prevented from failing over or being switched over. This prevents possible data corruption in a split-brain situation.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246100"></a>The <em>VERITAS Cluster Server User's Guide</em> contains a description of how VCS uses heartbeating to provide cluster systems a means to determine the status of their peers and to prevent possible data corruption on shared storage. The <em>VERITAS Cluster Server User's Guide</em> also describes reconnecting private networks.</font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="246106"></a>Editing the /etc/gabtab File to Add Heartbeat Regions</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246107"></a>You can set up heartbeat regions on a shared disk by using <font face="Courier New, Courier, sansserif, sans serif" size="2">gabdiskhb(</font>1M) commands. You must enter these commands in the <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/gabtab</font> file identically on each system (see <a href="04_pkg_install_vcs48_114282.html#315456">Configuring Group Membership and Atomic Broadcast (GAB)</a>). The heartbeat regions on the shared disk are configured when the systems start up.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246111"></a>When configuring disk heartbeating, you must create two membership heartbeat regions on the disk, each consisting of 128 blocks: one for the GAB control (port a) and one for the VCS (port h).</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246114"></a>In the following illustrated example, two systems are connected by two shared disks. Each system uses a separate controller for each disk.</font>
</p>

<a name="no_figure_caption0"> </a>  <!-- Start Image Code -->
  <!--
   CAUTION: If graphics output is truncated, change the paper size setting 
   of your WebWorks Rasterizer printer driver from "A4" to "Letter" and regenerate your project.
  -->

<p>
<a href="04_pkg_installa_t.htm">
<img src="images/04_pkg_installa.gif" width="55" height="52" border="0" ></a>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1"><em>Click the thumbnail above to view full-sized image. </font></em></p>
   <!-- End Image Code -->



<p><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="246253"></a>
<b>Allocation of Heartbeat Disk Regions</b></font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246400"></a>The illustrated configuration is specified in a <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/gabtab</font> file that resembles:</font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257570"></a>gabdiskhb&nbsp;-a&nbsp;/dev/vg01/lvol1&nbsp;-s&nbsp;0&nbsp;-p&nbsp;a
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257571"></a>gabdiskhb&nbsp;-a&nbsp;/dev/vg01/lvol1&nbsp;-s&nbsp;128&nbsp;-p&nbsp;h
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257572"></a>gabdiskhb&nbsp;-a&nbsp;/dev/vg02/lvol1&nbsp;-s&nbsp;0&nbsp;-p&nbsp;a
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257573"></a>gabdiskhb&nbsp;-a&nbsp;/dev/vg02/lvol1&nbsp;-s&nbsp;128&nbsp;-p&nbsp;h
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257574"></a>gabconfig&nbsp;-c&nbsp;-n&nbsp;2
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246417"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">-s</font> option to the <font face="Courier New, Courier, sansserif, sans serif" size="2">gabdiskhb</font> command specifies the start location of each 128-block region. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246419"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">-p</font> option specifies the port: the value &quot;<font face="Courier New, Courier, sansserif, sans serif" size="2">a</font>&quot; specifies the GAB control port, and the value &quot;<font face="Courier New, Courier, sansserif, sans serif" size="2">h</font>&quot; specifies the VCS port. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246420"></a>The regions should not overlap. Two adjacent regions must have starting blocks separated by 128 blocks. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246421"></a>Usually, the first 16 blocks of the first partition of the disk are reserved. If the partition you are using is not the first partition on the disk, the start locations may be 0 and 128.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246422"></a>Note the following considerations when configuring heartbeat disk regions.</font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246423"></a>A disk partition containing a heartbeat region cannot be used for any other purpose, such as a file system or volume.</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246424"></a>If a disk containing heartbeat regions is also used for other purposes, the traffic could adversely affect performance of the heartbeating. </font>
</li>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="257580"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000">EMC disk arrays do not support the creation of GAB disk objects, and, therefore, do not support the creation of disk heartbeat regions.
</font>
<hr noshade size="2" width="100%" color="#000000">
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246427"></a>The /etc/gabtab file is used at startup to create the regions on the disk. Reboot each system to implement the configuration. After the system starts up, you can display the configured heartbeat regions by entering:</font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="246428"></a>#&nbsp;<font face="Courier New, Courier, sansserif, sans serif" size="2"><b>/sbin/gabdiskhb&nbsp;-l</b></font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257592"></a>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257593"></a>Port&nbsp;&nbsp;Disk&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Major&nbsp;&nbsp;&nbsp;Minor&nbsp;&nbsp;&nbsp;&nbsp;Start&nbsp;&nbsp;&nbsp;&nbsp;Active
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257594"></a>==========================================================
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257595"></a>a&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/dev/vg01/lvol1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;37&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;8&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;01
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257596"></a>h&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/dev/vg01/lvol1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;37&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;8&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;128&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;01
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257597"></a>a&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/dev/vg02/lvol1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;37&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;7&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;01
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257598"></a>h&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/dev/vg02/lvol1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;37&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;7&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;128&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;01
</font>



<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="246450"></a>Adding GAB Disk Region Signatures (Optional) for Integrity</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246451"></a>To guarantee the integrity of the GAB disk region, GAB can be directed to verify a signature in that region on a periodic basis. This optional feature ensures that valuable data on the disk, such as a filesystem, is not accidently overwritten.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246453"></a>You can use the <font face="Courier New, Courier, sansserif, sans serif" size="2">gabdiskconf</font>(1M) command to initialize the region with the specified signature. This must be done before the gabdiskhb command is run manually or from the <font face="Courier New, Courier, sansserif, sans serif" size="2">/etc/gabtab</font> file during boot. </font>
</p>




<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="246454"></a>Example, Configuring and Checking for a Signature</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246455"></a>In the following example, GAB disk regions are initialized by assigning signatures. </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257605"></a>gabdiskconf&nbsp;-i&nbsp;/dev/vg01/lvol1&nbsp;-s&nbsp;0&nbsp;-S&nbsp;1123
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257606"></a>gabdiskconf&nbsp;-i&nbsp;/dev/vg01/lvol1&nbsp;-s&nbsp;128&nbsp;-S&nbsp;1124
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246462"></a>The disk regions, starting at block 16 and 144 of the block device <font face="Courier New, Courier, sansserif, sans serif" size="2">/dev/dsk/c1t1d2s3</font>, are assigned the 4-byte strings of 1123 and 1124, respectively, as signatures.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246463"></a>Later, the regions are configured as heartbeating regions by the <font face="Courier New, Courier, sansserif, sans serif" size="2">gabdiskhb</font> command. In the following example, the <font face="Courier New, Courier, sansserif, sans serif" size="2">gabdiskhb</font> command specifies that GAB check the signatures on a periodic basis.</font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257613"></a>gabdiskhb&nbsp;-a&nbsp;/dev/vg01/lvol1&nbsp;-s&nbsp;0&nbsp;-p&nbsp;a&nbsp;-S&nbsp;1123
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="257614"></a>gabdiskhb&nbsp;-a&nbsp;/dev/vg01/lvol1&nbsp;-s&nbsp;128&nbsp;-p&nbsp;h&nbsp;-S&nbsp;1124
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="246470"></a>If GAB determines that a signature does not match the user's specified value, it marks the disk as faulted.</font>
</p>


<!-- 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="04_pkg_install_vcs49_246090.html" title="Configuring Membership Heartbeat Regions on Disk (optional)">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="04_pkg_install_vcs48_114282.html" title="Previous - Configuring LLT and GAB">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="04_pkg_install_vcs50_122483.html" title="Next - Configuring VCS">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="vcs_splashpage_docCD_vcs1_103036.vxhd" title="Cluster Server Guides title page ">Cluster Server 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="vcs_install_titlepage_docCD_vcs2_73700.vxhd" title="Cluster Server 4.1 Installation Guide title page ">Cluster Server 4.1 Installation 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>
