Serveur Tomcat sous Windows Server 2000 ou ultérieur

Instructions détaillées sur l’installation et la configuration de Capteur pour Apache Jakarta Tomcat 4.1 ou version ultérieure s’exécutant sous Windows Server 2000 ou version ultérieure.

Les fichiers de programme pour Capteur sont contenus dans un fichier d’installation que vous obtenez sur le site de téléchargement de l’Adobe. Si vous ne disposez pas déjà du fichier d’installation de Capteur pour votre serveur web en particulier, téléchargez-le (ou procurez-le auprès de votre représentant d’Adobe) avant de commencer les procédures suivantes.

Les mises en oeuvre J2EE prises en charge sont les suivantes :

• JBoss Server 4.0.5 ou version ultérieure s’exécutant sur Microsoft Windows Server 2000 ou version ultérieure.

Pour installer et configurer Capteur, procédez comme suit :

Installation des fichiers de programme

Procédure d’extraction et d’installation des fichiers de programme pour Capteur.

1. Sur votre serveur Tomcat, créez un répertoire dans lequel installer les fichiers du programme Capteur. Gardez à l’esprit que votre file d’attente de disque se trouve dans ce répertoire. Assurez-vous donc que le périphérique choisi dispose de suffisamment d’espace pour contenir une file d’attente de la taille dont vous avez besoin.

   C:\VisualSensor
   

2. Extrayez le contenu du fichier d'installation dans le répertoire que vous venez de créer. Au cours de cette étape, Capteur installe les fichiers suivants :

Modification du fichier de configuration du capteur

Le txlogd.conf contient les paramètres de configuration de Capteur.

Vous devez modifier ce fichier pour indiquer, entre autres, la taille et l’emplacement du fichier de file d’attente du disque, l’adresse du serveur Insight et l’identifiant qui sera joint aux données d’événement générées par ce capteur.

Le fichier de configuration contient les paramètres requis et les paramètres facultatifs.

• Paramètres requis sont des paramètres que vous devez spécifier lors de l’installation de Capteur. Sans ces paramètres, Capteur ne s’exécute pas correctement.
• Paramètres facultatifs sont des paramètres qui activent par défaut des valeurs prédéfinies (que vous pouvez modifier) ou des fonctionnalités facultatives.

Modification du fichier de configuration du capteur

• Ouvrez le /etc/txlogd.conf dans un éditeur de texte et définissez les paramètres requis ainsi que les paramètres facultatifs souhaités.
• Enregistrez le fichier, puis fermez-le.

Modification du fichier de configuration du capteur

1. Ouvrez le /etc/txlogd.conf dans un éditeur de texte et définissez les paramètres requis ainsi que les paramètres facultatifs souhaités.
2. Enregistrez le fichier, puis fermez-le.

Démarrez l’émetteur et créez la file d’attente du disque

Après avoir configuré le fichier txlogd.conf, vous pouvez démarrer le programme d'émetteur, l'enregistrer en tant que service Windows et créer la file d'attente du disque.

1. Dans le menu Démarrer de Windows, sélectionnez Accessoires > Invite de commande.

2. Dans la fenêtre de l’invite de commande, accédez au répertoire dans lequel vous avez installé Capteur et exécutez la commande suivante :

   txlog /regserver
   

   Cette commande démarre l’émetteur, crée la file d’attente du disque et enregistre Sensor en tant que service Windows.

3. Pour vérifier que l'émetteur s'exécute correctement, cliquez sur Démarrer > Panneau de Contrôle > Outils d'administration > Services.

   REMARQUE

   Cette séquence de commandes peut varier en fonction de la version de Windows utilisée.

   1. Dans la liste des services, recherchez l’entrée de Capteur et vérifiez que son état est Démarré et que son type de démarrage est Automatique.
   2. Fermez le panneau de configuration Services .

4. Pour vérifier si l'émetteur a rencontré des erreurs au démarrage, cliquez sur Démarrer > Panneau de Contrôle > Outils d'administration > Visionneuse d'événements pour ouvrir la visionneuse d'événements.

   1. Dans le volet gauche de la fenêtre Visionneuse d’événements , sélectionnez le Journal des applications .
   2. Dans le volet de droite, recherchez les événements avec "Adobe" dans la colonne Source .
   3. Si vous trouvez une erreur dans "Adobe", double-cliquez sur l’erreur pour afficher la fenêtre Event Properties (Propriétés de l’événement). Cette fenêtre fournit des informations détaillées sur l’erreur.

5. Lorsque vous avez terminé d’examiner le journal des applications, fermez la visionneuse d’événements.

