Installation und Verwaltung eines AnswerBook2-Servers

Konfigurieren des Dokumentationsservers

Zum Anzeigen der aktuellen Serverkonfiguration wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl Aktuelle Konfiguration anzeigen. Um die vorhandenen Einstellungen zu ändern, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl Serverkonfiguration ändern.

Anzeigen der Konfiguration des Dokumentationsservers

Die Seite "Aktuelle Konfiguration anzeigen" enthält eine Liste der in der Tabelle 3-1 angezeigten Einstellungen Tabelle 3-2. Diese Einstellungen sind in der Datei server_config_path /dwhttpd.cfg gespeichert (standardmäßig /usr/lib/ab2/dweb/data/config/dwhttpd.cfg).


Hinweis -

Wenn Sie Ihren Server nicht auf NSAPI-Basis (Standard), sondern auf CGI-Basis betreiben, sind auf der Oberfläche der Verwaltungsseite nicht alle Konfigurationsoptionen sichtbar. Weitere Informationen finden Sie unter "Konfigurationsprobleme beim Ausführen des Servers als CGI-Prozeß".


Tabelle 3-1 Benutzerdefinierbare Konfigurationseinstellungen für den Server

Bezeichnung 

Standardwert und Beschreibung 

Servername 

Standardeinstellung: lokaler Host-Name (Beispiel: imaserver). Dieser Name wird von den Clients für den Zugriff auf die Dokumente dieses Servers genutzt. Um die Antwortzeit zu verkürzen, geben Sie einen vollständigen Namen ein (Beispiel: imaserver.eng.sun.com). Wenn der Zugriff auf den Dokumentationsserver auch von außerhalb Ihrer Domäne möglich sein soll, müssen Sie den vollständigen Namen eingeben.

Serveranschluß  

Standardeinstellung: 8888. Portnummer für Kommunikationsverbindungen. Sie können jede freie Portnummer auswählen; es wird jedoch empfohlen, den Standardwert zu verwenden.

Max. Anzahl Threads 

Standardeinstellung: 32. Maximale Anzahl der gleichzeitigen AnswerBook1-Suchvorgänge, die vom Server ausgeführt werden. Wenn Sie über zahlreiche AnswerBook1-Buchreihen verfügen, die häufig durchsucht werden, ist gegebenenfalls eine Erhöhung dieses Wertes ratsam. Dies kann aber eine längere Antwortzeit des Servers zur Folge haben.

Max. Anzahl Serveranforderungen 

Standardeinstellung: 1024. Der Server wird zur Durchführung von "Housekeeping"-Funktionen aufgefordert; nach der angegebenen Zahl von http-Abfragen erfolgt ein Neustart.

Zugriffsdatei 

Standardeinstellung: /var/log/ab2/logs/access-8888.log. Vollständiger Pfadname der Zugriffsprotokolldatei, in der Informationen zu jedem erfolgten Zugriff auf den lokalen Server enthalten sind.

Fehlerdatei 

Standardeinstellung: /var/log/ab2/logs/error-8888.log. Vollständiger Pfadname der Fehlerprotokolldatei, in der Informationen zu allen aufgetretenen Fehlern enthalten sind.

Verwaltungs-Zugriffskontrolle 

Standardeinstellung: On. Gibt an, ob der Zugriff auf die Verwaltungsfunktionen des Servers von Ihnen gesteuert wird. Bei der Erstinstallation eines Dokumentationsservers ist die Verwaltungs-Zugriffssteuerung zwar eingeschaltet, jedoch ist standardmäßig weder ein Benutzername noch ein Paßwort definiert. Informationen zum Einrichten des Erstzugriffs auf die Verwaltungsfunktionen finden Sie unter "Einrichten des Erstzugriffs auf die Verwaltung".

 Automatischer Start des AnswerBook2-Servers nach erneutem Booten

Standardeinstellung: Ja. Bestimmt, ob die Software des AnswerBook2-Servers nach dem erneuten Booten automatisch startet.


Hinweis -

Die unter Tabelle 3-2. angezeigten Einstellungen sollten vom Dokumentationsverwalter nicht manuell geändert werden. Die Einstellungen werden beim Installieren der Serversoftware vom System konfiguriert.


