Sunday, May 26, 2013

How to build and run the Drools and Guvnor Beta3 Demo

After the release of the Drools and Guvnor beta3 video see here, I'm being asked how people can build and run it themselves. Luckily it's very easy, so here are some quick instructions :)
  • Make sure you set your MAVEN_OPTS:
    • MAVEN_OPTS="-Xms512m -Xmx1024m -XX:MaxPermSize=128m"
  • Git clone:
    • https://github.com/droolsjbpm/guvnor
  • From clone root, built the main application:
    • mvn clean install -DskipTests
  • Change to the WAR module:
    • cd drools-wb/drools-wb-distribution-wars
  • Build the WAR
    • mvn clean install -DskipTests
    • Builds Tomcat and JBoss AS WARs, with the firefox profile.
      • WAR only works with Firefox, but quick to compile, for testing.
  • Download unzip and start JBoss AS7.1
    • http://download.jboss.org/jbossas/7.1/jboss-as-7.1.1.Final/jboss-as-7.1.1.Final.zip
    • ./standalone.sh
    • Once started, don't forget to create a management user with add-user.sh
  • Install the WAR via the AS web console
    • Find the WAR and upload it, AS automatically installs it
    • drools-workbench-6.0.0-SNAPSHOT-jboss-as7.0.war
  • Go to URL and login
    • http://localhost:8080/drools-workbench-6.0.0-SNAPSHOT-jboss-as7.0
    • login/pass admin/admin
    • Must use fireFox, as maven build defaults to reduced number of profile sets, for fast building. 
      • Use -PfullProfile with mvn install, to build all profiles, with longer build times.
  • There is a sample repo, but mostly has rubbish in it, stick to the uberfire playground.

Things to notice, or try:
  • Maven POM editor, when the file explorer is inside a maven project
  • As per my video, try building and installing the poject, and viewing in the maven manager
  • Clone some external projects, see if you can build and deploy them
  • Have a play with some of the custom editors, especially the guided editors and decision tables.


Share/Bookmark

11 comments:

  1. I have an issue when I follow the [Build the WAR].
    I have this error :
    [INFO] Scanning for projects...
    [ERROR] The build could not read 1 project -> [Help 1]
    [ERROR]
    [ERROR] The project org.drools:drools-wb-distribution-wars:6.0.0-SNAPSHOT (/home/xmouchot/Téléchargements/guvnor-master/drools-wb/drools-wb-distribution-wars/pom.xml) has 1 error
    [ERROR] Non-resolvable parent POM for org.drools:drools-wb:6.0.0-SNAPSHOT: Could not find artifact org.drools:droolsjbpm-parent:pom:6.0.0-SNAPSHOT and 'parent.relativePath' points at wrong local POM @ org.drools:drools-wb:6.0.0-SNAPSHOT, /home/xmouchot/Téléchargements/guvnor-master/drools-wb/pom.xml, line 5, column 11 -> [Help 2]
    [ERROR]
    [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
    [ERROR] Re-run Maven using the -X switch to enable full debug logging.
    [ERROR]
    [ERROR] For more information about the errors and possible solutions, please read the following articles:
    [ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/ProjectBuildingException
    [ERROR] [Help 2] http://cwiki.apache.org/confluence/display/MAVEN/UnresolvableModelException

    ReplyDelete
    Replies
    1. Anyone have this issue? (I tried to do it on an ubuntu)

      Delete
  2. Thanks Mark for these details. I am using Windows 7 and in executing git clone encounter the errors below. I suspect this is due to limited path lengths with Windows. If I download the zip version and extract it works fine. Anyone have any thoughts on a resolution?

    Cheers, Mark.

    Cloning into 'guvnor'...
    remote: Counting objects: 215310, done.
    remote: Compressing objects: 100% (64095/64095), done.
    remote: Total 215310 (delta 109554), reused 211716 (delta 106083)
    Receiving objects: 100% (215310/215310), 466.11 MiB | 574 KiB/s, done.
    Resolving deltas: 100% (109554/109554), done.
    error: unable to create file drools-wb/drools-wb-jcr2vfs-migration/drools-wb-jcr
    2vfs-migration-core/src/test/resources/org/drools/workbench/jcr2vfsmigration/mig
    rationExample.jcr/repository/repository/datastore/26/5b/2c/265b2c5b00c2954377e18
    77ff0f52f52c8e34a4d (No such file or directory)
    error: unable to create file drools-wb/drools-wb-jcr2vfs-migration/drools-wb-jcr
    2vfs-migration-core/src/test/resources/org/drools/workbench/jcr2vfsmigration/mig
    rationExample.jcr/repository/repository/datastore/51/fe/6d/51fe6d6d7415a505269f3
    a14b47534e2e4d4bff9 (No such file or directory)
    error: unable to create file drools-wb/drools-wb-jcr2vfs-migration/drools-wb-jcr
    2vfs-migration-core/src/test/resources/org/drools/workbench/jcr2vfsmigration/mig
    rationExample.jcr/repository/repository/datastore/69/a9/a8/69a9a8d1ea90e9801e249
    8586efa76b077d10bab (No such file or directory)
    error: unable to create file drools-wb/drools-wb-jcr2vfs-migration/drools-wb-jcr
    2vfs-migration-core/src/test/resources/org/drools/workbench/jcr2vfsmigration/mig
    rationExample.jcr/repository/repository/datastore/6d/c4/a8/6dc4a8452d05c34a73ec5
    f5716de1c725e37caa7 (No such file or directory)

    ReplyDelete
    Replies
    1. Hi Mark, thanks for your interest to get your hands dirty with our stuff ;)

      Well.. this is a know issue (limited path length).. we're now in a middle of a release, after it we'll start to fix it on windows.

      Delete
    2. I'm unable to get this to build as well. It fails on the webapp step as well with file name too long.

      Delete
    3. Currently the build does not work on windows - as the path ends up too long. It works fine on linux and ox. We are going to do a refactoring, to try and address this, to get shorter path names.

      Delete
  3. Thanks porcelli for the useful information and thanks Mark for the wit :) Porting it over to Openshift...

    ReplyDelete
    Replies
    1. Hi Mark, I tried to did it on an ubuntu.
      I have an issue on the second maven install command.
      You can see the 1 comment i posted.
      Let me know if you have the same issue or if it's ok for you :)
      thks

      Delete
    2. Hi. Not on this project however on a different one. You need to install the the bootstrap pom found here: https://github.com/droolsjbpm/droolsjbpm-build-bootstrap to your local repo. You could also add the jboss snapshot repository to your maven settings or the appropriate pom of the project you are building. It is located at https://repository.jboss.org/nexus/content/repositories/snapshots/

      Hope that helps.

      Delete
  4. Previous Drools versions reference different install steps for JBoss AS vs Apache Tomcat. For Drools 6, are the install steps and files still different?

    ReplyDelete