Kapitel 3 Verwaltung von AnswerBook2-Servern

Die Verwaltung der AnswerBook2-Software besteht im Ausführen der folgenden Funktionen, von denen jede für bestimmte Aufgaben vorgesehen ist:

• "Verwalten des Dokumentationsservers"

• "Starten und Anhalten des Dokumentationsservers "

• "Ein- und Ausschalten der Dokumentquellen-Fehlersuche "

• "Steuern des Verwaltungszugriffs"

• "Arbeiten mit Buchreihen"

• "Anzeigen der Konfiguration des Dokumentationsservers "

• "Arbeiten mit anderen Dokumentationsservern "

• "Arbeiten mit Serverberichten"

• "Allgemeine Navigationsfunktionen der Verwaltungsseite"

Verwalten des Dokumentationsservers

Die AnswerBook2-Software verfügt über eine Web-Browser-Oberfäche (Admin-Oberfläche) und eine Befehlszeilen-Oberfläche (ab2admin), die Sie für die Verwaltung des Dokumentationsservers verwenden können. Die meisten Funktionen sind auf beiden Oberflächen verfügbar.

Wird der Dokumentationsserver von einer CD-ROM ausgeführt, sind keine Verwaltungsfunktionen verfügbar.

Um auf die Hauptverwaltungsseite von AnswerBook2 zuzugreifen, wählen Sie AnswerBook2-Verwaltung auf der Optionsseite des AnswerBook2-Browsers, oder greifen Sie auf den URL zu: http://server:port/ab2/@Ab2Admin, wobei server der Name Ihres Servers und port die Nummer des Anschlusses ist, unter dem der Server läuft. Alle Seiten in der Verwaltungsseite enthalten am oberen Seitenrand allgemeine Funktionen zur Seitennavigation .

Um auf die Befehlszeilen-Oberfläche zuzugreifen, verwenden Sie den Befehl /usr/lib/ab2/bin/ab2admin . Weitere Informationen über die Befehlszeilen-Oberfläche finden Sie unter ab2admin(1m) man page Anhang A.

Die Verwaltungsfunktionen können nur von Benutzern mit entsprechender Berechtigung ausgeführt werden. Weitere Informationen finden Sie unter "Steuern des Verwaltungszugriffs".

Starten und Anhalten des Dokumentationsservers

Der Dokumentationsserver kann beim Booten des Systems automatisch gestartet werden (über das Skript /etc/init.d/ab2mgr). Bei Bedarf kann der Dokumentationsserver auch manuell gestartet, angehalten und neu gestartet werden. Nach dem Installieren einer neuen Buchreihe beispielsweise muß der Dokumentationsserver neu gestartet werden.

Um diese Funktionen ausführen zu können, melden Sie sich am Dokumentationsserver als root an, und verwenden Sie die ab2admin-Befehlszeilen-Oberfläche.

• Zum Starten des Dokumentationsservers verwenden Sie den folgenden Befehl:

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

• Zum Anhalten des Dokumentationsservers verwenden Sie den folgenden Befehl:

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

• Zum Neustart des Dokumentationsservers verwenden Sie den folgenden Befehl:

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

  Wenn der Neustart des Servers nicht den gewünschten Erfolg hat, halten Sie den Server an, und starten Sie ihn dann wieder.

• Zum Starten des Dokumentationsservers mit aktivierter Fehlersuche verwenden Sie den folgenden Startbefehl:

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

• Zum Anhalten des automatischen Serverstarts beim erneuten Booten des Systems verwenden Sie folgenden Befehl:

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

Ein- und Ausschalten der Dokumentquellen-Fehlersuche

Der AnswerBook2-Server verfügt über eine Fehlersuchoption, mit der unbekannte Markup-Informationen der Buchquelle im Viewer rot darstellt und mit dem Wort 'Fehler' versehen werden können. Diese Funktion hilft bei der Problemerkennung, falls ein Buch nicht wie erwartet angezeigt wird.

