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
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 ha.cf:
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/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).
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.
You can choose an item in the left tree then the right panel will show the information of the item if it has any.
Below is a typical screen shot of basic cluster information.
Below is a typical screen shot of basic information about a node.
Below is a typical screen shot of basic information about a resource.
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.
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.
Many of the screen shots above are taken from AlanRobertson's production cluster. The configuration files for that system are attached below: