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:
2020-01-20 18:26:23

Heartbeat IPaddr resource agent

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

The basic syntax of an IPaddr resource is


This can be abbreviated simply to:


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, IPaddr 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, IPaddr defaults to the highest address in the subnet (the usual default).

Examples                  (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.

IPaddr has a limit of around 100 aliases it can manage for any given interface.

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

See Also

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