1. Open the DOWNLOADS section of the Red Hat Customer Portal in your browser.
2. In the Product Downloads page that opens, click Red Hat JBoss BRMS and log in.
3. From the Version drop-down menu, select version 6.4.
4. Select Red Hat JBoss BRMS 6.4.0 Deployable for EAP 6 and click Download. If you use Red Hat JBoss EAP 7.0, select Red Hat JBoss BRMS 6.4.0 Deployable for EAP 7.

Procedure: Creating New Users

1. Change into the EAP_HOME directory.

2. On a Unix system, run the following command:

   bin/add-user.sh

   On a Windows system, run:

   bin\add-user.bat

3. Enter b to select the application user and press Enter.
4. Accept the default realm (ApplicationRealm) by pressing Enter.

5. At the user name prompt, enter the user name and confirm. For example: helloworlduser.

   Important

   Make sure that the selected user name does not conflict with any known title of a role or a group.

   For example, if there is a role called admin, do not create a user with the user name admin.

6. Create the user 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 (A-Z, a-z), at least one numerical character (0-9) and at least one special character (for example ~ ! @ # $ % ^ * ( ) - _ + =).

7. Enter a comma-separated list of roles the user will need at the roles prompt. For more information, see Section 2.3, “Defining Roles”.

   Note that Business Central users need to have the analyst or the admin role assigned.

8. Confirm that you want to add the user.
9. Enter yes at the next prompt to enable clustering in the future.

1. On the command line, change into the EAP_HOME directory:

2. In a Unix environment run:

   bin/standalone.sh

   In a Windows environment run:

   bin\standalone.bat

1. On the command line, move into the EAP_HOME directory.

2. In a Unix environment run:

   bin/standalone-secure.sh

   In a Windows environment run:

   bin\standalone-secure.bat

Procedure: Create and Execute Your First Rule Using Business Central

1. On the main menu of Business Central, click Authoring → Administration and then Organizational Unit → Manage Organizational Units.
2. Click Add.

3. In the displayed Add New Organizational Unit dialog box, define the unit properties. For example:

   • Name: Hello World
   • Owner: finance-dept@company.org

   Click OK.

4. On the perspective menu, click Repositories → New repository.

5. In the displayed New Repository dialog box, define the repository properties. For example:

   • Repository Name: EmployeeRepo
   • In the In Organizational Unit drop-down menu, select Hello World.

   Click Finish.

6. Go to Authoring → Project Authoring.
7. In the Project Explorer, under the organizational unit drop-down box, select Hello World, and in the repository drop-down box select EmployeeRepo.
8. On the perspective menu, go to New Item → Project.

9. In the displayed New Project wizard, provide a name (for example MyProject) for your project. In the Group Artifact Version part of the wizard, define the Maven properties of the project. For example:

   • Group ID: org.brms
   • Artifact ID: MyProject
   • Version ID: 1.0.0

   Click Finish.

10. On the perspective menu, go to New Item → Data Object.

11. In the displayed Create new Data Object dialog box, provide the values for object name and package. For example:

    • Data Object: Person
    • Package: org.brms.myproject

    Click Ok.

12. In the displayed Person window of the newly created Person data object, click add field to open the New field dialogue. Add a variable name in the Id field, select data type for the variable in the Type field, and click Create and continue until you have defined all the necessary variables. For example:

    • Id: firstName

      Type: String

    • Id: lastName

      Type: String

    • Id: hourlyRate

      Type: Integer

    • Id: wage

      Type: Integer

    Click Create for the last variable and then Save.

13. On the perspective menu, click New Item → DRL File.

14. In the Create new dialog box, provide the name and package name of your rule file. For example:

    • DRL file name: MyRule
    • Package: org.brms.myproject

    Click Ok.

15. In the displayed DRL editor with MyRule.drl, create the rule:

    package org.brms.myproject;
    rule "MyRule"
    when
    
      Person(hourlyRate*wage > 100)
      Person(name : firstName, surname : lastName)
    
    then
      System.out.println( "Hello" + " " + name + " " + surname + "!" );
      System.out.println( "You are rich!" );
    
    end

    Click Save.

    For more information about rules, see chapter All About Rules of the Red Hat JBoss BPM Suite Development Guide.

16. Following steps demonstrate how to create your own knowledge base. For more information about knowledge session, see the KIE Sessions chapter from the Red Hat JBoss BPM Suite Development Guide.

    1. Click Open Project Editor.
    2. Click Project Settings: Project General Settings → Knowledge Base Settings: Knowledge bases and sessions.

    3. Click Add and enter the name of your knowledge base.

       Enter myBase for this example.

    4. Click Make Default
    5. Click Add under Knowledge Sessions.
    6. Enter the name of your session. For example mySession. Check Default and select the stateless state.
    7. Click Save in the top right corner.

17. Click Open Project Editor and then Build & Deploy.

    A green notification appears in the upper part of the screen informing you that the project has been built and deployed successfully to the Execution Server.

    Note

    In case a red notification appears, informing you that the build has failed, you will be presented with information about the build failure in the Red Hat JBoss BRMS console. This is crucial information in case of troubleshooting your application. Make sure you have saved all assets before attempting to build your project.

Procedure: Registering Realtime Decision Server

1. Create a new user with the role kie-server:

   On the command line, change into EAP_HOME/bin/ and execute the following command:

   ~]$ ./add-user.sh -a --user kieserver --password kieserver1! --role kie-server,rest-all

