1. Go to the Red Hat Customer Portal 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 EAP 6.1.1 and then click Download.

1. Move the downloaded zip archive to the parent directory of the Red Hat JBoss Enterprise Application Platform home directory (EAP_HOME; the jboss-eap-6.1 directory).
2. Unzip the downloaded zip archive: make sure it is merged into the EAP_HOME directory (jboss-eap-6.1).

   Warning

   This step must be performed by the same user account that was used to install EAP. This account must not be a superuser account.
3. It is necessary to overwrite the files that already exist in the EAP_HOME directory with their versions from the downloaded zip archive. When prompted to do so, accept overwriting the original files.

1. Download the zip archive and prepare to manually merge files into the Red Hat JBoss Enterprise Application Platform home directory (EAP_HOME; the jboss-eap-6.1 directory).
2. Unzip the downloaded zip archive; however, do not overwrite all of the files. Manually merge the following files into the EAP_HOME directory (jboss-eap-6.1):
   • jboss-eap-6.1/domain/configuration/*
   • jboss-eap-6.1/standalone/configuration/*
   • jboss-eap-6.1/modules/layers.conf
   • jboss-eap-6.1/bin/product.conf

   Warning

   Make sure this step is performed by the same user account that was used to install EAP. This account must not be a superuser account.
3. Ensure the target EAP does not include a deployment with a colliding name. Copy the folder jboss-eap-6.1/standalone/deployments into the EAP_HOME directory from the BRMS distribution.
4. Make sure no EAP module layer is already called BRMS and copy the folder jboss-eap-6.1/modules/system/layers/brms into the EAP 6.1.1 folder.

1. Run ./add-user.sh on a Unix system or add-user.bat on a Windows system from the bin directory.
2. Enter b to select an Application User at the type of user prompt and press Enter.
3. Accept the default Realm (ApplicationRealm): by pressing Enter.
4. At the username prompt, enter a user name and confirm. For example: helloworlduser.
5. Create the user's password at the password prompt and reenter the password. For example: Helloworld@123.

   Note

   The password should be at least 8 characters in length and should contain upper and lower case alphabetic characters (e.g. A-Z, a-z), at least one numerical character (e.g. 0-9) and at least one special character (e.g. ~ ! @ # $ % ^ * ( ) - _ + =).
6. Enter a comma separate list of roles the user will need at the roles prompt (refer to Section 3.3, “Defining Roles”).
   Business Central users need to have the analyst or the admin role.
7. Confirm you want to add the user.
8. Enter yes at the next prompt (this is to enable clustering in the future if required).

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.

1. On the command line, move into the $SERVER_HOME/bin/ directory.
2. In a Unix environment run:

   ./standalone.sh

   In a Windows environment run:

   ./standalone.bat

1. On the command line, move into the $SERVER_HOME/bin/ directory.
2. In a Unix environment run:

   ./standalone-secure.sh

   In a Windows environment run:

   ./standalone-secure.bat

1. Open Business Central in your web browser (if running locally http://localhost:8080/business-central) and log in as a user with the admin role (helloworlduser).
2. Create an organizational unit in the Artifact repository:
   1. Go to Authoring → Administration.
   2. On the perspective menu, click Organizational Units → Manage Organizational Units.
   3. In the displayed Organizational Unit Manager view, click Add.
      In the displayed Add New Organizational Unit dialog box, define the unit properties and click OK:
      • Name: helloworld
      • Owner: helloworlduser
3. Create a new repository in the helloworld organizational unit:
   1. Go to Authoring → Administration.
   2. On the perspective menu, click Repositories → New repository.
   3. In the displayed Create Repository dialog box, define the repository properties:
      • Repository Name: helloworldrepo
      • Organizational Unit: helloworld
4. Go to Authoring → Project Authoring.
5. In the Project Explorer in the organizational unit drop-down box, select helloworld, and in the repository drop-down box select helloworldrepo.
   

   Figure 5.1. Selecting the helloworldrepo repository in the helloworld organizational unit in Project Explorer

6. Create a project in the helloworld repository:
   1. On the perspective menu, go to New Item → Project
   2. In the displayed Create new dialog box, define your Project properties:
      • Resource Name (project name): HelloWorld
      • Path: default://master@helloworldrepo/
   3. In the New Project Wizard dialog, define the maven properties of the Project. Press Enter after making each entry:
      • Group ID: org.brms
      • Artifact ID: HelloWorld
      • Version ID: 1.0
   4. Click Finish.

1. In Project Explorer, select the helloworld organizational unit, the helloworldrepo repository, the HelloWorld project, and the default package.

   Note

   Make sure to select the default package. Selection of an incorrect package causes the deployment to fail.
2. Create the DRL file:
   1. On the perspective menu, click New Item → DRL file.
   2. In the Create new dialog box, define the resource name as helloworldrule and check that the destination path is default://master@helloworldrepo/HelloWorld/src/main/resources.
   3. Click OK.
3. In the displayed DRL editor with the helloworldrule.drl file, define the rule:

   rule "helloworldrule"
   ruleflow-group "helloworldgroup"
   when 
   then
   	System.out.println("Hello World!");
   end
   

   This rule does not define any when condition, that is, it will always be true when fired (called to execute) and the Hello World! phrase will be printed.
4. Click Save.
5. A Save this item prompt is displayed. Enter the Check-in comment and click Save.

   Note

   The check-in comment would be a short description of the kind of change you made and has to be entered every time an asset is saved.

1. On the main menu of Business Central, go to Authoring → Project Authoring.
2. In the Project Explorer, locate the Hello World project.
3. Open the Project in the Project editor: on the perspective menu, click Tools → Project Editor.
4. Check that the correct Project details are displayed on the Project Screen and click the Build & Deploy button in the upper right hand corner of the Project Screen view.
   

   Figure 5.2. Project editor with the helloWorld project properties

Procedure 6.1. Install the Drools JBoss Developer Studio Plug-in

1. Start JBoss Developer Studio.
2. Select Help → Install New Software.
3. Click Add to enter the Add Repository menu.
4. Give the software site a name next to Name field and add the following url in the Location field: https://devstudio.jboss.com/updates/7.0/integration-stack/
5. Click OK
6. Select the JBoss Business Process and Rule Development feature from the available options and click Next and then Next again.
7. Read the license and accept it by selecting the appropriate radio button, and click Finish.
8. After installation of the plug-ins has completed, restart JBoss Developer Studio.

Procedure 6.2. Configure BRMS Runtime

1. From the JBoss Developer Studio menu, select Window and click Preferences.
2. Select Drools → Installed Drools Runtimes.
3. Click Add...; provide a name for the new runtime, and click Browse to navigate to the directory where the runtime is located. Click OK to register the selected runtime in JBDS.
4. Mark the runtime you have created as the default Drools runtime by clicking on the check box next to it.
5. Click OK. If you have existing projects, a dialog box will indicate that you have to restart JBoss Developer Studio to update the Runtime.

Procedure 6.3. Configure the Server

1. Open the Drools view by selecting Window → Open Perspective → Other and select Drools and click OK.
2. Add the server view by selecting Window → Show View → Other... and select Server → Servers.
3. Open the server menu by right clicking the Servers panel and select New → Server.
4. Define the server by selecting JBoss Enterprise Middleware → JBoss Enterprise Application Platform 6.1+ and clicking Next.
5. Set the home directory by clicking the Browse button. Navigate to and select the installation directory for JBoss EAP 6.1.1 which has JBoss BRMS installed.
6. Provide a name for the server in the Name field, make sure that the configuration file is set, and click Finish.

Procedure 6.4. Cloning a Remote Git Repository

1. Start the Red Hat JBoss BRMS server (if not already running) by selecting the server from the server tab and click the start icon.
2. Simultaneously, start the Secure Shell server, if not running already, by using the following command. The command is Linux and Mac specific only. On these platforms, if sshd has already been started, this command will fail and you may safely ignore this step.

   /sbin/service sshd start

3. In JBoss Developer Studio, select File → Import... and navigate to the Git folder. Open the Git folder to select Projects from Git and click Next.
4. Select the repository source as Clone URI and click Next.
5. Enter the details of the Git repository in the next window and click Next.

   

   Figure 6.1. Git Repository Details

6. Select which branch you want to import in the following window and click Next.
7. You will be presented with the option to define the local storage for this project. Enter (or select) a non-empty directory, make any configuration changes and click Next.
8. Import the project as a general project in the following window and click Next. Name the project and click Finish.

Procedure 6.5. Importing a Local Git Repository

1. Start the Red Hat JBoss BRMS server (if not already running) by selecting the server from the server tab and click the start icon.
2. In JBoss Developer Studio, select File → Import... and navigate to the Git folder. Open the Git folder to select Projects from Git and click Next.
3. Select the repository source as Existing local repository and click Next.
   

   Figure 6.2. Git Repository Details

4. Select the repository that is to be configured from the list of available repositories and click Next.
5. In the dialog that opens, select the radio button Import as general project from the Wizard for project import group and click Next. Name the project and click Finish.

   

   Figure 6.3. Wizard for Project Import

Procedure 6.6. Creating a New Red Hat JBoss Developer Studio Project

1. From the main menu, select File → New → Project.
   Select Drools → Drools Project and click Next.
2. Enter a name for the project into the Project name: text box and click Next.

   Note

   JBoss Developer Studio provides the option to add a sample HelloWorld Rule file to the project. Accept this default by clicking Next to test the sample project in the following steps.
3. Select the Drools runtime (or use the default).
4. Select code compatible with Drools 6.0.x. Enter a GroupID, an ArtifactID, and Version, and click Finish.
5. To test the project, right click the Java file that contains the main method and select Run → run as → Java Application.
   The output will be displayed on the console tab.

1. Navigate to the Red Hat Customer Portal and log in with your user credentials.
2. Select Downloads → Red Hat JBoss Middleware → Download Software.
3. From the Products drop-down menu, select BPM Suite.
4. From the Version drop-down menu, select the product version 6.0.2.
5. Select Red Hat JBoss BPM Suite 6.0.2 Business Resource Planner and then click Download.

1. On the command line, move into the examples/ directory.
2. In a Unix environment, run the following command:

   ./runExamples.sh

   In a Windows environment, run the following command:

   ./runExamples.bat

3. Pick an example from the Examples GUI application that opens and run it in your favorite IDE.