[jboss-svn-commits] JBL Code SVN: r33095 - labs/jbossrules/trunk/install.

jboss-svn-commits at lists.jboss.org jboss-svn-commits at lists.jboss.org
Wed May 26 11:26:38 EDT 2010


Author: KrisVerlaenen
Date: 2010-05-26 11:26:37 -0400 (Wed, 26 May 2010)
New Revision: 33095

Added:
   labs/jbossrules/trunk/install/install.html
Modified:
   labs/jbossrules/trunk/install/build.properties
   labs/jbossrules/trunk/install/build.xml
   labs/jbossrules/trunk/install/readme.txt
Log:
 - updated install script

Modified: labs/jbossrules/trunk/install/build.properties
===================================================================
--- labs/jbossrules/trunk/install/build.properties	2010-05-26 15:20:26 UTC (rev 33094)
+++ labs/jbossrules/trunk/install/build.properties	2010-05-26 15:26:37 UTC (rev 33095)
@@ -1,5 +1,5 @@
 # the home of your JBoss AS 4.2.3.GA installation
-jboss.home=C:/jboss-4.2.3.GA
+jboss.home=./jboss-4.2.3.GA
 
 # defines which server configuration should be used
 # for example, if you specify 'default', the application
@@ -8,4 +8,4 @@
 
 # the home of your eclipse installation
 # will be used to deploy the Eclipse plugin to
-eclipse.home=C:/Progra~1/eclipse-3.5.SR1
\ No newline at end of file
+eclipse.home=./eclipse

Modified: labs/jbossrules/trunk/install/build.xml
===================================================================
--- labs/jbossrules/trunk/install/build.xml	2010-05-26 15:20:26 UTC (rev 33094)
+++ labs/jbossrules/trunk/install/build.xml	2010-05-26 15:26:37 UTC (rev 33095)
@@ -6,54 +6,147 @@
 
   <property name="drools.version" value="5.1.0.SNAPSHOT" />
   <property name="drools.home" value="../" />
+
   <property name="jboss.server.conf.dir" value="${jboss.home}/server/${jboss.server.configuration}/conf" />
   <property name="jboss.server.data.dir" value="${jboss.home}/server/${jboss.server.configuration}/data" />
   <property name="jboss.server.deploy.dir" value="${jboss.home}/server/${jboss.server.configuration}/deploy" />
   <property name="jboss.server.lib.dir" value="${jboss.home}/server/${jboss.server.configuration}/lib" />
   <property name="jboss.server.birt.dir" value="${jboss.server.data.dir}/birt"/>
+  <property name="jboss.bind.address" value="localhost" />
+
   <property name="eclipse.workspace.dir" value="${drools.home}/install/sample/workspace"/>
+
+  <property name="jboss.download.url" value="http://downloads.sourceforge.net/jboss/jboss-4.2.3.GA.zip"/>
   <property name="h2.download.url" value="http://repository.jboss.org/maven2/com/h2database/h2/1.2.124/h2-1.2.124.jar"/>
   <property name="birt.download.url" value="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/R-R1-2_3_2_2-200906011507/birt-runtime-2_3_2_2.zip&amp;url=http://download.eclipse.org/birt/downloads/drops/R-R1-2_3_2_2-200906011507/birt-runtime-2_3_2_2.zip&amp;mirror_id=1"/>
 
-  <target name="install.guvnor.into.jboss" 
-          description="Installs Drools Guvnor into JBoss">
-    <copy file="${drools.home}/drools-guvnor/target/drools-guvnor.war"
-          tofile="${jboss.server.deploy.dir}/drools-guvnor.war"
-          overwrite="true" />
-  </target>
+  <!-- ############ DOWNLOAD ############ -->
 
+  <!-- Download H2 -->
   <target name="download.h2.check">
