(Check AFS servers for blocked connections in Nagios)


check_afs_udebug [-hV] [-t timeout] -H host -p port


check_afs_udebug is a Nagios plugin for checking AFS database servers to make sure the Ubik replication between the database servers is running correctly. udebug is used to connect to the specified port on the specified server. The port should generally be one of 7002 (ptserver), 7003 (vlserver), or 7004 (kaserver). The resulting output is checked to make sure that the recovery state is 1f if that server is the sync site, or that a sync site is known if that server doesn't claim to be the sync site.

check_afs_udebug will always print out a single line of output. That line will be UBIK OK if everything is fine, or UBIK CRITICAL - followed by an error message otherwise.


-H host, --hostname=host

The AFS database server whose Ubik status check_afs_udebug should check. This option is required.

-h, --help

Print out this documentation (which is done simply by feeding the script to perldoc -t).

-p port, --port=port

The port to connect to on the AFS database server. This should generally be one of 7002 (ptserver), 7003 (vlserver), or 7004 (kaserver). This option is required.

-t timeout, --timeout=timeout

Change the timeout for the udebug command. The default timeout is 60 seconds.

-V, --version

Print out the version of check_afs_udebug and quit.


check_afs_udebug follows the standard Nagios exit status requirements. This means that it will exit with status 0 if there are no problems or with status 2 if there are critical problems. For other errors, such as invalid syntax, check_afs_udebug will exit with status 3.


The standard -v verbose Nagios plugin option is not supported. It should print out the full udebug output.

The usage message for invalid options and for the -h option doesn't conform to Nagios standards.


This script does not use the Nagios util library or any of the defaults that it provides, which makes it somewhat deficient as a Nagios plugin. This is intentional, though, since this script can be used with other monitoring systems as well. It's not clear what a good solution to this would be.


This script is part of the afs-monitor package, which includes various AFS monitoring plugins for Nagios. It is available from the AFS monitoring tools page at <>.


Russ Allbery <>


Copyright 2004, 2010, 2013 The Board of Trustees of the Leland Stanford Junior University

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

Last spun 2014-08-10 from POD modified 2014-04-14