Oracle® Business Transaction Management

Release Notes

Release 12.1.0.6

E52794-03

June 2014

Oracle Business Transaction Management allows you to define and monitor transactions, and understand the business context of each transaction, including the transaction's consumers and business payload. You can also set performance targets for each transaction and monitor performance relative to those targets. You can trigger alert notifications when performance targets are breached or unusual conditions are met.

This document provides information about the changes introduced with release 12.1.0.6 of Business Transaction Management. It is recommended that you review this document before installing the product or upgrading to this version of the product. This document contains the following sections:

- "New Capabilities"

- "Known Problems"

- "Bugs Fixed in Release 12.1.0.6"

- "Documentation Accessibility"

New Capabilities

This release includes the following new features:

- SOA_B2B – Monitors SOA B2B (Business to business) adapters of SOA applications.

- Out of band discovery - enables dynamic discovery period for when an observer attempts to discover new components. For more information on this feature, enabled in the advanced settings for observers, see the Business Transaction Management Online Help.

- SOA 12.1.3 - Business Transaction Management is now compatible with Oracle SOA Suite Release 12.1.3.

- SOA_REST adapter -Monitors SOA REST adapters of SOA applications (SOA Release 12.1.3 only)

- OSB 12c - Business Transaction Management is now compatible with Oracle Service Bus Release 12c. Install the WebLogic 12 observer to use this feature.

Known Problems

The following problems have been observed:

- BTM does not support JVM Diagnostics if the server does not use FQDN
You can only access JVM Diagnostics from BTM if the machines where JVMD is installed are known to the Enterprise Manager instance by their fully qualified domain names (FQDN). If a machine has been discovered/registered by the EM in its short form (for example server1 instead of server1.oracle.com) then you will not be able to access JVM Diagnostics for that specific server.

- SOA Suite 11g Release 11.1.1.6 bug impacting observer
CR 13895209: INCORRECT WSDL FOR SOA PS5 WEB SERVICES. User Description: In SOA Release 11.1.1.6, if WSDLs of different SOA web services import the same parent WSDL, a query WSDL of individual service might contain all endpoints from different services with the same address location. This affects BTM in that SOA web services importing the same parent WSDL might show more endpoints than they are supposed to have. Sites impacted by this problem should either download the SOA Release 11.1.1.6 patch or upgrade to Release 11.1.1.7 to resolve this issue.

- If you are upgrading to release 12.1.0.6 of Business Transaction Management, and you use the observer for JavaEE in WebLogic 12 server, you need to reinstall the observer as described in the Installing Observer Libraries on WebLogic chapter of the Business Transaction Management Installation Guide.

- If you are upgrading to release 12.1.0.6 of Business Transaction Management, and you use the JMS probe, you need to remove and recreate all JMS Topic endpoints where the endpoint genre is OSB_Proxy and the endpoint URI is similar to the following:

jms://host:port/%ConnectionFactoryJNDIName%/%TopicJNDIName%

After upgrading to release 12.1.0.6, you can create a script which contains all the necessary commands to remove the endpoints as follows

For Windows, enter the following command to create the script:

btmcli generateRemoveOsbDeprecatedEpScript -s sphereUrl -u userName:password -scriptLanguage bat -o outputFileName

For other platforms, enter the following command to create the script:

btmcli generateRemoveOsbDeprecatedEpScript -s sphereUrl -u userName:password -scriptLanguage sh -o outputFileName

where:

- sphereUrl is the URL for the main server

- username is the username of the btmAdmin

- password is the password of the btmAdmin

- outputFileName is the file name of the script you want to create

Bugs Fixed in Release 12.1.0.6

The following bugs have been fixed in this release:

Table 1 Bugs Fixed in this Release

Bug Number

Description

16589209

TRANSACTION METRICS FOR "STARTED/COMPLETED TRANSACTION RATE" ARE WRONG

16709922

MESSAGE LOG BUNDLE URN:AGENT.SERVICE.AP_LOGDEST_17B13F6...ENCOUNTERED UNEXPECTED EXCEPTION

17432225

BTM: CANNOT LOCATE THE EP ID FOR THE SERVICE... WITH BINDING NULL/NULL, MEAS. IGNORED

17529399

CHANGED OBSERVER POLICY TO NOT SUMMARIZE JDBC - NOW GETTING NULLPOINTEREXCEPTION

17603641

FAILS TO DISCOVER OSB PROXY AND BUSINESS SERVICES WITH MESSAGE TRAFFIC

17760139

YOU NO LONGER SEE JDBC DETAILS WHEN VIEWING TRANSACTIONS

17812593

CAN NOT DISAMBIGUATE END-POINTS BECAUSE THERE ARE MULTIPLE ENDPOINTS

18019119

JAVA.UTIL.CONCURRENT.CONCURRENTHASHMAP CONSUMES 1.6GB OF BTM HEAP SPACE

18238167

NPE AFTER TOGGLING JDBC SUMMARY MODE

18269049

UNABLE TO EDIT "FAULT MONITORING" SETTING WHEN TRANSACTION NAME CONTAINS A SPACE

18470760

OSB OBSERVER NOT CORRECTLY DISCOVERING/MONITORING ENDPOINTS BEHIND LOAD BALANCER

18477204

MESSAGE LOGGING DATABASE POLICY IS STUCK FOREVER IN AN UNAPPLIED STATE

18615069

IOEXCEPTION2 UPDATING SERVLETRESPONSE FOR SERVLETRESPONSEMESSAGE: BROKEN PIPE

18685836

ENDPOINTS WITH DIFFERENT INTERFACES FOR SAME SERVICE CAUSE PROBLEMS WITH THE UI

18692593

SOA WSA THROWS EXCEPTION: CANNOT PROCESS DUE TO NULL PARAMETER

18720806

SETTINGS OF WEBLOGIC FRONTEND HOST/PORT CAUSES BTM TO GENERATE INCORRECT URL

18770741

APP DATA FROM OBSERVER EXCEEDS LIMITS OF SPHEREDB.AMBPT_SERVICE.QUALIFIEDNAME

18934050

BTM OSB OBSERVER: NPE IN DEFAULTREQUESTHEADER WITH TUXEDOTRANSPORT PROVIDER

ER16562801

ALLOW FOR MISMATCH OF SERVICE NAMES BETWEEN SOA OBSERVER AND OSB

ER17271706

REQUEST FOR A BTM CLI COMMAND TO PURGE ALL RUNTIME METRICS

ER17300720

BTM'S WEBLOGIC PRINCIPAL NAME MAPPINGS NEED TO BE MORE FLEXIBLE

ER17590432

BTM OBSERVER UNABLE TO HANDLE LONG DELAY IN REVERSE LOOK UP - WLS STUCK THREADS

ER18008346

CAPTURE SSL-ID FROM OSB CONTEXT TO BE USED AS CONSUMER IDENTIFICATION

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Oracle Business Transaction Management Release Notes, Release 12.1.0.6 for all platforms

E52794-03

Copyright © 2014 Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2016, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Alpha and Beta Draft Documentation Notice

If this document is in private preproduction status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your beta trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.