Provided by: hobbit_4.2.0.dfsg-10_i386 bug

NAME

       bbcombotest.cfg - Configuration of bbcombotest tool

SYNOPSIS

       $BBHOME/etc/bbcombotest.cfg

DESCRIPTION

       bbcombotest(1)      uses      it’s      own     configuration     file,
       $BBHOME/etc/bbcombotest.cfg Each line in this file defines  a  combined
       test.

FILE FORMAT

       Each  line  of  the  file  defines a new combined test. Blank lines and
       lines starting with a  hash  mark  (#)  are  treated  as  comments  and
       ignored.

       The  configuration  file  uses  the  hostnames  and  testnames that are
       already used in your Hobbit bb-hosts  file.  These  are  then  combined
       using normal logical operators - "||" for "or", "&&" for "and" etc.

       A  simple  test  -  e.g.  "Web1.http" - results in the value "1" if the
       "http" test for server "Web1" is green, yellow or clear. It yields  the
       value "0" if it is red, purple or blue.

       Apart  from  the logical operations, you can also do integer arithmetic
       and comparisons. E.g. the following is valid:

       WebCluster.http = (Web1.http + Web2.http + Web3.http) >= 2

       This test is green if two or more of the http tests for Web1, Web2  and
       Web3 are green.

       The full range of operators are:

               +      Add
               -      Subtract
               *      Multiply
               /      Divide
               %      Modulo
               |      Bit-wise "or"
               &      Bit-wise "and"
               ||     Logical "or"
               &&     Logical "and"
               >      Greater than
               <      Less than
               >=     Greater than or equal
               <=     Less than or equal
               ==     Equal

       There is currently no support for a "not" operator. If you need it, use
       the transcription "(host.test == 0)" instead of "!host.test".

       NB:  All  operators  have  EQUAL  PRECEDENCE.  If  you  need  something
       evaluated in a specific order, use parentheses to group the expressions
       together.

       If the expression comes out as "0", the combined test goes red.  If  it
       comes out as non-zero, the combined test is green.

       Note:  If  the  expression  involves hostnames with a character that is
       also an operator - e.g. if you have a host  "t1-router-newyork.foo.com"
       with  a  dash  in  the  hostname  - then the operator-character must be
       escaped with  a  backslash  ’\’  in  the  expression,  or  it  will  be
       interpreted as an operator.  E.g. like this:

        nyc.conn = (t1\-router\-nyc.conn || backup\-router\-nyc.conn)

EXAMPLE

       WebCluster.http = (Web1.http || Web2.http)
       AppSrvCluster.procs  = (AppSrv1.conn && AppSrv1.procs) || (AppSrv2.conn
       && AppSrv2.procs)
       Customer.cluster = WebCluster.http && AppSrvCluster.procs

       The first line defines a new test, with hostname "WebCluster"  and  the
       columnname  "http".  It  will  be  green if the http test on either the
       "Web1" or the "Web2" server is green.

       The second line defines a "procs" test for  the  "AppSrvCluster"  host.
       Each  of the AppSrv1 and AppSrv2 hosts is checked for "conn" (ping) and
       their "procs" test. On each host, both of these must be green, but  the
       combined  test  is  green if that condition is fulfilled on just one of
       the hosts.

       The third line uses the two first tests to build  a  "double  combined"
       test, defining a test that shows the overall health of the system.

FILES

       $BBHOME/etc/bbcombotest.cfg

SEE ALSO

       bbcombotest(1)