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:
2022-10-02 21:52:01

GUI Guide

It's a draft.

If you have any suggestion or comment about this guide, please email

The open issues for discussion is on GuiOpenIssues

The to do list for the GUI is on GuiToDo


If you're not running a pre-built binary with the management daemon compiled in, then this section is for you.

Check out current head source code from CVS. Configure it with --enable-mgmt option and make and make install. To build and run it, we need the following packages installed:

  • swig

  • python and python-devel >2.4

  • python-gtk >= 2.4

  • gnutls and gnutls-devel

  • libgcrypt and libgcrypt-devel

  • pam-devel

  • gettext


We let Heartbeat start the management daemon on server nodes. To do this, add the following lines to the end of

apiauth         mgmtd   uid=root
respawn         root    /usr/lib/heartbeat/mgmtd -v

NOTE: These directives are not necessary starting with version 2.0.5 of the Heartbeat package.


Please check the /etc/pam.d/hbmgmtd is in the correct format of your OS. If there is a problem with PAM, we can start mgmtd with the -t option, that will disable the PAM authorization (just for testing for security issue).


The mgmtd and GUI client use the port 5560, please open it in your firewall, or use ssh or similar to tunnel it through your firewall.


Change the password of hacluster on the nodes running the daemon, so you can use the password to login later.

The best approach is to give individual logins for each of the administrators responsible for the cluster, and add each authorized user id to the /etc/group file.


Restart Heartbeat on all cluster nodes. Run /usr/lib/heartbeat/ on any machine with an X server, with connectivity to the cluster. This can be your desktop machine, or it can be a cluster console (assuming you run X on your cluster consoles).


Select Menu->Connection->Login... or press the first button on the toolbar.

On the login dialog window, enter the name or IP of one of the active nodes and user name and password, then press OK.

Viewing Cluster Information

You can choose an item in the left tree then the right panel will show the information of the item if it has any.

Cluster View

Below is a typical screen shot of basic cluster information.

Node View

Below is a typical screen shot of basic information about a node.

Resource View

Below is a typical screen shot of basic information about a resource.

Add New Item

Select Menu->Action->Add New Item or press the "+" button on the toolbar.

Then a small dialog will show up to ask you about what type of item you want to add. Select one and press OK, then enter the information about the new item.

For ocf and stonith class resource agents, the parameters supplied automatically in the dialogue box are the mandatory parameters for the GUI. To supply optional parameters to the resource, press the [Add] button in the Parameters: box. After pressing the [Add] button, the resulting dialog box will show all the parameters to the resource agent.

For heartbeat class resource agents, all parameter names are sequential numbers corresponding to the argument number for the given argument. For example, 1, 2, 3, etc.

Delete Item

Choose an item in the left tree, then select Menu->Action->Delete or press the minus sign icon on the toolbar.


Select Menu->Connection->Logout or press the second button on the toolbar.

Configuration Files for this System

Many of the screen shots above are taken from AlanRobertson's production cluster. The configuration files for that system are attached below: