How to Install IBM WebSphere MQ 7.5 on Redhat Enterprise Linux - Middleware News

WebSphere MQ is an IBM messaging solution which enable applications to communicate each other asynchronously. Application A for example need not to be connected direct to application B to exchange information moreover application B need not to be running for the application A to communicate. Application A simply place the message in container called queue and application B will retrieve the message from that queue when it is available. That is the meaning of asynchronous communication messaging solutions accomplish. Other messaging solutions include Oracle Streams Advanced Queuing

The following post is showing the installation of IBM Webspere MQ version 7.5 on Redhat Enterprise Linux 5.8 (x86_64) platform. You can download the trial software from IBM site. 

In this post:

- Setup WebSphere user and Group

- Kernel Configuration Parameters

- Read and Accept License

- Install WebSphere MQ Components

- Post Installations

- Verifying Installation

- Start WebSphere MQ Explorer GUI

Setup WebSphere MQ User and Group

On UNIX like systems, WebSphere MQ requires a user ID of the name mqm, with a primary group of mqm to own the directories and files of the product. WebSphere MQ installation will automatically create the user and group for you. However you may want to setup in advance

Login to the system as user root then create user and group as follow:

[root@Lugaomqaq ~]# groupadd mqm

[root@Lugaomqaq ~]# useradd -g mqm mqm

[root@Lugaomqaq ~]# passwd mqm

Changing password for user mqm.

New UNIX password:

Retype new UNIX password:

passwd: all authentication tokens updated successfully.

[root@Lugaomqaq ~]#

Kernel Configuration Parameters

To make the following kernel changes log as user with root authority. Open the file "/etc/sysctl.conf" then add or change the following entries to the values shown (if the existing values in file are greater than these values do not change)

kernel.shmmni = 4096

kernel.shmall = 2097152

kernel.shmmax = 268435456

kernel.sem = 500 256000 250 1024

net.ipv4.tcp_keepalive_time = 300

To load these sysctl values immediately, execute command "sysctl -p" as follows:

[root@Lugaomqaq ~]# sysctl -p

net.ipv4.ip_forward = 0

net.ipv4.conf.default.rp_filter = 1

net.ipv4.conf.default.accept_source_route = 0

kernel.sysrq = 0

kernel.core_uses_pid = 1

net.ipv4.tcp_syncookies = 1

kernel.msgmnb = 65536

kernel.msgmax = 65536

kernel.shmmax = 68719476736

kernel.shmall = 4294967296

kernel.shmmni = 4096

kernel.sem = 500 256000 250 1024

fs.file-max = 524288

net.ipv4.tcp_keepalive_time = 300

[root@Lugaomqaq ~]#

Add the following information to the "/etc/security/limits.conf" file

mqm              hard    nofile          10240

mqm              soft    nofile          10240

If your Linux system needs more settings go to IBM WebSphere MQ Information Center. Expands WebSphere MQ >Installing > Prepare your system > Addition settings > Linux

Read and Accept License

While login as root set your current working directory to the installation files. Run the "./mqlicense.sh -text_only" command to read accept the license issues or run "./mqlicense.sh -accept" command to accept the license without displaying all text as follows (You must accept the license compliances otherwise you won’t proceed with installation):

[root@Lugaomqaq MQ_7.5.0.2]# ./mqlicense.sh -accept

Licensed Materials - Property of IBM            

 5724-H72

 (C) Copyright IBM Corporation 1994, 2013 All rights reserved.

US Government Users Restricted Rights - Use, duplication or disclosure

restricted by GSA ADP Schedule Contract with IBM Corp.

Agreement accepted:  Proceed with install.

[root@Lugaomqaq MQ_7.5.0.2]#

Install WebSphere MQ Components

At minimum Webspere MQ server installation you must install MQSeriesRuntime and the MQSeriesServer components. However, this example show the minimum installation of the following components 
    MQSeriesRuntime
    MQSeriesServer
    MQSeriesClient
    MQSeriesSDK
    MQSeriesSample
    MQSeriesJava
    MQSeriesMan
    MQSeriesJRE
    MQSeriesExplorer

Log in as root, or switch to the superuser by using the su command. Set your current working directory to the installation files. To install to the default location, "/opt/mqm" use the "rpm –ivh" command to install each component as follow:

[root@Lugaomqaq MQ_7.5.0.2]# rpm -ivh MQSeriesRuntime-7.5.0-2.x86_64.rpm

Preparing...                ########################################### [100%]

   1:MQSeriesRuntime        ########################################### [100%]

[root@Lugaomqaq MQ_7.5.0.2]#

