Attributes

Required attributes

Required attribute

Description

Device 

List of interfaces and their base IP addresses. 

Type and dimension: string-association 

Example: { lan0 = "192.205.8.42", lan3 = "192.205.8.42" } 

 

Optional attributes

Optional attribute

Description

ArpDelay 

Number of seconds to sleep between configuring an interface and sending out a broadcast to inform routers about the base IP address. 

Type and dimension: integer-scalar 

Default: 1 

 

HandshakeInterval 

Computes the maximum number of tries that 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.

To prevent spurious failovers, the agent must try to contact a host on the network several times before it marks a NIC as faulted. Increased values result in longer failover times, whether between the NICs or from system to system in the case of faulted NICs. 

Type and dimension: integer-scalar 

Default: 20 

This value is the equivalent to two tries. 

 

IfconfigTwice 

Causes an IP address to be configured twice, using an ifconfig up-down-up sequence. Increases the probability of gratuitous ARP requests (caused by ifconfig up) to reach clients. 

Type and dimension: integer-scalar 

 

NetworkHosts 

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 host name, 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. 

Type and dimension: string-vector 

Example: "166.93.2.1", "166.97.1.2" 

 

NetMask 

Netmask for the base IP address. You can specify the value of NetMask in decimal (base 10) or hexadecimal (base 16). 

Note   Symantec recommends that you specify a netmask for each virtual interface.

Type and dimension: string-scalar 

 

Options 

The ifconfig options for the base IP address. 

Type and dimension: string-scalar 

Example: "broadcast 192.203.15.255" 

 

PingOptimize 

A value of 1 indicates that the agent not perform broadcast pings. 

A value of 0 performs a broadcast ping each monitor cycle and detects the inactive interface within the cycle. 

Type and dimension: integer-scalar 

Default: 1 

 

RetestInterval 

Number of seconds to sleep between re-tests of a newly configured interface. 

A lower value results in faster local (interface-to-interface) failover. 

Type and dimension: integer-scalar 

Default: 5 

 

RouteOptions 

String to add a route when configuring an interface. Use only when configuring the local host as the default gateway.  

The string contains destination gateway metric. No routes are added if this string is set to NULL. 

Type and dimension: string-scalar 

Example: "default 192.98.16.103 0"