Author: stocco Date: Tue Jan 25 08:35:58 2005 New Revision: 126389 URL: http://svn.apache.org/viewcvs?view=rev&rev=126389 Log: This update was submitted by Jeremiah Johnson. Some minor edits to the README file associated with the petstoredemo.
Reviewed by Steve Tocco Modified: incubator/beehive/trunk/samples/petstoreWeb/README Modified: incubator/beehive/trunk/samples/petstoreWeb/README Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/samples/petstoreWeb/README?view=diff&rev=126389&p1=incubator/beehive/trunk/samples/petstoreWeb/README&r1=126388&p2=incubator/beehive/trunk/samples/petstoreWeb/README&r2=126389 ============================================================================== --- incubator/beehive/trunk/samples/petstoreWeb/README (original) +++ incubator/beehive/trunk/samples/petstoreWeb/README Tue Jan 25 08:35:58 2005 @@ -1,81 +1,76 @@ -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 - - +Welcome to the Beehive Petstore +=============================== + +Requirements +============ + +The following software is required to build and deploy the pet store: + + - Java 5 + - Ant 1.6.2 + - J2EE Container + +Setup +===== + +1) Java 5 + + Download: http://java.sun.com/j2se/1.5.0/download.jsp + + Install Java 5 and set the JAVA_HOME environment variable to +refernce the JDK install directory. Ensure that $JAVA_HOME/bin is +available in your $PATH. + +2) Ant 1.6.2 + + Download: http://ant.apache.org/bindownload.cgi + + Ant 1.6.2 is the minimum version required to build Beehive. Install +Ant 1.6.2 and set the ANT_HOME environment variable to reference the +Ant install directory. Ensure that $ANT_HOME/bin is available in your +$PATH. + +3) J2EE Container + + A J2EE Container is required. Use your existing container. + +Building +======== + +In the descriptions below, <BeehiveRoot> refers to the root of the +Beehive distribution. For example, if the distribution was unpacked +to c:\beehive, then that is what you should substitute for <BeehiveRoot>. + +The first time you build the Petstore web application, you will need to +pull in the Beehive runtime libraries. Use the following target once: + +ant -f <BeehiveRoot>\ant\webappRuntimeCore.xml + -Dwebapp.dir=<BeehiveRoot>\samples\petstoreWeb + deploy.beehive.webapp.runtime + +To build the Petstore web application, run the following target: + +ant -f <BeehiveRoot>\ant\buildWebapp.xml + -Dwebapp.dir=<BeehiveRoot>\samples\petstoreWeb + build + +Deploying and Running +===================== + +Use your container's standard deployment practice to deploy the Web +application found in samples/petstoreWeb. + +If you used petstoreWeb as the context root, then you should be able to +hit the Petstore web application, use the URL: + + http://<host>:<port>/petstoreWeb/Controller.jpf + +For example, if you are using Tomcat 5.0.25 for you J2EE container, you +may deploy using the following: + +cd <BeehiveRoot>\samples\petstoreWeb +jar cf %CATALINA_HOME%\webapps\petstoreWeb.war * + +Check the Beehive Wiki for information about deploying to other +containers. +
