The eventsubscriber runnable is an additional component to be deployed on the machine where Matomo is running. You basically need to add two additional runnables to your installation, the eventsubscriber runnable itself, and the cdf runnable (Cloud Decoupling Framework), which is required for communication between the components. CDF is a queue which can be used to decouple synchronous accesses to services.
This procedure assumes that you will add the cdf runnable to your ARIS installation and the eventsubscriber runnable to the Matomo server.
Prerequisites
You always run the ACC connected to your ARIS Agent(s), either using the usual command line switches to connect to a single agent (-h, -u, -pwd ) in case of a single node installation or using a node file (passed to the ACC with a -n switch) or by manually issuing add node commands in case of a distributed installation.
Procedure
set local.repository.only=false
The ARIS Agent will use the provided remote repository.
Example:
configure cdf_m cdf_m
Note that different from most runnables, the sizing m or l that you choose does not matter for the CDF runnable.
When adding the CDF runnable, you will not be able to update this installation with an update setup. As the setup will recognize that the installation has been tampered with. You can either update the installation manually (see ARIS Update Cookbook) or you can remove the runnable with the ACC deconfigure command (see ACC help), then run the update setup and add and configure the new version of the CDF runnable again.
reconfigure abs_m JAVA-Dcom.softwareag.copernicus.tracking.enabled=true
reconfigure copernicus_m JAVA-Dcom.softwareag.copernicus.tracking.enabled=true
This makes ACC available on this machine.
configure eventsubscriber_m eventsubscriber_m
reconfigure eventsubscriber_m zookeeper.connect.string="arisapp33srv.eur.com:14281,arisapp45srv.eur.com:14281,<host>:<port>, ..."
The eventsubscriber runnable will access Matomo via http://localhost:80/. If this default is not sufficient, reconfigure piwik.server.host, piwik.server.port, and piwik.server.path accordingly, for example:
reconfigure eventsubscriber_m piwik.server.host="arisapp44srv.eur.com" piwik.server.port=8080 piwik.server.path="piwik"
reconfigure eventsubscriber_m piwik.site.id=1
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
reconfigure eventsubscriber_m piwik.authentication.token?="f722a764407aef36bf212c6665e53500"
The runnables are available. Make sure that they are running.
To use the Matomo reports in ARIS, you must specify the report parameters accordingly.