<!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>Required Attribute</title>

</HEAD>

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

<a name="376347"></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_vcs211_582096.html" title="Previous - MultiNICB Agent">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="storage_agents_vcs213_155551.html" title="Next - Storage Agents">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="376347"></a> Required Attribute</font>
</h2>

        
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583815"></a>
<Table width="100%" border="1" cellpadding="2" cellspacing="0" >
<tr valign="top"><td><b><a name="583819"></a>Required Attribute</b>
</td>
<td><b><a name="583821"></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="583823"></a>Device</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583825"></a>List of NICs that you want under MultiNICB control, and the aliases of those NICs. The IPMultiNICB agent uses the NIC aliases to configure IP addresses. The IPMultiNICB agent uses these interface aliases to determine the order of the interface on which to bring the IP addresses online.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583832"></a>Type and dimension: <a href="intro_agents_vcs195_104530.html#104586">string</a>-<a href="intro_agents_vcs195_104530.html#104677">association</a></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583833"></a>Example:</font>
</li>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="583834"></a>Device&nbsp;=&nbsp;{&nbsp;&quot;lan0&quot;&nbsp;,&nbsp;&quot;lan4&quot;&nbsp;}
</font>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583835"></a>Example:</font>
</li>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="583836"></a>Device&nbsp;=&nbsp;{&nbsp;&quot;lan0&quot;&nbsp;=&nbsp;0,&nbsp;&quot;lan1&quot;&nbsp;=&nbsp;2,&nbsp;&quot;lan2&quot;&nbsp;=&nbsp;3&nbsp;}
</font>
</ul><ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583837"></a>In this example, the MultiNICB agent uses interfaces <font face="Courier New, Courier, sansserif, sans serif" size="2">lan0</font>, <font face="Courier New, Courier, sansserif, sans serif" size="2">lan1</font>, and <font face="Courier New, Courier, sansserif, sans serif" size="2">lan2</font>. The MultiNICB agent passes on the associated interface aliases <font face="Courier New, Courier, sansserif, sans serif" size="2">0</font>, <font face="Courier New, Courier, sansserif, sans serif" size="2">2</font>, and <font face="Courier New, Courier, sansserif, sans serif" size="2">3</font> to the IPMultiNICB agent.</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="376390"></a>Optional Attributes</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583864"></a>
<Table width="100%" border="1" cellpadding="2" cellspacing="0" >
<tr valign="top"><td><b><a name="583868"></a>Optional Attribute</b>
</td>
<td><b><a name="583870"></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="583872"></a>DefaultRouter</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583874"></a>This is the IP address of the default router on the subnet. If specified, the agent removes the default route when the resource goes offline. The agent adds the route back when the group returns online. You must specify this attribute if multiple IP subnets exist on one host; otherwise, the packets cannot be routed properly when the subnet corresponding to the first default route goes down.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583881"></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="583882"></a>Default: <font face="Courier New, Courier, sansserif, sans serif" size="2">&quot;0.0.0.0&quot;</font></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583883"></a>Example: <font face="Courier New, Courier, sansserif, sans serif" size="2">&quot;192.1.0.1&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="583885"></a>Failback</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583887"></a>If set to <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font>, the virtual IP addresses are failed back to the original physical interface whenever possible. A value of <font face="Courier New, Courier, sansserif, sans serif" size="2">0</font> disables this behavior.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583894"></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="583895"></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="583897"></a>IgnoreLinkStatus</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583899"></a>If set to <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font>, the agent ignores the driver-reported interface status while testing the interfaces. If set to <font face="Courier New, Courier, sansserif, sans serif" size="2">0</font>, the agent reports the interface status as <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DOWN</font> if the driver-reported interface status indicates the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DOWN</font> state. Using interface status for link testing may considerably speed up failovers.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583906"></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="583907"></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="583909"></a>LinkTestRatio</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583911"></a>This is the ratio of total monitor cycles to monitor cycles in which the agent tests the interfaces by sending packets. At all other times, the agent tests the link by checking the &quot;link-status&quot; as reported by the device driver. Checking the &quot;link-status&quot; is a faster way to check the interfaces, but only detects cable disconnection failures.</font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583912"></a>If set to <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font>, packets are sent during every monitor cycle.</font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583913"></a>If set to <font face="Courier New, Courier, sansserif, sans serif" size="2">0</font>, packets are never sent during a monitor cycle.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583920"></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="583921"></a>Default: <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583922"></a>Example: <font face="Courier New, Courier, sansserif, sans serif" size="2">3</font></font>
</li>
</ul><ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583923"></a>In this example, if monitor entry-point invoking is numbered as <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font>, <font face="Courier New, Courier, sansserif, sans serif" size="2">2</font>, <font face="Courier New, Courier, sansserif, sans serif" size="2">3</font>, <font face="Courier New, Courier, sansserif, sans serif" size="2">4</font>, <font face="Courier New, Courier, sansserif, sans serif" size="2">5</font>, <font face="Courier New, Courier, sansserif, sans serif" size="2">6</font>, ..., the actual packet send test is done at <font face="Courier New, Courier, sansserif, sans serif" size="2">3</font>, <font face="Courier New, Courier, sansserif, sans serif" size="2">6</font>, ... monitor entry-points. For <font face="Courier New, Courier, sansserif, sans serif" size="2">LinkTestRatio=4</font>, the packet send test is done at <font face="Courier New, Courier, sansserif, sans serif" size="2">4</font>, <font face="Courier New, Courier, sansserif, sans serif" size="2">8</font>, ... monitor entry points.</font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583925"></a>NetworkHosts</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583927"></a>List of host IP addresses on the IP subnet that are pinged to determine if the interfaces are working. NetworkHosts only accepts IP addresses to avoid DNS lookup delays. The IP addresses must be directly present on the IP subnet of interfaces (the hosts must respond to ARP requests).</font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583928"></a>If IP addresses are not provided, the hosts are automatically determined by sending a broadcast ping (unless the NoBroadcast attribute is set to 1). The first host to reply serves as the ping destination.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583935"></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="583936"></a>Example: <font face="Courier New, Courier, sansserif, sans serif" size="2">{&nbsp;&quot;192.1.0.1&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="583938"></a>NetworkTimeout</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583940"></a>Timeout for ARP and ICMP packets in milliseconds. MultiNICB waits for response to ICMP and ARP packets only during this time period.</font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583941"></a>Assign NetworkTimeout a value in the order of tens of milliseconds (given the ICMP and ARP destinations are required to be on the local network). Increasing this value increases the time for failover.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583948"></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="583949"></a>Default: <font face="Courier New, Courier, sansserif, sans serif" size="2">100</font></font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583951"></a>NoBroadcast</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583953"></a>If set to 1, NoBroadcast prevents MultiNICB from sending broadcast ICMP packets. (Note: MultiNICB can still send ARP requests.)</font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583954"></a>If NetworkHosts are not specified and NoBroadcast is set to <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font>, the MultiNICB agent cannot function properly.</font>
</p>
<br>
<hr>
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="583955"></a><b>Note  &nbsp;&nbsp;&nbsp;</b>VERITAS does not recommend setting the value of NoBroadcast to <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font>.
</font>
<hr>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583962"></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="583963"></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="583965"></a>OfflineTestRepeatCount</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583967"></a>Number of times the test is repeated if the interface status changes from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">UP</font> to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DOWN</font>. For every repetition of the test, the next NetworkHost is selected in round-robin manner. At the end of this process, broadcast is performed if NoBroadcast is set to 0. A greater value prevents spurious changes, but also increases the response time.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583974"></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="583975"></a>Default: <font face="Courier New, Courier, sansserif, sans serif" size="2">3</font></font>
</li>
</ul></td>
</tr>
<tr valign="top"><td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583977"></a>OnlineTestRepeatCount</font>
</p>
</td>
<td><p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583979"></a>Number of times the test is repeated if the interface status changes from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DOWN</font> to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">UP</font>. This helps to avoid oscillations in the status of the interface.</font>
</p>
<ul compact><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="583986"></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="583987"></a>Default: <font face="Courier New, Courier, sansserif, sans serif" size="2">3</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="376495"></a>Checklist for Using MultiNICB</font>
</h2>
 
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="376497"></a>For the MultiNICB agent to function properly, you must satisfy each item in the following list:</font>
</p>

