Chapter 4. Decision Server ZIP file installation and configuration
You can install Decision Server using the rhdm-7.2-kie-server-jws.zip
file .
4.1. Installing Decision Server from ZIP files
Decision Server provides the runtime environment for business assets and accesses the data stored in the assets repository (knowledge store). You can use ZIP files to install Decision Server on an existing Red Hat JBoss Web Server 5.0.1 or higher server instance.
To use the installer JAR file to install Decision Server, see Chapter 3, Using the Red Hat Decision Manager installer.
Prerequisites
The following files have been downloaded, as described in Chapter 2, Downloading the Red Hat Decision Manager installation files:
-
Red Hat Decision Manager 7.2.0 Add Ons (
rhdm-7.2.0-add-ons.zip
) -
Red Hat Decision Manager 7.2.0 Maven Repository (
rhdm-7.2.0-maven-repository.zip
)
-
Red Hat Decision Manager 7.2.0 Add Ons (
-
A backed-up Red Hat JBoss Web Server 5.0.1 or higher server installation is available. The base directory of the Red Hat JBoss Web Server installation is referred to as
JWS_HOME
. - Sufficient user permissions to complete the installation are granted.
Procedure
-
Unzip the
rhdm-7.2.0-add-ons.zip
file. From the unzipped
rhdm-7.2.0-add-ons.zip
file, extract the following files:-
rhdm-7.2-kie-server-jws.zip
-
rhdm-7.2-decision-engine.zip
In the following instructions, the directory that contains the extracted
rhdm-7.2-kie-server-jws.zip
file is calledJWS_TEMP_DIR
and the directory that contains the extractedrhdm-7.2-decision-engine.zip
file is calledENGINE_TEMP_DIR
.-
Copy the
JWS_TEMP_DIR/rhdm-7.2-kie-server-jws/kie-server.war
directory to theJWS_HOME/tomcat/webapps
directory.NoteEnsure the names of the Red Hat Decision Manager deployments you are copying do not conflict with your existing deployments in the Red Hat JBoss Web Server instance.
-
Remove the
.war
extensions from thekie-server.war
folder. -
Move the
kie-tomcat-integration-7.14.0.Final-redhat-00002.jar
file from theENGINE_TEMP_DIR
directory to theJWS_HOME/tomcat/lib
directory. -
Move the
jboss-jacc-api-<VERSION>.jar
,slf4j-api-<VERSION>.jar
, andslf4j-jdk14-<VERSION>.jar
files from theENGINE_TEMP_DIR/lib
directory to theJWS_HOME/tomcat/lib
directory, where<VERSION>
is the version artifact file name, in thelib
directory. -
Unzip the
rhdm-7.2.0-maven-repository.zip
file. Copy the following libraries from the unzipped Maven repository to the
JWS_HOME/tomcat/lib
folder:org.jboss.spec.javax.transaction:jboss-transaction-api_1.2_spec org.jboss.integration:narayana-tomcat org.jboss.narayana.jta:narayana-jta org.jboss:jboss-transaction-spi
Add the following line to the
<host>
element in theTOMCAT_HOME/conf/server.xml
file after the last Valve definition:<Valve className="org.kie.integration.tomcat.JACCValve" />
-
Open the
JWS_HOME/tomcat/conf/tomcat-users.xml
file in a text editor. Add users and roles to the
JWS_HOME/tomcat/conf/tomcat-users.xml
file. In the following example,<ROLE_NAME>
is a role supported by Red Hat Decision Manager.<USER_NAME>
and<USER_PWD>
are the user name and password of your choice:<role rolename="<ROLE_NAME>"/> <user username="<USER_NAME>" password="<USER_PWD>" roles="<ROLE_NAME>"/>
If a user has more than one role, as shown in the following example, separate the roles with a comma:
<role rolename="admin"/> <role rolename="kie-server"/> <user username="rhdmUser" password="user1234" roles="admin,kie-server"/>
Complete one of the following steps in the
JWS_HOME/tomcat/bin
directory:On Linux or UNIX, create the
setenv.sh
file with the following content:CATALINA_OPTS="-Xmx1024m -Dorg.jboss.logging.provider=jdk -Dorg.jbpm.server.ext.disabled=true -Dorg.jbpm.ui.server.ext.disabled=true -Dorg.jbpm.case.server.ext.disabled=true"
On Windows, add the following content to the
setenv.bat
file:set CATALINA_OPTS="-Xmx1024m -Dorg.jboss.logging.provider=jdk -Dorg.jbpm.server.ext.disabled=true -Dorg.jbpm.ui.server.ext.disabled=true -Dorg.jbpm.case.server.ext.disabled=true