Standardmäßig wird der AnswerBook2-Dokumentationsserver als NSAPI-Plugin oberhalb des im Software-Paket SUNWab2u enthalten httpd-Servers ausgeführt. Da der AnswerBook2-Server mit den standardmäßigen Web-Protokollen kompatibel ist, können Sie den Dokumentationssserver auch als CGI-Prozeß (Common Gateway Interface) oberhalb anderer bereits auf ihrem System ausgeführten Web-Server ausführen (z.B. Netscape Server oder Sun Web Server).
Beachten Sie, daß die nachstehenden Funktionen nicht verfügbar sind, wenn Sie nicht den standardmäßigen Web-Server von AnswerBook2 verwenden:
/usr/lib/ab2/bin/ab2admin -o start
/usr/lib/ab2/bin/ab2admin -o stop
/etc/init.d/ab2mgr start
/etc/init.d/ab2mgr stop
restart von der Admin-GUI
Da sich spezifische Details für die einzelnen Web-Server unterschieden, werden nachstehend nur die allgemeinen Schritte beschrieben, die erforderlich sind, um einen CGI-basierenden Web-Server anstelle des standardmäßigen Servers (NSAPI-Plugin) zu verwenden. Weiter unten finden Sie spezifische Beispiele für Sun Web-Server und Netscape Server.
Fahren Sie den AnswerBook2-Server herunter, falls dieser ausgeführt wird.
Verwenden Sie einen der folgenden Befehle:
# /usr/lib/ab2/bin/ab2admin -o stop # /etc/init.d/ab2mgr stop |
Bearbeiten Sie die Konfigurationsdatei Ihres Web-Servers, und machen Sie Symbole verfügbar.
Informationen über den Speicherort der Konfigurationsdatei und andere spezifische Details finden Sie in der Dokumentation Ihres Web-Servers. Der Eintrag /icons/ darf nicht 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/.
Verknüpfen Sie die Hilfedokumente von AnswerBook2 mit dem aktuellen Root-Verzeichnis für die Dokumentation.
Wechseln Sie zum Root-Verzeichnis für die Dokumentation Ihres Servers und erstellen Sie einen Verweis auf /usr/lib/ab2/data/docs/.
Machen Sie die cgi-bin-Dateien von AnswerBook2 für Ihren Server verfügbar.
Wechseln Sie in das Verzeichnis cgi-bin Ihres Web-Servers und erstellen Sie Soft-Links auf die folgenden Objekte:
/usr/lib/ab2/bin/cgi/admin /usr/lib/ab2/bin/cgi/nph-dweb /usr/lib/ab2/bin/cgi/gettransbitmap /usr/lib/ab2/bin/cgi/getepsf /usr/lib/ab2/bin/cgi/getframe /usr/lib/ab2/bin/cgi/ab2srwrap |
Bearbeiten Sie die Konfigurationsdatei Ihres Web-Servers, und ordnen Sie /ab2/ zum Aufruf von AnswerBook2 cgi zu.
Informationen über den Speicherort der Konfigurationsdatei und andere spezifische Details finden Sie in der Dokumentation Ihres Web-Servers. Sie müssen den Eintrag für /ab2/ in /usr/lib/ab2/bin/cgi/nph-dweb/ab2/ ändern.
Bearbeiten Sie die Verwaltungskonfigurationsdatei von AnswerBook2.
Bearbeiten Sie hierzu die Datei /usr/lib/ab2/bin/cgi/nph-dweb, und ändern Sie die Einträge für servertype, errorlog und accesslog.
Die standardmäßige Konfigurationsdatei für den Sun Web Server ist /etc/http/httpd.conf. Die Dateien befinden sich in /var/http/demo/. Falls Sie nicht an der Standardposition (/usr/) installiert haben, sind alle mit /usr/lib/ab2/ beginnenden Pfade der Pfad, in dem die Dateien installiert wurden (z.B. /usr2/lib/ab2/).
Bearbeiten Sie die Datei /etc/http/httpd.conf, und fügen Sie im Abschnitt server die folgende Zeile ein:
map /icons /usr/lib/ab2/data/docs/icons |
Starten im Anschluß an diese Änderung den SWS-Server erneut:
# /etc/init.d/httpd start |
Prüfen Sie, ob die Änderungen ordnungsgemäß durchgeführt wurden. Geben Sie hierzu den folgenden URL ein, um ein Hilfesymbol aufzurufen:
http://localhost:port/icons/ab2_help.gif |
Hierbei bezeichnet port die Nummer des Anschlusses, auf dem Ihr Dokumentationsserver ausgeführt wird. Standardmäßig ist dies 8888.
Wechseln Sie zum Verzeichnis /var/http/demo/public/ und geben Sie folgende Soft-Link ein:
# ln -s /usr/lib/ab2/data/docs/Help Help |
Prüfen Sie, ob die Änderungen ordnungsgemäß durchgeführt wurden. Geben Sie hierzu den folgenden URL ein, um ein Hilfesymbol aufzurufen:
http://localhost:port/Help/C/Help/books/Help/figures/ab2_help.gif |
Hierbei bezeichnet port die Nummer des Anschlusses, auf dem Ihr Dokumentationsserver ausgeführt wird. Standardmäßig ist dies 8888.
Wechseln Sie zum Verzeichnis /var/http/demo/cgi-bin/, und erstellen Sie die folgenden Soft-Links:
# ln -s /usr/lib/ab2/bin/cgi/admin # ln -s /usr/lib/ab2/bin/cgi/nph-dweb # ln -s /usr/lib/ab2/bin/cgi/gettransbitmap # ln -s /usr/lib/ab2/bin/cgi/getepsf # ln -s /usr/lib/ab2/bin/cgi/getframe # ln -s /usr/lib/ab2/bin/cgi/ab2srwrap |
Prüfen Sie, ob die Änderungen ordnungsgemäß durchgeführt wurden. Geben Sie hierzu den folgenden URL ein, um die Bibliotheksseite von AnswerBook2 aufzurufen:
http://localhost:port/cgi-bin/nph-dweb/ab2 |
Hierbei bezeichnet port die Nummer des Anschlusses, auf dem Ihr Dokumentationsserver ausgeführt wird. Standardmäßig ist dies 8888.
Bearbeiten Sie die Datei /etc/http/httpd.conf, und fügen Sie im Host-Abschnitt den folgenden Eintrag ein:
map /ab2 /var/http/demo/cgi-bin/nph-dweb/ab2 cgi |
Starten Sie den SWS-Server mit dem nachstehenden Befehl erneut:
# /etc/init.d/httpd start |
Prüfen Sie, ob die Änderungen ordnungsgemäß durchgeführt wurden. Geben Sie hierzu den folgenden URL ein, um die Bibliotheksseite von AnswerBook2 aufzurufen:
http://localhost:port/ab2 |
Hierbei bezeichnet port die Nummer des Anschlusses, auf dem Ihr Dokumentationsserver ausgeführt wird. Standardmäßig ist dies 8888.
Bearbeiten Sie die Datei /usr/lib/ab2/bin/cgi/nph-dweb, und ändern Sie darin die folgenden Einträge:
setenv servertype sws setenv errorlog setenv accesslog /var/http/logs/http.elf.1 |
Bei diesem Beispiel ist die Konfigurationsdatei von Netscape Server /ul/netscape/suitespot/httpd-threads1/config/obj.conf, und die Dateien befinden sich in /ul/netscape/suitespot/docs/. Falls Sie nicht an der Standardposition (/usr/) installiert haben, sollten alle mit /usr/lib/ab2/ beginnenden Pfade der Pfad sein, in dem Sie die Dateien installiert haben (z.B. /usr2/lib/ab2/).
Bearbeiten Sie die Datei /ul/netscape/suitespot/httpd-threads1/config/obj.conf, und fügen Sie die folgende Zeile ein:
NameTrans fn="pfx2dir" from="/icons" dir="/usr/lib/ab2/data/docs/icons" |
Um Ihre Änderungen zu überprüfen, starten Sie den Netscape Server erneut. Geben Sie dann den folgenden URL in Ihrem Web-Browser ein, um ein Hilfesymbol anzuzeigen:
http://localhost:port/icons/ab2_help.gif |
Wechseln Sie zum Verzeichnis /ul/netscape/suitespot/docs/ und geben Sie die folgende Soft-Link ein:
# ln -s /usr/lib/ab2/data/docs/Help Help |
Prüfen Sie, ob die Änderungen ordnungsgemäß durchgeführt wurden. Geben Sie hierzu den folgenden URL ein, um ein Hilfesymbol aufzurufen:
http://localhost:port/Help/C/Help/books/Help/figures/ab2_help.gif |
Hierbei bezeichnet port die Nummer des Anschlusses, auf dem Ihr Dokumentationsserver ausgeführt wird. Standardmäßig ist dies 8888.
Wechseln Sie zum Verzeichnis /ul/netscape/suitespot/cgi-bin/, und erstellen Sie die folgenden Soft-Links:
# ln -s /usr/lib/ab2/bin/cgi/admin # ln -s /usr/lib/ab2/bin/cgi/nph-dweb # ln -s /usr/lib/ab2/bin/cgi/gettransbitmap # ln -s /usr/lib/ab2/bin/cgi/getepsf # ln -s /usr/lib/ab2/bin/cgi/getframe # ln -s /usr/lib/ab2/bin/cgi/ab2srwrap |
Prüfen Sie, ob die Änderungen ordnungsgemäß durchgeführt wurden. Geben Sie hierzu den folgenden URL ein, um die Bibliotheksseite von AnswerBook2 aufzurufen:
http://localhost:port/cgi-bin/nph-dweb/ab2 |
Hierbei bezeichnet port die Nummer des Anschlusses, auf dem Ihr Dokumentationsserver ausgeführt wird. Standardmäßig ist dies 8888.
Bearbeiten Sie die Datei /ul/netscape/suitespot/httpd-threads1/config/obj.conf, und fügen Sie den folgenden Eintrag ein:
NameTrans fn="pfx2dir" from="/ab2" dir="/ul/netscape/suitespot/cgi-bin/nph-dweb/ab2" name="cgi" |
Um Ihre Änderungen zu prüfen, starten Sie den Netscape-Server erneut und geben in Ihrem Web-Browser den nachstehenden URL ein, um die Bibliotheksseite von AnswerBook2 anzuzeigen:
http://localhost:port/ab2 |
Hierbei bezeichnet port die Nummer des Anschlusses, auf dem Ihr Dokumentationsserver ausgeführt wird Standardmäßig ist dies 8888.
Bearbeiten Sie die Datei /usr/lib/ab2/bin/cgi/nph-dweb, und ändern Sie darin die folgenden Einträge:
setenv servertype netscape setenv errorlog /ul/netscape/suitespot/httpd-threads1/logs/errors setenv accesslog /ul/netscape/suitespot/httpd-threads1/logs/access |