[V9.1.0 Jul 2018][Linux]

Installing an IBM MQ client on Linux Ubuntu using Debian packages

You 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 you 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. 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.
  2. [Long Term Support] 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:
    ./mqlicense.sh

    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, ./mqlicense.sh -text_only

  3. [V9.1.5 Apr 2020] 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.
  4. Install the IBM MQ client.
    You can use any Debian installer. Installing an IBM MQ server on Linux Ubuntu using Debian packages describes the use of the apt and dpkg 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

    [V9.1.0 Jul 2018]ibmmq-sfbridge (Deprecated)

    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

    [V9.1.0 Jul 2018]ibmmq-bcbridge (Deprecated)

    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

You have installed the packages you require.

What to do next

  • If you 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. 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.
  • For instructions on how to verify your installation, see Testing communication between a client and a server on Linux