Installing MQIPT

IBM MQ Internet Pass-Thru (MQIPT) is available on AIX, Linux, and Windows. We can install MQIPT wherever we want on your computer, and can have several installations on the same system.

Each installation can be used and maintained separately. For example, we 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.

We can also install MQIPT alongside previous versions of MQIPT. We can have only one installation of MQIPT version 2.0 on the same system because of the installation method used by version 2.0.

Procedure

To install MQIPT, complete the following steps:

1. Download the MQIPT package for the platform you require from IBM Fix Central for IBM MQ. The MQIPT Version 9.2.x packages are available under the following names:

   Platform	Archive file
   AIX	9.2.x.0-IBM-MQIPT-AIXPPC64.tar.Z
   Linux x86 (64 bit)	9.2.x.0-IBM-MQIPT-LinuxX64.tar.gz
   Linux zSeries	9.2.x.0-IBM-MQIPT-LinuxS390X.tar.gz
   Linux PPC (Little Endian)	9.2.x.0-IBM-MQIPT-LinuxPPC64LE.tar.gz
   Windows (64 bit)	9.2.x.0-IBM-MQIPT-Win64.zip

2. Choose the location where we 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
   

3. Unpack the installation archive file into the MQIPT directory by using an appropriate tool for the 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.2.0.0-IBM-MQIPT-LinuxX64.tar.gz
   

4. To increase security, set the file permissions for the installed files so that they are read-only:
   • On UNIX or Linux systems, we can use the chmod command. For example:

     chmod -R /opt/mqipt/installation1/mqipt a-w
     

   • On Windows platforms, right-click the installation directory and select Properties. We can change the file permissions on the Security tab.

5. 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 we 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
   

6. 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

For information on configuring and administering MQIPT, see Administer and configuring IBM MQ Internet Pass-Thru.