--- projects/cms/source/server/README	2001/01/07 21:12:40	1.5
+++ projects/cms/source/server/README	2002/06/07 16:12:47	1.11
@@ -1,22 +1,73 @@
-i-scream Server Startup
-=======================
+i-scream Server README
+======================
 
-Recommended startup sequence of components:
+ANT build vs Make build
+-----------------------
 
+** We have revamped the Makefile, but not the ANT build **
+** So please use the Makefile for now **
+
+There are now two methods of compiling the server distribution. The existing
+Makefile method is still supported, but is of course limited in the OS's on
+which it can be run. The preffered method will be an XML based build script
+using ANT (http://jakarta.apache.org/ant) which will run on any platform.
+However, at this stage the ANT scripts are not completely finished and may
+have some odd behaviour.
+
+We envisage both the Makefile and ANT setups being maintained for some time,
+giving the developer a choice. This document still outlines the Makefile
+method of compiling, and will do so until such a point as the ANT scripts
+are deemed reliable. If, however, you wish to give the ant script a whirl,
+try the following after setting up ANT (see the ANT website for details);
+
+ant help
+
+Compiling
+---------
+
+The server can now easily be compiled without worrying about setting up any
+of the CLASSPATH's, or setting the path to JacORB. It's all self contained.
+
+Typical sequence to compile;
+
+./configure
+make build
+make install prefix=/some/path
+make clean
+
+In more detail, the first line ensures that the required libraries are
+available, and sets the Makefiles up so they know where everything is.
+The second line compiles all of the code and creates a JAR file in the
+build directory.
+The install line installs the server and libraries to a given location,
+along with the configuration files.
+Finally, the last line cleans up.
+
+Running
+-------
+
+It is recommended that the components are started up in the following order.
+
+(This can be on multiple hosts if required, as long as the order is correct).
+
 Core
 ClientInterfaceMain
-DBInterfaceMain
+DBInterface
 FilterManager
-RootFilterMain
+RootFilter
 FilterMain
+Client
 
-It is not necessary to start both the ClientInterfaceMain and DBInterfaceMain,
-the server will handle only one. Multiple Filter's can be started as required.
+It is not necessary to start both the ClientInterfaceMain and DBInterface,
+the server will handle only one or both. Multiple Filter's can be started
+as required.
 
 These are all loaded through the ComponentManager. More details on how to
 operate this will be provided later on. Typing "make run" will make an
 attempt to load it up.
 
+Check build/etc/default.properties to set the startup list and order.
+
 nb. You will need to ensure that the relevant libraries are in the
     build/lib directory. See the README in there for details.
 
@@ -46,14 +97,32 @@ install
   Installs the server to a given directory. Also takes a prefix;
     make install prefix = /usr/i-scream
 
-cvsbuild
+dist
+  Builds a full distribution of the server.
+    make dist ver = 1.0
+  Default ver is HEAD.
 
-  Builds any tagged version of the server from CVS. This saves the need to
-  checkout a version to build it, as it's all done automatically;
-    make install rev = RELEASE_1
-  Default tag is HEAD.
+dist-bin
+  Builds a binary distribution of the server.
+    make dist ver = 1.0
+  Default ver is HEAD.
 
 javadoc
 
   Builds all the javadoc pages in the `doc' directory.
 
+buildutil
+
+    (it is recommended you run a "make clean" first)
+  Builds a seperate JAR file, in `build' called `iscream-util.jar'.
+  This file contains just the uk.ac.ukc.iscream.util package for
+  use in other parts of the system, such as the clients.
+
+createtable
+
+  Creates the ipacket table in the mySQL database. This is required for
+  the database side of the server.
+
+droptable
+
+  Drops an ipacket table from the mySQL database if one exists.