Installing and configuring IBM Business Automation Manager Open Editions on Red Hat JBoss EAP 7.4

In a terminal window, navigate to the directory where you downloaded the installer JAR file and enter the following command:

java -jar IBAMOE-8.0-INS.Jar
java -jar IBAMOE-8.0-INS.Jar

java -Dizpack.mode=privileged -jar
IBAMOE-8.0-INS.Jar
IBAMOE-8.0-INS.Jar

java -XX:MaxHeapSize=4g -jar
IBAMOE-8.0-INS.Jar
IBAMOE-8.0-INS.Jar

Click I accept the terms of this license agreement and click Next.

Specify the Red Hat JBoss EAP 7.4 server home where you want to install IBM Business Automation Manager Open Editions and click Next.

Select the components that you want to install and click Next.

Create a user and click Next. By default, if you install both Business Central and KIE Server in the same container the new user is given the admin, kie-server, and rest-all roles. If you install only KIE Server, the user is given the kie-server role. To select another role, deselect admin. For information about roles, see IBM Business Automation Manager Open Editions roles and users.

On the Installation Overview page, review the components that you will install and click Next to start the installation.

When the installation has completed, click Next.

If KIE Server is installed, the Configure Runtime step appears under Component Installation. On the Configure Runtime Environment page, choose to perform the default installation or perform an advanced configuration.

If you selected Customize database settings, on the JDBC Drive Configuration page specify a data source JDBC driver vendor, select one or more driver JAR files, and click Next.

If you selected Customize KIE Server properties, on the KIE Server Properties Configuration page change any of the following properties:

Click Next to configure the runtime environment.

When Processing finished appears at the top of the screen, click Next to complete the installation.

Optional: Click Generate Installation Script and Properties File to save the installation data in XML files, and then click Done.

java -jar IBAMOE-8.0-INS.Jar <path-to-auto.xml-file>
java -jar IBAMOE-8.0-INS.Jar <path-to-auto.xml-file>

In a terminal window, navigate to the directory where you downloaded the installer file and enter the following command:

java -jar IBAMOE-8.0-INS.Jar -console

press 1 to continue, 2 to quit, 3 to redisplay.

Read the license agreement, enter 1, and press Enter to continue:

Specify the home directory of one of the following servers:  Red Hat JBoss EAP 7 or Red Hat JBoss Web Server 5.

Follow the instructions in the installer to complete the installation.

When the installation has completed, you will see this message:

Would you like to generate an automatic installation script and properties file?

Enter y to create XML files that contain the installation data, or n to complete the installation. If you enter y, you are prompted to specify a path for the XML files.

Enter a path or press the Enter key to accept the suggested path.

java -jar IBAMOE-8.0-INS.Jar <path-to-auto.xml-file>

If you installed only Business Central, repeat these steps to install KIE Server on a separate server.

On the first computer, run the installer in interactive mode or CLI mode. See one of the following sections for more information:

On the Component Selection page, clear the KIE Server box.

Complete the Business Central installation.

On the second computer, run the installer in interactive mode or CLI mode.

On the Component Selection page, clear the Business Central box.

On the Configure Runtime Environment page, select Perform Advanced Configuration.

Select Customize KIE Server properties and click Next.

Enter the controller URL for Business Central and configure additional properties for KIE Server. The controller URL has the following form where <HOST:PORT> is the address of Business Central on the second computer:

<HOST:PORT>/business-central/rest/controller

Complete the installation.

To verify that the IBM Business Automation Manager controller is now integrated with Business Central, go to the Execution Servers page in Business Central and confirm that the KIE Server that you configured appears under REMOTE SERVERS.

Extract the IBAMOE-8.0-BC7.zip IBAMOE-8.0-BC7.zip file to a temporary directory. In the following examples this directory is called TEMP_DIR.

Copy the contents of the TEMP_DIR/bamoe-8.0-BC7/jboss-eap-7.4 TEMP_DIR/bamoe-8.0-BC7/jboss-eap-7.4 directory to EAP_HOME. When prompted, merge or replace files.

