[jboss-svn-commits] JBL Code SVN: r33615 - labs/jbossrules/trunk/install.
jboss-svn-commits at lists.jboss.org
jboss-svn-commits at lists.jboss.org
Wed Jun 23 18:09:01 EDT 2010
Author: KrisVerlaenen
Date: 2010-06-23 18:09:01 -0400 (Wed, 23 Jun 2010)
New Revision: 33615
Modified:
labs/jbossrules/trunk/install/install.html
Log:
- updated install script
Modified: labs/jbossrules/trunk/install/install.html
===================================================================
--- labs/jbossrules/trunk/install/install.html 2010-06-23 21:31:06 UTC (rev 33614)
+++ labs/jbossrules/trunk/install/install.html 2010-06-23 22:09:01 UTC (rev 33615)
@@ -11,7 +11,8 @@
<H2>Demo setup</H2>
The easiest way to get started is to simply run the installation script to install the demo setup.
-Simply go into the install folder and run:<BR/>
+Simply go into the install folder and run:<BR/>
+<BR/>
<EM>ant install.demo</EM><BR/>
<BR/>
This will:<UL>
@@ -24,6 +25,7 @@
Once the demo setup has finished (this could take a while as it might have to download the various components),
you can start playing with the various components by starting the demo setup:<BR/>
+<BR/>
<EM>ant start.demo</EM><BR/>
<BR/>
This will:<UL>
@@ -32,65 +34,94 @@
<LI>Start Eclipse</LI>
<LI>Start the Human Task Service</LI>
</UL>
-<BR/>
+Once everything is started, you can start playing with the Eclipse tooling, Guvnor and gwt-console, as explained in the next three sections.
+<BR/>
<H3>Using Eclipse Tooling</H3>
+
+The <A href="http://people.redhat.com/kverlaen/install-eclipse.swf">following screencast</A> gives an overview of how to run a simple demo process in Eclipse. It shows you:
+<UL>
+ <LI>How to import an existing example project into your workspace, containing
+ <UL>
+ <LI>a sample BPMN2 process for requesting a performance evaluation</LI>
+ <LI>a sample Java class to start the process</LI>
+ </UL>
+ </LI>
+ <LI>How to start the process</LI>
+ <LI>How to complete human tasks using the test human task client in Eclipse</LI>
+</UL>
+If you want to know more, we recommend you take a look at the Drools documentation <A href="http://hudson.jboss.org/hudson/job/drools/lastSuccessfulBuild/artifact/trunk/target/docs/drools-flow/html/index.html">here</A>.
-Start by importing the sample project into your workspace.
-
<H3>Using Guvnor repository</H3>
Open up Drools Guvnor:<BR/>
-<A href="http://localhost:8080/drools-guvnor">http://localhost:8080/drools-guvnor</A>
+<A href="http://localhost:8080/drools-guvnor">http://localhost:8080/drools-guvnor</A><BR/>
+<BR/>
+Log in, using any non-empty username / password (we disabled authentication for demo purposes).
<P>
-Start by importing the sample repository.
+The <A href="http://people.redhat.com/kverlaen/install-guvnor.swf">following screencast</A> gives an overview of how to manage your repository. It shows you:
+<UL>
+ <LI>How to import an existing sample repository, containing the performance evaluation process as shown in the previous section</LI>
+ <LI>How to look up the processes that are part of a package</LI>
+ <LI>How to build a package so it can be used for creating a session (like for example in the gwt-console as shown in the next section)</LI>
+</UL>
+If you want to know more, we recommend you take a look at the Drools documentation <A href="http://hudson.jboss.org/hudson/job/drools/lastSuccessfulBuild/artifact/trunk/target/docs/drools-guvnor/html/index.html">here</A>.
<H3>Using web management consoles</H3>
First make sure you have imported the sample repository and built the defaultPackage in Guvnor first (see previous section).
<P>
Open up the process management console:<BR/>
-<A href="http://localhost:8080/gwt-console">http://localhost:8080/gwt-console</A>
+<A href="http://localhost:8080/gwt-console">http://localhost:8080/gwt-console</A><BR/>
+<BR/>
+Log in, using krisv / krisv as username / password.
<P>
-Make sure you have imported the sample repository and build the defaultPackage in Guvnor first.
+The <A href="http://people.redhat.com/kverlaen/install-gwt-console.swf">following screencast</A> gives an overview of how to manage your process instances. It shows you:
+<UL>
+ <LI>How to start a new process</LI>
+ <LI>How to look up the current status of a running process instance</LI>
+ <LI>How to look up your tasks</LI>
+ <LI>How to complete a task</LI>
+ <LI>How to generate reports to monitor your process execution</LI>
+</UL>
+If you want to know more, we recommend you take a look at the Drools documentation <A href="http://hudson.jboss.org/hudson/job/drools/lastSuccessfulBuild/artifact/trunk/target/docs/drools-flow/html/ch14.html">here</A>.
+<P>
+Once you're done playing:
+<EM>ant stop.demo</EM>
+<P>
+and simply close all the rest.
-<H2>Manually installing the different components</H2>
+
+<H2>Manually installing the different components</H2>
+
+If you don't want to use the demo setup, you can also use the individual ant targets, as described below.
+
<H3>Getting JBoss AS</H3>
You need to download and install JBoss AS version 4.2.3.GA.
If you don't have it installed yet, go into the install folder and run the installation script:<BR/>
<EM>ant install.jboss</EM><BR/>
<BR/>
This will download and install the server in install/jboss-4.2.3.GA folder. If you don't
-want it to download the zip file, you can put a jboss-4.2.3.GA.zip in the install/lib folder.
+want it to download the zip file, you can put the jboss-4.2.3.GA.zip in the install/lib folder.
<P>
If you already have it installed somewhere else, in install/build.properties, change the
jboss.home property to the location of your JBoss AS installation.
<P>
-Increase the memory that can be used by the application server (especially the PermGen space). To do so,<BR/>
-on linux/mac:<BR/>
-<EM>edit the run.conf in your JBoss AS bin folder and add the following line at the end of the file:</EM><BR/>
-<EM>JAVA_OPTS="$JAVA_OPTS -XX:MaxPermSize=256m"</EM><BR/>
-On windows: <BR/>
-<EM>edit the run.bat in your JBoss AS bin folder and change the following line:</EM><BR/>
-<EM>set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m</EM><BR/>
-<EM>to</EM><BR/>
-<EM>set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -XX:MaxPermSize=256m</EM><BR/>
<H3>Getting Eclipse</H3>
-You need to download and install Eclipse 3.5.1
+You need to download and install Eclipse 3.5.2
If you don't have it installed yet, run installation script:<BR/>
<EM>ant install.eclipse</EM><BR/>
<BR/>
This will download and install eclipse in install/eclipse folder.
-If you don't want it to download the eclipse file, you can put the file in the install/lib folder:
- eclipse-SDK-3.5.1-linux-gtk.tar.gz (linux),
- eclipse-SDK-3.5.1-win32.zip (windows), or
- eclipse-SDK-3.5.1-macosx-carbon.tar.gz (mac).
-If you don't want it to download the eclipse GEF file, you can put the file in the install/lib folder:
- GEF-runtime-3.5.1.zip
+If you don't want it to download the eclipse file, you can put the file in the install/lib folder:<BR/>
+ eclipse-SDK-3.5.2-linux-gtk.tar.gz (linux),<BR/>
+ eclipse-SDK-3.5.2-win32.zip (windows), or<BR/>
+ eclipse-SDK-3.5.2-macosx-carbon.tar.gz (mac).<BR/>
+If you don't want it to download the eclipse GEF file, you can put the GEF-runtime-3.5.2.zip file in the install/lib folder.
<P>
If you already have it installed somewhere else, in install/build.properties, change the
-eclipse.home property to the location of your Eclipse installation
+eclipse.home property to the location of your Eclipse installation.
<H3>Installing</H3>
In the install dir, run installation script:<BR/>
@@ -111,39 +142,16 @@
Startup eclipse:<BR/>
<EM>ant start.eclipse</EM>
+<H3>Stopping</H3>
+
+Once you're done playing<BR/>
+stop database:<BR/>
+<EM>ant stop.h2</EM>
+<P>
+stop JBoss AS:<BR/>
+<EM>ant stop.jboss</EM>
+<P>
+and simply close all the rest.
-import existing project ${drools.home}\install\sample (File - Import..., General - Existing Projects into Workspace, select install/sample/evaluation and click OK, click Finish)
-run example
-
-Add Evaluation.rf to guvnor, package defaultPackage (right-click on evaluation.rf in src/main/rules and select Guvnor - Add..., create a new Guvnor repository connection, under repository fill in /drools-guvnor/org.drools.guvnor.Guvnor/webdav/, click Next, select defaultPackage and click Finish)
-open Guvnor http://localhost:8080/drools-guvnor/ (login using any username/password, if it asks about installing samples, click No thanks)
-build defaultPackage (under Knowledge Bases, select defaultPackage, click on Build Package)
-
-open gwt-console http://localhost:8080/gwt-console/ (login using krisv/krisv)
-start process (Processes - Process overview, Click on Evaluation process and click Start and then OK, fill in username krisv and click Complete and close window)
-complete self-evaluation (Tasks - Personal Tasks, click on Performance Evaluation task, click View, fill in evaluation form, click Complete and close window)
-logout and login as john (john/john) to complete evaluation (Tasks - Personal Tasks, click on Performance Evaluation task, click View, fill in evaluation form, click Complete and close window)
-see reports (Reporting - Report Templates, select Overall Activity Report and click Create Report)
-
-Once you're done playing
-stop database: ant stop.h2
-stop JBoss AS: ant stop.jboss
-and simply close all the rest
-
-// TODO: how to add forms + graphs
-// TODO: register custom work item handlers
-// TODO: deploy demo task service as a service on the AS?
-// TODO: custom logins / task users
-
-// TODO: how to change configuration for another DB?
-Update datasource configuration if necessary (uses h2 in memory database by default).
-[You don't need to change anything to these files if you just want to use this default configuration]
-install/db/testDS1-ds.xml
-install/db/persistence.xml
-install/db/hibernate.cfg.xml
-
-Put database driver jar in install/db/driver directory (e.g. h2-1.1.117.jar, create the driver dir if necessary)
-By default, it will download the h2.jar.
-
</body>
-</html>
\ No newline at end of file
+</html>
More information about the jboss-svn-commits
mailing list