Oracle Coherence Best Practices for Session Management (Replication) in Clustered Application Servers Environment

Oracle Coherence is a in-memory data grid product, which is also being used commonly for Session Replication across cluster of application server nodes. It supports wide variety of application servers like WebLogic, WebSphere, Tomcat, JBoss, etc. Coherence*Web is Session Management module (built on top of Coherence) used for managing session information in clustered environment.

I would recommend following best practices w.r.t. Coherence*Web & Coherence usage particularly for Session Management (it can also be applied in other Coherence scenarios):

Coherence Deployment Topology

Coherence supports three deployment modes:

  1. In-process - Application servers that run Coherence*Web are storage-enabled, so that the HTTP session storage is co-located with the application servers. No separate cache servers are used for HTTP session storage.
  2. Out-of-process - The application servers that run Coherence*Web are storage-disabled members of the Coherence cluster. Separate cache servers are used for HTTP session storage.
  3. Out-of-Process with Coherence*Extend - The application servers that run Coherence*Web are not part of a Coherence cluster; the application servers use Coherence*Extend to attach to a Coherence cluster which contains cache servers used for HTTP session storage.


If there is need for Coherence to extend its boundaries beyond core Coherence TCMP (internal protocol used by Coherence), use Coherence*Extend, which supports Java, .Net & C++ clients.

In most of the scenarios, out-of-process is recommended topology because it has dedicated cache server nodes running independently promoting loose-coupled physical architecture.

For Session Replication, sharing associated application server memory (heap) with Coherence using in-process deployment creates dependability. If application server memory usage increases, it will impact Coherence performance as well & vice-versa.

Please make sure the following for Out-of-process configuration: Application Server Nodes are running in Storage-disabled mode. You need to pass both of these command-line parameters (or by using Coherence over-ride file) to application server JVM :


Please note that setting session storage property explicitely is needed as by default it is “true” in “session-cache-config.xml”:


<local-storage system-property="tangosol.coherence.session.localstorage"


Coherence Dedicated Nodes need to be storage enabled (otherwise there is nobody to store session attributes) and should either use “session-cache-config.xml” or custom cache configuration file with session cache configured in it:

java –Xms512m -Xmx512m -cp /usr/local/coherence_3_6/lib/coherence.jar:/usr/local/coherence_3_6/lib/coherence-web-spi.war:/usr/local/coherence_3_6/lib/commons-logging-api.jar:/usr/local/coherence_3_6/lib/log4j-1.2.8.jar
 -Dtangosol.coherence.cacheconfig=../../../webapps/example/WEB-INF/classes/session-cache-config.xml -Dtangosol.coherence.log.level=6 -Dtangosol.coherence.ttl=2 -Dtangosol.coherence.log=log4j -Dtangosol.coherence.edition=EE

Coherence Cache Topology

Coherence supports five different types of Cache based upon four cache topologies:

  1. Local Cache Topology: Local Cache
  2. Partitioned Cache Topology: Distributed (or Partitioned Cache)
  3. Replicated Cache Topology: Replicated Cache, Optimistic Cache
  4. Hybrid Topology (Local + Partitioned): Near Cache

You can use following simple guidelines in choosing appropriate type of cache:

ScenarioRecommended Cache Type
·You need faster read & write
·You don’t need fault tolerance (caution: no fault tolerance)
Local Cache
·You need faster read with best fault tolerance
·Write will be comparatively good but will have latency for copying updated data across
·Typically used to store metadata or configuration data

Note: Scale-out (horizontal scalability) can not be linear.

Replicated Cache
·You need faster write but best fault tolerance
·Read will be comparatively faster but depend on whether it reads from local or remote node
Partitioned or Distributed Cache
·You need faster write but best fault tolerance
·Read will be comparatively faster but depend on whether it reads from local or remote node
·Affinity boost performance of read-heavy application with moderate writes
Near Cache (backed up by Partitioned Cache)

Executing Production Checklist

Coherence recommends executing list of checklist on production environment to make sure environment & infrastructure has recommended settings/configurations particularly in following areas:

  • Network:
    • Multicast Test: If you are using multicast clustering, this test is must to make sure multicast configuration is correct & working properly.
    • Datagram Test – Before deploying your application, you must run it to make sure that there is no packet-loss in your network. Note that in 1GbE network, you should use 100MB packets for testing & minimum (not average) success rate should be close to 100% (~98-99%)
    • TTL – It is very important setting for multicast network & usually 2-5 is recommended value in production environment
  • Hardware, OS & JVM Settings
  • Coherence Editions & Modes:
    • Needless to say, Coherence mode should be PROD in production environment. It needs to be specified on command-line as override configuration file can not be used for Edition & Mode.


    • By default, Coherence runs in GE (Grid Edition) & it is very important to use appropriate edition (as per your license & needs) to specify the correct edition.


      Note that all the nodes in cluster should use same edition.