Extract the IBAMOE-8.0-KS8.Zip IBAMOE-8.0-KS8.Zip archive to a temporary directory. In the following examples this directory is called TEMP_DIR.

Copy the TEMP_DIR/IBAMOE-8.0-KS8/kie-server.war TEMP_DIR/IBAMOE-8.0-KS8/kie-server.war directory to EAP_HOME/standalone/deployments/.

Copy the contents of the TEMP_DIR/IBAMOE-8.0-KS8/IBAMOE-8.0-KS8/SecurityPolicy/ TEMP_DIR/IBAMOE-8.0-KS8/IBAMOE-8.0-KS8/SecurityPolicy/ to EAP_HOME/bin.

When prompted to overwrite files, click Replace.

In the EAP_HOME/standalone/deployments/ directory, create an empty file named kie-server.war.dodeploy. This file ensures that KIE Server is automatically deployed when the server starts.

Complete the following steps to prepare your database:

Open EAP_HOME/standalone/configuration/standalone-full.xml in a text editor and locate the <system-properties> tag.

Add the following properties to the <system-properties> tag where <DATASOURCE> is the JNDI name of your data source and <HIBERNATE_DIALECT> is the hibernate dialect for your database.

<property name="org.kie.server.persistence.ds" value="<DATASOURCE>"/>
<property name="org.kie.server.persistence.dialect" value="<HIBERNATE_DIALECT>"/>

<system-properties>
    <property name="org.kie.server.repo" value="${jboss.server.data.dir}"/>
    <property name="org.kie.example" value="true"/>
    <property name="org.jbpm.designer.perspective" value="full"/>
    <property name="designerdataobjects" value="false"/>
    <property name="org.kie.server.user" value="bamoeUser"/>
    <property name="org.kie.server.pwd" value="bamoe123!"/>
    <property name="org.kie.server.location" value="http://localhost:8080/kie-server/services/rest/server"/>
    <property name="org.kie.server.controller" value="http://localhost:8080/business-central/rest/controller"/>
    <property name="org.kie.server.controller.user" value="kieserver"/>
    <property name="org.kie.server.controller.pwd" value="kieserver1!"/>
    <property name="org.kie.server.id" value="local-server-123"/>

    <!-- Data source properties. -->
    <property name="org.kie.server.persistence.ds" value="java:jboss/datasources/KieServerDS"/>
    <property name="org.kie.server.persistence.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/>
</system-properties>

To change IBM Business Automation Manager Open Editions from using property-based user storage to file-based user storage, complete the following steps:

In a terminal application, navigate to the EAP_HOME/bin directory.

Create a user with the admin, rest-all, and kie-server roles that you will use to log in to Business Central.

Create a user with the admin, rest-all, and kie-server roles.

$ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password=<PASSWORD>}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[admin,rest-all,kie-server])"

Create a user with the kie-server role that you will use to log in to KIE Server.

$ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[kie-server])"

Make a note of your user names and passwords.

Optional: If you installed Business Central and KIE Server in the same server instance, you can create a single user that has both of these roles:

$ ./bin/jboss-cli.sh --commands="embed-server --std-out=echo,/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>),/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'}),/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[admin,rest-all,kie-server])"

Optional: To create several users at one time, create a file that contains the user data and run the following command, where <USER_DATA>.cli is the file that contains the user data:

$ ./bin/jboss-cli.sh --file=<USER_DATA>.cli

embed-server --std-out=echo

# first user
/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity(identity=<USERNAME>)
/subsystem=elytron/filesystem-realm=ApplicationRealm:set-password(identity=<USERNAME>, clear={password='<PASSWORD>'})
/subsystem=elytron/filesystem-realm=ApplicationRealm:add-identity-attribute(identity=<USERNAME>, name=role, value=[admin,role,group])

# second user
...

In your IBM Business Automation Manager Open Editions installation directory, navigate to the standalone-full.xml file. For example, if you use a Red Hat JBoss EAP installation for IBM Business Automation Manager Open Editions, go to $EAP_HOME/standalone/configuration/standalone-full.xml.

Open the standalone-full.xml file and under the <system-properties> tag, set the following JVM properties:

