Kapitel 3 Administrera en AnswerBook2-server

Administration av AnswerBook2-programvara innebär att följande funktioner utförs, där var och en av funktionerna innehåller specifika uppgifter:

• "Administrera dokumentationsservern"

• "Starta och stanna dokumentationsservern"

• "Aktivera och inaktivera felsökning för dokumentkällor"

• "Kontrollera administrativ åtkomst"

• "Arbeta med dokumentsamlingar"

• "Visa dokumentationsserverkonfiguration"

• "Arbeta med andra dokumentationsservrar"

• "Arbeta med serverrapporter"

• "Navigeringsfunktioner på administrationssidorna"

Administrera dokumentationsservern

AnswerBook2-programvaran innehåller ett webbläsargränssnitt (administrationssidan för AnswerBook2) och ett kommandoradsbaserat gränssnitt (ab2admin) som du använder när du administrerar dokumentationsservern. De flesta funktioner är tillgängliga i båda gränssnitten.

Du öppnar huvudadministrationssidan för AnswerBook2 genom att välja AnswerBook2 Administration på sidan Alternativ i AnswerBook2-webbläsaren, eller genom att ange URL-adressen: http://server:port/ab2/@Ab2Admin där server är namnet på din server och port är namnet på den port som används av servern. Administrationssidan har funktioner för att kunna navigera mellan sidor längst upp i fönstret.

Om du vill komma åt det kommandoradsbaserade gränssnittet använder du kommandot /usr/lib/ab2/bin/ab2admin. Mer detaljerad information om det kommandoradsbaserade gränssnittet finns i avsnittet Bilaga A.

Endast behöriga administratörer får använda de administrativa funktionerna. Mer information finns i avsnittet "Kontrollera administrativ åtkomst".

Starta och stanna dokumentationsservern

När du startar systemet där dokumentationsservern körs kan servern startas automatiskt (med skriptet /etc/init.d/ab2mgr). Du kan också starta, stanna och starta om dokumentationsservern manuellt när det behövs. Du måste t ex starta om dokumentationsservern när du har installerat en ny dokumentserie.

Om du vill utföra dessa funktioner loggar du in som root på dokumentationsserverns dator och använder det kommandoradsbaserade gränssnittet ab2admin.

• Använd följande kommando för att starta dokumentationsservern:

  # /usr/lib/ab2/bin/ab2admin -o start

• Använd följande kommando för att stanna dokumentationsservern:

  # /usr/lib/ab2/bin/ab2admin -o stop

• Använd följande kommando för att starta om dokumentationsservern:

  # /usr/lib/ab2/bin/ab2admin -o restart

  Om det inte hjälper att starta om servern kan du stanna och starta om den.

• Om du vill starta dokumentationsservern med felsökning aktiverat använder du följande form av startkommandot:

  # /usr/lib/ab2/bin/ab2admin -o start -D

• Använd följande kommando för att hindra servern från att startas automatiskt när systemet startas om:

  # /usr/lib/ab2/bin/ab2admin -o autostart_no

Aktivera och inaktivera felsökning för dokumentkällor

I AnswerBook2-servern finns en felsökningsfunktion som visar delar i bokens källkod som inte kan identifieras i rött med ordet "BUG" i webbläsaren. Tack vare den här funktionen kan du hitta problemet som gör att en bok inte visas som den ska.

Om du vill aktivera felsökning loggar du in som root på dokumentationsservern och anger värdet 1 för miljövariabeln AB2_DEBUG. Exempel:

% su -
# setenv AB2_DEBUG 1

Om du vill inaktivera felsökning loggar du in som root på dokumentationsservern och anger värdet 0 för miljövariabeln AB2_DEBUG. Exempel:

% su -
# setenv AB2_DEBUG 0

När du har ändrat felsökningsparametern måste du starta om dokumentservern. Skriv följande för att starta om dokumentationsservern:

# /usr/lib/ab2/bin/ab2admin -o restart

