Install IBM MQ client on Linux Ubuntu or Linux on POWER Systems - Little Endian

We can install an IBM MQ client on a Linux Ubuntu , or Linux on POWER® Systems - Little Endian, system 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.
  • Ensure that RPM is installed on your system, as RPM is not installed by default on this platform.

    To determine if the correct RPM package is installed on you system, see Checking the availability of RPM on your machine.

  • Once RPM is installed on your system, carry out the following procedure, as root:
    1. Create directory /etc/rpm
    2. Add file /macros, containing the following code, %_dbpath /var/lib/rpm, to the /etc/rpm directory.
    Attention: You should only set up a /macros file if you are not already using RPM, as the previous instruction changes the default system-wide RPM database.


About this task

Install the client by using the RPM Package Manager installer to select the components to install. The components and package names are listed in IBM MQ components and features.


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. If this installation is not the first installation of IBM MQ on the system, you must run the crtmqpkg command to create a unique set of packages to install on the system. For the crtmqpkg command to run on Linux, you must install the pax command and rpmbuild, which is located in the rpm package.
    1. Enter the following command: 
      ./crtmqpkg suffix
      where suffix is a name of your choosing, that uniquely identifies the installation packages on the system. suffix is not the same as an installation name, although the names can be identical. suffix is limited to 16 characters in the ranges A-Z, a-z, and 0-9. Note: This command creates a full copy of the installation packages in a temporary directory. By default, the temporary directory is located at /var/tmp. You must ensure that the system has enough free space before you run this command. To use a different location, we can set the TMPDIR environment variable before you run the crtmqpkg command. For example: 
      TMPDIR=/test ./crtmqpkg
    2. Set your current directory to the location specified when the crtmqpkg command completes. This directory is a subdirectory of the /var/tmp/mq_rpms directory, in which the unique set of packages is created. The packages have the suffix value contained within the file name. In the following example, the suffix of "1" ./crtmqpkg 1 means that there is a subdirectory named /var/tmp/mq_rpms/1/i386. The packages are renamed according to the subdirectory, for example, on Linux for System x (64-bit): 
      From: MQSeriesRuntime-8.0.0-0.x86_64.rpm
To: MQSeriesRuntime_1-8.0.0-0.x86_64.rpm
  4. Install IBM MQ. At a minimum, you must install the MQSeriesRuntime component. An additional flag is required when installing on Linux Ubuntu:

    • --force-debian: You must include this option to prevent warning messages from the version of RPM for your platform, which indicates that the RPM packages are not intended to be directly installed using RPM.
    An additional flag is required when installing on Ubuntu 14.04 on Linux on POWER Systems - Little Endian:

    • --ignorearch: You must include this option to prevent problems with some levels of rpm not recognizing the Linux on POWER Systems - Little Endian architecture

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

    Notes:

    • To install to the default location, /opt/mqm, use the rpm -ivh command to install each component that you require. To install the runtime component to the default location on Ubuntu Linux for System x (64-bit), use the following command: 
      rpm -ivh --force-debian MQSeriesRuntime-*.rpm
      To install the runtime component to the default location on Ubuntu Linux on POWER Systems - Little Endian, use the following command: 
      rpm -ivh --force-debian --ignorearch MQSeriesRuntime-*.rpm
      To install all components to the default location on Ubuntu Linux on POWER Systems - Little Endian use the following command: 
      rpm -ivh --force-debian --ignorearch MQSeries*.rpm
    • To install to a nondefault location, use the rpm --prefix option. For each installation, all of the IBM MQ components that you require must be installed in the same location. The installation path specified must be, either an empty directory, the root of an unused file system, or a path that does not exist. Attention: The length of the path is limited to 256 bytes and must not contain spaces. For example, enter the following installation path to install the runtime component to the /opt/customLocation directory on Ubuntu Linux on POWER Systems - Little Endian: 
      rpm --prefix /opt/customLocation -ivh --force-debian --ignorearch
MQSeriesRuntime-*.rpm

    Table 1 lists all available packages on Ubuntu, together with all the associated dependencies.

    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
    MQSeriesRuntime Common function for all other components None
    MQSeriesClient C IBM MQ client libraries MQSeriesRuntime
    MQSeriesJava Java and JMS IBM MQ APIs MQSeriesRuntime
    MQSeriesJRE Java Runtime Environment MQSeriesRuntime
    MQSeriesExplorer

    IBM MQ Explorer

    IBM MQ Explorer is only available on Linux for System x (64-bit).

    Note: There is no IBM support for this component on Ubuntu, unless you are running on Ubuntu Version 14.04 (or later) and have installed IBM MQ Version 8.0.0.2.     		MQSeriesRuntime

    MQSeriesJRE

    GTK2 version 2.2.4-0 or later, including the GTK2 engines that contain the GTK2 themes

    Bitstream-vera-fonts
    MQSeriesGSKit IBM Global Security Kit Note: There is no IBM support for this component on Ubuntu, unless you are running on Ubuntu Version 14.04 (or later) and have installed IBM MQ Version 8.0.0.2. MQSeriesRuntime MQSeries®JRE
    MQSeriesSDK Header files and libraries for non-Java APIs MQSeriesRuntime
    MQSeriesMan UNIX man pages for IBM MQ MQSeriesRuntime
    MQSeriesSamples IBM MQ application samples MQSeriesRuntime

    MQSeriesMsg_cs

    MQSeriesMsg_de

    MQSeriesMsg_es

    MQSeriesMsg_fr

    MQSeriesMsg_hu

    MQSeriesMsg_it

    MQSeriesMsg_ja

    MQSeriesMsg_ko

    MQSeriesMsg_pl

    MQSeriesMsg_pt

    MQSeriesMsg_ru

    MQSeriesMsg_Zh_CN

    MQSeriesMsg_Zh_TW

    		Language specific message catalog files MQSeriesRuntime
    MQSeriesFTBase Managed File Transfer component

    MQSeriesRuntime

    MQSeriesJava

    MQSeriesJRE

    MQSeriesFTLogger Managed File Transfer component

    MQSeriesRuntime

    MQSeriesFTBase

    MQSeriesJava

    MQSeriesJRE

    MQSeriesFTTools

    MQSeriesFTAgent

    		Managed File Transfer components

    MQSeriesRuntime

    MQSeriesFTBase

    MQSeriesJava

    MQSeriesJRE

    MQSeriesFTService Managed File Transfer component

    MQSeriesRuntime

    MQSeriesFTAgent

    MQSeriesFTBase

    MQSeriesJava

    MQSeriesJRE

    MQSeriesAMS Advanced Message Security component Note: There is no IBM support for this component on Ubuntu, unless you are running on Ubuntu Version 14.04 (or later) and have installed IBM MQ Version 8.0.0.2.

    MQSeriesRuntime

    MQSeriesSFBridge

    Install the IBM MQ Bridge to Salesforce to subscribe to Salesforce push topics and platform events.

    From IBM MQ Version 9.0.4 we can also use the bridge to create event messages for Salesforce platform events.

    Note:

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

    ibmmq-runtime

    ibmmq-java

    ibmmq-jre
    MQSeriesBCBridge

    Install the IBM MQ Bridge to blockchain to send queries and updates to, and receive responses from your blockchain network.

    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
    We can have only one primary installation on a system. If there is already a primary installation on the system, you must unset it before we can set another installation as the primary installation. For more information, see Change the primary installation.
  • 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