Skip to content

SoftwareAG/terracotta-samples

Repository files navigation

Terracotta 10.7/10.11/10.15 samples

This repository contains code samples for Terracotta version 10.7 clients (Ehcache 3 and TCStore).

NOTE: For samples corresponding to Terracotta releases 10.5 and earlier, please check release/10.5 branch. (https://github.com/SoftwareAG/terracotta-samples/tree/release/10.5)

What this document will help you accomplish:

  • Start a Terracotta cluster (one stripe or two stripes)

  • Run sample Ehcache 3 and Terracotta Store (TCStore) based applications, that connect to a Terracotta cluster.

Prerequisites:

Set the environment

  • For Un*x, run in a bash shell:

    export JAVA_HOME="/location/to/valid/JDK8OrLater" export TC_HOME="/path/to/extracted/TerracottaKit"

  • On Windows, run in a command prompt:

    set JAVA_HOME="C:\....\java\jdk1.x.y_zz" set TC_HOME="C:\path\to\extracted\TerracottaKit"

Make the license available to the server and config-tool

The config tool is responsible for activating your cluster (how many stripes in your cluster, propagating the license, etc.) Placing the license in the TC_HOME directory helps the sample server and config-tool scripts pick it up.

For example:

cp Terracotta107.xml TC_HOME/license.xml

Make sure you name the license file license.xml, and put it under TC_HOME

Run the sample applications

Clone this repo, and then you just need to cd into each directory to discover the sample and how start it.


For more information you can Ask a Question in the TECHcommunity Forums.

You can find additional information in the Software AG TECHcommunity.