The eventsubscriber runnable is an additional component to be deployed on the machine where Piwik 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 Piwik 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.
ACC is a command-line tool for administrating and configuring an ARIS installation. It communicates with ARIS Agents on all nodes.
To start ACC under a Windows operating system click Start > All Programs > ARIS > Administration > Start ARIS Cloud Controller. If you have changed agent user credentials you must enter the user name and/or the password.
To start ACC under a Linux operating system, execute the acc10.sh shell script instead. ACC is available if you have copied and installed the aris10-acc-<number> rpm file depending on the Linux operating system.
Enter help or help <command> to get information about the usage of the commands.
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.
Example:
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 Piwik 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 piwik.site.id to the ID of the ARIS Connect website in Piwik (see saved parameters from Piwik installation), for example:
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.
In order to use the Piwik reports in ARIS report parameters are to be specified accordingly.