This site best when viewed with a modern standards-compliant browser. We recommend Firefox Get Firefox!.

Linux-HA project logo
Providing Open Source High-Availability Software for Linux and other OSes since 1999.

USA Flag UK Flag

Japanese Flag


About Us

Contact Us

Legal Info

How To Contribute

Security Issues

This web page is no longer maintained. Information presented here exists only to avoid breaking historical links.
The Project stays maintained, and lives on: see the Linux-HA Reference Documentation.
To get rid of this notice, you may want to browse the old wiki instead.

1 February 2010 Hearbeat 3.0.2 released see the Release Notes

18 January 2009 Pacemaker 1.0.7 released see the Release Notes

16 November 2009 LINBIT new Heartbeat Steward see the Announcement

Last site update:
2019-12-16 02:51:31

Heartbeat IPaddr2 resource agent

The IPaddr2 resource agent is used by Heartbeat to configure IPv4 ServiceAddresses. Most resource groups will contain at least one IPaddr2 or IPaddr resource agent.

The basic syntax of an IPaddr2 resource is


So, the following forms of addressing are legal:


By far the most common case is the simplest one:


In this form, appropriate defaults are taken as described below.

Default Interface

If the interface was omitted, we use the system routing tables to determine which interface would be used to route a packet to the given address. That is, IPaddr2 selects the preferred interface for sending packets to that subnet. If no such interface can be found, heartbeat will issue a message something like this:

ERROR: unable to find an interface for given-ip-address

Default netmask

If the CIDR netmask is omitted, we choose the netmask associated with the route to the subnet to which packets to the given IP address would be routed. That is, we simply look up the routing information for that address, and use it to compute the correct netmask (and other items as described below).

Default broadcast address

If the broadcast address was omitted, IPaddr2 defaults to the highest address in the subnet (the usual default).


  IPaddr2::                  (implies a netmask)

Special Note

The interface mentioned above does not include an alias number. Heartbeat assigns them dynamically according to the available alias names.

See for a table explaining CIDR address format and their relationship to life, the universe and everything.

Unlike IPaddr, IPaddr2 has no obvious limitations on the number of addresses it can configure on an interface.

See Also

ResourceAgent, HeartbeatResourceAgent, IPaddr resource agent, Linux Hacks article on our send_arp command