Use this task to install and configure WebSphere MQ with support for the Java Message Service (JMS) for use with the WebSphere Application Server.
Before you begin
(UNIX platforms only) Before you install WebSphere MQ, create and mount a journalized file system called /var/mqm for your messaging working data. Use a partition strategy with a separate volume for the WebSphere MQ data. This means that other system activity is not affected if a large amount of messaging work builds up in /var/mqm. You can also create separate file systems for your log data (var/mqm/log) and error files (var/mqm/errors). You should store log files on a different physical volume from the messaging queues (var/mqm). This ensures data integrity in the case of a hardware failure. If you are creating separate file systems, allow a minimum of 30 MB of storage for /var/mqm, 20 MB of storage for /var/mqm/log, and 4 MB of storage for /var/mqm/errors.
You can get WebSphere MQ messaging platform-specific
books at this Web page:
http://www-306.ibm.com/software/integration/wmq/library/library6x.html
Why and when to perform this task
To install and configure WebSphere MQ (MQSeries) for use as a JMS provider to IBM WebSphere Application Server, complete the following steps:
Steps for this task
If you are installing WebSphere MQ on top of WebSphere Application Server embedded messaging, perform the following actions when installing WebSphere MQ:
If you want to use the original WebSphere MQ release, ensure that you install the CSD04 update.
If you want to use WebSphere MQ on the same machine as WebSphere Application Server embedded messaging, ensure that you install the following WebSphere MQ features:
For information about installing WebSphere MQ or migrating to WebSphere MQ from an earlier release, see the appropriate WebSphere MQ Quick Beginnings book, as listed above.
For example, you can do this by using either WebSphere Event Broker (formerly WebSphere MQ Event Broker) or WebSphere Message Broker (formerly WebSphere MQ Integrator).
For more information about installing WebSphere Event Broker (formerly WebSphere MQ Event Broker) or WebSphere Message Broker (formerly WebSphere MQ Integrator), see the following Web sites:
Results
This task has installed WebSphere MQ for use as the JMS provider with WebSphere Application Server.What to do next
You can configure JMS resources to be provided by WebSphere MQ, by using the WebSphere administrative console to define WebSphere MQ resources.
(UNIX platforms only) Restrict access to the messaging errors directories and logging files, by using the following commands. This is part of the procedure to secure the directories and log files needed for WebSphere MQ, as described in Securing messaging directories and log files.
chmod 3777 /var/mqm/errors chown mqm:mqm /var/mqm/errors touch /var/mqm/errors/AMQERR01.LOG chown mqm:mqm /var/mqm/errors/AMQERR01.LOG chmod 666 /var/mqm/errors/AMQERR01.LOG touch /var/mqm/errors/AMQERR02.LOG chown mqm:mqm /var/mqm/errors/AMQERR02.LOG chmod 666 /var/mqm/errors/AMQERR02.LOG touch /var/mqm/errors/AMQERR03.LOG chown mqm:mqm /var/mqm/errors/AMQERR03.LOG chmod 666 /var/mqm/errors/AMQERR03.LOG
chmod 3777 /var/mqm/qmgrs/@SYSTEM/errors chown mqm:mqm /var/mqm/qmgrs/@SYSTEM/errors touch /var/mqm/qmgrs/@SYSTEM/errors/AMQERR01.LOG chown mqm:mqm /var/mqm/qmgrs/@SYSTEM/errors/AMQERR01.LOG chmod 666 /var/mqm/qmgrs/@SYSTEM/errors/AMQERR01.LOG touch /var/mqm/qmgrs/@SYSTEM/errors/AMQERR02.LOG chown mqm:mqm /var/mqm/qmgrs/@SYSTEM/errors/AMQERR02.LOG chmod 666 /var/mqm/qmgrs/@SYSTEM/errors/AMQERR02.LOG touch /var/mqm/qmgrs/@SYSTEM/errors/AMQERR03.LOG chown mqm:mqm /var/mqm/qmgrs/@SYSTEM/errors/AMQERR03.LOG chmod 666 /var/mqm/qmgrs/@SYSTEM/errors/AMQERR03.LOG
After installing WebSphere MQ and WebSphere Application Server on the same host, you should only service WebSphere MQ with its CSD updates, and separately service WebSphere Application Server with its fix packs. This approach helps to avoid potential failures if you later decide to uninstall WebSphere Application Server fix packs. Also, if you apply a fix pack to WebSphere Application Server, specify not to update the Embedded Messaging feature.