Name

command — execute an arbitrary command

Synopsis

[ localhost exec=/opt/bs/otros/test.pl test1 time=10 item=test ]command

[ localhost exec=ntpdate -q localhost results=0:green:ntp OK;stratum 16:yellow:ntp running but not synchronized;timeout:red:ntp not running;*:red:ntp FAILURE]command

[Note]Note

commands are executed with "/" base directory. uxmon-net

Description

This executed command must return status 0 if test is ok, and status != 0 if it is wrong.

In order to allow interfacing to commands not explicitly written for use with Big Sister the default behaviour regarding exit codes and other error conditions is configurable (see "results" parameter below).

All text messages send to standard output/error is send as status messages to bsdisplay.

Parameters

exec command to execute

item The item to report (default: command)

time The number of seconds to wait for a response before timing out. (default:5)

results patterns and resulting status to report when a pattern matches. Patterns are separated by semicolons and the results string looks like

where pattern may be one of

: matches the commands exit code timeout : matches if command timed out failed : matches if uxmon was not able to even start the command : matched against the stdout/ stderr output of the command

The first matching pattern decides which rule will apply.