Keywords: Big Sister, Bigsister, Network Monitor, Network Monitoring, Perl, GPL, Big Brother, manual, SNMP

command
Prev | Healthcheck Command Reference | Next

## 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
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.

Prev | Up | Next
ldap | Home | ups