Om du vill styra felsökningen när du startar servern använder du följande form av startkommandot:

# /usr/lib/ab2/bin/ab2admin -o start -D

Kontrollera administrativ åtkomst

En administrativ användare är en användare som är definierad för att utföra dokumentadministrativa funktioner. AnswerBook2 använder lösenord för att verifiera att en viss administratör är behörig att utföra administrativa funktioner på servern.

Ställa in preliminär administrativ åtkomst

AnswerBook2-programvaran innehåller åtkomstkontroll som är aktiverad för administrativa funktioner, men ingen administrativ standardanvändare är definierad. Första gången du försöker komma åt de administrativa funktionerna i AnswerBook2 visas ett meddelande om att åtkomstkontroll är aktiverad men att ingen användare är definierad. Du kan nu göra något av följande:

• Stänga av åtkomstkontroll.

  Om du vill stänga av åtkomstkontroll loggar du in som root på dokumentationsservern och skriver följande:

  # /usr/lib/ab2/bin/ab2admin -o auth_off

  ---

  Varning!

  Om du stänger av åtkomstkontroll kan alla användare som kommer åt dokumentationsservern administrera dokumentationsservern.

  ---

• Definiera en administrativ användare och lösenord.

  Om du vill definiera en administrativ användare loggar du in som root på dokumentationsservern och skriver följande:

  # /usr/lib/ab2/bin/ab2admin -o add_admin -u admin-id

  där admin-id är inloggnings-ID:t för dokumentationsserverns administratör. ID:t admin-id behöver inte vara detsamma som användarens systeminloggnings-ID. Det är bara ett ID för dokumentrelaterade administrativa funktioner på en specifik server.

  Du uppmanas att skriva lösenordet och att därefter verifiera det genom att skriva det igen.

Lägga till åtkomst för AnswerBook2-administratörer

Om du vill lägga till en administrativ användare klickar du på Lägg till administratör på administrationssidan för AnswerBook2. Så här lägger du till en administrativ användare:

1. Skriv administratörens inloggnings-ID i fältet Administratörs-ID.

   Administratörs-ID:t behöver inte vara detsamma som användarens systeminloggnings-ID. Det är bara ett ID för dokumentrelaterade administrativa funktioner på en specifik server.

2. Skriv ett lösenord för administratören.

   Det här lösenordet lagras i en AnswerBook2-lösenordsdatabas. Det behöver inte vara samma som användarens systemlösenord.

Du måste skriva lösenordet två gånger för att verifiera det.

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o add_admin -u admin-id [-m servernamn] [-p serverport]

Ändra lösenord för en administratör

Om du vill ändra en administratörs lösenord klickar du på Ändra lösenord på administrationssidan för AnswerBook2. Så här ändrar du lösenordet:

1. Markera administratören i snabblistan Administratörs-ID.

2. Skriv administratörens befintliga lösenord i fältet Gammalt lösenord.

3. Skriv administratörens nya lösenord i fältet Nytt lösenord.

4. Skriv administratörens nya lösenord en gång till i fältet Skriv nytt lösenord igen.

5. Klicka på Ändra lösenord när du vill använda ändringen.

När du klickar på Ändra lösenord kontrollerar AnswerBook2 att data som skrevs i fälten Nytt lösenord och Skriv nytt lösenord igen stämmer överens. Om de stämmer lagras det nya lösenordet i databasen. Om de inte stämmer visas ett felmeddelande.

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o change_password -u admin-id [-m servernamn] [-p serverport]

Ta bort åtkomst för en administratör

Om du vill ta bort en användare från listan med administrativa användare för servern väljer du Ta bort administratör på administrationssidan för AnswerBook2. Så här tar du bort administratören:

1. Markera kryssrutan vid det administratörsinloggnings-ID som du vill ta bort från Adminstratörslistan.

   Det här är administratörs-ID:t, som inte behöver vara detsamma som personens system- eller användar-ID.