2. Open EAP_HOME/standalone/configuration/standalone.xml and add the following properties into the system-properties tag:

   <property name="org.kie.server.user"
             value="kieserver"></property>
   <property name="org.kie.server.pwd"
             value="kieserver1!"></property>
   <property name="org.kie.server.location"
             value="http://localhost:8080/kie-server/services/rest/server"></property>
   <property name="org.kie.server.controller"
             value="http://localhost:8080/business-central/rest/controller"></property>
   <property name="org.kie.server.controller.user"
             value="kieserver"></property>
   <property name="org.kie.server.controller.pwd"
             value="kieserver1!"></property>
   <property name="org.kie.server.id"
             value="local-server-123"></property>

3. Change into EAP_HOME/bin/ and execute the following command:

   ~]$ ./standalone.sh

4. In the Business Central, click Deploy → Execution Servers.

   In the displayed window, you will see local-server-123. Click Add Container under KIE CONTAINERS.

5. The New Container dialog opens. Enter the following:

   • Name: myContainer
   • Click Search and click Select next to MyProject-1.0.0.jar.
   • Click Finish to create the container.
6. Select myContainer and click Start to start the container.

1. Change into a directory of your choice and execute the following command:

   ~]$ mvn archetype:generate -DgroupId=com.MyProject.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

   This creates a directory called my-app with the following structure:

   my-app
   |-- pom.xml
   `-- src
       |-- main
       |   `-- java
       |       `-- com
       |           `-- MyProject
       |               `-- app
       |                   `-- App.java
       `-- test
           `-- java
               `-- com
                   `-- MyProject
                       `-- app
                           `-- AppTest.java

2. Declare libraries your Maven project will use. Edit my-app/pom.xml to set the Red Hat JBoss BRMS dependencies. For more information about Bill of Material (BOM) and dependency management, see chapter Dependency Management of the Red Hat JBoss BPM Suite Development Guide.

   <!-- Declaration of BOM -->
   <dependencyManagement>
   <dependencies>
     <dependency>
       <groupId>org.jboss.bom.brms</groupId>
       <artifactId>jboss-brms-bpmsuite-platform-bom</artifactId>
       <version>6.4.0.GA-redhat-2</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
   </dependencies>
   </dependencyManagement>
   <dependencies>
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
       <scope>test</scope>
     </dependency>
   <!-- Realtime Decision Server dependencies -->
     <dependency>
       <groupId>org.kie.server</groupId>
       <artifactId>kie-server-client</artifactId>
     </dependency>
     <dependency>
       <groupId>org.kie.server</groupId>
       <artifactId>kie-server-api</artifactId>
     </dependency>
   <!-- Red Hat JBoss BRMS dependency. -->
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-core</artifactId>
     </dependency>
   
     <dependency>
       <groupId>org.slf4j</groupId>
       <artifactId>slf4j-simple</artifactId>
     </dependency>
   <!-- Your project -->
     <dependency>
       <groupId>org.brms</groupId>
       <artifactId>MyProject</artifactId>
       <version>1.0.0</version>
     </dependency>
   </dependencies>

   Note

   The last dependency is the project you have built in Red Hat JBoss BRMS. The model class (org.brms.myproject.Person in this example) in the client code, that is your Maven application, needs to match your server side, that is the Red Hat JBoss BRMS. Otherwise, the rules will not match when sending a request. The easiest way to achieve this is to share the model class between both sides. You achieve this by adding it as a Maven dependency.

   Therefore, make sure that the following attributes match what you had entered while creating a new project in the Business Central:

   • groupId
   • artifactId
   • version
