Man Linux: Main Page and Category List

NAME

       checkservice - checks the status of services on (remote) hosts

DESCRIPTION

       Checkservice  uses  host-specific  configfiles  which  are  located  in
       /etc/checkservice/hosts/. This means that for every hosts precisely can
       be specified, which service to check, what its short and long name are,
       what portset should be scanned, if extended, simple or no  scan  should
       be performed (method) and optionally which action to undertake when the
       service is failing.
       The name of the file represents the host that should be scanned and the
       contents  of  the  configfile  instructs  Checkservice what services to
       check on that host.

SYNTAX

       The syntax used for every line in the configfiles is:

              <key>=<field1>:<field2>:...

       The fields are an ordered list, so watch out! To  configure  a  certain
       service, use:

              service=portset:shortname:method:longname[:action]

       Where  portset  represents  one  or more ports separated by a comma (no
       spaces allowed), shortname the short name of the service (mosty the one
       used  in  /etc/services),  method  the check-method that should be used
       (’n’ [None], ’s’ [Simple] or ’x’  [eXtended]),  an  arbitrary  longname
       (used  in the PHP-status page) and an optional action. That action will
       be run under the default shell if the service fails. Also  commentlines
       starting with the hash ’#’ and emptylines are allowed.

       If an url is set, the PHP-status page will create a link to that URL in
       the title of the statistics-table.

              url=url

       The  mailto-opion  can  contain  one  or  more  (seperated  by  colons)
       emailaddresses  that must be notified by mail (providing mailwarning is
       enabled) when something goes wrong with this host. This option does NOT
       override  the  mailto-option  in the global conffile but appends to the
       emailaddress(es) specified there.

              mailto=somebody@somehost.net[:another@somehost.net:...]

EXAMPLES

       * Let’s check samba (port 137 & 139) using the simple
         check-method (since I have no plugins for it):

           service=137,139:samba:s:Samba Share service

       * Apache is vital to me, let’s check it thoroughly and
         keep it alive:

           service=80:http:x:Apache Webserver:apachectl restart

       * And of course a link to Checkservice homepage in the
         title of the statistics-table of the PHP-status page:

           url=http://www.linvision.com/checkservice

AUTHOR

       This manual page was written by Paul van Tilburg  <paul@linvision.com>,
       for Linvision bv.

SEE ALSO

       checkservice(1), services(5)