IBM Support

Upgrading JRules to the latest V7.1 fix pack

Technote (FAQ)


How to upgrade JRules to the latest V7.1 fix pack?


It is strongly recommended to always run JRules with latest fix pack installed.
Note: it is ultimately recommended to migrate to the latest version of the product, now called Operational Decision Management (ODM) as soon as possible.

You can refer to our Operational Decision Manager Download document to find the the latest ODM version available and see technote Migrating from JRules to ODM for more information on the migration.


The sequence to install JRules V7.1 with the latest fix pack is:

Ensure that the correct product version for the fix pack is installed, that is, at least V7.1 (7.1.0, 7.1.1 or 7.1.1.X).

Do not uninstall JRules V7.1 before running a fix pack executable: the fix pack needs to be installed on top of a V7.1 installation.

However, if you are installing the Rule Solutions for Office module, you must un-install the existing version of Rule Solutions for Office before running the fix pack installer of that module.

Fix packs are cumulative, therefore you only need to install the latest fix pack on top of your existing V7.1.X.Y installation.

For example, in order to migrate your JRules version from V7.0 to the latest V7.1 fix pack, you must first install JRules V7.1.1, then install directly the latest V7.1.1.X fix pack.

Data migration:
  • If you are only applying the modification (7.1.1) and/or a fix pack on an existing V7.1, the data for all modules remains the same. No migration is needed.
  • If you are migrating from V7.0.X or an earlier version, you must also complete the migration process of your projects, as described in the section WebSphere ILOG JRules BRMS V7.1 > Migrating of the JRules V7.1 documentation. You can also refer to Migrating from JRules to ODM which also applies to migrations to 7.1.1.

Operating System (OS) security restrictions:
  • If you are installing on an UNIX-based OS or Windows (starting in version 7), you may need to run the installers as an administrator/root, depending on where you are installing, otherwise you might get the following error:
      " Wrong JRules Home

      The folder <YourJRulesInstallDir> is not a valid <ModuleName> installation folder."
  • To avoid the need to have administrative rights to install/modify a JRules installation, execute a sample of the distribution or run the WAS CE application server provided, choose a JRules root installation folder under a shared or user folder.

Each of the five steps listed above are described below in more detail.

1. Download and install JRules 7.1.1

If you already have JRules 7.1.1 installed for all the modules that you need, skip this step and proceed to step 2 below.

To download the JRules V7.1.1 installer go to the V7.1.1 Business Rule Management Systems Download Document page. Browse each section to find the installer that applies to your environment.

For example, to download the JRules core installer, open the WebSphere ILOG JRules V7.1.1 Download Documen t section. On the same page, you can find the Downloading and assembling the product section which provides instructions.

Run the V7.1.1 installers for the modules that you need in the following order, and follow the installation wizard:

    1. JRules core or "JRules" that includes Rule Studio and/or Rule Execution Server
    2. Rule Team Server (RTS)
    3. Decision Validation Services (DVS)

The JRules core module is required and must be installed first. You must install Rule Team Server (RTS) before installing Decision Validation Services (DVS).

You can only update the components that are installed. For example, if you want to use Rule Team Server (RTS) 7.1.1.X, you must install Rule Team Server (RTS) 7.1.1 first.

As you are planning to apply a fix pack (the latest is highly recommended), hold on to run the application server bundle JARs until after you applied the fix pack ( step 2 below) and then directly run the application server bundle JARs for that fix pack.

Same for Rule Solution for Office, you can just run the fix pack installer in the next step.

Back to the top

2. Download and install the latest JRules 7.1.1 cumulative fix pack

After you have installed V7.1.1, you can upgrade this version to the latest fix pack. You must first download the fix pack installer for each module to update.

You can find all the fix packs, including the latest, in the WebSphere ILOG JRules BRMS V7.1 Download document.

You must run the fix pack installers in the following order (for the modules you use):

    1. JRules core or "JRules" (includes Rule Studio and/or Rule Execution Server)
    2. Rule Team Server (RTS)
    3. Decision Validation Services (DVS)
    4. Rule Solutions for Office
    5. Application server bundles

In each wizard, you must indicate the same path to your existing JRules V7.1.X.Y root installation directory.

If you are deploying the JRules Java EE modules on an application server other than WebSphere Application Server Community Edition (WAS CE), you must install the corresponding application bundle (step 5 above).

The same application server bundle installers ( jrules_<app server>.jar) are downloaded along with each of the module fix pack installers. For example, the WebSphere Application Server bundle installer is jrules_websphere.jar.

You only need to run once the bundle JAR for each application server you need, as all the bundle provided with each module installer (of a same version/fix pack) are identical. Just make sure to have already updated all the modules your use to the same latest fix pack (steps above).

You can then use the following command to run the bundle installer (for WebSphere here for example):

    java -jar jrules_websphere.jar

If you are installing on folder with restricted access (on UNIX or Windows starting in V7), make sure to start the command prompt or run the command as an admin/root.

For each module that you installed (Rule Execution Server, Rule Team Server, Decision Validation Services), the corresponding Java EE components are then available under <JRulesInstallDir>\<module>\applicationservers\<app server> . You must now deploy or re-deploy them to your server(s).

Back to the top

3. Deploy or re-deploy the Java EE modules to your server(s)

You must deploy or re-deploy the JRules web/Java EE modules to your server(s) following the steps described in the documentation at WebSphere ILOG JRules BRMS V7.1: Java EE add-ons > Installing on <your application server>.

Make sure you have applied the application descriptor changes you need for custom roles and settings, if any, on the up-to-date modules before you deploy them.

Back to the top

4. Install or update the Rule Studio plugins in your existing Eclipse-based IDE

If you chose the run Rule Studio on an Eclipse instance other than the one provided by the JRules installer, you must also follow the steps listed in the documentation at Installing > Installing Rule Studio in Eclipse or Installing > Installing Rule Studio in IBM Eclipse-based products, to install the Rule Studio plugins or apply the latest fix pack.

Back to the top

5. Repackage your JRules client applications with the up-to-date libraries

If you have built client applications to Rule Execution Server or Rule Team Server, you will need to repackage then re-deploy those with the up-to-date libraries provided by the latest fix pack.

The libraries have been updated under <JRulesInstallDir>\<module>\lib.

Back to the top


Related information

JRules BRMS V7.1 Download document
JRules BRMS V7.1 Installation overview
JRules BRMS V7.1 Technotes
Migrating between minor releases
Migrating from JRules to ODM

Document information

More support for: WebSphere ILOG JRules

Software version: 7.1

Operating system(s): Platform Independent

Reference #: 1474292

Modified date: 25 June 2012

Translate this page: