You 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 V8.0 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.
- 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:
- Create directory /etc/rpm
- 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 that you want to install. The components and package names are listed in Choosing what to install.
Procedure
-
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. 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.
-
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 you can proceed with the installation.
-
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.
-
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, you can
set the
TMPDIR environment variable before you run the
crtmqpkg command. For example:
TMPDIR=/test ./crtmqpkg
-
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
-
Install IBM MQ.
At a minimum, you must install the
MQSeries®Runtime
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
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.
Note the following:
- 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 8.0.0.2.
|
MQSeriesRuntime MQSeriesJRE |
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 8.0.0.2.
|
MQSeriesRuntime MQSeriesJRE |
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 |
IBM MQ Managed File Transfer component |
MQSeriesRuntime
MQSeriesJava
MQSeriesJRE
|
MQSeriesFTLogger |
IBM MQ Managed File Transfer component |
MQSeriesRuntime
MQSeriesFTBase
MQSeriesJava
MQSeriesJRE
|
MQSeriesFTTools
MQSeriesFTAgent
|
IBM MQ Managed File Transfer components |
MQSeriesRuntime
MQSeriesFTBase
MQSeriesJava
MQSeriesJRE
|
MQSeriesFTService |
IBM MQ 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 8.0.0.2.
|
MQSeriesRuntime
|
Results
You have installed the packages you require.