NAME

Bio::GMOD::Admin::Monitor::acedb - Monitor acedb/sgifaceserver

SYNOPSIS

Check that sgifaceserver is running

use Bio::GMOD::Admin::Monitor::acedb;
my $gmod  = Bio::GMOD::Admin::Monitor::acedb->new();
$gmod->check_status();
print "Testing acedb status at " . $gmod->tested_at . ": $status";

DESCRIPTION

Bio::GMOD::Admin::Monitor::acedb provides methods for monitoring and restarting acedb/sgifaceserver as necessary.

PUBLIC METHODS

$gmod->check_status()

Check the status of acedb on the localhost. Note that because in most installations, sgifaceserver is configured to run under xinetd/inetd. If there has been a long period with no requests, sgifaceserver may have timed out.

This method returns a two element list comprised of ($string,$status). $string will contain a formatted string indicating the test, time, and result; $status will be boolean true or false indicating the success or failure of the test.

This method also populates the object with a variety of status strings. See the "ACCESSOR METHODS" section of Bio::GMOD::Admin::Monitor for additional details.

$monitor->restart(@options);

Restart sgifaceserver using a variety of methods, starting from least to most aggressive.

Options:
-user      These two options will be used to try and restart sgifaceserver
-pass      using the ace.pl script (if installed on your system) (admin/ace123)

-xinetd    full path to xinetd undet control of init.d
           (defaults to /etc/rc.d/init.d/xinetd if not provided)

The following attempts will be made to try and restart sgifaceserver:

1. via ace.pl
2. By reloading xinetd through inetd
3. By sending xinetd a HUP
4. By sending inetd a HUP

Note that restarting sgifaceserver can take some time depending on your system! Be patient!

This method returns a two element list comprised of ($string,$status). $string will contain a formatted string indicating the test, time, and result; $status will be boolean true or false indicating the success or failure of the test.

Like check_status(), this method populates a number of status fields in the object. See the "ACCESSOR METHODS" section of Bio::GMOD::Admin::Monitor for additional details.

BUGS

None reported.

SEE ALSO

Bio::GMOD, Bio::GMOD::Admin::Monitor

AUTHOR

Todd W. Harris <harris@cshl.org>.

Copyright (c) 2003-2005 Cold Spring Harbor Laboratory.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.