Checkservice v1.2.0
===================

Checkservice is rather easy to install manually!
In the rest of this document I presume you want to install this in
/usr/local and the config in /etc/checkservice, but of course you can
use another prefix. Here are the steps that you can follow:

1. Extract the tarball if you haven't done that already!

2. CD to the dir that was created by the extraction (checkservice-<version>)

(3. Be sure you're root, or that you can write in /etc/ and /usr/local).

4. Create the directories:
     $ mkdir /etc/checkservice
     $ mkdir /var/log/checkservice  		(1) (2)
     $ mkdir /var/lock/checkservice		(1)
     $ mkdir /var/cache/checkservice		(1)

   (1) These directories are default in checkservice.conf, you may change this.
   (2) If you change this, change it in /etc/cron.d/checkservice too!

5. Install the program, plugins and config with:
     $ cp checkservice /usr/local/sbin
     $ cp -a plugins /usr/local/lib/checkservice
     $ cp -a lib/CS /usr/local/share/perl
     $ cp -a config /etc/checkservice

6. The main program 'checkservice' and the check- and warning-plugins expect
   the perl interpreter binary at /usr/local/bin/perl. If it's NOT there,
   create a symlink in /usr/local/bin to the perl binary or change
   the path to the perl binary on first line of EVERY plugin and the
   checkservice program!!!

7. Edit /etc/checkservice/checkservice.conf and change it to suite
   your needs. (pluginpath=/usr/local/lib/checkservice, etc...)

8. If you want to use the php status page, move checkservice.php to
   a directory, where the webserver can reach & read it. On Debian system
   you could put this in /var/www/, on RedHat systems in /home/httpd.

     $ cp checkservice.php /path/to/some/dir

     * Edit checkservice to change the global variable
       $confdir if you have changed the default configdir (/etc/checkservice).

   NB. If you haven't got php3/php4 yet, you can read here how to install it:
       http://www.php.net/manual/install-unix.php

9. If you want to use the manpages, install them with:
   
     $ mkdir -p /usr/local/man/man1 /usr/local/man/man5
     $ cp man/checkservice.1 /usr/local/man/man1
         or: $ gzip -c man/checkservice.1 > /usr/local/man/man1/checkservice.1.gz
     $ cp man/checkservice.5 /usr/local/man/man5
         or: $ gzip -c man/checkservice.5 > /usr/local/man/man5/checkservice.5.gz

10. Optionally you can cron Checkservice to run every interval to create
    logs (usefull for service uptime percentages) and activate warnings, I
    provided an example script in the cron/ directory. You can copy this
    to /etc/cron.d to make it work:

      $ cp cron/checkservice /etc/cron.d/

    If you changed the default logdir, you need to change this cron-file too.
    
Now you are done. A configfile for 'localhost' is already there, copy
it to the hosts subdir of your confdir (default
/etc/checkservice/hosts) and run 'checkservice' to test it. You can
put other host-specific configfilees in /etc/checkservice/hosts to
start scanning more than one host (see also: man 5 checkservice).

If there is something missing or wrong with this doc, I like to hear
it, mail me!

Paul van Tilburg <paul@linvision.com>