[root@Lugaomqaq MQ_7.5.0.2]# rpm -ivh MQSeriesServer-7.5.0-2.x86_64.rpm

Preparing...                ########################################### [100%]

   1:MQSeriesServer         ########################################### [100%]

After the installation has completed, run the '/opt/mqm/bin/mqconfig'

command, using the 'mqm' user ID.

For example, execute the following statement when running as the 'root' user:

    su mqm -c "/opt/mqm/bin/mqconfig"

The 'mqconfig' command validates that the system configuration satisfies the

requirements for WebSphere MQ, and ensures that the settings for the 'mqm'

user ID are suitably configured.  Other WebSphere MQ administrators in the

'mqm' group can run this command to ensure their user limits are also

properly configured to use WebSphere MQ.

If 'mqconfig' indicates that any of the requirements have not been met,

consult the installation section within the WebSphere MQ Information Center

for details about how to configure the system and user limits.

Run the su mqm -c "/opt/mqm/bin/mqconfig" command as suggested to validate configurations

[root@Lugaomqaq MQ_7.5.0.2]# su mqm -c "/opt/mqm/bin/mqconfig"

mqconfig: Analyzing Red Hat Enterprise Linux Server release 5.8 (Tikanga)

          settings for WebSphere MQ V7.5

System V Semaphores

  semmsl     (sem:1)  500 semaphores                     IBM>=500          PASS

  semmns     (sem:2)  1 of 256000 semaphores     (0%)    IBM>=256000       PASS

  semopm     (sem:3)  250 operations                     IBM>=250          PASS

  semmni     (sem:4)  1 of 1024 sets             (0%)    IBM>=1024         PASS

System V Shared Memory

  shmmax              68719476736 bytes                  IBM>=268435456    PASS

  shmmni              4 of 4096 sets             (0%)    IBM>=4096         PASS

  shmall              1260 of 4294967296 pages   (0%)    IBM>=2097152      PASS

System Settings

  file-max            3570 of 524288 files       (0%)    IBM>=524288       PASS

  tcp_keepalive_time  300 seconds                        IBM<=300          PASS

Current User Limits (mqm)

  nofile       (-Hn)  10240 files                        IBM>=10240        PASS

  nofile       (-Sn)  10240 files                        IBM>=10240        PASS

  nproc        (-Hu)  8 of 10399 processes       (0%)    IBM>=4096         PASS

  nproc        (-Su)  8 of 10399 processes       (0%)    IBM>=4096         PASS

[root@Lugaomqaq MQ_7.5.0.2]#

If you encounter any FAIL go to IBM WebSphere MQ Information Center. Expands WebSphere MQ >Installing > Prepare your system > Addition settings > Linux. See how you can adjust kernel parameters before proceeding with installations

Install other components

[root@Lugaomqaq MQ_7.5.0.2]# rpm -ivh MQSeriesClient-7.5.0-2.x86_64.rpm

Preparing...                ########################################### [100%]

   1:MQSeriesClient         ########################################### [100%]

[root@Lugaomqaq MQ_7.5.0.2]#

[root@Lugaomqaq MQ_7.5.0.2]# rpm -ivh MQSeriesSDK-7.5.0-2.x86_64.rpm

Preparing...                ########################################### [100%]

   1:MQSeriesSDK            ########################################### [100%]

[root@Lugaomqaq MQ_7.5.0.2]#

[root@Lugaomqaq MQ_7.5.0.2]# rpm -ivh MQSeriesSamples-7.5.0-2.x86_64.rpm

Preparing...                ########################################### [100%]

   1:MQSeriesSamples        ########################################### [100%]

[root@Lugaomqaq MQ_7.5.0.2]#

[root@Lugaomqaq MQ_7.5.0.2]# rpm -ivh MQSeriesJava-7.5.0-2.x86_64.rpm

Preparing...                ########################################### [100%]

   1:MQSeriesJava           ########################################### [100%]

[root@Lugaomqaq MQ_7.5.0.2]#

[root@Lugaomqaq MQ_7.5.0.2]# rpm -ivh MQSeriesMan-7.5.0-2.x86_64.rpm

Preparing...                ########################################### [100%]

   1:MQSeriesMan            ########################################### [100%]

[root@Lugaomqaq MQ_7.5.0.2]#

[root@Lugaomqaq MQ_7.5.0.2]# rpm -ivh MQSeriesJRE-7.5.0-2.x86_64.rpm

Preparing...                ########################################### [100%]

   1:MQSeriesJRE            ########################################### [100%]

[root@Lugaomqaq MQ_7.5.0.2]#

