Serveurs JBoss, Tomcat et WebLogic sous RedHat Linux ou Sun Solaris

Instructions détaillées pour l’installation et la configuration des implémentations de Sensor pour J2EE s’exécutant sur RedHat Linux 7.x ou version ultérieure, Sun Solaris SPARC 2.6 ou version ultérieure ou Sun Solaris x86 9 ou version ultérieure.

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

Les implémentations J2EE prises en charge sont les suivantes :

• JBoss Server 3.2.x ou version ultérieure
• Apache Jakarta Tomcat Server 4.1 ou version ultérieure
• WebLogic Server 6.x ou version ultérieure

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

Installation des fichiers du programme

Procédure d'extraction et d'installation des fichiers programme pour Sensor.

1. Connectez-vous en tant qu’utilisateur root ou en tant qu’utilisateur disposant de l’autorité racine.

2. Décompressez et décompressez le fichier d’installation à l’aide de la commande suivante :

   • Sous Linux :

     tar -zxf installationFilename.tar.gz
     

   • Sous Solaris :

     unzip -d installationFilename.tar.gz 
      tar -xf installationFilename.tar
     

3. Copiez les fichiers de programme décompressés dans les répertoires identifiés dans le tableau suivant :

Fichier	Description	Répertoire cible
mod_Visual_sciences.so	Module de chargement du collecteur.	IBMHttpServer/modules
txlogd	Le programme d'émetteur.	/usr/local/bin --OU-- /usr/local/sbin
txlogd.conf	Fichier de configuration de Sensor.	/etc
trust_ca_cert.pem	Certificat utilisé pour valider le certificat numérique présenté par Insight Server pendant le processus de connexion	/usr/local/Visual_sciences

Autorisations sur les fichiers du programme

Fichier	Autorisations par défaut	chmod, commande
mod_Visual_sciences.so	rwx r-x r-x	chmod 775
txlogd	rwx —x —x	chmod 711
txlogd.conf	rw- r— r—	chmod 664
trust_ca_cert.pem	rw- r— r—	chmod 664

Modification du fichier de configuration du capteur

Le txlogd.conf fichier contient les paramètres de configuration de Sensor.

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

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

• Les paramètres requis sont des paramètres que vous devez spécifier lorsque vous installez Sensor. Sans ces paramètres, Sensor ne fonctionne pas correctement.
• Les paramètres facultatifs sont des paramètres qui, par défaut, utilisent des valeurs prédéfinies (que vous pouvez modifier) ou activent des fonctionnalités facultatives.

Pour modifier le fichier de configuration de Sensor

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

Pour modifier le fichier de configuration de Sensor

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

Démarrage de l'émetteur et création de la file d'attente du disque

Après avoir configuré le fichier txlogd.conf, vous pouvez démarrer le programme d’émetteurs, l’enregistrer en tant que service Windows et créer la file d’attente des disques.

1. Si le répertoire dans lequel se trouve la file d'attente de disque n'existe pas déjà, créez-le. Assurez-vous que le répertoire fournit à la fois le module collecteur et le programme émetteur l'accès en lecture/écriture au fichier.

   Pour plus d’informations sur les autorisations requises par les fichiers de file d’attente de disque, voir Autorisations de fichier Sensor UNIX.

2. Sur l’ordinateur sur lequel Sensor est installé, exécutez la commande suivante pour démarrer l’émetteur :

   /usr/local/bin/txlogd -ic -f /etc/txlogd.conf
   

   • L’option "i" de cette commande démarre l’émetteur en "mode interactif". Ce mode affiche les messages d’émetteur à l’écran et vous permet également d’interagir avec l’émetteur à l’aide des commandes du clavier.
   • L’option "c" indique à l’émetteur de créer la file d’attente du disque.
   • L’option "f" spécifie l’emplacement du fichier de configuration.

   Pour plus d’informations sur les options que vous pouvez utiliser au démarrage de l’émetteur, voir Options de ligne de commande de l’émetteur de capteur.

3. Vérifiez que l’émetteur a créé la file d’attente du disque à l’emplacement spécifié dans le paramètre QueueFile et à la taille spécifiée dans le paramètre QueueSize.

4. Si la file d’attente n’a pas été créée correctement, tapez Ctrl+C pour arrêter l’émetteur, puis procédez comme suit :

   1. Examinez le fichier txtlogd.conf et vérifiez que les paramètres QueueFile et QueueSize sont définis correctement.
   2. Vérifiez que le périphérique auquel la file d'attente de disque est affectée est opérationnel et dispose de suffisamment d'espace disponible pour stocker un fichier de la taille spécifiée dans le paramètre QueueSize.
   3. Effectuez les corrections nécessaires et répétez cette procédure.

Ajout du collecteur au serveur Web

Pour les serveurs Apache, le collecteur est un objet partagé dynamique que vous chargez dans le processus de votre serveur Web.

Pour ajouter le collecteur à votre serveur Web, vous devez modifier le httpd.conf fichier comme décrit ci-dessous et redémarrer votre serveur Web.

