BBRETEST-NET.SH(1) General Commands Manual BBRETEST-NET.SH(1)NAME
bbretest-net.sh - Xymon network re-test tool
SYNOPSIS
bbretest-net.sh
DESCRIPTION
bbretest-net.sh is an extension script for Xymon that runs on the network test server. It picks up the failing network tests executed by
the bbtest-net(1) program, and repeats these tests with a faster test cycle than the normal bbtest-net schedule. This means that when the
server recovers and the network service becomes available again, this is detected quicker resulting in less reported downtime.
Only tests whose first failure occurred within 30 minutes are included in the tests that are run by bbretest-net.sh. The 30 minute limit
is there to avoid hosts that are down for longer periods of time to bog down bbretest-net.sh. You can change this limit with the "--fre-
quenttestlimit=SECONDS" when you run bbtest-net.
INSTALLATION
This script runs by default from your hobbitlaunch.cfg(5) file.
FILES
$BBTMP/TESTNAME.LOCATION.status
Temporary status file managed by bbtest-net with status of tests that have currently failed.
$BBTMP/frequenttests.LOCATION
Temporary file managed by bbtest-net with the hostnames that bbretest-net.sh should test.
SEE ALSO bbtest-net(1), xymon(7), hobbitlaunch.cfg(5)Xymon Version 4.2.3: 4 Feb 2009 BBRETEST-NET.SH(1)
Check Out this Related Man Page
BB-SERVICES(5) File Formats Manual BB-SERVICES(5)NAME
bb-services - Configuration of TCP network services
SYNOPSIS
$BBHOME/etc/bb-services
DESCRIPTION
bb-services contains definitions of how bbtest-net(1) should test a TCP-based network service (i.e. all common network services except HTTP
and DNS). For each service, a simple dialogue can be defined to check that the service is functioning normally, and optional flags deter-
mine if the service has e.g. a banner or requires SSL- or telnet-style handshaking to be tested.
FILE FORMAT
bb-services is a text file. A simple service definition for the SMTP service would be this:
[smtp]
send "mail
quit
"
expect "220"
options banner
This defines a service called "smtp". When the connection is first established, bbtest-net will send the string "mail
quit
" to the
service. It will then expect a response beginning with "220". Any data returned by the service (a so-called "banner") will be recorded and
included in the status message.
The full set of commands available for the bb-services file are:
[NAME] Define the name of the TCP service, which will also be the column-name in the resulting display on the test status. If multiple
tests share a common definition (e.g. ssh, ssh1 and ssh2 are tested identically), you may list these in a single "[ssh|ssh1|ssh2]"
definition, separating each service-name with a pipe-sign.
send STRING
expect STRING
Defines the strings to send to the service after a connection is established, and the response that is expected. Either of these may
be omitted, in which case bbtest-net(1) will simply not send any data, or match a response against anything.
The send- and expect-strings use standard escaping for non-printable characters. "
" represents a carriage-return (ASCII 13), "
"
represents a line-feed (ASCII 10), " " represents a TAB (ASCII 8). Binary data is input as "xNN" with NN being the hexadecimal
value of the byte.
port NUMBER
Define the default TCP port-number for this service. If no portnumber is defined, bbtest-net(1) will attempt to lookup the portnum-
ber in the standard /etc/services file.
options option1[,option2][,option3]
Defines test options. The possible options are
banner - include received data in the status message
ssl - service uses SSL so perform an SSL handshake
telnet - service is telnet, so exchange telnet options
FILES
$BBHOME/etc/bb-services
SEE ALSO bbtest-net(1)Xymon Version 4.2.3: 4 Feb 2009 BB-SERVICES(5)