check_gateway
./check_gateway.pl [OPTIONS] [-f configuration_file]
-
-h or --help: prints short usage tips
-
-V or --version: prints plugin version
-
-v X or --verbose X: sets verbosity level to X (see UMI docs)
-
-t Y or --timeout Y: sets plugin execution timeout to Y seconds
Plugin checks UNICORE Gateway functionality. Written in Perl, v5.10.0 (requires commons.pm module in plugin directory or one level higher). Plugin connects to the Gateway web interface (you need to provide valid UCC configuration file path in check_gateway.config) and matches pattern to get all information about registered USites (this is done by class CheckGateway, compile it (use javac) and place in check_gateway.pl folder).
-
JAVA_PATH: path to java command (type simple "java" if java is available via PATH environment variable)
-
UCC_CONFIG: absolute path to valid configuration file for UCC (remember to set absolute paths to keystore and trustore in this file!)
-
GATEWAY_URL: address of the Gateway interface you want to check
-
REQUIRED_VSITES: List (separated by comma or spaces) containg names of services you are sure to be registered in this Gateway. If at least one of them will not be available, the plugin will exit with WARNING status.
-
WARNING: Unable to get Gateway output or no services found: Connection to Gateway is OK, but plugin could not match any service pattern in the Gateway web interface. There are no registered services or Gateway version you are checking is unsupported.
-
OK: Gateway works properly, … services found: Everything is OK
-
WARNING: Required services not found: …: Connection to Gateway is OK, but the script could not find some services you marked as required. See log for details.
-
CRITICAL: Connection refused, CRITICAL: Connection timed out, CRITICAL: No route to host, check connection, CRITICAL: Unknown gateway host: Unable to connect Gateway or network problems. Check if Gateway is running and is not blocked by firewall.
-
UNKNOWN: Keystore password you provided is wrong, UNKNOWN: Keystore path you provided is not valid: A given configuration file seems to be invalid, check it with UCC
-
CRITICAL: SSL connection cannot be trusted: Probe received SSL exception. Check if the Gateway trusts the certificate you are using to connect with.