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

</HEAD>

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

<a name="243157"></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="network_agents_vcs204_381657.html" title="Previous - Type Definition">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="network_agents_vcs206_393043.html" title="Next - Using RouteOptions">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_bundled_agents_titlepage_docCD_vcs186_73700.vxhd" title="Cluster Server 4.1 Bundled Agents Reference Guide title page ">Cluster Server 4.1 Bundled Agents Reference 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="243157"></a> Optional Attributes</font>
</h2>

        
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583574"></a>
<Table width="100%" border="1" cellpadding="2" cellspacing="0" >
<tr valign="top"><td><b><a name="583578"></a>Optional Attribute</b>
</td>
<td><b><a name="583580"></a>Description, Type and Dimension, Default, and Example</b>
</td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583582"></a>ArpDelay</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583584"></a>Number of seconds to sleep between configuring an interface and sending out a broadcast to inform routers about the base IP address.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583591"></a>Type and dimension: <a href="intro_agents_vcs195_104530.html#104607">integer</a>-<a href="intro_agents_vcs195_104530.html#104638">scalar</a></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583592"></a>Default: <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font></font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583594"></a>HandshakeInterval</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583596"></a>Computes the maximum number of attempts the agent makes either to ping a host (listed in the NetworkHosts attribute) when it fails over to a new NIC, or to ping the default broadcast address (depending on the attribute configured) when it fails over to a new NIC.</font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583597"></a>To prevent spurious failovers, the agent must try to contact a host on the network several times before marking a NIC as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">FAULTED</font>. Increased values result in longer failover times, whether between the NICs or from system to system in the case of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">FAULTED</font> NICs.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583604"></a>Type and dimension: <a href="intro_agents_vcs195_104530.html#104607">integer</a>-<a href="intro_agents_vcs195_104530.html#104638">scalar</a></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583605"></a>Default: <font face="Courier New, Courier, sansserif, sans serif" size="2">20</font></font>
</li>
</ul><ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583606"></a>This is the equivalent to two attempts.</font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583608"></a>IfconfigTwice</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583610"></a>Causes an IP address to be configured twice, using an <font face="Courier New, Courier, sansserif, sans serif" size="2">ifconfig up-down-up</font> sequence. Increases the probability of gratuitous ARP requests (caused by <font face="Courier New, Courier, sansserif, sans serif" size="2">ifconfig up</font>) to reach clients.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583617"></a>Type and dimension: <a href="intro_agents_vcs195_104530.html#104607">integer</a>-<a href="intro_agents_vcs195_104530.html#104638">scalar</a></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583618"></a>Default: <font face="Courier New, Courier, sansserif, sans serif" size="2">0</font></font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583620"></a>NetworkHosts</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583622"></a>List of hosts on the network that are pinged to determine if the network connection is alive. Enter the IP address of the host, instead of the HostName, to prevent the monitor from timing out. DNS can cause the ping to hang. If more than one network host is listed, the monitor returns online if at least one of the hosts is alive.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583629"></a>Type and dimension: <a href="intro_agents_vcs195_104530.html#104586">string</a>-<a href="intro_agents_vcs195_104530.html#104642">vector</a></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583630"></a>Example: <font face="Courier New, Courier, sansserif, sans serif" size="2">{&nbsp;&quot;166.93.2.1&quot;&nbsp;,&nbsp;&quot;166.97.1.2&quot;&nbsp;}</font></font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583632"></a>NetMask</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583634"></a>Netmask for the base IP address. You can specify the value of NetMask in decimal (base 10) or hexadecimal (base 16).</font>
</p>
<br>
<hr>
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="583635"></a><b>Note  &nbsp;&nbsp;&nbsp;</b>VERITAS recommends that you specify a netmask for each virtual interface.
</font>
<hr>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583642"></a>Type and dimension: <a href="intro_agents_vcs195_104530.html#104586">string</a>-<a href="intro_agents_vcs195_104530.html#104638">scalar</a></font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583644"></a>Options</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583648"></a>The <font face="Courier New, Courier, sansserif, sans serif" size="2">ifconfig</font> options for the base IP address.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583655"></a>Type and dimension: <a href="intro_agents_vcs195_104530.html#104586">string</a>-<a href="intro_agents_vcs195_104530.html#104638">scalar</a></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583656"></a>Example: <font face="Courier New, Courier, sansserif, sans serif" size="2">&quot;broadcast&nbsp;192.203.15.255&quot;</font></font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583658"></a>PingOptimize</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583660"></a>Number of monitor cycles to detect if the configured interface is inactive. A value of <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font> optimizes broadcast pings and requires two monitor cycles. A value of <font face="Courier New, Courier, sansserif, sans serif" size="2">0</font> performs a broadcast ping each monitor cycle and detects the inactive interface within the cycle.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583667"></a>Type and dimension: <a href="intro_agents_vcs195_104530.html#104607">integer</a>-<a href="intro_agents_vcs195_104530.html#104638">scalar</a></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583668"></a>Default: <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font></font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583670"></a>RetestInterval</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583672"></a>Number of seconds to sleep between re-tests of a newly configured interface.</font>
</p>
<br>
<hr>
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="583673"></a><b>Note  &nbsp;&nbsp;&nbsp;</b>A lower value results in faster local (interface-to-interface) failover.
</font>
<hr>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583680"></a>Type and dimension: <a href="intro_agents_vcs195_104530.html#104607">integer</a>-<a href="intro_agents_vcs195_104530.html#104638">scalar</a></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583681"></a>Default: <font face="Courier New, Courier, sansserif, sans serif" size="2">5</font></font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583683"></a>RouteOptions</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583685"></a>String to add a route when configuring an interface. Use only when configuring the local host as the default gateway. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583686"></a>The string contains <font face="Courier New, Courier, sansserif, sans serif" size="2">destination gateway metric</font>. No routes are added if this string is set to NULL.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583693"></a>Type and dimension: <a href="intro_agents_vcs195_104530.html#104586">string</a>-<a href="intro_agents_vcs195_104530.html#104638">scalar</a></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583694"></a>Example: <font face="Courier New, Courier, sansserif, sans serif" size="2">&quot;default&nbsp;192.98.16.103&nbsp;0&quot;</font></font>
</li>
</ul></td>
</tr>

