This site hosts historical documentation. Visit www.terracotta.org for recent product information.
A Terracotta license file is required to run enterprise versions of Terracotta products. The name of the file is terracotta-license.key
and must not be changed. Trial versions of Terracotta enterprise products expire after a trial period. Expiration warnings are issued both to logs and standard output to allow enough time to contact Terracotta for an extension.
Each node using an enterprise version of Terracotta software requires a copy of the license file or configuration that specifies the file's location. By default, the file is provided in the root directory of the Terracotta software kit. To avoid having to explicitly specify the file's location, you can leave it in the kit's root directory.
Or, more generally, ensure that the resource /terracotta-license.key
is on the same classpath as the Terracotta Toolkit runtime JAR. (The standard Terracotta Toolkit runtime JAR is included with Terracotta kits. See the installation section in the chapter for your Terracotta product for more information on how to install this JAR file). For example, the license file could be placed in WEB-INF/classes
when using a web application.
If the file is in the Terracotta installation directory, you can specify it with:
-Dtc.install-root=/path/to/terracotta-install-dir
If the file is in a different location, you can specify it with:
-Dcom.tc.productkey.path=/path/to/terracotta-license.key
Alternatively, the path to the license file can be specified by adding the following to the beginning of the Terracotta configuration file (tc-config.xml
by default):
<tc-properties>
<property name="productkey.path" value="path/to/terracotta-license.key" />
<!-- Other tc.properties here. -->
</tc-properties>
To refer to a license file that is in a WAR or JAR file, substitute productkey.resource.path
for productkey.path
.
There are a number of ways to verify what products and features are allowed and what limitations are imposed by your product key. The first is by looking at the readable file (terracotta-license.key
) containing the product key.
Second, at startup Terracotta software logs a message detailing the product key. The message is printed to the log and to standard output. The message should appear similar to the following:
2010-11-03 15:56:53,701 INFO - Terracotta license loaded from
/Downloads/terracotta-ee-3.4.0/terracotta-license.key
Capabilities: DCV2, authentication, ehcache, ehcache monitor, ehcache offheap, operator
console, quartz, roots, server array offheap, server striping, sessions
Date of Issue: 2010-10-16
Edition: FX
Expiration Date: 2011-01-03
License Number: 0000
License Type: Trial
Licensee: Terracotta QA
Max Client Count: 100
Product: Enterprise Suite
ehcache.maxOffHeap: 200G
terracotta.serverArray.maxOffHeap: 200G
Terracotta server information panels in the Terracotta Developer Console and Terracotta Operations Center also contain license details.