9.3.2 Terracotta Collaboration Setup File

Set information, such as the class path and the license key, to be used for Terracotta collaboration.

When you execute the cepstarteng command after creating this file, the class path is set and the CEP engine starts.

Create the Terracotta Collaboration setup file in /etc/opt/FJSVcep/config/terracotta_conf.

Format

Below is a definition example of the Terracotta Collaboration setup file. It comprises the lines described below.

Parameter definition line: A parameter definition line has the parameterName=specifiedValue format, where the value on the right side is assigned to the parameter on the left side. Tabs and spaces at the beginning and end of the line are ignored.
Note
Do not enter any spaces or tabs around the equals sign (=).

Blank line: A blank line consists of spaces and tabs only. The entire line is ignored by Terracotta Collaboration.

Parameters that can be set

Parameters that can be set are described below (all of them are mandatory):

Parameter name	Item name	Explanation	Allowed values	Mandatory/ Optional
BDCEP_TERRACOTTA_CLASSPATH	Terracotta Collaboration class path	Path of the Terracotta jar files used for Terracotta collaboration. Delimit multiple jar file paths with a colon (:).	Up to 1,023 alphanumeric characters and the following symbols: /:-_.	Mandatory
BDCEP_TERRACOTTA_LICENSEKEY	Terracotta license key	Path of the Terracotta license key.	Up to 1,023 alphanumeric characters and the following symbols: /-_.	Mandatory

Parameter name

Item name

Explanation

Allowed values

Mandatory/
Optional

BDCEP_TERRACOTTA_CLASSPATH

Terracotta Collaboration class path

Path of the Terracotta jar files used for Terracotta collaboration. Delimit multiple jar file paths with a colon (:).

Up to 1,023 alphanumeric characters and the following symbols:

/:-_.

Mandatory

BDCEP_TERRACOTTA_LICENSEKEY

Terracotta license key

Path of the Terracotta license key.

Up to 1,023 alphanumeric characters and the following symbols:

/-_.

Mandatory

Example

Below is a definition example of the setup file when Terracotta is installed in /opt/bigmemory-max-4.0.1.

Refer to the Terracotta manual for information on the jar file to be specified for the Terracotta Collaboration class path.

BDCEP_TERRACOTTA_CLASSPATH=/opt/bigmemory-max-4.0.1/apis/ehcache/lib/ehcache-ee-2.7.1.jar:/opt/bigmemory-max-4.0.1/apis/ehcache/lib/slf4j-api-1.6.6.jar:/opt/bigmemory-max-4.0.1/apis/ehcache/lib/slf4j-jdk14-1.6.6.jar:/opt/bigmemory-max-4.0.1/common/lib/bigmemory-4.0.1.jar:/opt/bigmemory-max-4.0.1/apis/toolkit/lib/terracotta-toolkit-runtime-ee-4.0.1.jar
BDCEP_TERRACOTTA_LICENSEKEY=/var/bigmemory/terracotta-license.key

Note

Before using Terracotta Collaboration, the five jar files listed below must be set in the class path for Terracotta Collaboration.
Note that the file names may differ depending on the Terracotta version and the environment, so check the file names in the version of Terracotta to be used before setting the jar files. Insert the version of each jar file in place of "x".
- bigmemory-x.x.x.jar
- ehcache-eex.x.x.jar
- slf4j-api-x.x.x.jar
- slf4j-jdk14-x.x.x.jar
- terracotta-toolkit-runtime-ee-x.x.x.jar
If you edit the files while the CEP engine is running, you must restart the CEP engine to enable the contents.