Author: steveh Date: Wed Oct 27 09:40:05 2004 New Revision: 55715 Modified: incubator/beehive/trunk/samples/petstoreWeb/README Log: Updating the Petstore sample README.
Modified: incubator/beehive/trunk/samples/petstoreWeb/README ============================================================================== --- incubator/beehive/trunk/samples/petstoreWeb/README (original) +++ incubator/beehive/trunk/samples/petstoreWeb/README Wed Oct 27 09:40:05 2004 @@ -1,30 +1,81 @@ -Welcome to the Beehive Petstore -=============================== - -Building -======== - -As the Petstore webapp is checked into SVN, it is setup to build -in a Beehive developer environment. The build file is here: - - $BEEHIVE_HOME/samples/petstoreWeb/WEB-INF/src/petstore-build.xml - -This build file references core webapp and Tomcat support Ant files -that live in: - - $BEEHIVE_HOME/test/ant/... - -To build the application, run: - - ant -f petstore-build.xml build - -To deploy the application, start Tomcat and run: - - ant -f petstore-build.xml deploy - -To hit the running application, use the URL: - - http://localhost:8080/petstoreWeb/Controller.jpf - -Your mileage here will vary depending on your Tomcat setup. - +Welcome to the Beehive Petstore +=============================== + +Requirements +============ + +Beehive requires the following software to build and deploy +the petstore: + + - J2SE 5.0 + - Ant 1.6.2 + - Tomcat 5.x + +Setup +===== + +In the descriptions below, $BEEHIVE_HOME refers to the root of the +Beehive distribution. For example, if Beehive is installed in: + + c:\java\beehive-0.3alpha + +the value of BEEHIVE_HOME would be: + + %BEEHIVE_HOME%=c:\java\beehive-0.3alpha + +Now, modify and run $BEEHIVE_HOME/beehiveUser.cmd to initialize your +shell with some required environment variables including: + +BEEHIVE_HOME +JAVA_HOME +ANT_HOME +CATALINA_HOME + +This will also add Java and Ant to your PATH. + +Note, if you are running on Windows, you will need to replace +$BEEHIVE_HOME with %BEEHIVE_HOME% below. + +Building +======== + +To build the Petstore web application, run the following target: + +ant -f $BEEHIVE_HOME\ant\buildWebapp.xml + deploy.beehive.webapp.runtime build.webapp + -Dwebapp.dir=$BEEHIVE_HOME\samples\petstoreWeb + +This will copy the Beehive webapp runtime into + + $BEEHIVE_HOME/samples/petstoreWeb/WEB-INF/lib + +and run the Beehive webapp build process on the petstoreWeb application. + +Deploying and Running +===================== + +Petstore can be deployed to a running version of Tomcat in one +of two ways: + +1) copy $BEEHIVE_HOME/samples/petstoreWeb/ to $CATALINA_HOME/webapps + +This will cause Tomcat to automatically deploy the webapp. + +2) Use Beehive's deploy Ant target to deploy the Petstore to Tomcat. + +This requires that the "manager" role be defined in +$CATALINA_HOME/conf/tomcat-users.xml with a username / password of +"manager" / "manager". + +Then, run the Ant command: + +ant -f $BEEHIVE_HOME\ant\buildWebapp.xml + deploy + -Dwebapp.dir=$BEEHIVE_HOME\samples\petstoreWeb + -Dcontext.path=petstoreWeb + +To hit the running application, use the URL: + + http://localhost:8080/petstoreWeb/Controller.jpf + +
