Installing and running MINIX for Solaris (SMX)
------------------------------------------------------
(HOWTO for HY345 by  M. Flouris (flouris@csd.uoc.gr) )

==================================================================

1. Copy SMX.

Copy the minix source directory to one of your own directories.
We will use the directory "/minix" as an example for our case.

Commands :
    cd /minix
    cp -r ~hy345/minix/smx .
    cd smx

==================================================================

2. Configure SMX.

Edit the file "env.sh". Line 4 of this file is :
"setenv SMXDIR  /home/lessons/hy345/minix/smx"
Change it to :
"setenv SMXDIR  /minix/smx"

Edit the file "src/Solaris/Makefile".
Line 6 of this file is :
"DESTDIR=/home/lessons/hy345/minix/smx/bin"
Change it to :
"DESTDIR=/minix/smx/bin" (/minix is the directory we use in this
example, you should use your own directory path).

In the smx directory you will find three shell script files :
a) env.sh : contains the environment variable settings and the
path settings for running smx.
b) compile_smx.sh : contains the commands needed to compile and
install the smx files.
c) run_smx.sh : contains the command to run SMX.

You will use these last two scripts after this setup step.

==================================================================

3. Compile and install SMX.

The commands you need are in the compile_smx.sh file.
Simply do a : "source compile_smx.sh"
After some compilation messages everything should be OK.

==================================================================

4. Run SMX.

Simply do a "source run_smx.sh" ...
and you should see something like this :
------------------------------------------------------
hy345@kirkios: /tmp/smx # source run_smx.sh 
Minix 2.0.0  Copyright 1997 Prentice-Hall, Inc.

eth_init0: got reply for wrong port
arp.c: unable to open ethernet
ip.c: unable to open eth port

Memory size = 3072K   MINIX =1184K   RAM disk =    0K   Available = 1888K

/dev/hdx1 is read-write mounted on /usr/bin
/dev/hdx2 is read-write mounted on /usr/man
Starting standard daemons: update.

Solaris-Minix  Release 2.0 Version 0

noname login: 
------------------------------------------------------

This means that Solaris MINIX (SMX) is running fine.
You can login as "root" and try all the usual UNIX commands
like : "ls", "cd", "du", etc. SMX has its own filesystem mounted,
so you will not be able to see your files.

====================================================================

5. To shutdown SMX, login as root and type "shutdown" or "halt"
E.g.
----------------------------------------------
Solaris-Minix  Release 2.0 Version 0

noname login: root
! halt
Exiting smx
hy345@kirkios: /tmp/smx #
-----------------------------------------------

====================================================================


Useful Info
-----------

A. The source code for SMX is in the "src" directory. If you
modify the source code, you should recompile and run SMX
(repeat steps 3 and 4).

B. Useful SMX links :

http://www.cosc.canterbury.ac.nz/~paul/smx.html
http://www.disi.unige.it/person/DoderoG/minix/minix.htm