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