IBM Support

Automating the installation and configuration of JRules 7 on JBoss 5.0.1

Troubleshooting


Problem

Due to JMX-related conflict with embedded Derby with JBoss, you may find that the configured server has issues once all the JRules modules are configured with JBoss. To prevent issues and simplify the installation process we provide here a build script to automate the installation and configuration of DVS, RTS, RES on JBoss server 5.0.1.

Symptom

After following through the documentation steps for integrating JBoss with JRules, users notice that the installation is not successful and the serve log contains exceptions.

Resolving The Problem

The automation is delivered as ant build script. The script provides multiple targets for installing and configuring JRules with JBoss.

  • The ANT target "installjboss" will:

    • 1. Download a JBoss installer and install JBoss, if no installation is already available.

    2. Update the default configuration in order to remove unnecessary setup related to JSF.

    3. Install RTS , RES and DVS if available.

  • The ANT target "installsample" will:

    • 1. Install derby driver into the server configuration.

    2. Configure the sample database delivered with JRules.

    3. Setup the user permission accordingly.

  • The ANT target "runserver" will start the configuration created
  • The ANT target "killjboss" will stop the configuration created

After running the task installjboss if you do not want to use the sample Derby databases you need to complete the configuration of JBOSS according to the installation manual.

For RTS complete

  1. Creating a data source and connection pool
  2. Configuring Security

For RES complete
  1. Creating a data source to access the Rule Execution Server database
  2. Configuring Security

The "build.properties" file contains initialization of variables that are used to parameterize the build.xml script. You need to make sure the properties in this file are accurately defined to represents your environment:
  • jrules.homedir: This variable specifies the absolute path of the installation of JRules directory.
  • jboss.server.configuration: This variable specifies the location of the server configuration directory.
    Currently the JRules installation only works with a "default" configuration. If you are using a custom configuration then it must be a copy of the configuration "default".

Note

To simplify the use of the ant tasks on both Windows and Linux, command files and shell files are also provided in the attachment. ( If ANT is not setup by default on your machine, edit the .bat file or .sh file in order to specify the path to ANT. Note that the folder <jrules-install>/shared/tools/ant contains an installation. )

The command script available are:

  1. installJRules-JBoss to install and configure JBoss with JRules with all the modules (DVS, RES, RTS). This command will not configure data source OR the users and groups, so that you have the flexibility to configure these settings. For more information on these steps, refer to the installation manual.
  2. install-Samples to configure JBoss with the sample databases.
  3. startJBoss. to start the server configuration on port 8080.
  4. stopJBoss to stop the running JBoss server.

jr7jb5.zip jr7jb5.zip
jr7jb5

[{"Product":{"code":"SS6MTS","label":"WebSphere ILOG JRules"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
15 June 2018

UID

swg21452375

Page Feedback