1. Release Notes for Oracle Coherence
  2. Known Issues and Workarounds

3 Known Issues and Workarounds

Learn about the known issues at the time of release.

This chapter includes the following section:

Changing the Partition Count When Using Active Persistence

Issue

The partition count cannot be changed when using active persistence. If you change a services partition count, then on restart of the services all active data is moved to the persistence trash and must be recovered after the original partition count is restored. Data that is persisted can only be recovered to services running with the same partition count.

Ensure that the partition count is not modified if active persistence is being used. If the partition count is changed, then a message similar to the following is displayed when the services are started:

<Warning> (thread=DistributedCache:DistributedCachePersistence, member=1):
Failed to recover partition 0 from SafeBerkeleyDBStore(...); partition-count
mismatch 501(persisted) != 277(service); reinstate persistent store from
trash once validation errors have been resolved

The message indicates that the change in the partition-count is not supported and the current active data has been copied to the trash directory.

Workaround

To recover the data:

  1. Shutdown the entire cluster.

  2. Remove the current active directory contents for the cluster and service affected on each cluster member.

  3. Copy (recursively) the contents of the trash directory for each service to the active directory.

  4. Restore the partition count to the original value.

  5. Restart the cluster.

Parent topic: Known Issues and Workarounds

Disabling Inlining in Java Versions Greater than 8

When using Java versions greater than Java 8 (for example, Java 11), one of the directives below should be provided as a JVM Option (on the command line). This step is to avoid a segmentation fault (SIGSEGV) that has been observed due to a compiler bug that is being worked on by the Java team.

  • -XX:CompileCommand=exclude,com/tangosol/coherence/component/util/daemon/queueProcessor/service/Grid.onInterval
  • -XX:-Inline

The first option will exclude the problematic method from being inlined by the compiler while the latter will disable inlining altogether.

Parent topic: Known Issues and Workarounds

Binary Incompatibility with Older Versions

There is a binary incompatibility between Oracle Coherence release 14.1.1.0 and Oracle Coherence release 14.1.2. This incompatibility requires upgrading users to recompile your applications against 14.1.2. It is a binary incompatibility only; not an API or functional incompatibility.

When you run Coherence-based applications prior to release 14.1.2 with the coherence.jar file from that release, you may encounter the following exception at runtime:
java.lang.ClassNotFoundException: com.tangosol.net.NamedCache$Option

For example, from Session.getCache("<cache name>") calls. This exception occurs because the nested class Option moved, in a refactoring, from NamedCache to its supertype NamedMap between 14.1.1.0 and 14.1.2. This refactoring preserves the API compatibility for the previous code using NamedCache.Option, but requires recompilation of that code against the 14.1.2 coherence.jar.

Workaround

To run a Coherence-based application prior to Oracle Coherence 14.1.2 with that release, you should first recompile the application against 14.1.2. Recompiling will avoid encountering a binary incompatibility exception at runtime.

Parent topic: Known Issues and Workarounds

pof-maven-plugin Version is Non-Compliant

Issue

The pof-maven-plugin packaged in the installer has a version qualifier, for example, 14.1.2-0-0-112309 in the plug-in pom.xml file and in the Maven plug-in metadata, under META-INF/maven/plugin.xml, which is generated and packaged inside the pof-maven-plugin JAR file.

Workaround

When the oracle-maven-sync plug-in is used to put the pof-maven-plugin artifacts into the local Maven repository, the plug-in output will show a message as follows:
[INFO] Installing <OracleHome>/coherence/plugins/maven/com/oracle/coherence/pof-maven-plugin/14.1.2/pof-maven-plugin.14.1.2.jar to $HOME/.m2/repository/com/oracle/coherence/pof-maven-plugin/14.1.2-0-0-112309/pof-maven-plugin-14.1.2-0-0-112309.jar
[INFO] Installing <OracleHome>/coherence/plugins/maven/com/oracle/coherence/pof-maven-plugin/14.1.2/pof-maven-plugin.14.1.2.pom to $HOME/.m2/repository/com/oracle/coherence/pof-maven-plugin/14.1.2-0-0-112309/pof-maven-plugin-14.1.2-0-0-112309.pom
When the pof-maven-plugin is used and referenced inside the Maven pom.xml file, the pof-maven-plugin version must be specified as the same exact version with the qualifier, as shown in the output message, for example 14.1.2-0-0-112309:
<groupId>com.oracle.coherence</groupId>
<artifactId>pof-maven-plugin</artifactId>
<version>14.1.2-0-0-112309</version>

Parent topic: Known Issues and Workarounds