Skip Headers
Oracle® Application Server Release Notes
10g Release 3 (10.1.3.1.0) for Microsoft Windows
B31012-02
  Go To Documentation Library
Home
Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

7 Oracle Enterprise Service Bus

This chapter describes issues associated with Oracle Enterprise Service Bus. It includes the following topics:

7.1 General Issues and Workarounds

This section describes general issue and workaround. It includes the following topic:

7.1.1 The SOA Basic Installation Type Should be Used Instead of the ESB Standalone Developer Installation Type

The Oracle Application Server SOA Suite Basic Install type should be used for development and pre-production testing. The Oracle Enterprise Service Bus standalone Developers installation type is not a supported option.

For information on installing the SOA Suite Basic Install type, see Oracle Application Server Installation Guide or Oracle Application Server Installation Guide for Linux x86.

7.1.2 Performance Degradation of Dequeuing Operations Against AQ When Using an Oracle 10.2.0.2 Database

When there is a large number of outstanding messages (more than 100K) in an AQ queue, dequeuing in the AQ adapter can be very slow with an Oracle 10.2.0.2 database.

You can remedy the problem by running dbms_stats.gather_table_stats or dbms_stats.gather_schema_stats to analyze the queue tables for query optimization.

7.1.3 Memory Usage Grows Gradually in Default Installation at High Volume

In high volume, high throughput environment, you might notice that the memory usage of the container is growing gradually. This might be a result of the instance tracking data not being flushed from the in-memory data structure fast enough. You can tune (reduce, in this case) the flush interval with a SQL statement executed against the ESB_PARAMETER table in the ORAESB schema as follows:


INSERT INTO ESB_PARAMETER (PARAM_NAME, PARAM_VALUE) 

       VALUES ('TrackingMessageFlushInterval', '500'); 



The PARAM_VALUE in the SQL statement represents 500 milliseconds.

If a value already exists, use the SQL UPDATE statement to update the parameter value, as follows:


UPDATE ESB_PARAMETER SET PARAM_VALUE = '500'

       WHERE PARAM_NAME = 'TrackingMessageFlushInterval'; 



After modifying the ESB_PARAMETER table, you need to restart the ESB Server.

7.1.4 Filter Expression Only Supports XPath Functions that are Included in the XPath 1.0 Specification

Filter expressions, XSL data transformations, and tracking fields do not support any XPath functions that are not part of the XPath 1.0 specification. The header support functions are an exception and are supported as Preview features. For information about Preview features, see Section 7.3.1, "Some Oracle Enterprise Service Bus Features are in Preview Mode".

7.1.5 External Dependencies Used at Design Time Must Be Available at Deployment Time

Ensure that all external dependencies that are used at design time, such as hosted WSDLs and XSDs, are available at the time of deployment. The deployment engine uses these artifacts to generate metadata. The deployment engine will try to access the artifacts until they are available or the engine times out.

7.1.6 Multibyte Characters Are Not Supported in Some ESB Component Names

The Oracle Enterprise Service Bus project, schema, service, and system names do not support multibyte characters. Use ASCII characters for those names.

Oracle Enterprise Service Bus does support multibyte character set payloads (data). The restriction on multibyte characters only applies to configuration data.

7.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

7.2.1 ESB Server Displays a Warning Message When Shut Down

A warning message might be displayed when the ESB Server shuts down. This occurs because the ESB runtime process interrupts the worker threads while shutting down.

The warning message has no impact and is safe to ignore.

7.2.2 Oracle ESB Control Does Not Display Correctly For Some Window Sizes

When resizing Oracle ESB Control, sometimes the scroll bar is missing and other layout issues might occur. To display the correct layout, maximize the Oracle ESB Control window.

7.2.3 Access Problem After Logging into Oracle ESB Control Using Internet Explorer

If you are having problems accessing the Oracle ESB Control with Internet Explorer, you can reconfigure the security options to add your domain to the local intranet zone.

From the Internet Explorer toolbar, select Tools > Internet Options > Security > Local intranet > Sites > Advanced, then add your domain in the entry field. For example, if your server hostname is esbserver.oracle.com, add *.oracle.com to the local intranet zone.

7.2.4 Timeout Exceptions When Using Oracle Enterprise Service Bus

