ehcache nicht replizieren in liferay cluster

Nachdem man tagelang Lesen unzählige blog-Beiträge, Foren-Themen, und natürlich SO Fragen, wollte ich hier kurz zusammenfassen, wie wir uns es endlich geschafft zu konfigurieren cache-Replikation in einer Liferay 6.2 cluster, mit unicast-TCP entsprechend Amazon EC2.

JGroups-Konfiguration

Vor der Konfiguration von Liferay für die cache-Replikation, müssen Sie verstehen, dass Liferay setzt auf JGroups-Kanäle. Grundsätzlich JGroups ermöglicht zu entdecken und die Kommunikation mit entfernten Instanzen. Standardmäßig (zumindest in Liferay) es nutzt multicast-UDP, um diese Ziele zu erreichen. Sehen JGroups website für mehr.

Aktivieren unicast-TCP, müssen Sie zuerst bekommen JGroups' TCP-Konfigurations-Datei von jgroups.jar im Liferay-webapp (so etwas wie $LIFERAY_HOME/tomcat-7.0.42/webapps/ROOT/WEB-INF/lib/jgroups.jar). Extrahieren Sie diese Datei an einen Ort zur Verfügung zu Liferay webapp ist classpath. Sagen $LIFERAY_HOME/tomcat-7.0.42/webapps/ROOT/WEB-INF/classes/custom_jgroups/tcp.xml. Beachten Sie diese Weg.

Für diese Konfiguration funktioniert in einem Liferay-cluster, die Sie gerade brauchen, um hinzuzufügen, ein singleton_name="liferay" Attribut TCP tag:

<config xmlns="urn:org:jgroups"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="urn:org:jgroups http://www.jgroups.org/schema/JGroups-3.1.xsd">
    <TCP singleton_name="liferay"
         bind_port="7800"
         loopback="false"
         ...

Haben Sie möglicherweise bemerkt, dass:

A. diese Konfigurations-Datei ist nicht festgelegt, eine bind-Adresse auf die zu hören, und

B., dass die ursprünglichen Wirte der cluster festgelegt werden muss, durch eine system-Eigenschaft.

In der Tat, müssen Sie zum ändern $LIFERAY_HOME/tomcat-7.0.42/bin/setenv.sh zu fügen Sie die folgenden JVM-Systemeigenschaften:

-Djava.net.preferIPv4Stack=true
-Djgroups.bind_addr=192.168.0.1
-Djgroups.tcpping.initial_hosts=192.168.0.1[7800],80.200.230.2[7800]

Bind-address legt fest, welche Netzwerkschnittstelle zu hören (JGroups-port ist auf 7800 im TCP-Konfigurations-Datei). Die ersten hosts, die Eigenschaft enthalten muss jede einzelne Instanz des Clusters (für mehr auf diesem, sehen TCPPING und MERGE2 auf JGroups docs), zusammen mit Ihren listening-ports. Remote-Instanzen bezeichnet werden kann, die von Ihrem host-Namen, - local-Adressen oder öffentliche Adressen.

(Tipp: wenn Sie ein Liferay-cluster auf Amazon EC2, sind die Chancen der lokalen IP-Adresse und host-Namen der Instanzen sind unterschiedlich nach jedem Neustart. Um dies zu umgehen, können Sie ersetzen Sie die lokale Adresse in setenv.sh durch das Ergebnis der Befehl hostname: `hostname` -- beachten Sie, dass die backticks hier)

(Tipp: wenn Sie Sicherheitsgruppen verwenden, die auf EC2, Sie sollten auch stellen Sie sicher, öffnen Sie die port-7800 auf alle Instanzen in der gleichen Sicherheitsgruppe)

Liferay-Konfiguration

JGroups-Replikation aktiviert ist, auf Liferay, indem die folgenden Objekte zu Ihren portal-ext.Eigenschaften:

# Tells Liferay to enable Cluster Link. This sets up JGroups control and transport channels (necessary for indexes and cache replication)
cluster.link.enabled=true
# This external address is used to determine which network interface must be used. This typically points to the database shared between the instances.
cluster.link.autodetect.address=shareddatabase.eu-west-1.rds.amazonaws.com:5432

Konfigurieren von JGroups für die unicast-TCP ist nur eine Frage der Hinweis auf die richtige Datei:

# Configures JGroups control channel for unicast TCP
cluster.link.channel.properties.control=/custom_jgroups/tcp.xml
# Configures JGroups transport channel for unicast TCP
cluster.link.channel.properties.transport.0=/custom_jgroups/tcp.xml

In der gleichen Datei, Lucene-index-Replikation erfordert dies eine einzige Eigenschaft:

# Enable Lucene indexes replication through Cluster Link
lucene.replicate.write=true

EhCache caches Replikation ist subtiler. Sie müssen konfigurieren von JGroups für beide Hibernate cache-und Liferay-interne caches. Zum verstehen dieser Konfiguration müssen Sie wissen, dass seit Liferay 6.2, die Standard EhCache-Konfiguration-Dateien sind im "Cluster" (nicht festlegen dieser Eigenschaften):

# Default hibernate cache configuration file
net.sf.ehcache.configurationResourceName=/ehcache/hibernate-clustered.xml
# Default internal  cache configuration file
ehcache.multi.vm.config.location=/ehcache/liferay-multi-vm-clustered.xml

Diese Konfigurations-Dateien basieren beide auf EhCache Fabriken, die festgelegt werden müssen, die ermöglichen, JGroups:

# Enable EhCache caches replication through JGroups
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

JGroups' cache-manager-peer-Anbieter Fabrik erwartet einen file parameter, der die JGroups-Konfiguration. Geben Sie den unicast-TCP-Konfigurations-Datei:

# Configure hibernate cache replication for unicast TCP
net.sf.ehcache.configurationResourceName.peerProviderProperties=file=/custom_jgroups/tcp.xml

# Configure internal caches replication for unicast TCP
ehcache.multi.vm.config.location.peerProviderProperties=file=/custom_jgroups/tcp.xml

(Tipp: wenn Sie Zweifel haben, konsultieren Sie die Eigenschaften-Definitionen und Standard-Werte: https://docs.liferay.com/portal/6.2/propertiesdoc/portal.properties.html)

Debugging

Darüber hinaus können Sie aktivieren debugging-traces mit:

cluster.executor.debug.enabled=true

Man kann sogar sagen, Liferay anzeigen auf alle Seiten die Namen der Knoten, der verarbeitet die Anfrage:

web.server.display.node=true

Schließlich JGroups-Kanäle verfügbar, einen Diagnose-service zur Verfügung durch Sonde-Werkzeug.

Erwähnenswert

Bitte denkt daran, dies deckt nur Indizes und cache-Replikation. Beim einrichten eines Liferay-cluster, Sie sollten auch die Möglichkeit in Betracht ziehen:

• Freigegebenen Datenbank (RDS on AWS),
• Gemeinsamen DocumentLibrary (S3, RDS on AWS),
• Session-Replikation auf Tomcat,
• Und vielleicht auch mehr, je nachdem, wie Sie verwenden Liferay.