New Supermarket Announcements!

Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the supermarket mailing list.

Select Supported Platforms


heartbeat (4) Versions 1.0.1

Installs but does not configure heartbeat

cookbook 'heartbeat', '~> 1.0.1'
cookbook 'heartbeat', '~> 1.0.1'
knife cookbook site install heartbeat
knife cookbook site download heartbeat

heartbeat Cookbook

Build Status Cookbook Version

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.



  • Debian/Ubuntu
  • RHEL/CentOS/Scientific/Amazon/Oracle


  • Chef 11+


  • none


  • 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 & Authors

Author: Cookbook Engineering Team (

Copyright: 2009-2015, Chef Software, Inc. ``` 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. ```

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

heartbeat Cookbook CHANGELOG

This file is used to list changes made in each version of the heartbeat cookbook.


  • Added .foodcritic file to skip certain rules
  • Updated .gitignore file
  • Added Test Kitchen config
  • Added Chef standard Rubocop config
  • Added testing in Travis CI
  • Added a Berksfile
  • Updated contributing and testing docs
  • Added and maintainers.toml files
  • Added Travis and cookbook version badges to the readme
  • Expanded the requirements section in the readme and clarify the minimum supported Chef release is 11
  • Updated Opscode -> Chef Software
  • Added a Rakefile for simplified testing
  • Added a Chefignore file
  • Resolved Rubocop warnings
  • Added long_description to the metadata
  • Added source_url and issues_url to the metadata
  • Added basic Chefspec convergence test


  • [COOK-1692] - Make heartbeat available for Centos/Redhat
  • [COOK-1699] - add LWRP for heartbeat configuration


  • Current public release.
FC003: Check whether you are running with chef server before using server-specific features: /tmp/cook/a8ad309136961d8a1f448583/heartbeat/providers/default.rb:22
FC016: LWRP does not declare a default action: /tmp/cook/a8ad309136961d8a1f448583/heartbeat/resources/ipaddr.rb:1
FC017: LWRP does not notify when updated: /tmp/cook/a8ad309136961d8a1f448583/heartbeat/providers/default.rb:20