Integration Server 10.3 | Clustering Guide | Managing Server Clustering | How a Stateful Integration Server Cluster and a Terracotta Server Array Handle Failures | What Happens when an Integration Server in a Stateful Cluster Cannot Connect to the Terracotta Server Array? | Integration Server Cannot Download the tc-config.xml File
 
Integration Server Cannot Download the tc-config.xml File
If Integration Server cannot download the tc-config.xml file, the startup sequence pauses while Integration Server tries to connect to the first Terracotta Server Array server specified in the Terracotta Server Array URLs list. The length of the pause is determined by the watt.server.cachemanager.connectTimeout parameter (see webMethods Integration Server Administrator’s Guide). If a connection is not established to any of the servers in the Terracotta Server Array within the time specified by this parameter, Integration Server logs an error and takes the action associated with the selected option for the Action on Startup Error parameter (see About Action on Startup Error Options).
Do the following:
1. Start the Terracotta Server Array.
2. Make sure the machine on which Integration Server is running can reach the Terracotta Server Array host specified in the tc-config.xml file.
3. Test the connection by pinging the servers in the Terracotta Server Array. You can find a list of the servers are listed in the Terracotta Server Array URLs list on the Settings > Caching > Add Cache Manager page in Integration Server Administrator.
4. Make sure the same version of Terracotta software is running on the client and the Terracotta Server Array. Check the ehcache.log file located in the Integration Server_directory /instances/instance_name/logs directory. If the Terracotta software version numbers are not the same, a version mismatch error will be logged and Integration Server shuts down.
5. Make sure the Integration Server has a valid Terracotta license key. If not, you can enable clustering on the Integration Server, but it will not be able to connect to the Terracotta Server Array. When the Integration Server starts, it will write an error to the server log and then take the action associated with the selected option for the Action on Startup Error parameter. You can add a Terracotta license key by placing the Terracotta license file into the SoftwareAG_directory\common\conf directory of the Integration Server. You must restart the Integration Server after adding a Terracotta license. Alternatively, you can use the Settings > License > License Details > Edit page in Integration Server Administrator to point to a Terracotta license file at a different location. For more information about adding the Terracotta license file, see Adding a Terracotta License.