[root@Lugaomqaq MQ_7.5.0.2]# rpm -ivh MQSeriesExplorer-7.5.0-2.x86_64.rpm

Preparing...                ########################################### [100%]

   1:MQSeriesExplorer       ########################################### [100%]

[root@Lugaomqaq MQ_7.5.0.2]#

Post Installations

If you have chosen this installation to be the primary installation on the system, set it as the primary installation.  Execute MQ_INSTALLATION_PATH/bin/setmqinst -i -p MQ_INSTALLATION_PATH where MQ_INSTALLATION_PATH represents the directory where WebSphere MQ is installed. Example

[root@Lugaomqaq ~]# /opt/mqm/bin/setmqinst -i -p /opt/mqm/

118 of 118 tasks have been completed successfuly.

'Installation1' (/opt/mqm) set as the Primary Installation.

[root@Lugaomqaq ~]#

If you want to set up the environment to work with this installation use setmqenv command to set various environment variables for a particular installation of WebSphere MQ

[root@Lugaomqaq ~]# su - mqm

 [mqm@Lugaomqaq ~]$ . /opt/mqm/bin/setmqenv -s

[mqm@Lugaomqaq ~]$

Check that the environment is set up correctly using dspmqver command as follow

[mqm@Lugaomqaq ~]$ dspmqver

Name:        WebSphere MQ

Version:     7.5.0.2

Level:       p750-002-130704.TRIAL

BuildType:   IKAP - (Production)

Platform:    WebSphere MQ for Linux (x86-64 platform)

Mode:        64-bit

O/S:         Linux 2.6.18-308.el5

InstName:    Installation1

InstDesc:   

Primary:     Yes

InstPath:    /opt/mqm

DataPath:    /var/mqm

MaxCmdLevel: 750

[mqm@Lugaomqaq ~]$

Verifying Installation

To verify installation configure the default queue manager, use the amqsput sample program to put a message on the queue, then use the amqsget sample program to get the message back from the queue

Log in as a user in the mqm group use command crtmqm to create a queue manager called QMA as follows

[mqm@Lugaomqaq ~]$ crtmqm QMA

WebSphere MQ queue manager created.

Directory '/var/mqm/qmgrs/QMA' created.

The queue manager is associated with installation 'Installation1'.

Creating or replacing default objects for queue manager 'QMA'.

Default objects statistics : 74 created. 0 replaced. 0 failed.

Completing setup.

Setup completed.

[mqm@Lugaomqaq ~]$

Use strmqm command to start the queue manager QMA as follow:

[mqm@Lugaomqaq ~]$ strmqm QMA

WebSphere MQ queue manager 'QMA' starting.

The queue manager is associated with installation 'Installation1'.

5 log records accessed on queue manager 'QMA' during the log replay phase.

Log replay for queue manager 'QMA' complete.

Transaction manager state recovered for queue manager 'QMA'.

WebSphere MQ queue manager 'QMA' started using V7.5.0.2.

[mqm@Lugaomqaq ~]$

Start MQSC to define a local queue called QUEUE1 then stop MQSC as follows

[mqm@Lugaomqaq ~]$ runmqsc QMA

5724-H72 (C) Copyright IBM Corp. 1994, 2011.  ALL RIGHTS RESERVED.

Starting MQSC for queue manager QMA.

DEFINE QLOCAL (QUEUE1)

     1 : DEFINE QLOCAL (QUEUE1)

AMQ8006: WebSphere MQ queue created.

end

     2 : end

One MQSC command read.

No commands have a syntax error.

All valid MQSC commands were processed.

[mqm@Lugaomqaq ~]$

Change into the MQ_INSTALLATION_PATH/samp/bin directory. Execute "./amqsput QUEUE1 QMA" command, type the message e.g. Hello Tanzania then place enter twice

[mqm@Lugaomqaq ~]$ cd /opt/mqm/samp/bin/

[mqm@Lugaomqaq bin]$

[mqm@Lugaomqaq bin]$ ./amqsput QUEUE1 QMA

Sample AMQSPUT0 start

target queue is QUEUE1

Hello Tanzania

Sample AMQSPUT0 end

[mqm@Lugaomqaq bin]$

Get the messages from the queue as follow:

[mqm@Lugaomqaq bin]$ ./amqsget QUEUE1 QMA

Sample AMQSGET0 start

message

no more messages

Sample AMQSGET0 end

[mqm@Lugaomqaq bin]$

Start WebSphere MQ Explorer GUI

Log in as a user in the mqm group then run MQExplorer command

[mqm@Lugaomqaq ~]$  MQExplorer