My Oracle Support Banner

Note for Troubleshooting Oracle Service Bus (OSB) Production Systems in a Cluster (Doc ID 1070885.1)

Last updated on SEPTEMBER 04, 2023

Applies to:

Oracle Service Bus - Version 2.0 and later
Information in this document applies to any platform.


Production systems for Oracle Service Bus (OSB) / AquaLogic Service Bus (ALSB) are usually clustered in order to ensure load balancing and high availability. A cluster adds additional complexity to a domain setup that can cause problems related to configuration issues. One of the most important configurations in a cluster is, to make sure that all managed servers have a valid listen address defined. Additionally, the OSB cluster should have a valid cluster address defined as well. If these configurations are not correct, all kinds of different issues can happen. For information around this topic, please check Setting up WebLogic Clusters in our documentation.

Installing OSB for a enterprise deployment is a task which is described in the Oracle Fusion Middleware Enterprise Deployment Guide for Oracle SOA Suite.

Adding an additional managed server to an existing OSB cluster often creates problems because of incorrect or missing configuration of the new managed server. The first part of this note lists documents that will help to avoid those issues and help to resolve them.

This note lists information for OSB/ALSB transports and adapters and possible issues that can happen in a cluster. The notes linked in those sections help to understand and fix these problems.

A cluster also needs to be considered if test console as well as the OSB administration console (sbconsole) is used. The next section has information on those topics.

In a clustered environment, several managed servers are available which influence the usage of URLs in WSDLs. Please find information on this topic in the next section.

Interoperability topics with other products like WebLogic Server, Oracle Enterprise Repository, BPEL, OBPM and MQ Series/WebSphere is listed in the next section.

The last section lists links to related documentation that gives background information in order to understand cluster deployments and high availability aspects. It has links to best practices guides as well as a troubleshooting guide for common cluster related issues.

Troubleshooting Steps

To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document
Troubleshooting Steps
 Is it Possible to Have 2 Oracle Service Bus (OSB) Clusters in One Domain ?
 Recommended WLS Patch if using Unicast
 Configuration Wizard Crashes if Creating a Clustered Domain
 Adding Managed Servers to an existing OSB Cluster
 Distributed Destinations With the Same Name in Different Domains for OSB and Other Products
 Starting a Managed Servers via NodeManager or Start Scripts in a OSB Cluster
 OSB/ALSB Deployments in a Clustered Production Environment
 Transports and Adapters in an OSB Cluster
 HTTP in an OSB Cluster
 Singleton Applications: The Reporting Provider and Statistics Aggregator in an OSB  Cluster
 Test Console in an OSB Cluster
 Optimize Service Runtime in an OSB Production System
 sbconsole in an OSB Cluster
 WSDL in an OSB Cluster
 Built-in or Custom XPath/XQuery or Custom XPath Functions in a OSB Cluster
 Documentation Links & Additional Reading

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.