# # bbwarnsetup.cfg # # BIG BROTHER Notification setup configuration file # Sean MacGuire - The MacLawran Group Inc. # Version 1.2b # Jul 12th, 1999 # # This program is Copyright (c) 1997-1999 # The MacLawran Group Inc. # All Rights Reserved # # # IMPORTANT *************** # # Tokens are defined on a single line in this format # # token: parameter(s) # # The ':' must always follow the token name # # IMPORTANT *************** # # # Scope: This means on which host(s) the variable is used # # Most of them are used on the BBPAGER host (obviously) # Others apply also on BBDISPLAY and all BB clients. # because they affect the behavior of the 'bbd' # and 'bb' programs # # Restart: Does BB needs to be restarted for this variable # to be reset # # # The "bbwarn" token specify if you want to use the notification feature or not # Set to TRUE if you want to enable the notification feature # anything else will disable it (FALSE,NO,NIET,...) # # Scope: BBPAGER # Reset: No bbwarn: TRUE # # Each message that is sent has a numeric value associated with it. # This value is in the XXXYYYYYYYYYYYY format: # # XXX: service code associated with the column name as # defined in bbinc.sh by "svcerrlist" token # YYYYYYYYYYYY: IP address of host in error, the IP address is # expanded to 12digits to remove any ambiguity # # services are defined by pairs: # # service:code # # NOTE: Don't define any codes in the 7XX ranges because codes starting # with 7 defines TCP errors and is followed with the IP code # e.g. 725 - SMTP error # # Scope: BBPAGER # Reset: No ##### ##### Fully modified all extensions to fit into the pre-defined "groups" ##### provided by stock Big Brother. ##### svcerrlist: disk:100 cpu:200 procs:300 msgs:400 conn:500 http:600 dns:800 ERR:999 vx_check:120 vx_group:125 vx_list:130 dmp:150 iostat:175 cpu2:250 prtdiag:275 ipcs:325 top:350 logs:450 ha:550 network:850 oracle:900 printers:950 # # The "ignforall" token is used to discard all hosts.service that # matches the egrep regexp. # N.B. You build your own egrep regexp # # ignforall: .*.cpu|.*.msgs|host11.* # # Scope: BBPAGER # Reset: No ##ignforall: # # "pagehelpcode" is the numceric code associated with the # phone # of the user when requesting for help . 911 is the default but I've # requests for customizable code so here it is. # # Scope: BBPAGER # Reset: No pagehelpcode: 911 # # "ttyline" token list the device files that KERMIT uses # The 1st available device will be used # # ttyline: /dev/cuaa0 /dev/cuaa1 # # Scope: BBPAGER # Reset: No ttyline: /dev/tty01 # # The dialing "prefix" and "suffix" are defined in these tokens # # Note: for SMS paging please read the doc/README.SMS, also the # prefix defined here does not apply to SMS ... # # Scope: BBPAGER # Reset: No #prefix: T9 prefix: suffix: # # The "pagedelay" token is used to specify how many minutes between pages # Set it really high to only be paged once... # "pagedelay" can be overridden in the 'bbwarnrules.cfg' file # # Scope: BBPAGER # Reset: No pagedelay: 30 # # The "pagelevels" token specifies on which colors should the 'bb' program # send notification messages to the BBPAGER server. # # e.g. pagelevels: red purple # # If the event color is either red or purple then send a page message # to BBPAGER server # # NOTE ******** This has to be set on all clients as it is used by # the 'bb' and 'bbd' program # # Scope: BBPAGER/BBDISPLAY/all BB clients # Reset: Yes pagelevels: yellow red purple #pagelevels: # # The "pagelevelsmail" token indicates that on that color level only # the email recipients get a notification (and that's only if that # particular event has a matching e-mail recipient in etc/bbwarnrules.cfg) # The color is active only if it is also defined in the "pagelevels" token # # e.g. pagelevelsmail: yellow purple # # If the event is of yellow or purple level, only an email notification # will be sent if the color is also defined in the "pagelevels" token. # # N.B. If you use pagerecovered with pagelevelsmail, you will be notified # for all recipients, not just those for yellow when the state # change is from yellow->green :(. It's a known bug and will be # fixed ASAP. Sorry... # # Scope: BBPAGER # Reset: No #pagelevelsmail: pagelevelsmail: yellow red purple # # The "pagerecovered" token is set to TRUE when you want to be notified # when the state of the problem has come back to normal # (that is, it is not in the pagelevels colors) # # If you have set type pagetype token to one of the following: # HOST/GROUP/RCPT, Big Brother will send a recovered notification # only on the event that triggered the notification. If there # are more events associated with that notification, you # will not be notified on recovery of these events. # # e.g. pagerecovered: TRUE # # Scope: BBPAGER # Reset: No #pagerecovered: FALSE pagerecovered: TRUE # # The "pagetype" token describes how the delay between should be handled. # # RCPT - applicable on the recipient # The recipient (mail/page/sms) won't be # notified until the next "pagedelay" # regardless of event (host.service) error # # EVENT - applicable on the host.service combination (www.maclawran.ca|disk) # The recipient won't be notified on a specific # event (host.service) error until "pagedelay" # has expired. This will generate the most notifications # # HOST - applicable on the host that is in error # The recipient won't be notified on any # event error from the same HOST until "pagedelay" has expired. # # GROUP - applicable on the display GROUP # The recipient won't be notified on a specific # event within a bb-hosts group until "pagedelay" # has expired. Hosts that do not belong to any # group (defined before the first group/group-compress # directive in bb-hosts) are defined belonging to # the global-grp group # # NOTE: As soon as an error event is resolved (returned to a color not # defined in "pagelevels" then the "pagedelay" is expired # # Scope: BBPAGER # Reset: No #pagetype: RCPT pagetype: EVENT # # "pagemaster" token holds email recipients to be sent a warning message # if a notification page (physical page) can't be sent # # If none are specified then no warning mail will be sent # # Scope: BBPAGER # Reset: No ## pagemaster: root@localhost pagemaster: pluzzi@pershing.com # # "pageaddhtmlpath" token defines if the email notification will # have the path to the HTML status page # The path is defined in the BBWEBHTMLLOGS variable in bbdef.sh # # default is TRUE # # Scope: BBPAGER # Reset: No pageaddhtmlpath: TRUE # # The "cfgdelim" token specifies the delimiter to use in the rule lines # of the bbwarnrules.cfg file # # i.e. cfgdelim: ; # rule line *;;*;;*;*; 9,1,9999999999 # # ***** NOTE ***** # # Don't use '*' ':' '/' ',' '.' '!' for "cfgdelim" as they will cause the # notification feature to fail. Don't use characters that you # may use in a regular expression in the # hosts/exhosts/services/exservices columns of a rule line # # Scope: BBPAGER # Reset: No cfgdelim: ; #cfgdelim: # # The "briefrcpt" token specifies which recipients should receive # brief notification messages # # i.e. briefrcpt: robert@localhost 9999999 # # Scope: BBPAGER # Reset: No briefrcpt: target@domain.com # # The "hg-groupname" token specifies specifies that the hosts listed can # be referred to "hg-groupname" in the hosts field in the bbwarnrules.cfg # config file. You can define as many hostgroups that you need # # i.e. hg-routers: rt1 rt2 rt3 router* # in rules: hg-routers host1*;;*;;*;*;root@localhost # # Scope: BBPAGER # Reset: No # # The "pg-groupname" token specifies specifies that the recipients listed can # be referred to "pg-groupname" in the recipients field in the bbwarnrules.cfg # config file. You can define as many pagegroups that you need # # i.e. pg-routeradmins: joe@localhost joey@localhost joanne@localhost # in rules: *;;*;;*;*;pg-routeradmins root@localhost # # Scope: BBPAGER # Reset: No