Das Runnable eventsubscriber ist eine zusätzliche Komponente, die auf dem Rechner bereitzustellen ist, auf dem Matomo ausgeführt wird. Im Grunde müssen Sie Ihrer Installation zwei zusätzliche Runnables hinzufügen: das Runnable eventsubscriber selbst sowie das Runnable cdf (Cloud Decoupling Framework), das für die Kommunikation zwischen den Komponenten benötigt wird. CDF ist eine Warteschlange, die zum Entkoppeln synchroner Zugriffe auf Services verwendet werden kann.
Bei dem hier beschriebenen Vorgehen wird davon ausgegangen, dass Sie Ihrer ARIS-Installation das Runnable cdf und Ihrem Matomo-Server das Runnable eventsubscriber hinzufügen.
Voraussetzungen
Sie verfügen über eine ARIS-Server-Installation, die ausgeführt wird.
Sie haben Zugriff auf das ARIS agent-Setup.
Sie verfügen über Grundkenntnisse der Verwendung von
.ARIS Cloud Controller kann in mehreren Modi verwendet werden.
Um ACC auf einem Windows-Betriebssystem zu starten, klicken Sie auf Start > Alle Programme > ARIS > Administration > ARIS Cloud Controller starten. Falls Sie die Anmeldeinformationen des Agent-Benutzers geändert haben, müssen Sie den Benutzernamen und/oder das Kennwort eingeben.
Zum Starten von ACC auf einem Linux-Betriebssystem führen Sie stattdessen das Shell-Skript acc10.sh aus. Geben Sie dazu Folgendes ein: su -c acc10.sh aris10.
Sie führen stets das mit Ihrem/Ihren ARIS agent(s) verbundene ACC aus, wahlweise über die üblichen Kommandozeilenschalter zum Verbinden mit einem einzelnen Agent (-h, -u, -pwd) im Falle einer Einzelknoten-Installation, über eine Knotendatei (die über den Schalter -n an ACC weitergegeben wird) oder durch manuelles Ausgeben von add node-Befehlen im Falle einer verteilten Installation.
Starten Sie ACC über die Startmenü-Verknüpfung, die beim Setup angelegt wurde. Achten Sie ansonsten darauf, dass Sie immer die richtige Datei generated.apptypes.cfg an diesen ACC weitergeben, indem Sie den Kommandozeilenschalter -c verwenden. Es ist wichtig, dass es sich bei der Datei generated.apptypes.cfg um dieselbe Version wie die der Installation handelt, der Sie Runnables hinzufügen möchten.
Öffnen Sie spezielle Ports zwischen dem ARIS-Server und dem Server, auf dem das Runnable eventsubscriber ausgeführt werden wird. Diese sind der Client-Port zookeeper und der ActiveMQPort des Runnable cdf.
Sie haben Zugriff auf die Matomo-Konfigurationswerte (IDs und Token).
Vorgehen
Starten Sie ARIS Cloud Controller (ACC) auf Ihrem ARIS-Server.
Geben Sie das Kennwort des Agent-Benutzers ein.
Sorgen Sie dafür, dass der ARIS agent das Remote-Repository als Download-Quelle für die Runnables verwendet.
Wenn Sie den ARIS-Server über das Setup installiert haben, wird der ARIS agent so eingestellt, dass Runnables aus seinem lokalen Repository verwendet werden. Um dies zu ändern, führen Sie den folgenden Befehl aus:
set local.repository.only=false
Der ARIS agent verwendet nun das bereitgestellte Remote-Repository.
Zum Hinzufügen des Runnables CDF geben Sie den folgenden Befehl ein:
Beispiel:
configure cdf_m cdf_m
Beachten Sie, dass die von Ihnen gewählte Dimensionierung m oder l im Unterschied zu den meisten anderen Runnables bei CDF belanglos ist.
Beim Hinzufügen des Runnables CDF wird es nicht möglich sein, diese Installation mit einem Update-Setup zu aktualisieren, da das Setup erkennt, dass die Installation manipuliert wurde. Sie können entweder die Installation manuell aktualisieren (siehe ARIS Update Cookbook) oder das Runnable mit dem ACC-Befehl deconfigure entfernen (siehe ) und dann das Update-Setup ausführen und die neue Version des Runnables CDF erneut hinzufügen und konfigurieren.
ARIS Cloud Controller kann in mehreren Modi verwendet werden.
Um ACC auf einem Windows-Betriebssystem zu starten, klicken Sie auf Start > Alle Programme > ARIS > Administration > ARIS Cloud Controller starten. Falls Sie die Anmeldeinformationen des Agent-Benutzers geändert haben, müssen Sie den Benutzernamen und/oder das Kennwort eingeben.
Zum Starten von ACC auf einem Linux-Betriebssystem führen Sie stattdessen das Shell-Skript acc10.sh aus. Geben Sie dazu Folgendes ein: su -c acc10.sh aris10.
Aktivieren Sie die Nutzungsnachverfolgung in allen Instanzen des Runnables abs und des Runnables copernicus. Geben Sie z. B. Folgendes ein:
reconfigure abs_m JAVA-Dcom.softwareag.copernicus.tracking.enabled=true
reconfigure copernicus_m JAVA-Dcom.softwareag.copernicus.tracking.enabled=true
Installieren Sie den ARIS agent auf dem Rechner, auf dem Matomo installiert ist. Sie können das ARIS agent-Setup vom ARIS Download Center herunterladen.
Damit ist ACC auf diesem Rechner verfügbar.
Um dem Matomo-Server das Runnable eventsubscriber hinzuzufügen, starten Sie ACC und geben Sie den folgenden Befehl aus:
configure eventsubscriber_m eventsubscriber_m
Konfigurieren Sie zookeeper.connect.string neu, sodass es auf alle Rechner mit einer ZooKeeper-Instanz zeigt, z. B.:
reconfigure eventsubscriber_m zookeeper.connect.string="arisapp33srv.eur.com:14281,arisapp45srv.eur.com:14281,<host>:<port>, ..."
Das Runnable eventsubscriber greift über http://localhost:80/ auf Matomo zu. Wenn diese Standardeinstellung nicht ausreicht, konfigurieren Sie piwik.server.host, piwik.server.port und piwik.server.path in entsprechender Weise neu, z. B.:
reconfigure eventsubscriber_m piwik.server.host="arisapp44srv.eur.com" piwik.server.port=8080 piwik.server.path="piwik"
Konfigurieren Sie piwik.site.id mit der ID der ARIS-Website in Matomo neu (siehe gespeicherte Parameter aus der Matomo-Installation), z. B.:
reconfigure eventsubscriber_m piwik.site.id=1
Konfigurieren Sie piwik.visit.tenant.dimension.id, piwik.visit.action.resource.path.dimension.id und piwik.visit.action.resource.type.dimension.id mit den IDs der in Matomo angelegten Custom Dimensions 'tenant', 'resource-path' und 'resource-type' neu, z. B.:
reconfigure eventsubscriber_m piwik.visit.tenant.dimension.id=1 piwik.visit.action.resource.path.dimension.id=2 piwik.visit.action.resource.type.dimension.id=3
Konfigurieren Sie piwik.authentication.token neu und legen Sie das Authentifizierungs-Token eines geeigneten Matomo-Benutzers mit Leseberechtigung für die ARIS-Website fest (siehe gespeicherte Parameter aus der Matomo-Installation). Es empfiehlt sich, den Wert der Eigenschaft in ACC mit dem Neukonfigurationsoperator ?= zu maskieren, z. B.:
reconfigure eventsubscriber_m piwik.authentication.token?="f722a764407aef36bf212c6665e53500"
Damit die Änderungen wirksam werden, müssen Sie das Runnable eventsubscriber stoppen und neu starten.
Die Runnables sind verfügbar. Vergewissern Sie sich, dass sie ausgeführt werden.
Um die Matomo-Reporte in ARIS verwenden zu können, müssen Sie die Reportparameter entsprechend festlegen.