Tabelle 3-2 Feste Konfigurationseinstellungen für den Server

Bezeichnung 

Standardwert und Beschreibung 

Server-Konfigurationspfad  

Standardeinstellung: /usr/lib/ab2/dweb/data/config

Name des Pfads, unter dem die Konfigurationsdateien für diesen Server gespeichert sind. 

Serverbenutzer 

Standardeinstellung: daemon

Eigentümer des Serverprozesses. Das Ändern dieses Variablenwerts kann beträchtliche Probleme beim Betrieb des Servers oder beim Zugriff auf die dort abgelegten Buchreihen hervorrufen.  

Plugin-Datei  

Standardeinstellung: /usr/lib/ab2/dweb/data/config/nsapi.cfg

Vollständiger Pfadname der Datei, in der alle Server-Plugins definiert sind. 

Mime-Datei 

Standardeinstellung: /usr/lib/ab2/dweb/data/config/mime.types

Vollständiger Pfadname der Datei, in der die MIME-Informationen definiert sind. 

Doku-Root 

Standardeinstellung: /usr/lib/ab2/data/docs

Pfadname, unter dem die Dokumentdateien für diesen Server gespeichert sind. 

Protokollverzeichnis  

Standardeinstellung: /var/log/ab2/logs

Pfadname, unter dem die Protokolldateien für diesen Server gespeichert sind. 

AnswerBook1-Buchreihendatenbank 

Standardeinstellung: /var/log/ab2/catalog/ab1_cardcatalog

Diese Datei enthält Angaben zu allen auf dem Server installierten AnswerBook1-Buchreihen. 

AnswerBook2-Buchreihendatenbank 

Standardeinstellung: /usr/lib/ab2/dweb/data/config/ab2_collections.template

Diese Datei enthält Angaben zu allen auf dem Server installierten AnswerBook2-Buchreihen. 

Zum Anzeigen der aktuellen Serverkonfiguration können Sie auch folgenden Befehl eingeben:


% /usr/lib/ab2/bin/ab2admin -o view_config [-m Server_Name] [-p Server_Port]

Ändern der Dokumentationsserverkonfiguration

Beim Installieren der AnswerBook2-Serversoftware werden bestimmte Variablen auf Standardwerte gesetzt. Verwenden Sie zum Ändern dieser Werte die Felder auf der Seite "Serverkonfiguration ändern". Die in der folgenden Tabelle aufgeführten Servereinstellungen können Sie ändern:

Tabelle 3-3 Serverkonfiguration ändern

Servername 

Beim Installieren des Dokumentationsserver setzt die AnswerBook2-Software diese Variable automatisch auf den aktuellen Host-Namen (Beispiel: cats). Wenn der Zugriff auf den Dokumentationsserver auch von außerhalb Ihrer Domäne möglich sein soll, ersetzen Sie den Namen durch einen vollständigen Namen (Beispiel: cats.house.pets.com ).

Server-Anschlußnummer 

Um einen anderen Port als 8888 zu verwenden, geben Sie in diesem Feld die entsprechende Portnummer ein. Um eine Portnummer verwenden zu können, die niedriger als 1024 ist, müssen zusätzliche Schritte ausgeführt werden. Weitere Informationen finden Sie unter "Verwenden einer Portnummer unter 1024".

Max. Anzahl Threads 

Maximale Anzahl der gleichzeitigen AnswerBook1-Suchvorgänge, die vom Server ausgeführt werden. Wenn Sie über zahlreiche AnswerBook1-Buchreihen verfügen, die häufig durchsucht werden, ist gegebenenfalls eine Erhöhung dieses Wertes ratsam. Dies kann aber eine längere Antwortzeit des Servers zur Folge haben. 

Max. Anzahl Serveranforderungen 

Legt fest, wie oft der Server die 'Housekeeping'-Funktionen mit anschließendem Neustart durchführt. Die Zahl gibt die Anzahl der http -Anforderungen an den Server an.

Zugriffsprotokolldatei 