-     <echo message="Checking h2 ..." />
-     <condition property="h2.not.available">
-       <not>
-         <available file="${drools.home}/install/db/driver/h2.jar" />
-       </not>
-     </condition>
-  </target> 
-
+    <echo message="Checking h2 download ..." />
+    <condition property="h2.not.available">
+      <not>
+        <available file="${drools.home}/install/db/driver/h2.jar" />
+      </not>
+    </condition>
+  </target>
   <target name="download.h2" depends="download.h2.check" if="h2.not.available">
-     <echo message="Getting h2 ..." />
-     <mkdir dir="${drools.home}/install/db/driver"/>
-     <get src="${h2.download.url}" dest="${drools.home}/install/db/driver/h2.jar" />
+    <echo message="Getting h2 ..." />
+    <mkdir dir="${drools.home}/install/db/driver"/>
+    <get src="${h2.download.url}" dest="${drools.home}/install/db/driver/h2.jar" />
   </target>
 
+  <!-- Download BIRT engine (gwt-console) -->
   <target name="download.birt.check">
-     <echo message="Checking birt reporting engine ..." />
-     <condition property="birt.not.available">
-       <not>
-         <available file="${drools.home}/install/lib/birt-runtime-2_3_2_2.zip" />
-       </not>
-     </condition>
+    <echo message="Checking birt reporting engine download ..." />
+    <condition property="birt.not.available">
+      <not>
+        <available file="${drools.home}/install/lib/birt-runtime-2_3_2_2.zip" />
+      </not>
+    </condition>
   </target> 
-
   <target name="download.birt" depends="download.birt.check" if="birt.not.available">
-     <echo message="Getting birt reporting engine ..." />
-     <mkdir dir="${drools.home}/install/lib"/>
-     <get src="${birt.download.url}" dest="${drools.home}/install/lib/birt-runtime-2_3_2_2.zip" />
+    <echo message="Getting birt reporting engine ..." />
+    <mkdir dir="${drools.home}/install/lib"/>
+    <get src="${birt.download.url}" dest="${drools.home}/install/lib/birt-runtime-2_3_2_2.zip" />
   </target>
 