1. A l’aide d’un éditeur de texte, ouvrez le httpd.conffichier pour le serveur Web dont Sensor capture les événements.

2. Ajoutez les éléments suivants <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 l’ <param-value> élément :

   <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>/etc/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. Tapez-les exactement comme ils apparaissent ci-dessus.

3. Redémarrez le processus du serveur Web (vous n'avez pas à redémarrer l'ordinateur du serveur entier, il vous 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.

Test du capteur

Vérifiez que le collecteur collecte les données d’événement et que l’émetteur les transmet au serveur Insight cible.

1. Si l’émetteur n’est pas en cours d’exécution, redémarrez-le à l’aide de la commande suivante :

   /usr/local/bin/txlogd -i -f /etc/txlogd.conf 
   

2. Ouvrez un navigateur (sur n’importe quel ordinateur) et demandez une page au serveur Web sur lequel Sensor est en cours d’exécution (veillez à sélectionner une page que Sensor surveille).

3. Une fois la requête émise, vérifiez dans la console de l’émetteur les messages indiquant qu’elle envoie des données d’événement au serveur Target Insight.

4. Si Sensor ne transmet pas correctement les données, vérifiez que :

   • Le serveur Insight cible est en cours d’exécution.
   • Les paramètres ServerAddress et ServerPort sont définis correctement dans txtlogd.conf. Si vous avez spécifié ServerAddress à l’aide d’un nom de serveur, essayez plutôt d’utiliser son adresse IP numérique.
   • La valeur du paramètre CertName correspond exactement au nom commun qui apparaît sur le certificat numérique du serveur Target Insight.

Ajout de l’émetteur au script de démarrage du système

Informations sur le chargement automatique de l’émetteur dans le script de démarrage du système.

Pour vous assurer que l’émetteur se charge automatiquement au redémarrage de l’ordinateur du serveur Web, ajoutez la commande suivante (qui lance l’émetteur) au script de démarrage du système :

/usr/local/bin/txlogd -f /etc/txlogd.conf

Cette commande démarre l'émetteur en tant que démon. Les messages d’exploitation et d’erreur générés par l’émetteur sont écrits syslog.

Le paramètre Solaris par défaut est 60. Selon les tests effectués avec Sensor, qui utilise trois sémaphores pour chaque instance, Adobe vous recommande d’utiliser 1024 comme paramètre. Ce nombre est suffisamment élevé pour que Sensor fonctionne avec toute autre application sur le serveur qui peut nécessiter des sémaphores, mais n’affecte pas les performances. Pour appuyer cette recommandation, veuillez noter que Adrian Cockcroft a déclaré dans son livre Sun Performance and Tuning (Prentice Hall, octobre 1994) ce qui suit : "Les bases de données ont tendance à utiliser beaucoup de paramètres de mémoire partagée et de sémaphore. Elles n'affectent pas les performances; tant qu'ils sont assez gros, les programmes fonctionneront."

Capture de données supplémentaires

Les capteurs de toutes les plateformes peuvent collecter toutes les données disponibles dans les en-têtes de requête et de réponse HTTP.

Les capteurs de la plateforme J2EE fournissent un mécanisme de collecte de données qui n’est pas disponible sur d’autres plateformes. Le collecteur de la plate-forme J2EE (collecteur J2EE) se trouve sur la couche de l’application, ce qui lui permet de collecter des données sensibles qui sont disponibles uniquement pour l’application et ne doivent pas être exposées par le balisage de page ou dans les en-têtes.

Par exemple, le collecteur J2EE peut être utilisé pour capturer les données de coût par clic (CPC) pour les liens affichés sur une page, les informations de partenaire sensibles sur une page et de nombreux autres points de données. L’environnement J2EE vous permet de modifier facilement votre WEBAPP pour capturer ces données personnalisées à l’aide de notre classe de collecteurs.

Lorsqu’un capteur pour la plateforme J2EE reçoit une requête, il appelle une classe de collecteur qui importe la fonction appendToLog. La fonction appendToLog ajoute à la requête initiale les paramètres de chaîne de requête spécifiés dans la fonction appendToLog. Ceci génère l’URI de la requête initiale contenant des paires nom-valeur de chaîne de requête supplémentaires qui correspondent aux noms et aux valeurs des données capturées. Par exemple, CPC=20 est ajouté à la requête initiale lorsque la valeur d’un emplacement ou d’un lien de clic publicitaire spécifique est de 20 cents. Insight Server traite ces valeurs dans le jeu de données pour analyse. Cette méthodologie de collecte offre un autre avantage : elle permet la collecte de données supplémentaires sans créer d’entrées de journal supplémentaires, comme cela peut être le cas avec les méthodologies de balisage de page.

Pour plus d’informations sur le traitement, voir le Guide de configuration des jeux de données.

Pour capturer des données supplémentaires à partir d’une page

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 demande qui en résulte 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.