Operations Guide
UM Installation

Different versions of UM have some differences in how the files are offered for download. As of 6.11, the following zip files are available for download:

  • UMS_version.zip - Streaming Edition.
  • UMP_version.zip - Persistence Edition.
  • UMQ_version.zip - Queuing Edition.
  • UMDRO_version.zip - DRO.
  • UM_version_doc.zip - Documentation package.

The first four contain the binary software for that product (all platforms). The last contains HTML and PDF documentation for all UM products and features.

For the binary software, the zip file contains a set of per-platform package installers, and a set of Java jar files. The jar files should be copied to wherever you keep your Java jars. The package installers should be installed as described below.

There are many different ways to install UM on a host, but they can generally be categorized in three groups:


UM Package Installer  <-

Running the UM package installer is typically only done for hosts being prepared for development use. Once an application system is developed, UM is usually installed by the user's own Application Installer.

Note that the DRO package installer needs the corresponding version of UM to be already installed and accessible in the current working directory before it can be installed.


Unix Package Installer  <-

A product's Unix Package Installer is an executable file with the file suffix ".sh". It is in the form of a self-extracting archive, sometimes called a "shell archive".

It is often necessary to set the file permissions to allow execution of the file.

Running the UM Package Installer on a Unix host does nothing more than copy the files under the current working directory. The installer does not perform any other installation actions.

For example, to install the UMQ base product:

$ chmod +x UMQ_6.17_Linux-glibc-2.17-x86_64.sh
$ ./UMQ_6.17_Linux-glibc-2.17-x86_64.sh

This creates a directory named "UMQ_6.17" which contains all the files and sub-directories needed to develop and test UM-based applications. It does not contain the documentation, which is shipped in its own zip file.


Windows Package Installer  <-

A product's Windows Package Installer is an executable file with the file suffix ".exe".

Running the UM Package Installer on a Windows host does the following:

  • Copies the files into the proper "Program File" folder, depending on whether the package is 32 or 64 bits.
  • Updates the system "PATH" environment variable to include UM's "bin" folder.
  • Optionally installs one or more daemons as Windows Services (see UM Daemons as Windows Services for more information).
  • Provides a standard Windows uninstaller which can be run from the normal Windows "Add or Remove Programs" control panel.

To run the installer, simply double-click the package installer icon.

Note that once an application system is developed, UM is usually installed by the user's own Application Installer.


Other Package Installers  <-

Java

The UM Java API is a wrapper around the UM dynamic library (JNI). The jar files are shipped with the package installers, and should be saved wherever you store your jar files.

Note that the Java jar file version must match the underlying UM library version.

Stratus OpenVOS Package

The Stratus OpenVOS package is a self-extracting archive that contains the Ultra Messaging Streaming Edition (UMS) for the Stratus OpenVOS platform.

Ultra Messaging supports Stratus OpenVOS Release 17.0.2aq.

RESTRICTIONS:

The following Ultra Messaging components and features do not run on the Stratus OpenVOS platform:

  • Ultra Messaging daemons (tnwgd, ummd, stored, lbmrd, SRS).
  • Java API and .NET API.
  • UM transports LBT-IPC, LBT-RDMA, or LBT-SMX.
  • Accelerated Multicast.
  • Persistence.
  • Queuing (including ULB).
  • Ultra Messaging Desktop Services (UMDS).

HP NonStop Package

The HP NonStop package is a self-extracting archive that contains the Ultra Messaging Persistence Edition (UMP) for the HP NonStop platform.

Ultra Messaging supports HP NonStop Version J06-17.

RESTRICTIONS:

The following components and features do not run on the HP NonStop platform.

  • Ultra Messaging daemons (tnwgd, ummd, stored, lbmrd, SRS).
  • Java API and .NET API
  • UM transports LBT-IPC, LBT-RDMA, or LBT-SMX
  • Accelerated Multicast
  • Queuing (including ULB).
  • Ultra Messaging Desktop Services (UMDS).


Copy UM Runtime Files  <-

It is generally not necessary to run the UM Package Installer to use UM on a host. For the most part, all you need to do is copy the runtime files to any desired location on your host. In the case of running UM daemons as Windows Services, there are some additional steps necessary; see Copy Windows Runtime Files.


Copy Unix Runtime Files  <-

Informatica generally recommends that UM runtime files be stored in the "lib" and "bin" sub-directories in the structure that the installer creates. If the brokered queuing feature is used, then the "broker" sub-directory should also be included. For example:

$ ls ~/UMQ_6.17/Linux-glibc-2.17-x86_64/
bin/ broker/ lib/

Notice that the "include" sub-directory is missing. Those files are only needed for development, not for production runtime.

For ease of use, users typically include "lib" in their library search path (e.g. "LD_LIBRARY_PATH" environment variable), and include "bin" in their "PATH".

No other specialized installation steps are needed for UM.

Alternatively, the contents of "bin" can be copied to wherever you already store your application executables, and the contents of "lib" can be copied to wherever you store your application dynamic libraries.


Copy Windows Runtime Files  <-

Informatica generally recommends that UM runtime files be stored in the "bin" sub-folder in the structure that the installer creates. If the brokered queuing feature is used, then the "broker" sub-directory should also be included. For example:

> dir "c:\Program Files\Informatica\UMQ_6.17\Win2k-x86_64"
... <DIR> bin
... <DIR> broker

Notice that the "include" and "lib" sub-folders are missing. Those files are only needed for development, not for production runtime.

For ease of use, users typically include "bin" in their "PATH" environment variable.

No other specialized installation steps are needed for UM applications. However, if you want to run one or more UM daemons as Windows Services, then there are some additional steps necessary, described in UM Daemons as Windows Services.

Alternatively, the contents of "bin" can be copied to wherever you already store your application executables.

Note
If it is desired to uninstall UM that was installed by copying files, UM will not show up in the normal Windows "Add or Remove Programs" control panel. If you have installed UM daemons as Windows Services, then you must manually remove them as Services before deleting the UM runtime files. See Remove the Windows Service.


Application Installer  <-

UM is intended to be integrated into a user's own application system. Each user decides how his application system is packaged and installed.

UM users typically do not run the UM package installer as part of their application installation procedure. Rather, the UM runtime files are typically packaged with the user's application files.

The requirements for the user's application installation procedure are the same as outlined in Copy UM Runtime Files, and for the most part, consist simply of copying the UM files to the host.

In the case of running UM daemons as Windows Services, there are some additional steps necessary; see Copy Windows Runtime Files.