-  <target name="install.drools-gwt-console.into.jboss" depends="download.h2,download.birt"
-          description="Installs Drools gwt-console into JBoss">
+  <!-- Download JBoss AS -->
+  <target name="download.jboss.check">
+    <echo message="Checking JBoss AS download ..." />
+    <condition property="jboss.not.available">
+      <not>
+        <available file="${drools.home}/install/lib/jboss-4.2.3.GA.zip" />
+      </not>
+    </condition>
+  </target>
+  <target name="download.jboss" depends="download.jboss.check" if="jboss.not.available">
+    <echo message="Getting JBoss AS ..." />
+    <mkdir dir="${drools.home}/install/lib"/>
+    <get src="${jboss.download.url}" dest="${drools.home}/install/lib/jboss-4.2.3.GA.zip" />
+  </target>
+
+  <!-- Download Eclipse -->
+  <condition property="download.type" value="win32">
+    <os family="windows" />
+  </condition>	
+  <condition property="download.type" value="macosx-carbon">
+    <and>
+      <os family="mac" />
+      <os family="unix" />
+    </and>
+  </condition>
+  <condition property="download.type" value="linux-gtk">
+    <and>
+      <not>
+        <os family="mac" />
+      </not>
+      <os family="unix" />
+    </and>
+  </condition>		
+  <condition property="download.extension" value="zip">
+    <os family="windows" />
+  </condition>		
+  <condition property="download.extension" value="tar.gz">
+    <or>
+      <os family="mac" />
+      <os family="unix" />
+    </or>
+  </condition>	
+  <condition property="expandTypeZip" value="true">
+    <equals arg1="${download.extension}" arg2="zip" />
+  </condition>   
+  <condition property="expandTypeTarGz" value="true">
+    <equals arg1="${download.extension}" arg2="tar.gz" />
+  </condition>   
+  <target name="download.eclipse.check">
+    <echo message="Checking Eclipse download ..." />
+    <condition property="eclipse.not.available">
+      <not>
+        <available file="${drools.home}/install/lib/eclipse-SDK-3.5.1-${download.type}.${download.extension}" />
+      </not>
+    </condition>
+  </target>
+  <target name="download.eclipse" depends="download.eclipse.check" if="eclipse.not.available">
+    <echo message="Getting Eclipse ..." />
+    <mkdir dir="${drools.home}/install/lib"/>
+    <get src="http://download.eclipse.org/eclipse/downloads/drops/R-3.5.1-200909170800/eclipse-SDK-3.5.1-${download.type}.${download.extension}"
+         dest="${drools.home}/install/lib/eclipse-SDK-3.5.1-${download.type}.${download.extension}" />
+  </target>
+  <target name="download.eclipse.gef.check">
+    <echo message="Checking Eclipse GEF download ..." />
+    <condition property="eclipse.gef.not.available">
+      <not>
+        <available file="${drools.home}/install/lib/GEF-runtime-3.5.1.zip" />
+      </not>
+    </condition>
+  </target>
+  <target name="download.eclipse.gef" depends="download.eclipse.gef.check" if="eclipse.gef.not.available">
+    <echo message="Getting Eclipse GEF ..." />
+    <mkdir dir="${drools.home}/install/lib"/>
+    <get src="http://download.eclipse.org/tools/gef/downloads/drops/3.5.1/R200909151220/GEF-runtime-3.5.1.zip" 
+         dest="${drools.home}/install/lib/GEF-runtime-3.5.1.zip" />
+  </target>
+
+  <!-- ############ INSTALL ############ -->
+
+  <!-- Install JBoss AS -->
+  <target name="install.jboss" depends="download.jboss">
+    <unzip src="${drools.home}/install/lib/jboss-4.2.3.GA.zip" dest="${drools.home}/install" />
+    <chmod perm="a+x" file="${drools.home}/install/jboss-4.2.3.GA/bin/run.sh" />
+    <chmod perm="a+x" file="${drools.home}/install/jboss-4.2.3.GA/bin/shutdown.sh" />
+  </target>
+
+  <!-- Install guvnor -->
+  <target name="install.guvnor.into.jboss">
+    <copy file="${drools.home}/drools-guvnor/target/drools-guvnor.war"
+          tofile="${jboss.server.deploy.dir}/drools-guvnor.war"
+          overwrite="true" />
+  </target>
+
+  <!-- Install gwt-console -->
+  <target name="install.drools-gwt-console.into.jboss" depends="download.h2,download.birt">
     <!-- gwt-console -->
     <mkdir dir="${drools.home}/install/target"/>
     <mkdir dir="${drools.home}/install/target/drools-gwt-server-war"/>
@@ -115,8 +208,26 @@
     </copy>
   </target>
 
-  <target name="install.drools-eclipse.into.eclipse" 
-          description="Installs Drools Eclipse plugins into Eclipse">
+  <!-- Install Eclipse -->
+  <target name="install.eclipse" depends="download.eclipse,download.eclipse.gef">   
+    <antcall target="unzipEclipse" />	
+    <antcall target="untarEclipse" />
+    <unzip dest="${drools.home}/install" overwrite="true" 
+           src="${drools.home}/install/lib/GEF-runtime-3.5.1.zip" />				         
+  </target>    
+  
+  <target name="unzipEclipse" if="expandTypeZip">
+    <unzip dest="${drools.home}/install" overwrite="true" 
+           src="${drools.home}/install/lib/eclipse-SDK-3.5.1-${download.type}.zip" />  
+  </target>
+
+  <target name="untarEclipse" if="expandTypeTarGz">
+    <gunzip src="${drools.home}/install/lib/eclipse-SDK-3.5.1-${download.type}.tar.gz"/>
+    <untar dest="${drools.home}/install" src="${drools.home}/install/lib/eclipse-SDK-3.5.1-${download.type}.tar" />
+  </target>
+
+  <!-- Install Eclipse plugins -->
+  <target name="install.drools-eclipse.into.eclipse">
     <!-- install plugins -->
     <unzip src="${drools.home}/drools-eclipse/drools-eclipse-build/target/org.drools.eclipse-${drools.version}.zip" dest="${eclipse.home}"/>
     <unzip src="${drools.home}/drools-eclipse/drools-eclipse-build/target/org.drools.eclipse.task-${drools.version}.zip" dest="${eclipse.home}"/>