<ul><p><img src="images/check.gif" alt="Checkmark">&nbsp;
<a name="376498"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Each interface must have a unique MAC address.</font>
</p><p><img src="images/check.gif" alt="Checkmark">&nbsp;
<a name="376499"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A MultiNICB resource controls all the interfaces on one IP subnet.</font>
</p><p><img src="images/check.gif" alt="Checkmark">&nbsp;
<a name="376500"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">At boot time, you must plumb all the interfaces that are under the MultiNICB resource and give them test IP addresses.</font>
</p><p><img src="images/check.gif" alt="Checkmark">&nbsp;
<a name="376501"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">All test IP addresses for the MultiNICB resource must belong to the same subnet as the virtual IP address.</font>
</p><hr noshade size="2" width="100%" color="#000000">
<img src="images/tip.gif" alt="Tip " height="16" width="16">
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="376502"></a>&nbsp;<b>Tip  &nbsp;&nbsp;</b></font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000">The base IP addresses, which the agent uses to test the link status, should be reserved for use by the agent. These IP addresses do not get failed over.</font>
<hr noshade size="2" width="100%" color="#000000">
<p><img src="images/check.gif" alt="Checkmark">&nbsp;
<a name="516261"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If NetworkHosts is specified, the hosts must be directly accessible on the LAN.</font>
</p></ul>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="376523"></a>Trigger Script</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="376524"></a>MultiNICB monitor entry point calls a VCS trigger in case of an interface going up or down. The following arguments are passed to the script:</font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="376525"></a>MultiNICB resource name</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="376526"></a>device whose status changed (for example, <font face="Courier New, Courier, sansserif, sans serif" size="2">lan0</font>)</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="376527"></a>device's previous status (<font face="Courier New, Courier, sansserif, sans serif" size="2">0</font> for down, <font face="Courier New, Courier, sansserif, sans serif" size="2">1</font> for up)</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="376528"></a>device's current status</font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="582338"></a>monitor heartbeat</font>
</li>
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="376529"></a>The agent also sends a notification (which may be received via SNMP or SMTP) to indicate that status of an interface changed. The notification is sent using &quot;health of a cluster resource declined&quot; and &quot;health of a clusterresource improved&quot; traps which are mentioned in the <em>VCS User's Guide</em>. A sample <font face="Courier New, Courier, sansserif, sans serif" size="2">mnicb_postchange&nbsp;</font>trigger is provided with the agent. The user may customize this sample script as needed or write one from scratch.</font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="392090"></a>The sample script does the following:</font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="376530"></a>If interface changes status, it prints a message to the console, for example: <font face="Courier New, Courier, sansserif, sans serif" size="2">MultiNICB:&nbsp;Device&nbsp;lan0&nbsp;status&nbsp;changed&nbsp;from&nbsp;DOWN&nbsp;to&nbsp;UP.</font></font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="376531"></a>The script saves last IP address-to-interface name association. If any of the IP addresses has been moved, added, or removed, it prints out a message to the console, for example:<font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;MultiNICB:&nbsp;IP&nbsp;address&nbsp;192.4.3.3&nbsp;moved&nbsp;from&nbsp;interface&nbsp;lan1:1&nbsp;to&nbsp;interface&nbsp;lan0:1</font></font>
</li>
</ul>
</p>



