IBM MQ Installation on Linux

IBM MQ v8 Installation procedure in Linux server


 Are you about to Install IBM MQ?

Below are the steps that needs to be followed for a safe and smooth installation on your Linux Machines.

First and foremost, is to outline the procedure:

  • 1.Checking Hardware and Software Requirements


  • 2.System Preparation before IBM MQ installation


  • 3.Installing IBM MQ on Linux  (Here I’ll provide instructions using rpm installation manager)


  • 4.Process to install MQ client binary (Optional step)


  • 5.Verification of IBM MQ installation


  1. Checking Hardware and Software Requirements:

Before we install IBM MQ, we need to make sure that our system meets the hardware and operating system requirements for the smooth installation.

Please refer to IBM official site for detailed requirements sheet for all the Current and previous releases with respect to each Operating system.

Things to be noted:

a) For JMS and SOAP support, IBM Java 7 SDK and Runtime V7.0 or later is required.

Current (while we are talking) version IBM MQ 9.0 is bundled with Java 8 version. You can verify your java installation using command:

$> java -version

Also, JRE does not need to be the JRE that was shipped and installed with IBM MQ but can be any of the one that was listed on IBM Official site.

b) For SOAP support, IBM MQ is shipped with Apache Axis v1.4 though it will not be installed.

c) IBM MQ Explorer can be installed either along with product or can be installed stand-alone using the support pack MS0T.


System Preparation before IBM MQ installation:

On Linux Systems, All the resources, directories and files associated with product IBM MQ are owned by the user ID  : mqm, with a primary group of mqm.

  1. 1. Creation of User ID and group on UNIX/Linux systems: 
    • By default, on Linux, RPM creates the mqm user ID and group ID as part of the installation Process if they do not exist already on system.
    • If we are installing IBM MQ on multiple systems, or planning to configure multi-instance queue managers, or for virtualization scenarios, we must ensure each UID and GID of mqm has the same value on all systems.
  • If we have special requirements for these Linux user ID’s (in case of managed), We must ensure that we create all the ID’s
    before installation.

We can use useradd and groupadd Linux commands to set the same UID and GID on each system.

2. Addition of Existing User ID’s to the mqm group :

If a want to facilitate an existing user to run MQ commands like crtmqm, strmqm , we must add the specific user to the primary        group  mqm. 

Note: userid limit is 12 characters.

3. Masking permissions of Log files:

Permissions for the log files written by queue manager must be properly determined and set by using umask unix command.

Note: ownership of the log files still be set to user mqm.

4. File system Setup Before installation:

Before installing IBM MQ, we might need to create file systems for both the product and working data to be stored.

Default installation directory for the Product can be changed but we cannot change the working directory locations.

Determining the size of the Server file system is very crucial and must be carefully planned to avoid the system space scarcity on     servers.

Below are the points to be considered to determine the size we need for  /var/mqm  file system:

    • a) Queue object count hosted by queue managers each
    • b) The size of log files and error messages.
    • c) Average size of message payload + message header ( ~500 bytes).
    • d) Contingency space for message buildups when there is an issue which lead to Message pileup.
    • e) Maximum message count in peak periods.
  • f) Trace data written by queue managers in /var/mqm/trace directory.

To summarize, the size of the file system must be scaled according to the number of queue managers that we intend to use,  the number of pages per log file, and the number of log files per queue manager.

 Create file systems for Error ( MQ installation/Queue Manager level)  and logs :

File system to hold log data : /var/mqm/log

File system to hold error Data : /var/mqm/errors

It is recommended that the error and log directories are placed on different disks rather than the queue manager run-time data ( /var/mqm/qmgrs).

     5. Linux O/S systems tuning for a better assistance to MQ server 

If there are any O/S level internals like shell, kernel parameters, TCP/IP keepalive for MQ channels, open file handles and Unix processes need to be tuned, must be done at last and we need to make sure, we touch base with Linux admin before we change anything.


Installing IBM MQ:

IBM MQ product is shipped with below components which can be chosen Upon our necessity:

Once we have the below Linux binaries of IBM MQ on your machine we intend to install as shown in below screen, we can proceed with next steps.

  1. 1. Login as a root user.
  2. 2. Set your current directory to the location where your installation binary resides.
  3. gunzip and tar the Linux MQ binary to decompress the tar.gz file by using below commands :

Prompt # > gunzip mqadv_dev80_linux_x86-64.tar.gz

Prompt #> tar -xvf mqadv_dev80_linux_x86-64.tar

Above tar command extracts the installation files into a directory with name MQServer.

MQ Linux Installation Binary
MQ Linux Installation Binary
  1. 3. We must accept the license agreement in order to proceed with installation.To do this , run :./ and hit 1 when prompts to accept license.4.To Install to the default location /opt/mqm Simply run each component that is required.MQSeriesServer and MQSeriesRuntime are two basic components necessary to Support running of a queue manager.If we want to install only MQSeriesServer and MQSeriesRuntime components, then simply we can issue below command:
    rpm -ivh MQSeriesRuntime-*.rpm MQSeriesServer-*.rpm
  2. 5.To install all components to the default location :
    /opt/mqm, Issue command using wildcard as below:
    rpm -ivh MQSeries*.rpm
    As you can see in below screenshot,all the components installed automatically :
























  1. Note: To install it to non-default location, we can make use of  rpm –prefix switch option as below :
  2. rpm –prefix /opt/customlocation -ivh MQSeriesRuntime-*.rpm MQSeriesServer-*.rpm6. We can install each component as listed below :

    Below is the order to be followed:

    IBM MQ Components
    refer above link for more information.

    Below is the Order and V8 packages that were installed as part of this tutorial :

                        rpm -ivh MQSeriesRuntime-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesJRE-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesJava-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesServer-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesFTBase-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesFTAgent-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesFTService-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesFTLogger-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesFTTools-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesAMS-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesXRService-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesExplorer-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesGSKit-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesClient-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesMan-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesMsg_es-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesSamples-8.0.0-4.x86_64.rpm
                        rpm -ivh MQSeriesSDK-8.0.0-4.x86_64.rpm



    7.  You can check all the packages that were installed by using below command : rpm -qa | grep MQ

    IBM MQ Components
    IBM MQ components

    8.  Once we are done with installing all the packages, we need to set the Primary installation as below :

    Goto Installation directory.In this case:prompt#> cd /opt/mqm  and run command:

    ./setmqinst -i -p /opt/mqm

    9. Switch to user mqm and set mq profile using below command:

    prpt#>  .  ./opt/mqm/bin/setmqenv -s

    If installation is in folder : /opt/mqm2 , then issue as below :

    prompt#> .   ./opt/mqm/bin/setmqenv -p /opt/mqm2 -l <LD_LIBRARY_PATH>



    Below command sets up the environment for queue manager QM1 in a 32 bit environment:

    prompt#> . /opt/mqm/bin/setmqenv -m QM1 -x 32






     Complete installation Process of IBM Websphere MQ v8 in Linux Server :



    rpm commands in order to install the IBM MQ Components :






















    For more details on each component, refer IBM official page :

    Disclaimer:  All the product names mentioned are trademarks of IBM, and others. I’m no way associated with IBM and this guide is totally an unofficial document. If there are any suggestions/corrections/feedback – please do let me know. I’ll be happy to change/modify.

Written by Ramesh Metta