#	START NEW ARIX SCCS HEADER
#
#	@(#) README: version 25.1 created on 11/27/91 at 14:51:52
#
#	Copyright (c) 1990 by Arix Corporation
#	All Rights Reserved
#
#	@(#)README	25.1	11/27/91 Copyright (c) 1990 by Arix Corporation
#
#	END NEW ARIX SCCS HEADER
#
This directory (/usr/sys) contains the files necessary to recreate the Arix
system kernel. 

* The files ./cf/config.h and ./cf/conf.c contain all the data defines and
  declarations for the current configuration parameters and are generated by
  running /etc/config on /etc/master.d/* and /etc/system.  Some important
  files and directories are:
	/etc/master.d	 (directory that contains all the master files)
	/etc/system	 (the current system description file)
	./iolib		 (make's list of kernel binaries and libraries)
	./lib		 (directory for the binaries in ./iolib)
	/usr/include/sys (directory containing the system include files)

* To modify these parameters, edit the /etc/system file to specify the 
  modified/new parameters.  Save a copy of /etc/system BEFORE you begin.

* To add a new device driver, stream module, file system switch entry, or line
  discipline, to the kernel (for a newly defined type) run the INSTALL script
  that will came with the package.  The INSTALL script may also do the next
  step (creating and installing the kernel).  Software developers should
  check the manual entry drvinstall(1M) for details on how to install drivers.

* To create and install a new kernel type:

	make install

  This will create a new kernel named:  arix

  By saying "install" make will also copy arix to arix.<date> in the root
  directory.  [<date> is the current month and day (i.e. arix.1216)]

* To finish the installation:
	1) Make sure you have a printed copy of these instructions, or you
	   have your System Administrator's Guide handy.
	2) Take the system to Single User State with "shutdown -y".
	3) Save a copy of the current kernel:  mv /arix /arix.old
	4) Link in the new kernel:  ln /arix.<date> /arix
	5) Type:  sync
	6) Type:  sync
	7) Type:  uadmin 2 1
		(This will reset the system and auto-boot.  Be sure that the
		 new kernel is the one which is booted.)
   Installation is complete.

* If the new kernel won't boot:
	1) Write down all the error messages.
	2) Reset the system.
	3) After the SPM Runtime Image has been booted, press the space bar
	   to avoid a kernel auto-boot.
	4) Boot the old kernel:  boot XdYsZarix.old
		   X = CSS slot number (the slot where the IOPM/DSDB resides),
		   Y = drive number,
		   Z = partition number (typically 0)
	   Model 85s may want to boot from a DSDB in an expansion cabinet:
		boot W/XdYsZ
		   W = the CSS slot number of the IOM that leads to the
		       expansion cabinet,
		   X = the IOPM/DSDB's slot number in the expansion cabinet,
		   Y, and Z are the same
	4) After the old kernel has booted, type:  ln /arix.old /arix
	5) Use the error messages to fix the problem and build a new kernel.
	6) Repeat the installation procedure.
	*) Note that once you have typed "boot XdYsZarix.old" the SPM
	   Runtime Menu will remember the "XdYsZarix.old" and use that for
	   the default kernel name.  So, when you try your corrected kernel,
	   you will have to stop the auto-boot process at the SPM Runtime
	   again and type:  boot XdYsZarix
