Installing and Configuring Xymon

by bitznbitez

When running a multi server environment, such as the small server farm I call “our home network” or a larger one such as the one at work, tools such as Hobbit -> Xymon -> etc. are invaluable.   This month I’m adding two new servers at home and so decided to get xymon working again.  I decided on a fresh install.  My hobbit server will be running on Linux Mint 12 ( Lisa ) and supporting clients on Ubuntu 12, Linux Mint 12, and Linux Mint 14, plus whatever VMs are running at any given moment.

#apt-get remove xymon
#apt-get install xymon

Edit /etc/apache2/conf.d/hobbit and change lines saying…

Allow from localhost ::1/128


Allow from all

Then reload apache

/etc/init.d/apache reload

Now configure the default for the hobbit-client in /etc/default/hobbit-client.   For a multi server environment this should be changed from local host to your actual server.   (NOTE: This means your IP should not move around.  Most home routers will try to keep the same IP for a given MAC address but it isn’t guaranteed unless you explicitly create the rule in the router.   No need to do that now but if you have trouble later check into it. )


Now restart hobbit….

/etc/init.d/hobbit restart

At this point you should be able to see your current server in xymon at the following URL http://localhost/hobbit/  ( note that the trailing / is essential ).   It may take a little time for the actual data to start flowing in but the server should be visible immediately, or pretty close to immediately.

Now you will need to add clients on your other hosts.   Ssh over to a host, become root ( in ubuntu/mint this is done via “sudo bash” which gives you a root shell.   Only use the root shell for short periods of maintenance, its much easier than always adding sudo in front of each command.

Install xymon

apt-get install xymon-client

During the install you will be prompted for the IP of the hobbit/xymon server.   Use the IP address of the server you previously installed.  The IP address can be changed later as well by editing /etc/default/hobbit-client on the client.

Now back on the server you will need to add the client to the /etc/hobbit/bb-hosts file client1

Then restart the hobbit server again

/etc/init.d/hobbit restart

Repeat the client add steps for each client you need to add.