Symantec logo

Attributes

Optional attributes

Optional attribute


Description

DefaultRouter 

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. 

Type and dimension: string-scalar 

Default: 0.0.0.0 

Example: "192.1.0.1" 

Failback 

If set to 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 set to 1, the agent ignores the driver-reported interface status while testing the interfaces. If set to 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. 

Type and dimension: integer-scalar 

Default: 1 

LinkTestRatio 

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 "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 set to 1, packets are sent during every monitor cycle. 

If set to 0, packets are never sent during a monitor cycle. 

Type and dimension: integer-scalar 

Default: 1 

Example: 3 

In this example, if the monitor agent function invokes in a numbered pattern such as 1, 2, 3, 4, 5, 6, ..., the actual packet send test is done at 3, 6, ... monitor agent functions. 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 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). 

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" 

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 set to 1, NoBroadcast prevents MultiNICB from sending broadcast ICMP packets. (Note: 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 helps to avoid oscillations in the status of the interface. 

Type and dimension: integer-scalar 

Default: 3