Um die Fehlersuche einzuschalten, melden Sie sich im System des Dokumentationsservers als root an, und setzen Sie die Umgebungsvariable AB2_DEBUG auf 1. Beispiel:

% su -
# setenv AB2_DEBUG 1

Um die Fehlersuche auszuschalten, melden Sie sich im System des Dokumentationsservers als root an, und setzen Sie die Umgebungsvariable AB2_DEBUG auf 0. Beispiel:

% su -
# setenv AB2_DEBUG 0

Nach Änderung des Fehlersuchparameters müssen Sie den Dokumentationsserver neu starten. Zum Neustart des Dokumentationsservers geben Sie folgendes ein:

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

Zur Steuerung der Fehlersuche beim Starten des Servers verwenden Sie den folgenden Startbefehl:

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

Steuern des Verwaltungszugriffs

Ein Benutzer mit Verwaltungsrechten ist ein besonderer Benutzer, der spezielle Funktionen in der Dokumentverwaltung ausführt. AnswerBook2 prüft mit Hilfe von Paßwörtern, ob ein bestimmter Verwalter Verwaltungsaufgaben auf dem Server ausführen darf.

Einrichten des Erstzugriffs auf die Verwaltung

Die AnswerBook2-Software wird zur Ausführung der Verwaltungsaufgaben mit aktivierter Zugriffssteuerung ausgeliefert, jedoch ohne Festlegung eines Standard-Benutzers. Wenn Sie die Verwaltungsfunktionen von AnswerBook2 erstmals aufrufen wollen, erhalten Sie von der Software die Meldung, daß die Zugriffssteuerung aktiviert ist, aber kein Benutzer definiert wurde. Sie haben jetzt zwei Möglichkeiten:

• Schalten Sie die Zugriffssteuerung aus.

  Zum Ausschalten der Zugriffssteuerung melden Sie sich am Dokumentationsserver als root an, und geben Sie folgendes ein:

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

  ---

  Achtung -

  Wenn Sie die Zugriffssteuerung ausschalten, kann Ihr Dokumentationsserver von jedem Benutzer geändert werden, der auf ihn zugreifen kann.

  ---

• Legen Sie einen Benutzer mit Verwaltungsrechten und ein Paßwort fest.

  Zum Festlegen eines Benutzers mit Verwaltungsrechten melden Sie sich am Dokumentationsserver als root an, und geben Sie folgendes ein:

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

  admin-id ist die Anmelde-ID zur Verwaltung dieses Dokumentationsservers. Die admin-id muß nicht mit der System-ID des Benutzers übereinstimmen; sie stellt lediglich eine Anmelde-ID für die Ausführung von dokumentbezogenen Verwaltungsfunktionen auf einem bestimmten Server dar.

  Sie werden zur Eingabe eines Paßworts für den Benutzer aufgefordert, das Sie anschließend zur Bestätigung erneut eingeben müssen.

Hinzufügen von Zugriffsrechten für AnswerBook2-Verwalter

Um einen Benutzer mit Verwaltungsrechten hinzuzufügen, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Administrator hinzufügen". So fügen Sie einen Benutzer mit Verwaltungsrechten hinzu:

1. Geben Sie im Feld "Administrator-ID" die Anmelde-ID des Administrators ein.

   Die admin-id muß nicht mit der System-ID des Benutzers übereinstimmen; sie stellt lediglich eine Anmelde-ID für die Ausführung von dokumentbezogenen Verwaltungsfunktionen auf einem bestimmten Server dar.

2. Geben Sie ein Paßwort für den Administrator ein.

   Das Paßwort wird in der AnswerBook2-Paßwort-Datenbank gespeichert. Es muß nicht mit dem Paßwort für die Systemanmeldung des Benutzers übereinstimmen.

Das Paßwort muß zur Bestätigung ein zweites Mal eingegeben werden.

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

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

Ändern des Paßworts für einen Verwalter

Um das Paßwort eines Verwalters zu ändern, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Paßwort ändern". So ändern Sie das Paßwort:

