Instructions détaillées pour l'installation et la configuration de Sensor for an Apache Server 1.3.x sur RedHat Linux 7.x ou version ultérieure, SUSE Linux 9.x ou version ultérieure, Sun Solaris SPARC 2.6 ou version ultérieure, Sun Solaris x86 9 ou version ultérieure, FreeBSD 4 ou version ultérieure, ou Mac OS X PowerPC.
Les fichiers de programme de Sensor sont inclus dans un fichier d’installation que vous obtenez du site de téléchargement de l’Adobe. Si vous ne disposez pas déjà du fichier d’installation de Sensor pour votre serveur Web particulier, téléchargez-le (ou procurez-le auprès de votre représentant d’Adobe) avant de commencer les procédures suivantes.
Pour installer et configurer Sensor, vous devez effectuer les étapes de haut niveau suivantes :
Instructions d’extraction et d’installation des fichiers de programme pour Sensor sur l’ordinateur serveur.
Connectez-vous en tant qu’utilisateur root ou en tant qu’utilisateur disposant de l’autorisation root.
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
Copiez les fichiers de programme non compressés dans les répertoires identifiés dans le tableau suivant :
Fichier | Description | Cible Directory |
---|---|---|
mod_visual_sciences.so | Module de chargement du collecteur | apachePath/libexec |
txlogd |
Programme de l'émetteur | /usr/local/bin --OU-- /usr/local/sbin |
txlogd.conf | Fichier de configuration du capteur | /etc |
trust_ca_cert.pem | Certificat utilisé pour valider le certificat numérique présenté par Insight Server lors du processus de connexion | /usr/local/visual_sciences |
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 pouvez, à la place, copier le fichier vers un emplacement où vos architectes peuvent y accéder ou simplement extraire le fichier du package d'installation si nécessaire. Pour plus d’informations sur l’expérimentation contrôlée, consultez le Guide des expériences contrôlées d’Insight.
Autorisations sur les fichiers de Programme
Des autorisations incorrectes sur les fichiers de programme provoquent la plupart des problèmes rencontrés lors de l’installation de Sensor.
Assurez-vous de définir les autorisations exactement comme indiqué dans cette section.
Par défaut, les fichiers de programme du fichier tar disposent des autorisations suivantes. Selon la configuration de votre système, ces paramètres peuvent être modifiés (non masqués) lors de l’extraction des fichiers. Pour réinitialiser les autorisations aux paramètres par défaut recommandés, utilisez les commandes chmod ci-dessous. Vérifiez que les répertoires dans lesquels vous avez installé les fichiers permettent au moins ce niveau d'accès.
Fichier | Autorisations par défaut | chmod, commande |
---|---|---|
mod_visual_sciences.so | rwx r-x r-x | chmod 755 |
txlogd | rwx —x —x | chmod 711 |
txlogd.conf | rw- rw- r— | chmod 664 |
trust_ca_cert.pem | rw- rw- r— | chmod 664 |
Le txlogd.conf fichier contient les paramètres de configuration de Sensor.
Vous devez modifier le fichier pour indiquer, entre autres, la taille de la file d’attente de disque, l’adresse du serveur Insight et l’identifiant qui sera associé aux données produites par ce capteur.
Le fichier de configuration contient les paramètres requis et les paramètres facultatifs.
Pour modifier le fichier de configuration de Sensor
Instructions pour créer la file d'attente de disque après avoir configuré le fichier txlogd.conf.
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 un accès en lecture/écriture au fichier.
Sur l’ordinateur sur lequel Sensor est installé, exécutez la commande suivante pour début de l’émetteur :
/usr/local/bin/txlogd -ic -f /etc/txlogd.conf
Vérifiez que l'émetteur a créé la file d'attente de disque à l'emplacement spécifié dans le paramètre QueueFile et de la taille spécifiée dans le paramètre QueueSize.
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 :
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 fichier httpd.conf comme décrit ci-dessous et redémarrer votre serveur Web.
Si Sensor capture des données pour plusieurs serveurs Web sur l’ordinateur serveur, vous devez effectuer la procédure suivante pour chaque serveur Web.
A l’aide d’un éditeur de texte, ouvrez le httpd.conf fichier pour le serveur Web dont événement Sensor capture les données.
ajoutez les lignes suivantes à la fin du fichier :
LoadModule visual_sciences_module libexec/mod_visual_sciences.so
VisualSciencesConfig /etc/txlogd.conf
AddModule mod_visual_sciences.c
Ces lignes sont sensibles à la casse. Tapez-les exactement comme ils apparaissent ci-dessus.
Redémarrez le serveur Web. Le collecteur est chargé avec le serveur Web et commencera à collecter les données de événement et à les écrire dans la file d'attente de disque.
Début de l’émetteur et vérifiez qu’il peut se connecter au serveur Insight et lui transmettre les données du événement.
Pour vérifier que l’émetteur peut envoyer des données de événement au serveur Insight, assurez-vous que le serveur cible Insight est installé et en cours d’exécution avant de commencer le test suivant.
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
Ouvrez un navigateur (sur n’importe quel ordinateur) et demandez une page au serveur Web sur lequel Sensor s’exécute (veillez à sélectionner une page que Sensor surveille).
Une fois la requête émise, vérifiez dans la console de l’émetteur les messages indiquant qu’elle envoie des données de événement au serveur cible Insight.
Si Sensor ne transmet pas correctement les données, vérifiez que :
Cible Insight Server est en cours d’exécution.
Les ServerAddress paramètres et ServerPort sont définis correctement dans txtlogd.conf.
Si vous avez spécifié ServerAddress à l’aide d’un nom de serveur, tentez plutôt d’utiliser son adresse IP numérique. La valeur du CertName paramètre correspond exactement au nom commun qui apparaît sur le certificat numérique du serveur cible Insight.
Informations permettant de s’assurer que l’émetteur se charge automatiquement au redémarrage de l’ordinateur du serveur Web.
ajoutez la commande suivante (qui lance l'émetteur) sur votre script de démarrage du système.
/usr/local/bin/txlogd -f /etc/txlogd.conf
Cette commande début l'émetteur en tant que démon. Les messages d'exploitation et d'erreur générés par l'émetteur sont écrits sur syslog.
Certains utilisateurs Solaris peuvent rencontrer une erreur "Impossible d'acquérir mutex". Pour que Sensor fonctionne correctement sur ces systèmes, la ligne suivante doit être ajoutée ou modifiée dans le fichier /etc/system :
semsys:seminfo_semmnu=1024
Le paramètre Solaris par défaut est 60. Selon les tests effectués avec Sensor, qui utilise trois sémaphores pour chaque instance, l’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é ce qui suit dans son livre Sun Performance and Tuning (Prentice Hall, octobre 1994) : "Les bases de données ont tendance à utiliser beaucoup de paramètres de mémoire partagée et de sémaphore. Elles n'ont aucune incidence sur les performances ; tant qu'ils sont assez gros, les programmes vont courir."