Ajouter des exécutables

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

Procédure

  1. Démarrez ARIS Cloud Controller (ACC) sur votre ARIS Server.
  2. Saisissez le mot de passe de l'agent.
  3. Faites utiliser à l'ARIS Agent le référentiel distant pour le téléchargement des exécutables.
  4. 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é.

  5. 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 Aide sur l'ACC), puis exécuter la mise à jour de configuration puis ajouter et configurer la nouvelle version du runnable CDF de nouveau.

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

  7. Installez ARIS Agent sur la machine sur laquelle Matomo est installé. L'installation d'ARIS Agent est disponible sur DVD.

    Cela rend l'ACC disponible sur cette machine.

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

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

  10. Reconfigurez piwik.site.id avec l'ID du site Web ARIS Connect dans Matomo (voir paramètres enregistrés de l'installation de Matomo), par exemple :

    reconfigure eventsubscriber_m piwik.site.id=1

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

  12. Reconfigurez piwik.authentication.token et réglez le jeton d'authentification d'un utilisateur Matomo approprié avec des permissions de consultation pour le site Web ARIS Connect (voir paramètres enregistrés 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"

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