1. Wählen Sie den Benutzer mit Verwaltungsrechten aus der Popup-Liste "Administrator-ID".

2. Geben Sie im Feld "Altes Paßwort" das vorhandene Paßwort des Verwalters ein.

3. Geben Sie nun im Feld "Neues Paßwort" das neue Paßwort des Verwalters ein.

4. Geben Sie im Feld "Erneute Eingabe des neuen Paßworts" das neue Paßwort des Verwalters ein.

5. Klicken Sie auf "Paßwort ändern", um die Änderung zu übernehmen.

Wenn Sie auf Paßwort ändern klicken, prüft die AnswerBook2-Software, ob die Eingaben in den beiden Feldern übereinstimmen. Wenn das der Fall ist, wird das neue Paßwort in der Datenbank gespeichert. Stimmen die Eingaben nicht überein, wird eine Fehlermeldung ausgegeben.

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

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

Zugriffsrechte für Administratoren entfernen

Um einen Benutzer aus der Liste der für diesen Server verwaltungsbrechtigten Benutzer zu entfernen, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl Administrator löschen. So entfernen Sie den Verwalter:

1. Klicken Sie auf das Kontrollkästchen neben der Anmelde-ID des Administrators, den Sie aus der Liste entfernen möchten.

   Es handelt sich um die Administrator-ID, die nicht mit der System- oder Benutzer-ID der betreffenden Person übereinstimmen muß.

2. Klicken Sie auf Administrator löschen.

   ---

   Hinweis -

   Diese Aktion hat keinen Einfluß auf die Zugriffsmöglichkeiten, die die betreffende Person als Benutzer der AnswerBook2-Dokumente hat. Es wird nur das Zugriffsrecht dieser Person auf die Verwaltungsfunktionen deaktiviert.

   ---

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

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

Arbeiten mit Buchreihen

Eine AnswerBook2-Buchreihe ist eine logische Gruppierung von Büchern. Es kann z. B. eine Buchreihe geben, in der alle entwicklerorientierten Bücher zu Solaris^TM enthalten sind. Dabei kann es sich um eine AnswerBook2-Buchreihe (SGML) oder um eine AnswerBook1-Buchreihe (Display PostScript^TM) handeln.

Auflisten von Buchreihen

Um eine Liste aller Buchreihen einzusehen, die sich auf Ihrem Server befinden, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Liste der verfügbaren Buchreihen anzeigen". Diese Liste enthält AnswerBook1-Buchreihen und AnswerBook2-Buchreihen.

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

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

Hinzufügen neuer Buchreihen

Um zur Datenbank des Servers eine Buchreihe hinzuzufügen, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Buchreihe zur Liste hinzufügen". Diese Funktion setzt voraus, daß die Buchreihe bereits als installiertes Paket im Serversystem oder in einem System, auf das der Server zugreifen kann, vorhanden ist. Wenn die Buchreihe noch nicht installiert ist, verwenden sie vor dem Ausführen dieser Funktion den Befehl pkgadd, um die Buchreihe hinzuzufügen. Neue Buchreihen (z. B. von der Solaris 2.5.1 operating environment or compatible version Documentation CD) werden bei Verwendung des Befehls pkgadd automatisch zur Liste des Servers hinzugefügt. Neue Buchreihen (zum Beispiel von der Solaris 2.6-Dokumentations-CD) werden automatisch in die Liste des Servers aufgenommen, wenn Sie den Befehl pkgadd ausführen.

Führen Sie folgende Schritte aus, um eine Buchreihe zu installieren:

1. Geben Sie im Feld "Pfad zur Buchreihe" einen gültigen Pfad zur Buchreihendatei ein.

   Beispiel: /opt/answerbooks/english/solaris_2.7/SUNWaman/collinfo. Der Pfad muß auf ein Verzeichnis verweisen, das eine collinfo-Datei (für eine AnswerBook2-Buchreihe) bzw. eine ab_cardcatalog-Datei (für eine AnswerBook1-Buchreihe) enthält.

