Installera och administrera en AnswerBook2-server

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 server_config_path/dwhttpd.cfg (som standard /usr/lib/ab2/dweb/data/config/dwhttpd.cfg).

Obs!

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

Tabell 3-1 Serverkonfigurationsinställingar som kan göras av användaren


Etikett	Standardvärde och beskrivning
Servernamn	Standard: `Lokalt värdnamn` (till exempel: `imaserver`). Namnet som klienter använder för att komma åt dokument på servern. Du kan förbättra svarstiden genom att ange ett fullständigt namn (till exempel: `imaserver.eng.sun.com`). Om du räknar med att användare utanför domänen kommer att ansluta till dokumentationsservern, måste du ange ett fullständigt namn.
Serverport	Standard: `8888`. Anslutningsnumret för kommunikation. Du kan välja valfritt ledigt anslutningsnummer, men standardvärdet rekommenderas.
Maximalt antal trådar	Standard: `32.` Det här är det högsta tillåtna antal samtidiga AnswerBook1-sökningar som servern kan utföra. Om du har många AnswerBook1-samlingar och användare ofta söker i dem, kan du behöva öka antalet trådar. Om du ökar antalet kan emellertid serverns svarstid bli längre.
Maximalt antal serveranrop	Standard: `1024`. Instruerar servern att utföra "administrativa" aktiviteter och starta om automatiskt efter det angivna antalet `http`-frågor.
Användarfil	Standard:`/var/log/ab2/logs/access-8888.log`. Den fullständiga sökvägen till användarloggen, som innehåller information om alla anslutningar som har gjorts till den lokala servern.
Felfil	Standard: `/var/log/ab2/logs/error-8888.log`. Den fullständiga sökvägen till felloggen, som innehåller information om alla fel som har påträffats.
Administrationsåtkomstkontroll	Standard: `På`. Anger om du kan styra vem som har åtkomst till administrativa funktioner på servern. När du först installerar en dokumentationsserver definieras som standard inget användarnamn och lösenord, trots att administrativ åtkomstkontroll är aktiverad. Mer information om hur du anger preliminär administrativ åtkomst finns i "Ställa in preliminär administrativ åtkomst".
Starta AnswerBook2-servern automatiskt efter omstart	Standard: `ja`. Anger om programvaran för AnswerBook2-servern ska startas automatiskt när systemet startas om.

Obs!

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.

Tabell 3-2 Fasta serverkonfigurationsinställningar


Etikett	Standardvärde och beskrivning
Serverkonfigurationssökväg	Standard: `/usr/lib/ab2/dweb/data/config` Sökvägen till serverns konfigurationsfiler.
Serveranvändare	Standard: `daemon` Ägaren till serverprocessen. Om du ändrar värdet på den här variabeln kan det skapa allvarliga problem när du kör servern eller använder samlingarna på servern.
Plug-in-fil	Standard: `/usr/lib/ab2/dweb/data/config/nsapi.cfg` Den fullständiga sökvägen till filen som definierar alla server-plug-in-program.
Mime-fil	Standard: `/usr/lib/ab2/dweb/data/config/mime.types` Den fullständiga sökvägen till filen som definierar all MIME-information.
Dokumentsökväg	Standard: `/usr/lib/ab2/data/docs` Detta är sökvägen till den plats där dokumentfilerna för denna server lagras.
Loggkatalog	Standard: `/var/log/ab2/logs` Sökvägen till serverns loggfiler.
Samlingsdatabas för AnswerBook1	Standard: `/var/log/ab2/catalog/ab1_cardcatalog` Den här filen identifierar de AnswerBook1-samlingar som är installerade på servern.
Samlingsdatabas för AnswerBook2	Standard: `/usr/lib/ab2/dweb/data/config/ab2_collections.template` Den här filen identifierar de AnswerBook2-samlingar som är installerade på servern.

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 de serverinställningar som finns i nedanstående tabell:

Tabell 3-3 Ändra serverkonfiguration


Servernamn	När du installerar dokumentationsservern anger AnswerBook2 automatiskt den här variabeln till det aktuella värdnamnet (till exempel `katter`). Om du vill att vem som helst utanför domänen ska komma åt dokument på servern ändrar du namnet till ett fullständigt namn (till exempel, `katter.husdjur.com`).
Serverportnummer	Om du vill använda en annan port än `8888` för AnswerBook2-servern skriver du portens nummer i det här fältet. Om du vill använda ett lägre portnummer än 1024, måste du utföra ytterligare steg. Mer information finns i "Använda ett lägre portnummer än 1024".
Maximalt antal trådar	Det här är det högsta tillåtna antal samtidiga AnswerBook1-sökningar som servern kan utföra. Om du har många AnswerBook1-samlingar och användare ofta söker i dem, kan du vilja öka antalet trådar. Om du ökar antalet kan emellertid serverns svarstid bli längre.
Maximalt antal serveranrop	Det här anger hur ofta servern ska utföra administrativa aktiviteter och starta om automatiskt. Numret anger antalet `http`-anrop till servern.
Felloggfil	Klicka på lämpligt element om du vill aktivera eller inaktivera administrativ åtkomstkontroll. Om många serverfel uppstår kan du behöva spara och starta om loggfilen då och då. Mer information om hur du roterar felloggfilen finns i "Rotera loggfiler".
Felloggfil	Klicka på lämpligt element om du vill aktivera eller inaktivera administrativ åtkomstkontroll. Om många serverfel uppstår kan du behöva spara och starta om loggfilen då och då. Mer information om hur du roterar felloggfilen finns i "Rotera loggfiler".
Administrationsåtkomstkontroll	Klicka på lämpligt element om du vill aktivera eller inaktivera administrativ åtkomstkontroll. När åtkomstkontroll är aktiverad kan bara användare som har administrativ åtkomst utföra administrativa funktioner på den här servern.
Starta AnswerBook2-servern automatiskt efter omstart av systemet	Klicka på lämpligt element om du vill aktivera eller inaktivera den här funktionen.

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

Obs!

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:

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.

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

Redigera filen /etc/init.d/ab2mgr och ändra den här raden från bakgrundsprogram 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