 | Deprecated
This document is being deprecated. Content from this document is being migrated to documentation on www.terracotta.org. Existing sections in this document will retain links to migration destinations, while new content on relevant properties in tc.properties will appear in the appropriate documents on www.terracotta.org. |
Overview
Certain facilities, such as DSO client memory management, can be controlled through the tc.properties file, located in lib/tc.jar, in the package com.tc.properties. The tc.properties file is in the form of a standard java.util.Properties object. You can override the values of the bundled tc.properties file by either (1) creating a tc.properties file in the lib directory of the Terracotta distribution, or (2) passing individual tc.property keys to Java in the standard way by prepending com.tc. For example, to override the default value of the l1.cachemanager.threshold property, pass the following system property: -Dcom.tc.l1.cachemanager.threshold=60.
The tc.properties exist to centralize values used by various Terracotta subsystems and are not generally meant to be used by Terracotta developers. In future releases, any of the tc.properties listed below may be removed or upgraded to official configuration elements.
l1.cachemanager
See the Virtual Memory Manager section in the Terracotta Tuning Guide
.
l2.l1reconnect
See Additional Features to Support High Availability in Configuring Terracotta for High Availability.
String Compression
Compressing long strings can improve the efficiency of your clustered application. String-compression properties enable string compression and set the size limit that triggers compression.
l1.transactionmanager.strings.compress.enabled
Enables (true) or disables (false) string compression.
Default: True
l1.transactionmanager.strings.compress.minSize
Sets the minimum size (in bytes) a string must reach before compression is applied.
Default: 512
Network HA
See Additional Features to Support High Availability in Configuring Terracotta for High Availability.
HealthChecker
See Additional Features to Support High Availability in Configuring Terracotta for High Availability.
Session Properties
Session properties apply to all Web applications clustered with Terracotta DSO and running on the current JVM.
session.cookie.domain
Sets the cookie domain to help maintain sessions across web servers. In the following example, note the leading period (".") in the domain name:
With this setting, requests (with the same session ID) directed at the example.com domain can maintain a session across servers. For example, a request to server1.example.com and a request with the same session ID to server2.example.com are recognized as belonging to the same session.
