Configuring tc-config.xml on the Terracotta Server Array

Integration Server requires that you set properties in the tc-config.xml file to configure the Terracotta Server Array. After you set the required properties and start Integration Server, Integration Server downloads tc‑config.xml to obtain the information necessary to connect to the Terracotta Server Array.

You specify the host servers for clustering or caching configuration with the Terracotta Server Array URLs parameter in Integration Server Administrator. When you start public cache managers that utilize distributed caches or a clustered Integration Server using distributed system caches, Integration Server uses the Terracotta Server Array URLs parameter to download tc-config.xml from the first specified Terracotta Server Array server to which it is able to connect. Using the settings in tc-config.xml, Integration Server connects to the Terracotta Server Array to begin using distributed caches. For more information about setting the Terracotta Server Array URLs parameter, see Working with Cache Managers (for distributed caches) or the webMethods Integration Server Clustering Guide (for Integration Server using Terracotta for clustering).

Configure the settings in tc-config.xml after you install the Terracotta Server Array, but before you start either the distributed cache on Integration Server or a clustered Integration Server that uses distributed system caches.

To configure the parameters in tc-config.xml

1. On the Terracotta Server Array host server, open tc-config.xml with a text editor.

Note:
By default, a Terracotta server expects to find the tc-config file in the TerracottaHome/server/bin folder. If tc-config.xml does not already exist on the Terracotta Server Array host server you must create it.

2. Specify the following element contents:

Note:
The following parameters are required for Integration Server clusters using distributed system caches. You must specify the values for the element contents exactly as shown.

a. In the tc-properties element, specify the property attributes as follows:

<tc-properties>
<property name="ehcache.storageStrategy.dcv2.perElementTTITTL.enabled"
value="true"/>
</tc-properties>

The ehcache.storageStrategy.dcv2.perElementTTITTL.enabled property determines whether the Terracotta server supports per element time-to-live and time-to-idle expiration. A true value, which is required for Integration Servers in a cluster, indicates that expiration is per element.

b. In the clients element, specify the content of the logs child element as follows:

<clients>
<logs>%(com.softwareag.tc.client.logs.directory)</logs>
</clients>

This element defines the directory to which Integration Server writes log entries. For more information about logging, see Logging Ehcache Activity.

3. When you are finished making your changes, save and close the file.

Note:
For more information about configuring Terracotta Server Array see the Terracotta product documentation. The Using Terracotta with webMethods Products contains a sample tc-config.xml file.