<property name="org.kie.server.id" value="default-kie-server"/>
<property name="org.kie.server.controller" value="http://localhost:8080/business-central/rest/controller"/>
<property name="org.kie.server.controller.user" value="controllerUser"/>
<property name="org.kie.server.controller.pwd" value="controllerUser1234;"/>
<property name="org.kie.server.location" value="http://localhost:8080/kie-server/services/rest/server"/>

<property name="org.kie.server.user" value="controllerUser"/>
<property name="org.kie.server.pwd" value="controllerUser1234;"/>

To verify that KIE Server starts successfully, send a GET request to http://SERVER:PORT/kie-server/services/rest/server/ when KIE Server is running. For more information about running IBM Business Automation Manager Open Editions on KIE Server, see Running IBM Business Automation Manager Open Editions.

<response type="SUCCESS" msg="Kie Server info">
    <kie-server-info>
        <capabilities>KieServer</capabilities>
        <capabilities>BRM</capabilities>
        <capabilities>BPM</capabilities>
        <capabilities>CaseMgmt</capabilities>
        <capabilities>BPM-UI</capabilities>
        <capabilities>BRP</capabilities>
        <capabilities>DMN</capabilities>
        <capabilities>Swagger</capabilities>
        <location>http://localhost:8230/kie-server/services/rest/server</location>
        <messages>
            <content>Server KieServerInfo{serverId='first-kie-server', version='7.5.1.Final-redhat-1', location='http://localhost:8230/kie-server/services/rest/server', capabilities=[KieServer, BRM, BPM, CaseMgmt, BPM-UI, BRP, DMN, Swagger]}started successfully at Mon Feb 05 15:44:35 AEST 2018</content>
            <severity>INFO</severity>
            <timestamp>2018-02-05T15:44:35.355+10:00</timestamp>
        </messages>
        <name>first-kie-server</name>
        <id>first-kie-server</id>
        <version>7.5.1.Final-redhat-1</version>
    </kie-server-info>
</response>

Verify successful registration:

In your IBM Business Automation Manager Open Editions installation directory, navigate to the standalone-full.xml file. For example, if you use a Red Hat JBoss EAP installation for IBM Business Automation Manager Open Editions, go to $EAP_HOME/standalone/configuration/standalone-full.xml.

Open the standalone-full.xml file.

Under the <system-properties> tag, set the value of the following JVM properties to the number of CPUs plus one:

Navigate to the IBM Business Automation Manager Open Editions 8.0 downloads page and follow the instructions to download IBM Business Automation Manager Open Editions 8.0 - Add-ons.

Extract the IBAMOE-8.0-AO.zip file. The bamoe-8.0.2-controller-ee7.zip file is in the extracted directory.

Extract the bamoe-8.0.2-controller-ee7.zip archive to a temporary directory. In the following examples this directory is called TEMP_DIR.

Copy the TEMP_DIR/bamoe-8.0.2-controller-ee7/controller.war directory to EAP_HOME/standalone/deployments/.

Copy the contents of the TEMP_DIR/bamoe-8.0.2-controller-ee7/SecurityPolicy/ directory to EAP_HOME/bin.

When prompted to overwrite files, select Yes.

In the EAP_HOME/standalone/deployments/ directory, create an empty file named controller.war.dodeploy. This file ensures that the headless IBM Business Automation Manager controller is automatically deployed when the server starts.

In a terminal application, navigate to EAP_HOME/bin.

If you installed the headless IBM Business Automation Manager controller on the same Red Hat JBoss EAP instance as the Red Hat JBoss EAP instance where you installed KIE Server, enter one of the following commands:

If you installed the headless IBM Business Automation Manager controller on a separate Red Hat JBoss EAP instance from the Red Hat JBoss EAP instance where you installed KIE Server, start the headless IBM Business Automation Manager controller with the standalone.sh script:

To verify that the headless IBM Business Automation Manager controller is working on Red Hat JBoss EAP, enter the following command where <CONTROLLER> and <CONTROLLER_PWD> is the user name and password combination that you created in Creating a headless IBM Business Automation Manager controller user. The output of this command provides information about the KIE Server instance.

curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H  "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'

