Licensing
This document describes the installation and update procedures for Terracotta Ehcache and Terracotta licenses.
Installing a license
A Terracotta license is installed on a Terracotta cluster using the cluster tool configure command, thereby enabling cluster configuration and license installation in one go. The command ensures that:
The license is a valid Software AG license.
The license has not expired already.
The
Terracotta configuration files do not violate the license.
The following example configures a Terracotta cluster using the license file license.xml, the name tc-cluster, and the configuration file tc-config.xml.
cluster-tool.sh configure -l license.xml -n tc-cluster tc-config.xml
Command completed successfully.
See the section
Cluster Tool for a detailed explanation of the command usage.
License expiration
License expiry checks are done every midnight (UTC time) to ensure that the license in use did not expire. Midnight here is the time at the start of the day, i.e. '00:00' hours. As an example, for a license which is valid till December 31, the midnight check on December 31 will pass, but the check on January 1 midnight will fail, and license will be deemed as expired. When a license expires, a warning message like the following will be logged every 30 minutes in the server logs:
ATTENTION!! LICENSE expired. Time since expiry 1 day(s)
The license must be renewed within 7 days of expiry. If it is not done, the cluster will be shut down with the following message in the server logs:
Shutting down the server as a new license is not installed within 7 days.
License renewal
If your license expires, a new license can be obtained by contacting Software AG support. The new license can then be installed using the cluster tool reconfigure command as follows:
cluster-tool.sh reconfigure -l license.xml -s localhost:9410
Command completed successfully.
See the section
Cluster Tool for a detailed explanation of the command usage.