---
name: "bbcombotest"
section: "1"
platform: "linux"
package: "xymon"
version: "4.3.0~beta2.dfsg-9.1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/bbcombotest"
---

# bbcombotest(1)

Xymon combination test tool

## NAME

bbcombotest - Xymon combination test tool

## SYNOPSIS

**bbcombotest --help**\
 **bbcombotest --version**\
 **bbcombotest \[--debug\] \[--quiet\]**

## DESCRIPTION

**bbcombotest** is a Xymon extension script that runs on the BBDISPLAY server.  It combines the results of one or more of the normal Xymon test results into a combined test result, using standard arithmetic og logical operators.

The resulting tests are sent to the Xymon display server as any  normal test - so all of the standard Xymon functions (history, statistics etc.) are available for the combined tests.

The tool was born from the need to monitor systems with built-in redundancy and automatic failover - e.g. load-balanced web servers. But other uses are possible.

## OPTIONS

- \--quiet

  Normally, the test status sent by bbcombotest includes information about the underlying test results used to determine the current value of the combined test. "--quiet" eliminates this information from the test status page.

- \--debug

  Provide debugging output for use in troubleshooting problems with bbcombotest.

- \--no-update

  Dont send any status messages - instead, the result of the combotests is simply dumped to stdout. Useful for debugging.

## FILES

- $BBHOME/etc/bbcombotest.cfg

  Configuration file for bbcombotest, where the combined tests are defined

- $BBHOME/etc/hobbitlaunch.cfg

  Configuration file controlling when bbcombotest is run.

## SEE ALSO

[bbcombotest.cfg(5)](/bbcombotest.cfg/5.md), [bb-hosts(5)](/bb-hosts/5.md), [hobbitserver.cfg(5)](/hobbitserver.cfg/5.md), [hobbitlaunch.cfg(5)](/hobbitlaunch.cfg/5.md)