Installation et administration d'un serveur AnswerBook2

Erreurs de serveur

Le tableau suivant répertorie les problèmes que vous pouvez rencontrer lorsque vous voulez consulter la documentation en ligne.

Tableau 4-1 Problèmes de serveur possibles

En cas de...... 

Vous pouvez... 

Voir aussi... 

Erreur de proxy du navigateur

Editez le fichier /usr/lib/ab2/dweb/data/config/dwhttpd.cfg et changez le nom de machine en nommachine.domaine.

Par exemple, au lieu de la ligne suivante :


set ServerHost imaserver ;#
Utilisez la ligne :

set ServerHost imaserver.eng.sun.com ;#
Puis, redémarrez le serveur de documentation.

Si le problème persiste, essayez de désactiver les proxies sur le navigateur Web. 

Erreurs de navigateur indiquant que le serveur de documentation ne répond pas

Si le serveur de documentation ne répond pas, redémarrez-le. 

Pour plus d'informations sur l'arrêt et le démarrage du serveur, reportez-vous à la section "Démarrage et arrêt d'un serveur de documentation".

404 Not Found lors d'une tentative d'accès au serveur de documentation

Un processus serveur est en cours d'exécution bien que le logiciel serveur ait été supprimé. Réinstallez le logiciel serveur.

Pour plus d'informations sur l'installation du logiciel, reportez-vous à la section "Installation du logiciel AnswerBook2".

La page de bibliothèque affiche uniquement la barre de navigation mais aucune collection de documents.

Vérifiez que le fichier modèle des collections (/usr/lib/ab2/dweb/data/config/ab2_collections.template) ne contient aucune entrée vide ou en double.

Si la correction du fichier modèle ne résoud pas le problème, il est possible que vous deviez réinstaller les collections de documents ou le serveur de documentation. Pour plus d'informations sur l'installation du logiciel, reportez-vous à la section "Installation du logiciel AnswerBook2".

Apparition de texte en rouge et du mot "BUG" dans un livre (ou dans plusieurs livres) 

La source du livre contient des balises qu'AnswerBook2 ne reconnaît pas et la variable d'environnement AB2_DEBUG est définie à la valeur "1" sur le serveur. 

Pour désactiver l'affichage des bogues, attribuez la valeur "0" à la variable d'environnement AB2_DEBUG, puis arrêtez le serveur et relancez-le. 

Pour résoudre le problème de balises erronées, prenez contact avec la personne qui vous a fourni le livre.  

Impossible d'accéder aux fonctions administratives sur le serveur de documentation

Le serveur de documents AnswerBook2 utilise des mécanismes de contrôle d'accès pour identifier les utilisateurs pouvant exécuter des fonctions d'administration. Les outils d'administration AnswerBook2 permettent à l'administrateur des documents de la machine serveur d'ajouter ou de supprimer des utilisateurs administratifs sur le serveur ainsi que de modifier leurs mots de passe. 

Pour ajouter ou de supprimer des utilisateurs administratifs sur le serveur, reportez-vous à la section "Gestion des accès administrateur". Si vous avez besoin d'accéder à un autre serveur, contactez l'administrateur de documents de ce serveur.

Impossible d'exécuter les commandes d'administration à partir de la page Administration AnswerBook2 (interface navigateur)

Certaines fonctions ne peuvent pas être utilisées à partir de la page Administration d'AnswerBook2 en raison de problèmes de droits. Essayez d'utiliser la même fonction à partir de l'interface de ligne de commande ab2admin.

Pour plus d'informations sur les options de la ligne de commande, reportez-vous à l'Annexe A.

La fonction Scanner les collections installées localement ne répertorie pas les collections de documents installées sur un point de montage local. 

Vérifiez que le répertoire dans lequel sont installées les collections est accessible en lecture par les autres utilisateurs.

 

Vous avez ajouté une collection AnswerBook1 mais les utilisateurs ne la voient pas dans leurs bibliothèques. 

Cela signifie que les données des collections présentent un problème. Vérifiez le fichier de collections ab_cardcatalog. Vérifiez que les informations figurant dans /var/log/ab2/catalog/ab1_cardcatalog sont correctes.

 

Le message L'ajout de la collection a échoué s'affiche lorsque vous tentez d'ajouter une collection via la page Administration d'AnswerBook2.

Vérifiez que le chemin d'accès au fichier des collections collinfo ou ab_cardcatalog est correct.

 

L'utilisation de la commande restart pour relancer le serveur de documentation a échoué ou n'a pas produit les résultats voulus.

Dans certains cas, la commande restart ne fonctionne pas correctement. Utilisez les commandes stop et start à la place.

Pour plus d'informations, reportez-vous à la section "Démarrage et arrêt d'un serveur de documentation".

Les collections de documents semblent endommagées et doivent être réinstallées. 

Utilisez la fonction ab2admin -o del_coll ou Supprimer une collection de la liste dans la page d'administration d'AnswerBook2 pour supprimer ces collections de la base de données du serveur de documentation.

Puis, utilisez pkgrm pour les supprimer du serveur avant d'installer les nouveaux modules.

Pour plus d'informations sur la suppression de collections, reportez-vous à la section "Suppression de collections AnswerBook2". Pour plus d'informations sur l'ajout de collections, reportez-vous à la section "Ajout de nouvelles collections".