Install the IBM MQ client on HP Integrity NonStop Server

Install the IBM MQ client on a HP Integrity NonStop Server system.

Before you begin

Before you start the installation procedure, make sure that you complete the necessary steps that are outlined in Set up the user and group on HP Integrity NonStop Server.

After preparing your system for installation, install the IBM MQ client for HP Integrity NonStop Server by following the instructions. After installation, you might want to verify your installation to check that it installed successfully. There are three steps to the installation:

1. Downloading the installation package.
2. Running the installer.
3. Set the environment.

Procedure

1. Log in to the OSS user ID that owns the installation. The OSS user ID must have MQM as its primary group.
2. Download the installation package file. Ensure that we use "binary mode" when we download the installation package file to OSS. Any corruption in the file causes the self-extracting archive to fail to run. After we have downloaded the package file, ensure that it has read and execute permissions for the user ID that is installing the package.
3. Set the _RLD_FIRST_LIB_PATH variable to MQ_INSTALLATION_PATH/opt/mqm/bin
4. Optional: Make your current directory the location of the installation file.
5. Type the following command to start the interactive installation procedure:

   ./name of package file -i OSS install_root -g Guardian install_root
   

   where

   name of package file> is the name of the installation package.

   OSS install_root is the OSS root directory of the new installation.

   Guardian install_root is the Guardian subvolume for the new installation.

   Both -i and -g options are mandatory.
   • -i specifies the new or empty OSS directory that contains the opt/mqm and var/mqm directories of the installation.
   • -g specifies the subvolume into which the Guardian components of the IBM MQ client for HP Integrity NonStop Server are installed. The Guardian subvolume can be specified in either OSS-form or Guardian-form and can be abbreviated. The Guardian subvolume specification is not case sensitive. The following examples show valid Guardian subvolume specifications:
     • /G/vol/subvol
     • vol/subvol
     • \$VOL.SUBVOL
     • vol.subvol
6. Optional: For OSS, set your environment by installing the binary files into your path. To do this, type the following command:

   export PATH=$PATH:OSS_install_root/opt/mqm/bin
   

   where OSS_install_root is the OSS root directory of the new installation.

Example

To install the IBM MQ client for HP Integrity NonStop Server from package mat1.run, type the following command:

./mat1.run -i ~install/mq75client -g /G/data04/mqm

The command installs the OSS components into new opt/mqm and var/mqm directories in ~install/mq75client. It installs the Guardian components into /G/data04/mqm.

What to do next

For instructions on how to verify your installation, see Testing communication between a client and a server on HP Integrity NonStop Server.