The Linux-HA User’s Guide

The Linux-HA Project

License information

The text of and illustrations in this document are licensed under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA").

Revision History
Revision 0.9.3December 13, 2010FGH
Revision 0.9.2May 28, 2010FGH
Revision 0.9.1April 19, 2010FGH
Revision 0.9.0February 5, 2010FGH

Table of Contents

I. Introduction to Heartbeat
1. Heartbeat as a Cluster Messaging Layer
2. Components
2.1. Communication module
2.2. Cluster Consensus Membership
2.3. Cluster Plumbing Library
2.4. IPC Library
2.5. Non-blocking logging daemon
II. Installing Heartbeat
3. Building and installing from source
3.1. Building and installing Cluster Glue from source
3.1.1. Cluster Glue build prerequisites
3.1.2. Downloading Cluster Glue sources
3.1.3. Building Cluster Glue
3.1.4. Building Packages
3.2. Building and installing Heartbeat from source
3.2.1. Heartbeat build prerequisites
3.2.2. Downloading Heartbeat sources
3.2.3. Building Heartbeat
3.2.4. Building Packages
4. Installing pre-built packages
4.1. Debian and Ubuntu
4.2. Fedora, RHEL and CentOS
4.3. OpenSUSE and SLES
III. Administrative Tasks
5. Creating an initial Heartbeat configuration
5.1. The file
5.2. The authkeys file
5.3. Propagating the cluster configuration to cluster nodes
5.4. Starting Heartbeat services
5.5. Where to go from here
6. Upgrading from previous Heartbeat versions
6.1. Upgrading from Heartbeat 2.1 clusters not using the CRM
6.1.1. Stopping Heartbeat services
6.1.2. Upgrade software
6.1.3. Enabling the Heartbeat cluster to use Pacemaker
6.1.4. Restarting Heartbeat
6.2. Upgrading from CRM-enabled Heartbeat 2.1 clusters
6.2.1. Placing the cluster in unmanaged mode
6.2.2. Backing up the CIB
6.2.3. Stopping Heartbeat services
6.2.4. Wiping files related to the CRM
6.2.5. Restoring the CIB
6.2.6. Upgrading software
6.2.7. Restarting Heartbeat services
6.2.8. Returning the cluster to managed mode
6.2.9. Upgrading the CIB schema
IV. Getting Help and Helping Out
7. Reporting problems
7.1. Mailing Lists
7.1.1. Linux-HA
7.1.2. Linux-HA-dev
7.2. Bug Tracking System
7.3. IRC
8. Submitting patches