Utilisation des rapports de serveur

Le serveur AnswerBook2 tient à jour des journaux consignant les erreurs de serveur et les erreurs d'accès au serveur. De plus, il fournit un rapport qui affiche la fréquence des accès aux collections et le nombre d'erreurs.

Rapport d'accès aux livres

Pour afficher un rapport des accès aux livres du serveur, sélectionnez Afficher le récapitulatif des accès aux livres dans la page Administration d'AnswerBook2. Ce rapport indique de manière sommaire la fréquence d'accès à chaque livre du serveur. Il précise les informations suivantes :

• Titre du livre : titre du livre tel qu'il s'affiche sur la page de la bibliothèque.

• Nom abrégé : nom du livre tel qu'il figure dans le fichier de configuration du livre.

• Nom de la collection : nom abrégé de la collection à laquelle le livre appartient, tel qu'il est défini dans le fichier collinfo.

• Occurrences : nombre de consultations d'un livre.

• Erreurs : nombre d'erreurs associées à un livre.

Journal des accès

Pour activer ou désactiver le journal des accès, sélectionnez Modifier la configuration du serveur dans la page Administration d'AnswerBook2.

• Pour obtenir des informations sur les accès des utilisateurs par le biais du journal des accès, cliquez sur le bouton situé en regard de Activé, puis sur Appliquer. L'emplacement par défaut de ce fichier est /var/log/ab2/logs/access-8888.log.

• Pour cesser de consigner les informations dans le journal des accès, cliquez sur le bouton en regard de Désactivé, puis sur Appliquer.

Vous pouvez également utiliser les commandes suivantes pour effectuer ces opérations :

% /usr/lib/ab2/bin/ab2admin -o access_on [-m nom_serveur] [-p port_serveur]

 

% /usr/lib/ab2/bin/ab2admin -o access_off [-m nom_serveur] [-p port_serveur]

 

Après avoir modifié la fonction de journalisation, vous devez arrêter et redémarrer le serveur de documentation. Pour cela, connectez-vous en tant que root sur la machine serveur et tapez les commandes suivantes :

# /usr/lib/ab2/bin/ab2admin -o stop

# /usr/lib/ab2/bin/ab2admin -o start

Affichage du journal des accès

Pour afficher le journal des accès, sélectionnez Afficher les journaux de consignation dans la page Administration d'AnswerBook2, puis cliquez sur Afficher le journal des accès. Le journal des accès est un fichier texte consignant tous les accès aux serveurs de documentation. Chaque ligne de ce fichier est au format suivant :

129.146.83.55 - - [04/Nov/1996:15:07:05 -0800]

"GET /icons/ab2_curr_home.gif HTTP/1.0" 200 1938

Signification de ces informations :

• La première série de numéros correspond à l'adresse IP du client. Par exemple, 129.146.83.55.

• Les informations entre crochets correspondent à la date et à l'heure de l'accès. Par exemple, [04/Nov/1996:15:07:05 -0800].

• Les informations entre guillemets indiquent le type d'accès. En général, elles correspondent à une URL ou à un nom de fichier ainsi qu'au protocole utilisé pour répondre à la requête d'accès. Par exemple, "GET /icons/ab2_curr_home.gif HTTP/1.0" indique que la connexion a été utilisée pour obtenir le fichier /icons/ab2_curr_home.gif à l'aide du protocole HTTP 1.0.

• L'avant-dernier numéro indique si l'accès a réussi (200) ou non (une quelconque autre valeur).

• Le dernier numéro indique la taille (en kilo-octets) des informations renvoyées au demandeur. Par exemple, 1938 est la taille du fichier .gif transféré.

Vous pouvez également effectuer cette opération en entrant la commande suivante :

% /usr/lib/ab2/bin/ab2admin -o view_access [-m nom_serveur] [-p port_serveur]

Journal des erreurs

Pour activer ou désactiver le journal des erreurs, sélectionnez Modifier la configuration du serveur dans la page Administration d'AnswerBook2.

• Pour obtenir des informations sur les erreurs survenues au niveau du serveur de documentation et enregistrées dans le fichier de journalisation des erreurs, cliquez sur le bouton situé en regard de Activé, puis sur Appliquer. L'emplacement par défaut pour ce fichier est /var/log/ab2/logs/errors-8888.log.

• Pour cesser de consigner les informations du journal des erreurs, cliquez sur le bouton situé en regard de Désactivé, puis sur Appliquer.

Vous pouvez également utiliser les commandes suivantes pour effectuer ces opérations :

% /usr/lib/ab2/bin/ab2admin -o error_on [-m nom_serveur] [-p port_serveur]

 

% /usr/lib/ab2/bin/ab2admin -o error_off [-m nom_serveur] [-p port_serveur]

Après avoir modifié la fonction de journalisation, vous devez arrêter et redémarrer le serveur de documentation. Pour cela, connectez-vous en tant que root sur la machine serveur et tapez les commandes suivantes :

# /usr/lib/ab2/bin/ab2admin -o stop

# /usr/lib/ab2/bin/ab2admin -o start

Consultation du journal des erreurs

Pour consulter le journal des erreurs, sélectionnez Afficher les journaux de consignation dans la page Administration d'AnswerBook2, puis cliquez sur Afficher le journal des erreurs. Ce journal contient la liste de toutes les erreurs qui se sont produites sur ce serveur de documentation. Cela permet de trouver l'origine de comportements inhabituels du serveur. Le nom et le port du serveur incriminé sont généralement précisés, avec un texte décrivant l'erreur.

Vous pouvez également effectuer cette opération en entrant la commande suivante :

% /usr/lib/ab2/bin/ab2admin -o view_error [-m nom_serveur] [-p port_serveur]

Renouvellement des journaux

Vous pouvez enregistrer le journal des accès ou le journal des erreurs en cours dans un fichier et enregistrer les informations de journalisation dans un nouveau fichier.

• Pour renouveler le journal des erreurs, sélectionnez Activer/désactiver le journal des erreurs dans la page Administration d'AnswerBook2.

• Pour renouveler le journal des accès, sélectionnez Activer/désactiver le journal des accès dans la page Administration d'AnswerBook2.

Lorsque l'écran Activer/Désactiver le journal des accès/erreurs s'affiche :

1. Entrez le nom du fichier de sauvegarde dans la zone Sauvegarder le journal.

   La valeur par défaut est date_jour.nom_fichier_journal_en_cours.log, date_jour étant au format AnnéeAnnéeAnnéeAnnée_MoisMois_JourJour_HeureHeure et la valeur par défaut de nom_fichier_journal_en_cours est access-8888.log ou error-8888.log (par exemple, 1997_02_26_14.access-8888.log).

   La zone Emplacement du journal vous indique où le fichier a été enregistré. Vous ne pouvez pas le modifier sur cette page.

2. Cliquez sur Appliquer.

Après avoir modifié la fonction de journalisation, vous devez arrêter et redémarrer le serveur de documentation. Pour cela, connectez-vous en tant que root sur la machine serveur et tapez les commandes suivantes :

# /usr/lib/ab2/bin/ab2admin -o stop

# /usr/lib/ab2/bin/ab2admin -o start

Vous pouvez également utiliser les commandes suivantes pour effectuer ces opérations :

% /usr/lib/ab2/bin/ab2admin -o rotate_error [-m nom_serveur] [-p port_serveur]

 

% /usr/lib/ab2/bin/ab2admin -o rotate_access [-m nom_serveur] [-p port_serveur]