Oracle® Fusion Middleware

Release Notes for Oracle Traffic Director

12c (12.2.1.2.0)

E78112-02

December 2016

This document contains information about the new features and known issues for Oracle Traffic Director 12.2.1.2.0. It contains:

- What’s New In This Release

- Known Issues

- Documentation Accessibility

What's New in This Release?

The following are the new features in Oracle Traffic Director 12.2.1.2.0. For more information, see Features of Oracle Traffic Director:

- Oracle Traffic Director supports sending notifications to one or more HTTP endpoints for the following two events:

- Origin server status change event

- Request limit exceeded event

For more information, see Events Notifications.

- Support for enabling FTP configuration for TCP proxies, see Managing TCP Proxies.

- Support for configuring dedicated Status Listeners to monitor status of Oracle Traffic Director instances, see Configuring Status Listener.

- Support for configuring active-active high availability, see Configuring Oracle Traffic Director for High Availability.

Known Issues

This section provides information about the known issues for Oracle Traffic Director 12.2.1.2.0 along with possible workarounds:

- Restart active-active failover node after enabling FTP on TCP listener

- Creation of active-active failover group through Enterprise Manager not supported

- Disable Session Caching Before Resuming SSL Connection

- Warnings Appear in Oracle Traffic Director Node Manager Log on Solaris on SPARC (64–bit)

- Active-active requests fail when they originate from machines configured as failover group

Restart active-active failover node after enabling FTP on TCP listener

In an active-active failover enabled configuration, if you create an FTP-enabled TCP listener or enable the FTP for an existing TCP listener, then this new/modified configuration will not be part of the running failover until you stop and start the failover on all the nodes. If failover is not restarted, then the incoming traffic is not routed through the LVS and will not be load balanced. Instead, it will be directly served by OTD where VIP is plumbed.

Creation of active-active failover group through Enterprise Manager not supported

There is no option to create/manage active-active failover groups using Enterprise Manager. Active-active failover groups must be created/managed using WLST commands.

Disable Session Caching Before Resuming SSL Connection

If client authentication is enabled on an SSL listener, there is an issue in retrieving the client certificate chain during session resumption. This may cause a subsequent credential check to fail in some cases.

A workaround for this issue is to disable the SSL session cache in this case.

Warnings Appear in Oracle Traffic Director Node Manager Log on Solaris on SPARC (64–bit)

After installing Oracle Traffic Director on Solaris on SPARC (64-bit), you might see warning messages similar to the following examples in the Node Manager log when starting the Oracle Traffic Director Node Manager:

WARNING: Key store file keystores.xml integrity check failed.
Location:  /home/oracle/config/domains/OTDDomain/config/fmwconfig/ Jul 19, 2016 10:44:36 PM
oracle.security.jps.internal.keystore.file.FileKeyStoreManager openKeyStore

WARNING: Opening of file based keystore failed.
Reason : oracle.security.jps.service.keystore.KeyStoreServiceException: JPS-06502: Failed to read keystore.
Reason : javax.xml.bind.UnmarshalException

The first warning is a security warning, and the second warning is because of file synchronization issues with the keystores.xml file. There is no workaround, as there is no impact on OTD functionality. You can ignore these warnings.

Active-active requests fail when they originate from machines configured as failover group

If an active-active failover group is configured for a VIP on Oracle Traffic Director, and the requests to VIP originates from one of the machines where the failover group is configured, then the requests fail.

The workaround is to send the requests from an external machine which is not a part of the failover group.

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.

Oracle® Fusion Middleware Release Notes for Oracle Traffic Director, 12c (12.2.1.2.0)

E78112-02

Copyright © 2015, 2016, 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, 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.

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 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.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2018, 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.

Pre-General Availability Draft Documentation Notice

If this document is in public or private pre-General Availability status:

This documentation is in pre-General Availability 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 Pre-General Availability Draft Documentation Notice

If this document is in private pre-General Availability 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 pre-General Availability 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.