My Oracle Support Banner

Coherence Applications Upgrade Guide From 3.7.x Versions to 12c Releases and 12.1.x to 12.2.x Releases. (Doc ID 2723702.1)

Last updated on NOVEMBER 07, 2022

Applies to:

Oracle Coherence - Version and later
Oracle WebLogic Server - Version 10.3.6 and later
Information in this document applies to any platform.


Coherence applications can be upgraded to new Coherence versions to take advantage of new and improved features. This document provides instructions and guidelines that should be followed when upgrading to a new Coherence version. This document includes the upgrade guidelines for the users who are upgrading from 3.7.1.x to 12c (12.x) versions and who are upgrading from 12cR1 (12.1.x) versions to 12cR2 (12.2.x) versions.


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
 General Upgrade Guidelines
 Upgrading from Version 12.1.x
 Update JVM
 Update Maven Build Scripts
 Update Cache Configuration File
 Update Address and Port Assignments
 Update Multiple Clusters that Run on the Same Network
 Plan for TCP Usage
 Update Extractor Implementations
 Updated Packaging for Coherence REST on WebLogic Server
 Running coherence.jar for the Coherence Console
 Update CohQL Scripts
 Update the Coherence*Web Configuration
 Migrate to a Supported Web Container
 Remove ActiveCache Integrations
 Remove Encryption Filters
 Remove TopLink Grid Implementations
 Update Classpaths for HotCache
 Update Custom Health Monitors
 Upgrading from Version 3.7.1.x
 Upgrading Applications Using Coherence and Coherence*Web on WebLogic Server
 Upgrading Coherence*Extend
 Upgrading Coherence*Web
 Coherence*Web SPI Reserved for Older Versions of WebLogic
 ActiveCache (active-cache.jar) Replaced with Managed Coherence Servers
 New Session Cache Configuration File
 Upgrading ActiveCache Applications on WebLogic Server
 Replacements for Deprecated Features
 Replacement for Deprecated packet-pool and message-pool Elements
 Replacement for the Deprecated LH File Manager
 Replacement for the Deprecated NamedCache Lock APIs
 Replacement for the Deprecated XmlConfigurable Interface
 Other Upgrade Issues
 New DistributedCache Default for Exalogic Environments
 Connecting from Remote RMI Clients
 Key Associations on the Coherence*Extend Client
 Changes to Invalidation Strategy for Near Caches
 New Cache Configuration Element: resource-config
 Changes to Invocable API Behavior

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