Attributes for MultiNICA agent

For Solaris:

Table: Required attributes

Required attribute

Description

Device

List of interfaces and their base IP addresses.

For each system you must localize the attribute with a separate base IP address.

Type and dimension: string-association

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

Protocol

For more information, see Table: Optional attributes.

NetMask

For more information, see Table: Optional attributes.

Table: 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 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).

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

NetMask

Netmask for the base IP address. Specify the value of NetMask in decimal (base 10).

You must configure this attribute if the IP address is an IPv4 address.

Type and dimension: string-scalar

Example: "255.255.255.0"

NetworkHosts

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. If an invalid network host address is specified or if there is a mismatch in protocol of the network host and Protocol attribute of resource, the resource enters an UNKNOWN state.

Type and dimension: string-vector

Example: "128.93.2.1", "128.97.1.2"

Options

The ifconfig options for the base IP address.

Type and dimension: string-scalar

Example: "failover"

For complete list of ifconfig options refer to ifconfig manpage.

PingOptimize

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

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

Protocol

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