mdm-cache-config.xml.template file parameters

You should not update the mdm-cache-config.xml.template file unless you have been advised by the IBM Support to do so. However, you may need to adjust the multi-cast settings depending on your network configuration.

Values

The multi-cast settings are configured by the installer. However, you may need to update them after the installation is complete.

There are three properties that can be set in the cacheManagerPeerProviderFactory node:
peerDiscovery
This is a mandatory property. Specify "automatic" unless your network prohibits multicast. If this is the case, please consult the ehcache documentation on manual configuration of RMI communication.
multicastGroupAddress
This is a mandatory property. Specify a valid multicast group address in the range of 239.XXX.XXX.XXX. You must consult with your system administrator before you specify a multicast group address.
multicastGroupPort
This is a mandatory property. Specify a dedicated port for the multicast traffic. The default is 4446 and it is recommended that this not be changed to avoid collisions with other applications.
timeToLive
This setting configures how far multicast packets propagate past routers. 0 is restricted to the same host, 1 is restricted to the same subnet, 32 is restricted to the same site, 64 is restricted to the same region, 128 is restricted to the same continent, 255 is unrestricted. The recommended value is either 0 or 1.

When changes are added to the mdm-cache-config.xml.template file and the configureEnv.sh script is run, the changes are then reflected in the mdm-ehcache-config.xml file.

File location

The mdm-cache-config.xml.template file is located in $TOP/etc/default/ directory.

Example

This is an example of the mdm-cache-config.xml.template file:

<cacheManagerPeerProviderFactory
	class="net.sf.ehcache.distribution.RMICacheManagerPeerProviderFactory"
	properties="peerDiscovery=automatic,
		   multicastGroupAddress=239.10.10.10,
		   multicastGroupPort=4446,
		   timeToLive=1"/>