NAME
checkservice - checks the status of services on (remote) hosts
SYNOPSIS
checkservice [OPTIONS]...
DESCRIPTION
Checkservice will get its information about what to do from the
combination of a global configfile and host-specific files. It can scan
either one host or all hosts for which those host-specific configfiles
are available. Checkservice provides two types of scans that are
configurable for every separate service: simple and extended. For an
extended service-check plugins are used. These will thoroughly check if
the service is REALLY working. If no plugin is available for that
service or the configuration for that service is set to do a simple
check, Checkservice will perform a test if the port/ports given for
that service is/are open.
Checkservice provides three types of output:
logfiles
Write the status of each service in a separate logfile for the
specified host.
stdout
This is meant for the Checkservice php-script, the format is
exactly like the configfile but with the status at then end.
mrtg Simple form of output: print a zero if the specified host is up
and all the services are working correctly, or a one if one of
the services is failing the test or the host is down. This
number is followed by the localtime (see also: perlfunc (1p) for
the format).
OPTIONS
-t, --targethost=STR
Specify the host to scan. A configfile for that host must be
available in <configdir>/hosts. If STR is ’*’, all hosts will be
scanned for which configfiles are available.
-c, --configdir=PATH
Specifies configdir, (default: /etc/checkservice).
-l, --logdir=PATH
Logdirectory where host-specific logs should be kept. If PATH is
’-’, Checkservice will print to stdout (default).
-m, --mrtg
Generate only a 0 (host is up & all services are ok) or 1 to
stdout, followed by localtime. Using this option, logdir
specification will be ignored. NB. The targethost option is
compulsory!
-h, --help
Show this help and exit.
-v, --version=MODE
Show version (if MODE is ’short’, only version number will be
printed) and exit.
FILES
/etc/checkservice/config
Global configfile.
/etc/checkservice/*.mail
Template mail files, in which the following variables can be
used:
%t time server/service went down.
%h host that either is unreachable or has a failing service.
%s service that went down (not available in the host
unreachable-template).
%p portset defined for service.
The subject is also configurable by adding a ’Subject: .....’
line on top of the template, it will be stripped from the mail’s
contents. Variable substitution is also performed to that
Subject-line.
/etc/checkservice/hosts/*
Host-specific configfiles. Look at checkservice(5) for the
format. Note that directory structures are allowed to create a
sort of groups (and subgroups, etc).
AUTHOR
This manual page was written by Paul van Tilburg <paul@linvision.com>,
for Linvision BV.
REPORTING BUGS
Report bugs to paul@linvision.com
COPYRIGHT
This software is copyright © 2000, by Paul van Tilburg
You are free to distribute this software under the terms of the GNU
General Public License.
SEE ALSO
checkservice(5)