Author: tom.baeyens(a)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>