Klicken Sie auf den entsprechenden Eintrag, um die Zugriffsprotokollierung ein- oder auszuschalten. Wenn mit zahlreichen Benutzerzugriffen auf Ihren Dokumentationsserver zu rechnen ist, sollten Sie diese Protokolldatei regelmäßig speichern und erneut starten. Weitere Informationen über das Speichern und erneute Starten der Zugriffsprotokolldatei finden Sie unter "Umstellen von Fehlerprotokolldateien ".

Fehlerprotokolldatei 

Klicken Sie auf den entsprechenden Eintrag, um die Fehlerprotokollierung ein- oder auszuschalten. Wenn auf dem Server häufig Fehler auftreten, sollten Sie diese Protokolldatei regelmäßig speichern und erneut starten. Weitere Informationen über das Speichern und erneute Starten der Fehlerprotokolldatei finden Sie unter "Umstellen von Fehlerprotokolldateien ".

Verwaltungs-Zugriffskontrolle  

Klicken Sie auf den entsprechenden Eintrag, um die Verwaltungs-Zugriffskontrolle ein- oder auszuschalten. Bei eingeschalteter Zugriffssteuerung können die Verwaltungsfunktionen dieses Servers nur von Benutzern mit eingerichtetem Zugriffsrecht ausgeführt werden.  

Automatischer Start des AnswerBook2-Servers nach erneutem Booten 

Klicken Sie auf den entsprechenden Eintrag, um diese Funktion ein- oder auszuschalten. 

Diese Funktionen sind auch über die Befehlszeilen-Oberfläche der Verwaltung (ab2admin) verfügbar. Weitere Informationen über die Befehlszeilen-Oberfläche finden Sie unter Anhang A. Außerdem können Sie zum Ändern dieser Werte auch die Datei server_config_path /dwhttpd.cfg bearbeiten (standardmäßig installiert unter /usr/lib/ab2/dweb/data/config/dwhttpd.cfg).


Hinweis -

Nach dem Ändern dieser Werte muß der Dokumentationsserver angehalten und erneut gestartet werden. Melden Sie sich am Dokumentationsserver als root an, und geben Sie folgende Befehle ein:


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

Verwenden einer Portnummer unter 1024

Die Portnummern unter 1024 sind für das System reserviert. So verwenden Sie eine dieser Nummern (z. B. Portnummer 80) für den AnswerBook2-Server:

  1. Verwenden Sie auf der AnswerBook2-Verwaltungsseite die Funktion "Konfigurationseinstellungen ändern", oder bearbeiten Sie die Datei /usr/lib/ab2/dweb/data/config/dwhttpd.cfg, und ändern Sie die Portnummer des Servers zu 80.

  2. Bearbeiten Sie die Datei /usr/lib/ab2/dweb/data/config/nsapi.cfg, und ändern Sie die Portnummer des Servers zu 80.

    Die Zeile sollte wie folgt aussehen:


    set ServerPort 80
  3. Bearbeiten Sie die Datei /etc/init.d/ab2mgr, und ersetzen Sie die Zeile von daemon bis 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"

    durch:


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

    Dadurch kann der übergeordnete dwhttpd-Prozeß als root ablaufen, die dann Port 80 verwenden kann. Beachten Sie dabei, daß der untergeordnete dwhttpd-Prozeß weiterhin als daemon abläuft.

Konfigurationsprobleme beim Ausführen des Servers als CGI-Prozeß

Da der AnswerBook2-Server mit Standard-Web-Protokollen arbeitet, kann er alternativ zur Standardeinrichtung als NSAPI-Server auch als CGI-Prozeß auf einem bestehenden Server ausgeführt werden. Informationen zu dieser Serverkonfiguration finden Sie unter "Ausführen des AnswerBook2-Servers als CGI-Prozeß".

Wird der Dokumentationsserver als CGI-Prozeß ausgeführt, werden auf der Seite "Konfigurationseinstellungen anzeigen" der AnswerBook2-Verwaltungsseite folgende Konfigurationseinstellungen nicht angezeigt:

Die einzige auf der Seite "Serverkonfiguration ändern" verfügbare Option ist das Ein- oder Ausschalten der Zugriffsteuerung. Alle anderen Funktionen werden nicht angezeigt.

Die folgenden Optionen des Befehls ab2admin sind nicht aufrufbar: