LocalController Configuration

The LocalController is an essential service that is installed on each server in the cluster.
camm226
The LocalController is an essential service that is installed on each server in the cluster.
The LocalController performs the following key functions:
  • Facilitates communication between subcomponents running on the local server and the remote MultiControllers.
  • Monitors the performance and availability of Engines and Presenters and restarts any failed components.
  • Listens for heartbeat operations from cluster members. By default, the LocalController listens on port 29598 or TCP.
  • Sends heartbeat information to the MultiControllers.
  • Starts, stops, and restarts local Engines and Presenters.
During the GUI installation, you can configure only the mandatory options that are required to install a basic LocalController. However, you may manually edit the LC or LocalConfig-lc.xml file.
Sample LocalConfig-lc.xml file (basic configuration)
<LocalConfig> <Names> <Name name="mainClass">com.torokina.tim.lc.Main</Name> <Name name="primaryMcAddress">127.0.0.1</Name> <Name name="secondaryMcAddress"></Name> <Name name="primaryMcPort">29599</Name> <Name name="secondaryMcPort">-1</Name> <Name name="myAddress">127.0.0.1</Name> <Name name="appName">CAMM-Local-Controller</Name> <Name name="appShortName">LC</Name> <Name name="lcPort">29598</Name> <Name name="heartbeatFrequency">15</Name> <Name name="heartbeatTimeout">180</Name> </Names> <Paths> <Path name="dsLocalConfig">${basedir}/DS/LocalConfig-ds.xml</Path> </Paths> </LocalConfig>
Sample LocalConfig-lc.xml file (hidden logging and cleanups configuration)
<Logging> <LogLevel>INFO</LogLevel> <LogDirectory>${logbase}</LogDirectory> <ObjectLogging> <ObjectToLog> <ObjectName>com.torokina.tim.config</ObjectName> <ObjectLogLevel>TRACE</ObjectLogLevel> </ObjectToLog> </ObjectLogging> </Logging> <CleanUps> <CleanUp> <CleanUpName>clean-temporary-directory</CleanUpName> <CleanUpAction>delete</CleanUpAction> <CleanUpTarget>${tmp}</CleanUpTarget> <Parameter> <ParameterName>expire</ParameterName> <ParameterValue>3d</ParameterValue> </Parameter> </CleanUp> <CleanUp> <CleanUpName>archive-log-directory</CleanUpName> <CleanUpAction>archive</CleanUpAction> <CleanUpTarget>${logbase}</CleanUpTarget> <Parameter> <ParameterName>expire</ParameterName> <ParameterValue>3d</ParameterValue> </Parameter> </CleanUp> <CleanUp> <CleanUpName>clean-log-directory</CleanUpName> <CleanUpAction>delete</CleanUpAction> <CleanUpTarget>${logbase}</CleanUpTarget> <Parameter> <ParameterName>expire</ParameterName> <ParameterValue>7d</ParameterValue> </Parameter> </CleanUp> </CleanUps>
Sample LocalConfig-lc.xml file (LocalController runtime)
<?xml version="1.0" encoding="UTF-8"?> <Runtime> <Names> <Name name="mainClass">com.torokina.tim.lc.Main</Name> <Name name="primaryMcAddress">127.0.0.1</Name> <Name name="secondaryMcAddress"/> <Name name="primaryMcPort">29599</Name> <Name name="secondaryMcPort">-1</Name> <Name name="myAddress">127.0.0.1</Name> <Name name="appName">CAMM-Local-Controller</Name> <Name name="appShortName">LC</Name> <Name name="lcPort">29598</Name> <Name name="heartbeatFrequency">15</Name> <Name name="heartbeatTimeout">180</Name> <Name name="mcPort">29599</Name> <Name name="manageable">996</Name> </Names> <Paths> <Path name="dsLocalConfig">${basedir}/DS/LocalConfig-ds.xml</Path> <Path name="apphome">${tim.base}/${appShortName}</Path> <Path name="runtimeConfig">${apphome}/runtime.xml</Path> <Path name="tmp">${apphome}/tmp</Path> <Path name="logbase">${apphome}/logs</Path> <Path name="basedir">${tim.base}</Path> </Paths> </Runtime>