#ibmwebspheremessagebroker

Prerequisites:

Untar the following:

8.0.0-WS-MB-LINUXIA32-FP0000-TRIAL.tar.gz

8.0.0-WS-MBT-LINUXIA32-FP0000-TRIAL-D1.tar.gz

8.0.0-WS-MBT-LINUXIA32-FP0000-TRIAL-D2.tar.gz

8.0.0-WS-MBT-LINUXIA32-FP0000-TRIAL-D3.tar.gz

CZRW2ML.tar.gz

Note: to untar, open terminal and execute: $ tar xvf filename

The above should result in the extraction of these folders: messagebroker_ia_trial_runtime1, disk1, disk2, disk3, CZRW2ML

Install Alien:

What is alien: Alien is a utility that converts RPM packages to Debian packages or Alien can install RPM packages directly

Installation: Open terminal and execute: $ sudo apt-get install alien

Why Alien: Since Ubuntu is a Debian based OS and WMB installers are rpms (installer packages that are commonly used in Red Hat OS) therefore we need to find a way to make use of such rpms in Ubuntu, using alien is just one way of installing these Red Hat installer packages.

Alternative: We can also use the rpm utility for ubuntu. To install this utility, open terminal and execute: $ sudo apt-get install rpm sharutils

I personally used alien for the installation of WMB

User/ID Setup:

Create the required WebSphere embedded messaging support groups mqm and mqbrkrs

Open terminal and execute: $ sudo groupadd mqm

Open terminal and execute: $ sudo groupadd mqbrkrs

Create the user: mqm and add this user to the group: mqm

Open terminal and execute: $ sudo useradd -d /var/mqm/ -g mqm mqm

Note: -d: directory for the mqm user and -g: The group name or number of the user's initial login group. The group name must exist. A group number must refer to an already existing group. The default group number is 1

Create a Message Broker service id and add to group mqbrkrs and mqm

Open terminal and execute: $ sudo useradd -d /home/mbadmin -G mqbrkrs,mqm mbadmin

Note: -G: A list of supplementary groups which the user is also a member of. Each group is separated from the next by a comma, with no intervening whitespace. The groups are subject to the same restrictions as the group given with the -g option. The default is for the user to belong only to the initial group

Adding yourself to these groups: mqm, mqbrkrs:

Open terminal and execute: $ sudo usermod -a -G mqbrkrs,mqm <user id>

Open terminal and execute: $ sudo usermod -a -G mqbrkrs,mqm root

Open terminal and execute: $ sudo usermod -a -G mbadmin <user id>

Note: -a: Add the user to the supplemental group(s). Use only with -G option

Installing WebSphere Message Queue (WMQ):

WMQ is the underlying platform for WMB therefore it has to be installed first

Installation Steps:

Open terminal, navigate to CZRW2ML and execute: $ sudo ./mqlicense.sh

Most probably you will get the following exception as a result of the above's execution otherwise accept the agreement:

Exception in thread "main" java.lang.UnsatisfiedLinkError: fontmanager (libstdc++.so.5: cannot open shared object file: No such file or directory)

If you encounter this exception (which I did as well), execute the following:

On the terminal execute: $ less ./licenses/LA_en

Scroll down the agreement, till the end, then type :q 

One more thing: Upon the successful execution of mqlicense.sh this file is created: /tmp/mq_license/license/status.dat which (in this exceptional situation) we need to create ourselves, to do so, open terminal and execute:

$ sudo mkdir -p /tmp/mq_license/license/

$ sudo touch /tmp/mq_license/license/status.dat

Install the following rpms:

MQSeriesRuntime-7.0.1-3.i386.rpm

MQSeriesServer-7.0.1-3.i386.rpm

MQSeriesSDK-7.0.1-3.i386.rpm

MQSeriesClient-7.0.1-3.i386.rpm

MQSeriesJava-7.0.1-3.i386.rpm

MQSeriesSamples-7.0.1-3.i386.rpm

gsk7bas-7.0-4.23.i386.rpm

MQSeriesKeyMan-7.0.1-3.i386.rpm

MQSeriesMan-7.0.1-3.i386.rpm

MQSeriesMsg_es-7.0.1-3.i386.rpm

MQSeriesJRE-7.0.1-3.i386.rpm

MQSeriesEclipseSDK33-7.0.1-3.i386.rpm

MQSeriesConfig-7.0.1-3.i386.rpm

Note: These packages can be installed by executing: $ sudo alien -i --script filename.rpm

Verifying the installation:

Open terminal and execute: sudo su – mqm

Create and start a test queue manager:

$ crtmqm TestQM

$ strmqm TestQM

Exit from mqm: $ exit

Launching the WebSphere MQ Explorer: $ sudo strmqcfg

You should see TestQM when the WMQ explorer runs

Installing WMB:

Open terminal and navigate to: messagebroker_ia_trial_runtime1

Execute: $ sudo ./setuplinuxia32.bin

A GUI installer is launched after the execution of this command [I took all the default options]

The above does not install MB Explorer application, that has to be manually installed by executing the following:

Navigate to: messagebroker_ia_trial_runtime1/MBExplorer

Execute: $ sudo ./install.bin

Toolkit installation:

Navigate to: disk1 (e.g. /tmp/disk1)

Execute: $ sudo ./installToolkit.sh

The above will launch the installation manager (for the record, again I took all the defaults)

During installation, the following steps are needed to be performed, if this exception is encountered on the Install Packages screen: The package IBM webSphere Message Broker Toolkit requires system library libstdc++.so.5 ir libstdc++.so.6. Make sure libstdc++.so.5 or libstdc++.so.6 is available in the system library path before installing this package.

Close the installation manager

Install libstdc++6 (if its not already installed). You can do so while using Synaptic Package Manager

After the above, open terminal and execute: $ sudo ln -s /usr/lib/i386-linux-gnu/libstdc++.so.6 /usr/lib

Execute: $ sudo ldconfig

For the verification of the successful application/execution of the above steps, execute: $ ldconfig -p | grep libstdc++

The above, should display this:

libstdc++.so.6 (libc6) => /usr/lib/i386-linux-gnu/libstdc++.so.6

libstdc++.so.6 (libc6) => /usr/lib/libstdc++.so.6

After the successful setup of libstdc++6.0, start over by launching the installation manager (navigate to /disk1 and execute: $ sudo ./installToolkit.sh)

Accept all the defaults (unless you think otherwise), keep on clicking Next and lastly Finish, the installation manager will then complete the installation

Verifying the installation of WMB:

Open Dash, check the installed apps, you'll find the icon of installed IBM WebSphere Message Broker Toolkit 8.0 (alternatively, you can also search for the very app in Dash)

Click on the icon to launch the toolkit, if the app starts successfully, then it should be treated as a proof of the successful installation

Close the Welcome screen

Click New in front of Application Development to start developing WMB artifacts/components

References:

- http://mqseries.net/phpBB/viewtopic.php?p=285778

- http://www.gefira.pl/blog/2010/07/03/websphere-mq-and-ubuntu-howto/

- http://www.gefira.pl/blog/2011/02/18/a-shortstory-of-a-failed-installation-websphere-message-broker-on-ubuntu/