Install and configuring a JMS provider

This topic describes the different ways that you can implement a JMS provider for use with WebSphere Application Server.

 

Overview

For IBM WebSphere Application Server to support bean-managed messaging, you need to install and configure one or more JMS providers that conform to the JMS specification version 1.0.2. To use message-driven beans the JMS provider must support the Application Server Facility (ASF) function defined within that specification.

You can install and use the Embedded Messaging Server option of WebSphere Application Server, install WebSphere MQ as the JMS provider, or install another "generic" JMS provider. If you install both embedded messaging and WebSphere MQ as JMS providers, for example, WebSphere applications can use JMS resources provided by both the embedded WebSphere JMS provider and the WebSphere MQ JMS provider.

WebSphere Application Server provides default JMS support with its Embedded Messaging Server component. This function is installed with WebSphere Application Server, administered through the administrative console and managed as part of the WebSphere Application Server runtime. This function is only accessible from WebSphere Application Server Web, EJB and client containers, and is not interoperable with WebSphere MQ. If access is required to heterogeneous non-JMS applications, WebSphere MQ clustering, or other WebSphere MQ functions, install WebSphere Application Server without the Embedded Messaging Server component, and should install WebSphere MQ instead as the JMS provider.

The WebSphere Application Server Embedded Messaging Client is the same Java Client feature that ships with WebSphere MQ 5.3.1, except that the Embedded Messaging Client has a licensing restriction that prohibits it from communicating with queue managers outside the WebSphere environment (that is, with any full WebSphere MQ queue managers). You do not need to install any Embedded Messaging components (client or server) in order to send and receive messages to and from the full WebSphere MQ.

To provide the supported levels of messaging, apply the latest service for WebSphere Application Server and WebSphere MQ while a production application is in Quality-Assurance or Product-Validation Test.

For more information about WebSphere Application Server messaging scenarios, and the relationship between embedded messaging and WebSphere MQ, see the following articles:

You can install and configure a JMS provider in one or more of the following ways:

 

Example

A new IBM WebSphere Application Server server machine, hostA.

This scenario starts with adding embedded messaging as the JMS provider, then optionally adding WebSphere MQ as an alternative JMS provider. Each stage summarizes the messaging functions that can be added.

  1. Installing embedded messaging as the only JMS provider.

    You want to be able to run WebSphere applications that use the WebSphere JMS resources for both point-to-point and publish/subscribe messaging.

    1. Install IBM WebSphere Application Server with the Embedded Messaging Server and Embedded Messaging Client options.

    2. Use the administrative console to configure WebSphere JMS resources; for example, WebSphere Queue Connection Factories and WebSphere Topic Connection Factories.

    3. On any client machines that are to use the WebSphere JMS resources, install IBM WebSphere Application Server with the Embedded Messaging Client option.

  2. Adding WebSphere MQ as an alternative JMS provider for point-to-point messaging.

    Besides the point-to-point and publish/subscribe messaging that uses the embedded WebSphere JMS resources (from the preceding step), you want to use WebSphere MQ Queue resources for point-to-point messaging.

    1. Install WebSphere MQ 5.3 with the required features. For more information about installing WebSphere MQ, see the Target can be accessed only when this topic is linked to the World Wide Web   WebSphere MQ Quick Beginnings book for your machine's platform . When installing WebSphere MQ, perform the following actions:

      1. When asked if you want to remove or modify the version of WebSphere MQ currently installed, choose to remove the Server. (The WebSphere MQ install program recognizes the installed WebSphere embedded messaging as an installed version of WebSphere MQ.)

      2. Select the option to keep existing queue managers.

      3. Proceed with the installation of the full WebSphere MQ Server by running the install program again, after the old WebSphere MQ server (the Embedded Messaging Server) has been removed.

    2. Use the administrative console to configure WebSphere MQ Queue Connection Factories and WebSphere MQ Queue Destinations.

  3. Adding WebSphere MQ Event Broker for alternative publish/subscribe messaging.

    For publish/subscribe messaging, you want to be able to run WebSphere applications that use the WebSphere MQ Topic resources or the embedded WebSphere Topic resources (such as those configured in preceding steps).

    1. Install WebSphere MQ Event Broker. For more information about installing WebSphere MQ Event Broker, see the Target can be accessed only when this topic is linked to the World Wide Web   WebSphere MQ Event Broker Installation Guide for your machine's platform .

    2. Use the administrative console to configure WebSphere MQ Topic Connection Factories and WebSphere MQ Topic Destinations.

An existing WebSphere MQ 5.2 server and broker machine, hostA, where you want to install embedded messaging as the JMS provider.

  1. Upgrade to WebSphere MQ 5.3 with the required features. For more information about upgrading to WebSphere MQ 5.3, see "Migrating from an earlier version" in the Target can be accessed only when this topic is linked to the World Wide Web   WebSphere MQ Quick Beginnings book for your machine's platform .

  2. To continue using publish/subscribe messaging, upgrade to a supported broker such as WebSphere MQ Event Broker.

  3. Install IBM WebSphere Application Server with the Embedded Messaging Server. You do not need to install the Embedded Messaging Client, which is the same as installed with WebSphere MQ.

  4. Use the administrative console to configure WebSphere JMS resources; for example, WebSphere Queue Connection Factories and WebSphere Topic Connection Factories.

  5. If you want WebSphere applications to use the WebSphere MQ resources, use the administrative console to configure WebSphere MQ JMS resources; for example, WebSphere MQ Queue Connection Factories and WebSphere MQ Destinations.

  6. On any client machines that are to use the WebSphere JMS resources, install IBM WebSphere Application Server. If the WebSphere MQ client is not installed, install Embedded Messaging Client option.

You can run WebSphere applications that use both the WebSphere JMS resources and WebSphere MQ JMS resources for messaging.

An existing WebSphere MQ server machine, hostA, where you want to use WebSphere MQ as the only JMS provider.

  1. For point-to-point messaging, ensure that you have installed WebSphere MQ 5.3 with required features. For publish/subscribe messaging, ensure that you have also installed a supported broker such as WebSphere MQ Event Broker. For more information about installing WebSphere MQ 5.3 and Event Broker, see the Target can be accessed only when this topic is linked to the World Wide Web   WebSphere MQ Quick Beginnings book and Target can be accessed only when this topic is linked to the World Wide Web   WebSphere MQ Event Broker Installation Guide for your machine's platform.

  2. Install IBM WebSphere Application Server without any of the Embedded Messaging Server and Embedded Messaging Client options.

  3. Use the administrative console to configure WebSphere MQ JMS resources; for example, WebSphere MQ Queue Connection Factories and WebSphere MQ Topic Connection Factories.

  4. On any client machines that are to use the WebSphere JMS resources, install IBM WebSphere Application Server. If the WebSphere MQ client is not installed, install the Embedded Messaging Client option.

You can run WebSphere applications that use the WebSphere MQ JMS resources for point-to-point or (with a supported broker installed) publish/subscribe messaging.


Related tasks
Configuring JMS provider resources
Moving from the embedded WebSphere JMS provider to WebSphere MQ
Managing JMS servers in a deployment manager cell
Administering WebSphere JMS support