Search <book_title>...

InfoScale™ 9.0 Cluster Server Bundled Agents Reference Guide - AIX

Last Published: 2025-09-09

Product(s): InfoScale & Storage Foundation (9.0)

Platform: AIX

Attributes for MultiNICB agent

Table: Required attributes

Required attribute	Description
Device	Lists the interfaces that you want the agent to monitor. You can assign a unique base IP address to each interface. Use the AIX SMIT configuration tool to configure the base IP addresses and to make them persistent across reboots. When you use the IPv6 protocol, you must configure the value for this attribute with base IPv6 addresses. You need to also configure the corresponding IPMultiNICB agent's PrefixLen attribute. When a network interface or a network adapter of the type MultiNICB under VCS control is renamed, you must update the value of the Device attribute of the MultiNICB resource. Note: Arctera recommends to offline the service groups containing the network resources before renaming the network interfaces and adapters and to update the VCS configuration to avoid any undesired behaviour. Type and dimension: string-association IPv4 example: { en1= "10.182.9.34", en2 = "10.182.10.34" } IPv6 example: { en1 = "2001:db8::1", en2 = "2001:db8::2" }

Required attribute

Description

Device

Lists the interfaces that you want the agent to monitor. You can assign a unique base IP address to each interface.

Use the AIX SMIT configuration tool to configure the base IP addresses and to make them persistent across reboots.

When you use the IPv6 protocol, you must configure the value for this attribute with base IPv6 addresses. You need to also configure the corresponding IPMultiNICB agent's PrefixLen attribute.

When a network interface or a network adapter of the type MultiNICB under VCS control is renamed, you must update the value of the Device attribute of the MultiNICB resource.

Note:

Arctera recommends to offline the service groups containing the network resources before renaming the network interfaces and adapters and to update the VCS configuration to avoid any undesired behaviour.

Type and dimension: string-association

IPv4 example:

{ en1= "10.182.9.34", en2 = "10.182.10.34" }

IPv6 example:

{ en1 = "2001:db8::1", en2 = "2001:db8::2" }

Table: Optional attributes

Optional attribute	Description
LinkTestRatio	Controls the frequency of the ping test in relation to the link test. The ping test may be run at a lesser frequency to reduce network traffic. If this attribute is set to 1, packets are sent during every monitor cycle. If this attribute is set to 0, packets are never sent during a monitor cycle. Arctera does not recommend setting the value to zero. The agent determines link status without transmitting any ping packets. For other values greater than 1, packets are sent at a lower frequency. For example, if LinkTestRatio=2, then ping packets are sent out during every other monitor cycle. In other words, packets are sent out half as often than if LinkTestRatio were equal to one. When using IPv6 protocol, set the LinkTestRatio attribute to 0. If you set the attribute to another value, the MultiNICB resource may show unexpected behavior. Type and dimension: integer-scalar Default: 0 Example: 1
NetworkHosts	The NetworkHosts attribute is a list of hosts on the local network that are pinged to determine if the network connection is available. These must be IP addresses, and not host names. If you do not specify this attribute, the agent monitors the interface by pinging the broadcast address on the interface. If you specify one or more network hosts, and at least one host responds to a ping, the agent reports the MultiNICB resource online. The IP addresses for the NetworkHosts attribute must be on the same subnet as the base IP addresses for the MultiNICB resource. If an invalid network host address is specified, the resource enters an UNKNOWN state. Type and dimension: string-vector Example for pure Ipv4 configuration: NetworkHosts ={ "10.128.8.10" , "10.128.8.45" } Example for pure IPv6 configuration: NetworkHosts = {"2620:128:f0a2:900c::1", "2620:129:f0b3:910d::1"} Example for mixed mode configuration: NetworkHosts@sysa= {"10.128.8.10" , "10.128.8.45" } NetworkHosts@sysb= {"2620:128:f0a2:900c::1", "2620:129:f0b3:910d::1"}
NoBroadcast	If the value of this attribute is 1, NoBroadcast prevents the agent from sending broadcast pings. ARP requests may still be generated. Note: If no NetworkHosts are specified and NoBroadcast is set to 1, the agent cannot function properly. Arctera does not recommend setting 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 NetworkHosts attribute 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 increases the response time. Type and dimension: integer-scalar Default: 3
OnlineTestRepeatCount	The number of times that the test is repeated if the interface changes from down to up. This test helps to prevent oscillations in the status of the interface. Type and dimension: integer-scalar Default: 3
NetworkTimeout	Timeout for ARP and ICMP packets in milliseconds. MultiNICB waits for the response to ICMP and ARP packets only during this time period. Assign the NetworkTimeout a value in the order of tens of milliseconds, given that the ICMP and ARP destinations must be on the local network. Increasing this value increases the time for failover. Type and dimension: integer-scalar Default: 100
Gateway	IP address for the default gateway on the local network. Type and dimension: string-scalar Example: "136.22.1.1"