
				Instructions
				------------

			Last Update: January 14th, 1986


	This file contains instructions on how to create and install
the entire MSG mail system.  It should be read BEFORE any attempts
are made at actually creating and/or installing any of the software
contained herein!

	First off, you'll need to create the documents so that you
can read the "MSG Configuration Guide" and configure the system
correctly for your local site needs...

	$ make documentation

This will create two documents - the "Msg Users Guide", and the "Msg
Configuration Guide".  For our purposes, you're only interested in the 
configuration guide, so at this point print out the file 

		"doc/Config.fmtd" 

and then continue reading with that document.

--------

I assume you've read and followed the directions in the Configuration
guide if you're back here!  If not, GO DO IT!!!

--------

Try again - ready?

Okay.  Now that we've configured the MSG system so that it will all
be happy with the file locations, node type, memory requirements,
and so on of your system we can actually try to make the system!

The first step is to edit the Makefile so that the define for the
macro "DEFINE" is correct for your OS.  The choices are "BSD", "UTS"
or the default of Bell/HP-UX.

When you're done, type:

	$ make all

This will take a fair while, so it's recommended that you go and eat 
lunch or play a game for a while!! 

Assuming there are no errors during compilation (we'll have to assume
that for the moment) you should now be able to list the directory "bin"
and find the following files:

  "answer", "arepdaemon", "autoreply", "cutfile", "fastmail", "from", 
  "msg", "newalias", "newmail", "printmail", "readmsg" and "snd"

at this point you need to check the system level Makefile (in this
directory) to check that the defines for the following are correct
for your system:

	TAPE=   /dev/rct
	DEST=   /usr/local/bin
	LIB=    /usr/local/lib
	MAN=	/usr/man/man1

(these are the Bell System V defaults, more or less).  Once they're 
altered to your satisfaction, you can install all the software by
becoming root on your machine (you'll need write permission to the
directories above) then typing:

	$ make install
	
When this is done:
	
	$ cd /usr/local/bin

(or wherever you changed DEST in the makefile to) then typing:

	$ chown root msg
	$ chmod 4755 msg

This is because the mailer has to have the ability to CREATE new
files in the "mailhome" directory.  If it doesn't have this 
permission, it will immediately fail upon invokation, telling
you that it wants that permission.   

Note to System Administrators:  As an administrator of a single
user and 25 user Unix system, I am aware of the potential dangers
that a setuid root program pose.  However, great cares have been
taken to remove any possibility of raising a ruckus with the
added privileges.   (check src/syscall.c for example)  If any
problems do arise PLEASE LET ME KNOW!!!

Finally, we're just about done!   The final checks can be made
by the following commands:

	$ /usr/local/bin/msg -z

should say "no mail" if nothing's in the mailbox

	$ /usr/local/bin/msg -f test/test.mail

should read in EIGHT messages from various people.  While here, try to
A)lias C)urrent message for each of the eight messages to confirm that
the reply/address system is working okay.   Now try to C)hange mailboxes
to the file "test/test.note" and use the '%' key to see if the mailer is
generating valid return addresses for the notes (If not, then you might
need to install the pathalias database - see "sysdefs.h" for more info)
Change back to "test/test.mail" and Q)uit without having marked anything 
for deletion...answer the questions accordingly.

If you get this far you're in Wonderful shape!  In fact, you're done!

Congratulations!  You've just installed one of the best electronic mail
systems available today on your machine (if I say so myself!)

HANDY HINTS:  If you want to create a print of the entire set of
sources, including this file, use the command:

	$ make listing

If, on the other hand, you just want to create a listing file of 
just the MSG sources, try:

	$ make msg-listing

Also, if you have a number of machines on a network, you can rlogin
to the remote machine and then do a remote install (after checking
to ensure that the networking copy method in the Makefile under the
target "remote-install" is correct) by typing:

	$ make -f <remote Makefile> REMOTE=<remote file system> rmt-install

(for example, if we had installed the system on machine "machx" and 
 wanted to install it on "machy", with the Makefile in /src/Msg on
 "machx", we could type from "machy";
	 $ make -f machx:/src/Msg/Makefile REMOTE=machx: rmt-install
 to have it install the system on machine y!)

That's it!
----------

	Author's address:	hpcnof!dat@HPLABS
				ihnp4!hpfcla!d_taylor

	Mail address:		Dave Taylor
				Hewlett Packard - CNO (MS 102)
				3404 East Harmony Road
				Fort Collins CO
				80525

	phone:		(work)  (303) 229-2419


  This document and the entire mail system is

	(C) Copyright 1986, Dave Taylor
