Installation instructions for mSQL Version 2.0
---------------------------------------------- 

1.	Unpack the source code.

2. 	In the source directory type "make target".  This will create a
	"symbolic link tree" for your platform under the targets/ directory.
	For example, on a BSD/OS machine you may end up with a replica
	of the source code directory in targets/BSD_OS-2.1-i386/

3.	Change directory to the target directory for your machine.

4.	Run the setup utility (Note: use ./setup to ensure you get the
	mSQL setup utility and not a system utility).

5.	After setup has completed,  you can edit a couple of default
	configuration values in site.mm if you wish.  When you are happy
	type "make all"

6.	If the compilation of mSQL completes properly, type "make install"
	This will install all the mSQL related files under /usr/local/Hughes
	(or whatever directory you set as the install directory in site.mm) 
	You may need root access to perform this step.

7.	Edit /usr/local/Hughes/msql.conf to see if everything is OK.
	The only thing you might change in a normal installation is the
	username of the mSQL_User or the Admin_User.  By default, mSQL is 
	configured to run as a user called 'msql' with root being the admin
	user (i.e. the one who can create databases, shutdown the server
	etc).

8.	Ensure that the installation directory (and everything under it)
	is owned by the user that mSQL will run as (e.g. the msql user).
	To do this, issue a command like "chown -R msql /usr/local/Hughes".
	Substitute the correct username and installation directory if
	you are running a non-default installation.

9.	If you wish to use the WWW interface package, W3-mSQL, you
	should start the mSQL server (by running /usr/local/Hughes/bin/msql2d &)
	and then execute misc/setup_www.  This will setup a couple of
	databases and install the Hughes Technologies related web page
	graphics etc. into your web tree.  You'll need to be running as
	the mSQL Root_User as this creates several databases.  You may
	also need to run as a specific user to modify your web tree.
	Note : setup_www expects to find Lite installed in the default
	location.  If you installed into anywhere other than
	/usr/local/Hughes please edit the first line of the
	setup_www script to reflect the location of the Lite binary.

10.	If you want to use W3-mSQL you'll need to copy w3-auth and
	w3-msql from /usr/local/Hughes/bin to your cgi-bin directory (or
	provide a symbolic link to them from your cgi-bin).  You will
	also need to copy the graphics files used by these tools into
	your web tree.  Create a directory called 'Hughes' at the top
	of your web tree and then copy the demos/w3-msql/graphics
	directory into the newly created 'Hughes' directory (i.e.
	using a browser you could load
	http://your.host/Hughes/graphics/hughes.gif)

11.	If you want to install the sample W3-mSQL application (the 
	bookmarks database), copy the demos/w3-msql/bookmarks directory
	to the top of your web tree (i.e. so that http://your.host/bookmarks/ 
	will load the welcome page of the sample application).


Note : To use the W3-mSQL authentication / access control features
you'll need a web server that passes authentication headers to CGI
scripts.  The CERN server does this and a patch is available from Hughes
Technologies to add this feature to the Apache server.  The Apache patch
is available for both 1.1 and 1.2 versions of Apache.  Please see the
Software section of www.Hughes.com.au for details.
