test

Installation und Verwaltung eines AnswerBook2-Servers

Ausführen des AnswerBook2-Servers als CGI-Prozeß

In der Standardeinstellung wird der AnswerBook2-Dokumentationsserver als NSAPI-Plugin auf dem httpd-Server ausgeführt, der im SUNWab2u -Paket enthalten ist. Da der AnswerBook2-Server mit den Standardprotokollen des Web kompatibel ist, kann der Dokumentationsserver auch als CGI-Prozeß (Common Gateway Interface) über einen anderen Web-Server ausgeführt werden (z. B. Netscape Server oder Sun Web Server).

Hinweis -

Eine Änderung der Servereinstellungen auf dieser Ebene setzt umfassende Kenntnisse über das Web voraus. Führen Sie diese Änderungen nur dann durch, wenn Sie die Konfiguration und die spezifischen Anforderungen Ihres Web-Servers detailliert kennen.

Beachten Sie, daß die folgenden Funktionen bei Abweichung vom standardmäßigen AnswerBook2-Web-Server nicht ausführbar sind:

Sie müssen statt dessen die Start- und Stop-Funktionen des Servers verwenden.

Wechsel zu einem Server auf CGI-Basis
Hinweis -

Aufgrund der rasanten Entwicklung in der Web-Server-Technologie können an dieser Stelle nicht alle möglichen Konfigurationen von Web-Servern dokumentiert werden. Daher soll das folgende allgemeine Verfahren lediglich als Richtlinie dienen. Bevor Sie dieses Verfahren anwenden, müssen Sie die Konfiguration und spezifischen Anforderungen Ihres Web-Browsers detailliert kennen.

Das Verfahren beschreibt die allgemeinen Schritte, die Sie für den Einsatz eines Web-Servers auf CGI-Basis an Stelle des Standardservers (NSAPI-Plugin) ausführen müssen.

  1. Deaktivieren Sie den automatischen Startvorgang des AnswerBook2-Servers beim erneuten Booten des Systems.

    Verwenden Sie hierfür auf der AnswerBook2-Verwaltungsseite die Seite "Serverkonfiguration ändern", oder geben Sie folgenden Befehl ein:


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

  2. Schalten Sie die Verwaltungszugriffssteuerung für den Standard-Dokumentationsserver aus.

    Führen Sie folgenden Befehl aus: 


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

  3. Fahren Sie den AnswerBook2-Server herunter, falls er ausgeführt wird.

    Verwenden Sie einen der folgenden Befehle:


    # /usr/lib/ab2/bin/ab2admin -o stop
# /etc/init.d/ab2mgr stop

  4. Bearbeiten Sie die Konfigurationsdatei des Servers, und stellen Sie die Programmsymbole bereit.

    Detailangaben, wie z. B. zum Auffinden der Konfigurationsdatei, finden Sie in der Dokumentation Ihres Servers. Der Eintrag /icons/ muß auf /usr/lib/ab2/data/docs/icons/ verweisen.

    Wenn /icons/ bereits verwendet wird, verknüpfen Sie alle Dateien in /usr/lib/ab2/data/docs/icons/ mit dem vorhandenen Verzeichnis /icons/.

    Nach dem Ausführen dieser Änderung starten Sie den Server erneut.

    Zum Überprüfen der Änderungen geben Sie folgenden URL in Ihrem Web-Browser ein, so daß ein Hilfesymbol angezeigt wird:


    http://localhost:port/icons/ab2_help.gif

    Erläuterung: Port gibt die Port-Nummer des Dokumentationsservers an.

  5. Verknüpfen Sie die AnswerBook2-Hilfedokumente mit der aktuellen Dokument-Root.

    Wechseln Sie in das Root-Verzeichnis des Web-Servers, und erstellen Sie einen symbolischen Link zu /usr/lib/ab2/data/docs/Help/.

    Zum Überprüfen der Änderungen geben Sie folgenden URL in Ihrem Web-Browser ein, so daß ein Hilfesymbol angezeigt wird: :


    http://localhost:port/Help/C/Help/books/AB2ADMIN/figures/ab2_help.gif

    Erläuterung: Port gibt die Port-Nummer des Dokumentationsservers an.

  6. Stellen Sie dem Server die AnswerBook2-cgi-Dateien zur Verfügung.

    Wechseln Sie in das Verzeichnis cgi-bin des Web-Servers, und erstellen Sie symbolische Links zu den folgenden Zielen:


    /usr/lib/ab2/bin/ab2bin/admin
