Getting Started

with
IBM WebSphere ILOG JRules 7.0.2 Trial
Installation

Jacek Laskowski
IT Software Specialist for WebSphere BPM
IBM Software Services Poland
jacek.laskowski@pl.ibm.com

version: June 11, 2010

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 1 of 17

Table of Contents
Introduction.......................................................................................................................................... 3
Installing RedHat Enterprise Linux 5.4 x86-64 with its latest updates................................................ 3
Installing IBM Java SDK 6 for Linux.................................................................................................. 3
Installing Eclipse Ganymede................................................................................................................ 6
Installing IBM WebSphere ILOG JRules 7.0.2 Trial........................................................................... 6
Post-installation check: running Rule Studio, Rule Team Server and Rule Execution Server...........14
Rule Studio.................................................................................................................................... 14
Rule Team Server and Rule Execution Server...............................................................................15

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 2 of 17

Introduction
This document describes the steps to install IBM WebSphere ILOG JRules 7.0.2 Trial on RedHat
Enterprise Linux 5.4 (64-bit version) with IBM Java SDK 6 and Eclipse Galileo.
The trial is available at WebSphere ILOG JRules Trial download for version 7.0.2.
WebSphere ILOG JRules Business Rule Management System Version 7.0, hardware and software
requirements - Linux on x86-64
The documentation is at IBM WebSphere ILOG JRules Version 7.0.2 Information Center.
Note to MacOS users: the entire environment has been tested with VMware Fusion 3.0.2 on MacOS
X Snow Leopard with 8GB RAM.

Installing RedHat Enterprise Linux 5.4 x86-64 with its latest

updates
Download the appropriate Linux distribution image of your choice. In case of this document it's
RHEL5.4-Server-20090819.0-x86_64-DVD.iso.
IBMers should use the Linux internal ftp servers as described at the Enterprise Linux site.
Create a new virtual machine with 1792 MB RAM, 2 processors and 20GB hard disk space. It
should take around 15 minutes using the quick installation.
Update the fresh Linux installation with yum update.
IBMers should first register themselves with the IBM Internal Red Hat Network Satellite as
described at request access and configure the yum client.
There's a hitch you should be aware of running yum update on x86-64 platform will likely fail
with a bizarre error message about conflicts between packages being updated. It is most likely due
to cyclic dependency between pam.i386 and pam.x86_64 so you have to download them by
yourself (pam-0.99.6.2-6.el5_4.1.i386.rpm and pam-0.99.6.2-6.el5_4.1.x86_64.rpm at the time of
this writing) and install with rpm -Uhv with a single command.
rpm -Uhv pam-0.99.6.2-6.el5_4.1.i386.rpm pam-0.99.6.2-6.el5_4.1.x86_64.rpm

I'm all ears how to fix it in a gentle way (if it does exist).

Installing IBM Java SDK 6 for Linux

Due to an issue with OpenJDK 6 that exhibits itself as Ruleflow editor empty - no toolbar and
palette, it's of little or no use with ILOG JRules Rule Studio.
It's therefore mandatory to install IBM Java SDK 6 (SR8, 64-bit AMD/Opteron/EM64T) for
Linux. It's available at IBM Java Developer Kits' Linux Download information.
IBM Java SDK 6 requires libstdc++.so.5, but it's not available at the up-to-date RedHat EL 5.4
installation. You need to install compat-libstdc++-33 before installing IBM Java SDK.

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 3 of 17

Note that a single yum install compat-libstdc++-33 is enough. In the following installation log I
mistakenly installed the 32-bit version as well as the proper 64-bit mode. It's likely to be fixed in the
upcoming version of the document.
[root@localhost ~]# yum provides libstdc++.so.5
Loaded plugins: rhnplugin, security
compat-libstdc++-33-3.2.3-61.i386 : Compatibility standard C++ libraries
Repo
: rhel-x86_64-server-5
Matched from:
Other
: libstdc++.so.5
[root@localhost ~]# yum install compat-libstdc++-33-3.2.3-61.i386
Loaded plugins: rhnplugin, security
Setting up Install Process
Resolving Dependencies
--> Running transaction check
---> Package compat-libstdc++-33.i386 0:3.2.3-61 set to be updated
--> Finished Dependency Resolution
Dependencies Resolved
========================================================================================
Package
Arch
Version
Repository
Size
========================================================================================
Installing:
compat-libstdc++-33
i386
3.2.3-61
rhel-x86_64-server-5 232 k
Transaction Summary
========================================================================================
Install
1 Package(s)
Update
0 Package(s)
Remove
0 Package(s)
Total download size: 232 k
Is this ok [y/N]: y
Downloading Packages:
compat-libstdc++-33-3.2.3-61.i386.rpm
Running rpm_check_debug
Running Transaction Test
Finished Transaction Test
Transaction Test Succeeded
Running Transaction
Installing
: compat-libstdc++-33

