Chapter 2. Red Hat Decision Manager clusters in a development (authoring) environment

Procedure

1. 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

2. 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.

3. 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

Procedure

1. 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
2. Click Download next to Red Hat AMQ Broker 7.2.0 (amq-broker-7.2.0-bin.zip).
3. Extract the amq-broker-7.2.0-bin.zip file.
4. Change directory to amq-broker-7.2.0-bin/amq-broker-7.2.0/bin.

5. 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>

6. 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

Procedure

1. Download Red Hat JBoss EAP 7.2 on each node of the cluster:

   1. 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
   2. Click Download next to Red Hat JBoss Enterprise Application Platform 7.2.0. (JBEAP-7.2.0/jboss-eap-7.2.0.zip).
2. Extract the jboss-eap-7.2.0.zip file. In the following steps, EAP_HOME is the jboss-eap-7.2/jboss-eap-7.2 directory.
3. Download and apply the latest Red Hat JBoss EAP patch, if available.

4. Download Red Hat Decision Manager on each node of the cluster:

   1. 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.4
   2. Download Red Hat Decision Manager 7.4.0 Business Central Deployable for Red Hat JBoss EAP 7 (rhdm-7.4.0-decision-central-eap7-deployable.zip).
5. Extract the rhdm-7.4.0-decision-central-eap7-deployable.zip file to a temporary directory. In the following commands this directory is called TEMP_DIR.
6. Copy the contents of TEMP_DIR/rhdm-7.4.0-decision-central-eap7-deployable/jboss-eap-7.2 to EAP_HOME.
7. Download and apply the latest Red Hat Decision Manager patch, if available.
8. Navigate to the EAP_HOME/bin directory.

9. 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

   Note

   Make 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).

10. 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

11. Make a note of your user names and passwords.

Procedure

1. Open the EAP_HOME/standalone/configuration/standalone-full-ha.xml file in a text editor.

2. Edit or add the following properties to 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.
   • <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.
   • <INFINISPAN_NODE_IP> is the IP address where Red Hat Data Grid is installed.
   • <SHARED_NETWORK_FOLDER> is the network folder that all Business Centrals in the cluster use to exchange data. This folder must be the same on all nodes of the cluster.

   <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&amp;retryInterval=1000&amp;retryIntervalMultiplier=1.0&amp;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.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=""/>
     <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="<SHARED_NETWORK_FOLDER>"/>
     <property name="es.set.netty.runtime.available.processors"
        value="false"/>
   </system-properties>

3. Save the standalone-full-ha.xml file.

4. 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-ha.xml

   • On Windows:

     standalone.bat -c standalone-full-ha.xml

Procedure

1. In a web browser, enter <node-IP-address>:8080/decision-central. Replace <node-IP-address> with the IP address of a particular node.
2. Enter the admin user credentials that you created during installation. The Business Central home page appears.
3. Select Menu → Design → Projects.
4. Click Try Samples → Mortgages → OK. The Assets window appears.
5. Click Add Asset → Data Object.
6. Enter MyDataObject in the Data Object field and click OK.
7. Click Spaces → MySpace → Mortgages and confirm that MyDataObject is in the list of assets.

8. 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

9. Enter the same credentials that you used to log in to Business Central on the first node, where you created the MyDataObject asset.
10. Select Menu→ Design → Projects.
11. Select the Mortgages project.
12. Verify that MyDataObject is in the asset list.
13. Delete the Mortgages project.