Plan the client installation on HP Integrity NonStop Server

This section describes what to do to prepare your HP Integrity NonStop Server system for installing the IBM MQ client for HP Integrity NonStop Server.


Understanding multiple installations

The IBM MQ client for HP Integrity NonStop Server can be installed more than once on an HP Integrity NonStop Server system. In addition, multiple different versions of the client can be installed on a single HP Integrity NonStop Server system, and be maintained independently.

To install IBM MQ client for HP Integrity NonStop Server, you must specify two locations; one in the OSS file system, and one in the Guardian file system, which is used by the installer to store the results of the installation. These locations must not contain or overlap with any other IBM MQ client for HP Integrity NonStop Server installation. The locations must also be free of other files.

Each installation is independent and self-contained, with all data, such as configuration logs, or trace and program files located within the installation directory hierarchy. All commands and libraries use an embedded runtime search path (RPath) to ensure that they load their dependencies from the same installation.

As several installations might be present, each application must locate and load the IBM MQ client libraries from the correct installation.

  • For native applications, an application that is linked with the IBM MQ MQIC.LIB installation library inherits the IBM MQ installation RPATH, and can run without environment variables. Environment variables in OSS, for example, _RLD_LIB_PATH or DEFINEs in Guardian, are only required if you want to run the application using a different IBM MQ installation.
  • For Java applications using the Java Messaging Service (JMS) API, the client Java archive (JAR) must be from the correct installation, and must be included on the class path. For more information, see Environment variables used by IBM MQ classes for JMS.


Product packaging and delivery

IBM MQ client for HP Integrity NonStop Server is downloaded to the OSS file system as a single file.

The IBM MQ client for HP Integrity NonStop Server package file is a self-extracting archive (SFX) that contains an installer and all files that are required to create installations.

The SFX for IBM MQ client for HP Integrity NonStop Server has a file extension of .run. There is no concept of placed files. When run, the SFX creates a single installation, directly from the archive, into the OSS and Guardian file systems.

The SFX can be used to create as many installations of the IBM MQ client for HP Integrity NonStop Server as you require. No information about installations is retained in the SFX, and no tools are provided for extracting individual files from the SFX.