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