Getting Started with IBM WebSphere ILOG JRules 7.0.2...

Getting Started

with

IBM WebSphere ILOG JRules 7.0.2 Trial

Installation

Jacek LaskowskiIT Software Specialist for WebSphere BPM

IBM Software Services [email protected]

version: June 11, 2010

Getting Started with IBM WebSphere ILOG JRules 7.0.2 Trial - Installation of 17

mailto:[email protected]

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

Rule Studio.................................................................................................................................... 14Rule Team Server and Rule Execution Server...............................................................................15


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


http://www14.software.ibm.com/download/data/web/en_US/trialprograms/W518849N35119T77.html

https://www.ibm.com/developerworks/java/jdk/linux/download.html

https://www.ibm.com/developerworks/forums/thread.jspa?threadID=322658&tstart=0

https://www.ibm.com/developerworks/forums/thread.jspa?threadID=322658&tstart=0

https://ftp3.linux.ibm.com/up2date.html

https://ftp3.linux.ibm.com/

http://publib.boulder.ibm.com/infocenter/brjrules/v7r0m2/index.jsp

http://www-01.ibm.com/support/docview.wss?rs=4043&uid=swg27016357

http://www-01.ibm.com/support/docview.wss?rs=4043&uid=swg27016357

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.5Loaded plugins: rhnplugin, securitycompat-libstdc++-33-3.2.3-61.i386 : Compatibility standard C++ librariesRepo : rhel-x86_64-server-5Matched from:Other : libstdc++.so.5[root@localhost ~]# yum install compat-libstdc++-33-3.2.3-61.i386Loaded plugins: rhnplugin, securitySetting up Install ProcessResolving 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 kIs this ok [y/N]: yDownloading Packages:compat-libstdc++-33-3.2.3-61.i386.rpm | 232 kB 00:01Running rpm_check_debugRunning Transaction TestFinished Transaction TestTransaction Test SucceededRunning Transaction Installing : compat-libstdc++-33 1/1

Installed: compat-libstdc++-33.i386 0:3.2.3-61

Complete!

[root@localhost ~]# yum install compat-libstdc++-33Loaded plugins: rhnplugin, securitySetting up Install ProcessPackage compat-libstdc++-33-3.2.3-61.i386 already installed and latest versionResolving 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


========================================================================================Install 1 Package(s) Update 0 Package(s) Remove 0 Package(s)

Total download size: 227 kIs this ok [y/N]: yDownloading Packages:compat-libstdc++-33-3.2.3-61.x86_64.rpm | 227 kB 00:01 Running rpm_check_debugRunning Transaction TestFinished Transaction TestTransaction Test SucceededRunning Transaction Installing : compat-libstdc++-33 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-java-x86_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 -versionjava 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_055940JIT - r9_20100401_15339GC - 20100308_AA)JCL - 20100408_01


Installing Eclipse GanymedeEclipse 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 TrialThe 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 -versionjava 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_055940JIT - r9_20100401_15339GC - 20100308_AA)JCL - 20100408_01

[jacek@localhost ~]$ echo $DISPLAY:0.0


http://www.eclipse.org/downloads/packages/release/ganymede/sr2

[jacek@localhost ~]$ ls -ltrtotal 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

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.


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.


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.


Press Install and the installation process begins.


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


It finishes the installation step.

[jacek@localhost ~]$ ls -l ./WebSphereILOGJRules702/total 16108drwxrwxr-x 6 jacek jacek 4096 Mar 16 11:14 docdrwxrwxr-x 7 jacek jacek 4096 Mar 16 11:14 dvsdrwxrwxr-x 9 jacek jacek 4096 Mar 16 11:14 executionserverdrwxrwxr-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.exedrwxrwxr-x 2 jacek jacek 4096 Mar 16 11:15 license-rwxrwxr-x 1 jacek jacek 54648 Mar 16 11:15 readme.htmldrwxrwxr-x 5 jacek jacek 4096 Mar 16 11:14 shareddrwxrwxr-x 9 jacek jacek 4096 Mar 16 11:15 studiodrwxrwxr-x 7 jacek jacek 4096 Mar 16 11:14 teamserverdrwxrwxr-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...


...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 180drwxrwxr-x 3 jacek jacek 4096 Mar 16 11:14 compatibility_pluginsdrwxrwxr-x 4 jacek jacek 4096 Mar 16 11:14 eclipse-rw-rw-r-- 1 jacek jacek 53750 Mar 16 11:15 lax.jardrwxrwxr-x 2 jacek jacek 4096 Mar 16 11:15 libdrwxrwxr-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.laxdrwxrwxr-x 9 jacek jacek 4096 Mar 16 11:14 samplesdrwxrwxr-x 2 jacek jacek 4096 Mar 16 11:14 schemasdrwxrwxr-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.


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.


http://localhost:8080/teamserver

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.


http://localhost:8080/res

Getting Started with IBM WebSphere ILOG JRules 7.0.2...

Documents

Transcript of Getting Started with IBM WebSphere ILOG JRules 7.0.2...