Primary installation

Explanation of the IBM® MQ primary installation.

Overview

The primary installation is:
  • The installation to which system-wide locations refer
  • Optional, but convenient
Note: Prior to IBM WebSphere® MQ 7.1, the only installation was the primary installation. However, if you uninstall IBM WebSphere MQ 7.0.1, and then install IBM WebSphere MQ 7.1, the installation is not by default the primary installation.

UNIX systems

The primary installation:
  • Has symbolic links in /usr/lib and /usr/bin

    If you have not set a primary installation there are no symbolic links.

  • Must be configured manually using the following command: 
    
$ MQ_INSTALLATION_PATH/bin/setmqinst -i -p MQ_INSTALLATION_PATH
To locate your various installations, you can use the:
  • Platform installation tools to query what is installed where on the system
  • dspmqver command
  • dspmqinst command
  • Following command to list the installations: 
    
cat /etc/opt/mqm/mqinst.ini

Windows

The primary installation is:
  • By default the first installation.
  • Pointed to by global environment variables.
  • Used by some operating system features that require central registration of interface libraries.

    For example, .NET monitor (transactional mode) and COM/ActiveX interface classes.

To locate your various installations, you can use the:
  • Platform installation tools to query what is installed where on the system
  • dspmqver command
  • dspmqinst command
  • Following command to query the registry: 
    
reg.exe query "HKLM\Software\[Wow6432Node\]IBM\WebSphere MQ\Installation" /s

Migration of Windows registry information

IBM WebSphere MQ 7.1 onwards uses mqs.ini and qm.ini.

However, if IBM WebSphere MQ 7.0.1 is still installed, IBM WebSphere MQ 7.1 uses the registry.

To uninstall IBM WebSphere MQ 7.0.1 with IBM WebSphere MQ 7.1 already installed, you must:
  • End all the queue managers and listeners
  • Uninstall IBM WebSphere MQ 7.0.1 which migrates the registry information into mqs.ini and qm.ini.
  • IBM WebSphere MQ 7.1 now starts using mqs.ini instead.
Note: If for some reason the uninstall is interrupted, and the automatic migration does not run, a tool is provided to migrate the information out of the registry manually.