Chapter 30. Installing and configuring Smart Router

Procedure

1. Navigate to the Software Downloads page in the Red Hat Customer Portal (login required), and select the product and version from the drop-down options:

   • Product: Process Automation Manager
   • Version: 7.11
2. Download Red Hat Process Automation Manager 7.11.0 Add-Ons.
3. Extract the downloaded rhpam-7.11.0-add-ons.zip file to a temporary directory. The rhpam-7.11.0-smart-router.jar file is in the extracted rhpam-7.11.0-add-ons directory.
4. Copy the rhpam-7.11.0-smart-router.jar file to the location where you will run the file.

5. Enter the following command to start Smart Router:

   java
   -Dorg.kie.server.router.host=<ROUTER_HOST>
   -Dorg.kie.server.router.port=<ROUTER_PORT>
   -Dorg.kie.server.controller=<CONTROLLER_URL>
   -Dorg.kie.server.controller.user=<CONTROLLER_USER>
   -Dorg.kie.server.controller.pwd=<CONTROLLER_PWD>
   -Dorg.kie.server.router.config.watcher.enabled=true
   -Dorg.kie.server.router.repo=<NFS_STORAGE>
   -jar rhpam-7.11.0-smart-router.jar

   The properties in the preceding command have the following default values:

   org.kie.server.router.host=localhost
   org.kie.server.router.port=9000
   org.kie.server.controller= N/A
   org.kie.server.controller.user=kieserver
   org.kie.server.controller.pwd=kieserver1!
   org.kie.server.router.repo= <CURRENT_WORKING_DIR>
   org.kie.server.router.config.watcher.enabled=false

   org.kie.server.controller is the URL of the server controller, for example:

   org.kie.server.controller=http://<HOST>:<PORT>/controller/rest/controller

   org.kie.server.router.config.watcher.enabled is an optional settings to enable the watcher service system property.

6. On every KIE Server instance that must connect to the Smart Router, set the org.kie.server.router system property to the Smart Router URL.

7. To access Smart Router from the client side, use the Smart Router URL instead of the KIE Server URL, for example:

   KieServicesConfiguration config = KieServicesFactory.newRestConfiguration("http://smartrouter.example.com:9000", "USERNAME", "PASSWORD");

   In this example, smartrouter.example.com is the Smart Router URL, and USERNAME and PASSWORD are the log in credentials for the Smart Router configuration.

8. To create a new container in an umanaged KIE Server so that you can fill it with example data, send the following HTTP request:

   $ curl -v -X POST -H 'Content-type: application/xml' -H 'X-KIE-Content-Type: xstream' -d @create-container.xml -u ${KIE_CRED} http://${KIE-SERVER-HOST}:${KIE-SERVER-PORT}/kie-server/services/rest/server/config/

9. Review the contents the create-container.xml file:

   <script>
     <create-container>
       <container container-id="example:timer-test:1.1">
         <release-id>
           <group-id>example</group-id>
           <artifact-id>timer-test</artifact-id>
           <version>1.1</version>
         </release-id>
         <config-items>
           <itemName>RuntimeStrategy</itemName>
           <itemValue>PER_PROCESS_INSTANCE</itemValue>
           <itemType></itemType>
         </config-items>
       </container>
     </create-container>
   </script>

   A message about the deployed container is displayed in the Smart Router console. For example:

   INFO: Added http://localhost:8180/kie-server/services/rest/server as server location for container example:timer-test:1.1

10. To display a list of containers, enter the following command:

    $ curl http://localhost:9000/mgmt/list

    The list of containers is displayed:

    {
      "containerInfo": [{
        "alias": "timer-test",
        "containerId": "example:timer-test:1.1",
        "releaseId": "example:timer-test:1.1"
      }],
      "containers": [
        {"example:timer-test:1.1": ["http://localhost:8180/kie-server/services/rest/server"]},
        {"timer-test": ["http://localhost:8180/kie-server/services/rest/server"]}
      ],
      "servers": [
        {"kieserver2": []},
        {"kieserver1": ["http://localhost:8180/kie-server/services/rest/server"]}
      ]
    }

11. To initiate a process using the Smart Router URL, enter the following command:

    $ curl -s -X POST -H 'Content-type: application/json' -H 'X-KIE-Content-Type: json' -d '{"timerDuration":"9s"}' -u kieserver:kieserver1! http://localhost:9000/containers/example:timer-test:1.1/processes/timer-test.TimerProcess/instances