IBM® MQ Internet Pass-Thru (MQIPT) is available on AIX®, Linux®,
and Windows. You can install MQIPT wherever you want on your computer, and can have several
installations on the same system.
About this task
Each installation can be used and maintained separately. For example, you can have different fix
pack levels of MQIPT installed in different locations
if you choose.
The installation location is not fixed. MQIPT can
be installed anywhere on the system. It is not necessary to set the system PATH
or CLASSPATH environment variables to refer to MQIPT.
The MQIPT commands can be invoked from any location
and MQIPT automatically detects its own location. You
might choose to add the MQIPT
bin directory to the PATH environment variable for
convenience, but it is not mandatory to do so.
You can also install MQIPT alongside previous
versions of MQIPT. You can have only one installation
of MQIPT version 2.0 on the same system because of the
installation method used by version 2.0.
If you run MQIPT as a system service, you can
install only one such service on each system. You cannot install more than one MQIPT service on the same system, either from the same MQIPT installation or from different installations. Also, only
the installation of MQIPT that installed the service
can be used to remove it. For example, if you have two MQIPT installations, one in C:\mqipt1 and
one in C:\mqipt2, and you run the command C:\mqipt1\bin\mqiptService
-install C:\mqipt1
, then only the mqiptService command from the
C:\mqipt1 installation can subsequently be used to remove the service.
Attempting to remove the service using a different installation causes error MQCPE083.
Procedure
To install MQIPT, complete the following
steps:
- Download the MQIPT package for the platform you require from IBM
Fix Central for IBM MQ. The MQIPT for
IBM MQ 9.1.x packages are available under the following
names:
Platform
|
Archive file
|
AIX
|
9.1.x.0-IBM-MQIPT-AIXPPC64.tar.Z |
Linux x86 (64 bit) |
9.1.x.0-IBM-MQIPT-LinuxX64.tar.gz |
Linux zSeries |
9.1.x.0-IBM-MQIPT-LinuxS390X.tar.gz |
Linux PPC (Little Endian) |
9.1.x.0-IBM-MQIPT-LinuxPPC64LE.tar.gz |
Windows (64 bit) |
9.1.x.0-IBM-MQIPT-Win64.zip |
- Choose the location where you want MQIPT to
be installed.
When you unpack the MQIPT
installation archive file, a directory called mqipt is created, and the
installation files are all placed in this directory. If necessary, create a new directory where you
want MQIPT to be installed.
For example, on a
UNIX platform, you might use
the following command:
mkdir /opt/mqipt/installation1
- Unpack the installation archive file into the MQIPT directory by using an appropriate tool for your
platform.
Note: The tar command on UNIX and Linux systems must be run as the root user when installing MQIPT. Failure to run the tar command as
root is likely to result in "permission denied" errors.
For example, on a
Linux platform, you might use
the following commands, if the archive file was downloaded to the
/tmp
directory:
cd /opt/mqipt/installation1
su root
tar xzvf /tmp/9.1.4.0-IBM-MQIPT-LinuxX64.tar.gz
- To increase security, set the file permissions for the installed files so that they are
read-only:
- If you subsequently receive error message MQCPE080
Unable to determine MQIPT installation
directory, set the MQIPT_PATH environment variable to the absolute path
of the MQIPT installation directory.
You do not normally have to set the PATH or CLASSPATH
environment variables for MQIPT because the
installation includes a Java runtime environment (JRE). However,
under some circumstances (for example, if you use symbolic links), MQIPT commands are unable to determine the installation
directory. This can be corrected by setting the MQIPT_PATH environment
variable.
For example, if your installation directory is
/opt/mqipt/installation1/mqipt, you might use the following commands:
MQIPT_PATH=/opt/mqipt/installation1/mqipt
export MQIPT_PATH
- On Windows platforms,
create MQIPT icons on the Start menu.
Run the following command from an administrator command prompt:
C:\mqipt_path\bin\mqiptIcons -install installation_name
where
- mqipt_path is the directory where MQIPT is installed.
- installation_name is a name that you choose to distinguish this installation
from any other. The name is appended to the name of the MQIPT icons.
What to do next
Follow the scenarios in Getting started with IBM MQ Internet Pass-Thru to verity that
MQIPT is installed correctly, and to configure
MQIPT in simple scenarios.For information on
configuring and administering MQIPT, see Administering and configuring IBM MQ Internet Pass-Thru.