GUI Guide

It's a draft.

If you have any suggestion or comment about this guide, please email zhenhltc@cn.ibm.com

The open issues for discussion is on GuiOpenIssues[1]

The to do list for the GUI is on GuiToDo[2]

Build

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[3]. 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

Configure

ha.cf

We let Heartbeat[4] start the management daemon on server nodes. To do this, add the following lines to the end of ha.cf[5]:

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.

/etc/pam.d/hbmgmtd

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).

Firewall

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.

Account

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.

Run

Restart Heartbeat[4] on all cluster nodes. Run /usr/lib/heartbeat/haclient.py 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).

Login

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.

Logout

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[6]'s production cluster. The configuration files for that system are attached below:

• cib.xml[7]

• ha.cf[8]

• drbd.conf[9]

• drbdlinks.conf[10]

• drbdlinks.home.conf[11]

---

This information provided courtesy of the Linux-HA project at http://linux-ha.org/