| 232 kB

00:01

1/1

Installed:
compat-libstdc++-33.i386 0:3.2.3-61
Complete!
[root@localhost ~]# yum install compat-libstdc++-33
Loaded plugins: rhnplugin, security
Setting up Install Process
Package compat-libstdc++-33-3.2.3-61.i386 already installed and latest version
Resolving Dependencies
--> Running transaction check
---> Package compat-libstdc++-33.x86_64 0:3.2.3-61 set to be updated
--> Finished Dependency Resolution
Dependencies Resolved
========================================================================================
Package
Arch
Version
Repository
Size
========================================================================================
Installing:
compat-libstdc++-33
x86_64 3.2.3-61
rhel-x86_64-server-5 227 k
Transaction Summary

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 4 of 17

========================================================================================
Install
1 Package(s)
Update
0 Package(s)
Remove
0 Package(s)
Total download size: 227 k
Is this ok [y/N]: y
Downloading Packages:
compat-libstdc++-33-3.2.3-61.x86_64.rpm
Running rpm_check_debug
Running Transaction Test
Finished Transaction Test
Transaction Test Succeeded
Running Transaction
Installing
: compat-libstdc++-33

| 227 kB

00:01

1/1

Installed:
compat-libstdc++-33.x86_64 0:3.2.3-61
Complete!

With compat-libstdc++-33 installed, you use rpm -Uhv to install IBM Java SDK 6 ibm-javax86_64-sdk-6.0-8.0.x86_64.rpm.
[root@localhost ~]# rpm -Uhv ibm-java-x86_64-sdk-6.0-8.0.x86_64.rpm
Preparing...
########################################### [100%]
1:ibm-java-x86_64-sdk
########################################### [100%]

The IBM Java SDK is installed in /opt/ibm/java-x86_64-60 directory.

Run java -version command to verify whether the correct, IBM Java SDK is executed each time
java is fired.
[root@localhost ~]# java -version
java version "1.6.0"
Java(TM) SE Runtime Environment (build pxa6460sr8-20100409_01(SR8))
IBM J9 VM (build 2.4, JRE 1.6.0 IBM J9 2.4 Linux amd64-64 jvmxa6460sr8-20100401_55940
(JIT enabled, AOT enabled)
J9VM 20100401_055940
JIT - r9_20100401_15339
GC
- 20100308_AA)
JCL - 20100408_01

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 5 of 17

Installing Eclipse Ganymede

Eclipse is required for the developer tool ILOG JRules Rule Studio. The Linux installer does
assume it's already been installed (Windows one comes with it).
Note that Eclipse 3.4.2 (Ganymede) is required for a proper work of the Rule Studio. It's been
verified that Eclipse Galileo doesn't work well (and occasionally throws exception when tried).
Download Eclipse IDE for Java EE Developers (Eclipse Ganymede Sr2) for Linux 64bit from
the following site:
http://www.eclipse.org/downloads/packages/release/ganymede/sr2
and install it by unpacking to the directory of your choice with tar -zxf.
[jacek@localhost ~]$ tar -zxf eclipse-jee-ganymede-SR2-linux-gtk-x86_64.tar.gz

Once unpacked, fire it up to ensure it works well.

[jacek@localhost ~]$ eclipse/eclipse

Installing IBM WebSphere ILOG JRules 7.0.2 Trial

The below command line output shows the commands to execute for a successful installation.
Note it's not required to run the installation with the root privileges. A regular user works fine.
Ensure the DISPLAY environment variable is set correctly as the only way to install ILOG JRules is
with a graphical installer.
Let the command line speak for itself. User commands are in bold.
[jacek@localhost ~]$ java -version
java version "1.6.0"
Java(TM) SE Runtime Environment (build pxa6460sr8-20100409_01(SR8))
IBM J9 VM (build 2.4, JRE 1.6.0 IBM J9 2.4 Linux amd64-64 jvmxa6460sr8-20100401_55940
(JIT enabled, AOT enabled)
J9VM 20100401_055940
JIT - r9_20100401_15339
GC
- 20100308_AA)
JCL - 20100408_01
[jacek@localhost ~]$ echo $DISPLAY
:0.0

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 6 of 17

[jacek@localhost ~]$ ls -ltr

total 342588
-rw-r--r-- 1 jacek jacek 350484336 Mar 16 10:39 jrules70trial.bin
[jacek@localhost ~]$ chmod +x jrules70trial.bin
[jacek@localhost ~]$ ./jrules70trial.bin
Preparing to install...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...
Launching installer...

At this point the installation was performed with a graphical user interface and so the screenshots
go.

Screenshot 1: WebSphere ILOG JRules Trial Installer's splash screen

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 7 of 17

Press Next.

Select I accept the terms in the license agreement and press Next.

Choose the version for the installation, which in this particular case is Trial version. Press Next.

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 8 of 17

