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 l'exécutable cdf à votre installation ARIS et l'exécutable eventsubscriber au serveur Matomo.

Conditions préalables

  1. Démarrez l'ACC sur votre ARIS Server.

    ACC est un outil en ligne de commande pour administrater et configurer une installation ARIS. Il communique avec les ARIS Agents sur tous les nœuds.

    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. L'ACC est disponible si vous avez copié et installé le fichier rpm aris10-acc-<nombre> dépendant du système d'exploitation Linux.

    Entrez help ou help <commande> pour obtenir des informations sur l'utilisation des commandes.

  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 exécutables 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 l'exécutable 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 l'exécutable CDF.

    Lorsque vous ajoutez l'exécutable CDF, vous ne pourrez pas mettre à jour cette installation avec une mise à jour de configuration, 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 l'exécutable 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 de l'exécutable CDF de nouveau.

  6. Activez le suivi de l'utilisation dans toutes les instances de l'exécutable abs et dans toutes les instances de l'exécutable 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 :

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

    L'exécutable 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 l'exécutable eventsubscriber.

Les exécutables 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.