Spong client is the client application that works with SpongServer which we use to monitor our servers and nodes.

Here are some installation instructions for getting it working on your node, they are specific to DebianLinux but should be fairly easy to adapt. These instructions are assuming you have a working knowledge of Debian Linux and have a working node connected to the Internet. Note that spong-client doesn't currently install on a Red Hat Linux machine from the tarball.

1. Lookup your NodeId from the MapServer here:

   http://maps.personaltelco.net/group_nodes?group=PersonalTelco

2. Set the host name of your box to your NodeId. {{{# hostname node111

# vi /etc/hostname}}}

• The /etc/hostname file should include one line: {{{ node111

}}}

• Setup your domain name to be personaltelco.net and make sure that a gethostbyname call returns the fully qualified domain name (eg. node111.personaltelco.net). {{{# vi /etc/hosts

}}}

• It should be like this (if you have other entries that's okay but make sure that these two exist and are exactly like this): {{{127.0.0.1 localhost

x.x.x.x node111.personaltelco.net node111}}}

• You can test it to make sure it's doing the right thing by running this perl one liner: {{{# perl -MSys::Hostname -e '$h = (gethostbyname(Sys::Hostname::hostname()))[0]; print "$h\n"'

}}}

• Install spong client onto your box. Follow the instructions to download and configure it. BR {{{# apt-get install spong-client

}}}

• Now setup spong to monitor what you want it to. The main thing you need to change is what processes it makes sure are running. Edit the spong.conf.node111 file to look like this. {{{# vi /etc/spong/spong.conf.node111

}}}

• {{{# This file is automatically created by debconf, yet all modifications

# will be preserved. $SPONGSERVER="mon.personaltelco.net"; @PROCSWARN = ("cron","atd"); @PROCSCRIT = ("syslogd","klogd","dhcpd","cardmgr","gateway"); 1; }}}

• Warn means I want to know if it dies but it's not crucial, red means page me. There may be other bits and pieces you want to monitor in that same section customize them however you want.
• Now test to make sure it's all working okay (errors should be obvious).

  # /usr/sbin/spong-client --debug

• If that works, you can either reboot, or restart the spong-clinet: {{{# /etc/init.d/spong-client stop

# /etc/init.d/spong-client start }}}

• Email mailto:ops@personaltelco.net all this information so we can add your system to be monitored. We need your NodeId, your IpAddress, your name and whatever email address you'd like to be notified of failures on.

• Check the spong page and make sure that you are now listed.

  http://mon.personaltelco.net/

[CategoryDocumentation]