3 Interoperating with Different WebLogic Server Releases or Foreign Providers
This chapter includes the following sections:
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.
Note:
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.
Supported Configurations and Compatibility
For the most current information on supported configurations and compatibility between current version of WebLogic Server and previous releases, see Supported Configurations and WebLogic Server Compatibility in What's New in Oracle WebLogic Server.
Parent topic: Interoperating with Different WebLogic Server Releases
Naming Guidelines for WebLogic Servers and Domains
Unique naming rules apply to all WebLogic Server deployments if more than one domain is involved. See Integration and Multi-Domain Best Practices in Administering JMS Resources for Oracle WebLogic Server.
Parent topic: Interoperating with Different WebLogic Server Releases
Configuring Interoperability for WebLogic Domains
Configuring interoperability between domains depends on the QOS:
Parent topic: Interoperating with Different WebLogic Server Releases
Configuring Interoperability for Exactly-once QOS
Use the following guidelines to configure interoperability to handle transactional messages (using the Exactly-once QOS) between two WebLogic 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 Secure Inter-Domain and Intra-Domain Transaction Communication in Developing JTA Applications for Oracle WebLogic Server
-
Changing the Asynchronous Mode Enabled Attribute in Tuning Performance of Oracle WebLogic Server
-
-
When interoperating between two WebLogic domains, see Naming Guidelines for WebLogic Servers and Domains.
-
Ensure that the XA connection factory is enabled for the domains by selecting the
XAConnection
Factory Enabled.See Configure Resources for JMS System Modules in the Oracle WebLogic Remote Console Online Help.
-
Deploy the transaction resource adapter,
jms-xa-adp.rar
, on the domain where the messaging bridge is running.Note:
Messaging bridge configuration has been simplified since WebLogic Server 12.2.1. You need not explicitly configure and deploy bridge adapters. Instead, a messaging bridge now uses the automatically deployed internal adapters when the bridge is configured with a default adapter JNDI name (
eis.jms.WLSConnectionFactoryJNDINoTX
oreis.jms.WLSConnectionFactoryJNDIXA
). These internal adapters also have a much larger connection capacity.Legacy adapters explicitly configured with the default adapter JNDI names still deploy, but are ignored by messaging bridges. The legacy adapter deployments can be removed in the configuration after upgrading to WebLogic Server 12.2.1.
-
When configuring the JMS bridge destinations, as described in Create a JMS Bridge Destination in the Oracle WebLogic Remote 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.
See Create a Messaging Bridge Instance in the Oracle WebLogic Remote Console Online Help.
Parent topic: Configuring Interoperability for WebLogic Domains
Configuring At-least-once or At-most-once QOS
There are no special security configuration requirements for the bridge to interoperate between two WebLogic domains. However, if you want to provide more secure communication between domains, you can configure Cross Domain Security.
Note:
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 Cross-Domain Security in Administering Security for Oracle WebLogic Server
-
Changing the Asynchronous Mode Enabled Attribute in Tuning Performance of Oracle WebLogic Server
Parent topic: Configuring Interoperability for WebLogic Domains
Interoperating with Foreign Providers
When configuring a messaging bridge involves interoperability with a third-party Jakarta Messaging Service provider, you must configure the following:
-
Before starting WebLogic Server:
-
Supply the provider's
CLASSPATH
in the WebLogic ServerCLASSPATH
. -
Include the
PATH
of any native code required by the provider's client-side libraries in the WebLogic Server systemPATH
. (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 a JMS Bridge Destination in the Oracle WebLogic Remote Console Online Help.
-