command — execute an arbitrary command
[ 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 |
---|---|
commands are executed with "/" base directory. uxmon-net |
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.
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.