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:
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.