Installera och administrera en AnswerBook2-server

Kapitel 4 Problemlösning i AnswerBook2

I det här avsnittet förklaras hur du löser kända problem i AnswerBook2. Följande ämnen behandlas:

Serverfel

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 ... 

Proxy-läsarfel

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:


set ServerHost imaserver ;#
Använder du den här raden:

set ServerHost imaserver.eng.sun.com ;#
Starta sedan om dokumentationsservern.

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".

AnswerBook2-felmeddelanden

I det här avsnittet visas AnswerBook2-felmeddelanden och vad du ska göra när de visas.

Kunde inte hitta lokal AnswerBook2-server att administrera.

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.

Ingen AnswerBook2-server hittades.

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:

  1. 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/
    

  2. Om datorn som du startade AnswerBook2-funktionen från är en dokumentserver, startas AnswerBook2-läsaren med följande URL: http://localhost:8888

  3. Om en AnswerBook2-server är registrerad i FNS (Federated Naming Service), använder AnswerBook2-visaren den registrerade serverns URL.

Serverprogramvara för AnswerBook2 finns inte i sökvägen %s.

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.

Arkitekturen hanteras inte: %s.

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.

ab2cd hanterar inte %s.

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*.

Verifiering misslyckades. Försök igen.

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.

Nödvändiga alternativ saknas.

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).