@@ -135,14 +246,19 @@
     </copy>
   </target>
 
+  <!-- Install Demo -->
+  <target name="install.demo" depends="install.jboss,install.guvnor.into.jboss,install.drools-gwt-console.into.jboss,install.eclipse,install.drools-eclipse.into.eclipse" />
+
+  <!-- ############ START/STOP ############ -->
+
+  <!-- Start H2 server -->
   <target name="start.h2" depends="download.h2">
     <java classname="org.h2.tools.Server" fork="true" spawn="true">
       <arg value="-tcp" />
       <classpath location="${drools.home}/install/db/driver/h2.jar" />
     </java>
-    
   </target>
-
+  <!-- Stop H2 server -->
   <target name="stop.h2" depends="download.h2">
     <java classname="org.h2.tools.Server" fork="true">
       <classpath location="${drools.home}/install/db/driver/h2.jar" />
@@ -151,26 +267,27 @@
     </java>
   </target>
 
+  <!-- Start JBoss AS -->
   <target name="start.jboss">
-    <exec executable="${jboss.home}/bin/run.bat"
-          spawn="yes"
+    <property name="jboss.full.path" location="${jboss.home}/bin/run.bat" />
+    <exec executable="${jboss.full.path}" spawn="yes"
           os="Windows 7,Windows Vista,Windows XP,Windows 2000">
       <arg value="-b" />
       <arg value="${jboss.bind.address}" />
     </exec>
-    <exec executable="${jboss.home}/bin/run.sh" spawn="yes" os="Linux,Mac OS X">
+    <property name="jboss.full.path" location="${jboss.home}/bin/run.bat" />
+    <exec executable="${jboss.full.path}" spawn="yes" os="Linux,Mac OS X">
       <arg value="-b" />
       <arg value="${jboss.bind.address}" />
     </exec>
-    <waitfor maxwait="5" maxwaitunit="minute" checkevery="30" checkeveryunit="second"
-      timeoutproperty="jboss.timeout">
+    <waitfor maxwait="5" maxwaitunit="minute" checkevery="30"
+             checkeveryunit="second" timeoutproperty="jboss.timeout">
       <socket server="${jboss.bind.address}" port="8080" />
     </waitfor>
     <fail if="jboss.timeout" message="jboss did not start within 5 minutes"/>
   </target>
-
-  <target name="stop.jboss"
-          description="signals jboss to stop, but doesn't wait till its finished">
+  <!-- Stop JBoss AS -->
+  <target name="stop.jboss">
     <exec executable="${jboss.home}/bin/shutdown.bat"
           os="Windows 7,Windows Vista,Windows XP,Windows 2000">
       <arg value="-s" />
@@ -184,32 +301,27 @@
     </exec>
   </target>
 
-  <target name="start.eclipse" description="starts eclipse">
-    <!-- Windows -->
+  <!-- Start Eclipse -->
+  <target name="start.eclipse">
     <exec executable="${eclipse.home}/eclipse.exe"
           spawn="yes"
           os="Windows 7,Windows Vista,Windows XP,Windows 2000">
       <arg value="-data" />
       <arg value="${eclipse.workspace.dir}" />
     </exec>
