I det här avsnittet förklaras hur du löser kända problem i AnswerBook2. Följande ämnen behandlas:
I följande tabell visas en lista över problem som kan uppstå när du hanterar onlinedokumentation.
Tabell 4-1 Serverproblem
Om du ser det här ... |
Kan du göra så här ... |
Se även ... |
||
---|---|---|---|---|
Redigera filen /usr/lib/ab2/dweb/data/config/dwhttpd.cfg och ändra värdnamnet till värdnamn.domän. I stället för t ex följande rad:
|
Om problemet kvarstår kan du försöka stänga av proxyinställningarna på webbläsaren. |
|||
Webbläsarfel som anger att dokumentationsservern inte svarar |
Om dokumentationsservern inte svarar startar du om den. |
Information om hur du stannar och startar servern finns i "Starta och stanna dokumentationsservern". |
||
404 går inte att hitta när du försöker komma åt dokumentationsservern |
En serverprocess körs men serverprogramvaran har tagits bort. Installera om serverprogramvaran. |
Information om hur du installerar programvaran finns i "Installera programvaran för AnswerBook2 ". |
||
Bibliotekssidan visar bara navigationsfältet och inga dokumentsamlingar |
Kontrollera att samlingarnas mallfil (/usr/lib/ab2/dweb/data/config/ab2_samlingar.mallfil) inte innehåller några tomma eller dubbla poster. |
Om problemet kvarstår när mallfilen är korrigerad kan du behöva installera om dokumentsamlingarna eller serverprogramvaran. Information om hur du installerar programvaran finns i "Installera programvaran för AnswerBook2 ". |
||
Röd text och ordet "BUG" visas i en bok (eller flera böcker) |
Bokens källkod innehåller delar som AnswerBook2 inte kan identifiera, och miljövariabeln AB2_DEBUG har värdet "1" på servern. |
Om du vill inaktivera felvisningen anger du värdet "0" för AB2_DEBUG och stannar och startar om servern. Kontakta den person som har tillhandahållit boken och se till att koden ändras. |
||
Det går inte att komma åt administrativa funktioner på dokumentationsservern |
I AnswerBook2-dokumentationsservern an Information om hur du lägger till eller tar bort administrativa användare för servern finns i "Kontrollera administrativ åtkomst". Om du behöver åtkomst till en annan server, kontaktar du dokumentadministratören för den servern. |
|||
Det går inte att utföra administrativa kommandon från AnswerBook2:s administrationssida (läsargränssnitt) |
Vissa funktioner fungerar inte från administrationssidan för AnswerBook2 av behörighetsskäl. Försök utföra samma funktion från det kommandoradsbaserade gränssnittet ab2admin. |
Information om kommandoradsalternativen finns i xref linkend="ab2-man-page-appendix-1">. |
||
En Sök efter installerade samlingar-funktion listar inte dokumentsamlingar som är installerade på en lokal monteringspunkt |
Kontrollera att katalogen där samlingarna är installerade har läsåtkomst för andra. |
|
||
Du har lagt till en AnswerBook1-samling, men användare ser den inte i sina bibliotek |
Det här innebär att det finns något fel i data för samlingen i filen ab_cardcatalog. Kontrollera att informationen i /var/log/ab2/catalog/ab1_cardcatalog är korrekt. |
|
||
Meddelandet Kunde inte lägga till samlingen visas när du försöker lägga till en samling genom administrationssidan i AnswerBook2 |
Kontrollera att sökvägen till filen collinfo eller ab_cardcatalog för samlingen är korrekt. |
|
||
Kommandot restart för att starta om dokumentationsservern misslyckades eller gav oväntade resultat |
Ibland fungerar inte kommandot restart som det ska. Använd kommandona stop och start i stället. |
Mer information finns i "Starta och stanna dokumentationsservern". |
||
Dokumentsamlingar verkar vara skadade och behöver installeras om |
Ta bort samlingarna från dokumentationsserverns databas med funktionen ab2admin -o del_coll eller Ta bort samlingar från listan på administrationssidan för AnswerBook2. Använd sedan pkgrm för att ta bort dem från servern innan du installerar nya paket. |
Mer information om hur du tar bort samlingar finns i "Ta bort AnswerBook2-samlingar". Mer information om hur du lägger till samlingar finns i "Lägga till nya samlingar". |
I det här avsnittet visas AnswerBook2-felmeddelanden och vad du ska göra när de visas.
Innebär: Ett försök att använda answerbook2_admin-skriptet eller starta administrationssidan för AnswerBook2 i CDE-frontpanelen misslyckades eftersom det inte finns någon dokumentationsserver i det här systemet.
Åtgärd: Du kan antingen gå till det system där dokumentationsservern finns och använda samma procedur eller skriva URL:en till den dokumentationsserver som du vill administrera i din webbläsare.
Innebär: Ett försök att använda answerbook2_admin-skriptet eller starta klientvisaren i CDE-frontpanelen misslyckades eftersom ingen standarddokumentationsserver är definierad.
Åtgärd: Klientvisaren använder följande metod för att hitta en standarddokumentationsserver:
Om du har definierat omgivningsvariabeln, AB2_DEFAULTSERVER, startas AnswerBook2-läsaren med hjälp av den URL som definieras av den variabeln. Du kan t ex ha följande rad i .cshrc-filen:
setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888/ |
Om datorn som du startade AnswerBook2-funktionen från är en dokumentserver, startas AnswerBook2-läsaren med följande URL: http://localhost:8888
Om en AnswerBook2-server är registrerad i FNS (Federated Naming Service), använder AnswerBook2-visaren den registrerade serverns URL.
Innebär: Ett försök att starta ab2cd-skriptet misslyckades eftersom en ogiltig sökväg angavs.
Åtgärd: Du måste skriva kommandot i den katalog där ab2cd-skriptet finns eller ange den fullständiga sökvägen till ab2cd-skriptet.
Innebär: Du försökte köra ab2cd-skriptet från ett system som inte stöds.
Åtgärd: Dokumentationsserverprogrammet kräver att operativmiljöerna Solaris 2.5.1, Solaris 2.6, or Solaris 7 körs på antingen ett SPARC- eller ett Intel-baserat system.
Innebär: Du försökte köra ab2cd-skriptet från ett system med ett språkområde eller en kodning som inte stöds.
Åtgärd: Dokumentationsserverprogrammet stöder följande språkområden och kodningar: C, en_*, es, es_*, fr, fr_*, it, it_*, sv, sv_*, de, de_*, ja, japanska, ja_JP.PCK, ko, zh, zh_TW, zh_TW.BIG5 och *[Uu][Tt][Ff]-8*.
Innebär: En administrativ användare skrev fel administrationslösenord.
Åtgärd: Skriv lösenordet igen. Om det misslyckas igen bör du kontrollera att du försöker administrera den server som det här administratörs-ID:t och lösenordet är giltiga för.
Innebär: Ett ab2cd-kommando användes, men rätt alternativ saknades.
Åtgärd: Kontrollera om du har angett kommandot och alternativen korrekt. Mer information om alternativen finns i ab2cd i direkthjälpen (man).