This directory contains supporting materials for using Solaris-Athena
on SIPB servers.  Here is an overview of the file hierarchy:

	install.sh	Handy script to automate the installation of
			server machines

	patches		Patches to install on server machines.  (Some
			patches may not be world-readable.)

The remainder of this file describes procedures for installing,
modifying, and updating SIPB servers running Solaris-Athena under this
model.

Installing
----------

1. Install the machine normally.  Depending on the service, you may
   want to do a custom install and partition the machine yourself.
   Note the requirement of a 2GB space set aside for /packs.

   Don't let the machine reboot multi-user after the install.  Either
   babysit the machine and prevent it from rebooting multi-user, or do
   a custom install and tell it not to do an automatic reboot after
   installation.

2. Bring up the machine single-user.

3. Bring up the network and AFS by running the following commands:

	/etc/init.d/MOUNTFSYS start
	/etc/init.d/inetinit start
	/etc/init.d/afs start

4. Set up /srvd and /os symlinks by hand, running commands like:

	ln -s /afs/athena.mit.edu/system/sun4x_56/os /os
	ln -s /afs/athena.mit.edu/system/sun4x_56/srvd-8.2 /srvd

5. Make /packs either a symlink or a mount point for an area with at
   least 1GB free (enough room for a copy of the srvd and os volume
   plus some margin).

6. Get tokens in the sipb cell, if there might be any non-world-
   readable patches to install in the patches directory.

7. Run:

	sh /afs/sipb.mit.edu/service/solaris/scripts/install.sh

   This script will:

	* Copy the system packs and os volume to /packs/srvd and
	  /packs/os.
	* Apply all the Sun patches in the patches directory to
	  /packs/os.
	* Reset the modes and/or ownerships of some files.
	* Regenerate the stat files in /packs/srvd.
	* Set RVDCLIENT, PUBLIC, and AUTOUPDATE false in
	  /etc/athena/rc.conf.
	* Track the os and srvd onto the main filesystem.
	* Point /var/sadm at /os/var/sadm so patches applied to
	  /packs/os are reflected by showrev.

7. Perform service-specific configuration, including setting the root
   password and creating /etc/athena/access and /.k5login.

Adding a Solaris patch
----------------------

1. Retrieve the patch and untar it into the patches directory of this
   hierarchy, so that new server machines will get it.

2. Apply the patch to /packs/os on existing server machines (using
   "patchadd -R /packs/os /path/to/patch").

3. Propagate files from /packs/os to the main filesystem as necessary.