<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="https://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
jBPM-5.3.0.Final Manual Deployment Guide for Beginner
</h3>
<span style="margin-bottom: 10px;">
modified by <a href="https://community.jboss.org/people/quangtin3">quangtin3</a> in <i>jBPM</i> - <a href="https://community.jboss.org/docs/DOC-21179">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><p><div class="toc" style="border: 1px dashed black; padding: 10px;"><ul><ul><li>
<a class="jive-link-anchor-small" href="#1_Overview_of_jBPM">1. Overview of jBPM</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#jBPM_Components">jBPM Components</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Separation_deployment">Separation deployment</a>
</li>
</ul><li>
<a class="jive-link-anchor-small" href="#2_Common_bugs_fix_after_jBPM530Final_release">2. Common bugs fix after jBPM-5.3.0.Final release</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#Building_from_sourcecode">Building from source-code</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#a_Configure_your_git_username_and_email">a. Configure your git username and email</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#b_Clone_jbpm_repository_from_githubcom">b. Clone jbpm repository from github.com</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#c_Working_with_local_repository">c. Working with local repository</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#List_all_jBPM_tags_">List all jBPM tags </a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Switch_to_530Final_revision_tag">Switch to 5.3.0.Final revision tag.</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#View_prehistory_just_before_jBPM_team_released_jBPM530Final">View pre-history just before jBPM team released jBPM.5.3.0.Final</a>
</li>
</ul></ul><li>
<a class="jive-link-anchor-small" href="#Apply_bug_fix">Apply bug fix</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#Bug_Could_not_locate_named_parameter_userId">Bug: Could not locate named parameter [userId]</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Bug_No_result_or_connection_timeout">Bug: No result, or connection timeout</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Bug_Must_be_positive">Bug: Must be positive</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Bug_HornetQ_binding_only_to_local_address">Bug: HornetQ binding only to local address.</a>
</li>
</ul></ul><li>
<a class="jive-link-anchor-small" href="#3_Manual_jBPM_components_deployment">3. Manual jBPM components deployment</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#Environment">Environment</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#Check_your_JDK_installation">Check your JDK installation</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Check_apache_maven">Check apache maven</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Check_apache_ant">Check apache ant</a>
</li>
</ul><li>
<a class="jive-link-anchor-small" href="#Deployment_parameters">Deployment parameters</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#MySQL_database_deployment_just_verify">MySQL database deployment (just verify).</a>
</li>
</ul><li>
<a class="jive-link-anchor-small" href="#4_Drools_guvnor_designer_and_formbuilder_deployment_with_verify">4. Drools guvnor, designer, and form-builder deployment (with verify)</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#Step_41Extract_a_clean_copy_of_jbossas702Finalzip_to_GUVNOR_JBOSS">Step 4.1:Extract a clean copy of jboss-as-7.0.2.Final.zip to GUVNOR_JBOSS</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Step_42_Jboss_configuration">Step 4.2: Jboss configuration.</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Step_43_droolsguvnor_configuration">Step 4.3: drools-guvnor configuration</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#a_Update_GUVNOR_JBOSSpreferencesproperties_to_our_will_be_deployed_designer_and_formbuilder">a. Update GUVNOR_JBOSS/preferences.properties to our will be deployed designer and form-builder</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#b_Place_a_copy_of_GUVNOR_JBOSSpreferencesproperties_to_droolsguvnorwartargetWEBINFclassespreferencesproperties">b. Place a copy of GUVNOR_JBOSS/preferences.properties to drools-guvnor.war/target/WEB-INF/classes/preferences.properties</a>
</li>
</ul><li>
<a class="jive-link-anchor-small" href="#Step_44_Deploy_and_verify_droolsguvnor_component_installation">Step 4.4: Deploy and verify drools-guvnor component installation</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#a_Deploy_droolsguvnor">a. Deploy drools-guvnor</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#b_Verify_that_we_have_the_following_message_in_the_console">b. Verify that we have the following message in the console</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#c_Verify_that_we_can_access_the_droolsguvnor">c. Verify that we can access the drools-guvnor</a>
</li>
</ul><li>
<a class="jive-link-anchor-small" href="#Step_45_Deploy_designer">Step 4.5: Deploy designer</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#a_Apply_the_change_for_Designer_as_following_article_httpbpmgeekcomblogmakingjbpm5workremotehost_">a. Apply the change for Designer as following article http://bpmgeek.com/blog/making-jbpm5-work-remote-host </a>
</li>
<li>
<a class="jive-link-anchor-small" href="#b_Deploy_designer">b. Deploy designer</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#c_Verify_designer">c. Verify designer</a>
</li>
</ul><li>
<a class="jive-link-anchor-small" href="#Step_46_Deploy_formbuilder">Step 4.6: Deploy form-builder</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#a_Add_usersroles_configuration_to_GUVNOR_JBOSS">a. Add users/roles configuration to GUVNOR_JBOSS</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#b_Add_security_domain_for_jbpmformbuilder_in_file_standaloneconfigurationstandalonexml">b. Add security domain for jbpm-form-builder in file standalone/configuration/standalone.xml</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#c_Add_usersroles_to_jbpmformbuilderwarWEBINFclasses">c. Add users/roles to jbpm-form-builder.war/WEB-INF/classes</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#d_Deploy_formbuilder_and_verify_like_we_already_did_with_designer">d. Deploy form-builder and verify like we already did with designer</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#e_Verify_that_you_have">e. Verify that you have</a>
</li>
</ul></ul><li>
<a class="jive-link-anchor-small" href="#5_TaskService_or_Human_Task_deployment_with_verify">5. Task-Service or Human Task deployment (with verify).</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#Step_51Extract_a_clean_copy_of_jbossas702Finalzip_to_HUMAN_TASK_JBOSS">Step 5.1:Extract a clean copy of jboss-as-7.0.2.Final.zip to HUMAN_TASK_JBOSS</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Step_52_Copy_your_custom_build_humantask_">Step 5.2: Copy your custom build human-task </a>
</li>
<li>
<a class="jive-link-anchor-small" href="#Step_53_Jboss_standalonexml_configuration_">Step 5.3: Jboss standalone.xml configuration </a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#a_Remove_pojo_module">a. Remove pojo module</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#b_Change_port_for_management_interface">b. Change port for management interface.</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#c_Add_datasource_for_taskservice">c. Add datasource for task-service</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#d_Bind_to_HUMAN_TASK_IP_For_example">d. Bind to HUMAN_TASK_IP. For example</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#e_Set_offsetport">e. Set offset-port</a>
</li>
</ul><li>
<a class="jive-link-anchor-small" href="#Step_54_MySQL_driver_for_jboss">Step 5.4: MySQL driver for jboss</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#a_Create_MySQL_module_directory">a. Create MySQL module directory</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#bCopy_module_declaration_file">b.Copy module declaration file</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#c_Download_and_install_mysql_driver_to_jBoss">c. Download and install mysql driver to jBoss</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#d_Start_your_HUMAN_TASK_JBOSS_now">d. Start your HUMAN_TASK_JBOSS now</a>
</li>
</ul><li>
<a class="jive-link-anchor-small" href="#Step_54_jbpmhumantaskwar_configuration_TODO">Step 5.4: jbpm-human-task.war configuration (//TODO)</a>
</li>
<ul><li>
<a class="jive-link-anchor-small" href="#a_Update_HUMAN_TASK_JBOSS">a. Update HUMAN_TASK_JBOSS</a>
</li>
<li>
<a class="jive-link-anchor-small" href="#b_Place_a_copy_of_HUMAN_TASK_JBOSS">b. Place a copy of HUMAN_TASK_JBOSS</a>
</li>
</ul></ul><li>
<a class="jive-link-anchor-small" href="#6_jBPMConsole_deployment_with_verify">6. jBPM-Console deployment (with verify).</a>
</li>
</ul></ul></div></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>Disclaimer:</strong> First, Almost material in this article I borrowed form all over the public web. Some of most borrowed source are (in order):</p><ul><li>Extract from jbpm-install/build.xml Ant script.</li><li>jBPM official user-guide: <a class="jive-link-external-small" href="http://docs.jboss.org/jbpm/v5.3/userguide/">http://docs.jboss.org/jbpm/v5.3/userguide/</a></li><li>jBPM community user forum: <a class="" href="https://community.jboss.org/community/jbpm?view=discussions">https://community.jboss.org/en/jbpm?view=discussions</a></li><li>BPM Geek: <a class="jive-link-external-small" href="http://bpmgeek.com/blog/making-jbpm5-work-remote-host">http://bpmgeek.com/blog/making-jbpm5-work-remote-host</a></li></ul><p>Second, This article only provides a way of step by step manually deployment of each jBPM-5.3.0.Final components. It was written by a jBPM beginner. For a official document please refer to: <a class="jive-link-external-small" href="http://docs.jboss.org/jbpm/v5.3/userguide/">http://docs.jboss.org/jbpm/v5.3/userguide/</a></p><p>Third,this article example is in Linux. Mabe I will add ant scripts (again, heavily extracts from jbpm-install/build.xml) for faster deployment and Windows friendlier.</p><h2 id="1_Overview_of_jBPM" style="text-align: start;">1. Overview of jBPM</h2><h3 id="jBPM_Components">jBPM Components</h3><p>Download a copy of jbpm-5.3.0.Final-installer-full.zip (<a class="jive-link-external-small" href="http://sourceforge.net/projects/jbpm/files/jBPM%205/jbpm-5.3.0.Final/">http://sourceforge.net/projects/jbpm/files/jBPM%205/jbpm-5.3.0.Final/</a>) and extract it to a location, from now on we call it JBPM_INSTALL. JBPM_INSTALL contains all core jBPM components.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><table border="1" cellpadding="3" cellspacing="0" class="jiveBorder" style="width: 80%; border: 1px solid #000000;"><tbody><tr><th align="center" style="border:1px solid black;border: 1px solid #000000;background-color: #6690bc;" valign="middle"><span style="color: #ffffff;"><strong>Components<br/></strong></span></th><th align="center" style="border:1px solid black;border: 1px solid #000000;background-color: #6690bc;" valign="middle"><span style="color: #ffffff;"><strong>File in JBPM_INSTALL/lib</strong></span><br/></th><th align="center" style="border:1px solid black;border: 1px solid #000000;background-color: #6690bc;" valign="middle"><span style="color: #ffffff;"><strong>Description<br/></strong></span></th></tr><tr><td style="border:1px solid black;border: 1px solid #000000;">jbpm-runtime</td><td style="border:1px solid black;border: 1px solid #000000;">jbpm-5.3.0.Final-bin.zip</td><td style="border:1px solid black;border: 1px solid #000000;">jBPM Runtime, if you are willing to build a stand alone Java application you will need this.</td></tr><tr><td style="border:1px solid black;border: 1px solid #000000;">drools-guvnor</td><td style="border:1px solid black;border: 1px solid #000000;">guvnor-distribution-wars-5.4.0-20120516.war</td><td style="border:1px solid black;border: 1px solid #000000;">Drools-Guvnor provides process repository.</td></tr><tr><td style="border:1px solid black;border: 1px solid #000000;">designer</td><td style="border:1px solid black;border: 1px solid #000000;">designer-2.2.Final-jboss7.war</td><td style="border:1px solid black;border: 1px solid #000000;">JBPM2 process designer. It's integrated with drools-guvnor.</td></tr><tr><td style="border:1px solid black;border: 1px solid #000000;">form-builder</td><td style="border:1px solid black;border: 1px solid #000000;">jbpm-5.3.0.Final-form-builder.war</td><td style="border:1px solid black;border: 1px solid #000000;">Form builder. It's going to be integrated with the designer. <a class="jive-link-external-small" href="http://blog.athico.com/2012/07/jbpm-form-builder-state-of-art.html">http://blog.athico.com/2012/07/jbpm-form-builder-state-of-art.html</a></td></tr><tr><td style="border:1px solid black;border: 1px solid #000000;">gwt-console and gwt-console-server</td><td style="border:1px solid black;border: 1px solid #000000;">jbpm-5.3.0.Final-gwt-console.zip</td><td style="border:1px solid black;border: 1px solid #000000;"><br/></td></tr><tr><td style="border:1px solid black;border: 1px solid #000000;">human-task</td><td style="border:1px solid black;border: 1px solid #000000;">jbpm-5.3.0.Final-human-task-war.zip</td><td style="border:1px solid black;border: 1px solid #000000;"><br/></td></tr></tbody></table><p style="text-align: center;">Table 01: jBPM.5.3.0.Final components and their binary file</p><p><a href="https://community.jboss.org/servlet/JiveServlet/showImage/19247/jBPM+-+Internal+Components+Communication.png"><span> https://community.jboss.org/servlet/JiveServlet/downloadImage/19247/jBPM+-+Internal+Components+Communication.png </span></a></p><p style="text-align: center;">Figure 01: jBPM-Internal components communication</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>The communication between component as described in Figure-01, this article use MySQL. But by default, jbpm-install with "ant start.demo" will run with H2 database. From this communication view we can separate each component deployment. Event on each application server.</p><p><a href="https://community.jboss.org/servlet/JiveServlet/showImage/19248/jBPM+-+Eclipse+and+Reporting+Communication.png"><span> https://community.jboss.org/servlet/JiveServlet/downloadImage/19248/jBPM+-+Eclipse+and+Reporting+Communication.png </span></a></p><p style="text-align: center;">Figure 02: The communication with Eclipse IDE</p><h3 id="Separation_deployment">Separation deployment</h3><p style="text-align: start;">For a beginner, with all jBPM components are twisted together:</p><ul><li style="text-align: start;">It's hard to tell which message of what components. When something go wrong, which one to focus, which one to just ignore.</li><li style="text-align: start;">Need a way to check each component is up and running.</li><li style="text-align: start;">Just a way to learn and experience with jBPM.</li></ul><p>Purely from this experience and conclusion, this article will provides a manual installation of each jBPM-5.3.0.Final component.</p><h2 id="2_Common_bugs_fix_after_jBPM530Final_release">2. Common bugs fix after jBPM-5.3.0.Final release</h2><h3 id="Building_from_sourcecode">Building from source-code</h3><p>As a beginner I occasionally meet this kind of error {userId parameter, no result, must be positive, hornetq remote ..}. Some are must apply the fix before you can go on further. The commits after jBPM-5.3.0.Final does fix the bug but also introduces incompatible with other jBPM.5.3.0.Final. So this part will describes how to checkout Original jBPM-5.3.0.Final release source code; find the Fixed patch and apply to your local branch.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>For more detailed git document, please refer to other document. This article only using related git commands.</p><h4 id="a_Configure_your_git_username_and_email">a. Configure your git username and email</h4><pre class="jive-pre"><code class="jive-code"># For your local branche
git config --global user.name "Your Name"
git config --global user.email "your_email@addr.ess"
</code></pre><h4 id="b_Clone_jbpm_repository_from_githubcom">b. Clone jbpm repository from github.com</h4><pre class="jive-pre"><code class="jive-code"># We only need jbpm.git, because in version 5.3.0.Final all component on the same git repository.
git clone https://github.com/droolsjbpm/jbpm.git
# We have local git reposistory. We will call its directory path as jBPM_SRC
cd jbpm/
mvn clean install -U -Dfull -DskipTests
</code></pre><p>Optional: in "mvn clean install -U -Dfull -DskipTests" abover, We can add -nsu (no snapshot update) for faster build. Because we're only aware specific on 5.3.0.Final revision and its dependencies.</p><pre class="jive-pre"><code class="jive-code">mvn clean install -U -Dfull -DskipTests -nsu
</code></pre><p>This command really takes a while, especially for the first time and your empty maven local repository.</p><h4 id="c_Working_with_local_repository">c. Working with local repository</h4><p>The jbpm is a typical maven parent project with multiple module. Two of theme {human-task; gwt-console} are parent project too. From now on, you can use your favorite IDE with JavaEE profile to work with this checked out repository, showing diff and applying patch. Otherwise you can using git command as following example:</p><h5 id="List_all_jBPM_tags_">List all jBPM tags </h5><pre class="jive-pre"><code class="jive-code"># From your jBPM_SOURCE, show tags
git tag
</code></pre><p>The output will be something like this:</p><pre class="jive-pre"><code class="jive-code">5.0-CR1
5.0.0
5.1.0.CR1
5.1.0.Final
5.1.0.M1
5.1.1.Final
5.1.2.Final
5.2.0.Final
5.2.1.Final
5.2.2.Final
5.3.0.CR1
5.3.0.Final
</code></pre><h5 id="Switch_to_530Final_revision_tag">Switch to 5.3.0.Final revision tag.</h5><p>Chose your local branch name, for example: <span style="color: #ff6600;">update.after.5.3.0.final</span></p><pre class="jive-pre"><code class="jive-code">git checkout 5.3.0.Final  -b update.after.5.3.0.final
</code></pre><p>Result message</p><pre class="jive-pre"><code class="jive-code">Switched to a new branch 'update.after.5.3.0.final'
</code></pre><h5 id="View_prehistory_just_before_jBPM_team_released_jBPM530Final">View pre-history just before jBPM team released jBPM.5.3.0.Final</h5><pre class="jive-pre"><code class="jive-code">git log
</code></pre><p>Example output</p><pre class="jive-pre"><code class="jive-code">***@***:~/Tutorial/jbpm$ git log
commit d7640b9c0ba87d771862e8534cc607ca0f4d1aff
Author: Toni Rikkola <toni@rikkola.net>
Date:   Mon May 14 13:25:30 2012 +0300
    change to 5.4.0.Final version
commit 88440fe1430170458981c2752192df2c64c83636
Author: Maciej Swiderski <mswiders@redhat.com>
Date:   Wed May 9 19:22:35 2012 +0200
    BZ820210 - Could not initialize stateful knowledge session: loader constraint violation when using HornetQ task service strategy
commit 80f940e2e860ac640a75114ab2780f6c2b7a865c
Author: salaboy <salaboy@gmail.com>
Date:   Wed May 9 15:04:54 2012 +0100
    - mvel workaround
...
</code></pre><p>Build your own jBPM.5.3.0.Final for the first time</p><pre class="jive-pre"><code class="jive-code">mvn clean install -U -Dfull -DskipTests -nsu
</code></pre><p>Now you can working with your local git repository, update the 5.3.0.Final tag with the patch you need. All your commit will be stored on <span style="color: #ff6600;">update.after.5.3.0.final <span style="color: #000000;">branches.</span><br/></span></p><h3 id="Apply_bug_fix">Apply bug fix</h3><h4 id="Bug_Could_not_locate_named_parameter_userId">Bug: Could not locate named parameter [userId]</h4><p>Full message</p><pre class="jive-pre"><code class="jive-code">java.lang.IllegalArgumentException: org.hibernate.QueryParameterException: could not locate named parameter [userId]
</code></pre><p>Community thread:</p><p><a class="jive-link-message-small" href="https://community.jboss.org/message/738335#738335">https://community.jboss.org/message/738335#738335</a></p><p> <a class="jive-link-thread-small" href="https://community.jboss.org/thread/200361">https://community.jboss.org/thread/200361</a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Fix commit: 4a47527163854b233cdb9599f54c9320e945a372</p><h4 id="Bug_No_result_or_connection_timeout">Bug: No result, or connection timeout</h4><p>Message</p><pre class="jive-pre"><code class="jive-code">java.lang.RuntimeException: Timeout : unable to retrieve results
</code></pre><p>Treatment: With this particular deployment {separating components deployment, using MySQL} I haven't meet this error yet.</p><h4 id="Bug_Must_be_positive">Bug: Must be positive</h4><p>Full message: </p><pre class="jive-pre"><code class="jive-code">2011-07-18 18:46:35,546 [FATAL] Uncaught Exception:
java.lang.IllegalArgumentException:
must be positive
    at Unknown.cKb(Unknown source:0)
</code></pre><p>Fix: Not yet. (I think) this comes from GWT bug. GWT is the Google Web Toolkit that jBPM-Console are using. Just ignore it and continue with your work.</p><h4 id="Bug_HornetQ_binding_only_to_local_address">Bug: HornetQ binding only to local address.</h4><p>There aren't any configuration for Human-Task-War to bind on particular address. And by default it only listen on local address so Gwt-Console-Server cannot connect to it. Our separating deployment needs Gwt-Console-Server to connect to Human-Task, so apply the change-set below:</p><p>Bug track link: <a class="jive-link-external-small" href="https://issues.jboss.org/browse/JBPM-3720?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel">https://issues.jboss.org/browse/JBPM-3720?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel</a></p><p>Change set: <a class="jive-link-external-small" href="https://source.jboss.org/changelog/jBPM?cs=e115680b023ce0747608625f0cd61665cd09df40">https://source.jboss.org/changelog/jBPM?cs=e115680b023ce0747608625f0cd61665cd09df40</a></p><h2 id="3_Manual_jBPM_components_deployment">3. Manual jBPM components deployment</h2><h3 id="Environment">Environment</h3><h4 id="Check_your_JDK_installation">Check your JDK installation</h4><pre class="jive-pre"><code class="jive-code"># Check JAVA_HOME environment variable arcording to your operating system. In linux
echo $JAVA_HOME
# JDK Java version 1.6 or newer
java -version
</code></pre><h4 id="Check_apache_maven">Check apache maven</h4><p>Download and installation instruction: <a class="jive-link-external-small" href="http://maven.apache.org/download.html">http://maven.apache.org/download.html</a></p><pre class="jive-pre"><code class="jive-code"># Check M2 and  M2_HOME environment variables acording to your operating system. In linux
echo $M2
echo $M2_HOME
# Check Apache Maven installation
mvn -version
</code></pre><h4 id="Check_apache_ant">Check apache ant</h4><p>Download: <a class="jive-link-external-small" href="http://ant.apache.org/bindownload.cgi">http://ant.apache.org/bindownload.cgi</a> and manual: <a class="jive-link-external-small" href="http://ant.apache.org/manual/index.html">http://ant.apache.org/manual/index.html</a></p><pre class="jive-pre"><code class="jive-code"># Check ANT_HOME environment variables acording to  your operating system. In linux
echo $ANT_HOME
# And ANT_OPTS if it's nessessary. For example proxy configuration
echo $ANT_OPTS
-Dhttp.proxyHost=192.168.193.12 -Dhttp.proxyPort=3128
# Check Apache Ant installation
ant -version
</code></pre><h3 id="Deployment_parameters">Deployment parameters</h3><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><table border="1" cellpadding="3" cellspacing="0" class="jiveBorder" style="width: 100%; border: 1px solid #000000;"><tbody><tr><th style="border:1px solid black;border: 1px solid #000000;font-family: arial,helvetica,sans-serif;padding: 3px;text-align: -moz-center;color: #333333;background-color: #6690bc;" valign="middle"><span style="color: #ffffff;"><strong>Name<br/></strong></span></th><th style="border:1px solid black;border: 1px solid #000000;font-family: arial,helvetica,sans-serif;padding: 3px;text-align: -moz-center;color: #333333;background-color: #6690bc;" valign="middle"><span style="color: #ffffff;"><strong>Variables<br/></strong></span></th><th style="border:1px solid black;border: 1px solid #000000;font-family: arial,helvetica,sans-serif;padding: 3px;text-align: -moz-center;color: #333333;background-color: #6690bc;" valign="middle"><span style="color: #ffffff;"><strong>Example values</strong></span></th></tr><tr><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;">Jbpm-install</td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;">JBPM_INSTALL</td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;">/opt/download/jbpm-install</td></tr><tr><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;">MySQL username/password and schema</td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;"><p>MySQL_JBPM</p><p>MySQL_TASK</p></td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;"><p>jbpm,jbpmpassword and schema name is jbpm</p><p>task,taskpassword and schema name is task</p></td></tr><tr><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;">MySQL server IP/PORT</td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;">MySQL_IP:MySQL_PORT</td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;">192.168.140.39:3306</td></tr><tr><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;">Group-01 components: {Drool-guvnor, Designer, Form-Builder}</td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;"><p>GUVNOR_JBOSS</p><p>GUVNOR_IP</p><p>GUVNOR_HTTP_PORT</p><p>GUVNOR_MANAGEMENT_PORT</p></td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;"><p>/opt/guvnor_jboss</p><p>192.168.140.39</p><p>8080</p><p>9999 and 9990</p></td></tr><tr><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;">Group-02: Human-task</td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;"><p>HUMAN_TASK_JBOSS</p><p>HUMAN_TASK_IP</p><p>HUMAN_TASK_HTTP_PORT</p><p>HUMAN_TASK_MANAGEMENT_PORT</p><p>HUMAN_TASK_PORT-OFFSET</p></td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;"><p>/opt/human_task_jboss</p><p>192.168.140.39</p><p>8180</p><p>10099 and 10090</p><p><span style="color: #ff6600;">port-offset="100"</span></p></td></tr><tr><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;">Group-03: Gwt-Console and Gwt-Console-Server</td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;"><p>CONSOLE_JBOSS</p><p>CONSOLE_IP</p><p>CONSOLE_HTTP_PORT</p><p>CONSOLE_MANAGEMENT_POR</p><p>CONSOLE_PORT_OFFSET</p></td><td style="border:1px solid black;border: 1px solid #000000;background-color: transparent;padding: 3px;text-align: left;color: #000000;"><p>/opt/console_jboss</p><p>192.168.140.39</p><p>8280</p><p>10199 and 10190</p><p><span style="color: #ff6600;">port-offset="200"</span></p></td></tr></tbody></table><p style="text-align: center;">Table 02 - Deployment parameters</p><p>The "example value column" in Table 02 are values from a real deployment with all jboss instances running  on the same machine. <a class="jive-link-wiki-small" href="https://community.jboss.org/docs/DOC-16705">https://community.jboss.org/wiki/MultipleInstancesOfJBossAS7OnTheSameMachine</a> (Approach#1)</p><h3 id="MySQL_database_deployment_just_verify">MySQL database deployment (just verify).</h3><p>Verify that you can connect and login to MySQL:</p><pre class="jive-pre"><code class="jive-code"># From server HUMAN_TASK_IP to MySQL_IP:MySQL_PORT
mysql -h MySQL_IP -P MySQL_Port  -u MySQL_TASK -pMySQL_TASK_PASSWORD
# From server JBPM_IP to MYSQL_IP:MySQL_PORT
mysql -h MySQL_IP -P MySQL_Port  -u MySQL_JBPM -pMySQL_JBPM_PASSWORD
# Note: -P (capitalized) for port; and -p (lowercase) for password.
# No space between -p and MySQL_TASK_PASSWORD. For example:
#   mysql -h 192.168.140.39 -P 3306 -u task -ptaskpassword
#   mysql -h 192.168.140.39 -P 3306 -u jbpm -pjbpmpassword
</code></pre><p>After this, We can just forget about firewall, network routing, MySQL permission issues incase our persistence not work. For MySQL related document <a class="jive-link-external-small" href="http://dev.mysql.com/doc/refman/5.0/en/connecting.html">http://dev.mysql.com/doc/refman/5.0/en/connecting.html</a></p><h2 id="4_Drools_guvnor_designer_and_formbuilder_deployment_with_verify">4. Drools guvnor, designer, and form-builder deployment (with verify)</h2><p>Login to server on GUVNOR_IP and place a copy of jbpm-install and start the installation:</p><h3 id="Step_41Extract_a_clean_copy_of_jbossas702Finalzip_to_GUVNOR_JBOSS">Step 4.1:Extract a clean copy of jboss-as-7.0.2.Final.zip to GUVNOR_JBOSS</h3><pre class="jive-pre"><code class="jive-code"># Set our GUVNOR_JBOSS to this example path
export GUVNOR_JBOSS=/opt/guvnor_jboss
echo $GUVNOR_JBOSS
# Go to JBPM_INSTALL directory
cd /opt/download/
unzip jbpm-5.3.0.Final-installer-full.zip
cd /opt/download/jbpm-installer
# Extract a clean copy of jboss application server. To move to /opt we need root permission.
unzip lib/jboss-as-7.0.2.Final.zip
sudo mv jboss-as-7.0.2.Final $GUVNOR_JBOSS
# Copy guvnor, designer, form-builder
cp lib/guvnor-distribution-wars-5.4.0-20120516.war $GUVNOR_JBOSS/drools-guvnor.war
cp lib/designer-2.2.Final-jboss7.war $GUVNOR_JBOSS/designer.war
cp lib/jbpm-5.3.0.Final-form-builder.war $GUVNOR_JBOSS/jbpm-form-builder.war
# And their configurations file
cp conf/guvnor.preferences.properties $GUVNOR_JBOSS/preferences.properties
cp auth/users.properties $GUVNOR_JBOSS/
cp auth/roles.properties $GUVNOR_JBOSS/
cd $GUVNOR_JBOSS
</code></pre><h3 id="Step_42_Jboss_configuration">Step 4.2: Jboss configuration.</h3><pre class="jive-pre"><code class="jive-code jive-xml"># Change GUVNOR_JBOSS/standalone/configuration/standalone.xml to bind to GUVNOR_IP. For example
<span class="jive-xml-tag"><interfaces></span>
     <span class="jive-xml-tag"><interface name="management"></span>
          <span class="jive-xml-tag"><inet-address value="${jboss.bind.address.management:192.168.140.39}"/></span>
     <span class="jive-xml-tag"></interface></span>
     <span class="jive-xml-tag"><interface name="public"></span>
          <span class="jive-xml-tag"><inet-address value="${jboss.bind.address:192.168.140.39}"/></span>
     <span class="jive-xml-tag"></interface></span>
<span class="jive-xml-tag"></interfaces></span>
</code></pre><h3 id="Step_43_droolsguvnor_configuration">Step 4.3: drools-guvnor configuration</h3><h4 id="a_Update_GUVNOR_JBOSSpreferencesproperties_to_our_will_be_deployed_designer_and_formbuilder">a. Update GUVNOR_JBOSS/preferences.properties to our will be deployed designer and form-builder</h4><pre class="jive-pre"><code class="jive-code">...
#Designer configuration
designer.url=http://192.168.140.39:8080
#Do not change this unless you know what are you doing
designer.context=designer
designer.profile=jbpm
#FormBuilder configuration
#Do not change this unless you know what are you doing
formbuilder.url=http://192.168.140.39:8080
formbuilder.context=jbpm-form-builder
formbuilder.profile=guvnor
</code></pre><h4 id="b_Place_a_copy_of_GUVNOR_JBOSSpreferencesproperties_to_droolsguvnorwartargetWEBINFclassespreferencesproperties">b. Place a copy of GUVNOR_JBOSS/preferences.properties to drools-guvnor.war/target/WEB-INF/classes/preferences.properties</h4><p># User your favorist archive manager.</p><p>Using "Open with Archive Manager" in  Ubuntu Linux</p><h3 id="Step_44_Deploy_and_verify_droolsguvnor_component_installation">Step 4.4: Deploy and verify drools-guvnor component installation</h3><h4 id="a_Deploy_droolsguvnor">a. Deploy drools-guvnor</h4><pre class="jive-pre"><code class="jive-code"># Set our GUVNOR_JBOSS to this example path
export GUVNOR_JBOSS=/opt/guvnor_jboss
cd $GUVNOR_JBOSS
# Deploy drools-guvnor
cp drools-guvnor.war standalone/deployments/
# Verify drools-guvnor by start GUVNOR_JBOSS
bin/standalone.sh
</code></pre><h4 id="b_Verify_that_we_have_the_following_message_in_the_console">b. Verify that we have the following message in the console</h4><pre class="jive-pre"><code class="jive-code">...
11:55:46,779 INFO  [org.jboss.web] (MSC service thread 1-2) registering web context: /drools-guvnor
11:55:46,844 INFO  [org.jboss.as.server.controller] (DeploymentScanner-threads - 2) Deployed "drools-guvnor.war
</code></pre><h4 id="c_Verify_that_we_can_access_the_droolsguvnor">c. Verify that we can access the drools-guvnor</h4><p><span>Access the </span><a class="jive-link-external-small" href="http://GUVNOR_IP:8080/drools-guvnor" target="_blank">http://GUVNOR_IP:8080/drools-guvnor</a><span> (In our example is </span><a class="jive-link-external-small" href="http://192.168.140.39:8080" target="_blank">http://192.168.140.39:8080/drools-guvnor</a>) with the <span style="color: #000000;">browser from <span style="color: #ff6600;">GUVNOR_IP</span> and <span style="color: #ff6600;">CONSOLE_IP</span></span></p><h3 id="Step_45_Deploy_designer">Step 4.5: Deploy designer</h3><h4 id="a_Apply_the_change_for_Designer_as_following_article_httpbpmgeekcomblogmakingjbpm5workremotehost_">a. Apply the change for Designer as following article http://bpmgeek.com/blog/making-jbpm5-work-remote-host </h4><p>Section#Saving and reloading process in designer could cause failures</p><p><externalloadurl protocol="http" host="<span style="color: #ff6600;">GUVNOR_IP</span>:8080" subdomain="drools-guvnor/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="admin"/></p><p>In our example</p><pre class="jive-pre"><code class="jive-code jive-xml"><span class="jive-xml-tag"><externalloadurl protocol="http" host="192.168.140.39:8080" subdomain="drools-guvnor/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="admin"/></span>
</code></pre><h4 id="b_Deploy_designer">b. Deploy designer</h4><p>Simple by copy to jboss deployment directory, or with our example in Linux</p><pre class="jive-pre"><code class="jive-code"># Set our GUVNOR_JBOSS to this example path
export GUVNOR_JBOSS=/opt/guvnor_jboss
cd $GUVNOR_JBOSS
# Deploy designer
cp designer.war standalone/deployments/
</code></pre><h4 id="c_Verify_designer">c. Verify designer</h4><p>Start jboss and verify that we have something like this</p><pre class="jive-pre"><code class="jive-code">09:47:56,841 INFO  [org.jboss.as.server.controller] (DeploymentScanner-threads - 2) Deployed "designer.war"
09:47:56,841 INFO  [org.jboss.as.server.controller] (DeploymentScanner-threads - 2) Deployed "drools-guvnor.war"
</code></pre><p><a href="https://community.jboss.org/servlet/JiveServlet/showImage/19266/Screenshot.png"><span> https://community.jboss.org/servlet/JiveServlet/downloadImage/19266/Screenshot.png </span></a></p><p style="text-align: center;">Figure 02: Verify designer installation</p><p><span>User your browser to connect to </span><a class="jive-link-external-small" href="http://GUVNOR_IP:8080/drools-guvnor" target="_blank">http://GUVNOR_IP:8080/drools-guvnor</a><span> (or </span><a class="jive-link-external-small" href="http://192.168.140.39:8080/drools-guvnor" target="_blank">http://192.168.140.39:8080/drools-guvnor</a><span> in our example), on Left side bar, select "Knowledge Base" \ "Packages" , then select "Create New" \ "New BPMN2 Process" as Figure 02 above, note that if you can create/edit and save your process.</span></p><h3 id="Step_46_Deploy_formbuilder">Step 4.6: Deploy form-builder</h3><h4 id="a_Add_usersroles_configuration_to_GUVNOR_JBOSS">a. Add users/roles configuration to GUVNOR_JBOSS</h4><pre class="jive-pre"><code class="jive-code"># Set our GUVNOR_JBOSS to this example path
export GUVNOR_JBOSS=/opt/guvnor_jboss
cd $GUVNOR_JBOSS
cp users.properties standalone/configuration/
cp roles.properties standalone/configuration/
</code></pre><h4 id="b_Add_security_domain_for_jbpmformbuilder_in_file_standaloneconfigurationstandalonexml">b. Add security domain for jbpm-form-builder in file standalone/configuration/standalone.xml</h4><pre class="jive-pre"><code class="jive-code jive-xml"><span class="jive-xml-tag"><subsystem xmlns="urn:jboss:domain:security:1.0"></span>
   <span class="jive-xml-tag"><security-domains></span>
..
      <span class="jive-xml-tag"><security-domain name="jbpm-form-builder" cache-type="default"></span>
              <span class="jive-xml-tag"><authentication></span>
                  <span class="jive-xml-tag"><login-module code="UsersRoles" flag="required"></span>
                      <span class="jive-xml-tag"><module-option name="usersProperties" value="${jboss.server.config.dir}/users.properties"/></span>
                      <span class="jive-xml-tag"><module-option name="rolesProperties" value="${jboss.server.config.dir}/roles.properties"/></span>
                  <span class="jive-xml-tag"></login-module></span>
              <span class="jive-xml-tag"></authentication></span>
      <span class="jive-xml-tag"></security-domain></span>
..
   <span class="jive-xml-tag"></security-domains></span>
<span class="jive-xml-tag"></subsystem></span>
</code></pre><h4 id="c_Add_usersroles_to_jbpmformbuilderwarWEBINFclasses">c. Add users/roles to jbpm-form-builder.war/WEB-INF/classes</h4><p>Using your current Archive Manager to add users.properties and roles.properties to jbpm-form-builder.war/WEB-INF/classes</p><h4 id="d_Deploy_formbuilder_and_verify_like_we_already_did_with_designer">d. Deploy form-builder and verify like we already did with designer</h4><pre class="jive-pre"><code class="jive-code">cp jbpm-form-builder.war standalone/deployments/
# Start GUVNOR_JBOSS
bin/standalone.sh
</code></pre><h4 id="e_Verify_that_you_have">e. Verify that you have</h4><pre class="jive-pre"><code class="jive-code">10:36:52,907 INFO  [org.jboss.as.server.controller] (DeploymentScanner-threads - 2) Deployed "drools-guvnor.war"
</code></pre><p><span>And use your browser to verify that </span><a class="jive-link-external-small" href="http://GUVNOR_IP:8080/jbpm-form-builder" target="_blank">http://GUVNOR_IP:8080/jbpm-form-builder</a><span> (</span><a class="jive-link-external-small" href="http://192.168.140.39:8080/jbpm-form-builder" target="_blank">http://192.168.140.39:8080/jbpm-form-builder</a><span>) works.</span></p><h2 id="5_TaskService_or_Human_Task_deployment_with_verify">5. Task-Service or Human Task deployment (with verify).</h2><p>Login to server on HUMAN_TASK_IP and place a copy of jbpm-install and start the installation:</p><h3 id="Step_51Extract_a_clean_copy_of_jbossas702Finalzip_to_HUMAN_TASK_JBOSS">Step 5.1:Extract a clean copy of jboss-as-7.0.2.Final.zip to HUMAN_TASK_JBOSS</h3><pre class="jive-pre"><code class="jive-code"># Set our HUMAN_TASK_JBOSS to this example path
export HUMAN_TASK_JBOSS=/opt/human_task_jboss
echo $HUMAN_TASK_JBOSS
# Go to JBPM_INSTALL directory
cd /opt/download/
unzip jbpm-5.3.0.Final-installer-full.zip
cd /opt/download/jbpm-installer
# Extract a clean copy of jboss application server. To move to /opt we need root permission.
unzip lib/jboss-as-7.0.2.Final.zip
sudo mv jboss-as-7.0.2.Final $HUMAN_TASK_JBOSS
# And jbpm transactin manager library
cp jbpm-tm.jar $HUMAN_TASK_JBOSS/
# MySQL module configuration
cp db/driver_jar_module.xml $HUMAN_TASK_JBOSS/module.xml
cd $HUMAN_TASK_JBOSS
</code></pre><h3 id="Step_52_Copy_your_custom_build_humantask_">Step 5.2: Copy your custom build human-task </h3><p>From JBPM_SOURCE/jbpm-human-task/jbpm-human-task-war/target </p><p>To $HUMAN_TASK_JBOSS/jbpm-human-task-war.war</p><h3 id="Step_53_Jboss_standalonexml_configuration_">Step 5.3: Jboss standalone.xml configuration </h3><p>Change HUMAN_TASK_JBOSS/standalone/configuration/<span style="color: #ff6600; font-size: 14pt;">standalone.xml</span> as following</p><h4 id="a_Remove_pojo_module">a. Remove pojo module</h4><pre ___default_attr="xml" class="jive_text_macro jive_macro_code"><p><extension module="org.jboss.as.osgi"/></p><p><!-- Remove this line extension module="org.jboss.as.pojo"/--></p><p><extension module="org.jboss.as.remoting"/></p></pre><h4 id="b_Change_port_for_management_interface">b. Change port for management interface.</h4><pre ___default_attr="xml" class="jive_text_macro jive_macro_code"><p><management-interfaces></p><p>    <native-interface interface="management" port="10099" /></p><p>    <http-interface interface="management" port="10090"/></p><p></management-interfaces></p></pre><h4 id="c_Add_datasource_for_taskservice">c. Add datasource for task-service</h4><pre ___default_attr="xml" class="jive_text_macro jive_macro_code"><p><subsystem xmlns="urn:jboss:domain:datasources:1.0"></p><p>    <datasources></p><p>        <datasource jndi-name="java:jboss/datasources/taskDS" pool-name="MysqlTaskDSPool" enabled="true" jta="true" use-java-context="true" use-ccm="true"></p><p>            <connection-url></p><p>                jdbc:mysql://192.168.140.39:3306/task</p><p>            </connection-url></p><p>            <driver></p><p>                mysql</p><p>            </driver></p><p>            <pool></p><p>                <prefill></p><p>                    false</p><p>                </prefill></p><p>                <use-strict-min></p><p>                    false</p><p>                </use-strict-min></p><p>                <flush-strategy></p><p>                    FailingConnectionOnly</p><p>                </flush-strategy></p><p>            </pool></p><p>            <security></p><p>                <user-name></p><p>                    task</p><p>                </user-name></p><p>                <password></p><p>                    taskpassword</p><p>                </password></p><p>            </security></p><p>        </datasource></p><p>        <drivers></p><p>            <driver name="mysql" module="com.mysql"></p><p>                <xa-datasource-class></p><p>                    com.mysql.jdbc.jdbc2.optional.MysqlXADataSource</p><p>                </xa-datasource-class></p><p>            </driver></p><p>        </drivers></p><p>    </datasources></p><p></subsystem></p></pre><h4 id="d_Bind_to_HUMAN_TASK_IP_For_example">d. Bind to HUMAN_TASK_IP. For example</h4><pre class="jive-pre"><code class="jive-code jive-xml"><span class="jive-xml-tag"><interfaces></span>
     <span class="jive-xml-tag"><interface name="management"></span>
          <span class="jive-xml-tag"><inet-address value="${jboss.bind.address.management:192.168.140.39}"/></span>
     <span class="jive-xml-tag"></interface></span>
     <span class="jive-xml-tag"><interface name="public"></span>
          <span class="jive-xml-tag"><inet-address value="${jboss.bind.address:192.168.140.39}"/></span>
     <span class="jive-xml-tag"></interface></span>
<span class="jive-xml-tag"></interfaces></span>
</code></pre><h4 id="e_Set_offsetport">e. Set offset-port</h4><p>For our example to running on the same server as in <a class="jive-link-wiki-small" href="https://community.jboss.org/docs/DOC-16705">https://community.jboss.org/wiki/MultipleInstancesOfJBossAS7OnTheSameMachine</a> (Approach#1)</p><pre class="jive-pre"><code class="jive-code jive-xml"><span class="jive-xml-tag"><socket-binding-group name="standard-sockets" default-interface="public" port-offset="100"></span>
</code></pre><h3 id="Step_54_MySQL_driver_for_jboss">Step 5.4: MySQL driver for jboss</h3><h4 id="a_Create_MySQL_module_directory">a. Create MySQL module directory</h4><p>mkdir /modules/com/mysql</p><p>mkdir /modules/com/mysql/main</p><h4 id="bCopy_module_declaration_file">b.Copy module declaration file</h4><p>cp module.xml /modules/com/mysql/main/</p><h4 id="c_Download_and_install_mysql_driver_to_jBoss">c. Download and install mysql driver to jBoss</h4><p><span>wget </span><a class="jive-link-external-small" href="https://repository.jboss.org/nexus/service/local/repositories/central/content/mysql/mysql-connector-java/5.1.18/mysql-connector-java-5.1.18.jar" target="_blank">https://repository.jboss.org/nexus/service/local/repositories/central/content/mysql/mysql-connector-java/5.1.18/mysql-connector-java-5.1.18.jar</a></p><p>cp mysql-connector-java-5.1.18.jar /modules/com/mysql/main/mysql-connector-java.jar</p><h4 id="d_Start_your_HUMAN_TASK_JBOSS_now">d. Start your HUMAN_TASK_JBOSS now</h4><pre class="jive-pre"><code class="jive-code jive-java">bin/standalone.sh
</code></pre><p>To verify your configuration</p><ul><li style="text-align: start;">Does it start Ok?</li><li style="text-align: start;">MySQL driver loaded?</li><li style="text-align: start;"><span>Can you see taskDS datasource on jBoss admin console at </span><a class="jive-link-external-small" href="http://HUMAN_TASK_IP:10099/" target="_blank">http://HUMAN_TASK_IP:10099/</a><span> ?</span></li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h3 id="Step_54_jbpmhumantaskwar_configuration_TODO">Step 5.4: jbpm-human-task.war configuration (//TODO)</h3><h4 id="a_Update_HUMAN_TASK_JBOSS">a. Update HUMAN_TASK_JBOSS</h4><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h4 id="b_Place_a_copy_of_HUMAN_TASK_JBOSS">b. Place a copy of HUMAN_TASK_JBOSS</h4><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><h2 id="6_jBPMConsole_deployment_with_verify">6. jBPM-Console deployment (with verify).</h2></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="https://community.jboss.org/docs/DOC-21179">going to Community</a></p>
<p style="margin: 0;">Create a new document in jBPM at <a href="https://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2034">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>