<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="426968"></a>Sample Configuration</font>
</h2>
 



<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000"><a name="426977"></a>VCS Configuration</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="426978"></a>The following is an example VCS configuration.</font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581502"></a>include&nbsp;&quot;types.cf&quot;
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581503"></a>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581504"></a>cluster&nbsp;clus_north&nbsp;(
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581505"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;UserNames&nbsp;=&nbsp;{&nbsp;admin&nbsp;=&nbsp;&quot;cDRpdxPmHpzS.&quot;&nbsp;}
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581506"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Administrators&nbsp;=&nbsp;{&nbsp;admin&nbsp;}
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581507"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CounterInterval&nbsp;=&nbsp;5
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581508"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581509"></a>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581510"></a>system&nbsp;north
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581511"></a>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581512"></a>system&nbsp;south
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581513"></a>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581514"></a>group&nbsp;g11&nbsp;(
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581515"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SystemList&nbsp;=&nbsp;{&nbsp;north&nbsp;=&nbsp;0,&nbsp;south&nbsp;=&nbsp;1&nbsp;}
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581516"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;AutoStartList&nbsp;=&nbsp;{&nbsp;north,&nbsp;south&nbsp;}
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581517"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581518"></a>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581519"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;IPMultiNICB&nbsp;ipmnicb&nbsp;(
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581520"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;BaseResName&nbsp;=&nbsp;mnicb
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581521"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Address&nbsp;=&nbsp;&quot;192.1.0.201&quot;
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581522"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NetMask&nbsp;=&nbsp;&quot;255.255.0.0&quot;
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581523"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;DeviceChoice&nbsp;=&nbsp;1
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581524"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581525"></a>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581526"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;MultiNICB&nbsp;mnicb&nbsp;(
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581527"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Device&nbsp;@north&nbsp;=&nbsp;{&nbsp;lan0&nbsp;=&nbsp;0,&nbsp;lan4&nbsp;=&nbsp;1&nbsp;}
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581528"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Device&nbsp;@south&nbsp;=&nbsp;{&nbsp;lan0&nbsp;=&nbsp;0,&nbsp;lan4&nbsp;=&nbsp;1&nbsp;}
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581529"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;NetworkHosts&nbsp;=&nbsp;{&nbsp;&quot;192.1.0.1&quot;&nbsp;}
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581530"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;DefaultRouter&nbsp;=&nbsp;&quot;0.0.0.0&quot;
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581531"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581532"></a>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="581533"></a>&nbsp;ipmnicb&nbsp;requires&nbsp;mnicb
</font>

<!-- 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_vcs212_376347.html" title="Required Attribute">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_vcs211_582096.html" title="Previous - MultiNICB Agent">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="storage_agents_vcs213_155551.html" title="Next - Storage Agents">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>
