Configuring and
Managing the WebLogic
Messaging Bridge
Interoperating with Different WebLogic Server Releases or Foreign Providers
The following sections provide interoperability guidelines for using the WebLogic Messaging Bridge to access JMS destinations on different releases of WebLogic Server or when accessing foreign providers:
Interoperating with Different WebLogic Server Releases
The following interoperability guidelines apply when using the messaging bridge to access JMS destinations on different releases of WebLogic Server and in other WebLogic Server domains.
When the messaging bridge is used to communicate between two domains running different releases of WebLogic Server, BEA recommends that the messaging bridge be configured to run on the domain using the latest release of WebLogic Server.
Naming Guidelines for WebLogic Servers and Domains
Unique naming rules apply to all WebLogic Server deployments if more than one domain is involved. Therefore, make sure that:
WebLogic Server instances and domain names are unique.
WebLogic JMS server names are unique name across domains.
If a JMS file store is being used for persistent messages, the JMS file store name must be unique across domains.
Configuring Interoperability for WebLogic Domains
Unless the Exactly-once QOS (quality of service) is required for handling two-phase transactions sent across the messaging bridge, there are no special security configuration requirements for the bridge to interoperate between two release 6.1 or later domains.
However, you must follow these steps when a bridge running on release 7.0 domain must handle transactional messages (using the Exactly-once QOS) between two release 6.1 or later domains
For each server participating in the transaction, set the Security Interoperability Mode flag according to Setting Security Interoperability Mode in Programming WebLogic JTA before rebooting.
Note:
When Security Interoperability Mode is set to performance, you are not required to set domain trust between the domains.
Configure domain trust for the all participating bridge domains.
In all participating WebLogic Server 6.x domains, change the password for the system user to the same value in all participating domains on the SecurityUsers tab in the Administration Console. See Changing the System Password.
Establish domain trust by setting a security credential for all domains to the same value in all participating domains. If you have participating 6.x domains, set the security credential for all domains to the same value as the system password in all participating WebLogic Server 6.x domains.
Access Destinations In a Release 6.1 or Later Domain
Use these guidelines when configuring a messaging bridge on a release 9.0 domain to provide "Exactly-once" transactional message communication between two release 6.1 or later domains.
Note:
The Exactly-once quality of service for two-phase transactions is only supported for release 6.1 or later.
Make sure that the XA connection factory is enabled for the domains by selecting the XAConnection Factory Enabled check box. See Configure connection factory transaction parameters in Administration Console Online Help.
Deploy the transaction resource adapter, jms-xa-adp.rar, on the 9.0 domain where the messaging bridge is running, as described in Deploy resource adaptors in Administration Console Online Help.
When configuring the JMS bridge destinations, as described in Create JMS bridge destinations in Administration Console Online Help, do the following for both the source and target destinations:
In the Adapter JNDI Name field, identify the transaction adapter's JNDI name, eis.jms.WLSConnectionFactoryJNDIXA.
Do not enter anything in the Adapter Classpath field.
When configuring a messaging bridge involves interoperability with a third-party messaging provider, you must configure the following:
Before starting WebLogic Server:
Supply the provider's CLASSPATH in the WebLogic Server CLASSPATH.
Include the PATH of any native code required by the provider's client-side libraries in the WebLogic Server system PATH. (This variable may vary depending on your operating system.)
In the JMSBridgeDestination instance for the third-party messaging product being bridged, provide vendor-specific information in the following attributes:
Connection URL
Initial Context Factory
Connection Factory JNDI Name
Destination JNDI Name
Note:
The messaging bridge cannot provide the "Exactly-once" quality of service when the source and target bridge destinations are located on the same resource manager (that is, when the bridge is forwarding a global transaction that is using the XA resource of the resource manager). For example, when using MQ Series, it is not possible to use the same Queue Manager for the source and target bridge destinations.
For more information on configuring the remaining attributes for a JMS Bridge Destination, see Create JMS Bridge destinations in Administration Console Online Help.