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 config tool either:
during the cluster activation process using the
activate command, or
any later desired time by using the
set command
These commands ensure 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 activates a Terracotta cluster and installs the license file:
./config-tool.sh activate -license-file license.xml -cluster-name tc-cluster -connect-to localhost:9410
Activating nodes: localhost:9410
License installation successful
Restarting nodes: localhost:9410
Node: localhost:9410 has restarted in state: ACTIVE
All nodes came back up
Command successful!
See the set command 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 config tool set command as follows:
./config-tool.sh set -setting license-file=license.xml -connect-to localhost:9410
Connecting to: localhost:9410 (this can take time if some nodes are not reachable)
License validation passed: configuration change(s) can be applied
Applying new configuration change(s) to activated cluster: localhost:9410
Command successful!
See the set command for a detailed explanation of the command usage.