                          MAT Installation Guide
                          ----------------------

MAT is a two part program, the MAT Console, and the MAT agent.  The MAT console
is the GUI front-end.  It provides the easy to use interface for managing your 
UNIX hosts.  The MAT agent is the backend process which processes the requests
from the MAT console, and modifies the UNIX configuration files.  The MAT 
agent has to be installed on every machine you want MAT to manage.  The MAT
console only needs to be installed on one machine.  The following instructions
outlines how to install MAT on a UNIX machine.


Installing the MAT agent:
-------------------------
Before starting the install make sure you have the correct agent for the 
platform you wish to install on.  Currently the MAT agent is available for the
following operating systems:
	- Linux  (only tested on 2.0.x)
	- Solaris 2.5
	- SunOS 4.1.4

Installation of the MAT agent reguires three steps.
	1.  Unpack the distribution.  Install in /var/mat, or /usr/mat
	2.  Update /etc/services
	3.  Update /etc/inetd.conf, and restart inetd

Unpack the MAT agent distribution into a temporary dir.  It's one of the files
matagent.tar.{OS name}.  The Linux version includes a version with shadow
password support.  The shadow passwords are NOT fully tested.  Edit the 
install.sh, and set the MATHOME variable to the directory of your choice.  Do not 
install MAT in a NFS mounted partition, because the later releases of MAT will
have some monitoring tools, which will store data in the $MATHOME/var directory.
Run the install.sh file, and it will install the MAT agent.

The install script has only been tested on a Linux machine.  If it fails you
can install manually quite easily.
1.  Make a directory for the MAT agent, and untar the matagent.tar file into the
directory.
 
2.  Edit the /etc/services file.  It should have an entry like the following:
mat		2345/tcp		# Mat agent

This will let MAT use port 2345.  If you want to use another port, just change
2345 to whatever you want that's free.  If you change it from the default 2345
you will need to edit the MAT console executable "mat", and set the "port"
variable to the new value.

3.  Edit the /etc/inetd.conf file.  It should have an entry like the following:
mat	stream	tcp	nowait	root	/var/mat/bin/matagent	/var/mat

If you choose to install in another directory you will need to change the last 
two entries in the above line.  For example to install in /usr/local/mat
change:  /var/mat/bin/matagent   to   /usr/local/mat/bin/matagent
 and          /var/mat           to        /usr/local/mat

Restart the inetd deamon.  That should be it.

To test the agent telnet to the host with the agent on the appropriate port
e.g.   telnet localhost 2345
It should respond with something like:
MAT Agent Started.  C version 0.12 (Beta).
Type "ping".  It will respond with the version number and OS type.

********************************  NOTE  *****************************
By default MAT will NOT modify the actual configuration files on the
UNIX host, instead it will modify it's own copy of the files.  After
you are comfortable with MAT's operation you can make links to the
actual files.
*********************************************************************
That's the MAT agent installed.


Installing the MAT Console
--------------------------
The MAT console requires Tcl/TK from SUN Microsystems.  Tcl/TK is part of the
Linux distribution.  Tck/TK version 8.0 or higher is highly recommended for the
speed improvements.  

MAT Console on a UNIX machine.
1. Extract the MAT console file "matcon.tar".
2. Make sure that Tcl/TK is installed on the machine you want to run the console
on.  If it's in your path, you should be able to find it by running:
	whereis wish    or
	which wish
After you have found it edit the file "mat" and replace
"#!/usr/local/bin/wish8.0"  with "#!{your location for wish}"

3.  Next you need to make the tclIndex file in the MAT console lib directory.
Go to the lib directory in the MAT console installationand start tclsh e.g.
	>  cd mat/lib
	>  tclsh
You will see the tclsh prompt "%".  Type "auto_mkindex {MAT lib path} *.tcl".
If the MAT lib directory was /home/root/mat/lib you would type:
	%   auto_mkindex /home/root/mat/lib *.tcl

4.  The MAT console is now ready to run, just go to the MAT bin directory and
type ./mat
	
MAT Console on Windows 95:
If you plan on using the MAT console in Windows 95 you will have to download 
Tcl/TK from SUN.  There are some problems with fonts, but other than that it
appears to run.  Extract the MAT console, and rename the file "mat" to "mat.tk"
.  Double-click on the MAT icon, and away you go.


