-
Language:
English
-
Language:
English
2.3. Installing the Deployable Package
The deployable package is provided for customers to install JBoss Enterprise BRMS Platform 5.3.1 to an existing application server. JBoss Enterprise BRMS 5.3.1 is supported on the following containers:
- JBoss Enterprise Application Platform 5.1.2, 5.2.0, and 6.0.0
- JBoss Enterprise SOA Platform 5.3.0
- JBoss Enterprise Web Server 1.0.2 and 2.0.0
Procedure 2.2. Installing the Deployable Package
- Download the deployable package zip file from the Red Hat Customer Support Portal at https://access.redhat.com.Select Downloads → Download your software → BRMS Platform, and then select the version and choose the deployable package.Users installing to JBoss Enterprise Application Platform 6 should download the package that includes EE6 as part of the filename. All other users should download the package that does not include EE6 as part of the filename.
- Extracting the downloaded archive creates the following zip archives:
jboss-brms-engine.zip
jboss-brms-manager.zip
jboss-jbpm-console.zip
jboss-jbpm-engine.zip
modeshape.zip
Modeshape is a Java Content Repository (JCR) that is included in JBoss Enterprise BRMS 5.3.1 as a technical preview; see the BRMS Administration Guide for further details. - Extract
jboss-brms.war
from thejboss-brms-manager.zip
archive and copy to the application server's deploy directory.The deploy directories are as follow:- JBoss Enterprise Application Platform 5.x:
jboss-as/server/profile/deploy/
- JBoss Enterprise Application Platform 6.0:
jboss-eap-6.0/standalone/deployments/
- JBoss Enterprise SOA Platform:
jboss-esb/server/profile/deploy/
- JBoss Enterprise Web Server 1:
tomcat6/webapps/
- JBoss Enterprise Web Server 2:
tomcat7/webapps/
- Extract
business-central.war
,business-central-server.war
,designer.war
, andjbpm-human-task.war
from thejboss-jbpm-console.zip
archive and copy to the application server's deploy directory as above. - JBoss Enterprise Web Server users must remove the
.war
extension from the name of the war archives. After the archives have been renamed thewebapps/
directory should contains the following subdirectories:- jboss-brms
- business-central
- business-central-server
- designer
- jbpm-human-task
- JBoss Enterprise Application Platform 6 users must create the following empty files in the
jboss-eap-6.0/standalone/deployments/
directory:- jboss-brms.war.dodeploy
- business-central.war.dodeploy
- business-central-server.war.dodeploy
- designer.war.dodeploy
- jbpm-human-task.war.dodeploy
- Extract the
jboss-jbpm-engine.zip
directory and copy thenetty.jar
file fromjboss-jbpm-engine/lib/
into a directory that will be on the classpath.- JBoss Enterprise Application Platform 5:
common/lib/
- JBoss Enterprise SOA Platform 5.x:
common/lib/
- JBoss Enterprise Web Server 1:
tomcat6/lib/
- JBoss Enterprise Web Server 2:
tomcat7/lib/
Note
Both JBoss Enterprise Application Platform 5.x and JBoss Enterprise SOA Platform include a netty.jar file; however, JBoss Enterprise BRMS requires the specific version of netty.jar that is included with the JBoss Enterprise BRMS download.JBoss Enterprise Application Platform 6 users do not need to extract netty.jar from thejboss-jbpm-engine.zip
directory. Instead, edit thejboss-eap-6.0/standalone/configuration/standalone.xml
file so that the application server will load the required netty library.Update the"urn:jboss:domain:ee:1.1"
subsystem property to match the following code snippet:<subsystem xmlns="urn:jboss:domain:ee:1.1"> <global-modules> <module name="org.jboss.netty" slot="main"/> </global-modules> <spec-descriptor-property-replacement>false</spec-descriptor-property-replacement> <jboss-descriptor-property-replacement>true</jboss-descriptor-property-replacement> </subsystem>
- When deploying to JBoss Enterprise Web Server, copy the
antlr
,common-collections
,dom4j
,javassist
,jta
,hibernate
,log4j
, andslf4j
jar files from thejboss-jbpm-engine/lib/
directory to the application server'slib
directory.- JBoss Enterprise Web Server 1:
tomcat6/lib/
- JBoss Enterprise Web Server 2:
tomcat7/lib/
- The default configurations use embedded databases that are not suitable or supported for production environments. Before deploying into a production environment, this configuration must be changed to a supported database. Please refer to the BRMS Administration Guide for database configuration instructions.