-    <!-- Unix -->
-    <chmod perm="+x">
-      <fileset dir="${eclipse.home}">
-        <filename name="eclipse" />
-      </fileset>
-      <!-- Path is different for OS X -->
-      <fileset dir="${eclipse.home}/Eclipse.app/Contents/MacOS/">
-        <filename name="eclipse" />
-      </fileset>
-    </chmod>
-    <exec executable="${eclipse.home}/eclipse" os="Linux">
+    <exec executable="${eclipse.home}/eclipse" spawn="yes" os="Linux">
       <arg value="-data" />
       <arg value="${eclipse.workspace.dir}" />
     </exec>
-    <exec executable="${eclipse.home}/Eclipse.app/Contents/MacOS/eclipse" os="Mac OS X">
+    <exec executable="${eclipse.home}/Eclipse.app/Contents/MacOS/eclipse" spawn="yes" os="Mac OS X">
       <arg value="-data" />
       <arg value="${eclipse.workspace.dir}" />
     </exec>
   </target>
 
+  <!-- Start Demo -->
+  <target name="start.demo" depends="start.h2,start.jboss,start.eclipse" />
+  <!-- Stop Demo -->
+  <target name="stop.demo" depends="stop.h2,stop.jboss" />
+
 </project>

Added: labs/jbossrules/trunk/install/install.html
===================================================================
--- labs/jbossrules/trunk/install/install.html	                        (rev 0)
+++ labs/jbossrules/trunk/install/install.html	2010-05-26 15:26:37 UTC (rev 33095)
@@ -0,0 +1,145 @@
+<HTML>
+<BODY>
+
+<H1>Installation</H1>
+
+<H2>Prerequisites</H2>
+This script assumes you have Java 1.5+, Maven 2.0.8+ and Ant 1.7+ installed.<BR/>
+If you don't, use the following links to download and install them:<BR/>
+Java: <A href="http://java.sun.com/javase/downloads/index.jsp">http://java.sun.com/javase/downloads/index.jsp</A><BR/>
+Maven: <A href="http://maven.apache.org/download.html">http://maven.apache.org/download.html</A><BR/>
+Ant: <A href="http://ant.apache.org/bindownload.cgi">http://ant.apache.org/bindownload.cgi</A><BR/>
+
+<H2>Getting Drools</H2>
+Download the latest Drools source code from SVN using the following URL:<BR/>
+<A href="http://anonsvn.jboss.org/repos/labs/labs/jbossrules/trunk/">http://anonsvn.jboss.org/repos/labs/labs/jbossrules/trunk/</A>
+<P/>
+Now run the Drools build. In the Drools root folder, run the following command:<BR/>
+<EM>mvn -Dmaven.test.skip -Declipse install</EM><BR/>
+<BR/>
+Note: If it is the first time you do this, this could take a while as it will be downloading
+eclipse as part of the installation, you can remove the -Declipse part if you're not
+interested in the Eclipse plugin.
+
+<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/>
+<EM>ant install.demo</EM><BR/>
+<BR/>
+This will:<UL>
+  <LI>Download JBoss AS</LI>
+  <LI>Download Eclipse</LI>
+  <LI>Install Guvnor into JBoss AS</LI>
+  <LI>Install the gwt-console into JBoss AS</LI>
+  <LI>Install the Eclipse plugins</LI>
+</UL>
+
+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/>
+<EM>ant start.demo</EM><BR/>
+<BR/>
+This will:<UL>
+  <LI>Start the H2 database</LI>
+  <LI>Start the JBoss AS</LI>
+  <LI>Start Eclipse</LI>
+  <LI>Start the Human Task Service</LI>
+</UL>
+<BR/>
+
+<H3>Using Eclipse Tooling</H3>
+<H3>Using Guvnor repository</H3>
+<H3>Using web management consoles</H3>
+
+<H2>Manually installing the different components</H2>
+<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.
+<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
+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
+<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
+
+<H3>Installing</H3>
+In the install dir, run installation script:<BR/>
+<EM>ant install.guvnor.into.jboss</EM><BR/>
+<EM>ant install.drools-gwt-console.into.jboss</EM><BR/>
+<EM>ant install.drools-eclipse.into.eclipse</EM><BR/>
+
+<H3>Starting</H3/>
+Startup database:<BR/>
+<EM>ant start.h2</EM>
+<P>
+Startup JBoss AS:<BR/>
+<EM>ant start.jboss</EM>
+<P>
+startup task service (run org.drools.task.service.DemoTaskService as part of the drools-process\drools-process-task project)
+<P>
+Startup eclipse:<BR/>
+<EM>ant start.eclipse</EM>
+
+
+add existing drools runtime in ${drools.home}\install\runtime (Window - Preferences, Drools - Installed Drools Runtimes, click Add..., name "Drools runtime", Browse to install/runtime directory in drools root and click OK, click OK again, check the created runtime, click OK)
+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