You should make both of the updates described in this section to avoid time out errors when either ESB or another application, such as BPEL, starts a transaction. The time out error for an OC4J transaction applies to all applications and the time out error while deploying from Oracle JDeveloper only applies to Oracle Enterprise Service Bus. Note that the time out value set in the esb_config.ini file takes precedence when ESB starts the transaction.

If an OC4J transaction time out error occurs while importing metadata into the ESB Server, you need to increase the value of the transaction-timeout parameter in the Oracle_Home/j2ee/home/config/transaction-manager.xml file. The error can occur for various reasons, such as a BPEL or an external service WSDL is not available or slow.

If a time out error occurs while deploying from Oracle JDeveloper, you need to increase the value of the xa_timeout parameter in the Oracle_Home/integration/esb/esb_config.ini file. After modifying the file, you need to restart the ESB Server.

7.2.5 Missing pc.properties After Completing the ESB Standalone Installation

After completing the Oracle Enterprise Service Bus standalone installation, the following error message might occur:

Could not locate file pc.properties in classpath

To create the pc.properties file for your system, perform the following:

  1. Copy Oracle_Home\integration\esb\config\pc.properties.esb to Oracle_Home\integration\esb\config\pc.properties.

  2. Edit pc.properties according to your system requirements.

  3. Restart the ESB Server.

7.2.6 An Inbound Adapter Service and its Corresponding Routing Service Should Reside in the Same ESB System

An inbound adapter service and its corresponding routing services are considered peer entities that should be deployed together in the same ESB system.

7.2.7 Configuration of an Additional Design Time Instance in a High Availability Deployment Requires Additional Configuration

If you install multiple ESB repositories against the same database, the second repository installation overwrites the existing ESB metadata configuration residing in the ESB_PARAMETER table. In order to preserve the old values, you need to export the ESB_PARAMETER table before installing the second repository, then import the ESB_PARAMETER table after completing the installation of the second repository.

For information about exporting and importing the ESB_PARAMETER table, see "Updating the ESB Metadata" in Oracle Application Server Enterprise Deployment Guide.

7.2.8 New Parameters in the ESB_PARAMETER Table are Required for a Non-default OC4J JMS Setup

When using a non-default JMS setup, you need to specify several parameters in the ESB_PARAMETER table to indicate JNDI locations for the topic and connection factory. The parameters are:

  • PROP_NAME_ERROR_XATCF_JNDI

    Description: XA JMS connection factory for error topic

    Example: OracleOJMS/XATCF

  • PROP_NAME_ERROR_TCF_JNDI

    Description: Non-XA JMS connection factory for error topic

    Example: OracleOJMS/TCF

After modifying the ESB_PARAMETER table, you need to restart the ESB runtime and design time servers.

7.2.9 Non-transactional MQ Adapter Incorrectly Configured as Transactional

At installation time, the MQ Adapter is incorrectly registered with Oracle Enterprise Service Bus as transactional. This leads to the display of an incorrect status in Oracle ESB Control when transactions are rolled back.

The IS_TRANSACTIONAL columns in the ESB_SERVICE_TYPE table should be set to N (not Y) when SERVICE_TYPE is equal to MQ. You can fix the ESB service configuration in the ESB_SERVICE_TYPE table using the following SQL statement:


UPDATE ESB_SERVICE_TYPE SET IS_TRANSACTIONAL = 'N' WHERE SERVICE_TYPE = 'MQ';



After modifying the table, you need to restart the ESB Server.

7.3 Documentation Errata

This section describes documentation errata. It includes the following topic:

7.3.1 Some Oracle Enterprise Service Bus Features are in Preview Mode

Some Oracle Enterprise Service Bus features are available in Preview mode and will be supported in a later release.

Preview features in this release are:

  • Endpoint properties

    • Adapter Endpoint properties

    • SOAP Endpoint properties

  • Header Support

    • Header support for Adapters

    • Header support for SOAP Headers, such as security, encryption, and WS-Addressing

  • Oracle Enterprise Service Bus to Oracle Application Server Integration B2B integration

7.3.2 Oracle Enterprise Service Bus and Oracle Application Server Integration B2B

The B2B WSIL Browser enables interoperability between Oracle Enterprise Service Bus and Oracle Application Server Integration B2B and is available through patch 5105622.

This feature are available in Preview mode and will be supported in a later release.


See Also:

  • Oracle Application Server Integration B2B User's Guide