3. Locate the my-app/src/test/java/com/MyProject/app/AppTest.java Java class. Maven creates this class by default.

4. Edit AppTest.java. Add the following imports:

   import org.kie.api.command.BatchExecutionCommand;
   import org.kie.server.api.model.ServiceResponse;
   import org.kie.server.client.KieServicesClient;
   import org.kie.server.client.KieServicesConfiguration;
   import org.kie.server.client.KieServicesFactory;
   import org.kie.server.client.RuleServicesClient;
   import org.kie.api.KieServices;
   import org.kie.api.command.Command;
   
   import java.util.ArrayList;
   import java.util.HashSet;
   import java.util.List;
   import java.util.Set;
   
   import org.brms.myproject.Person;
   import org.drools.core.command.impl.GenericCommand;

   Locate the testApp() method, load the knowledge base and fire your rule by adding the following code:

   Person p1 = new Person();
   p1.setFirstName("Anton");
   p1.setLastName("RedHat");
   p1.setHourlyRate(11);
   p1.setWage(20);
   
   String url = "http://localhost:8080/kie-server/services/rest/server";
   String username = "kieserver";
   String password = "kieserver1!";
   String container = "myContainer";
   String session = "mySession";
   
   KieServicesConfiguration config = KieServicesFactory
     .newRestConfiguration(url, username, password);
   Set<Class<?>> allClasses = new HashSet<Class<?>>();
   allClasses.add(Person.class);
   config.addExtraClasses(allClasses);
   
   KieServicesClient client  = KieServicesFactory.newKieServicesClient(config);
   RuleServicesClient ruleClient = client.getServicesClient(RuleServicesClient.class);
   List<GenericCommand<?>> commands = new ArrayList<GenericCommand<?>>();
   
   commands.add((GenericCommand<?>) KieServices.Factory
     .get().getCommands().newInsert(p1,"Person Insert ID"));
   commands.add((GenericCommand<?>) KieServices.Factory
     .get().getCommands().newFireAllRules("fire-identifier"));
   
   BatchExecutionCommand batchCommand = KieServices.Factory
     .get().getCommands().newBatchExecution(commands,session);
   ServiceResponse<String> response = ruleClient.executeCommands(container, batchCommand);
   System.out.println(response.getResult());

   Note that the default marshaller is JAXB, unless set differently. That means you must set its context with any custom classes you plan to use. In this example, that is Person.class. Since the example uses a stateless session, the kie session is disposed of once a single command is executed. That is why you need to wrap multiple commands in the BatchCommand object.

   To change the marshaller type, enter one of the following commands:

   config.setMarshallingFormat(MarshallingFormat.JSON);

   config.setMarshallingFormat(MarshallingFormat.XSTREAM);

   And add the following import:

   import org.kie.server.api.marshalling.MarshallingFormat;

5. Navigate to my-app and execute the following command from the command line:

   ~]$ mvn clean install

   Note that there is the Maven output and the Red Hat JBoss BRMS output. The expected output in the Red Hat JBoss BRMS console is:

   16:26:56,119 INFO  [stdout] (http-/127.0.0.1:8080-5) Hello Anton RedHat!
   16:26:56,119 INFO  [stdout] (http-/127.0.0.1:8080-5) You are rich!

Procedure: Installing Drools Red Hat JBoss Developer Studio Plug-in

1. Start Red Hat JBoss Developer Studio.
2. Click 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/10.0/stable/updates/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, accept it by selecting the appropriate radio button, and click Finish.
8. After the installation completes, restart Red Hat JBoss Developer Studio.

