Since version 7 KIE Server is the only provided out of the box execution server (there is no execution server in workbench) so it got some additional attention to make sure it does perform in the best possible way.
KIE Server supports following runtime environments:
- WildFly 10.x
- EAP 7.x
- WebSphere 9
- WebLogic 12.3
- Tomcat 8.x
Tom Jenkinson and Gytis Trikleris
Installation notes – with BPM capabilities
- (1) Copy following libraries into TOMCAT_HOME/lib
- javax.security.jacc:javax.security.jacc-api
- org.kie:kie-tomcat-integration
- org.slf4j:artifactId=slf4j-api
- org.slf4j:artifactId=slf4j-jdk14
- (2) Configure users and roles in tomcat-users.xml (or different user repository if applicable)
- (3) Configure JACC Valve for security integration Edit TOMCAT_HOME/conf/server.xml and add following in Host section after last Valve declaration
<Valve className=”org.kie.integration.tomcat.JACCValve” />
- (4) Create setenv.sh|bat in TOMCAT_HOME/bin with following content
CATALINA_OPTS="
-Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry
-Dorg.kie.server.persistence.ds=java:comp/env/jdbc/jbpm
-Djbpm.tm.jndi.lookup=java:comp/env/TransactionManager
-Dorg.kie.server.persistence.tm=JBossTS
-Dhibernate.connection.release_mode=after_transaction
-Dorg.kie.server.id=tomcat-kieserver
-Dorg.kie.server.location=http://localhost:8080/kie-server/services/rest/server
-Dorg.kie.server.controller=http://localhost:8080/kie-wb/rest/controller
"
Items marked in green are related to persistence and transaction.
Items marked in blue are general KIE Server parameters needed when running in managed mode.
- (5) Copy JDBC driver jar into TOMCAT_HOME/lib depending on the data base of your choice
- (6) Configure data source for jBPM extension of KIE Server
Edit TOMCAT_HOME/conf/context.xml and add following within Context tags of the file:
This is only an example to use H2 as data base, for other data bases look at
- (7) Last but not least is to configure XA recovery
Create xa recovery file next to the context.xml with data base configuration with following content:
- <?xml version=”1.0″ encoding=”UTF-8″?>
- <!DOCTYPE properties SYSTEM “http://java.sun.com/dtd/properties.dtd”>
- <properties>
- <entry key=”DB_1_DatabaseUser”>sa</entry>
- <entry key=”DB_1_DatabasePassword”>sa</entry>
- <entry key=”DB_1_DatabaseDynamicClass”></entry>
- <entry key=”DB_1_DatabaseURL”>java:comp/env/h2DataSource</entry>
- </properties>
- Append to CATALINA_OPTS in setenv.sh|bat file following:
-Dcom.arjuna.ats.jta.recovery.XAResourceRecovery1=
- BasicXARecovery supports following parameters:
- path to the properties file
- the number of connections defined in the properties file