Summary:
The UMP portal product normally uses Multicast network communications to locate and communicate additional UMP nodes in a clustered or multi-node environment. This article describes how to configure the product for Unicast instead.
Background:
In certain circumstances, it may be desirable to set up a clustered or multi-node UMP installation without using multicast.
These circumstances may include:
· situations where multicast is disabled on a network interface
· MSP situations where multiple independent multi-node UMP environments may be configured within a single network and should be isolated from each other
· Other situations where multicast is unavailable (security limitations, OS configurations, etc.)
Environment:
UMP 8.0 or later
Instructions:
You will need to follow these steps on both UMP nodes simultaneously - shut down both wasp probes, make the below changes on each node, and then start them up again one at a time (order shouldn't matter.) If there are more than two nodes, you must perform these steps on all nodes.
<UIM Install Location>\probes\service\wasp\webapps\ROOT\WEB-INF\classes\portal-ext.properties
To this file, add the following options (again note that you will need to add an IP address specific to your environment):
cluster.link.channel.properties.control=unicast.xml
cluster.link.channel.properties.transport.0=unicast.xml
ehcache.bootstrap.cache.loader.factory=com.liferay.portal.cache.ehcache.JGroupsBootstrapCacheLoaderFactory
ehcache.cache.event.listener.factory=net.sf.ehcache.distribution.jgroups.JGroupsCacheReplicatorFactory
ehcache.cache.manager.peer.provider.factory=net.sf.ehcache.distribution.jgroups.JGroupsCacheManagerPeerProviderFactory
net.sf.ehcache.configurationResourceName.peerProviderProperties=file=/unicast.xml
ehcache.multi.vm.config.location.peerProviderProperties=file=/unicast.xml
Since both UMP nodes can communicate with your SQL database server, specifying its address in the directive above will allow each node to gather some information about which network interface it should be using. You don't actually have to put the database server's IP here, technically any machine (other than the primary hub) which both nodes can communicate with should work, but using the IP of the database server is usually a guarantee that this will be the case. Make sure to specify the port as well as the IP.
In the same file, uncomment the following properties, and then start wasp:
#cluster.link.enabled=true
#lucene.replicate.write=true
Now start the wasp probes on all nodes and they should now be running in a clustered fashion but using Unicast instead of Multicast.
Additional Information:
The following line can be added to the portal-ext.properties file to enable additional debug logging around the clustering process:
cluster.executor.debug.enabled=true
The additional debug information will be logged in the portal.log file, found in the wasp folder.