First Steps

Setup a number of variables that we'll use throughout the build process. Adjust them to your needs.

export PREFIX=/usr

Create a user and group for the cluster

getent group haclient >/dev/null || groupadd -r haclient
getent passwd hacluster >/dev/null || useradd -r -g haclient -d /var/lib/heartbeat/cores/hacluster -s /sbin/nologin -c "cluster user" hacluster

Darwin/MacOS X

Follow the source based installation instructions below after having installed MacPorts and installing the following pre-requisites:

sudo port install pkgconfig glib2 help2man

And make sure the default autoconf installation understands the pkg-config macros:

sudo ln -s /opt/local/share/aclocal/pkg.m4 /usr/share/aclocal/

LibQB

libqb is a library with the primary purpose of providing high performance client server reusable features. It provides high performance logging, tracing, ipc, and poll.

It is used by Pacemaker and Corosync.

Obtain the latest sources from Git:

git clone git://github.com/ClusterLabs/libqb.git
cd libqb

Teach it about the machine it will run on

./autogen.sh && ./configure --prefix=$PREFIX

Once configure reports success, simply execute

make
sudo make install

CoroSync

CoroSync contains the infrastructure (such as network protocols and cluster membership APIs) that used to be part of OpenAIS. See the CoroSync FAQ entry for more details.

For the majority of Pacemaker users, it is simplest to think of CoroSync as simply a new version of OpenAIS without a bunch of stuff you weren't using anyway.

Grab the latest code from the CoroSync project which has all the required patches to support Pacemaker

git clone git://github.com/corosync/corosync.git
cd corosync

Teach CoroSync about the machine it will run on

./autogen.sh && ./configure --prefix=$PREFIX 

Once configure reports success, simply execute

make
sudo make install

Pacemaker

Obtain the latest Pacemaker sources from Git:

git clone git://github.com/ClusterLabs/pacemaker.git
cd pacemaker

Teach Pacemaker about the machine it will run on

./autogen.sh && ./configure --prefix=$PREFIX

Once configure reports success, simply execute

make
sudo make install

for some reason this also appears to be necessary

sudo ldconfig -v

be sure to first update LD_LIBRARY_PATH if you installed Pacemaker (or anything else) into a non-standard location.

Next Steps

Once Pacemaker is installed, the next step is to configure your cluster stack. Check out our quickstart guides or the Initial Configuration page.