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 Möjliga 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 hostname.domain.

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_collections.template) 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 används metoder för åtkomstkontroll för att definiera vilka användare som kan använda administrationsfunktioner. Administrationsverktygen i AnswerBook2 gör att dokumentadministratören för serverdatorn kan lägga till och ta bort administrativa användare för servern och ändra deras lösenord. 

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

Funktionen Sök efter installerade samlingar 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. 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.

Verifiering misslyckades. Försök igen.

Vad det betyder: En administrativ användare skrev fel administrationslösenord.

Så här löser du det: 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.

Ingen AnswerBook2-server hittades.

Vad det betyder: Ett försök att använda answerbook2_admin-skriptet eller starta administrationssidan för AnswerBook2 från CDE-frontpanelen misslyckades eftersom ingen standarddokumentationsserver är definierad.

Så här löser du det: Gå till det system där dokumentationsservern finns och använd samma procedur eller skriv in URL:en för den dokumentationsserver du vill administrera med din webbläsare.

Det går inte att kommunicera med den alternativa servern servernamn.

Vad det betyder: Ett försök att kontakta den angivna alternativa servern misslyckades på grund av att serverns namn eller port inte finns, eller för att åtkomst till en server utanför företagets nätverk inte tillåts.

Så här löser du det: Kontrollera att den alternativa serverns namn och port är korrekta. Om de är korrekta, kontrollerar du att den alternativa servern finns innanför företagets brandvägg. Om den alternativa servern som du försöker lägga till finns utanför företagets brandvägg, kanske du inte får lägga till den som en alternativ server av säkerhetsskäl.

Ingen AnswerBook2-server hittades.

Vad det betyder: Ett försök att använda answerbook2 skriptet eller starta klientvisaren i CDE-frontpanelen misslyckades eftersom ingen standarddokumentationsserver är definierad.

Så här löser du det: Klientvisaren använder följande metod för att hitta en standarddokumentationsserver:

  1. Om miljövariabeln AB2_DEFAULTSERVER är definierad startas AnswerBook2-läsaren med 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 dokumentationsserver, försöker AnswerBook2-läsaren visa 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.