Call us: +1-415-738-4000
You might want to run the Terracotta Server Array or the Cross-Language Connector, which are Java programs, as a Windows service. If so, use the Service Wrapper located inside the kit at
$installdir/server/wrapper (or, for 3.7,
To start the service, set your
conf/wrapper-clc.conf. For example:
The wrapper does not read your
JAVA_HOME from the environment. For Windows, if you do not want to set it in the configuration file, comment it out and set
JAVA_HOME in the registry instead.
For the Cross-Language Connector, you need these configuration files:
For the TSA, you need this configuration file:
Overwrite those files with your own. If you want to change these file names, modify the names in the wrapper configurations.
TSA conf/wrapper-tsa.conf file to match the server name in your tc-config.xml:
where server0 represents the name of the server you want to start.
The services are controlled by an Administrator user, so you have to confirm for every action, such as install, start, stop, remove.
In addition, the Administrator user needs to have read/write permission for the "wrapper" directory.
The wrapper service is located at
To install the service wrapper, run the script with the install parameter:
%> bin/tsa-service.bat install
NOTE: The examples in this section show the TSA script. For the Cross-Language Connector, use the
Then you can either start/stop the service:
%> bin/tsa-service.bat start %> bin/tsa-service.bat stop
If you want to remove the service:
%> bin/tsa-service.bat remove
There are more commands available when you run the script without any parameter:
There are comments in
wrapper-clc.conf to explain each parameter.
If you need to modify JVM system properties, classpath, or command line parameters,
follow the current pattern. Pay close attention to their numerical
order and parameter counts.
For more information, see http://wrapper.tanukisoftware.com/doc/english/properties.html