Re: [jboss-user] [jBPM] - jBPM-5.3.0.Final Manual Deployment Guide for Beginner
by quangtin3
quangtin3 [https://community.jboss.org/people/quangtin3] commented on the document
"jBPM-5.3.0.Final Manual Deployment Guide for Beginner"
To view all comments on this document, visit: https://community.jboss.org/docs/DOC-21179#comment-10531
--------------------------------------------------
Dear Mauricio Salatino,
Sorry, I don't know why and how I put a copy of entire article in a reply. I did try to empty it, but didn't work. Please help me to delete above reply and this one too.
Thanks,
- Quang.
--------------------------------------------------
13 years, 7 months
- 1
- 0
Re: [jboss-user] [jBPM] - jBPM-5.3.0.Final Manual Deployment Guide for Beginner
by quangtin3
quangtin3 [https://community.jboss.org/people/quangtin3] commented on the document
"jBPM-5.3.0.Final Manual Deployment Guide for Beginner"
To view all comments on this document, visit: https://community.jboss.org/docs/DOC-21179#comment-10530
--------------------------------------------------
Dear Mauricio Salatino,
Thank you for your kind word. I'm appriciated the greate work of jBPM Team as well as other project at jboss.org. This article mainly comes after our team faces a minor issues with jBPM.5.3.0.Final deployment. I thought it may be help if i put related things together. Most of the material comes from the jBPM's user-guide and other greate people. The worst part is mine.
Sincerely,
- Quang
--------------------------------------------------
13 years, 7 months
- 1
- 0
[jBPM] - jBPM-5.3.0.Final Manual Deployment Guide for Beginner
by quangtin3
quangtin3 [https://community.jboss.org/people/quangtin3] modified the document:
"jBPM-5.3.0.Final Manual Deployment Guide for Beginner"
To view the document, visit: https://community.jboss.org/docs/DOC-21179
--------------------------------------------------------------
**
#1_Overview_of_jBPM 1. Overview of jBPM
***
#jBPM_Components jBPM Components
***
#Separation_deployment Separation deployment
**
#2_Common_bugs_fix_after_jBPM530Final_release 2. Common bugs fix after jBPM-5.3.0.Final release
***
#Building_from_sourcecode Building from source-code
****
#a_Configure_your_git_username_and_email a. Configure your git username and email
****
#b_Clone_jbpm_repository_from_githubcom b. Clone jbpm repository from github.com
****
#c_Working_with_local_repository c. Working with local repository
*****
#List_all_jBPM_tags_ List all jBPM tags
*****
#Switch_to_530Final_revision_tag Switch to 5.3.0.Final revision tag.
*****
#View_prehistory_just_before_jBPM_team_released_jBPM530Final View pre-history just before jBPM team released jBPM.5.3.0.Final
***
#Apply_bug_fix Apply bug fix
****
#Bug_Could_not_locate_named_parameter_userId Bug: Could not locate named parameter [userId]
****
#Bug_No_result_or_connection_timeout Bug: No result, or connection timeout
****
#Bug_Must_be_positive Bug: Must be positive
****
#Bug_HornetQ_binding_only_to_local_address Bug: HornetQ binding only to local address.
**
#3_Manual_jBPM_components_deployment 3. Manual jBPM components deployment
***
#Environment Environment
****
#Check_your_JDK_installation Check your JDK installation
****
#Check_apache_maven Check apache maven
****
#Check_apache_ant Check apache ant
***
#Deployment_parameters Deployment parameters
***
#MySQL_database_deployment_just_verify MySQL database deployment (just verify).
**
#4_Drools_guvnor_designer_and_formbuilder_deployment_with_verify 4. Drools guvnor, designer, and form-builder deployment (with verify)
***
#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
***
#Step_42_Jboss_configuration Step 4.2: Jboss configuration.
***
#Step_43_droolsguvnor_configuration Step 4.3: drools-guvnor configuration
****
#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
****
#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
***
#Step_44_Deploy_and_verify_droolsguvnor_component_installation Step 4.4: Deploy and verify drools-guvnor component installation
****
#a_Deploy_droolsguvnor a. Deploy drools-guvnor
****
#b_Verify_that_we_have_the_following_message_in_the_console b. Verify that we have the following message in the console
****
#c_Verify_that_we_can_access_the_droolsguvnor c. Verify that we can access the drools-guvnor
***
#Step_45_Deploy_designer Step 4.5: Deploy designer
****
#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
****
#b_Deploy_designer b. Deploy designer
****
#c_Verify_designer c. Verify designer
***
#Step_46_Deploy_formbuilder Step 4.6: Deploy form-builder
****
#a_Add_usersroles_configuration_to_GUVNOR_JBOSS a. Add users/roles configuration to GUVNOR_JBOSS
****
#b_Add_security_domain_for_jbpmformbuilder_in_file_standaloneconfigurationstandalonexml b. Add security domain for jbpm-form-builder in file standalone/configuration/standalone.xml
****
#c_Add_usersroles_to_jbpmformbuilderwarWEBINFclasses c. Add users/roles to jbpm-form-builder.war/WEB-INF/classes
****
#d_Deploy_formbuilder_and_verify_like_we_already_did_with_designer d. Deploy form-builder and verify like we already did with designer
****
#e_Verify_that_you_have e. Verify that you have
**
#5_TaskService_or_Human_Task_deployment_with_verify 5. Task-Service or Human Task deployment (with verify).
***
#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
***
#Step_52_Copy_your_custom_build_humantask_ Step 5.2: Copy your custom build human-task
***
#Step_53_Jboss_standalonexml_configuration_ Step 5.3: Jboss standalone.xml configuration
****
#a_Remove_pojo_module a. Remove pojo module
****
#b_Change_port_for_management_interface b. Change port for management interface.
****
#c_Add_datasource_for_taskservice c. Add datasource for task-service
****
#d_Bind_to_HUMAN_TASK_IP_For_example d. Bind to HUMAN_TASK_IP. For example
****
#e_Set_offsetport e. Set offset-port
***
#Step_54_MySQL_driver_for_jboss Step 5.4: MySQL driver for jboss
****
#a_Create_MySQL_module_directory a. Create MySQL module directory
****
#bCopy_module_declaration_file b.Copy module declaration file
****
#c_Download_and_install_mysql_driver_to_jBoss c. Download and install mysql driver to jBoss
****
#d_Start_your_HUMAN_TASK_JBOSS_now d. Start your HUMAN_TASK_JBOSS now
***
#Step_54_jbpmhumantaskwar_configuration_TODO Step 5.4: jbpm-human-task.war configuration (//TODO)
****
#a_Update_HUMAN_TASK_JBOSS a. Update HUMAN_TASK_JBOSS
****
#b_Place_a_copy_of_HUMAN_TASK_JBOSS b. Place a copy of HUMAN_TASK_JBOSS
**
#6_jBPMConsole_deployment_with_verify 6. jBPM-Console deployment (with verify).
*Disclaimer:* First, Almost material in this article I borrowed form all over the public web. Some of most borrowed source are (in order):
* Extract from jbpm-install/build.xml Ant script.
* jBPM official user-guide: http://docs.jboss.org/jbpm/v5.3/userguide/ http://docs.jboss.org/jbpm/v5.3/userguide/
* jBPM community user forum: https://community.jboss.org/community/jbpm?view=discussions https://community.jboss.org/en/jbpm?view=discussions
* BPM Geek: http://bpmgeek.com/blog/making-jbpm5-work-remote-host http://bpmgeek.com/blog/making-jbpm5-work-remote-host
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: http://docs.jboss.org/jbpm/v5.3/userguide/ http://docs.jboss.org/jbpm/v5.3/userguide/
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.
h2. 1. Overview of jBPM
h3. jBPM Components
Download a copy of jbpm-5.3.0.Final-installer-full.zip ( 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/) and extract it to a location, from now on we call it JBPM_INSTALL. JBPM_INSTALL contains all core jBPM components.
|| *Components
* || *File in JBPM_INSTALL/lib*
|| *Description
* ||
| jbpm-runtime | jbpm-5.3.0.Final-bin.zip | jBPM Runtime, if you are willing to build a stand alone Java application you will need this. |
| drools-guvnor | guvnor-distribution-wars-5.4.0-20120516.war | Drools-Guvnor provides process repository. |
| designer | designer-2.2.Final-jboss7.war | JBPM2 process designer. It's integrated with drools-guvnor. |
| form-builder | jbpm-5.3.0.Final-form-builder.war | Form builder. It's going to be integrated with the designer. http://blog.athico.com/2012/07/jbpm-form-builder-state-of-art.html |
| gwt-console and gwt-console-server | jbpm-5.3.0.Final-gwt-console.zip |
|
| human-task | jbpm-5.3.0.Final-human-task-war.zip |
|
Table 01: jBPM.5.3.0.Final components and their binary file
https://community.jboss.org/servlet/JiveServlet/showImage/19247/jBPM+-+In... https://community.jboss.org/servlet/JiveServlet/downloadImage/19247/jBPM+...
Figure 01: jBPM-Internal components communication
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.
https://community.jboss.org/servlet/JiveServlet/showImage/19248/jBPM+-+Ec... https://community.jboss.org/servlet/JiveServlet/downloadImage/19248/jBPM+...
Figure 02: The communication with Eclipse IDE
h3. Separation deployment
For a beginner, with all jBPM components are twisted together:
* It's hard to tell which message of what components. When something go wrong, which one to focus, which one to just ignore.
* Need a way to check each component is up and running.
* Just a way to learn and experience with jBPM.
Purely from this experience and conclusion, this article will provides a manual installation of each jBPM-5.3.0.Final component.
h2. 2. Common bugs fix after jBPM-5.3.0.Final release
h3. Building from source-code
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.
For more detailed git document, please refer to other document. This article only using related git commands.
h4. a. Configure your git username and email
# For your local branche
git config --global user.name "Your Name"
git config --global user.email "your_email(a)addr.ess"
h4. b. Clone jbpm repository from github.com
# 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
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.
mvn clean install -U -Dfull -DskipTests -nsu
This command really takes a while, especially for the first time and your empty maven local repository.
h4. c. Working with local repository
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:
h5. List all jBPM tags
# From your jBPM_SOURCE, show tags
git tag
The output will be something like this:
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
h5. Switch to 5.3.0.Final revision tag.
Chose your local branch name, for example: update.after.5.3.0.final
git checkout 5.3.0.Final -b update.after.5.3.0.final
Result message
Switched to a new branch 'update.after.5.3.0.final'
h5. View pre-history just before jBPM team released jBPM.5.3.0.Final
git log
Example output
***@***:~/Tutorial/jbpm$ git log
commit d7640b9c0ba87d771862e8534cc607ca0f4d1aff
Author: Toni Rikkola <toni(a)rikkola.net>
Date: Mon May 14 13:25:30 2012 +0300
change to 5.4.0.Final version
commit 88440fe1430170458981c2752192df2c64c83636
Author: Maciej Swiderski <mswiders(a)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(a)gmail.com>
Date: Wed May 9 15:04:54 2012 +0100
- mvel workaround
...
Build your own jBPM.5.3.0.Final for the first time
mvn clean install -U -Dfull -DskipTests -nsu
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 update.after.5.3.0.final branches.
h3. Apply bug fix
h4. Bug: Could not locate named parameter [userId]
Full message
java.lang.IllegalArgumentException: org.hibernate.QueryParameterException: could not locate named parameter [userId]
Community thread:
https://community.jboss.org/message/738335#738335 https://community.jboss.org/message/738335#738335
https://community.jboss.org/thread/200361 https://community.jboss.org/thread/200361
Fix commit: 4a47527163854b233cdb9599f54c9320e945a372
h4. Bug: No result, or connection timeout
Message
java.lang.RuntimeException: Timeout : unable to retrieve results
Treatment: With this particular deployment {separating components deployment, using MySQL} I haven't meet this error yet.
h4. Bug: Must be positive
Full message:
2011-07-18 18:46:35,546 [FATAL] Uncaught Exception:
java.lang.IllegalArgumentException:
must be positive
at Unknown.cKb(Unknown source:0)
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.
h4. Bug: HornetQ binding only to local address.
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:
Bug track link: https://issues.jboss.org/browse/JBPM-3720?page=com.atlassian.jira.plugin.... https://issues.jboss.org/browse/JBPM-3720?page=com.atlassian.jira.plugin....
Change set: https://source.jboss.org/changelog/jBPM?cs=e115680b023ce0747608625f0cd616... https://source.jboss.org/changelog/jBPM?cs=e115680b023ce0747608625f0cd616...
h2. 3. Manual jBPM components deployment
h3. Environment
h4. Check your JDK installation
# Check JAVA_HOME environment variable arcording to your operating system. In linux
echo $JAVA_HOME
# JDK Java version 1.6 or newer
java -version
h4. Check apache maven
Download and installation instruction: http://maven.apache.org/download.html http://maven.apache.org/download.html
# 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
h4. Check apache ant
Download: http://ant.apache.org/bindownload.cgi http://ant.apache.org/bindownload.cgi and manual: http://ant.apache.org/manual/index.html http://ant.apache.org/manual/index.html
# 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
h3. Deployment parameters
|| *Name
* || *Variables
* || *Example values* ||
| Jbpm-install | JBPM_INSTALL | /opt/download/jbpm-install |
| MySQL username/password and schema | MySQL_JBPM
MySQL_TASK | jbpm,jbpmpassword and schema name is jbpm
task,taskpassword and schema name is task |
| MySQL server IP/PORT | MySQL_IP:MySQL_PORT | 192.168.140.39:3306 |
| Group-01 components: {Drool-guvnor, Designer, Form-Builder} | GUVNOR_JBOSS
GUVNOR_IP
GUVNOR_HTTP_PORT
GUVNOR_MANAGEMENT_PORT | /opt/guvnor_jboss
192.168.140.39
8080
9999 and 9990 |
| Group-02: Human-task | HUMAN_TASK_JBOSS
HUMAN_TASK_IP
HUMAN_TASK_HTTP_PORT
HUMAN_TASK_MANAGEMENT_PORT
HUMAN_TASK_PORT-OFFSET | /opt/human_task_jboss
192.168.140.39
8180
10099 and 10090
port-offset="100" |
| Group-03: Gwt-Console and Gwt-Console-Server | CONSOLE_JBOSS
CONSOLE_IP
CONSOLE_HTTP_PORT
CONSOLE_MANAGEMENT_POR
CONSOLE_PORT_OFFSET | /opt/console_jboss
192.168.140.39
8280
10199 and 10190
port-offset="200" |
Table 02 - Deployment parameters
The "example value column" in Table 02 are values from a real deployment with all jboss instances running on the same machine. https://community.jboss.org/docs/DOC-16705 https://community.jboss.org/wiki/MultipleInstancesOfJBossAS7OnTheSameMachine (Approach#1)
h3. MySQL database deployment (just verify).
Verify that you can connect and login to MySQL:
# 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
After this, We can just forget about firewall, network routing, MySQL permission issues incase our persistence not work. For MySQL related document http://dev.mysql.com/doc/refman/5.0/en/connecting.html http://dev.mysql.com/doc/refman/5.0/en/connecting.html
h2. 4. Drools guvnor, designer, and form-builder deployment (with verify)
Login to server on GUVNOR_IP and place a copy of jbpm-install and start the installation:
h3. Step 4.1:Extract a clean copy of jboss-as-7.0.2.Final.zip to GUVNOR_JBOSS
# 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
h3. Step 4.2: Jboss configuration.
# Change GUVNOR_JBOSS/standalone/configuration/standalone.xml to bind to GUVNOR_IP. For example
<interfaces>
<interface name="management">
<inet-address value="${jboss.bind.address.management:192.168.140.39}"/>
</interface>
<interface name="public">
<inet-address value="${jboss.bind.address:192.168.140.39}"/>
</interface>
</interfaces>
h3. Step 4.3: drools-guvnor configuration
h4. a. Update GUVNOR_JBOSS/preferences.properties to our will be deployed designer and form-builder
...
#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
h4. b. Place a copy of GUVNOR_JBOSS/preferences.properties to drools-guvnor.war/target/WEB-INF/classes/preferences.properties
# User your favorist archive manager.
Using "Open with Archive Manager" in Ubuntu Linux
h3. Step 4.4: Deploy and verify drools-guvnor component installation
h4. a. Deploy drools-guvnor
# 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
h4. b. Verify that we have the following message in the console
...
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
h4. c. Verify that we can access the drools-guvnor
Access the http://GUVNOR_IP:8080/drools-guvnor http://GUVNOR_IP:8080/drools-guvnor (In our example is http://192.168.140.39:8080 http://192.168.140.39:8080/drools-guvnor) with the browser from GUVNOR_IP and CONSOLE_IP
h3. Step 4.5: Deploy designer
h4. a. Apply the change for Designer as following article http://bpmgeek.com/blog/making-jbpm5-work-remote-host
Section#Saving and reloading process in designer could cause failures
<externalloadurl protocol="http" host="GUVNOR_IP:8080" subdomain="drools-guvnor/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="admin"/>
In our example
<externalloadurl protocol="http" host="192.168.140.39:8080" subdomain="drools-guvnor/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="admin"/>
h4. b. Deploy designer
Simple by copy to jboss deployment directory, or with our example in Linux
# Set our GUVNOR_JBOSS to this example path
export GUVNOR_JBOSS=/opt/guvnor_jboss
cd $GUVNOR_JBOSS
# Deploy designer
cp designer.war standalone/deployments/
h4. c. Verify designer
Start jboss and verify that we have something like this
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"
https://community.jboss.org/servlet/JiveServlet/showImage/19266/Screensho... https://community.jboss.org/servlet/JiveServlet/downloadImage/19266/Scree...
Figure 02: Verify designer installation
User your browser to connect to http://GUVNOR_IP:8080/drools-guvnor http://GUVNOR_IP:8080/drools-guvnor (or http://192.168.140.39:8080/drools-guvnor http://192.168.140.39:8080/drools-guvnor 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.
h3. Step 4.6: Deploy form-builder
h4. a. Add users/roles configuration to GUVNOR_JBOSS
# 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/
h4. b. Add security domain for jbpm-form-builder in file standalone/configuration/standalone.xml
<subsystem xmlns="urn:jboss:domain:security:1.0">
<security-domains>
..
<security-domain name="jbpm-form-builder" cache-type="default">
<authentication>
<login-module code="UsersRoles" flag="required">
<module-option name="usersProperties" value="${jboss.server.config.dir}/users.properties"/>
<module-option name="rolesProperties" value="${jboss.server.config.dir}/roles.properties"/>
</login-module>
</authentication>
</security-domain>
..
</security-domains>
</subsystem>
h4. c. Add users/roles to jbpm-form-builder.war/WEB-INF/classes
Using your current Archive Manager to add users.properties and roles.properties to jbpm-form-builder.war/WEB-INF/classes
h4. d. Deploy form-builder and verify like we already did with designer
cp jbpm-form-builder.war standalone/deployments/
# Start GUVNOR_JBOSS
bin/standalone.sh
h4. e. Verify that you have
10:36:52,907 INFO [org.jboss.as.server.controller] (DeploymentScanner-threads - 2) Deployed "drools-guvnor.war"
And use your browser to verify that http://GUVNOR_IP:8080/jbpm-form-builder http://GUVNOR_IP:8080/jbpm-form-builder ( http://192.168.140.39:8080/jbpm-form-builder http://192.168.140.39:8080/jbpm-form-builder) works.
h2. 5. Task-Service or Human Task deployment (with verify).
Login to server on HUMAN_TASK_IP and place a copy of jbpm-install and start the installation:
h3. Step 5.1:Extract a clean copy of jboss-as-7.0.2.Final.zip to HUMAN_TASK_JBOSS
# 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
h3. Step 5.2: Copy your custom build human-task
>From JBPM_SOURCE/jbpm-human-task/jbpm-human-task-war/target
To $HUMAN_TASK_JBOSS/jbpm-human-task-war.war
h3. Step 5.3: Jboss standalone.xml configuration
Change HUMAN_TASK_JBOSS/standalone/configuration/standalone.xml as following
h4. a. Remove pojo module
<extension module="org.jboss.as.osgi"/>
<!-- Remove this line extension module="org.jboss.as.pojo"/-->
<extension module="org.jboss.as.remoting"/>
h4. b. Change port for management interface.
<management-interfaces>
<native-interface interface="management" port="10099" />
<http-interface interface="management" port="10090"/>
</management-interfaces>
h4. c. Add datasource for task-service
<subsystem xmlns="urn:jboss:domain:datasources:1.0">
<datasources>
<datasource jndi-name="java:jboss/datasources/taskDS" pool-name="MysqlTaskDSPool" enabled="true" jta="true" use-java-context="true" use-ccm="true">
<connection-url>
jdbc:mysql://192.168.140.39:3306/task
</connection-url>
<driver>
mysql
</driver>
<pool>
<prefill>
false
</prefill>
<use-strict-min>
false
</use-strict-min>
<flush-strategy>
FailingConnectionOnly
</flush-strategy>
</pool>
<security>
<user-name>
task
</user-name>
<password>
taskpassword
</password>
</security>
</datasource>
<drivers>
<driver name="mysql" module="com.mysql">
<xa-datasource-class>
com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
</xa-datasource-class>
</driver>
</drivers>
</datasources>
</subsystem>
h4. d. Bind to HUMAN_TASK_IP. For example
<interfaces>
<interface name="management">
<inet-address value="${jboss.bind.address.management:192.168.140.39}"/>
</interface>
<interface name="public">
<inet-address value="${jboss.bind.address:192.168.140.39}"/>
</interface>
</interfaces>
h4. e. Set offset-port
For our example to running on the same server as in https://community.jboss.org/docs/DOC-16705 https://community.jboss.org/wiki/MultipleInstancesOfJBossAS7OnTheSameMachine (Approach#1)
<socket-binding-group name="standard-sockets" default-interface="public" port-offset="100">
h3. Step 5.4: MySQL driver for jboss
h4. a. Create MySQL module directory
mkdir modules/com/mysql
mkdir modules/com/mysql/main
h4. b.Copy module declaration file
cp module.xml modules/com/mysql/main/
h4. c. Download and install mysql driver to jBoss
wget https://repository.jboss.org/nexus/service/local/repositories/central/con...
cp mysql-connector-java-5.1.18.jar modules/com/mysql/main/mysql-connector-java.jar
h4. d. Start your HUMAN_TASK_JBOSS now
bin/standalone.sh
To verify your configuration
* Does it start Ok?
* MySQL driver loaded?
* Can you see taskDS datasource on jBoss admin console at http://HUMAN_TASK_IP:10099/ http://HUMAN_TASK_IP:10099/ ?
h3. Step 5.4: jbpm-human-task.war configuration (//TODO)
h4. a. Update HUMAN_TASK_JBOSS
h4. b. Place a copy of HUMAN_TASK_JBOSS
h2. 6. jBPM-Console deployment (with verify).
--------------------------------------------------------------
Comment by going to Community
[https://community.jboss.org/docs/DOC-21179]
Create a new document in jBPM at Community
[https://community.jboss.org/choose-container!input.jspa?contentType=102&c...]
13 years, 7 months
- 1
- 0
Re: [jboss-user] [jBPM] - jBPM-5.3.0.Final Manual Deployment Guide for Beginner
by quangtin3
quangtin3 [https://community.jboss.org/people/quangtin3] commented on the document
"jBPM-5.3.0.Final Manual Deployment Guide for Beginner"
To view all comments on this document, visit: https://community.jboss.org/docs/DOC-21179#comment-10529
--------------------------------------------------
**
#1_Overview_of_jBPM 1. Overview of jBPM
***
#jBPM_Components jBPM Components
***
#Separation_deployment Separation deployment
**
#2_Common_bugs_fix_after_jBPM530Final_release 2. Common bugs fix after jBPM-5.3.0.Final release
***
#Building_from_sourcecode Building from source-code
****
#a_Configure_your_git_username_and_email a. Configure your git username and email
****
#b_Clone_jbpm_repository_from_githubcom b. Clone jbpm repository from github.com
****
#c_Working_with_local_repository c. Working with local repository
*****
#List_all_jBPM_tags_ List all jBPM tags
*****
#Switch_to_530Final_revision_tag Switch to 5.3.0.Final revision tag.
*****
#View_prehistory_just_before_jBPM_team_released_jBPM530Final View pre-history just before jBPM team released jBPM.5.3.0.Final
***
#Apply_bug_fix Apply bug fix
****
#Bug_Could_not_locate_named_parameter_userId Bug: Could not locate named parameter [userId]
****
#Bug_No_result_or_connection_timeout Bug: No result, or connection timeout
****
#Bug_Must_be_positive Bug: Must be positive
****
#Bug_HornetQ_binding_only_to_local_address Bug: HornetQ binding only to local address.
**
#3_Manual_jBPM_components_deployment 3. Manual jBPM components deployment
***
#Environment Environment
****
#Check_your_JDK_installation Check your JDK installation
****
#Check_apache_maven Check apache maven
****
#Check_apache_ant Check apache ant
***
#Deployment_parameters Deployment parameters
***
#MySQL_database_deployment_just_verify MySQL database deployment (just verify).
**
#4_Drools_guvnor_designer_and_formbuilder_deployment_with_verify 4. Drools guvnor, designer, and form-builder deployment (with verify)
***
#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
***
#Step_42_Jboss_configuration Step 4.2: Jboss configuration.
***
#Step_43_droolsguvnor_configuration Step 4.3: drools-guvnor configuration
****
#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
****
#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
***
#Step_44_Deploy_and_verify_droolsguvnor_component_installation Step 4.4: Deploy and verify drools-guvnor component installation
****
#a_Deploy_droolsguvnor a. Deploy drools-guvnor
****
#b_Verify_that_we_have_the_following_message_in_the_console b. Verify that we have the following message in the console
****
#c_Verify_that_we_can_access_the_droolsguvnor c. Verify that we can access the drools-guvnor
***
#Step_45_Deploy_designer Step 4.5: Deploy designer
****
#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
****
#b_Deploy_designer b. Deploy designer
****
#c_Verify_designer c. Verify designer
***
#Step_46_Deploy_formbuilder Step 4.6: Deploy form-builder
****
#a_Add_usersroles_configuration_to_GUVNOR_JBOSS a. Add users/roles configuration to GUVNOR_JBOSS
****
#b_Add_security_domain_for_jbpmformbuilder_in_file_standaloneconfigurationstandalonexml b. Add security domain for jbpm-form-builder in file standalone/configuration/standalone.xml
****
#c_Add_usersroles_to_jbpmformbuilderwarWEBINFclasses c. Add users/roles to jbpm-form-builder.war/WEB-INF/classes
****
#d_Deploy_formbuilder_and_verify_like_we_already_did_with_designer d. Deploy form-builder and verify like we already did with designer
****
#e_Verify_that_you_have e. Verify that you have
**
#5_TaskService_or_Human_Task_deployment_with_verify 5. Task-Service or Human Task deployment (with verify).
***
#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
***
#Step_52_Copy_your_custom_build_humantask_ Step 5.2: Copy your custom build human-task
***
#Step_53_Jboss_standalonexml_configuration_ Step 5.3: Jboss standalone.xml configuration
****
#a_Remove_pojo_module a. Remove pojo module
****
#b_Change_port_for_management_interface b. Change port for management interface.
****
#c_Add_datasource_for_taskservice c. Add datasource for task-service
****
#d_Bind_to_HUMAN_TASK_IP_For_example d. Bind to HUMAN_TASK_IP. For example
****
#e_Set_offsetport e. Set offset-port
***
#Step_54_MySQL_driver_for_jboss Step 5.4: MySQL driver for jboss
****
#a_Create_MySQL_module_directory a. Create MySQL module directory
****
#bCopy_module_declaration_file b.Copy module declaration file
****
#c_Download_and_install_mysql_driver_to_jBoss c. Download and install mysql driver to jBoss
****
#d_Start_your_HUMAN_TASK_JBOSS_now d. Start your HUMAN_TASK_JBOSS now
***
#Step_54_jbpmhumantaskwar_configuration_TODO Step 5.4: jbpm-human-task.war configuration (//TODO)
****
#a_Update_HUMAN_TASK_JBOSS a. Update HUMAN_TASK_JBOSS
****
#b_Place_a_copy_of_HUMAN_TASK_JBOSS b. Place a copy of HUMAN_TASK_JBOSS
**
#6_jBPMConsole_deployment_with_verify 6. jBPM-Console deployment (with verify).
*Disclaimer:* First, Almost material in this article I borrowed form all over the public web. Some of most borrowed source are (in order):
* Extract from jbpm-install/build.xml Ant script.
* jBPM official user-guide: http://docs.jboss.org/jbpm/v5.3/userguide/ http://docs.jboss.org/jbpm/v5.3/userguide/
* jBPM community user forum: https://community.jboss.org/community/jbpm?view=discussions https://community.jboss.org/en/jbpm?view=discussions
* BPM Geek: http://bpmgeek.com/blog/making-jbpm5-work-remote-host http://bpmgeek.com/blog/making-jbpm5-work-remote-host
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: http://docs.jboss.org/jbpm/v5.3/userguide/ http://docs.jboss.org/jbpm/v5.3/userguide/
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.
h2. 1. Overview of jBPM
h3. jBPM Components
Download a copy of jbpm-5.3.0.Final-installer-full.zip ( 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/) and extract it to a location, from now on we call it JBPM_INSTALL. JBPM_INSTALL contains all core jBPM components.
|| *Components
* || *File in JBPM_INSTALL/lib*
|| *Description
* ||
| jbpm-runtime | jbpm-5.3.0.Final-bin.zip | jBPM Runtime, if you are willing to build a stand alone Java application you will need this. |
| drools-guvnor | guvnor-distribution-wars-5.4.0-20120516.war | Drools-Guvnor provides process repository. |
| designer | designer-2.2.Final-jboss7.war | JBPM2 process designer. It's integrated with drools-guvnor. |
| form-builder | jbpm-5.3.0.Final-form-builder.war | Form builder. It's going to be integrated with the designer. http://blog.athico.com/2012/07/jbpm-form-builder-state-of-art.html |
| gwt-console and gwt-console-server | jbpm-5.3.0.Final-gwt-console.zip |
|
| human-task | jbpm-5.3.0.Final-human-task-war.zip |
|
Table 01: jBPM.5.3.0.Final components and their binary file
https://community.jboss.org/servlet/JiveServlet/showImage/19247/jBPM+-+In... https://community.jboss.org/servlet/JiveServlet/downloadImage/19247/jBPM+...
Figure 01: jBPM-Internal components communication
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.
https://community.jboss.org/servlet/JiveServlet/showImage/19248/jBPM+-+Ec... https://community.jboss.org/servlet/JiveServlet/downloadImage/19248/jBPM+...
Figure 02: The communication with Eclipse IDE
h3. Separation deployment
For a beginner, with all jBPM components are twisted together:
* It's hard to tell which message of what components. When something go wrong, which one to focus, which one to just ignore.
* Need a way to check each component is up and running.
* Just a way to learn and experience with jBPM.
Purely from this experience and conclusion, this article will provides a manual installation of each jBPM-5.3.0.Final component.
h2. 2. Common bugs fix after jBPM-5.3.0.Final release
h3. Building from source-code
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.
For more detailed git document, please refer to other document. This article only using related git commands.
h4. a. Configure your git username and email
# For your local branche
git config --global user.name "Your Name"
git config --global user.email "your_email(a)addr.ess"
h4. b. Clone jbpm repository from github.com
# 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
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.
mvn clean install -U -Dfull -DskipTests -nsu
This command really takes a while, especially for the first time and your empty maven local repository.
h4. c. Working with local repository
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:
h5. List all jBPM tags
# From your jBPM_SOURCE, show tags
git tag
The output will be something like this:
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
h5. Switch to 5.3.0.Final revision tag.
Chose your local branch name, for example: update.after.5.3.0.final
git checkout 5.3.0.Final -b update.after.5.3.0.final
Result message
Switched to a new branch 'update.after.5.3.0.final'
h5. View pre-history just before jBPM team released jBPM.5.3.0.Final
git log
Example output
***@***:~/Tutorial/jbpm$ git log
commit d7640b9c0ba87d771862e8534cc607ca0f4d1aff
Author: Toni Rikkola <toni(a)rikkola.net>
Date: Mon May 14 13:25:30 2012 +0300
change to 5.4.0.Final version
commit 88440fe1430170458981c2752192df2c64c83636
Author: Maciej Swiderski <mswiders(a)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(a)gmail.com>
Date: Wed May 9 15:04:54 2012 +0100
- mvel workaround
...
Build your own jBPM.5.3.0.Final for the first time
mvn clean install -U -Dfull -DskipTests -nsu
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 update.after.5.3.0.final branches.
h3. Apply bug fix
h4. Bug: Could not locate named parameter [userId]
Full message
java.lang.IllegalArgumentException: org.hibernate.QueryParameterException: could not locate named parameter [userId]
Community thread:
https://community.jboss.org/message/738335#738335 https://community.jboss.org/message/738335#738335
https://community.jboss.org/thread/200361 https://community.jboss.org/thread/200361
Fix commit: 4a47527163854b233cdb9599f54c9320e945a372
h4. Bug: No result, or connection timeout
Message
java.lang.RuntimeException: Timeout : unable to retrieve results
Treatment: With this particular deployment {separating components deployment, using MySQL} I haven't meet this error yet.
h4. Bug: Must be positive
Full message:
2011-07-18 18:46:35,546 [FATAL] Uncaught Exception:
java.lang.IllegalArgumentException:
must be positive
at Unknown.cKb(Unknown source:0)
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.
h4. Bug: HornetQ binding only to local address.
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:
Bug track link: https://issues.jboss.org/browse/JBPM-3720?page=com.atlassian.jira.plugin.... https://issues.jboss.org/browse/JBPM-3720?page=com.atlassian.jira.plugin....
Change set: https://source.jboss.org/changelog/jBPM?cs=e115680b023ce0747608625f0cd616... https://source.jboss.org/changelog/jBPM?cs=e115680b023ce0747608625f0cd616...
h2. 3. Manual jBPM components deployment
h3. Environment
h4. Check your JDK installation
# Check JAVA_HOME environment variable arcording to your operating system. In linux
echo $JAVA_HOME
# JDK Java version 1.6 or newer
java -version
h4. Check apache maven
Download and installation instruction: http://maven.apache.org/download.html http://maven.apache.org/download.html
# 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
h4. Check apache ant
Download: http://ant.apache.org/bindownload.cgi http://ant.apache.org/bindownload.cgi and manual: http://ant.apache.org/manual/index.html http://ant.apache.org/manual/index.html
# 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
h3. Deployment parameters
|| *Name
* || *Variables
* || *Example values* ||
| Jbpm-install | JBPM_INSTALL | /opt/download/jbpm-install |
| MySQL username/password and schema | MySQL_JBPM
MySQL_TASK | jbpm,jbpmpassword and schema name is jbpm
task,taskpassword and schema name is task |
| MySQL server IP/PORT | MySQL_IP:MySQL_PORT | 192.168.140.39:3306 |
| Group-01 components: {Drool-guvnor, Designer, Form-Builder} | GUVNOR_JBOSS
GUVNOR_IP
GUVNOR_HTTP_PORT
GUVNOR_MANAGEMENT_PORT | /opt/guvnor_jboss
192.168.140.39
8080
9999 and 9990 |
| Group-02: Human-task | HUMAN_TASK_JBOSS
HUMAN_TASK_IP
HUMAN_TASK_HTTP_PORT
HUMAN_TASK_MANAGEMENT_PORT
HUMAN_TASK_PORT-OFFSET | /opt/human_task_jboss
192.168.140.39
8180
10099 and 10090
port-offset="100" |
| Group-03: Gwt-Console and Gwt-Console-Server | CONSOLE_JBOSS
CONSOLE_IP
CONSOLE_HTTP_PORT
CONSOLE_MANAGEMENT_POR
CONSOLE_PORT_OFFSET | /opt/console_jboss
192.168.140.39
8280
10199 and 10190
port-offset="200" |
Table 02 - Deployment parameters
The "example value column" in Table 02 are values from a real deployment with all jboss instances running on the same machine. https://community.jboss.org/docs/DOC-16705 https://community.jboss.org/wiki/MultipleInstancesOfJBossAS7OnTheSameMachine (Approach#1)
h3. MySQL database deployment (just verify).
Verify that you can connect and login to MySQL:
# 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
After this, We can just forget about firewall, network routing, MySQL permission issues incase our persistence not work. For MySQL related document http://dev.mysql.com/doc/refman/5.0/en/connecting.html http://dev.mysql.com/doc/refman/5.0/en/connecting.html
h2. 4. Drools guvnor, designer, and form-builder deployment (with verify)
Login to server on GUVNOR_IP and place a copy of jbpm-install and start the installation:
h3. Step 4.1:Extract a clean copy of jboss-as-7.0.2.Final.zip to GUVNOR_JBOSS
# 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
h3. Step 4.2: Jboss configuration.
# Change GUVNOR_JBOSS/standalone/configuration/standalone.xml to bind to GUVNOR_IP. For example
<interfaces>
<interface name="management">
<inet-address value="${jboss.bind.address.management:192.168.140.39}"/>
</interface>
<interface name="public">
<inet-address value="${jboss.bind.address:192.168.140.39}"/>
</interface>
</interfaces>
h3. Step 4.3: drools-guvnor configuration
h4. a. Update GUVNOR_JBOSS/preferences.properties to our will be deployed designer and form-builder
...
#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
h4. b. Place a copy of GUVNOR_JBOSS/preferences.properties to drools-guvnor.war/target/WEB-INF/classes/preferences.properties
# User your favorist archive manager.
Using "Open with Archive Manager" in Ubuntu Linux
h3. Step 4.4: Deploy and verify drools-guvnor component installation
h4. a. Deploy drools-guvnor
# 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
h4. b. Verify that we have the following message in the console
...
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
h4. c. Verify that we can access the drools-guvnor
Access the http://GUVNOR_IP:8080/drools-guvnor http://GUVNOR_IP:8080/drools-guvnor (In our example is http://192.168.140.39:8080 http://192.168.140.39:8080/drools-guvnor) with the browser from GUVNOR_IP and CONSOLE_IP
h3. Step 4.5: Deploy designer
h4. a. Apply the change for Designer as following article http://bpmgeek.com/blog/making-jbpm5-work-remote-host
Section#Saving and reloading process in designer could cause failures
<externalloadurl protocol="http" host="GUVNOR_IP:8080" subdomain="drools-guvnor/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="admin"/>
In our example
<externalloadurl protocol="http" host="192.168.140.39:8080" subdomain="drools-guvnor/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="admin"/>
h4. b. Deploy designer
Simple by copy to jboss deployment directory, or with our example in Linux
# Set our GUVNOR_JBOSS to this example path
export GUVNOR_JBOSS=/opt/guvnor_jboss
cd $GUVNOR_JBOSS
# Deploy designer
cp designer.war standalone/deployments/
h4. c. Verify designer
Start jboss and verify that we have something like this
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"
https://community.jboss.org/servlet/JiveServlet/showImage/19266/Screensho... https://community.jboss.org/servlet/JiveServlet/downloadImage/19266/Scree...
Figure 02: Verify designer installation
User your browser to connect to http://GUVNOR_IP:8080/drools-guvnor http://GUVNOR_IP:8080/drools-guvnor (or http://192.168.140.39:8080/drools-guvnor http://192.168.140.39:8080/drools-guvnor 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.
h3. Step 4.6: Deploy form-builder
h4. a. Add users/roles configuration to GUVNOR_JBOSS
# 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/
h4. b. Add security domain for jbpm-form-builder in file standalone/configuration/standalone.xml
<subsystem xmlns="urn:jboss:domain:security:1.0">
<security-domains>
..
<security-domain name="jbpm-form-builder" cache-type="default">
<authentication>
<login-module code="UsersRoles" flag="required">
<module-option name="usersProperties" value="${jboss.server.config.dir}/users.properties"/>
<module-option name="rolesProperties" value="${jboss.server.config.dir}/roles.properties"/>
</login-module>
</authentication>
</security-domain>
..
</security-domains>
</subsystem>
h4. c. Add users/roles to jbpm-form-builder.war/WEB-INF/classes
Using your current Archive Manager to add users.properties and roles.properties to jbpm-form-builder.war/WEB-INF/classes
h4. d. Deploy form-builder and verify like we already did with designer
cp jbpm-form-builder.war standalone/deployments/
# Start GUVNOR_JBOSS
bin/standalone.sh
h4. e. Verify that you have
10:36:52,907 INFO [org.jboss.as.server.controller] (DeploymentScanner-threads - 2) Deployed "drools-guvnor.war"
And use your browser to verify that http://GUVNOR_IP:8080/jbpm-form-builder http://GUVNOR_IP:8080/jbpm-form-builder ( http://192.168.140.39:8080/jbpm-form-builder http://192.168.140.39:8080/jbpm-form-builder) works.
h2. 5. Task-Service or Human Task deployment (with verify).
Login to server on HUMAN_TASK_IP and place a copy of jbpm-install and start the installation:
h3. Step 5.1:Extract a clean copy of jboss-as-7.0.2.Final.zip to HUMAN_TASK_JBOSS
# 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
h3. Step 5.2: Copy your custom build human-task
>From JBPM_SOURCE/jbpm-human-task/jbpm-human-task-war/target
To $HUMAN_TASK_JBOSS/jbpm-human-task-war.war
h3. Step 5.3: Jboss standalone.xml configuration
Change HUMAN_TASK_JBOSS/standalone/configuration/standalone.xml as following
h4. a. Remove pojo module
<extension module="org.jboss.as.osgi"/>
<!-- Remove this line extension module="org.jboss.as.pojo"/-->
<extension module="org.jboss.as.remoting"/>
h4. b. Change port for management interface.
<management-interfaces>
<native-interface interface="management" port="10099" />
<http-interface interface="management" port="10090"/>
</management-interfaces>
h4. c. Add datasource for task-service
<subsystem xmlns="urn:jboss:domain:datasources:1.0">
<datasources>
<datasource jndi-name="java:jboss/datasources/taskDS" pool-name="MysqlTaskDSPool" enabled="true" jta="true" use-java-context="true" use-ccm="true">
<connection-url>
jdbc:mysql://192.168.140.39:3306/task
</connection-url>
<driver>
mysql
</driver>
<pool>
<prefill>
false
</prefill>
<use-strict-min>
false
</use-strict-min>
<flush-strategy>
FailingConnectionOnly
</flush-strategy>
</pool>
<security>
<user-name>
task
</user-name>
<password>
taskpassword
</password>
</security>
</datasource>
<drivers>
<driver name="mysql" module="com.mysql">
<xa-datasource-class>
com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
</xa-datasource-class>
</driver>
</drivers>
</datasources>
</subsystem>
h4. d. Bind to HUMAN_TASK_IP. For example
<interfaces>
<interface name="management">
<inet-address value="${jboss.bind.address.management:192.168.140.39}"/>
</interface>
<interface name="public">
<inet-address value="${jboss.bind.address:192.168.140.39}"/>
</interface>
</interfaces>
h4. e. Set offset-port
For our example to running on the same server as in https://community.jboss.org/docs/DOC-16705 https://community.jboss.org/wiki/MultipleInstancesOfJBossAS7OnTheSameMachine (Approach#1)
<socket-binding-group name="standard-sockets" default-interface="public" port-offset="100">
h3. Step 5.4: MySQL driver for jboss
h4. a. Create MySQL module directory
mkdir modules/com/mysql
mkdir modules/com/mysql/main
h4. b.Copy module declaration file
cp module.xml modules/com/mysql/main/
h4. c. Download and install mysql driver to jBoss
wget https://repository.jboss.org/nexus/service/local/repositories/central/con...
cp mysql-connector-java-5.1.18.jar modules/com/mysql/main/mysql-connector-java.jar
h4. d. Start your HUMAN_TASK_JBOSS now
bin/standalone.sh
To verify your configuration
* Does it start Ok?
* MySQL driver loaded?
* Can you see taskDS datasource on jBoss admin console at http://HUMAN_TASK_IP:10099/ http://HUMAN_TASK_IP:10099/ ?
h3. Step 5.4: jbpm-human-task.war configuration (//TODO)
h4. a. Update HUMAN_TASK_JBOSS
h4. b. Place a copy of HUMAN_TASK_JBOSS
h2. 6. jBPM-Console deployment (with verify).
--------------------------------------------------
13 years, 7 months
- 1
- 0
[Datasource Configuration] - Database driver problem
by Mallikharjuna Areti
Mallikharjuna Areti [https://community.jboss.org/people/malli002] created the discussion
"Database driver problem"
To view the discussion, visit: https://community.jboss.org/message/754138#754138
--------------------------------------------------------------
I am trying to configure few datasources in my environment and getting below driver problem.
i have tried with *ojdbc6.jar file and ojdbc14.jar* file in the classpath.
If i use ojdbc6.jar file i will get class not found exception like below with sealing violation ..etc where as if i use ojdbc14.jar file i will get class cast exception. Basically what i understood is it's driver mismatch or something but not able to identify where could be the problem. I have tried all the ways, from my side if anyone have any idea about this or any clue please suggest me. I can give you more clarity on the problem if required.
Few extra details :-
java version - 1.6.0.20
Jboss version - 5.1
+Caused by: java.lang.NoClassDefFoundError: oracle/jdbc/driver/OracleDriver+
+ at oracle.jdbc.pool.OracleDataSource.<init>(OracleDataSource.java:85)+
+ at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)+
+ at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:39)+
+ at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:27)+
+ at java.lang.reflect.Constructor.newInstance(Constructor.java:513)+
+ at java.lang.Class.newInstance0(Class.java:355)+
+ at java.lang.Class.newInstance(Class.java:308)+
+ at org.jboss.resource.adapter.jdbc.local.LocalManagedConnectionFactory.getDriver(LocalManagedConnectionFactory.java:481)+
+ at org.jboss.resource.adapter.jdbc.local.LocalManagedConnectionFactory.getLocalManagedConnection(LocalManagedConnectionFactory.java:206)+
+ ... 98 more+
*+Caused by: java.lang.ClassNotFoundException: Unexpected error during load of: oracle.jdbc.driver.OracleDriver, msg=Sealing violation for package oracle.jdbc.driver+*
+ at org.jboss.classloader.spi.base.ClassLoaderManager.process(ClassLoaderManager.java:181)+
+ at org.jboss.classloader.spi.base.BaseClassLoaderDomain.loadClass(BaseClassLoaderDomain.java:276)+
+ at org.jboss.classloader.spi.base.BaseClassLoaderDomain.loadClass(BaseClassLoaderDomain.java:1138)+
+ at org.jboss.classloader.spi.base.BaseClassLoader.loadClassFromDomain(BaseClassLoader.java:862)+
+ at org.jboss.classloader.spi.base.BaseClassLoader.doLoadClass(BaseClassLoader.java:502)+
+ at org.jboss.classloader.spi.base.BaseClassLoader.loadClass(BaseClassLoader.java:447)+
+ at java.lang.ClassLoader.loadClass(ClassLoader.java:248)+
+ ... 107 more+
Here is my one of DS.xml file
+<datasources>+
+ <local-tx-datasource>+
+ <jndi-name>jdbc/<JNDI NAME></jndi-name>+
+ <connection-url>jdbc:orcale:thin:@<servername>:<port>:<schema_name></connection-url>+
+ <driver-class>oracle.jdbc.pool.OracleDataSource</driver-class>+
+ <security-domain>DataSourceDBLogin</security-domain>+
+ <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>+
+ <metadata>+
+ <type-mapping>Oracle11g</type-mapping>+
+ </metadata>+
+ <min-pool-size>5</min-pool-size>+
+ <max-pool-size>20</max-pool-size>+
+ <idle-timeout-minutes>15</idle-timeout-minutes>+
+ </local-tx-datasource>+
+ </datasources>+
++
--------------------------------------------------------------
Reply to this message by going to Community
[https://community.jboss.org/message/754138#754138]
Start a new discussion in Datasource Configuration at Community
[https://community.jboss.org/choose-container!input.jspa?contentType=1&con...]
13 years, 7 months
- 3
- 9
[jBPM] - Re: Any help with Jbpm-Console problem please.
by wqe wqe
wqe wqe [https://community.jboss.org/people/drupalspring] created the discussion
"Re: Any help with Jbpm-Console problem please."
To view the discussion, visit: https://community.jboss.org/message/755022#755022
--------------------------------------------------------------
Fully agree your points that jbpm-install *SUCKS .*
** Second thing is that I think most new user will try to install the jbpm first and play with it following the steps of http://docs.jboss.org/jbpm/v5.3/userguide/ch.console.html official documtation . So it is better that the final version of jbpm in the future does not have any bugs when user try to follow the steps in the official documentation .Thanks for the hints how to solve the "could not locate named parameter [userId]" problem
--------------------------------------------------------------
Reply to this message by going to Community
[https://community.jboss.org/message/755022#755022]
Start a new discussion in jBPM at Community
[https://community.jboss.org/choose-container!input.jspa?contentType=1&con...]
13 years, 7 months
- 1
- 0
[jBPM] - jBPM
by Mauricio Salatino
Mauricio Salatino [https://community.jboss.org/people/salaboy21] modified the document:
"jBPM"
To view the document, visit: https://community.jboss.org/docs/DOC-11184
--------------------------------------------------------------
h3. About jBPM
jBPM is a platform for executable process languages ranging from business process management (BPM) over workflow to service orchestration.
h3. *jBPM5*
* https://community.jboss.org/docs/DOC-15172 jBPM 5.0 Request for Comments
* https://community.jboss.org/docs/DOC-15344 jBPM 5.0 Roadmap
* https://community.jboss.org/docs/DOC-16589 jBPM5 Eclipse BPMN 2.0 Editor
| h5. User documentation
** jBPM5 User Guide (https://hudson.jboss.org/hudson/job/jBPM5/lastSuccessfulBuild/artifact/ta...)
** jBPM5.3 Deployment Guide for Beginners (https://community.jboss.org/docs/DOC-21179)
h5. Report Issues & Feature Requests
** Feature Requests (https://issues.jboss.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=p...)
** Issues (https://issues.jboss.org/secure/IssueNavigator.jspa?reset=true&jqlQuery=p...)
h5. jBPM5 Blogs
** Kris Vaerlaen Blog: http://kverlaen.blogspot.com
** Blog Athico Drools and jBPM Blog: http://blog.athico.com
** Maciej Swiderski: http://mswiderski.blogspot.com
** Marco Rietveld : http://mriet.wordpress.com
** Tihomir Surdilovic: http://surdilovic.wordpress.com/
** Esteban Aliverti: http://ilesteban.wordpress.com
** Eric Schabell: http://www.schabell.org/search/label/jBPM
** Francesco Marchioni: http://www.mastertheboss.com/
** Demian Calcaprina: http://dcalca.wordpress.com/
** Salaboy Blog: http://salaboy.com
h5. Developer documentation
** WS-HT Specification 1.1 (http://docs.oasis-open.org/bpel4people/ws-humantask-1.1-spec-cs-01.pdf)
** OMG BPMN2 Specification (http://www.omg.org/spec/BPMN/2.0/)
** Developing Drools and jBPM (https://github.com/droolsjbpm/droolsjbpm-build-bootstrap/blob/master/READ...)
** jBPM 5 database testing (https://community.jboss.org/docs/DOC-17071)
h5. Other projects
** jBPM5 Migration Tool Project (https://community.jboss.org/docs/DOC-15974) | h5. jBPM5 Slides and Tutorials
** Roadmap (http://salaboy.wordpress.com/2011/01/24/announcing-jbpm5-community-training/)
** Module #0: Baby Steps Examples (http://salaboy.wordpress.com/2011/03/10/jbpm5-community-training-%E2%80%9...)
** Module #1: Basic Overview about jBPM5 (http://salaboy.wordpress.com/2011/01/29/jbpm5-community-training-module-1...)
** Module #2: The BPM Practice (http://http://salaboy.wordpress.com/2011/02/04/jbpm5-community-training-%...)
** Module #2.5: BPM For Developers (http://wp.me/pbXhi-qG)
** Module #3: BPMN 2.0 Specification (Delayed)
** Module #4: jBPM5 API Overview (http://salaboy.wordpress.com/2011/02/21/jbpm5-community-training-%E2%80%9...)
** Module #5: Domain Specific Processes (http://salaboy.wordpress.com/2011/03/09/jbpm5-community-training-%E2%80%9...)
** Example Source Code (https://github.com/Salaboy/Drools_jBPM5-Training-Examples) |
h3. PM General
* https://community.jboss.org/docs/DOC-11170 jBPM References
* https://community.jboss.org/docs/DOC-13217 jBPM Roadmap
* https://community.jboss.org/docs/DOC-13666 jBPM Console Priorities
* https://community.jboss.org/docs/DOC-13299 jBPM Student Projects
* https://community.jboss.org/docs/DOC-11166 jBPM Presentations
* https://community.jboss.org/docs/DOC-11147 jBPM Links
| h3. jBPM 4
| h3. jBPM 3
|
| h5. Developer Documentation
* jBPM4 IDE Setup (https://community.jboss.org/docs/DOC-13458)
* jBPM4 Build Engine From Source (https://community.jboss.org/docs/DOC-12867)
* jBPM4 Build Designer From Sources (https://community.jboss.org/docs/DOC-13343)
* jBPM4 Build Console From Sources (https://community.jboss.org/docs/DOC-12879)
* jBPM4 Maven Dependencies (https://community.jboss.org/docs/DOC-13328)
* jBPM4 QA (https://community.jboss.org/docs/DOC-13251)
* jBPM4 Release Procedure (https://community.jboss.org/docs/DOC-13360)
* jBPM4 Execution Modes (https://community.jboss.org/docs/DOC-13340)
* jBPM4 Use Cases (https://community.jboss.org/docs/DOC-13298)
* jBPM4 Improvements (https://community.jboss.org/docs/DOC-13670)
h5. Related topics
* jBPM and XForms (https://www.jboss.org/community/docs/DOC-13362)
* jBPM console (https://www.jboss.org/community/docs/DOC-12879) (GWT)
* Report server (BIRT) (https://www.jboss.org/community/docs/DOC-13191)
* JOPR integration (https://www.jboss.org/community/docs/DOC-13381)
h5. Interesting Links
* Scalability and performance of jBPM in a cluster (http://www.theserverside.com/tt/articles/article.tss?l=WorkflowEngineJBos...)
TSS article by Szymon Zeslawski
* Manage your business processes with jBPM (http://www.javaworld.com/javaworld/jw-05-2006/jw-0522-jbpm.html)
JavaWorld article by Jeff Hanson | h5. User Documentation
* jBPM3 Getting Started (https://community.jboss.org/docs/DOC-11142)
* jBPM3 GPD Installation (https://community.jboss.org/docs/DOC-12929)
* jBPM3 Feature List (https://community.jboss.org/docs/DOC-10124)
* jBPM3 FAQ (https://community.jboss.org/docs/DOC-11092)
* jBPM3 Web App on SOA-P (https://community.jboss.org/docs/DOC-16025)
* jBPM3 on Tomcat (https://community.jboss.org/docs/DOC-16106)
* jBPM3 and JMS (https://community.jboss.org/docs/DOC-10126)
* jBPM3 and Drools (https://community.jboss.org/docs/DOC-11096)
* jBPM3 Custom Tasks (https://community.jboss.org/docs/DOC-9478)
* jBPM3 Join Lock Mode (https://community.jboss.org/docs/DOC-13753)
* jBPM3 Text Columns (https://community.jboss.org/docs/DOC-16177)
h5. Database Setup
* DB2 (https://community.jboss.org/docs/DOC-13821)
* MySQL (https://community.jboss.org/docs/DOC-14445)
* Oracle (https://community.jboss.org/docs/DOC-14836)
* PostgreSQL (https://community.jboss.org/docs/DOC-13270)
* Sybase (https://community.jboss.org/docs/DOC-12932)
h5. Developer Documentation
* jBPM3 Platform Support (https://community.jboss.org/docs/DOC-13763)
* jBPM3 Design Documentation (https://community.jboss.org/docs/DOC-15934)
* jBPM3 Building From Source (https://community.jboss.org/docs/DOC-12863)
* jBPM3 Building the Installer (https://community.jboss.org/docs/DOC-12866)
* jBPM3 Eclipse Setup (https://community.jboss.org/docs/DOC-12862)
* jBPM3 Hudson Setup (https://community.jboss.org/docs/DOC-12865)
* jBPM3 Release Procedure (https://community.jboss.org/docs/DOC-13428) |
Looking for the https://community.jboss.org/docs/DOC-12853 jBPM Legacy Wiki?
--------------------------------------------------------------
Comment by going to Community
[https://community.jboss.org/docs/DOC-11184]
Create a new document in jBPM at Community
[https://community.jboss.org/choose-container!input.jspa?contentType=102&c...]
13 years, 7 months
- 1
- 0
Re: [jboss-user] [jBPM] - jBPM-5.3.0.Final Manual Deployment Guide for Beginner
by Mauricio Salatino
Mauricio Salatino [https://community.jboss.org/people/salaboy21] commented on the document
"jBPM-5.3.0.Final Manual Deployment Guide for Beginner"
To view all comments on this document, visit: https://community.jboss.org/docs/DOC-21179#comment-10528
--------------------------------------------------
Really nice! thanks for contributing this document back..
I will make sure to add this to the JBPM resoruces.
Cheers
--------------------------------------------------
13 years, 7 months
- 1
- 0
[jBPM] - jBPM-5.3.0.Final Manual Deployment Guide for Beginner
by quangtin3
quangtin3 [https://community.jboss.org/people/quangtin3] modified the document:
"jBPM-5.3.0.Final Manual Deployment Guide for Beginner"
To view the document, visit: https://community.jboss.org/docs/DOC-21179
--------------------------------------------------------------
**
#1_Overview_of_jBPM 1. Overview of jBPM
***
#jBPM_Components jBPM Components
***
#Separation_deployment Separation deployment
**
#2_Common_bugs_fix_after_jBPM530Final_release 2. Common bugs fix after jBPM-5.3.0.Final release
***
#Building_from_sourcecode Building from source-code
****
#a_Configure_your_git_username_and_email a. Configure your git username and email
****
#b_Clone_jbpm_repository_from_githubcom b. Clone jbpm repository from github.com
****
#c_Working_with_local_repository c. Working with local repository
*****
#List_all_jBPM_tags_ List all jBPM tags
*****
#Switch_to_530Final_revision_tag Switch to 5.3.0.Final revision tag.
*****
#View_prehistory_just_before_jBPM_team_released_jBPM530Final View pre-history just before jBPM team released jBPM.5.3.0.Final
***
#Apply_bug_fix Apply bug fix
****
#Bug_Could_not_locate_named_parameter_userId Bug: Could not locate named parameter [userId]
****
#Bug_No_result_or_connection_timeout Bug: No result, or connection timeout
****
#Bug_Must_be_positive Bug: Must be positive
****
#Bug_HornetQ_binding_only_to_local_address Bug: HornetQ binding only to local address.
**
#3_Manual_jBPM_components_deployment 3. Manual jBPM components deployment
***
#Environment Environment
****
#Check_your_JDK_installation Check your JDK installation
****
#Check_apache_maven Check apache maven
****
#Check_apache_ant Check apache ant
***
#Deployment_parameters Deployment parameters
***
#MySQL_database_deployment_just_verify MySQL database deployment (just verify).
**
#4_Drools_guvnor_designer_and_formbuilder_deployment_with_verify 4. Drools guvnor, designer, and form-builder deployment (with verify)
***
#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
***
#Step_42_Jboss_configuration Step 4.2: Jboss configuration.
***
#Step_43_droolsguvnor_configuration Step 4.3: drools-guvnor configuration
****
#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
****
#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
***
#Step_44_Deploy_and_verify_droolsguvnor_component_installation Step 4.4: Deploy and verify drools-guvnor component installation
****
#a_Deploy_droolsguvnor a. Deploy drools-guvnor
****
#b_Verify_that_we_have_the_following_message_in_the_console b. Verify that we have the following message in the console
****
#c_Verify_that_we_can_access_the_droolsguvnor c. Verify that we can access the drools-guvnor
***
#Step_45_Deploy_designer Step 4.5: Deploy designer
****
#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
****
#b_Deploy_designer b. Deploy designer
****
#c_Verify_designer c. Verify designer
***
#Step_46_Deploy_formbuilder Step 4.6: Deploy form-builder
****
#a_Add_usersroles_configuration_to_GUVNOR_JBOSS a. Add users/roles configuration to GUVNOR_JBOSS
****
#b_Add_security_domain_for_jbpmformbuilder_in_file_standaloneconfigurationstandalonexml b. Add security domain for jbpm-form-builder in file standalone/configuration/standalone.xml
****
#c_Add_usersroles_to_jbpmformbuilderwarWEBINFclasses c. Add users/roles to jbpm-form-builder.war/WEB-INF/classes
****
#d_Deploy_formbuilder_and_verify_like_we_already_did_with_designer d. Deploy form-builder and verify like we already did with designer
****
#e_Verify_that_you_have e. Verify that you have
**
#5_TaskService_or_Human_Task_deployment_with_verify 5. Task-Service or Human Task deployment (with verify).
***
#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
***
#Step_52_Copy_your_custom_build_humantask_ Step 5.2: Copy your custom build human-task
***
#Step_53_Jboss_standalonexml_configuration_ Step 5.3: Jboss standalone.xml configuration
****
#a_Remove_pojo_module a. Remove pojo module
****
#b_Change_port_for_management_interface b. Change port for management interface.
****
#c_Add_datasource_for_taskservice c. Add datasource for task-service
****
#d_Bind_to_HUMAN_TASK_IP_For_example d. Bind to HUMAN_TASK_IP. For example
****
#e_Set_offsetport e. Set offset-port
***
#Step_54_MySQL_driver_for_jboss Step 5.4: MySQL driver for jboss
****
#a_Create_MySQL_module_directory a. Create MySQL module directory
****
#bCopy_module_declaration_file b.Copy module declaration file
****
#c_Download_and_install_mysql_driver_to_jBoss c. Download and install mysql driver to jBoss
****
#d_Start_your_HUMAN_TASK_JBOSS_now d. Start your HUMAN_TASK_JBOSS now
***
#Step_54_jbpmhumantaskwar_configuration_TODO Step 5.4: jbpm-human-task.war configuration (//TODO)
****
#a_Update_HUMAN_TASK_JBOSS a. Update HUMAN_TASK_JBOSS
****
#b_Place_a_copy_of_HUMAN_TASK_JBOSS b. Place a copy of HUMAN_TASK_JBOSS
**
#6_jBPMConsole_deployment_with_verify 6. jBPM-Console deployment (with verify).
*Disclaimer:* First, Almost material in this article I borrowed form all over the public web. Some of most borrowed source are (in order):
* Extract from jbpm-install/build.xml Ant script.
* jBPM official user-guide: http://docs.jboss.org/jbpm/v5.3/userguide/ http://docs.jboss.org/jbpm/v5.3/userguide/
* jBPM community user forum: https://community.jboss.org/community/jbpm?view=discussions https://community.jboss.org/en/jbpm?view=discussions
* BPM Geek: http://bpmgeek.com/blog/making-jbpm5-work-remote-host http://bpmgeek.com/blog/making-jbpm5-work-remote-host
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: http://docs.jboss.org/jbpm/v5.3/userguide/ http://docs.jboss.org/jbpm/v5.3/userguide/
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.
h2. 1. Overview of jBPM
h3. jBPM Components
Download a copy of jbpm-5.3.0.Final-installer-full.zip ( 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/) and extract it to a location, from now on we call it JBPM_INSTALL. JBPM_INSTALL contains all core jBPM components.
|| *Components
* || *File in JBPM_INSTALL/lib*
|| *Description
* ||
| jbpm-runtime | jbpm-5.3.0.Final-bin.zip | jBPM Runtime, if you are willing to build a stand alone Java application you will need this. |
| drools-guvnor | guvnor-distribution-wars-5.4.0-20120516.war | Drools-Guvnor provides process repository. |
| designer | designer-2.2.Final-jboss7.war | JBPM2 process designer. It's integrated with drools-guvnor. |
| form-builder | jbpm-5.3.0.Final-form-builder.war | Form builder. It's going to be integrated with the designer. http://blog.athico.com/2012/07/jbpm-form-builder-state-of-art.html |
| gwt-console and gwt-console-server | jbpm-5.3.0.Final-gwt-console.zip |
|
| human-task | jbpm-5.3.0.Final-human-task-war.zip |
|
Table 01: jBPM.5.3.0.Final components and their binary file
https://community.jboss.org/servlet/JiveServlet/showImage/19247/jBPM+-+In... https://community.jboss.org/servlet/JiveServlet/downloadImage/19247/jBPM+...
Figure 01: jBPM-Internal components communication
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.
https://community.jboss.org/servlet/JiveServlet/showImage/19248/jBPM+-+Ec... https://community.jboss.org/servlet/JiveServlet/downloadImage/19248/jBPM+...
Figure 02: The communication with Eclipse IDE
h3. Separation deployment
For a beginner, with all jBPM components are twisted together:
* It's hard to tell which message of what components. When something go wrong, which one to focus, which one to just ignore.
* Need a way to check each component is up and running.
* Just a way to learn and experience with jBPM.
Purely from this experience and conclusion, this article will provides a manual installation of each jBPM-5.3.0.Final component.
h2. 2. Common bugs fix after jBPM-5.3.0.Final release
h3. Building from source-code
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.
For more detailed git document, please refer to other document. This article only using related git commands.
h4. a. Configure your git username and email
# For your local branche
git config --global user.name "Your Name"
git config --global user.email "your_email(a)addr.ess"
h4. b. Clone jbpm repository from github.com
# 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
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.
mvn clean install -U -Dfull -DskipTests -nsu
This command really takes a while, especially for the first time and your empty maven local repository.
h4. c. Working with local repository
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:
h5. List all jBPM tags
# From your jBPM_SOURCE, show tags
git tag
The output will be something like this:
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
h5. Switch to 5.3.0.Final revision tag.
Chose your local branch name, for example: update.after.5.3.0.final
git checkout 5.3.0.Final -b update.after.5.3.0.final
Result message
Switched to a new branch 'update.after.5.3.0.final'
h5. View pre-history just before jBPM team released jBPM.5.3.0.Final
git log
Example output
***@***:~/Tutorial/jbpm$ git log
commit d7640b9c0ba87d771862e8534cc607ca0f4d1aff
Author: Toni Rikkola <toni(a)rikkola.net>
Date: Mon May 14 13:25:30 2012 +0300
change to 5.4.0.Final version
commit 88440fe1430170458981c2752192df2c64c83636
Author: Maciej Swiderski <mswiders(a)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(a)gmail.com>
Date: Wed May 9 15:04:54 2012 +0100
- mvel workaround
...
Build your own jBPM.5.3.0.Final for the first time
mvn clean install -U -Dfull -DskipTests -nsu
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 update.after.5.3.0.final branches.
h3. Apply bug fix
h4. Bug: Could not locate named parameter [userId]
Full message
java.lang.IllegalArgumentException: org.hibernate.QueryParameterException: could not locate named parameter [userId]
Community thread:
https://community.jboss.org/message/738335#738335 https://community.jboss.org/message/738335#738335
https://community.jboss.org/thread/200361 https://community.jboss.org/thread/200361
Fix commit: 4a47527163854b233cdb9599f54c9320e945a372
h4. Bug: No result, or connection timeout
Message
java.lang.RuntimeException: Timeout : unable to retrieve results
Treatment: With this particular deployment {separating components deployment, using MySQL} I haven't meet this error yet.
h4. Bug: Must be positive
Full message:
2011-07-18 18:46:35,546 [FATAL] Uncaught Exception:
java.lang.IllegalArgumentException:
must be positive
at Unknown.cKb(Unknown source:0)
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.
h4. Bug: HornetQ binding only to local address.
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:
Bug track link: https://issues.jboss.org/browse/JBPM-3720?page=com.atlassian.jira.plugin.... https://issues.jboss.org/browse/JBPM-3720?page=com.atlassian.jira.plugin....
Change set: https://source.jboss.org/changelog/jBPM?cs=e115680b023ce0747608625f0cd616... https://source.jboss.org/changelog/jBPM?cs=e115680b023ce0747608625f0cd616...
h2. 3. Manual jBPM components deployment
h3. Environment
h4. Check your JDK installation
# Check JAVA_HOME environment variable arcording to your operating system. In linux
echo $JAVA_HOME
# JDK Java version 1.6 or newer
java -version
h4. Check apache maven
Download and installation instruction: http://maven.apache.org/download.html http://maven.apache.org/download.html
# 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
h4. Check apache ant
Download: http://ant.apache.org/bindownload.cgi http://ant.apache.org/bindownload.cgi and manual: http://ant.apache.org/manual/index.html http://ant.apache.org/manual/index.html
# 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
h3. Deployment parameters
|| *Name
* || *Variables
* || *Example values* ||
| Jbpm-install | JBPM_INSTALL | /opt/download/jbpm-install |
| MySQL username/password and schema | MySQL_JBPM
MySQL_TASK | jbpm,jbpmpassword and schema name is jbpm
task,taskpassword and schema name is task |
| MySQL server IP/PORT | MySQL_IP:MySQL_PORT | 192.168.140.39:3306 |
| Group-01 components: {Drool-guvnor, Designer, Form-Builder} | GUVNOR_JBOSS
GUVNOR_IP
GUVNOR_HTTP_PORT
GUVNOR_MANAGEMENT_PORT | /opt/guvnor_jboss
192.168.140.39
8080
9999 and 9990 |
| Group-02: Human-task | HUMAN_TASK_JBOSS
HUMAN_TASK_IP
HUMAN_TASK_HTTP_PORT
HUMAN_TASK_MANAGEMENT_PORT
HUMAN_TASK_PORT-OFFSET | /opt/human_task_jboss
192.168.140.39
8180
10099 and 10090
port-offset="100" |
| Group-03: Gwt-Console and Gwt-Console-Server | CONSOLE_JBOSS
CONSOLE_IP
CONSOLE_HTTP_PORT
CONSOLE_MANAGEMENT_POR
CONSOLE_PORT_OFFSET | /opt/console_jboss
192.168.140.39
8280
10199 and 10190
port-offset="200" |
Table 02 - Deployment parameters
The "example value column" in Table 02 are values from a real deployment with all jboss instances running on the same machine. https://community.jboss.org/docs/DOC-16705 https://community.jboss.org/wiki/MultipleInstancesOfJBossAS7OnTheSameMachine (Approach#1)
h3. MySQL database deployment (just verify).
Verify that you can connect and login to MySQL:
# 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
After this, We can just forget about firewall, network routing, MySQL permission issues incase our persistence not work. For MySQL related document http://dev.mysql.com/doc/refman/5.0/en/connecting.html http://dev.mysql.com/doc/refman/5.0/en/connecting.html
h2. 4. Drools guvnor, designer, and form-builder deployment (with verify)
Login to server on GUVNOR_IP and place a copy of jbpm-install and start the installation:
h3. Step 4.1:Extract a clean copy of jboss-as-7.0.2.Final.zip to GUVNOR_JBOSS
# 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
h3. Step 4.2: Jboss configuration.
# Change GUVNOR_JBOSS/standalone/configuration/standalone.xml to bind to GUVNOR_IP. For example
<interfaces>
<interface name="management">
<inet-address value="${jboss.bind.address.management:192.168.140.39}"/>
</interface>
<interface name="public">
<inet-address value="${jboss.bind.address:192.168.140.39}"/>
</interface>
</interfaces>
h3. Step 4.3: drools-guvnor configuration
h4. a. Update GUVNOR_JBOSS/preferences.properties to our will be deployed designer and form-builder
...
#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
h4. b. Place a copy of GUVNOR_JBOSS/preferences.properties to drools-guvnor.war/target/WEB-INF/classes/preferences.properties
# User your favorist archive manager.
Using "Open with Archive Manager" in Ubuntu Linux
h3. Step 4.4: Deploy and verify drools-guvnor component installation
h4. a. Deploy drools-guvnor
# 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
h4. b. Verify that we have the following message in the console
...
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
h4. c. Verify that we can access the drools-guvnor
Access the http://GUVNOR_IP:8080/drools-guvnor http://GUVNOR_IP:8080/drools-guvnor (In our example is http://192.168.140.39:8080 http://192.168.140.39:8080/drools-guvnor) with the browser from GUVNOR_IP and CONSOLE_IP
h3. Step 4.5: Deploy designer
h4. a. Apply the change for Designer as following article http://bpmgeek.com/blog/making-jbpm5-work-remote-host
Section#Saving and reloading process in designer could cause failures
<externalloadurl protocol="http" host="GUVNOR_IP:8080" subdomain="drools-guvnor/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="admin"/>
In our example
<externalloadurl protocol="http" host="192.168.140.39:8080" subdomain="drools-guvnor/org.drools.guvnor.Guvnor/oryxeditor" usr="admin" pwd="admin"/>
h4. b. Deploy designer
Simple by copy to jboss deployment directory, or with our example in Linux
# Set our GUVNOR_JBOSS to this example path
export GUVNOR_JBOSS=/opt/guvnor_jboss
cd $GUVNOR_JBOSS
# Deploy designer
cp designer.war standalone/deployments/
h4. c. Verify designer
Start jboss and verify that we have something like this
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"
https://community.jboss.org/servlet/JiveServlet/showImage/19266/Screensho... https://community.jboss.org/servlet/JiveServlet/downloadImage/19266/Scree...
Figure 02: Verify designer installation
User your browser to connect to http://GUVNOR_IP:8080/drools-guvnor http://GUVNOR_IP:8080/drools-guvnor (or http://192.168.140.39:8080/drools-guvnor http://192.168.140.39:8080/drools-guvnor 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.
h3. Step 4.6: Deploy form-builder
h4. a. Add users/roles configuration to GUVNOR_JBOSS
# 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/
h4. b. Add security domain for jbpm-form-builder in file standalone/configuration/standalone.xml
<subsystem xmlns="urn:jboss:domain:security:1.0">
<security-domains>
..
<security-domain name="jbpm-form-builder" cache-type="default">
<authentication>
<login-module code="UsersRoles" flag="required">
<module-option name="usersProperties" value="${jboss.server.config.dir}/users.properties"/>
<module-option name="rolesProperties" value="${jboss.server.config.dir}/roles.properties"/>
</login-module>
</authentication>
</security-domain>
..
</security-domains>
</subsystem>
h4. c. Add users/roles to jbpm-form-builder.war/WEB-INF/classes
Using your current Archive Manager to add users.properties and roles.properties to jbpm-form-builder.war/WEB-INF/classes
h4. d. Deploy form-builder and verify like we already did with designer
cp jbpm-form-builder.war standalone/deployments/
# Start GUVNOR_JBOSS
bin/standalone.sh
h4. e. Verify that you have
10:36:52,907 INFO [org.jboss.as.server.controller] (DeploymentScanner-threads - 2) Deployed "drools-guvnor.war"
And use your browser to verify that http://GUVNOR_IP:8080/jbpm-form-builder http://GUVNOR_IP:8080/jbpm-form-builder ( http://192.168.140.39:8080/jbpm-form-builder http://192.168.140.39:8080/jbpm-form-builder) works.
h2. 5. Task-Service or Human Task deployment (with verify).
Login to server on HUMAN_TASK_IP and place a copy of jbpm-install and start the installation:
h3. Step 5.1:Extract a clean copy of jboss-as-7.0.2.Final.zip to HUMAN_TASK_JBOSS
# 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
h3. Step 5.2: Copy your custom build human-task
>From JBPM_SOURCE/jbpm-human-task/jbpm-human-task-war/target
To $HUMAN_TASK_JBOSS/jbpm-human-task-war.war
h3. Step 5.3: Jboss standalone.xml configuration
Change HUMAN_TASK_JBOSS/standalone/configuration/standalone.xml as following
h4. a. Remove pojo module
<extension module="org.jboss.as.osgi"/>
<!-- Remove this line extension module="org.jboss.as.pojo"/-->
<extension module="org.jboss.as.remoting"/>
h4. b. Change port for management interface.
<management-interfaces>
<native-interface interface="management" port="10099" />
<http-interface interface="management" port="10090"/>
</management-interfaces>
h4. c. Add datasource for task-service
<subsystem xmlns="urn:jboss:domain:datasources:1.0">
<datasources>
<datasource jndi-name="java:jboss/datasources/taskDS" pool-name="MysqlTaskDSPool" enabled="true" jta="true" use-java-context="true" use-ccm="true">
<connection-url>
jdbc:mysql://192.168.140.39:3306/task
</connection-url>
<driver>
mysql
</driver>
<pool>
<prefill>
false
</prefill>
<use-strict-min>
false
</use-strict-min>
<flush-strategy>
FailingConnectionOnly
</flush-strategy>
</pool>
<security>
<user-name>
task
</user-name>
<password>
taskpassword
</password>
</security>
</datasource>
<drivers>
<driver name="mysql" module="com.mysql">
<xa-datasource-class>
com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
</xa-datasource-class>
</driver>
</drivers>
</datasources>
</subsystem>
h4. d. Bind to HUMAN_TASK_IP. For example
<interfaces>
<interface name="management">
<inet-address value="${jboss.bind.address.management:192.168.140.39}"/>
</interface>
<interface name="public">
<inet-address value="${jboss.bind.address:192.168.140.39}"/>
</interface>
</interfaces>
h4. e. Set offset-port
For our example to running on the same server as in https://community.jboss.org/docs/DOC-16705 https://community.jboss.org/wiki/MultipleInstancesOfJBossAS7OnTheSameMachine (Approach#1)
<socket-binding-group name="standard-sockets" default-interface="public" port-offset="100">
h3. Step 5.4: MySQL driver for jboss
h4. a. Create MySQL module directory
mkdir /modules/com/mysql
mkdir /modules/com/mysql/main
h4. b.Copy module declaration file
cp module.xml /modules/com/mysql/main/
h4. c. Download and install mysql driver to jBoss
wget https://repository.jboss.org/nexus/service/local/repositories/central/con... https://repository.jboss.org/nexus/service/local/repositories/central/con...
cp mysql-connector-java-5.1.18.jar /modules/com/mysql/main/mysql-connector-java.jar
h4. d. Start your HUMAN_TASK_JBOSS now
bin/standalone.sh
To verify your configuration
* Does it start Ok?
* MySQL driver loaded?
* Can you see taskDS datasource on jBoss admin console at http://HUMAN_TASK_IP:10099/ http://HUMAN_TASK_IP:10099/ ?
h3. Step 5.4: jbpm-human-task.war configuration (//TODO)
h4. a. Update HUMAN_TASK_JBOSS
h4. b. Place a copy of HUMAN_TASK_JBOSS
h2. 6. jBPM-Console deployment (with verify).
--------------------------------------------------------------
Comment by going to Community
[https://community.jboss.org/docs/DOC-21179]
Create a new document in jBPM at Community
[https://community.jboss.org/choose-container!input.jspa?contentType=102&c...]
13 years, 7 months
- 1
- 0
[jBPM] - "Large Objects may not be used in auto-commit mode" when using Postresql DB
by wqe wqe
wqe wqe [https://community.jboss.org/people/drupalspring] created the discussion
""Large Objects may not be used in auto-commit mode" when using Postresql DB"
To view the discussion, visit: https://community.jboss.org/message/755019#755019
--------------------------------------------------------------
I just follow the instruction in the http://docs.jboss.org/jbpm/v5.3/userguide/ch.console.html official documtation of using gwt-console :
1. Login as krisv and create an evaluation instance
2. Click the task section --> Personal Tasks to check if the process instance created in the previous step can be assigned to krisv (current account ) . However , " *Large Objects may not be used in auto-commit mode*" exception occurs . Belows show the details information of this errors:
> 15:03:00,963 INFO [stdout] (Thread-68) Hibernate: select task0_.id as col_0_0_, task0_.processInstanceId as col_1_0_, names4_.text as col_2_0_, subjects2_.text as col_3_0_, descriptio3_.text as col_4_0_, task0_.status as col_5_0_, task0_.priority as col_6_0_, task0_.skipable as col_7_0_, task0_.actualOwner_id as col_8_0_, user1_.id as col_9_0_, task0_.createdOn as col_10_0_, task0_.activationTime as col_11_0_, task0_.expirationTime as col_12_0_, task0_.processId as col_13_0_, task0_.processSessionId as col_14_0_ from Task task0_ left outer join OrganizationalEntity user1_ on task0_.createdBy_id=user1_.id left outer join I18NText subjects2_ on task0_.id=subjects2_.Task_Subjects_Id left outer join I18NText descriptio3_ on task0_.id=descriptio3_.Task_Descriptions_Id left outer join I18NText names4_ on task0_.id=names4_.Task_Names_Id inner join OrganizationalEntity user5_ on task0_.actualOwner_id=user5_.id where task0_.actualOwner_id=? and (task0_.status in (?)) and (names4_.language=? or (select count(names6_.Task_Names_Id) from I18NText names6_ where task0_.id=names6_.Task_Names_Id)=0) and (subjects2_.language=? or (select count(subjects7_.Task_Subjects_Id) from I18NText subjects7_ where task0_.id=subjects7_.Task_Subjects_Id)=0) and (descriptio3_.language=? or (select count(descriptio8_.Task_Descriptions_Id) from I18NText descriptio8_ where task0_.id=descriptio8_.Task_Descriptions_Id)=0) and (task0_.expirationTime is null)
>
>
> [11:17:04,031 ERROR [org.jbpm.task.service.TaskServerHandler] (Thread-70) org.hibernate.exception.GenericJDBCException*: Large Objects may not be used in auto-commit mode.*: javax.persistence.PersistenceException: org.hibernate.exception.GenericJDBCException: Large Objects may not be used in auto-commit mode.
> ]
> 11:17:04,015 ERROR [stderr] (Thread-70) at org.jbpm.task.service.persistence.*TaskPersistenceManager.queryTasksWithUserIdStatusAndLanguage*(TaskPersistenceManager.java:225)
> 11:17:04,015 ERROR [stderr] (Thread-70) at org.jbpm.task.service*.TaskServiceSession.getTasksOwned*(TaskServiceSession.java:653)
> 11:17:04,015 ERROR [stderr] (Thread-70) at org.jbpm.task.service.TaskServerHandler.messageReceived(TaskServerHandler.java:289)
Google and found that handling the "large object" in postresql is required to be enclosed with a transaction block. As my transaction is managed by the AS , I want to ask how to force the AS to disable the auto-commit transaction ? Do jbpm 5.3.0 Final really works with Postresql 9.1 ? Anyone who have successfully config jbpm 5.3.0 Final with Postresql 9.1 using AS 7.1.X please share the idea .
Here is my configuration :
persistence.xml of the jbpm-human-task-war.war :
<persistence-unit name="org.jbpm.task" transaction-type="JTA">
<provider>org.hibernate.ejb.HibernatePersistence</provider>
<jta-data-source>java:jboss/datasources/task</jta-data-source>
<mapping-file>META-INF/Taskorm.xml</mapping-file>
<properties>
<property name="hibernate.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/>
<property name="hibernate.max_fetch_depth" value="3"/>
<property name="hibernate.hbm2ddl.auto" value="update" />
| | <property name="hibernate.connection.autocommit" value="false" /> | |
<property name="hibernate.show_sql" value="true" />
<class>XXXXXXXX</class>
<property name="hibernate.connection.autocommit" value="false" />
<property name="hibernate.transaction.jta.platform" value="org.hibernate.service.jta.platform.internal.JBossAppServerJtaPlatform" />
</properties>
</persistence-unit>
datasource setting in the standalone.xml:
<subsystem xmlns="urn:jboss:domain:datasources:1.0">
<datasources>
<datasource jta="true" jndi-name="java:jboss/datasources/jbpm5" pool-name="jbpmDS" enabled="true" use-java-context="true">
<connection-url>jdbc:postgresql://127.0.0.1:5433/jbpm5</connection-url>
<driver>postgresql-9.1</driver>
<security>
<user-name>jbpm5</user-name>
<password>jbpm5</password>
</security>
</datasource>
<datasource jta="true" jndi-name="java:jboss/datasources/task" pool-name="taskDS" enabled="true" use-java-context="true">
<connection-url>jdbc:postgresql://127.0.0.1:5433/task</connection-url>
<driver>postgresql-9.1</driver>
<security>
<user-name>jbpm5</user-name>
<password>jbpm5</password>
</security>
</datasource>
<drivers>
<driver name="postgresql-9.1" module="org.postgresql">
<xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class>
</driver>
</drivers>
</datasources>
</subsystem>
--------------------------------------------------------------
Reply to this message by going to Community
[https://community.jboss.org/message/755019#755019]
Start a new discussion in jBPM at Community
[https://community.jboss.org/choose-container!input.jspa?contentType=1&con...]
13 years, 7 months
- 1
- 0