General Notes on Configuring Restartability
A restartable
CacheManager must be supplied with a data directory name using the
restartable(<data-root-identifier>) API. If not, the
CacheManager would be created as a non-restartable
CacheManager.
The data directory name specified at
CacheManager should be any one of the data directories specified in the server configuration. For example, if a server is configured with data directories
root1,
root2 and
root3, a
CacheManager could be supplied any one of these three data directories. If the data directory specified in the
CacheManager configuration does not match the data directory specified in server configuration, the following
Exception is thrown.
org.terracotta.entity.ConfigurationException:
Given identifier (specified_directory) is not present in the server's configuration;
Cannot configure Fast Restart Store for clustered tier manager
(specified_cache_manager) due to invalid configuration specified by client.
As with a non-restartable
CacheManager, the server resource supplied in the
defaultServerResource API should exist in the
Terracotta Server configuration.
As should be obvious, the specified pool size shouldn't exceed the server resource size.
Different clients who want to connect to the same
CacheManager should use the exact same configuration. Once
CacheManager is created, any subsequent attempts to create the same
CacheManager with a different configuration will fail.