/usr/lib/ab2/bin/ab2bin/nph-dweb
/usr/lib/ab2/bin/ab2bin/gettransbitmap
/usr/lib/ab2/bin/ab2bin/getepsf
/usr/lib/ab2/bin/ab2bin/getframe

    Zum Überprüfen der Änderungen rufen Sie im Web-Browser mit folgendem URL die AnswerBook2-Bibliotheksseite auf:


    http://localhost:port/cgi-bin/nph-dweb/ab2

    Erläuterung: Port gibt die Port-Nummer des Dokumentationsservers an.

  7. Bearbeiten Sie die Konfigurationsdatei des Servers, und ordnen Sie /ab2/ so zu, daß die AnswerBook2-Datei cgi aufgerufen wird.

    Detailangaben, wie z. B. zum Auffinden der Konfigurationsdatei, finden Sie in der Dokumentation Ihres Servers. Der Eintrag für /ab2/ muß zu /usr/lib/ab2/bin/ab2bin/nph-dweb/ab2/ geändert werden.

    Zum Überprüfen der Änderungen starten Sie den Server erneut und rufen im Web-Browser mit folgendem URL die AnswerBook2-Bibliotheksseite auf:


    http://localhost:port/ab2

    Erläuterung: Port gibt die Port-Nummer des Dokumentationsservers an.

  8. Wenn Benutzer die Möglichkeit haben sollen, auf den Dokumentationsserver ohne die Spezifizierung von /ab2 am Ende des URL zugreifen zu können, ändern Sie Konfigurationsdatei des Servers, und geben Sie die Zuordnung / zu /ab2/ ein.

    Detailangaben, wie z. B. zum Auffinden der Konfigurationsdatei, finden Sie in der Dokumentation Ihres Servers. Sie müssen den Eintrag für / zu /ab2/ ändern und zur Zuordnung ein remote-Flag hinzufügen.

    Zum Überprüfen der Änderungen starten Sie den Server erneut und rufen im Web-Browser mit folgendem URL die AnswerBook2-Bibliotheksseite auf:


    http://localhost:port

    Erläuterung: Port gibt die Port-Nummer des Dokumentationsservers an.

  9. Bearbeiten Sie die Konfigurationsdatei für die AnswerBook2-Verwaltung.

    Die Datei /usr/lib/ab2/bin/ab2bin/nph-dweb muß bearbeitet und die Einträge für servertype, errorlog und accesslog müssen geändert werden.


    setenv servertype server_type
setenv errorlog kompletter_pfad_zum_fehlerprotokoll
setenv accesslog kompletter_pfad_zum_zugriffsprotokoll

    Erläuterung:

    • server_type identifiziert den Server, den Sie ausführen, zum Beispiel sws.

    • kompletter_pfad_zum_fehlerprotokoll ist der Pfad zum Fehlerprotokoll Ihres Web-Servers.

    • kompletter_pfad_zum_zugriffsprotokoll ist der Pfad zum Zugriffsprotokoll Ihres Web-Servers.

  10. Richten Sie eine Zugriffssteuerung zur AnswerBook2-Verwaltungsoberfläche ein.

    Um die Ausführung von Verwaltungsfunktionen auf dem Dokumentationsserver zu kontrollieren, beschränken Sie mit Hilfe der entsprechenden Steuerung Ihres HTTP-Servers den Zugriff auf folgenden URL: /ab2/@Ab2Admin