Procedure: Configuring Red Hat JBoss BRMS Runtime

1. Open the DOWNLOADS section of the Red Hat Customer Portal.
2. Click Red Hat JBoss BRMS and log in.
3. Download the Red Hat JBoss BRMS 6.4.0 Core Engine archive.
4. Extract the runtime JAR files located in the jboss-brms-VERSION-engine.zip.
5. From the Red Hat JBoss Developer Studio menu, click Window → Preferences.
6. Click Drools → Installed Drools Runtimes.
7. Click Add…​; provide a name for the new runtime, and click Browse to navigate to the directory where you extracted the runtime files. Click OK to register the selected runtime in Red Hat JBoss Developer Studio.
8. Mark the runtime you have created as the default Drools runtime by clicking on the check box next to it.
9. Click OK. If you have existing projects, a dialog box will indicate that you have to restart Red Hat JBoss Developer Studio to update the Runtime.

Procedure: Configuring Server

1. Open the Drools view by clicking Window → Perspective → Open Perspective → Other, then Drools, and click OK.
2. Add the Server view by clicking Window → Show View → Other…​ and then 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. Click JBoss EAP 6.4 Runtime and select Create new runtime (next page). Click Next.
6. Set the home directory by clicking Browse. Navigate to and select the installation directory for Red Hat JBoss EAP 6.4 which has Red Hat JBoss BRMS installed.
7. Provide a name for the server in the Name field, ensure that the configuration file is set, and click Finish.

Configuring Kie Navigator

1. In Red Hat JBoss Developer Studio, click Window → Show View → Other…​.
2. Type Kie Navigator and select the Kie Navigator option.
3. If you have no server with Red Hat JBoss BRMS configured in your Red Hat JBoss Developer Studio, you will be asked to configure a server first. See Section 5.3, “Configuring Red Hat JBoss BRMS Server” for more information.
4. Right click your server name you want to use and select Properties.
5. Enter username and pasword that has a kie role, for example kie-server.

6. Enter the following:

   • KIE Application Name: business-central
   • HTTP Port: 8080

   • Git Port: 8001

     Note

     The values above are the default values. If you changed the default values of Git or Business Central ports, use your values.

7. Check Use default Git Repository Path and click Apply.
8. Start your server in the Servers tab and wait until the server has started.
9. In the Kie Navigator tab, right click your server name and click Refresh. You will see the contents of the Red Hat JBoss BRMS git repository. Double click a project to import it into your Red Hat JBoss Developer Studio.

Procedure: Cloning Remote Git Repository

1. Start the Red Hat JBoss BRMS server by selecting the server from the Server tab and clicking the start icon.

2. Start the Secure Shell server, if not running already, by using the following command. The command is specific to Linux and Mac environments. If sshd has already been started, this command fails. In that case, you may safely ignore this step.

   /sbin/service sshd start

3. In Red Hat JBoss Developer Studio , click 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 5.1. Git Repository Details

   
6. Select the branch you wish to import in the following window and click Next.
7. 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: Importing Local Git Repository

1. Start the Red Hat JBoss BRMS server by selecting the server from the Server tab and click the start icon.
2. In Red Hat JBoss Developer Studio, click 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 5.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 5.3. Wizard for Project Import

   

Procedure: Creating New Red Hat JBoss Developer Studio Project

1. From the main menu, click File → New → Project.
2. Click Drools → Drools Project and click Next.
3. For now, choose the second option. Red Hat JBoss Developer Studio creates a project with a Red Hat JBoss BRMS example. Click Next.
4. Enter a name for the project into the Project name: text box and click Finish.

1. Navigate to the src/main/java directory and expand the com.sample package.

2. Right click a Java class and select Run As → Java Application.

   The output will be displayed on the console tab.

1. Open the DOWNLOADS section of the Red Hat Customer Portal.
2. Click Red Hat JBoss BRMS and log in.
3. From the Version drop-down menu, select version 6.4.
4. Select Red Hat JBoss BRMS 6.4.0 Business Resource Planner and click Download.

1. On the command line, change into the examples/ directory.

2. In a Unix environment, execute:

   ./runExamples.sh

   In a Windows environment, execute:

   runExamples.bat

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