+

Search Tips | Advanced Search

Install MQIPT

From version 2.1 of MQIPT, we can install the product wherever you want on your computer, and can have several installations at the same time.


About this task

Each installation can be used and maintained separately, so 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 version 2.1 can be installed anywhere on the system. It is no longer 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 version 2.1 alongside version 2.0. 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.

If you run MQIPT as a system service, we can install only one such service on each system. We 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 we 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 version 2.1, complete the following steps:

  1. 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
  2. Unpack the installation archive file into the MQIPT directory by using an appropriate tool for your platform. Note that the tar command on UNIX and Linux systems must be run as the root user. Choose the correct installation archive file for your platform. The readme file supplied with MQIPT specifies the exact operating system versions that are supported.
    Platform Archive file
    AIX ms81_rios_aix_4.tar
    HP-UX ms81_ia64_hpux_11.tar
    Linux x86 (32 bit) ms81_x86_linux_2.tar
    Linux x86 (64 bit) ms81_amd64_linux_2.tar
    Linux zSeries ms81_s390x_linux_2.tar
    Solaris SPARC ms81_sparc_solaris_2.tar
    Solaris x86 (64 bit) ms81_amd64_solaris_2.tar
    Windows (32 bit) ms81_x86_nt_4.zip
    For example, on an AIX platform, you might use the following commands, if the archive file was downloaded to the /tmp directory: 
    cd /opt/mqipt
su root
tar xvf /tmp/ms81_rios_aix_4.tar
  3. To increase security, set the file permissions for your 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 a-w

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

  4. If you subsequently receive error 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 PATH or CLASSPATH 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, you might use the following commands: 
    MQIPT_PATH=/opt/mqipt
export MQIPT_PATH
  5. On Windows platforms, create MQIPT icons on the Start menu. Run the following command from a command line: 
    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.