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.
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).
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ß".
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. |
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.
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] |
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).
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 |
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:
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.
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 |
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.
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:
Max. Anzahl Threads
Max. Anzahl Serveranforderungen
Server-Konfigurationspfad
Serverbenutzer
Plugin-Datei
Mime-Datei
Doku-Root
Protokollverzeichnis
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:
-o access_on
-o access_off
-o error_off
-o error_on
-o modify_Server_Name
-o modify_Server_Port