2. Klicken Sie auf den Befehl "Buchreihe hinzufügen".

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

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

Nach der Installation einer Buchreihe müssen Sie den Dokumentationsserver neu starten. Klicken Sie dazu auf der Statusseite der Verwaltungsseite auf den Befehl "Neustart", oder geben Sie in der Befehlszeile folgendes ein:

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

Hinzufügen vorhandener Buchreihen

Der AnswerBook2-Server durchsucht Ihr aktuelles System, um lokal installierte AnswerBook1- und AnswerBook2-Buchreihen zu finden und diese zur Serverdatenbank hinzuzufügen. Damit der Server diese Funktion ausführen kann, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Lokal installierte Buchreihen suchen". Diese Funktion erstellt eine Liste aller im lokalen System gefundenen gültigen Buchreihen und zeigt sie an.

So fügen sie eine Buchreihe zur Serverdatenbank hinzu:

1. Klicken Sie auf das Kontrollkästchen neben der Buchreihe, die Sie hinzufügen möchten.

   Buchreihen ohne nebenstehendes Kontrollkästchen sind in der Datenbank bereits vorhanden.

2. Wenn Sie alle gewünschten Buchreihen ausgewählt haben, klicken Sie auf "Ausgewählte Buchreihen hinzufügen".

Falls in der Liste, die auf einem lokalen Mount-Point installierten Buchreihen nicht enthalten sind, überprüfen Sie, ob der Lesezugriff für das Verzeichnis, das die Buchreihen enthält, auf Andere eingestellt ist.

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

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

Die Befehlszeilenfunktion zum Durchsuchen fügt alle gefundenen Buchreihen hinzu; eine Auswahl der hinzuzufügenden Buchreihen ist nicht möglich.

Nach der Installation einer Buchreihe müssen Sie den Dokumentationsserver neu starten. Klicken Sie hierzu auf der Statusseite der AnswerBook2-Verwaltungsseite auf den Befehl "Neustart", oder geben Sie in der Befehlszeile folgendes ein:

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

Entfernen von AnswerBook2-Buchreihen

Um eine AnswerBook2- oder AnswerBook1-Buchreihe aus der Datenbank des Servers zu entfernen, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Buchreihe aus der Liste löschen". So entfernen Sie die Buchreihe:

1. Klicken Sie auf die Kontrollkästchen neben den Titeln der Buchreihen, die Sie aus der Buchreihenliste entfernen möchten. (Um Ihre Auswahl rückgängig zu machen, klicken Sie erneut auf das Kontrollkästchen.)

2. Wenn Sie alle gewünschten Buchreihen ausgewählt haben, klicken Sie auf "Buchreihe löschen".

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

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

Durch diese Funktionen werden die Buchreihen nicht aus dem System entfernt; es wird lediglich der entsprechende Eintrag aus der Datenbank des Servers entfernt. Um die Pakete aus dem System zu entfernen, verwenden Sie das Dienstprogramm pkgrm.

Nach dem Entfernen einer Buchreihe müssen Sie den Dokumentationsserver neu starten. Klicken Sie hierzu auf der Statusseite der AnswerBook2-Verwaltung auf den Befehl Neustart, or geben Sie in der Befehlszeile folgendes ein:

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

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

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

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.

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:

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

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:

• 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

Arbeiten mit anderen Dokumentationsservern

Wenn der Benutzer auf einen Link in einem Buch klickt, kann der AnswerBook2-Server diesem Link zu einem alternativen AnswerBook2-Server folgen. Wenn sich das Buch auf dem aktuellen Dokumentationsserver befindet, führt der Link zu dieser Position. Befindet sich das Buch dagegen nicht auf dem aktuellen Server, wird als AnswerBook2-Server ein beliebiger alternativer Dokumentationsserver verwendet, für den der Zugriff definiert wurde. Sie können diese Möglichkeit nutzen, um Dokumente auf mehrere Server zu verteilen oder um ein Backup Ihrer Dokumente zu erstellen.

