Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial ...

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial Installation

Jacek Laskowski IT Software Specialist for WebSphere BPM IBM Software Services Poland [email protected]

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


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.


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


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


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


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


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.


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.


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.


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.


Page 12 of 17


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...


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.


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.


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.


Page 17 of 17