Installation Overview

Edit online

This installation guide describes how to install and configure the products Terracotta and Terracotta Ehcache.

You can install your Terracotta product by using the webMethods Installer. This simplifies the integration with other webMethods products.

Refer to the section Installing using the webMethods Installer for details.

Overview of Product Components

The installation procedure for Terracotta places the following components on your machine. You can select all of the components for installation or just a subset:

  1. Server: The server component that manages the resources of all of the Ehcache caches and TCStore stores. For information about this component, see the Terracotta Server Administration Guide.
  2. Utilities:

    A set of command-line utilities that allows you to perform a variety of cluster configuration and management tasks. The utilities include the cluster tool and the config tool.

    For information about these utilities, see the sections Cluster Tool and Config Tool in the Terracotta Server Administration Guide.

    Other utilities are described where required; for example, the use of the voter script is described in the section Failover Tuning in the Terracotta Server Administration Guide.

  3. Ehcache Client Libraries: The Ehcache API client libraries that you integrate into your Ehcache-based applications. These libraries are available both as OSGi and non-OSGi builds. For information about using the Ehcache API, see the Ehcache API Developer Guide.
  4. Management Console: The browser-based graphical user interface that allows you to monitor and manage the current status of all caches and stores managed by the Terracotta Server. For information about this component, see the Terracotta Management Console User Guide.
  5. TCStore Client Libraries: The TCStore API client libraries that you integrate into your TCStore-based applications. These libraries are available both as OSGi and non-OSGi builds. For information about using the TCStore API, see the TCStore API Developer Guide.

If you are installing Terracotta Ehcache, the product scope does not include the TCStore component. Therefore the installation procedure allows you to install the same components as for Terracotta, except the TCStore Client Libraries component.

List of System Requirements

For a list of system requirements such as supported operating systems and web browsers, see the section System Requirements.

Working in a Distributed Environment

If you intend to use Terracotta in a distributed environment with multiple hosts, you will typically aim to set up the following configuration:

  • a Terracotta Server installation on as many hosts as desired;
  • command line utilities on at least one host (could be one of the server machines);
  • the Terracotta Management Console on one host (should not be one of the server machines, can be the same as the machine containing the command line utilities);
  • API Client libraries on hosts where client applications are running.

These components are individually selectable when you use the webMethods Installer to perform the installation.

Note on Upgrading from previous Product Releases

There is an upgrade path from earlier Terracotta 10.x releases to the current release. For details, see the section Migrating from older Terracotta versions to 10.7 in the Terracotta Server Administration Guide.

There is no upgrade path or data migration path from BigMemory product releases to the current Terracotta product release.