[jbpm-commits] JBoss JBPM SVN: r4905 - jbpm4/trunk/modules/userguide/src/main/docbook/en/modules.

[do-not-reply at jboss.org]

Author: tom.baeyens at jboss.com
Date: 2009-05-27 03:30:08 -0400 (Wed, 27 May 2009)
New Revision: 4905

Modified:
   jbpm4/trunk/modules/userguide/src/main/docbook/en/modules/ch02-Installation.xml
Log:
doc updates based on burr's feedback

Modified: jbpm4/trunk/modules/userguide/src/main/docbook/en/modules/ch02-Installation.xml
===================================================================
--- jbpm4/trunk/modules/userguide/src/main/docbook/en/modules/ch02-Installation.xml	2009-05-26 18:11:12 UTC (rev 4904)
+++ jbpm4/trunk/modules/userguide/src/main/docbook/en/modules/ch02-Installation.xml	2009-05-27 07:30:08 UTC (rev 4905)
@@ -27,12 +27,9 @@
     <para>The <emphasis role="bold">demo setup</emphasis> is the simplest way to get started.
     This section describes the steps to complete the demo setup.
     </para>
-    <para>If you have jboss-5.0.0.GA on locally on your machine, create a directory 
-    called <literal>downloads</literal> in your jBPM home directory and copy 
-    the jboss distribution zip file in there.  Same for an Eclipse Ganymede SR2 JEE distribution 
-    (eclipse-jee-ganymede-SR2-win32.zip).  If you have it already locally, copy it to 
-    the downloads directory.  If you don't have those files in that place, they will be downloaded 
-    automatically by the demo setup ant script.
+    <para>If you have previously downloaded jboss-5.0.0.GA.zip, create a downloads directory 
+    in your jBPM home directory and place the zip file in there. Otherwise the script will download 
+    it for you. the same is true for eclipse-jee-ganymede-SR2-win32.zip
     </para>
     <para>Open a command prompt and go do directory <literal>${jbpm.home}/jboss</literal>.  Then 
     run
@@ -44,15 +41,15 @@
       <listitem>Install jBPM into that JBoss installation.  By default, this includes a hypersonic 
       database that is accessable over TCP/IP. 
       </listitem>
-      <listitem>Start JBoss.  This will also start the hypersonic DB.</listitem>
+      <listitem>Start JBoss in the background.  This will also start the hypersonic DB.</listitem>
       <listitem>Create the DB Schema</listitem>
       <listitem>Create an examples.bar business archive from the examples and deploy it to the jBPM DB.</listitem>
       <listitem>Load the example users and groups from <literal>${jbpm.home}/db/example.identities.sql</literal> </listitem>
       <listitem>Install eclipse into <literal>${jbpm.home}/eclipse</literal></listitem>
       <listitem>Start eclipse</listitem>
     </itemizedlist>
-    <para>Once this is done and eclipse has started, you can continue to follow the instructions
-    of <xref linkend="graphicalprocessdesigner" /> 
+    <para>After this is done JBoss will be running in the background.  Once eclipse has started, you can continue 
+    to follow the instructions of <xref linkend="graphicalprocessdesigner" /> 
     </para>
     <para>And you can surf to <ulink url="http://localhost:8080/gwt-console">the jBPM console</ulink>
     You can login as one of the following users:
@@ -104,6 +101,8 @@
     want to customize:
     </para>
     <itemizedlist>
+      <listitem><literal>jbpm.home</literal> : Default value is <literal>${user.home}/jbpm-${jbpm-version}</literal>.  
+      You should set it to the location where you unzipped the distribution.</listitem>
       <listitem><literal>database</literal> : Default value is <literal>hsqldb</literal>.  Alternative values 
       are <literal>mysql</literal>, <literal>oracle</literal> and <literal>postgresql</literal></listitem>
       <listitem><literal>jboss.version</literal> : Default value is <literal>5.0.0.GA</literal>.  Alternative 
@@ -197,7 +196,7 @@
         <mediaobject><imageobject><imagedata align="center" fileref="images/gpd.install.gpd.site.png"/></imageobject></mediaobject>
       </figure>
     </section>
-    <section>
+    <section id="definejbpmuserlibraries">
       <title>Define the jBPM User Library</title>
       <para>This section shows how to define a user library for your workspace
       that is a placeholder for the jBPM library as well as its dependencies. 
@@ -266,6 +265,10 @@
         <listitem>The <literal>examples</literal> project is automatically found and selected</listitem>
         <listitem>Click <literal>Finish</literal> </listitem>
       </itemizedlist>
+      <para>After setting the <link linkend="definejbpmuserlibraries">jBPM User Libraries</link> 
+      and importing the examples, all the examples can be run as JUnit tests.  Right click 
+      on a test and select 'Run As' --> 'JUnit Test'.  
+      </para>
       <para>You're all set to start playing with the coolest Java process technology!</para>
     </section>