svn commit: r415346 - /geronimo/daytrader/branches/1.1.0/README

[ho...@apache.org]

Author: hogstrom
Date: Mon Jun 19 07:37:24 2006
New Revision: 415346

URL: http://svn.apache.org/viewvc?rev=415346&view=rev
Log:
Updated README per John Sisson's comments

Modified:
    geronimo/daytrader/branches/1.1.0/README

Modified: geronimo/daytrader/branches/1.1.0/README
URL: http://svn.apache.org/viewvc/geronimo/daytrader/branches/1.1.0/README?rev=415346&r1=415345&r2=415346&view=diff
==============================================================================
--- geronimo/daytrader/branches/1.1.0/README (original)
+++ geronimo/daytrader/branches/1.1.0/README Mon Jun 19 07:37:24 2006
@@ -2,31 +2,38 @@
 
 BUILD
 
-To build the dayTrader EAR, install maven and then type 'maven' from the dayTrader root directory (the directory containing this README).
+To build the dayTrader EAR, you need to have Maven 2 installed.   This can be found at http://maven.apache.org.  Once installed you can build DayTrader by executing the following command from the dayTrader root directory (the directory containing this README).:
 
-This should build the daytrader-ear-1.0-SNAPSHOT.ear in the modules/ear/target directory.
+mvn install
+
+This should build the daytrader-ear-1.1.ear in the modules/ear/target directory.
 
 INSTALL
 
-Before installing the EAR, you will need to create the tradedb database.  First, make sure Geronimo is started.  Then cd into the derby directory. Make sure the GERONIMO_HOME environment variable is defined.  Run either createDB.bat (Windows) or createDB.sh (Unix). This will create the tradedb database and its tables.
+Before installing the EAR, you will need to create the tradedb database.  
 
-To install the EAR, run the following from the dayTrader root directory:
-${GERONIMO_HOME}\deploy.[bat|sh] deploy modules\ear\target\daytrader-ear-1.0-SNAPSHOT.ear dayTrader-plan.xml
+The scripts below use ${GERONIMO_HOME} and ${DAYTRADER_HOME} as the root directory for each project.  You will need to either set these environment variables yourself or adjust the commands with the absolute path as required.  Windows users will need to use the appropriate Windows commands.  
 
-When the application starts, you may see exceptions such as "Error: TradeDirect:init -- error on JNDI lookups of DataSource -- TradeDirect will not work". You should be able to ignore these messages.
+1. Start the Apache Geronimo Application Server.
+2. Copy the geronimo-daytrader-derby-db-1.1.jar into the Geronimo repository
+   a. mkdir -p ${GERONIMO_HOME}/repository/geronimo/geronimo-daytrader-derby-db/1.1
+   b. cp ${DAYTRADER_HOME}/derby/geronimo-daytrader-derby-db-1.1.jar ${GERONIMO_HOME}/repository/geronimo/geronimo-daytrader-derby-db/1.1/
+   c. java -jar ${GERONIMO_HOME}/bin/deployer.jar deploy ${DAYTRADER_HOME}/modules/ear/target/daytrader-ear-1.1.ear \
+                ${DAYTRADER_HOME}/plans/[tomcat | jetty]-plan.xml
+   note: specify the tomcat or jetty based on the variant of Geronimo that was installed.
 
-RUN
+When the above steps are completed you need to populate the database.  Do this by accessing the application at http://<hostname>:<port>/daytrader.
 
-Access the dayTrader application at http://<hostname>:<port>/daytrader.  To begin trading, go to 'Configuration -> (Re)-populate Trade Database'. This creates the fictional users, stocks, prices, etc. in the database and may take a while.  After this you can go to 'Go Trade!' to begin trading.
+You can then choose configuration and select a Population size.  The default is 50 and 100 which is quite small.  Choose a sample that makes sense for your testing requirements.  Tests in the performance report which will be available at http://geronimo.apache.org were conducted with a population size of 5000 and 10000 respectively.
 
-There are two application clients you can run, the streamer client and web services client.  To run these (from the geronimo bin directory):
+When the configuration has been updated (after selecting the "Update" button at the bottom of the screen you will then need to select Populate Trade Database on the configuration screen.
 
-TradeStreamerAppClient:
-java -jar client.jar tradeStreamerAppclient
+Post questions and comments to the Geronimo User mailing list at user@geronimo.apache.org.
 
-wsappclient:
-java -jar client.jar Trade/daytrader-wsappclient-1.0-SNAPSHOT
+RUN
+
+Access the dayTrader application at http://<hostname>:<port>/daytrader.  To begin trading, go to 'Configuration -> (Re)-populate Trade Database'. This creates the fictional users, stocks, prices, etc. in the database and may take a while.  After this you can go to 'Go Trade!' to begin trading.
 
 ACKNOWLEDGEMENTS
 
-Many thanks to Gianny Damour and David Jencks for helping to get the sample to its working state at this point.
+Many thanks to Gianny Damour and David Jencks for helping to get the sample to its working state.  Also to Jeff Genender and Bryan Noll for putting a lot of work into testing this Application on other Application Servers.