Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Development repository for Opscode Cookbook heartbeat
branch: master
Failed to load latest commit information.
providers opscode2chef
recipes opscode2chef
resources opscode2chef
CONTRIBUTING opscode2chef
LICENSE Preparing repository for splitting cookbooks into their own repos. opscode2chef
metadata.rb opscode2chef


Installs heartbeat, and includes resources/providers for managing heartbeat configuration.

It is outside the scope of this cookbook and the README to replace documentation and user understanding of the linux-ha and heartbeat project.


Requires a Chef Server due to use of Search.


Supported via Platform Family:

  • Debian
  • RHEL


  • node['heartbeat']['conf_dir'] - Directory where heartbeat configuration lives.

The following attributes are used in recipe[heartbeat::config] to pass into the LWRP used there. Each corresponds to a resource attribute in the LWRP, making the recipe drivable with attributes, e.g. set in a role. See the heartbeat resource attributes below for descriptions.

  • node['heartbeat']['config']['auto_failback']
  • node['heartbeat']['config']['autojoin']
  • node['heartbeat']['config']['compression']
  • node['heartbeat']['config']['compression_threshold']
  • node['heartbeat']['config']['deadtime']
  • node['heartbeat']['config']['initdead']
  • node['heartbeat']['config']['keepalive']
  • node['heartbeat']['config']['logfacility']
  • node['heartbeat']['config']['udpport']
  • node['heartbeat']['config']['warntime']
  • node['heartbeat']['config']['search']
  • node['heartbeat']['config']['authkeys']
  • node['heartbeat']['config']['active_key']
  • node['heartbeat']['config']['mode']
  • node['heartbeat']['config']['interface']
  • node['heartbeat']['config']['mcast_group']
  • node['heartbeat']['config']['mcast_ttl']
  • node['heartbeat']['config']['resource_ip']



Manages heartbeat configuration files (, authkeys, haresources).


  • :create - Default Creates the configuration. This will search for a specified query (see the search resource attribute below), and fall back to finding the cookbook and recipe name where the LWRP is used in the node's recipes attribute.


  • auto_failback - used for the auto_failback configuration directive in
  • autojoin - used for the autojoin configuration directive in
  • compression - used for the compression configuration directive in
  • compression_threshold - used for the compression_threshold configuration directive in
  • deadtime - used for the deadtime configuration directive in
  • initdead - used for the initdead configuration directive in
  • keepalive - used for the keepalive configuration directive in
  • logfacility - used for the logfacility configuration directive in
  • udpport - used for the udpport configuration directive in
  • warntime - used for the warntime configuration directive in
  • search - a search query to use instead of the default (see description above).
  • authkeys - sha1 keys used in the authkeys config file.
  • active_key - the key used for the auth configuration directive in the authkeys config file.
  • interface - used for the `` configuration directive in
  • mcast_group - used for the `` configuration directive in
  • mcast_ttl - used for the `` configuration directive in
  • mode - tye network mode to use, can be ucast, bcast, or mcast, corresponds to the configuration directives in
  • resource_groups - array of resource groups


See recipe[heartbeat::config].


Used in the heartbeat LWRP for the group IP.


Manages the haresources resource_groups.



Installs the heartbeat and heartbeat-dev packages, and manages the heartbeat service. The recipe does not at this time manage any configuration.


Uses the heartbeat LWRP with the node['heartbeat']['config'] attributes to manage a complete heartbeat configuration.


Use the default recipe to install heartbeat's packages and manage the service.

Use the LWRP in your own recipe, or set the attributes described above and use the config recipe to setup a heartbeat-monitored application.

License and Author

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Something went wrong with that request. Please try again.