+

Search Tips | Advanced Search

Installing an IBM MQ client on Linux Ubuntu using Debian packages

We can install an IBM MQ client on a Linux Ubuntu system, using a Debian package, 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 we have completed the necessary steps outlined in Preparing the system on Linux.


About this task

Install the client by using a Debian installer to select the components that you want to install. The components and package names are listed in IBM MQ Debian components for Linux Ubuntu systems.


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 a 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. Install the IBM MQ client. We can use any Debian installer. Installing an IBM MQ server on Linux Ubuntu using Debian packages describes the use of the dpkg and apt packages to install a server. At a minimum, we must install the ibmmq-runtime component.

    If we are installing a subset of components, we must ensure that any dependencies are first installed, as listed in Table 1.

    To install and use the package listed in the Package Name column, we must also install the components listed in the Package Dependencies column.

    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

    ibmmq-msg-cs

    ibmmq-msg-de

    ibmmq-msg-es

    ibmmq-msg-fr

    ibmmq-msg-hu

    ibmmq-msg-it

    ibmmq-msg-ja

    ibmmq-msg-ko

    ibmmq-msg-pl

    ibmmq-msg-pt

    ibmmq-msg-ru

    ibmmq-msg-zh-cn

    ibmmq-msg-zh-tw

    		Language specific message catalog files ibmmq-runtime
    ibmmq-gskit

    IBM Global Security Kit

    		ibmmq-runtime

    ibmmq-jre

    ibmmq-sfbridge

    IBM MQ Bridge to Salesforce

    Note:

    The IBM MQ Bridge to Salesforce is available only on Linux for x86-64 (64 bit).

    		 ibmmq-runtime

    ibmmq-java

    ibmmq-jre

    ibmmq-bcbridge

    IBM MQ Bridge to blockchain

    Note:

    The IBM MQ Bridge to blockchain is available only on Linux for x86-64 (64 bit).

    		 ibmmq-runtime

    ibmmq-java

    ibmmq-jre


Results

We have installed the packages you require.


What to do next

  • If we have chosen this installation to be the primary installation on the system, we must now set it as the primary installation. Enter the following command at the command prompt: 
     MQ_INSTALLATION_PATH/bin/setmqinst -i -p MQ_INSTALLATION_PATH
  • 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.
  • For instructions on how to verify your installation, see Testing communication between a client and a server on Linux

Parent topic: Installing IBM MQ on Linux Ubuntu using Debian


Related concepts


Related tasks


Related information

Last updated: 2020-10-04