Installing an IBM MQ server on Linux Ubuntu using Debian packages
You can install an IBM® MQ server on a Linux® Ubuntu system, using a Debian installer, in accordance with the system requirements web page.
Before you begin
See System Requirements for IBM MQ for details of the supported software levels.
Before you start the installation procedure, make sure that you first complete the necessary steps that are outlined in Preparing the system on Linux.
If you have installed IBM MQ 9.0.2, or earlier, on Ubuntu using rpm, you must uninstall all rpm versions of the product before installing the Debian version of the product.
About this task
Ubuntuversion of the tar.gz package, before you install the product, as this version contains the deb files you need for the apt tool.
- You can use dpkg to install individual packages, but you must ensure you install any dependencies as dpkg does not install any dependent packages for the package you require. Refer to the Table 1 table for information about the dependencies of each package.
- You can use the apt tool to install packages, and you do not need to install any dependent packages. The apt tool installs dependency packages for the package that you require.
- You must make your files accessible to the apt tool, in order to use it.
To do this, issue the command,
chmod -R a+rx DIRNAME, where
DIRNAMEis the directory into which you unpacked the tar.gz package.Attention: If you do not make your files accessible to the apt tool, you receive the following errors:where /sw/9101deb is the directory from which you are installing IBM MQ.
- N: Download is performed unsandboxed as root as file '/sw/9101deb/./InRelease' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)
- E: Failed to fetch file:/sw/9101deb/./Packages File not found - /sw/9101deb/./Packages (2: No such file or directory)
- E: Some index files failed to download. They have been ignored, or old ones used instead.
To support the running of a queue manager, you must install at least the
ibmmq-runtime and the
|Package Name||Component Function||Package Dependencies|
|ibmmq-runtime||Common function for all other components||None|
|ibmmq-client||C IBM MQ client libraries||ibmmq-runtime|
|ibmmq-java||Java and JMS IBM MQ APIs||ibmmq-runtime|
|ibmmq-jre||Java Runtime Environment||ibmmq-runtime|
|ibmmq-sdk||Header files and libraries for non-Java APIs||ibmmq-runtime|
|ibmmq-man||UNIX man pages for IBM MQ||ibmmq-runtime|
|ibmmq-samples||IBM MQ application samples||ibmmq-runtime|
|Additional language message catalog files. English message catalog files are installed by default. For more information about these message catalogs, see Displaying messages in your national language on Linux||ibmmq-runtime|
IBM MQ Explorer. Only on Linux x86-64 systems.
IBM Global Security Kit
REST API and IBM MQ Console.
|ibmmq-ftbase||Managed File Transfer component||
|ibmmq-ftlogger||Managed File Transfer component||
|Managed File Transfer components||
|ibmmq-ftservice||Managed File Transfer component||
Advanced Message Queuing Protocol component
Telemetry Service component
Advanced Message Security component
|ibmmq-sfbridge||Install the IBM MQ Bridge to Salesforce to configure
the connections to Salesforce and IBM MQ, then run the command runmqsfb to
subscribe to events from Salesforce and publish them to an
IBM MQ network.
The IBM MQ Bridge to Salesforce is available only on Linux for x86-64 (64 bit).
Install the IBM MQ Bridge to blockchain to send queries and updates to, and receive responses from your blockchain network.
The IBM MQ Bridge to blockchain is available only on Linux for x86-64 (64 bit).
Open a shell terminal and set your current directory to the location of the installation
The location might be the mount point of the server DVD, a network location, or a local file system directory. You must have root authority to run the following commands. You can do so by adding sudo before the following commands, or by changing to the root user in the shell with the su command.
For Long Term Support and Continuous Delivery before IBM MQ 9.1.5, you must accept the terms of the license agreement
before you can proceed with the installation.
To do this run the mqlicense.sh script:
The license agreement is displayed in a language appropriate to your environment and you are prompted to accept or decline the terms of the license.
If possible, mqlicense.sh opens an X-window to display the license.
If you need the license to be presented as text in the current shell, which can be read by a screen reader, type the following command,
For Continuous Delivery from IBM MQ 9.1.5, you have the option of accepting the license before or
after installing the product.
See License acceptance on IBM MQ for Linux for more information.
Choose how to install the IBM MQ packages:
Either use the dpkg command to install the IBM MQ packages that you want, or use the apt management tool to install the IBM MQ packages that you want along with their dependency packages.
- To use the dpkg command to install the IBM MQ packages that you want, issue the dpkg
command for each IBM MQ package that you want to
install. For example, issue the following command to install the run time package:
dpkg -i ibmmq-runtime_126.96.36.199_amd64.debImportant: Although dpkg permits multiple package files in the same command, this will not work as expected because of IBM MQ inter-package dependencies. You must install the packages individually in the order shown below. You may find that using apt is a better option.
- To use the apt management tool to install the IBM MQ packages that you want along with their dependency
- Create a file with the suffix
.list, for example,
IBM_MQ.list, in the /etc/apt/sources.list.d directory.
This file should contain a
debentry for the location of the directory that contains the IBM MQ packages.For example:
The inclusion of the
# Local directory containing IBM MQ packages deb [trusted=yes] file:/var/tmp/mq ./
[trusted=yes]statement (including the brackets) is optional and suppresses warnings and prompts during subsequent operations.
- Run the command apt update to add this directory, and the list of packages
the directory contains, to the apt cache.You can now use apt to install IBM MQ. For example, you can install the complete product by issuing the following command:
You can install the server package and all its dependencies by issuing the following command:
apt install "ibmmq-*"
apt install ibmmq-serverAttention: Do not run the
apt install ibmmq-*command in the directory which holds the
.debfiles, unless you are using quotation characters in the shell.
If you are using tools such as aptitude or synaptic, the install packages can be found in the misc\non-free category.
- Create a file with the suffix
- To use the dpkg command to install the IBM MQ packages that you want, issue the dpkg command for each IBM MQ package that you want to install. For example, issue the following command to install the run time package:
You have installed the packages you require.
What to do next
- If required, you can now set this installation to be the primary installation. Enter the
following command at the command prompt:
MQ_INSTALLATION_PATH/bin/setmqinst -i -p
MQ_INSTALLATION_PATHrepresents the directory where IBM MQ is installed.
- You might want to set up the environment to work with this installation. You can use the setmqenv or crtmqenv command to set various environment variables for a particular installation of IBM MQ . For more information, see setmqenv and crtmqenv.
- If you want to confirm that the installation was successful, you can verify your installation. See Verifying an IBM MQ installation on Linux, for more information.