1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
Checkservice v1.1.0
-------------------
Checkservice is rather easy to install manually!
In the rest of this document I presume you want to install this in
/usr/local, 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.
(3. Be sure you're root, or that you can write in /etc/ and /usr/local.)
4. Install the program, plugins and config with:
$ cp checkservice /usr/local/sbin
$ cp -a plugins /usr/local/lib/checkservice
$ cp -a config /etc/checkservice
5. Create the directories:
$ mkdir /var/log/checkservice *
$ mkdir /var/lock/checkservice **
$ mkdir /var/cache/checkservice **
* This directory is configurable, if you change this, change it in
/etc/cron.d/checkservice too)
** These directories are default in checkservice.conf, you may change this.
6. Edit /etc/checkservice/checkservice.conf and change it to suite
your needs. (pluginpath=/usr/local/lib/checkservice, etc...)
7. Then move opensocket.pl to some dir that your perl standard looks
in for include files To see what those dirs are, run:
$ perl -e 'print join ",", @INC, "\n";'
most likely /usr/local/lib/site_perl will do).
8. If you want to use the php3 stats page, move the php3 to some dir, 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.php3 /path/to/some/dir
* Edit /etc/checkservice/statuspage.conf to change the global variables.
(if you changed the default configdir (/etc/checkservice) edit
checkservice.php3 too!!)
NB. If you haven't got php3 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:
$ mkdirhier /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, 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 want to change this cron-file too.
Now you are done. A configfile for 'localhost' is already there, try
running 'checkservice' to test it.
You can put 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>
|
