RODX-SCM
		http://rodx-scm.sourceforge.net

		NOTE: the latest build can be pulled from CVS using cvs checkout ProjectOne_

		*** README FILE FOR SUPPLY CHAIN MANAGEMENT SOFTWARE ***

Developers:
Ryan Catherman
Omer Ansari
Dave Tran


This README file contains:
0. contents of this tar file package
1. Prerequisites of the software
2. how to install it
3. how to start/stop it
4. disclaimer

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

0. CONTENTS
[note: ignore all CVS/ directories]

- each source code file has a header in it briefly describing its functionality

README 		<--this file
build/		<--all compiled binaries 
build.xml	<--build file for ant /tomcat server
docs/		<--documentation for this project
src/		<--source code for the daemons
	EntitySpecificContainer/	<---Database Engine [Core]
	GUIClasses/			<---Some Classes that JSP code needs
	XMLEngine/			<---XML/GUI OrderPlacer and Receiver
	ScmMain.java			<---the main() of each daemon
	lib/				<---location for APIs (see #1 Pre-reqs below)
	start.sh			<---start script for daemons
	stop.sh				<---stop script for daemons
	tables				<---tables schema for oracle database
todo		
web/		<--JSP/HTML code for the frontend GUI for all vendors
	hose/				<---JSP/HTML code for hose vendor
	valve/				<---JSP/HTML code for valve vendor
	assm/				<---JSP/HTML code for assembly vendor
	ac/				<---JSP/HTML code for AC vendor
	



note, you can fetch fresh code via sourceforge's CVS :

cvs checkout ProjectOne_


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


1. PREREQUISITES:

A. need to put the following APIs into 
--------
ProjectOne_/src/lib/

1. gnujaxp.jar : ftp://ftp.gnu.org/pub/gnu/classpathx
2. classes12.zip : http://otn.oracle.com/software/tech/java/sqlj_jdbc/content.html

[alternatively, you can get the above APIs from the project's home page too]

B. need to install tomcat server from:
--------
http://jakarta.apache.org/tomcat/index.html

- put the above APIs into common/lib for jsp to use them. 
- [note, in order for JSP to recognize the above libraries, you might need to
unzip classes12.zip, and make a jar of all the files]

C. need JDK 1.2 from java.sun.com
--------

D. need ant installed from jakarta.apache.org
--------



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


2.  HOW TO INSTALL IT:

- untar the file into $CATALINA_HOME/webapps [$CATALINA_HOME is the path to the
tomcat install

- tweak the supplied build.xml by changing the username/password to that of
the tomcat server's manager:

<property name="username" value="managers_username"/>
<property name="password" value="managers_password"/>


- run  ant install to install this app into the tomcat space


- first time only: need to compile ProjectOne/src/ScmMain.java just once
see its comments on details on how to install it


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


3. START / STOP MECHANISM:


HOW TO RUN IT:

- there are 4 daemons that run, one for each vendor. all four of them can be
started at once using:

ProjectOne_/src/start.sh

. tweak this file to specify the path to the APIs if different, and to specify
different log files than default



HOW TO STOP IT:

use 

ProjectOne_/src/stop.sh


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


4. DISCLAIMER

-please read assumptions in the documentation on http://rodx-scm.sourceforge.net

-since we have used an external database at NCSU, we are NOT liable if the external database
stop functioning or misbehaves on its end.


-----------------------use in good health!----------------