Angeben alternativer Dokumentationsserver

Um eine Liste der definierten alternativen Server zu erhalten, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Liste der Alternativ-Server anzeigen". Eine Liste der zu diesem Zeitpunkt identifizierten Alternativ-Server wird angezeigt. Klickt ein Benutzer auf ein Link in einem Buch, das sich nicht auf dem aktuellen Server befindet, prüft AnswerBook2 die aufgelisteten Server, um das Ziel des Links zu finden. Der AnswerBook2-Server wird mit dem vordefinierten Alternativ-Server http://docs.sun.com/ geliefert. Dies ist der Master-Dokumentationsserver von Sun, auf dem sich die veröffentlichten Sun-Dokumentationen befinden.

Zu jedem für den aktuellen Server definierten Alternativserver zeigt diese Seite den Servernamen, seine Portnummer und ein Link zu der Liste mit den dort installierten Buchreihen an. Wenn Sie auf den Befehl "Liste der Buchreihen anzeigen" klicken, werden Sie zur Eingabe der Verwaltungs-ID und des Paßworts für den alternativen Server aufgefordert (sofern die Verwaltungszugriffssteuerung für den alternativen Server definiert wurde). Das bedeutet, daß Sie einen alternativen Server zwar ohne entsprechenden Verwaltungszugriff hinzufügen, die Liste der dort vorhandenen Buchreihen jedoch nur dann einsehen können, wenn Sie diese Zugriffsrechte besitzen.

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

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

Hinzufügen alternativer Dokumentationsserver

Um Ihren gegenwärtigen Serverzugriff auch auf Bücher zu erweitern, die sich auf einem anderen Server befinden (um den Links zwischen Büchern folgen zu können), wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl Alternativ-Server hinzufügen.

1. Geben Sie im Feld "AnswerBook2-Servername" den Namen des Alternativ-Servers ein.

2. Geben Sie im Feld "Server-Portnummer" die AnswerBook2-Portnummer des Alternativ-Servers ein. Wenn Ihnen die Portnummer nicht bekannt ist, geben Sie 8888 (die AnswerBook2-Standardportnummer) ein.

3. Klicken Sie auf den Befehl "Server hinzufügen".

   ---

   Hinweis -

   Befindet sich der Alternativ-Server, den Sie hinzufügen möchten, außerhalb des Netzwerks Ihrer Firma, können Sie ihn nicht möglicherweise nicht hinzufügen. Die Ursache hierfür ist häufig die "Firewall".

   ---

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

% /usr/lib/ab2/bin/ab2admin -o add_server -M add_Server_Name -P add_Server_Port 
[-m Server_Name] [-p Server_Port]

Entfernen zusätzlicher Dokumentationsserver

Um einen Server aus der Liste der Alternativ-Server zu entfernen, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Alternativ-Server löschen".

1. Wählen Sie den Server in der Server-Liste.

2. Klicken Sie auf den Befehl "Server löschen".

Dadurch wird der betreffende Server aus der Liste der alternativen Server für den lokalen Dokumentationsserver entfernt. Der aus der Liste entfernte Server ist jedoch weiterhin als Dokumentationsserver verfügbar.

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

% /usr/lib/ab2/bin/ab2admin -o del_server -M del_Server_Name -P del_Server_Port 
[-m Server_Name] [-p Server_Port]

Ändern der Reihenfolge der Alternativ-Server

Wenn Sie Ihrer Liste der verwendbaren Alternativ-Server einen neuen Server hinzufügen, wird dieser am Ende der Liste eingetragen. Durch diese Sortierung wird die Reihenfolge festgelegt, nach der Ihr Server beim Folgen von Dokumentenlinks auf die Alternativserver zugreift. Wenn ein Benutzer ein bestimmtes Dokument aus der Bibliothek abfragt, das auf dem Standardserver nicht vorhanden ist, geht dieser in der festgelegten Reihenfolge die Liste mit Alternativservern durch, um das Dokument zu finden.

