Device 

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. 

Type and dimension: string-association 

Examples: 

In this example, the MultiNICB agent uses interfaces qfe0, qfe1, and qfe2. The MultiNICB agent passes on the associated interface aliases 0, 2, and 3 to the IPMultiNICB agent. 

Device = qfe0 , qfe4 

Device = qfe0 = 0, qfe1 = 2, qfe2 = 3 

Device = { "qfe0" , "qfe4" } 

Device = { "qfe0" = 0, "qfe1" = 2, "qfe2" = 3 } 

DefaultRouter 

This attribute is the IP address of the default router on the subnet. If you specify this value, 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. If you do not specify the value, the packets cannot be routed properly when the subnet corresponding to the first default route goes down. 

Type and dimension: string-scalar 

Default: 0.0.0.0 

Example: 192.1.0.1 

Example: "192.1.0.1" 

GroupName 

The GroupName attribute is the name of the IPMP group that you want to assign to the interfaces under the control of the agent. The name's length should not exceed 31 bytes. 

Type and dimension: string-scalar 

Example: IPMPgrp1 

Example: "IPMPgrp1" 

MpathdCommand 

This value is the path to the mpathd executable. Use MpathdCommand to kill or restart mpathd. See the UseMpathd attribute for details. 

Type and dimension: string-scalar 

Default: /usr/lib/inet/in.mpathd 

UseMpathd 

The legal values for this attribute are 0 and 1. All the MultiNICB resources on one system must have the same value for this attribute. 

See Base and Multipathing modes for Solaris. 

If the value of the attribute is 0, in.mpathd is automatically killed on that system. For more information about mpathd, refer to the Sun documentation. 

If the value of the attribute is 1, MultiNICB assumes that mpathd (in.mpathd) is running. This value restarts mpathd if it is not running already. 

Type and dimension: integer-scalar 

Default: 0 

Failback 

If the value of the attribute is 1, the virtual IP addresses are failed back to the original physical interface whenever possible. A value of 0 disables this behavior. 

Type and dimension: integer-scalar 

Default: 0 

IgnoreLinkStatus 

If the value of the attribute is 1, the agent ignores the driver-reported interface status while testing the interfaces. If the value of the attribute is 0, the agent reports the interface status as down if the driver-reported interface status indicates the down state. Using interface status for link testing may considerably speed up failovers. 

When you use trunked interfaces, you must set the value of this attribute to 1. Otherwise set it to 0. 

Type and dimension: integer-scalar 

Default: 1 

LinkTestRatio 

This attribute 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 "link-status" as reported by the device driver. Checking the "link-status" is a faster way to check the interfaces, but only detects cable disconnection failures. 

If the value of the attribute is 1, packets are sent during every monitor cycle. 

If the value of the attribute is 0, packets are never sent during a monitor cycle. 

Type and dimension: integer-scalar 

Default: 1 

Example: 3 

Example: "3" 

In this example, if monitor entry-point invoking is numbered as 1, 2, 3, 4, 5, 6, ..., the actual packet send test is done at 3, 6, ... monitor entry-points. For LinkTestRatio=4, the packet send test is done at 4, 8, ... monitor agent functions. 

NetworkHosts 

List of host IP addresses on the IP subnet that are pinged to determine if the interfaces work. 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). 

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. 

Type and dimension: string-vector 

Example: 192.1.0.1  

Example: "192.1.0.1"  

NetworkTimeout 

Timeout for ARP and ICMP packets in milliseconds. MultiNICB waits for response to ICMP and ARP packets only during this time period. 

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. 

Type and dimension: integer-scalar 

Default: 100 

NoBroadcast 

If the value of the attribute is 1, NoBroadcast prevents MultiNICB from sending broadcast ICMP packets. Note that MultiNICB can still send ARP requests. 

If NetworkHosts are not specified and NoBroadcast is set to 1, the MultiNICB agent cannot function properly. 

Note   Symantec does not recommend setting the value of NoBroadcast to 1.

Type and dimension: integer-scalar 

Default: 0 

OfflineTestRepeatCount 

Number of times the test is repeated if the interface status changes from up to down. 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. 

Type and dimension: integer-scalar 

Default: 3 

OnlineTestRepeatCount 

Number of times the test is repeated if the interface status changes from down to up. This test helps to avoid oscillations in the status of the interface. 

Type and dimension: integer-scalar 

Default: 3 

ConfigCheck 

If the value of the attribute is 1, the MultiNICB agent checks for: 

• All specified physical interfaces are in the same IP subnet and group, and have "DEPRECATED" and "NOFAILOVER" flags set on them.
• No other physical interface has the same subnet as the specified interfaces.

Valid values for this attribute are 0 and 1.  

Type and dimension: integer-scalar 

Default: 1 

MpathdRestart 

If the value of the attribute is 1, MultiNICB tries to restart mpathd. 

Valid values for this attribute are 0 and 1. 

Type and dimension: integer-scalar 

Default: 1