L'exécutable eventsubscriber est un composant supplémentaire à déployer sur la machine sur laquelle Matomo est exécuté. Vous devez ajouter deux exécutables supplémentaires à votre installation, l'exécutable eventsubscriber lui-même et l'exécutable cdf (Cloud Decoupling Framework), qui est nécessaire pour la communication entre les composants. CDF est une queue qui peut être utilisée pour découpler des accès synchrones aux services.
Cette procédure suppose que vous ajouterez le runnable cdf à votre installation ARIS et le runnable eventsubscriber au serveur Matomo.
Conditions préalables
Vous avez une installation de serveur ARIS en cours d'exécution.
Vous avez accès à l'installation d'ARIS agent.
Vous avez des connaissances élémentaires de l'utilisation de
.ARIS Cloud Controller peut être utilisé dans plusieurs modes.
Pour démarrer ACC sous un système d'exploitation Windows, cliquez sur Démarrer > Tous les programmes > ARIS > Administration > ARIS Cloud Controller. Si vous avez changé les informations d'identification de l'utilisateur pour l'agent, vous devez saisir le nom d'utilisateur et/ou le mot de passe.
Pour lancer l'ACC sous un système d'exploitation Linux, exécutez plutôt le script shell acc10.sh. Pour ce faire, saisissez : su -c acc10.sh aris10.
Vous exécutez toujours l'ACC connecté à votre ou vos ARIS agents, en utilisant les commutateurs de ligne de commande habituels pour connecter un unique agent (-h, -u, -pwd) dans le cas d'une installation à un seul nœud, en utilisant un fichier de nœud (passé à l'ACC avec un commutateur -n) ou en émettant manuellement des commandes d'ajout de nœud dans le cas d'une installation distribuée.
Démarrez l'ACC avec le raccourci du menu Démarrer qui a été créé à l'installation. Sinon, assurez-vous de toujours passer le fichier generated.apptypes.cfg approprié à cet ACC avec le commutateur de ligne de commande -c. Il est important que le fichier generated.apptypes.cfg soit de la même version que celle de l'installation à laquelle vous souhaitez ajouter les runnables.
Assurez-vous d'ouvrir les ports spécifiques entre l'serveur ARIS et le serveur sur lequel le runnable eventsubscriber sera exécuté. Il s'agit du port client zookeeper et du ActiveMQPort du runnable cdf.
Vous avez accès aux valeurs de configuration de Matomo (ID et jeton).
Procédure
Démarrez ARIS Cloud Controller (ACC) sur votre serveur ARIS.
Saisissez le mot de passe de l'agent.
Faites utiliser à l'ARIS agent le référentiel distant pour le téléchargement des exécutables.
Si vous avez installé le serveur ARIS avec la configuration, l'ARIS agent sera configuré pour ne prendre les runnables que de son référentiel local. Pour changer ce réglage, exécutez la commande :
set local.repository.only=false
L'ARIS agent utilisera le référentiel distant indiqué.
Pour ajouter le runnable CDF, saisissez la commande :
Exemple :
configure cdf_m cdf_m
Veuillez noter que contrairement à la plupart des exécutables, le dimensionnement m ou l que vous choisissez n'importe pas pour le runnable CDF.
Lors de l'ajout du runnable CDF, vous ne pourrez pas mettre à jour cette installation avec une configuration de mise à jour, car la configuration reconnaîtra que l'installation a été modifiée. Vous pouvez mettre à jour l'installation manuellement (voir ARIS Update Cookbook) ou supprimer le runnable avec la commande annuler la configuration de l'ACC (voir ), puis exécuter la mise à jour de configuration puis ajouter et configurer la nouvelle version du runnable CDF de nouveau.
ARIS Cloud Controller peut être utilisé dans plusieurs modes.
Pour démarrer ACC sous un système d'exploitation Windows, cliquez sur Démarrer > Tous les programmes > ARIS > Administration > ARIS Cloud Controller. Si vous avez changé les informations d'identification de l'utilisateur pour l'agent, vous devez saisir le nom d'utilisateur et/ou le mot de passe.
Pour lancer l'ACC sous un système d'exploitation Linux, exécutez plutôt le script shell acc10.sh. Pour ce faire, saisissez : su -c acc10.sh aris10.
Activez le suivi de l'utilisation dans toutes les instances du runnable abs et dans toutes les instances du runnable copernicus. Saisissez, par exemple :
reconfigure abs_m JAVA-Dcom.softwareag.copernicus.tracking.enabled=true
reconfigure copernicus_m JAVA-Dcom.softwareag.copernicus.tracking.enabled=true
Installez l'ARIS agent sur la machine sur laquelle Matomo est installé. Vous pouvez télécharger la configuration d'ARIS agent à partir du Centre de téléchargement ARIS.
Cela rend l'ACC disponible sur cette machine.
Pour ajouter l'exécutable eventsubscriber sur le serveur Matomo, démarrez l'ACC et lancez la commande, par exemple :
configure eventsubscriber_m eventsubscriber_m
Reconfigurez zookeeper.connect.string pour pointer vers toutes les machines avec une instance de ZooKeeper, par exemple :
reconfigure eventsubscriber_m zookeeper.connect.string="arisapp33srv.eur.com:14281,arisapp45srv.eur.com:14281,<host>:<port>, ..."
Le runnable eventsubscriber accèdera à Matomo via http://localhost:80/. Si ce défaut n'est pas suffisant, reconfigurez piwik.server.host, piwik.server.port et piwik.server.path en conséquence, par exemple :
reconfigure eventsubscriber_m piwik.server.host="arisapp44srv.eur.com" piwik.server.port=8080 piwik.server.path="piwik"
Reconfigurez piwik.site.id avec l'ID du site Web ARIS dans Matomo (consultez les paramètres enregistrés à partir de l'installation de Matomo), par exemple :
reconfigure eventsubscriber_m piwik.site.id=1
Reconfigurez piwik.visit.tenant.dimension.id, piwik.visit.action.resource.path.dimension.id et piwik.visit.action.resource.type.dimension.id avec les ID du locataire et les dimensions personnalisées resource-path et resource-type crées dans Matomo, par exemple :
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
Reconfigurez piwik.authentication.token et réglez le jeton d'authentification d'un utilisateur Matomo approprié avec des autorisations de consultation pour le site Web ARIS (consultez les paramètres enregistrés à partir de l'installation de Matomo). Il est recommandé de masquer la valeur de la propriété avec l'opérateur de reconfiguration ?= dans l'ACC, par exemple :
reconfigure eventsubscriber_m piwik.authentication.token?="f722a764407aef36bf212c6665e53500"
Pour appliquer les changements, vous devez arrêter et redémarrer le runnable eventsubscriber.
Les runnables sont disponibles. Assurez-vous qu'ils soient exécutés.
Pour utiliser les rapports Matomo dans ARIS, vous devez spécifier les paramètres de rapport en conséquence.