2. Klicka på Ta bort administratör.

   ---

   Obs!

   Den här åtgärden har ingen effekt på användarens möjlighet att komma åt AnswerBook2-dokument som användare. Den tar bara bort användarens möjlighet att utföra administrativa funktioner.

   ---

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o del_admin -u admin-id [-m servernamn] [-p serverport]

Arbeta med dokumentsamlingar

En AnswerBook2-samling är en logisk gruppering av böcker. Du kan t ex ha en samling som innehåller alla Solaris^TM-böcker som vänder sig till utvecklare. Den här samlingen kan vara en AnswerBook2-samling (SGML) eller en AnswerBook1-samling (Display PostScript^TM).

Lista samlingar

Om du vill visa en lista med alla samlingar som är installerade på servern klickar du på Visa lista över tillgängliga samlingar på administrationssidan för AnswerBook2. Den listan innehåller AnswerBook1-samlingar och AnswerBook2-samlingar.

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o list [-m servernamn] [-p serverport]

Lägga till nya samlingar

Om du vill lägga till en samling i serverns databas klickar du på Lägg till samling i lista på administrationssidan för AnswerBook2. Funktionen antar att samlingen redan finns som ett installerat paket i serverns system eller något annat system som servern har åtkomst till. Om samlingen inte är installerad än använder du först pkgadd för att lägga till samlingen, och därefter den här funktionen. För nya samlingar (t ex de som finns på dokumentations-CD:n för Solaris 2.6) läggs samlingarna till i serverns lista automatiskt om du kör kommandot pkgadd på servern.

Så här installerar du samlingen:

1. Skriv en giltig sökväg till samlingsfilen i fältet Samlingens sökväg.

   T ex /opt/answerbooks/english/solaris_2.7/SUNWaman/collinfo. Sökvägen måste peka på en katalog som innehåller antingen en collinfo-fil för en AnswerBook2-samling eller en ab_cardcatalog-fil för en AnswerBook1-samling.

2. Klicka på Lägg till samling.

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o add_coll -d path_to_collection

När du har installerat en samling måste du starta om dokumentationsservern. Du startar om dokumentationsservern genom att klicka på OMSTART på administrationssidans statussida eller skriva följande på kommandoraden:

# /usr/lib/ab2/bin/ab2admin -o restart

Lägga till befintliga samlingar

AnswerBook2-servern kan leta i ditt system efter lokalt installerade AnswerBook1- och AnswerBook2-samlingar och lägga till dem i serverns databas. Om du vill att servern ska utföra den här funktionen klickar du på Sök efter lokalt installerade samlingar på administrationssidan för AnswerBook2. Med den här funktionen skapas och visas en lista över alla giltiga dokumentsamlingar i det lokala systemet.

Så här lägger du till en samling i serverns databas:

1. Klicka i kryssrutan intill samlingen som du vill lägga till.

2. När du har markerat alla samlingar du vill använda klickar du på Lägg till markerade samlingar.

Samlingar utan kryssruta finns redan i databasen.

Om listan inte innehåller dokumentsamlingar som är installerade på en lokal monteringspunkt, verifierar du att katalogen där samlingarna är installerade har läsåtkomst för andra.

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o scan

Sökfunktionen på kommandoraden lägger till alla samlingar som påträffas. Du kan inte välja vilka samlingar du vill lägga till.

När du har installerat en samling måste du starta om dokumentationsservern. Du startar om dokumentationsservern genom att klicka på OMSTART på administrationsstatussidan för AnswerBook2 eller skriva följande på kommandoraden:

# /usr/lib/ab2/bin/ab2admin -o restart

Ta bort AnswerBook2-samlingar

Om du vill ta bort en AnswerBook2- eller AnswerBook1-samling från serverns databas klickar du på Ta bort samling från lista på administrationssidan för AnswerBook2. Så här tar du bort samlingen:

1. Markera kryssrutorna bredvid rubrikerna på samlingarna som du vill ta bort från Lista över samlingar. (Om du vill avmarkera ett markerat element klickar du i kryssrutan igen.)