Executing Performance Tuning Guidelines

Coherence suggests tuning for: OS, Network, JVM & Coherence Network. Please refer to Coherence Performance Tuning guidelines (reference section) for more details.

Enable JMX for Monitoring Coherence

Coherence provides OOTB support for JMX-based monitoring for its cluster, nodes, caches & others. It needs at least one node to act as manager & rest of the nodes in cluster can publish their statistics using JMX.

For management node,

For other nodes, you can simply remove “” command-line parameter. Also, note that in above case, JMX authentication is not enabled (which needs to be secured) & JMX port needs to be specified as well.

Using Log4J for Coherence Logs

Though Coherence has its own logging mechanism, Log4J is more beneficial in terms of log rotation & controlling appropriate log levels.

Note that you can use both Coherence Log Level parameter (-Dtangosol.coherence.log.level) & Log4J configuration for logging level.

Follow these steps to enable Log4J for Coherence:

  • Coherence does not have log4j libraries & hence you need to add following jars to classpath:
    a. Copy “commons-logging-api.jar” & “log4j-1.2.8.jar” to /lib folder
  • Create/Modify your Log4J XML file & put that in classpath of your Coherence JVM.
  • Set command-line parameter (or use override file) to specify log parameter value as “log4j”.

Note that Coherence assumes that Log4J XML will have Logger Name as “Coherence” otherwise you need to specify logger name by having separate parameter “tangosol.coherence.log.logger”.


Cache Server Startup Script

JAVA_OPTS="-Xms$MEMORY -Xmx$MEMORY -Dtangosol.coherence.log.level=6 -Dtangosol.coherence.log=log4j -Dtangosol.coherence.log.logger=MyCoherence"

$JAVAEXEC -server -showversion $JAVA_OPTS -cp "$COHERENCE_HOME/lib/coherence.jar:$ "$COHERENCE_HOME/lib/commons-logging-api.jar:$ COHERENCE_HOME/lib/log4j-1.2.8.jar" $1



<logger name="MyCoherence">

<level value="3"/>

<appender-ref ref="CoherenceAppender"/>


Review Coherence*Web Context Parameter

There are several Coherence Web Context Parameters, which need to be adjusted when you are installing Coherence*Web in your web application, particularly following:

  • coherence-enable-sessioncontext
  • coherence-session-id-length
  • coherence-session-urlencode-enabled
  • coherence-session-thread-locking
  • coherence-sticky-sessions
  • coherence-reaperdaemon-assume-locality
  • coherence-enable-suspect-attributes

Note: These parameters are configured in web.xml & got instrumented when Coherence*Web install utility is invoked.

Using Coherence as L2 Cache Provider

Coherence can also be used as L2 Cache provider for ORM frameworks in-use. Having Coherence as L2 cache enables enterprise level caching for your ORM L2 caches as well.

To configure the same, you need to specify Coherence as L2 Cache Provider (particularly for Hibernate L2 Cache):

  • Specify Coherence as L2 Cache provider in Hibernate Configuration file:
    <prop key="hibernate.cache.provider_class">
  • Configuration for Hibernate L2 Cache is loaded based on following parameter. There is default L2 Cache configuration file already in place.
    -Dtangosol.coherence.hibernate.cacheconfig = /hibernate-cache-config.xml


Coherence User Guide:

Related Whitepaper:

Functional Programming in Java: Harnessing the Power of Java 8 Lambda Expressions

Get ready to program in a whole new way!

Functional Programming in Java will help you quickly get on top of the new, essential Java 8 language features and the functional style that will change and improve your code. This short, targeted book will help you make the paradigm shift from the old imperative way to a less error-prone, more elegant, and concise coding style that’s also a breeze to parallelize. You’ll explore the syntax and semantics of lambda expressions, method and constructor references, and functional interfaces. You’ll design and write applications better using the new standards in Java 8 and the JDK.

Get it Now!  

Leave a Reply

× one = 3

Java Code Geeks and all content copyright © 2010-2014, Exelixis Media Ltd | Terms of Use
All trademarks and registered trademarks appearing on Java Code Geeks are the property of their respective owners.
Java is a trademark or registered trademark of Oracle Corporation in the United States and other countries.
Java Code Geeks is not connected to Oracle Corporation and is not sponsored by Oracle Corporation.

Sign up for our Newsletter

15,153 insiders are already enjoying weekly updates and complimentary whitepapers! Join them now to gain exclusive access to the latest news in the Java world, as well as insights about Android, Scala, Groovy and other related technologies.

As an extra bonus, by joining you will get our brand new e-books, published by Java Code Geeks and their JCG partners for your reading pleasure! Enter your info and stay on top of things,

  • Fresh trends
  • Cases and examples
  • Research and insights
  • Two complimentary e-books