Chapitre 4 Résolution des problèmes d'AnswerBook2
Cette section explique comment résoudre les problèmes connus pouvant survenir lors de l'utilisation d'AnswerBook2 ; elle contient les informations suivantes :
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... |
||
|---|---|---|---|---|
|
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 :
|
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". |
Messages d'erreur AnswerBook2
Cette section répertorie les messages d'erreur AnswerBook2 et indique comment les résoudre.
- Authentication failed, try again (L'authentification a échoué, essayez de nouveau).
-
Signification : Un utilisateur administratif a saisi un mot de passe administratif erroné.
Résolution : Retapez le mot de passe. En cas de nouvel échec, assurez-vous que vous tentez d'accéder au serveur pour lequel cet administrateur et ce mot de passe sont corrects.
- Cannot find local AnswerBook2 server to administer (Impossible de trouver le serveur local AnswerBook2 à gérer).
-
Signification : Une tentative d'utilisation du script answerbook2_admin ou de lancement de la page Administration d'AnswerBook2 à partir du tableau de bord du CDE a échoué car aucun serveur de documentation n'existe sur le système.
Résolution : Placez-vous dans le système où réside le serveur de documentation et utilisez la même procédure ou entrez l'URL du serveur de documentation que vous voulez administrer dans votre navigateur.
- Cannot talk to alternate server nom_serveur (Echec de la communication avec le serveur nom_serveur).
-
Signification : Une tentative de communication avec le serveur de remplacement spécifié a échoué, soit parce que nom ou le port du serveur n'existe pas ou parce que l'accès est bloqué vers les serveurs situés en dehors de votre société.
Résolution : Vérifiez que le nom et le port du serveur de remplacement sont corrects. Le cas échéant, vérifiez si le serveur de remplacement se trouve derrière le pare-feu de votre société. Si le serveur que vous essayez d'ajouter se trouve à l'extérieur du pare-feu de votre entreprise, les fonctions de sécurité de votre réseau risquent de vous empêcher de l'ajouter en tant que serveur de remplacement.
- No AnswerBook2 documentation server was found (Aucun serveur de documentation AnswerBook2 n'a été détecté).
-
Signification : Une tentative d'utilisation du script answerbook2 ou de lancement de l'afficheur client à partir du tableau de bord du CDE a échoué car aucun serveur de documentation n'est défini par défaut sur le système.
Résolution : L'afficheur client utilise l'approche suivante pour trouver un serveur de documentation par défaut :
-
Si la variable d'environnement AB2_DEFAULTSERVER est définie, l'afficheur AnswerBook2 se lance à l'aide de l'URL définie par cette variable. Par exemple, votre fichier .cshrc contient une ligne qui ressemble à la suivante :
setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888/
-
Si la machine à partir de laquelle vous avez initié la fonction AnswerBook2 est un serveur de documentation, l'afficheur AnswerBook2 tente d'accéder à l'URL : http://localhost:8888
-
Si un serveur AnswerBook2 est enregistré via les services FNS (Federated Naming Service), l'afficheur AnswerBook2 utilise l'URL du serveur enregistré.
-
- © 2010, Oracle Corporation and/or its affiliates