[UNIX, Linux, Windows]

Multiple installations on UNIX, Linux, and Windows

On UNIX, Linux®, and Windows, it is possible to have more than one copy of IBM® MQ on a system.

You can choose where each copy of IBM MQ is installed, but each copy must be in a separate installation location. A maximum of 128 installations of IBM MQ can exist on a single machine at a time. You have a choice:
  • Keep the simplicity of maintaining and managing a single installation of IBM MQ on a machine.
  • Take advantage of the flexibility that is offered by enabling multiple IBM MQ installations.

Decisions to make before installing

Before you install multiple copies of IBM MQ, you must make several decisions:
Where will you install each copy of IBM MQ?
You can choose the installation location for your installations at IBM WebSphere® MQ 7.1, or later. For more information, see Installation location on Multiplatforms.
Do you need a primary installation?
A primary installation is an installation to which system-wide locations refer.

For more information, see Primary installation on UNIX, Linux, and Windows.

How will your applications connect?
You need to consider how your applications locate the appropriate IBM MQ libraries. For more information, see Connecting applications in a multiple installation environment, and Connecting .NET applications in a multiple installation environment.
Do your existing exits need changing?
If IBM MQ is not installed in the default location, your exits need to be updated. For more information, see Writing exits and installable services on UNIX, Linux, and Windows .
Which queue manager will be associated with which installation?
Each queue manager is associated with a particular installation. The installation that a queue manager is associated with limits that queue manager so that it can be administered only by commands from that installation. For more information, see Associating a queue manager with an installation.
How will you set up your environment to work with each installation?
With multiple installations on a system, you need to consider how you will work with particular installations, and how you will issue commands from that installation. You can either specify the full path to the command, or you can use the setmqenv or crtmqenv command to set environment variables. Setting the environment variables allows you to omit the path to the commands for that installation. For more information, see setmqenv, and crtmqenv.
When you have answered these questions, you can install IBM MQ after you have read IBM MQ installation overview.
If you have existing installations of IBM MQ and you want to use the multiple installation capability to migrate from one version of IBM MQ to another version, see one of the following platform-specific topics:

The IBM message service client for .NET support pack and multiple installations

For multiple version support, on IBM WebSphere MQ 7.1 or later, the Java and .NET Messaging and Web Services feature must be installed with the IBM MQ product. For more information about installing the .NET feature, see Installing IBM MQ classes for .NET.