Chapter 2. Red Hat Decision Manager clusters in a development (authoring) environment
Configuration of Business Central for high availability is currently technology preview.
You can configure Red Hat Decision Manager as a clustered development environment to benefit from high availability. With a clustered environment, if a developer is working on $node1
and that node fails, that developer’s work is preserved and visible on any other node of the cluster.
Most development environments consist of Business Central and at least one Decision Server .
To create a Red Hat Decision Manager clustered development environment, you must perform the following tasks:
- Configure Red Hat JBoss EAP 7.2 with Red Hat Data Grid 7.3.1 on a machine.
- Configure AMQ Broker, a Java messaging server (JMS) broker, on a machine.
- Configure an NFS file server on a machine.
- Download Red Hat JBoss EAP 7.2 and Red Hat Decision Manager 7.5, then install them on each machine that is to become a cluster node.
- Configure and start Business Central on each cluster node to start the operation of the cluster.
Red Hat Data Grid is built from the Infinispan open-source software project. It is a distributed highly scalable full-text search and analytics engine. It contains indexing capabilities that enable you to store, search, and analyze high volumes of data quickly and in near-real time. In a Red Hat Decision Manager clustered environment, it enables you to perform complex and efficient searches across cluster nodes.
A JMS broker is a software component that receives messages, stores them locally, and forwards the messages to a recipient. AMQ Broker enables your applications to communicate with any messaging provider. It specifies how components such as message-driven beans, Enterprise JavaBeans, and servlets can send or receive messages.
2.1. Installing and configuring Red Hat Data Grid
To use Red Hat Data Grid for more efficient searching across cluster nodes, install and configure Red Hat Data Grid for the Red Hat Decision Manager clustered environment. Use the following instructions to configure a simplified, non-high availability environment on a separate machine.
For information about Red Hat Data Grid modules for Red Hat JBoss EAP, see Red Hat Data Grid modules for EAP in the Red Hat Data Grid User Guide.
Do not install Red Hat Data Grid on the same node as Business Central.
Prerequisites
- A Java Virtual Machine (JVM) environment compatible with Java 8.0 or later is installed.
-
A backed-up Red Hat JBoss EAP installation version 7.2 or higher is available. The base directory of the Red Hat JBoss EAP installation is referred to as
EAP_HOME
. - Red Hat Decision Manager is installed and configured.
- Sufficient user permissions to complete the installation are granted.
Procedure
Navigate to the Software Downloads page in the Red Hat Customer Portal (login required), and select the product and version from the drop-down options:
- Product: Data Grid
- Version: 7.3
Download and unzip the Red Hat JBoss Data Grid 7.3.0 Server (
jboss-datagrid-7.3.0-1-server.zip
) installation file to the preferred location on your system.The unzipped directory is referred to as
JDG_HOME
.To run Red Hat Data Grid, navigate to
JDG_HOME/bin
and enter one of the following commands:On Linux or UNIX-based systems:
$ ./standalone.sh -c clustered.xml
On Windows:
standalone.bat -c clustered.xml
2.2. Downloading and configuring AMQ Broker
AMQ Broker enables your applications to communicate with any messaging provider. It specifies how components such as message-driven beans, Enterprise JavaBeans, and servlets can send or receive messages. Use the following instructions to configure a simplified, non-high availability environment on a separate machine.
To configure AMQ Broker for a high availability Red Hat Decision Manager clustered environment, see Using AMQ Broker.
Procedure
Navigate to the Software Downloads page in the Red Hat Customer Portal (login required), and select the product and version from the drop-down options:
- Product: AMQ Broker
- Version: 7.2.0
-
Click Download next to Red Hat AMQ Broker 7.2.0 (
amq-broker-7.2.0-bin.zip
). -
Extract the
amq-broker-7.2.0-bin.zip
file. -
Change directory to
amq-broker-7.2.0-bin/amq-broker-7.2.0/bin
. Enter the following command and replace the following placeholders to create the broker and broker user:
-
<HOST>
is the IP address or host name of the server where you installed AMQ Broker. -
<AMQ_USER>
and<AMQ_PASSWORD>
is a user name and password combination of your choice. <BROKER_NAME>
is a name for the broker that you are creating../artemis create --host <HOST> --user <AMQ_USER> --password <AMQ_PASSWORD> --require-login <BROKER_NAME>
-
To run AMQ Broker, enter the following command in the
amq-broker-7.2.0-bin/amq-broker-7.2.0/bin
directory:amq-broker-7.2.0/bin/<BROKER_NAME>/bin/artemis run
2.3. Configuring an NFS server
You must deploy and configure an NFS server to provide the file system necessary for a Business Central clustered environment.
You must use NFS version 4.
Procedure
- Configure a server to export NFS version 4 shares. For instructions about exporting NFS shares on Red Hat Enterprise Linux, see Exporting NFS shares.
Create an
/opt/kie/data
share with the options:rw,sync,no_root_squash
. For example, you can use one of the following lines in the/etc/exports
file:/opt/kie/data *(rw,sync,no_root_squash) /opt/kie/data 192.268.1.0/24(rw,sync,no_root_squash)
NoteYou can use another share name instead of '/opt/kie/data'. In this case, you must use this name when configuring all nodes that run Business Central.
2.4. Downloading and extracting Red Hat JBoss EAP 7.2 and Red Hat Decision Manager
Download and install Red Hat JBoss EAP 7.2 and Red Hat Decision Manager 7.5 on each node of the cluster.
Procedure
Download Red Hat JBoss EAP 7.2 on each node of the cluster:
Navigate to the Software Downloads page in the Red Hat Customer Portal (login required), and select the product and version from the drop-down options:
- Product: Enterprise Application Platform
- Version: 7.2
-
Click Download next to Red Hat JBoss Enterprise Application Platform 7.2.0. (
JBEAP-7.2.0/jboss-eap-7.2.0.zip
).
-
Extract the
jboss-eap-7.2.0.zip
file. In the following steps,EAP_HOME
is thejboss-eap-7.2/jboss-eap-7.2
directory. - Download and apply the latest Red Hat JBoss EAP patch, if available.
Download Red Hat Decision Manager on each node of the cluster:
Navigate to the Software Downloads page in the Red Hat Customer Portal, and select the product and version from the drop-down options:
- Product: Decision Manager
- Version: 7.5
-
Download Red Hat Decision Manager 7.5.1 Business Central Deployable for Red Hat JBoss EAP 7 (
rhdm-7.5.1-decision-central-eap7-deployable.zip
).
-
Extract the
rhdm-7.5.1-decision-central-eap7-deployable.zip
file to a temporary directory. In the following commands this directory is calledTEMP_DIR
. -
Copy the contents of
TEMP_DIR/rhdm-7.5.1-decision-central-eap7-deployable/jboss-eap-7.2
toEAP_HOME
. - Download and apply the latest Red Hat Decision Manager patch, if available.
-
Navigate to the
EAP_HOME/bin
directory. Create a user with the
admin
role that you will use to log in to Business Central. In the following command, replace<username>
and<password>
with the user name and password of your choice.$ ./add-user.sh -a --user <USERNAME> --password <PASSWORD> --role admin
NoteMake sure that the specified user name is not the same as an existing user, role, or group. For example, do not create a user with the user name
admin
.The password must have at least eight characters and must contain at least one number and one non-alphanumeric character, but not & (ampersand).
Create a user with the
kie-server
role that you will use to log in to Decision Server.$ ./add-user.sh -a --user <USERNAME> --password <PASSWORD> --role kie-server
- Make a note of your user names and passwords.
2.5. Configuring and running Business Central in a cluster
After you install Red Hat JBoss EAP and Business Central you can use Red Hat Data Grid and the AMQ Broker to configure the cluster. Complete these steps on each node of the cluster.
These steps describe a basic cluster configuration. For more complex configurations, see the Red Hat JBoss EAP 7.2 Configuration Guide.
Prerequisites
- Red Hat Data Grid 7.3.1 is installed as described in Section 2.1, “Installing and configuring Red Hat Data Grid”.
- AMQ Broker is installed and configured, as described in Section 2.2, “Downloading and configuring AMQ Broker”.
- Red Hat JBoss EAP and Red Hat Decision Manager are installed on each node of the cluster as described in Section 2.4, “Downloading and extracting Red Hat JBoss EAP 7.2 and Red Hat Decision Manager”.
An NFS server with a mounted partition is available.
NoteTo configure an NFS server with a mounted partition, perform the following steps:
- Configure the NFS server. For more information, see How to configure NFS in RHEL 7 and Section 2.3, “Configuring an NFS server”.
To add the shared folder, enter the following command:
# vi /etc/exports /data/shared * (rw,sync,no_root_squash)
Where
/data/shared
is the shared folder,*
are the IP addresses allowed to connect to the NFS server, and(rw,sync,no_root_squash)
are the minimum options required for NFS.
Procedure
Mount the directory shared over NFS as
/data
. Enter the following commands as the root user:mkdir /data mount <NFS_SERVER_IP>:<DATA_SHARE> /data
Replace <NFS_SERVER_IP> with the IP address or hostname of the NFS server machine. Replace <DATA_SHARE> with the share name that you configured (for example,
/opt/kie/data
).-
Open the
EAP_HOME/standalone/configuration/standalone-full.xml
file in a text editor. Edit or add the properties under the
<system-properties>
element and replace the following placeholders:-
<AMQ_USER>
and<AMQ_PASSWORD>
are the credentials that you defined when creating the AMQ Broker. -
<AMQ_BROKER_IP_ADDRESS>
is the IP address of the AMQ Broker. <INFINISPAN_NODE_IP>
is the IP address where Red Hat Data Grid is installed.<system-properties> <property name="appformer-jms-connection-mode" value="REMOTE"/> <property name="appformer-jms-username" value="<AMQ_USER>"/> <property name="appformer-jms-password" value="<AMQ_USER_PASSWORD>"/> <property name="appformer-jms-url" value="tcp://<AMQ_BROKER_IP_ADDRESS>:61616?ha=true&retryInterval=1000&retryIntervalMultiplier=1.0&reconnectAttempts=-1"/> <property name="org.appformer.ext.metadata.infinispan.port" value="11222"/> <property name="org.appformer.ext.metadata.infinispan.host" value="<INFINISPAN_NODE_IP>"/> <property name="org.appformer.ext.metadata.infinispan.realm" value="ApplicationRealm"/> <property name="org.appformer.ext.metadata.infinispan.cluster" value="kie-cluster"/> <property name="org.appformer.ext.metadata.index" value="infinispan"/> <property name="org.uberfire.nio.git.dir" value="/data"/> <property name="es.set.netty.runtime.available.processors" value="false"/> </system-properties>
-
Optional: If the Red Hat Data Grid deployment requires authentication, edit or add the properties under the
<system-properties>
element and replace the following placeholders:-
<SERVER_NAME>
is the server name specified in your Red Hat Data Grid server configuration. <SASL_QOP>
is the combination of auth, auth-int and auth-conf values for your Red Hat Data Grid server configuration.<property name="org.appformer.ext.metadata.infinispan.server.name" value="<SERVER_NAME>"/> <property name="org.appformer.ext.metadata.infinispan.sasl.qop" value="<SASL_QOP>"/> <property name="org.appformer.ext.metadata.infinispan.username" value=""/> <property name="org.appformer.ext.metadata.infinispan.password" value=""/>
-
-
Save the
standalone-full.xml
file. To start the cluster, navigate to
EAP_HOME/bin
and enter one of the following commands:On Linux or UNIX-based systems:
$ ./standalone.sh -c standalone-full.xml
On Windows:
standalone.bat -c standalone-full.xml
2.6. Verifying the Red Hat Decision Manager cluster
After configuring the cluster for Red Hat Decision Manager, create an asset to verify that the installation is working.
Procedure
-
In a web browser, enter
<node-IP-address>:8080/decision-central
. Replace<node-IP-address>
with the IP address of a particular node. -
Enter the
admin
user credentials that you created during installation. The Business Central home page appears. - Select Menu → Design → Projects.
- Open the MySpace space.
- Click Try Samples → Mortgages → OK. The Assets window appears.
- Click Add Asset → Data Object.
-
Enter
MyDataObject
in the Data Object field and click OK. -
Click Spaces → MySpace → Mortgages and confirm that
MyDataObject
is in the list of assets. Enter the following URL in a web browser, where
<node_IP_address>
is the address of a different node of the cluster:http://<node_IP_address>:8080/decision-central
-
Enter the same credentials that you used to log in to Business Central on the first node, where you created the
MyDataObject
asset. - Select Menu→ Design → Projects.
- Open the MySpace space.
- Select the Mortgages project.
-
Verify that
MyDataObject
is in the asset list. - Delete the Mortgages project.