WebLogic Server sous Windows Server 2000 ou version ultérieure

Instructions détaillées pour l’installation et la configuration de Sensor pour WebLogic Server 6.x ou version ultérieure sous Microsoft Windows Server 2000 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.

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.

Sur votre serveur WebLogic Server, créez un répertoire dans lequel installer les fichiers du programme Sensor. 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
```
Extrayez le contenu du fichier d'installation dans le répertoire que vous venez de créer. Au cours de cette étape, Sensor installe les fichiers suivants :

Fichier	Description	Répertoire cible
Visual_sciences.dll	Module de chargement du collecteur.	Dans n’importe quel répertoire.
J2EECollector.jar	Bibliothèques du module de chargement des collecteurs	WEB-INF/lib
txlogd.exe	Le programme d'émetteur.	Dans n’importe quel répertoire
txlogd.conf	Fichier de configuration de Sensor.	Dans n’importe quel répertoire
trust_ca_cert.pem	Certificat utilisé pour valider le certificat numérique présenté par Insight Server pendant le processus de connexion	Dans n’importe quel répertoire

REMARQUE

Le package d’installation contient un fichier de feuille de calcul appelé TestExperiment.xls. Cette feuille de calcul est un outil que les architectes utilisent pour configurer une expérience contrôlée. Sensor n’utilise pas ce fichier, il n’est donc pas nécessaire d’installer le fichier sur l’ordinateur sur lequel Sensor est en cours d’exécution (bien que vous puissiez choisir de le faire). Vous souhaiterez peut-être copier le fichier vers un emplacement accessible par vos architectes ou simplement extraire le fichier du package d’installation, le cas échéant. Pour plus d'informations sur l'expérimentation contrôlée, consultez le Guide des expériences contrôlées Insight.

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

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.

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.

Dans le menu Démarrer de Windows, sélectionnez Accessoires > Invite de commandes.
Dans la fenêtre d’invite de commande, accédez au répertoire dans lequel vous avez installé Sensor 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.
Pour vérifier que l’émetteur s’exécute correctement, cliquez sur Démarrer > Panneau de configuration > Outils d’administration > Services.

REMARQUE

Cette séquence de commandes peut varier selon la version de Windows utilisée.
1. Dans la liste des services, recherchez l’entrée de Sensor 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.
Pour vérifier si l’émetteur a rencontré des erreurs au démarrage, cliquez sur Démarrer > Panneau de configuration > Outils d’administration > Observateur d’événements pour ouvrir l’Observateur d’événements.
1. Dans le volet gauche de la fenêtre Observateur 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 provenant d’Adobe, cliquez deux fois sur l’erreur pour afficher la fenêtre Propriétés de l’événement. Cette fenêtre fournit des informations détaillées sur l’erreur.
Lorsque vous avez terminé d’examiner le journal des applications, fermez l’Observateur d’événements.
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 Sensor 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 défini correctement.
2. Vérifiez que le périphérique sur lequel vous avez installé Sensor dispose d’un espace suffisant pour contenir un fichier de la taille spécifiée dans le paramètre QueueSize.
3. A l’aide du panneau de contrôle Services de Windows, arrêtez l’émetteur.
4. Supprimez le fichier de file d’attente.
5. Réinscrivez Sensor en tant que service Windows : dans le menu Démarrer de Windows, sélectionnez Accessoires > Invite de commandes. Dans la fenêtre d’invite de commande, accédez au répertoire dans lequel vous avez installé Sensor et exécutez la commande suivante :
```
txlog /regserver
```

L'émetteur est conçu pour fonctionner en continu. Si vous redémarrez l’ordinateur, 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 le web.xml fichier comme décrit ci-dessous et redémarrer votre application Web.

A l’aide d’un éditeur de texte, ouvrez le web.xml fichier pour le serveur Web dont Sensor capture les événements.

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

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.

Modification du script de démarrage

Instructions pour la modification du script de démarrage.

Dans le script utilisé pour démarrer WebLogic (par exemple, C:\bea\user_projects\mydomain\startServer.cmd), modifiez la ligne "set JAVA_OPTIONS=" pour définir la définition java.library.path sur le répertoire contenant le fichier Visual_sciences.dll.

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

Capture de données supplémentaires

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

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" %> 
```
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.
Répétez cette procédure pour chaque page .jsp à partir de laquelle vous souhaitez capturer des données supplémentaires.