2. När du har markerat alla samlingar som du vill ta bort klickar du på Ta bort samling.

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o del_coll -t samlingstitel

Funktionerna tar inte bort samlingspaketen från systemet, utan samlingens post tas bara bort från serverdatabasen. Om du vill ta bort paketen från systemet använder du pkgrm.

När du har tagit bort en samling måste du starta om dokumentationsservern. Du startar om dokumentationsservern genom att klicka på OMSTART på administrationsstatussidan för AnswerBook2 eller skriva följande på kommandoraden:

# /usr/lib/ab2/bin/ab2admin -o restart

Konfigurera dokumentationsservern

Om du vill visa aktuell serverkonfiguration klickar du på Visa aktuell konfiguration på administrationssidan för AnswerBook2. Om du vill ändra de här inställningarna klickar du på Ändra serverkonfiguration på administrationssidan för AnswerBook2.

Visa dokumentationsserverkonfiguration

På sidan Visa aktuell konfiguration visas en lista över inställningarna i Tabell 3-1 och Tabell 3-2. Inställningarna lagras i filen serverkonfigurationssökväg/dwhttpd.cfg (som standard /usr/lib/ab2/dweb/data/config/dwhttpd.cfg).

Om du kör en CGI-baserad server i stället för en NSAPI-server visas bara några av serverkonfigurationsalternativen på administrationssidans gränssnitt. Mer information finns i "Konfigurationsproblem när servern körs som en CGI-process".

Dokumentadministratören bör inte ändra inställningarna i Tabell 3-2 manuellt. Systemet konfigurerar de här inställningarna när du installerar serverprogrammet.

Du kan också använda följande kommando för att visa aktuell serverkonfiguration:

% /usr/lib/ab2/bin/ab2admin -o view_config [-m servernamn] [-p serverport]

Ändra konfiguration för dokumentationsserver

När du installerar AnswerBook2-serverprogramvaran anges vissa variabler till standardvärden. Använd fälten på sidan Ändra serverkonfiguration för att ändra de här värdena. Du kan ändra följande serverinställningar:

De här funktionerna är också tillgängliga via det administrativa kommandoradsbaserade gränssnittet (ab2admin). Mer detaljerad information om det kommandoradsbaserade gränssnittet finns i avsnittet Bilaga A. Du kan också redigera filen serverkonfigsökväg/dwhttpd.cfg (som standard används /usr/lib/ab2/dweb/data/config/dwhttpd.cfg) om du vill ändra värdena.

Om du ändrar något av de här värdena måste du stanna och starta om dokumentationsservern. Logga in som root på servern och skriv följande kommando:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

Använda ett lägre portnummer än 1024

Portnummer under 1024 är reserverade för systemet. Så här gör du om du vill använda något av de här numren (t ex portnummer 80) för AnswerBook2-servern:

1. Använd antingen funktionen Ändra konfigurationsinställningar på administrationssidan för AnswerBook2 eller redigera filen /usr/lib/ab2/dweb/data/config/dwhttpd.cfg och ändra serverns portnummer till 80.

2. Redigera filen /usr/lib/ab2/dweb/data/config/nsapi.cfg och ändra serverns portnummer till 80.

   Raden bör se ut så här:

   set ServerPort 80

3. Redigera filen /etc/init.d/ab2mgr och ändra den här raden från daemon till root:

   su daemon -c "LD_PRELOAD=$pre_load;LANG=$LNG;AB2_ORIG_LANG=$ORGLNG;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG AB2_ORIG_LANG LC_ALL EBT_REGISTRY; $AB2BIN/dwhttpd $AB2CFG > /dev/null"

   till följande:

   su root -c "LD_PRELOAD=$pre_load;LANG=$LNG;AB2_ORIG_LANG=$ORGLNG;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG AB2_ORIG_LANG LC_ALL EBT_REGISTRY; $AB2BIN/dwhttpd $AB2CFG > /dev/null"

   På det här sättet kan den överordnade processen dwhttpd köras som root, som sedan kan använda port 80. Observera att den underordnade processen dwhttpd ändå körs som bakgrundsprogram.