6. Vérifiez que l'émetteur a créé la file d'attente du disque (Diskq2000.log) dans le répertoire où vous avez installé les fichiers du programme Capteur et que c'est la taille que vous avez spécifiée dans le paramètre QueueSize du fichier txlogd.conf.

   Si la file d’attente n’a pas été créée correctement :

   1. Examinez le fichier txtlogd.conf et vérifiez que le paramètre QueueSize est correctement défini.

   2. Vérifiez que le périphérique sur lequel vous avez installé Capteur dispose de suffisamment d’espace disponible pour contenir un fichier de la taille spécifiée dans le paramètre QueueSize .

   3. À l’aide du panneau de configuration Services sous Windows, arrêtez l’émetteur.

   4. Supprimez le fichier de file d’attente.

   5. Réenregistrer Capteur en tant que service Windows : dans le menu Démarrer de Windows, sélectionnez Accessoires > Invite de commande. Dans la fenêtre de l’invite de commande, accédez au répertoire dans lequel vous avez installé Capteur et exécutez la commande suivante :

      txlog /regserver
      

L'émetteur est conçu pour fonctionner en continu. Si vous redémarrez la machine, l'émetteur redémarre automatiquement. Si vous devez démarrer et arrêter l'émetteur manuellement, vous pouvez le faire à l'aide du panneau de configuration Services de Windows.

Ajout du collecteur au serveur web

Pour les serveurs JBoss, le collecteur fonctionne comme un filtre dans le conteneur de servlets.

Pour ajouter le collecteur à votre serveur web, vous devez modifier la variable web.xml comme décrit ci-dessous et redémarrez votre application web.

1. À l’aide d’un éditeur de texte, ouvrez le web.xml pour le serveur web dont le Capteur d’événements capture les événements.

2. Ajoutez ce qui suit : <filter> et <filter-mapping> au fichier descripteur. Si vous n’avez pas installé txlogd.conf dans le répertoire /etc, vous devez saisir le chemin d’accès correct à ce fichier dans la variable <param-value> element:

   <filter>
     <filter-name>VSCollectorFilter</filter-name>
     <description></description>
     <filter-class>
         com.visualsciences.collector.VSCollectorFilter
       </filter-class>
     <init-param>
       <param-name>configPath</param-name>
       <param-value>C:/VisualSensor/txlogd.conf</param-value>
     <description></description>
     </init-param>
   </filter>
   
   <filter-mapping>
     <filter-name>VSCollectorFilter</filter-name>
     <url-pattern>/*</url-pattern>
   </filter-mapping>
   

   REMARQUE

   Ces lignes sont sensibles à la casse. Saisissez-les exactement comme ils apparaissent ci-dessus.

3. Redémarrez le processus du serveur web (il n’est pas nécessaire de redémarrer l’ensemble de l’ordinateur serveur, il suffit de redémarrer le processus du serveur web). Le collecteur est chargé avec le serveur web et commence à collecter les données d’événement et à les écrire dans la file d’attente du disque.

Modification du chemin d’accès à la bibliothèque Java

Instructions pour l’ajout du fichier Visual_sciences.dll au chemin d’accès de la bibliothèque Java Tomcat.

1. Sur votre serveur Windows, accédez au répertoire d’installation de Tomcat. (Tomcat > bin)

2. Sous le dossier bin, exécutez Tomcat9w.exe (gestionnaire de service de démon commun).

   Dans l’onglet Java , sous Options Java, ajoutez une nouvelle ligne :

   -Djava.library.path=C:\Sensor directory
   

   Où C:\Sensor est le répertoire contenant le visual_sciences.dll fichier .

Capture de données supplémentaires

Vous pouvez capturer des données de mesure supplémentaires à partir d’applications web J2EE à l’aide de la fonctionnalité appendToLog() .

1. Ajoutez le code suivant en haut de la page .jsp à partir de laquelle vous souhaitez capturer des données :

   <%@ page import="com.visualsciences.collector.VSCollector" %>
   

2. Utilisez la méthode appendToLog() de l’objet collecteur pour ajouter les paires nom-valeur souhaitées à la chaîne de requête de la page .jsp demandée. L’exemple suivant ajoute "A=1" et "B=2" à la chaîne de requête de la page .jsp demandée pour la page /index.jsp :

   <html>
   <body>
     <h1>Hello World</h1>
     <%
       VSCollector collector = new VSCollector(request, response);
       collector.appendToLog("A", "1");
       collector.appendToLog("B", "2");
     %>
   </body>
   </html>
   

   L’URI de requête obtenu est /index.jsp?A=1&B=2.

3. Répétez cette procédure pour chaque page .jsp à partir de laquelle vous souhaitez capturer des données supplémentaires.

Ressources Business.Adobe.com

Audio Analytics Customer Journey Analytics Tag Management Audience Targeting Mobile Marketing Data Warehouse