Cannot start nodes in a USS cluster

Document ID : KB000093495
Last Modified Date : 02/05/2018
Show Technical Document Details
17.1/17.0/14.1 CA Unified Self Service install with 2 or more clustered nodes results in the inability to start USS on the nodes.

When you start USS Service, it fails to start and the Liferay logs contain an exception like this:

21:32:37,247 ERROR [MainServlet:217] net.sf.ehcache.CacheException: 
at com.liferay.portal.cache.ehcache.EhcacheStreamBootstrapCacheLoader.start( 
at com.liferay.portal.servlet.MainServlet.processStartupEvents( 
at com.liferay.portal.servlet.MainServlet.init( 
at javax.servlet.GenericServlet.init( 
at org.apache.catalina.core.StandardWrapper.initServlet( 
at org.apache.catalina.core.StandardWrapper.loadServlet( 
at org.apache.catalina.core.StandardWrapper.load(

1) Implement a change like this on both nodes: 

# change YourNetworkShare  and Share_For_USS_Attachments  to appropriate host/folder


# below is your database server/port
#note change YourDBServerIPAddress to your database server's IP / port number

A restart of USS is needed for the above to be effective

2) To prevent further EOF exception that could happen due to corrupt cache of any node in the cluster, say you need to restart node1 first and node2 is available. 
1. Stop node1 
2. Go to the control panel of NODE2 (http://node2:8686/group/control_panel 
3. Navigate to Server Administration and Execute the “Clear content cached across the cluster.” 
4. Start node1 

If you need to restart node2 and node1 is available: 
1. Stop node2 
2. Go to the control panel of NODE1 (http://node1:8686/group/control_panel 
3. Navigate to Server Administration and Execute the “Clear content cached across the cluster.” 
4. Start node2 

Unfortunately this is needed because of the architecture of Liferay's clustering implementation and there's no other way at this time.