Konfigurationsproblem när servern körs som en CGI-process

AnswerBook2-servern följer standardwebbprotokollen, och du kan därför köra AnswerBook2-servern som en CGI-process på en befintlig server, i stället för på NSAPI-standardservern. Information om hur du konfigurerar servern för att köras på det här sättet finns i "Köra AnswerBook2-servern som en CGI-process".

Om du kör dokumentationsservern som en CGI-process kommer följande konfigurationsinställningar inte att visas på sidan Visa konfigurationsinställningar på administrationssidan för AnswerBook2:

• Max antal trådar

• Max antal serverfrågor

• Serverkonfigurationssökväg

• Serveranvändare

• Plug-in-fil

• Mime-fil

• Dokumentsökväg

• Loggkatalog

Det enda alternativet som finns kvar på sidan Ändra konfigurationsinställningar är åtkomstkontroll, som du kan aktivera eller inaktivera. Inga andra funktioner visas.

Följande alternativ för kommandot ab2admin fungerar inte:

• -o access_on

• -o access_off

• -o error_off

• -o error_on

• -o modify_server_name

• -o modify_server_port

Arbeta med andra dokumentationsservrar

När en användare klickar på en länk i en bok kan AnswerBook2-servern följa länken till en annan AnswerBook2-server. Om boken finns på den aktuella dokumentationsservern leder länken dit. Om däremot boken med länken inte finns på den aktuella servern, går AnswerBook2-servern vidare till de alternativa servrar som åtkomst har definierats för. Du kan använda den här funktionen för att distribuera dokument tvärs över olika servrar eller för att skapa säkerhetskopior av dokumenten.

Identifiera alternativa dokumentationsservrar

Om du vill se vilka alternativa servrar som är definierade klickar du på Visa lista över alternativa servrar i administrationssidan för AnswerBook2. En lista visas då över servrar som är identifierade som "reservservrar". Om en användare klickar på en länk i en bok och boken inte finns på den aktuella servern, söker AnswerBook2 igenom servrarna i listan efter länkens mål. AnswerBook2-servern levereras med en fördefinierad alternativ server: http://docs.sun.com. Detta är Suns huvuddokumentationsserver som innehåller utgiven Sun-dokumentation.

För varje alternativ server som definieras för den aktuella servern visar sidan serverns namn, anslutningsnummer och en länk som visar vilka samlingar som finns på den servern. När du klickar på Visa lista av samlingar visas en dialogruta där du anger giltigt administrations-ID och lösenord för den alternativa servern (om administrativ åtkomstkontroll är definierad för den alternativa servern). Du kan alltså lägga till en alternativ server utan att ha administrativ åtkomst till den, men du kan bara visa en lista med samlingar på den alternativa servern om du har administrativ åtkomst till den.

Du kan även använda följande kommando för att utföra denna funktion:

% /usr/lib/ab2/bin/ab2admin -o list_server  
[-m servernamn] [-p serverport]

Lägga till alternativa dokumentationsservrar

Om du vill att den aktuella servern ska komma åt böcker på en annan server (för att kunna följa länkar mellan böcker) väljer du Lägg till alternativ server på administrationssidan för AnswerBook2.

1. Skriv den alternativa serverns namn i fältet AnswerBook2-servernamn.

2. Skriv den alternativa serverns AnswerBook2-portnummer i fältet Serverportnummer. Om du är osäker på portnumret kan du försöka med 8888 (AnswerBook2:s standardanslutningsnummer).

3. Klicka på Lägg till server.

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o add_server -M lägg_till_servernamn -P lägg_till_servernamn 
[-m servernamn] [-p serverport]

Ta bort ytterligare dokumentationsservrar

Om du vill ta bort en server från serverns lista över alternativa servrar klickar du på Ta bort alternativ server på administrationssidan för AnswerBook2.

1. Markera servern i Serverlista.

