You can install an IBM® MQ server on a 64-bit
Linux® system.
Before you begin
- If you install a copy of IBM MQ server for Linux using Electronic Software Download, obtained from Passport Advantage, you need to decompress the
tar.gz file by using the gunzip
command:
gunzip IBM_MQ_V9.0_TRIAL_FOR_LINUX_ML.tar.gz
and extract the
installation files from the tar file, by using the following command:
tar -xvf IBM_MQ_V9.0_TRIAL_FOR_LINUX_ML.tar
Important: You must
use GNU tar (also known as gtar
) to unpack any tar
images.
- Before you start the installation procedure, ensure that you have completed the necessary steps
outlined in Preparing the system on Linux.
- If this installation is not the first installation on the system, you must ensure that the
crtmqpkg command can write to a temporary location. By default, the
crtmqpkg command will write to the /var/tmp directory. To
use a different location, you can set the TMPDIR environment variable before you
run the crtmqpkg command.
- To run the crtmqpkg command used in this task, you must have the
pax command or rpmbuild installed.
Attention: pax and rpmbuild are not supplied as part of the product. You
must obtain these from your Linux distribution
supplier.
From IBM MQ 9.1.5 you have the option
to accept the license before or after product installation. See License acceptance on IBM MQ for Linux for
more information.
About this task
Install the server by using the RPM Package Manager installer to select the components you want
to install. The components and package names are listed in IBM MQ rpm components for Linux systems.
Attention: If you install the packages using the wildcard character, that is, using the
command
rpm -ivh MQ*.rpm
, you should install the packages in the following order:
- MQSeriesRuntime
- MQSeriesJRE
- MQSeriesJava
- MQSeriesServer
- MQSeriesWeb
- MQSeriesFTBase
- MQSeriesFTAgent
- MQSeriesFTService
- MQSeriesFTLogger
- MQSeriesFTTools
- MQSeriesAMQP
- MQSeriesAMS
- MQSeriesXRService
- MQSeriesExplorer
- MQSeriesGSKit
- MQSeriesClient
- MQSeriesMan
- MQSeriesMsg
- MQSeriesSamples
- MQSeriesSDK
- MQSeriesSFBridge (Deprecated)
- MQSeriesBCBridge (Deprecated)
Procedure
-
Log in as root, or switch to the superuser by using the
su command.
-
Set your current directory to the location of the installation file. The location might be the
mount point of the server DVD, a network location, or a local file system directory.
-
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
-
For Continuous Delivery from IBM MQ 9.1.5, you have the option of accepting the license before or
after installing the product.
-
If this installation is not the only 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. To
run the crtmqpkg command to run on Linux, you must install the pax command
and rpmbuild, which is located in the rpm-build package.
Note: The crtmqpkg command is required only if this is not the first installation
of IBM MQ on the system. If you have earlier versions of
IBM MQ installed on your system, then installing the
latest version works correctly if you install it in a different location.
To run the crtmqpkg command on a Linux system:
-
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 suffix
-
Set your current directory to the location specified when the crtmqpkg
command operation completes successfully.
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. For example, using a suffix of "1":
./crtmqpkg 1
means there is a subdirectory named
/var/tmp/mq_rpms/1/x86_64.
The packages are renamed according to the subdirectory, for example:
From: MQSeriesRuntime-8.0.0-0.x86_64.rpm
To: MQSeriesRuntime-1-8.0.0-0.x86_64.rpm
-
Install IBM MQ.
To support the running of a queue manager, you must install at least the MQSeriesRuntime,
MQSeriesServer, and MQSeriesGSKit components.
- To install to the default location, /opt/mqm, use the rpm
-ivh command to install each component that you require.
For example, to install the
runtime and server components to the default location, use the following command:
rpm -ivh MQSeriesRuntime-*.rpm MQSeriesServer-*.rpm
To install all
components that are available in your current location on the installation media to the default
location, use the following command:
rpm -ivh MQSeries*.rpm
Important: The components that you need to install might not all be in the same folder on the
installation media. Some components might be under the
/Advanced folder. For
more information about installing
IBM MQ Advanced components,
see
Installing IBM MQ Advanced for Multiplatforms.
- To install to a non-default 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. 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 and server components
to the
/opt/customLocation directory on a 64-bit
Linux system:
rpm --prefix /opt/customLocation -ivh MQSeriesRuntime-*.rpm MQSeriesServer-*.rpm
Results
You installed IBM MQ on your Linux system.
What to do next
- If required, you can now set this installation to be the primary installation. Enter the
following command at the command prompt:
MQ_INSTALLATION_PATH
/bin/setmqinst -i -p MQ_INSTALLATION_PATH
where MQ_INSTALLATION_PATH
represents the directory where
IBM MQ is installed.
You can have only one primary installation on a system. If there is already a primary
installation on the system, you must unset it before you can set another installation as the primary
installation. For more information, see Changing the primary installation.
- 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.
- If you want to confirm that the installation was successful, you can verify your installation.
See Verifying an IBM MQ installation on Linux, for more information.
- Only a user with a UID that is a member of the mqm group can issue
administration commands. If you want to enable users to issue administration commands, they must be
added to the mqm group. For more information, see Setting up the user and group on Linux and Authority to administer IBM MQ on UNIX, Linux, and Windows systems.