SURVIVOR: Watcher Utility
About watcher
usage 
    watcher -p <swuri> [-i <instance>] [-t <timeout>] [-n <notify>] [-q]
where
  • swuri: URI of the web interface (eg: http://survivor.site.org/cgi-bin/sw).
  • instance: The instance to examine, as selected from instance.cf. If there is only one instance on the scheduler host, this argument may be omitted.
  • timeout: Timeout for establishing the HTTP connection. The default timeout is 30 seconds.
  • notify: An address to send output to. By default, output will be generated to stdout or stderr. If an address is specified, any output will instead be sent there.
  • -q: Quiet mode. Only errors will be reported.

The watcher utility contacts the web interface to determine the status of the scheduler. It is useful to ensure the scheduler is still running, that the configuration files are properly configured, and to perform other validations of the installation.

Upon successful completion, watcher will exit with MODEXEC_OK and report the appropriate status messages if requested. Upon error, appropriate messages will be generated and the exit code will be MODEXEC_PROBLEM.

The functionality and implementation of this utility is subject to change in a future release.

Dependencies

watcher requires the following Perl modules to be installed on the host from which it is run:
  • HTTP::Request::Common
  • LWP::UserAgent
  • Mail::Mailer
  • URI

Installation

The watcher utility is available in the survivor source distribution, in the util directory. It is not installed by default.

The easiest way to run watcher is to install it in $INSTDIR/sbin, from where it will be able to find the $INSTDIR/mod subdirectory. To install on a host that does not have a full installation, a directory tree like this should suffice: 

 survivor-lite/sbin/watcher
 survivor-lite/mod/common/ (and its contents)

Then, call watcher from cron as often as desired.

$Date: 2006/11/20 00:04:20 $
$Revision: 0.3 $
 keywords