</table>


<Table width="100%" border="0" cellpadding="1" cellspacing="0">
<tr><td>
</Table></font>
</p>




<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="165898"></a>MultiNICA Notes</font>
</h2>
 
<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="160523"></a>If all NICs configured in the Device attribute are down, the MultiNICA agent faults the resource after a two to three minute interval. This delay occurs because the MultiNICA agent tests the failed NIC several times before marking the resource <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">OFFLINE</font>. Messages recorded in the engine log during failover provide a detailed description of the events that take place. (The engine log is located in <font face="Courier New, Courier, sansserif, sans serif" size="2">/var/VRTSvcs/log/engine_A.log</font>.)</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="133160"></a>The MultiNICA agent supports only one active NIC on one IP subnet; the agent does not work with multiple active NICs on the same subnet. </font>
</li>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="572904"></a>For example, you have one active NIC, <font face="Courier New, Courier, sansserif, sans serif" size="2">lan0(10.128.2.5)</font>, and you configure a second NIC, <font face="Courier New, Courier, sansserif, sans serif" size="2">lan1</font>, as the backup NIC to <font face="Courier New, Courier, sansserif, sans serif" size="2">lan0</font>. The agent does not fail over from <font face="Courier New, Courier, sansserif, sans serif" size="2">lan0</font> to <font face="Courier New, Courier, sansserif, sans serif" size="2">lan1</font> because all ping tests are redirected through <font face="Courier New, Courier, sansserif, sans serif" size="2">lan0</font> on the same subnet, making the MultiNICA monitor return an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">ONLINE</font> status. Note that using <font face="Courier New, Courier, sansserif, sans serif" size="2">ping&nbsp;-i</font> does not enable the use of multiple active NICs. </font>
</blockquote>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="160565"></a>Before you start VCS, configure the primary NIC with the correct broadcast address and netmask.</font>
</li>
</ul>
</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="network_agents_vcs205_243157.html" title="Optional Attributes">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="network_agents_vcs204_381657.html" title="Previous - Type Definition">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="network_agents_vcs206_393043.html" title="Next - Using RouteOptions">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_bundled_agents_titlepage_docCD_vcs186_73700.vxhd" title="Cluster Server 4.1 Bundled Agents Reference Guide title page ">Cluster Server 4.1 Bundled Agents Reference 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>
