-----------------------
Configuration/ Deployment Issues:
	1. mySQL Database on DrLucky 
	2. JBoss 3.0.4 w/ Tomcat 4.1.12 
	3. J2EE SDK 1.3.1 
	4. Java SDK 1.4.1_01 

Known Problems:
	1. user name should be <= 255 characters (not enforced)


-----------------------
Setup:

1. obtain the executables
	a. create a temp directory (TEMPDIR)   
	b. >cd TEMPDIR
	c. download the four zip files found in baseline/build/release into the TEMPDIR


2. unzip the files in the temp directory 
	a. >unzip pq_ejb.zip          (will result in TEMPDIR/pqdeploy)
	b. >unzip pq_replication.zip  (will result in TEMPDIR/pqreplication)
	c. >unzip pq_ticker.zip       (will result in TEMPDIR/pqticker)
	d. >unzip pq_client.zip       (will result in TEMPDIR/pqclient)


3. make sure that JBOSS_HOME is set
	a. to use your own JBoss installation...
	   export JBOSS_HOME=<your installation path>/jboss-3.0.4_tomcat-4.1.12
	
	b. to use the team's JBoss installation...
	   export JBOSS_HOME=/afs/ece/class/ece841/public_html/team1/jboss-3.0.4_tomcat-4.1.12

   ** please make sure that JBOSS_HOME is either set in your .bashrc file
      or you set it in each terminal that you bring up. **
   
   
-----------------------
Installation:

1. install server(s)
	a. bring up a new terminal (ex: >xterm&)
	b. >cd TEMPDIR/pqticker
	c. >more serverlist.props

	   This will print out a list of hostnames that the server can be installed on.
	   It will look something like this:
               risk = 1
               trouble = 2
               scrabble = 3

	d. ssh to one of the machines listed (ex: >ssh risk)
	e. >cd TEMPDIR/pqdeploy
	f. >chmod +x installserver.sh
	g. >./installserver.sh


(step 1 can be performed for each of the servers listed)


-----------------------
Run:

1. start the JNDI on drlucky
	a. bring up a new terminal (ex: >xterm&)
	b. >ssh drlucky
	c. >cd $JBOSS_HOME/bin
	d. >./run.sh -c minimal


2. start the replication manager
	a. bring up a new terminal (ex:  >xterm&)
 	b. >ssh drlucky
	c. >cd TEMPDIR/pqreplication
	d. >chmod +x run-replication.sh
	e. >./run-replication.sh
	
	   Wait a few seconds, some exceptions will display and then the replication manager
	   will start all the servers.


3. start the ticker
	a. bring up a new terminal (ex: >xterm&)
 	b. >ssh drlucky
	c. >cd TEMPDIR/pqticker
	d. >chmod +x run-ticker.sh
	e. >./run-ticker.sh


4. start the client(s)
	a. bring up a new terminal (ex: >xterm&)
	b. ssh to any of the ece machines (ex: >ssh candyland)
	c. >cd TEMPDIR/pqclient
	d. >chmod +x run-client.sh
	e. >./run-client.sh

------------------------
Reading logs

1. read server logs
	a. bring up a terminal on the server your interested in
	b. >cd /tmp
	c. log information is in 'pq.log'