2. Klicka på Ta bort server.

Den här åtgärden tar bort servern från listan över alternativa servrar för den lokala dokumentationsservern. Åtgärden hindrar inte den borttagna servern från att fungera som dokumentationsserver.

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o del_server -M ta_bort_servernamn -P ta_bort_serverport 
[-m servernamn] [-p serverport]

Ändra ordning för alternativa servrar

När du lägger till en alternativ server i listan över servrar som din server kan använda, placeras den längst ned i serverordningen. Ordningen avgör i vilken följd servern ansluter till alternativa servrar för att följa dokumentlänkar. Om en användare begär ett visst dokument från biblioteket och det dokumentet inte är tillgängligt på standardservern, går servern igenom listan över alternativa servrar i den definierade ordningen och letar efter dokumentet.

Om du vill ändra ordningen på de servrar som är tillgängliga i systemet klickar du på Ändra serverordning på administrationssidan för AnswerBook2.

1. Markera en server i Serverlista.

2. Klicka på Uppåt eller Nedåt.

3. Klicka på Flytta.

Det finns inget kommandoradsalternativ för att utföra den här funktionen.

Arbeta med serverrapporter

Serverprogramvaran i AnswerBook2 för en logg som visar serverfel och serveråtkomst. Dessutom skapar den en sammanfattande rapport som visar hur ofta dokumentsamlingar har använts och hur många fel som har uppstått.

Bokåtkomstrapport

Om du vill visa en sammanfattning av åtkomst till böckerna på servern klickar du på Visa sammanfattningar över bokåtkomst på administrationssidan för AnswerBook2. En bokåtkomstrapport sammanfattar hur ofta varje bok på servern har använts. För varje bok på servern visas följande:

• Boktitel - Bokens titel som den visas på Bibliotekssidan.

• Kort boknamn - Det korta namnet på boken som står i bokens konfigurationsfil.

• Namn på samling - Det korta namnet på samlingen dit boken hör, vilket står i filen collinfo.

• Träffar - Antal gånger som boken har använts.

• Fel - Antal fel som är associerade med boken.

Åtkomstloggfiler

Om du vill aktivera eller inaktivera åtkomstloggning klickar du på Ändra serverkonfiguration på administrationssidan för AnswerBook2.

• Om du vill ha information om vem som använder information på dokumentservern inskriven i åtkomstloggfilen, klickar du på knappen bredvid på och därefter på Verkställ. Standardplatsen för den här filen är /var/log/ab2/logs/access-8888.log.

• Om du inte vill att information ska skrivas in i åtkomstloggfilen längre klickar du på knappen bredvid av och därefter på Verkställ.

Du kan också använda följande kommandon för att utföra de här funktionerna:

% /usr/lib/ab2/bin/ab2admin -o access_on [-m servernamn] [-p serverport]
 

% /usr/lib/ab2/bin/ab2admin -o access_off [-m servernamn] [-p serverport]
 

När du har ändrat loggningsfunktionen måste du stanna och starta om dokumentationsservern. Logga in som root på servern och skriv följande kommandon:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

Visa åtkomstlogg

Om du vill visa åtkomstloggfilen klickar du på Visa loggfiler på administrationssidan för AnswerBook2 och klickar på Visa åtkomstloggfil. Åtkomstloggfilen är en textfil som listar alla användare som har anslutit till dokumentationsservern. Alla rader i åtkomstloggböckerna ser ungefär ut på följande sätt:

129.146.83.55 - - [04/Nov/1996:15:07:05 -0800]
"GET /icons/ab2_curr_home.gif HTTP/1.0" 200 1938

Där:

• Den första gruppen med tal är klientens IP-adress (Internet Protocol). Exempelvis 129.146.83.55.

• Informationen mellan hakparenteser är datum och tid för anslutningen. Exempelvis [04/nov/1996:15:07:05 -0800] .

