Chapter 4. Install Red Hat JBoss BRMS on IBM WebSphere 8

Now that the basic configuration is done and IBM WebSphere 8 is set to deploy JBoss BRMS, you can upload the WAR deployable that was extracted earlier.
As noted earlier, the JBoss BRMS zip file for IBM WebSphere 8 contains the deployable WAR file for Business Central.
Let's install Business Central for BRMS on IBM WebSphere 8.

4.1. Install Business Central

Business Central is uploaded as a Web archive and then accessed by a familiar URL: http://target-server/business-central. Start this deployment by installing the Business Central WAR as a WebSphere Application.
  1. In your IBM WebSphere 8 administrative console, open up Applications --> Application Types --> WebSphere enterprise applications. This will show you all the existing applications in the system and allow you to install a new one.
  2. Click the Install button to start the process.
  3. Upload the Business Central war file (business-central.war) from the local file system. See Section 2.2, “Extract Red Hat JBoss BRMS for IBM WebSphere 8”. This process may take some time.
  4. Accept the default choices for most of the options presented including choosing the Fast Path option.
  5. Change Application name to be business-central in Step 1 and click Next.
  6. In Step 2, map the Business Central modules to servers depending upon your requirements.
  7. Accept the default values for rest of the options and set the context root to: business-central. Click the Finish button to install Business Central at the Summary page. This process will take a while. Choose to save to the master configuration at the end of this process.
  8. You will be returned to the WebSphere enterprise applications page where business-central will be a new application listed. However, this application will be stopped at this stage. Before you start it, there are a few application configuration options that need to be done.

  9. Map Groups to Roles

    Click on the business-central application and open up this applications configuration page. Click on Security role to user/group mapping.
    Select the admin role, click Map Groups..., search for the admin group in the next screen (or just press the Search button) and move it from the Available list to the Selected list. Click OK. Mapping this will give the admin user that we created earlier (business-central-admin) access to the Business Central application.
    Do the same for the analyst role and save the configuration.
    If you have other groups or users that should have access to Business Central, use the same steps to map them to the admin or analyst roles.

    Note

    Give this user access to the kie-server role if you are also installing the Realtime Decision Server. Furthermore, map appropriate REST API roles if you will use REST API. For further information about API roles, refer to Chapter 17. Remote API from Red Hat JBoss BPM Suite Development Guide.

  10. Classloading Configuration

    Ensure by going to the Class loading and update detection setting for your business-central application that the parameters Classes loaded with local class loader first (parent last) and Single class loader for application are checked.
  11. Click the OK button, choose to save to master configuration and restart the WebSphere server.

  12. Enable Bouncy Castle Crypto API

    To enable GIT SSH repository cloning and kie-config-cli from within Business Central, the Bouncy Castle Crypto API must be setup. Enable this API by following these steps:
    1. Set the org.apache.sshd.registerBouncyCastle property to true and org.uberfire.domain property to WSLogin. These are custom properties so see Section 3.4, “Add Custom JVM Properties” for details on how to set them.
    2. Setup the Bouncy Castle API as a shared library referenced from Business Central using the appropriate version of Bouncy Castle:
      1. Navigate to Environment → Shared Libraries, choose your scope and then click on the New button to create a new library. Give this library a name and set the classpath to the Bouncy Castle library (bcprov-jdk16-1.46.jar). Click Ok and save the configuration.
      2. Navigate to Applications → Application Types. Open up WebSphere enterprise applications and then click the Business Central application that you have just installed. Click on Shared library references, select the web module, click on Reference shared libraries and select the Bouncy Castle library created in the previous step. Click the Ok button and save the configuration.
You have now successfully installed Business Central on IBM WebSphere 8. Start the application by going back to Applications --> WebSphere enterprise applications page and then selecting business-central checkbox before clicking on the Start button.
To access the application, navigate to http://target-server/business-central.