Configure 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.
- Naming Guidelines for WebLogic Servers and Domains
- Configuring Interoperability for WebLogic Domains
When the messaging bridge is used to communicate between two domains running different releases of WebLogic Server, Oracle 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
Configuring interoperability between domains depends on the QOS:
Configuring Interoperability for Exactly-once QOS
Use the following guidelines to configure interoperability when a bridge running on a release 7.0 or higher domain must handle transactional messages (using the Exactly-once QOS) between two release 7.0 or later domains
- You must correctly configure either Cross Domain Security or Security Interop Mode for all participating domains.
Keep all the domains used by your process symmetric with respect to Cross Domain Security configuration and Security Interop Mode. Because both settings are set at the domain level, it is possible for a domain to be in a mixed mode, meaning the domain has both Cross Domain Security and Security Interop Mode set. For more information, see:
- Configuring Domains for Inter-Domain Transactions in Programming WebLogic JTA
- Changing the Asynchronous Mode Enabled Attribute in WebLogic Server Performance and Tuning.
- If a JMS file store is being used for persistent messages, the JMS file store name must be unique across WebLogic domains, as described in Naming Guidelines for WebLogic Servers and Domains.
- 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 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.
- Select a Quality Of Service of Exactly-once, as described in “Configure messaging bridge instances” in Administration Console Online Help.
Configuring At-least-once or At-most-once QOS
There are no special security configuration requirements for the bridge to interoperate between two releases of 7.0 or later domains. However, if you wish to provide more secure communication between domains, you can configure Cross Domain Security.
Keep all the domains used by your process symmetric with respect to Cross Domain Security configuration—all domains use Cross Domain Security (or are on the appropriate exception lists) or none of the domains have Cross Domain Security configured. For more information, see:
- Configuring Configuring Security for a WebLogic Domain in Securing WebLogic Server
- Changing the Asynchronous Mode Enabled Attribute in WebLogic Server Performance and Tuning.
Interoperating with Foreign Providers
When configuring a messaging bridge involves interoperability with a third-party messaging provider, 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
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.