Installing an IBM MQ server on Linux Ubuntu using Debian packages

We can install an IBM MQ server on a Linux Ubuntu system, using a Debian installer, in accordance with the system requirements web page.

Before starting

See System Requirements for IBM MQ for details of the supported software levels.

Before starting the installation procedure, make sure that you first complete the necessary steps outlined in Preparing the system on Linux.

If we have installed IBM MQ Version 9.0.2, or earlier, on Ubuntu using rpm, we must uninstall all rpm versions of the product before installing the Debian version of the product.

About this task

dpkg

We can use dpkg to install individual packages, but we 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.

apt

We can use the apt tool to install packages, and we do not need to install any dependent packages. The apt tool installs dependency packages for the package that you require.

We 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 DIRNAME is the directory into which you unpacked the tar.gz package.

Attention: If we do not make your files accessible to the apt tool, you receive the following errors:

• 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.

where /sw/9101deb is the directory from which we are installing IBM MQ.

To support the running of a queue manager, we must install at least the ibmmq-runtime and the ibmmq-server components.

Procedure

1. Open a shell terminal and set your current directory to the location of the installation packages. The location might be the mount point of the server DVD, a network location, or a local file system directory. We must have root authority to run the following commands. We can do so by adding sudo before the following commands, or by changing to the root user in the shell with the su command.
2. For Long Term Support before Version 9.2.0 and Continuous Delivery before Version 9.1.5, we must accept the terms of the license agreement before we can proceed with the installation. To do this run the mqlicense.sh script:

   ./mqlicense.sh

   The license agreement is displayed in a language appropriate to the 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, ./mqlicense.sh -text_only

3. From Version 9.2.0, 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.
4. 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 we want along with their dependency packages.
   • To use the dpkg command to install the IBM MQ packages that we want, issue the dpkg command for each IBM MQ package that we want to install. For example, issue the following command to install the run time package:

     dpkg -i ibmmq-runtime_9.2.0.0_amd64.deb

     Important: Although dpkg permits multiple package files in the same command, this will not work as expected because of IBM MQ inter-package dependencies. We must install the packages individually in the order shown below. You may find that using apt is a better option.
     • ibmmq-runtime
     • ibmmq-jre
     • ibmmq-java
     • ibmmq-gskit
     • ibmmq-server
     • ibmmq-web
     • ibmmq-ftbase
     • ibmmq-ftagent
     • ibmmq-ftservice
     • ibmmq-ftlogger
     • ibmmq-fttools
     • ibmmq-amqp
     • ibmmq-ams
     • ibmmq-xrservice
     • ibmmq-explorer
     • ibmmq-client
     • ibmmq-man
     • ibmmq-msg_language
     • ibmmq-samples
     • ibmmq-sdk
     • ibmmq-sfbridge
     • ibmmq-bcbridge

   • To use the apt management tool to install the IBM MQ packages that we want along with their dependency packages:
     1. 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 deb entry for the location of the directory that contains the IBM MQ packages.

        For example:

        # Local directory containing IBM MQ packages 
        deb [trusted=yes] file:/var/tmp/mq ./
        

        The inclusion of the [trusted=yes] statement (including the brackets) is optional and suppresses warnings and prompts during subsequent operations.
     2. Run the command apt update to add this directory, and the list of packages the directory contains, to the apt cache.We can now use apt to install IBM MQ. For example, we can install the complete product by issuing the following command:

        apt install "ibmmq-*" 

        We can install the server package and all its dependencies by issuing the following command:

         apt install ibmmq-server 

        Attention: Do not run the apt install ibmmq-* command in the directory which holds the .deb files, unless we are using quotation characters in the shell.

        If we are using tools such as aptitude or synaptic, the install packages can be found in the misc\non-free category.

Results

We have installed the packages you require.

What to do next

• If required, we 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_PATH

  where MQ_INSTALLATION_PATH represents the directory where IBM MQ is installed.

• We might want to set up the environment to work with this installation. We 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.
• To confirm that the installation was successful, we can verify your installation. See Verify an IBM MQ installation on Linux, for more information.

Parent topic: Installing IBM MQ on Linux Ubuntu using Debian

Related tasks

• Uninstalling or modifying IBM MQ on Linux Ubuntu using Debian packages