Um die Reihenfolge der ihrem System zur Verfügung stehenden Server zu ändern, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Server-Reihenfolge ändern".

1. Wählen Sie einen Server in der Server-Liste.

2. Klicken Sie auf den Befehl "Nach oben verschieben" bzw. "Nach unten verschieben".

3. Klicken Sie auf den Befehl "Verschieben".

Diese Funktion kann nicht mittels Befehlszeileneingabe aufgerufen werden.

Arbeiten mit Serverberichten

Die AnswerBook2-Serversoftware verwaltet Protokolle, in denen Serverfehler und Serverzugriffe erfaßt werden. Außerdem wird ein zusammenfassender Bericht erstellt, der die Zugriffshäufigkeit auf die einzelnen Buchreihen und die Anzahl der aufgetretenen Fehler anzeigt.

Zusammenfassender Buchzugriffsbericht

Um eine Zusammenfassung der Buchzugriffe auf dem Server anzuzeigen, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Buchzugriffsbericht anzeigen". Der Buchzugriffsbericht enthält eine Zusammenfassung, aus der hervorgeht, wie oft auf die einzelnen Bücher auf dem Server zugegriffen wurde. Für jedes Buch auf dem Server werden folgende Parameter angezeigt:

• Buchtitel - Der Buchtitel, wie er auf der Bibliotheksseite vermerkt ist

• Buchname - Der verkürzte Name des Buchs, wie er in dessen Konfigurationsdatei angegeben ist

• Buchreihenname - Der Kurzname der Buchreihe, zu der dieses Buch gehört, wie er in der Datei collinfo angegeben ist

• Treffer - Anzahl der Zugriffe auf das Buch

• Fehler - Anzahl der im Zusammenhang mit dem Buch aufgetretenen Fehler

Zugriffsprotokolldateien

Um die Zugriffsprotokollierung ein- oder auszuschalten, wählen Sie auf der -Verwaltungsseite den Befehl "Serverkonfiguration ändern".

• Wenn in der Zugriffsprotokolldatei aufgezeichnet werden soll, wer auf die Informationen des Dokumentationsservers zugreift, klicken Sie auf die Schaltfläche neben "Ein" und danach auf "Zuweisen". Standardmäßig ist diese Datei unter /var/log/ab2/logs/access-8888.log abgelegt.

• Um das Schreiben von Informationen in die Zugriffsprotokolldatei zu unterdrücken, klicken Sie auf die Schaltfläche neben "Aus" und danach auf "Zuweisen".

Zum Ausführen dieser Funktionen können Sie auch folgende Befehle eingeben:

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

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

Nach dem Ändern der Protokollfunktion müssen Sie den Dokumentationsserver anhalten und neu starten. 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

Anzeigen des Zugriffsprotokolls

Um die Zugriffsprotokolldatei anzuzeigen, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Protokolldateien anzeigen", und klicken Sie anschließend auf "Zugriffsprotokolldatei anzeigen". Bei der Zugriffsprotokolldatei handelt es sich um eine Textdatei, die alle Zugriffe auf den Server auflistet. Alle Zeilen des Zugriffsprotokolls sind nach folgendem Schema aufgebaut:

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

Erläuterung:

• Die erste Ziffernfolge ist die IP-Adresse (Internet Protocol) des Clients. Beispiel: 129.146.83.55.

• Die Information in eckigen Klammern gibt Datum und Uhrzeit des Zugriffs an. Beispiel: [04/Nov/1996:15:07:05 -0800] .

• Die Information in Anführungszeichen zeigt die Art des Zugriffs an. In der Regel werden dort der URL oder ein Dateiname sowie das für die Reaktion auf die Zugriffsanforderung verwendete Protokoll angegeben. Beispiel: "GET /icons/ab2_curr_home.gif HTTP/1.0" zeigt, daß auf die Datei /icons/ab2_curr_home.gif unter Verwendung des HTTP-1.0-Protokolls zugegriffen wurde.