• Informationen mellan dubbla citattecken anger vilken typ av anslutning som ägde rum. Det här identifierar för det mesta en URL-adress eller ett filnamn och protokollet som användes för att svara på anslutningsanropet. "GET /icons/ab2_curr_home.gif HTTP/1.0" anger t ex att anslutningen gällde filen /icons/ab2_curr_home.gif med protokollet HTTP 1.0.

• Det näst sista talet anger om anslutningen lyckades (200) eller inte (allt annat).

• Det sista talet anger storleken (i kilobyte) på informationen som returneras till anroparen. Exempelvis är 1938 storleken på den .gif-fil som hämtats.

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o view_access [-m servernamn] [-p serverport]

Felloggfiler

Om du vill aktivera eller inaktivera felloggning klickar du på Ändra serverkonfiguration på administrationssidan för AnswerBook2.

• Om du vill att information om fel som uppstår på dokumentationsservern ska skrivas in i felloggfilen, klickar du på knappen bredvid på och därefter på Verkställ. Standardplatsen för den här filen är /var/log/ab2/logs/errors-8888.log.

• Om du inte vill att information ska skrivas in i felloggfilen längre klickar du på knappen bredvid av och därefter på Verkställ.

Du kan också använda följande kommandon för att utföra de här funktionerna:

% /usr/lib/ab2/bin/ab2admin -o error_on [-m servernamn] [-p serverport]
 

% /usr/lib/ab2/bin/ab2admin -o error_off [-m servernamn] [-p serverport]

När du har ändrat loggningsfunktionen måste du stanna och starta om dokumentationsservern. Logga in som root på servern och skriv följande kommandon:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

Visa felloggen

Om du vill visa felloggfilen klickar du på Visa loggfiler på administrationssidan för AnswerBook2 och klickar på Visa felloggfil. Felloggfilen listar alla fel som uppstår på dokumentationsservern. Du kan använda den här informationen för att ta reda på orsaken till serverproblem eller onormalt uppträdande. Felrapporten innehåller för det mesta servern och porten som felet är associerat med, liksom en beskrivning av felet.

Du kan också använda följande kommando för att utföra den här funktionen:

% /usr/lib/ab2/bin/ab2admin -o view_error [-m servernamn] [-p serverport]

Rotera loggfiler

Du kan spara den aktuella användarloggen eller felloggen till en fil och börja logga information i en tom fil.

• Om du vill rotera felloggen klickar du på Rotera fellogg på administrationssidan för AnswerBook2.

• Om du vill rotera användarloggen klickar du på Rotera åtkomstloggfil på administrationssidan för AnswerBook2.

Gör följande när sidan Rotera åtkomstlogg/Rotera fellogg visas:

1. Skriv namnet på filen som ska sparas i fältet Spara loggfil.

   Standardvärdet är aktuellt_datum.aktuellt_loggfilsnamn.log. Här har aktuellt_datum formen årårårår_MånadMånad_DagDag_TimmeTimme, och aktuellt_loggfilsnamn har standardvärdet access-8888.log eller error-8888.log (exempelvis 1997_2_26_14.access-8888.log).

   Observera att sökvägen till filen visas i fältet Placering av loggfil. Du kan inte ändra den här informationen på den här sidan.

2. Klicka på Verkställ.

När du har ändrat loggningsfunktionen måste du stanna och starta om dokumentationsservern. Logga in som root på servern och skriv följande kommandon:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

Du kan också använda följande kommandon för att utföra de här funktionerna:

% /usr/lib/ab2/bin/ab2admin -o rotate_error [-m servernamn] [-p serverport]
 

% /usr/lib/ab2/bin/ab2admin -o rotate_access [-m servernamn] [-p serverport]

Navigeringsfunktioner på administrationssidorna

Överst på varje sida i AnswerBook2 hittar du en uppsättning med vanliga navigeringsfunktioner. I följande tabell beskrivs vad som händer när du väljer någon av dessa funktioner från administrationssidorna.

På många av administrationssidorna kan du komma till huvudadministrationssidan för AnswerBook2 genom att klicka på ikonen .