--- projects/cms/source/server/README 2000/12/06 22:54:22 1.3 +++ projects/cms/source/server/README 2001/01/07 21:12:40 1.5 @@ -1,28 +1,59 @@ i-scream Server Startup ======================= -Current startup sequence: +Recommended startup sequence of components: -uk.ac.ukc.iscream.core.Core -uk.ac.ukc.iscream.clientinterface.ClientInterfaceMain -uk.ac.ukc.iscream.dbinterface.DBInterfaceMain -uk.ac.ukc.iscream.filtermanager.FilterManager -uk.ac.ukc.iscream.rootfilter.RootFilterMain -uk.ac.ukc.iscream.filter.FilterMain +Core +ClientInterfaceMain +DBInterfaceMain +FilterManager +RootFilterMain +FilterMain -The following sequence of commands should suffice. They will probably need -to be run in seperate terminal windows. +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. -make runcore -make runclientinterface -make rundbinterface -make runfiltermanager -make runrootfilter -make runfilter NAME=filter1 +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. -If all is working this will ensure every component, including the IDL, is -compiled as required before execution. +nb. You will need to ensure that the relevant libraries are in the + build/lib directory. See the README in there for details. -nb. you will need to ensure your classpath is correctly set prior to - running, otherwise java will fail to find the jacorb classes and the - XML parsing packages. +Makefile +======== +The following targets are available; + +build + + Compile the entire server package, include the IDL file. Generates the + JAR file for the final package. + +run + + Run's the server from the JAR file in /build. + +clean + + Cleans all compiled code, and javadoc pages. + +distclean + + Also cleans files left by configure, including the libraries. + +install + + Installs the server to a given directory. Also takes a prefix; + make install prefix = /usr/i-scream + +cvsbuild + + 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. + +javadoc + + Builds all the javadoc pages in the `doc' directory. +