Starting from 14c version, OIG uses JCS Cache to manage cached data instead of EH cache. The EH cache is replaced by JCS due to security vulnerability reasons. JCS uses Lateral UDP Discovery (LTCP) to distribute cache among the nodes. To learn about JCS, refer to https://commons.apache.org/proper/commons-jcs/LateralUDPDiscovery.html

JCS uses cache region (or category) for storing the related data together and every region has it's own configuration. The cache configuration for all regions is stored in a file called cache.ccf that is found at the location <OIM_HOME>/server/config/.

An example of one region configuration is shown below.

To change the settings as desired, you must edit this file and restart the server to make the changes effective. The description of each parameter is explained at https://commons.apache.org/proper/commons-jcs/LateralTCPProperties.html.

jcs.region.SSOIntegration=LTCP
jcs.region.SSOIntegration.cacheattributes=org.apache.commons.jcs3.engine.CompositeCacheAttributes
jcs.region.SSOIntegration.cacheattributes.MaxObjects=200001
jcs.region.SSOIntegration.cacheattributes.MemoryCacheName=org.apache.commons.jcs3.engine.memory.lru.LRUMemoryCache
jcs.region.SSOIntegration.cacheattributes.UseMemoryShrinker=truejcs.region.SSOIntegration.cacheattributes.MaxMemoryIdleTimeSeconds=3600jcs.region.SSOIntegration.cacheattributes.ShrinkerIntervalSeconds=60
jcs.region.SSOIntegration.elementattributes=org.apache.commons.jcs3.engine.ElementAttributes
jcs.region.SSOIntegration.elementattributes.IsEternal=false
jcs.region.SSOIntegration.elementattributes.MaxLifeSeconds=700
jcs.region.SSOIntegration.elementattributes.IdleTime=1800
jcs.region.SSOIntegration.elementattributes.IsSpool=true
jcs.region.SSOIntegration.elementattributes.IsRemote=true
jcs.region.SSOIntegration.elementattributes.IsLateral=true

The oim-config.xml also contains the cache settings in an XML tag <cacheCategoryConfig> as shown below.

The attribute expirationTime found in this file is same as the attribute "jcs.region.<region name>.elementattributes.MaxLifeSeconds" found in the cache.ccf file. The changes performed in oim-config.xml overrides the default configuration. Hence, use cache.ccf for any configuration.

<cacheCategoryConfig name="SSOIntegration" enabled="true" expirationTime="14400" />

In addition to JCS specific configuration, the following two extra parameters are used to override the parameter "TcpListenerPort". You can use this configuration if multiple OIM nodes are running in a same host.

jcs.auxiliary.LTCP.attributes.TcpListenerPort=10890

#When there are multiple OIM servers in the same host machine, jcs.auxiliary.LTCP.attributes.TcpListenerPort must be defined with a different value per server. In this case, to override the default configuration.

#machine1

oracle.iam.host.WLS_OIM1.tcpport=10890

oracle.iam.host.WLS_OIM2.tcpport=10891

#machine2

oracle.iam.host.WLS_OIM3.tcpport=10890

oracle.iam.host.WLS_OIM4.tcpport=10891