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.

1. Open a shell terminal. Log in as root, or with sufficient authority to run the following commands.

   You can do this by adding sudo before the commands, or by changing to the root user in the shell with the su command. For more information, see Exploring the differences between sudo and su commands in Linux.

2. Set your current directory to the location of the installation packages.

   The location might be a network location, or a local file system directory. See Where to find downloadable installation images.

3. From IBM MQ 9.2.0, you have the option of accepting the license before or after installing the product. To accept the license before installing, 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 

   See Accepting the license on IBM MQ for Linux for more information about license acceptance.
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-get 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-gskit 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 (GSKit)	ibmmq-runtime ibmmq-jre
   ibmmq-sfbridge 4.a	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 4.b 4.c	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

   Notes:

   1. The IBM MQ Bridge to Salesforce is deprecated across all releases from November 22 2022 (see US Announcement letter 222-341).
   2. The IBM MQ Bridge to blockchain is deprecated across all releases from November 22 2022 (see US Announcement letter 222-341). Blockchain connectivity can be achieved with IBM App Connect or through App Connect capabilities available with IBM Cloud Pak® for Integration.
   3. For Continuous Delivery, the IBM MQ Bridge to blockchain is removed from the product at IBM MQ 9.3.2.