
								7/30/90
			BIT - Installation Guide

   This document describes how to load, run, and remove BIT.  BIT is MIPS
Manufacturing's Online Burn-In Test Program.  It is useful for verifying
that system hardware is functional.  This program runs on top of UNIX and
uses standard UNIX utilities.

   To install BIT on a system, the user should be logged in as "root" and
"cd" to a file system which can accomodate BIT's size (i.e. cd /usr).  The
following command will create a bit directory from tape:
	tar xv
Alternatively, a bit directory can be created from a tar file, typically
something like /usr/bit.tar:
	tar xvf <bit_tar_file>

   In manufacturing, BIT is installed by entering:
	make install 
This will set the file permissions and update the /etc/passwd, /etc/hosts,
and /etc/local_hostname files.  The /etc files require updating since
manufacturing machines are not yet configured to run on the local network.
The original /etc files are saved in etc.d and will be restored when BIT is
removed.  This target can only be made once (otherwise the saved /etc/...
files would be overwritten and lost).

   If the machine has already been configured for the local network, then
the /etc/hosts and /etc/local_hostname are already operational and do not
need to be replaced.  In this case, the user should enter:
	make bit 
This will set the file permissions and ownership, but leave /etc/hosts and
/etc/local_hostname alone.  This target can be called multiple times.
Thus, it is useful for keeping the file permissions correct whenever any
files are modified or replaced.

   To run BIT, enter the command:
	BIT
This starts up the main test script which prompts the user for machine
information, prompts for which tests to run, starts the tests, and displays
the test results while BIT is running.  BIT will continue running until the
user enters "Ctrl-C", at which time all temporary files will be removed and
the test results will be displayed and logged to the file, REPORT.BIT.

   BIT can be suspended, temporarily, if the user needs access to the
machine while BIT is running.  Enter "Ctrl-Z", and BIT will be suspended.
Entering the UNIX command, "fg", will restart BIT.  Suspending BIT will cause
no harm, but is not recommended because it will sometimes cause tests
to fail.  For instance, many tests (such as tape tests) have time limits
placed on their execution which can be exceeded while BIT is suspended.

   To remove BIT from the system, enter the command:
	make restore 
This will restore the /etc/passwd and /etc/hosts files to their original
contents.  It will also delete everything in the bit directory.  The bit
directory itself is left for the user to delete.

   To create another BIT tape, insert a blank tape and enter the command:
	make reltape


		      Serial Port Testing - Jumpers Required

   The mother-board serial port test checks the ports individually.  It
requires a DB25 connector with pins 2 and 3 crossed.

   The remaining serial port tests require jumpers between port pairs.  For
example, ports 1 and 2, 3 and 4, etc. should be connected together.  The
jumper should have pins 2 and 3 crossed and pins 8 and 20 crossed between
DB25 connectors.
