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 :
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 |
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.
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.
Pour modifier le fichier de configuration de Sensor
Pour modifier le fichier de configuration de Sensor
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.
Cette séquence de commandes peut varier selon la version de Windows utilisée.
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.
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 :
Examinez le fichier txtlogd.conf et vérifiez que le paramètre QueueSize est défini correctement.
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.
A l’aide du panneau de contrôle Services de Windows, arrêtez l’émetteur.
Supprimez le fichier de file d’attente.
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.
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>
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.
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
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.