---------------------------------------------------- Configuration information for Big Brother's Scripts ---------------------------------------------------- 0. Start by reading the README in the root directory of BB 1. Decide where your Big Brother Servers will be. You'll need a machine running a Web server to display the results of the Big Brother test. This machine is internally known to Big Brother as BBDISPLAY. If you have a modem and kermit available somewhere on your network then Big Brother can act as a pager server. This machine is internally known to Big Brother as BBPAGER. This can be the same machine as BBDISPLAY. 2. Configuring for your OS type In install/ use the bbconfig to copy the appropriate OS specific files. 3. Configure the bb-hosts file. The bb-hosts file controls where Big Brother looks for things and the actions that are taken. The format is identical to the standard /etc/hosts file, except with additional directives for Big Brother. Lines are of the format: # IP-ADDR: XXX.XXX.XXX.XXX HOSTNAME: host.domain.com if FQDN="TRUE" host if FQDN="" Directives the Big Brother knows about are: BBDISPLAY Machine with Web Server to display results BBPAGER Machine to act as the pager server BBNET Indicates the host that checks the ip network services http:// Test http connections for this server & path https:// Test https connections for this server & path https test requires lynx Note that you can specify multiple URLs by joining the URLs with '|': http://www_path|http://www_path1 or by specifying them individually: http://www_path http://www_path1 ftp Test machine for ftp server smtp Test machine for smtp server pop3 Test machine for pop3 server telnet ssh nntp Check /etc/services for proper service name especially pop3 (sometimes referred as pop-3) (!ftp checks that ftp is NOT running) dns noping Don't do ping test for this host dialup If host is down then display clear button imap This is a sample bb-hosts file: # # BIG BROTHER HOSTS FILE # 192.168.110.102 bobo # BBDISPLAY BBPAGER ftp smtp pop3 192.168.110.95 admin # http://admin/ 192.168.110.108 mynet # BBNET bobo is the display/pager server. mynet is the host that runs the bin/bb-network.sh (ip network services) it will check the ftp/smtp/pop3 services on bobo, then the http service on admin It is best to have the master bb-hosts file identical on all hosts. 4. Configure the bbdef.sh file bbdef.sh is where you configure how Big Brother reacts to a variety of situations that may arise. You can establish levels for warnings, panics, and whether or not Big Brother attempts to page the administrator. Configure the bbinc.sh file Set the FQDN flag to true if you are using fully qualified domain names. You shouldn't have to configure the bbsys.sh file. The local OS discrepencies should have been taken care of in the bbsys.os file which is copied to bbsys.local during the initial setup. If you do need to change a value do so in the bbsys.local and notify bbconfig@bb4.com of your change as it may be needed for other similar installs. We try to keep up with most particularities of each OS but sometimes some settings go through the cracks. 6. Configure the notification feature (BBWARN) edit bbwarnsetup.cfg & bbwarnrules.cfg These configs file have the information required to how to set them up. 7. Copy over to client programs In install/ use the bbclient script to create a tarball of BB. Use bbclient for same OS/HW platforms. You must reconfigure and recompile BB for each OS/HW platform. 8. Read the different documentation files: http://yourwebserver/bb/help/bb-help.html $BBHOME/README $BBHOME/LICENSE $BBHOME/README.INSTALL $BBHOME/README.CHANGES $BBHOME/install/README (this file but you're reading it ;-)) $BBHOME/install/README.SMS $BBHOME/install/STRUCTURE $BBHOME/etc/security.DIST $BBHOME/etc/bb-dftab.DIST $BBHOME/etc/bb-proctab.DIST $BBHOME/etc/bb-cputab.DIST $BBHOME/etc/bb-msgstab.DIST $BBHOME/etc/bb-bbexttab.DIST $BBHOME/src/README $BBHOME/www/help/bb-help.html (Best place for info)