Choose the destination folder (by default it's /opt/IBM/WebSphereILOGJRules702) and press Next.

Select the directory where you've installed Eclipse and press Next. Note that the installation asks
for Eclipse 3.3, but Eclipse 3.4.2 is supported since ILOG JRules 7.0.2.

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 9 of 17

Choose the JDK and press Next (note that the Java VM to be Used by Installed Product points
out to OpenJDK, but it's only that I haven't updated the screenshots yet. ILOG JRules Rule Studio
doesn't work reliably with OpenJDK).

This is the last step before final installation. Due to inability to resize the summary screen I had to
take two screenshots.
Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 10 of 17

Press Install and the installation process begins.

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 11 of 17

Press Done. The installation's done and a browser with IBM WebSphere ILOG JRules V7.0.2
README document will pop up.

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 12 of 17

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 13 of 17

It finishes the installation step.

[jacek@localhost ~]$ ls -l ./WebSphereILOGJRules702/
total 16108
drwxrwxr-x 6 jacek jacek
4096 Mar 16 11:14 doc
drwxrwxr-x 7 jacek jacek
4096 Mar 16 11:14 dvs
drwxrwxr-x 9 jacek jacek
4096 Mar 16 11:14 executionserver
drwxrwxr-x 7 jacek jacek
4096 Mar 16 11:14 gettingstarted
-rw-rw-r-- 1 jacek jacek 2552584 Mar 16 11:16
IBM_WebSphere_ILOG_JRules_V7.0.2_InstallLog.log
-rwxrwxr-x 1 jacek jacek 13765776 Mar 16 11:15 ILOGRuleSolutionsForOffice.exe
drwxrwxr-x 2 jacek jacek
4096 Mar 16 11:15 license
-rwxrwxr-x 1 jacek jacek
54648 Mar 16 11:15 readme.html
drwxrwxr-x 5 jacek jacek
4096 Mar 16 11:14 shared
drwxrwxr-x 9 jacek jacek
4096 Mar 16 11:15 studio
drwxrwxr-x 7 jacek jacek
4096 Mar 16 11:14 teamserver
drwxrwxr-x 2 jacek jacek
4096 Mar 16 11:16 Uninstall_IBM WebSphere ILOG JRules
V7.0.2

Post-installation check: running Rule Studio, Rule Team

Server and Rule Execution Server
Rule Studio
Let's start with the tool for JRules developers Rule Studio. According to the docs...

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 14 of 17

...that's what lax.jar is supposed to do (on Linux). There's however a bit slicker approach with Rule
Studio shell script.
[jacek@localhost ~]$ ls -l ./WebSphereILOGJRules702/studio/
total 180
drwxrwxr-x 3 jacek jacek 4096 Mar 16 11:14 compatibility_plugins
drwxrwxr-x 4 jacek jacek 4096 Mar 16 11:14 eclipse
-rw-rw-r-- 1 jacek jacek 53750 Mar 16 11:15 lax.jar
drwxrwxr-x 2 jacek jacek 4096 Mar 16 11:15 lib
drwxrwxr-x 4 jacek jacek 4096 Mar 16 11:14 migration
-rwxr-xr-x 1 jacek jacek 46518 Mar 16 11:15 Rule Studio
-rwxrwxr-x 1 jacek jacek 3289 Mar 16 11:15 Rule Studio.lax
drwxrwxr-x 9 jacek jacek 4096 Mar 16 11:14 samples
drwxrwxr-x 2 jacek jacek 4096 Mar 16 11:14 schemas
drwxrwxr-x 11 jacek jacek 4096 Mar 16 11:14 tutorials
[jacek@localhost ~]$ ./WebSphereILOGJRules702/studio/Rule\ Studio

After a couple of seconds, Rule Studio should be up and running with the Rule perspective open.

Rule Team Server and Rule Execution Server

The ILOG JRules 7.0.2 Trial comes with Apache Tomcat 6.0.18 bundled. All the application server
components of JRules are preinstalled onto Tomcat.
The server and the modules are started up with ./shared/bin/samples shell script.
[jacek@localhost WebSphereILOGJRules702]$ pwd
/home/jacek/WebSphereILOGJRules702
[jacek@localhost WebSphereILOGJRules702]$ ./shared/bin/samples

After a while, a graphical administration-like tool opens.

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 15 of 17

Note the buttons at the bottom of the panel. They're for Tomcat administration and to open a
browser with the Samples Home Page.
Once Tomcat starts up, a browser with What are JRules samples and how to use them opens.
Go to http://localhost:8080/teamserver and Rule Team Server opens.

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 16 of 17

Use rtsAdmin/rtsAdmin credentials to pass the gate.

Go to http://localhost:8080/res with resAdmin/resAdmin credentials and you're in Rule Execution
Server console.

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation

Page 17 of 17