Configuration in a Cluster Setup

20.2 Configuration in a Cluster Setup

JCS provides multiple auxiliaries which can be plugged into a cache region and OIG uses TCP Lateral(LTCP). Please read thru the below doc to know more about it.
https://commons.apache.org/proper/commons-jcs/LateralTCPAuxCache.html

Every JCS region is shipped with a empty value for Auxiliary. Please open the file <OIM_HOME>/server/config/cache.ccf file and provide the value "LTCP" for each region.

Example:

jcs.default=LTCP

jcs.region.DataObjectEventHandlers=LTCP

jcs.region.ProcessDefinition=LTCP

etc..
The last section of "cache.ccf" file shows the below content. The value for "jcs.auxiliary.LTCP.attributes.UdpDiscoveryAddr" (i,e multicast address) attribute can be determined by running the below command
```
# TCP and UDP
jcs.auxiliary.LTCP=org.apache.commons.jcs3.auxiliary.lateral.socket.tcp.LateralTCPCacheFactory
jcs.auxiliary.LTCP.attributes=org.apache.commons.jcs3.auxiliary.lateral.socket.tcp.TCPLateralCacheAttributes
jcs.auxiliary.LTCP.attributes.TcpListenerPort=7800
jcs.auxiliary.LTCP.attributes.UdpDiscoveryAddr=230.182.50.205
jcs.auxiliary.LTCP.attributes.UdpDiscoveryPort=45566
jcs.auxiliary.LTCP.attributes.UdpDiscoveryEnabled=true
jcs.auxiliary.LTCP.attributes.UdpTTL=4
jcs.auxiliary.LTCP.attributes.Receive=true
jcs.auxiliary.LTCP.attributes.AllowGet=false
jcs.auxiliary.LTCP.attributes.IssueRemoveOnPut=false
jcs.auxiliary.LTCP.attributes.PutOnlyMode=true
```
Determining the value for multicast address

jcs.auxiliary.LTCP.attributes.UdpDiscoveryAddr

Multicast addresses can be found from the OS level command like In Linux.

> ip maddr show

Sample output:

6: eth0

link 33:33:00:00:00:01

link 01:00:5e:00:00:01

inet 224.0.0.1

Pickup the IP address "224.0.0.1" and provide the same for the attribute "jcs.auxiliary.LTCP.attributes.UdpDiscoveryAddr".

All OIM servers in the OIM cluster must share the same multicast address and multicast port like

jcs.auxiliary.LTCP.attributes.UdpDiscoveryAddr=224.0.0.1 jcs.auxiliary.LTCP.attributes.UdpDiscoveryPort=45566

Note:
That the jcs.auxiliary.LTCP.attributes.UdpDiscoveryPort must be chosen to form a unique JCS multicast channels within OIM servers.
Save the changes and restart the server.