IBM Support

Installing WebSphere MQ in AIX Workload Partitions

Question & Answer


Question

What is required to Install WebSphere MQ in AIX Workload Partitions?

Cause

WebSphere MQ documentation does not describe the installation process for AIX Workload Partitions.

Answer

Installing WebSphere MQ in AIX Workload Partitions

References

1. WebSphere MQ Quick Beginnings for AIX:
Version 6: http://publibfp.boulder.ibm.com/epubs/pdf/amqaac08.pdf
Version 7: http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/index.jsp?topic=/com.ibm.mq.amqaac.doc/aq10120_.htm

2. IBM Workload Partitions for AIX topic in the Combined IBM Systems Information Center
http://publib.boulder.ibm.com/infocenter/systems/index.jsp?topic=/com.ibm.aix.wpar/wpar-overview.htm

3. Introduction to Workload Partition Management in IBM AIX, SG24-7431-00
http://www.redbooks.ibm.com/abstracts/sg247431.html


Introduction

“Workload partitions (WPARs) are virtualized operating system environments within a single instance of the AIX operating system. WPARs secure and isolate the environment for the processes and signals that are used by enterprise applications.”


Application WPARs

WebSphere MQ is not supported in application WPARs.


System WPARs

Private /usr filesystem

WebSphere MQ can be installed directly in a system WPAR with a private, read-write, /usr filesystem using the standard procedure described in the Quick Beginnings manual. Applying service, and uninstalling the product can also be performed in the normal way.


Shared, read-only /usr filesystem

WebSphere MQ is supported in system WPARs with read-only /usr filesystems by installation in the global environment provided that the gid and uid for the group and user names 'mqm' in each WPAR where the product is to be run match the values set in the global environment. Standard administrative techniques can be used to achieve this and are described in the procedures below.


Installing WebSphere MQ into a system with existing WPARs

1. Perform a normal installation of WebSphere MQ in the global environment using the instructions in the Quick Beginnings manual for your release.

2. Note the gid and uid of the group and user mqm.

3. In each WPAR where you intend to run WebSphere MQ: create the group and user mqm using the same gid and uid as the global environment.

Use the syncwpar command to run the root part installation of WebSphere MQ


Creating a new WPAR with WebSphere MQ when MQ is already installed in the global environment.

Create the WPAR, this will cause the root-part installation of WebSphere MQ to be run for the new WPAR

Note the gid and uid of mqm in the global environment

In the new WPAR check the gid and uid of the group and user mqm - if they are different from the global environment delete and recreate with the correct values

In the WPAR, as root, run /usr/mqm/bin/amqicdir -i -f ( this will correct ownership of the /var/mqm directory structure).


Applying service to WebSphere MQ in a WPAR environment.

Updates (refresh packs and service packs) can be applied to WebSphere MQ using the instructions in the Quick Beginnings and any additional documentation accompanying the update, the service will be installed in the global environment. You should note:

All WebSphere MQ activity (queue managers, listeners, client programs) should be stopped in all WPARs before attempting to install the update.

The syncwpar command should be run for all WPARs before restarting WebSphere MQ.


Uninstalling WebSphere MQ

1. Before uninstalling WebSphere MQ from an AIX system global environment containing WPARs you must stop all WebSphere MQ activity (queue managers, listeners, client programs) in all WPARs.

2. Perform the uninstallation in the global environment according to the instructions in the Quick Beginnings manual.

3. Run the syncwpar command for each WPAR that had WebSphere MQ installed.

[{"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Install \/ Migration","Platform":[{"code":"PF002","label":"AIX"}],"Version":"7.0;6.0","Edition":"All Editions","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
15 June 2018

UID

swg21320429