• Die vorletzte Zahl gibt Auskunft über den Erfolg (200) oder Mißerfolg (alle anderen Werte) des Zugriffs.

• Die letzte Zahl gibt die Gesamtgröße (in KB) der an den Abfrager übermittelten Informationen an. Beispiel: 1938 ist die Größe der abgerufenen .gif-Datei.

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

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

Fehlerprotokolldateien

Um die Fehlerprotokollierung ein- oder auszuschalten, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Serverkonfiguration ändern".

• Wenn Informationen über die auf dem Dokumentationsserver aufgetretenen Fehler in der Fehlerprotokolldatei aufgezeichnet werden sollen, klicken Sie auf die Schaltfläche neben aktiviert und danach auf "Zuweisen". Standardmäßig ist diese Datei unter /var/log/ab2/logs/errors-8888.log abgelegt.

• Um das Schreiben von Informationen in die Fehlerprotokolldatei zu unterdrücken, klicken Sie auf die Schaltfläche neben deaktiviert und danach auf Zuweisen.

Zum Ausführen dieser Funktionen können Sie auch folgende Befehle eingeben:

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

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

Nach dem Ändern der Protokollfunktion müssen Sie den Dokumentationsserver anhalten und neu starten. Melden Sie sich am Gerät des Dokumentationsservers als root an, und geben Sie folgende Befehle ein:

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

Anzeigen des Fehlerprotokolls

Um die Fehlerprotokolldatei anzuzeigen, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Protokolldateien anzeigen", und klicken Sie danach auf "Fehlerprotokolldatei anzeigen". In der Fehlerprotokolldatei sind alle auf dem Dokumentationsserver aufgetretenen Fehler verzeichnet. Mit Hilfe dieser Informationen können Sie die Ursache eines Serverproblems oder eines ungewöhnlichen Verhaltens feststellen. Im Zusammenhang mit diesen Fehlern werden in der Regel Server und Port für den aufgetretenen Fehler sowie ein beschreibender Text angegeben.

Zum Ausführen dieser Funktion können Sie auch den folgenden Befehl eingeben:

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

Umstellen von Fehlerprotokolldateien

Sie können das aktuelle Zugriffs- oder Fehlerprotokoll in einer Datei speicher und ein neues Protokoll in einer neuen Datei starten.

• Um das Fehlerprotokoll umzustellen, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Fehlerprotokolldatei umstellen".

• Um das Zugriffsprotokoll umzustellen, wählen Sie auf der AnswerBook2-Verwaltungsseite den Befehl "Zugriffsprotokolldatei umstellen".

Auf der Seite für das Umstellen des Zugriffs- bzw. Fehlerprotokolls gehen Sie wie folgt vor:

1. Geben Sie im Feld "Protokolldatei speichern" den Namen der Datei ein, in der das Protokoll gespeichert werden soll.

   Aktuelles_Datum hat das Format JahrJahrJahrJahr_MonatMonat_TagTag_StundeStunde ; Aktueller_Protokolldateiname lautet standardmäßig access-8888 oder error-8888 (Beispiel: 1997_02_26_14.access-8888.log).

   Beachten Sie, daß im Feld "Protokolldatei-Speicherort" die Stelle angegeben ist, an der die Datei gespeichert wurde. Die Angaben können auf dieser Seite nicht geändert werden.

2. Klicken Sie auf "Zuweisen".

Nach dem Ändern der Protokollfunktion müssen Sie den Dokumentationsserver anhalten und neu starten. 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

Zum Ausführen dieser Funktionen können Sie auch folgende Befehle eingeben:

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

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

Allgemeine Navigationsfunktionen der Verwaltungsseite

Am oberen Rand der AnswerBook2-Seiten sind allgemeine Navigationsfunktionen aufgeführt. Was passiert, wenn Sie diese Funktionen auf den Verwaltungsseiten wählen, ist in der Tabelle unten beschrieben.

Auf vielen Verwaltungsseiten gelangen Sie durch Klicken auf das Symbol zur AnswerBook2-Hauptverwaltungsseite.