IBM MQ - Install MQ server on Linux

If you are not familiar with what IBM MQ (message queue) is, check out our Getting Started page.

Before downloading the installation files, you will want to understand IBM version.release.modification.fixpack. and the differences between Long Term Support (LTS) and Continuous Delivery (CD).

This will download a gzip compressed tar archive, such as MQ_V<version>_CDR_TRIAL_LIN_X86_64-BI.tar.gz. Extract the gzip compressed tar archive. This will create a new folder named MQServer in the /opt directory.

tar -zxvf MQ_V9.0.4_CDR_TRIAL_LIN_X86_64-BI.tar.gz -C /opt


Use the command to view and accept the license agreement.

In /etc/sysctl.conf, set the file limit to be at least 100000.

fs.file-max = 100000


Issue the following command to refresh your users sysctl.

sysctl -p


The rpm command is used to install the product. At a bare minimum, all that is required is the rpm command with the -i or --install option and the rpm files, like this.

rpm -i /opt/MQServer/MQSeriesRuntime-*.rpm
rpm -i /opt/MQServer/MQSeriesServer-*.rpm
rpm -i /opt/MQServer/MQSeriesSamples-*.rpm


However, typically, the -ivh or --install --verbose --hash options are used, like this.

rpm -ivh /opt/MQServer/MQSeriesRuntime-*.rpm
rpm -ivh /opt/MQServer/MQSeriesServer-*.rpm
rpm -ivh /opt/MQServer/MQSeriesSamples-*.rpm


By default, the RPM will be installed to the /opt/mqm directory. The --prefix option can be used to specify an alternate install directory, like this. This is needed if you want to install multiple versions of MQ on a system.

rpm --prefix /opt/mqm904 -ivh /opt/MQServer/MQSeriesServer-*.rpm


Installation name

Once the installation name has been defined, it cannot be changed. 

  • The dspmqinst command can be used to display information about an installation. By default, the first installation will have a name of "Installation1".
  • The crtmqinst command can be used to defined an installation name for for additional installations.
  • The setmqinst command can be used to update the mqinst.ini file to set an installation as the primary installation.
  • The dltmqinst command can be used to delete an installation from the mqinst.ini file.

You will next want to create the queue manager.

Did you find this article helpful?

If so, consider buying me a coffee over at Buy Me A Coffee

Add a Comment

We will never share your name or email with anyone. Enter your email if you would like to be notified when we respond to your comment.

Please enter 1f68c in the box below so that we can be sure you are a human.


Web design by yours truely - me, myself, and I   |   |