3.5. Installing Red Hat JBoss BRMS on Red Hat JBoss Web Server

Procedure 3.1. Installing the Generic Deployable Package

1. To download the generic deployable package zip file from the Red Hat Customer Support Portal, go to https://access.redhat.com and log in.
2. Click Downloads Products Downloads.
3. In the Product Downloads page that opens, click Red Hat JBoss BRMS.
4. From the Version drop-down menu, select version 6.0.3
5. Select Red Hat JBoss BRMS 6.0.3 Deployable for All Supported Containers package and then click Download.
6. Extracting the downloaded archive creates the following zip archives:
   • jboss-brms-engine.zip
   • jboss-brms-manager.zip
7. Extract business-central.war from the jboss-brms-manager.zip archive and copy to tomcat7/webapps/.
8. Remove the .war extension from the business-central.war so that directory is now called business-central.
9. Define the users and the roles in tomcat7/conf/tomcat-users.xml as shown below:

     <role rolename="admin"/>
     <role rolename="analyst"/>
     <user username="user" password="password" roles="admin,analyst"/>

10. Edit the web.xml file in the tomcat7/webapps/business-central/WEB-INF directory by uncommenting all entries that are marked with TOMCAT-JEE-SECURITY. For example:

    <!-- TOMCAT-JEE-SECURITY -->
        <!--
        <init-param>
          <param-name>org.uberfire.auth.scheme</param-name>
          <param-value>org.uberfire.security.server.auth.JACCAuthenticationScheme</param-value>
        </init-param>
        -->
    
    

    Should be uncommented like the following:

    <!-- TOMCAT-JEE-SECURITY -->
    
        <init-param>
          <param-name>org.uberfire.auth.scheme</param-name>
          <param-value>org.uberfire.security.server.auth.JACCAuthenticationScheme</param-value>
        </init-param>
    
    

11. Copy the kie-tomcat-integration-VERSION.jar file from business-central/WEB-INF/lib in BRMS distribution to tomcat7/lib.
12. Copy the slf4j-api-VERSION.jar file and the slf4j-ext-VERSION.jar file from business-central/WEB-INF/lib in BRMS distribution to tomcat7/lib.
13. Download the file below and place it in the tomcat7/lib directory.
    • javax.security.jacc-api.jar
14. Add the below Tomcat Valve declaration into tomcat7/conf/server.xml (inside the relevant <host> element):

    <Valve className="org.kie.integration.tomcat.JACCValve"/>

15. Rename org.uberfire.security.auth.AuthenticationSource to org.uberfire.security.auth.AuthenticationSource-ORIGIN and org.uberfire.security.auth.AuthenticationSource-TOMCAT-JEE-SECURITY to org.uberfire.security.auth.AuthenticationSource inside the business-central/WEB-INF/classes/META-INF/services
16. Start JBoss Web Server by running startup.sh in the tomcat7/bin directory.

    ./startup.sh

17. Navigate to http://localhost:8080/business-central in a web browser.
18. Login with the correct username/password as given in the tomcat-users.xml file where you defined user roles.