
								8/24/89

                      BIT - Site Installation Instructions


  This bit tape is not a released product.  It is provided as a courtesy to 
enable system level testing to be performed.  This document will describe how 
to configure this tape for your site.


1.	Select a system that has about 9 megabytes of free diskspace with 
	a Q24 or Q120 tape drive.

2.	While logged on as root, perform the following commands;

		cd /usr
		mkdir bitmaster
		cd bitmaster

	You have created a directory that we will use to load bit, and 
 	configure it for your site.

3.	Load the bit tape in the system's tape drive.

4.	The tape is in tar format, usually you can load tar tapes with;

		tar xv

	If your system complains about "No such device" you may have to 
	specify the special file that describes the tape drive.  For an
	M/120 for example, the command would be;

		tar xvf /dev/rmt/Q120-0
		        or
		tar xvf /dev/rmt/Q24-0

5.	Once the tape has loaded, you must modify several files within the
	package to allow bit to run in your environment.  Familiarity with
	unix and a text editor such as vi or emacs is essential.

	In /usr/bitmaster/bit/etc.d you will find two files, hosts and 
	local_host.bit.  The hosts file must be replaced with your
	local copy of the hosts file from /etc/hosts.  If your copy
	of this file is on the same machine that we are working with, then
	use the command;

		cp /etc/hosts /usr/bitmaster/bit/etc.d

	to overlay bit's hosts file with your local copy.

	The next file that needs to be modified is local_host.bit
	Modification of the second line in this file is needed to
	describe the netmask and broadcast address for your environment.
	consult your system administrator for details regarding this
	information.  The top line remains "no_hostname_set" to prevent systems
	from enabling network services until the system is identified by running
	bit.  

	Another file that will need modification is 
                  /usr/bitmaster/bit/CONFIGURATION
	This file describes various attributes about drive mount directories, 
	time delays for tape and network tests and the name of a host to send
	bit reports to.  You will want to change the host name to match your
	host name, and assign a reasonable path to use on the host.

	The last modification you will need to make is in the file
	/usr/bitmaster/bit/net.BIT
	Search for "prefix=" and change the "mcs" to match the prefix of 
	systems running in your environment.  We use this prefix because
	it uniquely identifies systems in test, for example "mcs45".

6.	Once the master version of bit is in place, you will want to copy 
	it to a new tape for distribution within your site.  

		cd /usr/bitmaster
		tar cv bit

	See the section above for alternate tape special files, if required. 

	You now have a local version of bit for your site.  Test the tape that
	you have created to make absolutly sure that it is fully functional.

