Install 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 you begin

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

Before you start the installation procedure, make sure that we have completed the necessary steps outlined in Preparing the system on Linux.


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 the client DVD, a network location, or a local file system directory. You 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. Run the mqlicense.sh script. If you want to view a text-only version of the license, which can be read by a screen reader, type the following message: 
    ./mqlicense.sh -text_only
    The license is displayed.

    You must accept the license agreement before we can proceed with the installation.

  3. Install the IBM MQ client. We can use any Debian installer. Install 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, you must install the ibmmq-runtime component.

    If you are installing a subset of components, you 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, you must also install the components listed in the Package Dependencies column.
    Table 1. Package component dependencies
    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 System x (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 System x (64 bit).

    		 ibmmq-runtime

    ibmmq-java

    ibmmq-jre


Results

You have installed the packages you require.


What to do next

  • If we have chosen this installation to be the primary installation on the system, you 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
  • You 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