User: tcoleman
Date: 01/02/15 13:29:50
Modified: documentation petstore-1.1.1-01.html
Log:
Modify JPS build procedures; Add information on using Cloudscape
Revision Changes Path
1.4 +37 -51 newsite/documentation/petstore-1.1.1-01.html
Index: petstore-1.1.1-01.html
===================================================================
RCS file: /products/cvs/ejboss/newsite/documentation/petstore-1.1.1-01.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- petstore-1.1.1-01.html 2001/02/09 19:13:47 1.3
+++ petstore-1.1.1-01.html 2001/02/15 21:29:50 1.4
@@ -35,6 +35,9 @@
<p>
See the <code>/docs/security.html</code> page in the Pet Store demo for details.
<p>
+<li>
+<h3><a NAME="petstore00">Inventory</a></h3>
+<p>The Inventory Bean complains that it is "unable to locate invetory." (sic).
</ol>
<h2>Original contributor</h2>
@@ -63,9 +66,9 @@
<p>Running the Pet Store demo in JBoss currently requires that JBoss be patched to
support deployment of multiple Ejb's within an .ear file. It also requires
several minor changes to deployment files in the Pet Store application (.ear) file.
-You can get the source from
+The patch is currently available from
<a HREF="petstore-1.1.1-patch.zip">
-www.jboss.org/documentation/petstore-1.1.1-patch.zip</a>.
+www.jboss.org/newsite/documentation/petstore-1.1.1-patch.zip</a>.
<p>Copy the patch file to a temporary directory and unzip it. The patch
contains two (2) zip files; one to patch JBoss, and another to patch the
Pet Store demo.
@@ -93,29 +96,34 @@
<p>
<li>
<h3><a NAME="petstore4">Select a Database</a></h3>
-<p>The Pet Store demo uses the <b>Cloudscape</b> database by default.
+<p>The Pet Store demo uses the <b>Cloudscape</b> database by default.
+To avoid problems with SQL syntax, use Cloudscape if at all possible.
+<p>
It also includes SQL scripts for building databases in
<b>Oracle</b> and <b>Sybase</b>, (though you may need to comment out the
<code>drop table</code> statements at the top for them to run the first time).
-The JBoss Pet Store patch file includes a Firebird/InterBase script.
-The Pet Store demo should work with just about any JDBC compliant database.
+<p>
<p>The Pet Store demo is being tested with
<a HREF="http://firebird.sourceforge.net/fb_download.html">Firebird/InterBase
6.0.</a>
+The JBoss Pet Store patch file includes a Firebird/InterBase script.
In order to use Firebird/Interbase, you will also need to install Interclient
2.0, which provides the JDBC inteface. Using the Reference J2EE server, the
-Pet Store demo did not work correctly with Interclient 1.6.
-<p>(Installing Firebird/InterBase and Interclient is beyond the scope of this
-document.)
+Pet Store demo did not work correctly with Interclient 1.6. (Installing
+Firebird/InterBase and Interclient is beyond the scope of this document.)
+<p>
+The Pet Store demo theoretically should work with just about any JDBC compliant
database.
<p>
<li>
-<h3><a NAME="petstore5">Rebuild the Pet Store application (petstore.ear)</a></h3><p>
-<p>These steps add the file <code>jboss-web.xml</code> to the WEB-INF directory in
-<code>petstore.war</code>, modify the <code>serverType</code> in the
-<code>web.xml</code> file of that directory to allow the application to
-recognize JBoss, and modify the <code>application.xml</code> file in the META-INF
directory of <code>petstore.ear</code>.
-This preliminary documentation describes how to do this manually:
+<h3><a NAME="petstore5">Rebuild the Pet Store application (petstore.ear)</a></h3>
<p>
+The following step overwrites several files in the Pet Store application sources.
You may want to make a separate copy of the JBoss version of the Pet Store.
+<p>This step adds the file <code>jboss-web.xml</code> to the WEB-INF directory in
+<code>petstore.war</code>, modifies the <code>serverType</code> in the
+<code>web.xml</code> file of that directory to identify the JBoss server to
+the application, and modifies the <code>application.xml</code> file in the META-INF
directory of <code>petstore.ear</code>.
+<p>
+<p>
a. Copy the <code>petstore-jboss-mods.zip</code> file to the root directory
($PETSTORE)
of your Pet Store distribution. Change to this directory and unzip the file.
@@ -127,49 +135,27 @@
</pre>
<p>
-b. Rebuild the Pet Store application. Run <code>build.sh</code> or
<code>build.bat</code> in the
-<code>$PETSTORE/src/petstore/src/build directory</code>. The result is a new
-<code>petstore.ear</code> in the <code>$PETSTORE/src/petstore/build</code>
directory.
+b. Rebuild the Pet Store application.
+<p>Run <code>build.sh</code> or <code>build.bat</code> in the
+<code>$PETSTORE/src/petstore/src/build directory</code>.
+<p>The result is a new <code>petstore.ear</code> in the
<code>$PETSTORE/src/petstore/build</code> directory.
-<p>
-c. Copy the new <code>petstore.ear</code> to a clean temporary directory and unjar
it:
<p>
-<pre>
- cp $PETSTORE/src/petstore/build/petstore.ear $TEMP
- cd $TEMP
- jar xvf petstore.ear
-</pre>
-
-<p>
-d. Edit the application.xml file. The <b>estore</b> context needs a leading
-slash to work with Tomcat.
-<p>
-<pre>
- <web>
- <web-uri>petstore.war</web-uri>
- <context-root><b>/estore</b></context-root>
- <web>
-</pre>
-
-<p>
-e. Rejar the application. The result is the application file you will deploy
-in JBoss.
-<p>
-<pre>
- rm petstore.ear
- jar cvf petstore.ear *
-</pre>
+This is the file you deploy by copying it to <code>$JBOSS_HOME/deploy</code>.
<p>
<li>
-<h3><a NAME="petstore6">Add DB Pool to JBoss</a></h3>
+<h3><a NAME="petstore6">Add DB Pools to JBoss</a></h3>
<p>The JBoss Petstore patch file includes the file
- <code>jboss.jcml.</code> The default configuration has
- a Firebird/InterBase DB Pool. If you will be using a
- different database, you should update or replace this with a
- single DB pool that points to your database, and then edit the file
- according to the procedures in the
- <a HREF="../manual/adv_config.html#datasources">Data Sources</a> section.</p>
+ <code>jboss.jcml.</code> This file has Pet Store DB Pools for
+ Cloudscape and Firebird/InterBase. You will have to comment
+ out or remove the unused Pool.
+<p> Cloudscape mappings are included in the <code>standardjaws.xml</code> file
+ included in the Pet Store patch.
+<p> If you will be using a
+ different database, you will need to define DB pools appropriate
+ for your database. See the
+ <a HREF="../manual/adv_config.html#datasources">Data Sources</a> section for
details.</p>
<p>
<li>
