Instructions relatives à l’installation et à la configuration d’Apache Server 2.0.40, 2.0.42 ou version ultérieure, d’Apache Server 2.2 ou d’Apache Server 2.4 sous Linux, Sun Solaris ou FreeBSD.
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, vous devez effectuer les étapes de haut niveau suivantes :
Les serveurs Apache suivants sont pris en charge :
Bien que les instructions d’installation de Sensors sur les serveurs Web exécutant Apache Server versions 2.0.40, 2.0.42 ou ultérieures (32 et 64 bits) ou 2.2 soient identiques (sauf indication contraire dans les procédures suivantes), les fichiers d’installation de chaque version diffèrent. Avant d’installer Sensor, assurez-vous d’avoir reçu les fichiers d’installation appropriés pour les versions du serveur Apache et du système d’exploitation en cours d’exécution.
Procédure d'extraction et d'installation des fichiers programme pour Sensor.
Connectez-vous en tant qu’utilisateur root ou en tant qu’utilisateur disposant de l’autorité racine.
Décompressez et décompressez le fichier d’installation à l’aide de la commande suivante :
Sous Linux :
tar -zxf installationFilename
unzip -d installationFilename.tar.gz
tar -xf installationFilename.tar
Sous Solaris :
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 |
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.
Autorisations sur les fichiers du programme
Des autorisations incorrectes sur les fichiers programme provoquent la plupart des problèmes rencontrés lors de l’installation de Sensor. Veillez à définir les autorisations exactement comme indiqué dans cette section.
Par défaut, les fichiers programme du fichier tar possèdent les 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 sur les 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 775 |
txlogd | rwx —x —x | chmod 711 |
txlogd.conf | rw- r— r— | chmod 664 |
trust_ca_cert.pem | rw- r— r— | chmod 664 |
Cette section décrit la procédure à suivre pour vous connecter au même serveur.
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.
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.
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
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.
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.
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 IBM HTTP, 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 fichier httpd.conf pour le serveur Web dont Sensor capture les événements.
Ajoutez les deux lignes suivantes à la fin du fichier :
LoadModule visual_sciences_module modules/mod_visual_sciences.so
VisualSciencesConfig /etc/txlogd.conf
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.
Vérifiez que le collecteur collecte les données d’événement et que l’émetteur les transmet au serveur Insight cible.
Pour vérifier que l’émetteur peut envoyer des données d’événement au serveur Insight, assurez-vous que le serveur Insight cible 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 est en cours d’exécution (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 d’événement au serveur Target Insight.
Si Sensor ne transmet pas correctement les données, vérifiez que :
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 sur syslog.