Modified: labs/jbossrules/trunk/install/readme.txt
===================================================================
--- labs/jbossrules/trunk/install/readme.txt	2010-05-26 15:20:26 UTC (rev 33094)
+++ labs/jbossrules/trunk/install/readme.txt	2010-05-26 15:26:37 UTC (rev 33095)
@@ -1,13 +1,21 @@
+[This script assumes you have Java 1.5+, Maven 2.0.8+ and ANT 1.7+ installed]
+
 Download latest Drools code from SVN: http://anonsvn.jboss.org/repos/labs/labs/jbossrules/trunk/
 
 Run Drools build: in Drools root folder run "mvn -Dmaven.test.skip -Declipse install"
-(if it is the first time you do this, this could take a while as it will be downloading eclipse as part of the installation, you can remove the -Declipse part if you're not interested in the Eclipse plugin)
+(if it is the first time you do this, this could take a while as it will be downloading
+ eclipse as part of the installation, you can remove the -Declipse part if you're not
+ interested in the Eclipse plugin)
 
-Download and install JBoss AS version 4.2.3.GA
+Download and install JBoss AS version 4.2.3.GA:
+If you don't have it installed yet, run installation script:
+  ant install.jboss
+  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)
 In install/build.properties, change the jboss.home property to the location of your JBoss AS installation
 
 Increase the memory that can be used by the application server (especially the PermGen space). To do so,
-On linux: 
+On linux/mac:
   edit the run.conf in your JBoss AS bin folder and add the following line at the end of the file:
   JAVA_OPTS="$JAVA_OPTS -XX:MaxPermSize=256m"
 On windows: 
@@ -17,30 +25,31 @@
   set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -XX:MaxPermSize=256m
 
 Download Eclipse 3.5.1
+If you don't have it installed yet, run installation script:
+  ant install.eclipse
+  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)
+    eclipse-SDK-3.5.1-macosx-carbon.tar.gz (mac))
 In install/build.properties, change the eclipse.home property to the location of your Eclipse installation
 
-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.
-
 in the install dir, run installation script:
 ant install.guvnor.into.jboss
 ant install.drools-gwt-console.into.jboss
 ant install.drools-eclipse.into.eclipse
 
-startup database (e.g. run org.h2.tools.Server.class inside h2-1.1.117.jar)
+startup database
+ant start.h2
 
 startup JBoss AS
+ant start.jboss
 
 startup task service (run org.drools.task.service.DemoTaskService as part of the drools-process\drools-process-task project)
 
 startup eclipse
-switch to Drools perspective
+ant start.eclipse
+
 add existing drools runtime in ${drools.home}\install\runtime (Window - Preferences, Drools - Installed Drools Runtimes, click Add..., name "Drools runtime", Browse to install/runtime directory in drools root and click OK, click OK again, check the created runtime, click OK)
 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
@@ -55,5 +64,22 @@
 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.
\ No newline at end of file



More information about the jboss-svn-commits mailing list