----------------------------------------------------
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>	<HOSTNAME>	# <DIRECTIVES>

	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://<path>	Test http connections for this server & path
		https://<path>	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/src/README
	$BBHOME/www/help/bb-help.html	(Best place for info)
