Required attributes

Required attribute



List of interfaces and their base IP addresses. 

Type and dimension: string-association 

Example: { le0 = "", qfe3 = "" } 



Required to use the IPv6 protocol. 

See Protocol 


Optional attributes

Optional attribute



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 



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

If the value of the RetestInterval attribute is five (default), each try takes about 10 seconds. 

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 (20/10). 



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 



Netmask for the base IP address. 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 

Default: + 

Example: "" 



The 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 causes the ping to hang. If this attribute is unspecified, the monitor tests the NIC by pinging the broadcast address on the NIC. 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: "", "" 



The ifconfig options for the base IP address. 

Type and dimension: string-scalar 

Example: "trailers" 



Number of monitor cycles to detect if the configured interface is inactive. A value of 1 optimizes broadcast pings and requires two monitor cycles. 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 



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 



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 0" 



Specifies the type of IP protocol (IPv4 or IPv6) that you want to use with the agent. 

When you use the IPv6 protocol, you must configure values for this attribute, the Device attribute, and the corresponding IPMultiNIC agent's PrefixLen attribute. 

Type-dimension: string-scalar 

Default: IPv4 

Example: IPv6