Installera och administrera en AnswerBook2-server

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