Declare the IBM Business Automation Manager Open Editions BOM in the pom.xml file:

<dependencyManagement>
 <dependencies>
  <dependency>
   <groupId>com.redhat.ba</groupId>
   <artifactId>ba-platform-bom</artifactId>
   <version>8.0.4.redhat-00001</version>
   <type>pom</type>
   <scope>import</scope>
  </dependency>
 </dependencies>
</dependencyManagement>
<dependencies>
<!-- Your dependencies -->
</dependencies>

Declare dependencies required for your project in the <dependencies> tag. After you import the product BOM into your project, the versions of the user-facing product dependencies are defined so you do not need to specify the <version> sub-element of these <dependency> elements. However, you must use the <dependency> element to declare dependencies which you want to use in your project.

For standalone projects that are not authored in Business Central, specify all dependencies required for your projects. In projects that you author in Business Central, the basic decision engine and process engine dependencies are provided automatically by Business Central.

Create a Maven settings.xml file with connection and access details for your external repository. For details about the settings.xml file, see the Maven Settings Reference.

Save the file in a known location, for example, /opt/custom-config/settings.xml.

In your IBM Business Automation Manager Open Editions installation directory, navigate to the standalone-full.xml file. For example, if you use a Red Hat JBoss EAP installation for IBM Business Automation Manager Open Editions, go to $EAP_HOME/standalone/configuration/standalone-full.xml.

Open standalone-full.xml and under the <system-properties> tag, set the kie.maven.settings.custom property to the full path name of the settings.xml file.

<property name="kie.maven.settings.custom" value="/opt/custom-config/settings.xml"/>

Start or restart Business Central and KIE Server.

On the computer that has an outgoing connection to the public Internet, complete the following steps:

Navigate to the IBM Business Automation Manager Open Editions 8.0 downloads page and follow the instructions to download the Business Automation Manager Open Editions 8.0 - Offline Repository Builder product deliverable file.

Extract the contents of the Business Automation Manager Open Editions 8.0 - Offline Repository Builder product deliverable file into any directory.

Change to the directory and enter the following command:

./offline-repo-builder.sh offliner.txt

If you developed services outside of Business Central and they have additional dependencies, add the dependencies to the mirror repository. If you developed the services as Maven projects, you can use the following steps to prepare these dependencies automatically. Complete the steps on the computer that has an outgoing connection to the public Internet.

Copy the contents of the repository subdirectory to a directory on the computer on which you deployed IBM Business Automation Manager Open Editions. This directory becomes the offline Maven mirror repository.

Create and configure a settings.xml file for your IBM Business Automation Manager Open Editions deployment as described in Configuring an external Maven repository for Business Central and KIE Server.

Make the following changes in the settings.xml file:

Set the kie.maven.offline.force property for Business Central to true. For instructions about setting properties for Business Central, see Installing and configuring IBM Business Automation Manager Open Editions on Red Hat JBoss EAP 7.4.

Start Red Hat JBoss EAP and open Business Central in a web browser.

Copy an SVG format image to the EAP_HOME/standalone/deployments/business-central.war/img/ directory in your IBM Business Automation Manager Open Editions installation.

In the EAP_HOME/standalone/deployments/business-central.war/img/ directory, either move or rename the existing redhat_logo.png file.

Rename your PNG file redhat_logo.png.

To change the project logo that appears above the User name and Password fields, replace the default image BC_Logo.png with a new SVG file.

Force a full reload of the login page, bypassing the cache, to view the changes. For example, in most Linux and Windows web browsers, press Ctrl+F5.

Start Red Hat JBoss EAP, open Business Central in a web browser, and log in with your user credentials.

Copy your new application header image in the SVG format to the EAP_HOME/standalone/deployments/business-central.war/banner/ directory in your IBM Business Automation Manager Open Editions installation.

Open the EAP_HOME/standalone/deployments/business-central.war/banner/banner.html file in a text editor.

Replace logo.png in the <img> tag with the file name of your new image:admin-and-config/

<img src="banner/logo.png"/>

Force a full reload of the login page, bypassing the cache, to view the changes. For example, in most Linux and Windows web browsers, press Ctrl+F5.