Runnables hinzufügen

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

Vorgehen

  1. Starten Sie ARIS Cloud Controller (ACC) auf Ihrem ARIS Server.
  2. Geben Sie das Kennwort des Agent-Benutzers ein.
  3. Sorgen Sie dafür, dass ARIS Agent das Remote-Repository zum Herunterladen der Runnables verwendet.
  4. Wenn Sie den ARIS-Server über das Setup installiert haben, wird 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

    ARIS Agent verwendet nun das bereitgestellte Remote-Repository.

  5. 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 ACC-Hilfe) und dann das Update-Setup ausführen und die neue Version des Runnables CDF erneut hinzufügen und konfigurieren.

  6. 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

  7. Installieren Sie ARIS Agent auf dem Rechner, auf dem Matomo installiert ist. Das ARIS Agent-Setup ist auf DVD verfügbar.

    Damit ist ACC auf diesem Rechner verfügbar.

  8. Um dem Matomo-Server das Runnable eventsubscriber hinzuzufügen, starten Sie ACC und geben Sie den folgenden Befehl aus:

    configure eventsubscriber_m eventsubscriber_m

  9. 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"

  10. Konfigurieren Sie piwik.site.id mit der ID der ARIS Connect-Website in Matomo neu (siehe gespeicherte Parameter aus der Matomo-Installation), z. B.:

    reconfigure eventsubscriber_m piwik.site.id=1

  11. 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

  12. Konfigurieren Sie piwik.authentication.token neu und legen Sie den Authentifizierungs-Token eines entsprechenden Matomo-Benutzers mit Leseberechtigung für die ARIS Connect-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"

  13. 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.