Dieser Abschnitt beschreibt, welche Voraussetzungen Sie erfüllen und welche Entscheidungen Sie treffen müssen, bevor Sie die AnswerBook2 Server-Software installieren können.
Dieser Abschnitt gilt nur für Verwalter von AnswerBook2-Serversystemen. Benutzer, die sich Online-Dokumentationen lediglich anzeigen lassen, brauchen diesen Abschnitt nicht zu lesen. Der Betrieb eines AnswerBook2-Client erfordert keine besonderen Installationsmaßnahmen.
Für dieses Produkt gibt es keine Zugriffssteuerung auf Client-Ebene. Wenn ein Client auf den URL eines Dokumentationsservers zugreifen kann, kann er auch die auf dem Server gespeicherten Dokumente anzeigen.
Dieser Abschnitt behandelt folgende Themen:
Detaillierte Informationen über die Verwaltung eines Dokumentationsservers finden Sie in der Online-Hilfe, auf die Sie nach der Installation der Dokumentationsserver-Software über die AnswerBook2-Schnittstelle zugreifen können.
Bevor Sie mit der Installation beginnen, müssen Sie prüfen, ob Ihr System die unter "Hardware-- und Softwarevoraussetzungen" beschriebenen Voraussetzungen erfüllt, und entscheiden, wo Sie die Software installieren wollen (siehe "Installationseinstellungen".
Vergewissern Sie sich vor dem Beginn der Installation, daß die Systeme, auf denen Sie die Serversoftware von AnswerBook2 installieren möchten, die an folgenden Stellen aufgelisteten Hard- und Softwarevoraussetzungen erfüllt: Tabelle 9-2 und Tabelle 9-3.
Tabelle 9-2 Hardware-- und Softwarevoraussetzungen
Komponente |
Voraussetzung |
---|---|
Hardware des Dokumentservers |
SPARCstationTM 2 oder höher (SPARCstation 5 empfohlen) Intel-PC |
Betriebssystemumgebung |
Solaris 7 (für SPARC oder x86, je nach Hardware) |
Admin GUI und AnswerBook2-Client-Viewer |
Beliebiger Browser mit Unterstützung von HTML 3.2 (z.B. Netscape Navigator, HotJava oder Lynx) |
Tabelle 9-3 Erforderliche Festplattenkapazität
Verzeichnispfad |
Beschreibung |
Speicherbedarf |
---|---|---|
/usr/lib/ab2/ |
Enthält ausführbare Dateien, Server-Prozeßdateien, Bilbiotheksdateien sowie Quelldateien für Grafiken und Dokumente für die Benutzeroberfläche. |
26 MByte |
/var/log/ab2/ |
Enthält Katalogdateien und Protokolldateien, falls Protokollfunktionen aktiviert sind. |
5 MByte (empfohlen - der Speicherbedarf steigt bei der Nutzung des Servers) |
/etc/init.d/ab2mgr |
Server-Startdatei |
0,01 MByte |
Zusätzlich benötigen Sie noch genügend Festplattenkapazität für die eigentlichen Buchdateien (empfohlen werden 600 MByte). Der genaue Platzbedarf hängt dabei von der jeweiligen Buchreihe ab. Ein Verzeichnis der auf der Solaris 7 Documentation CD gespeicherten Buchreihen finden Sie in der README-Datei dieser CD.
Bevor Sie die AnswerBook2 Server-Software installieren, müssen Sie entscheiden, wie die Installation erfolgen soll:
Installation aller Komponenten auf einem System
Die Serversoftware von AnswerBook2 und die Solaris 7-Buchreihen befinden sich auf der Solaris 7 Documentation CD. Wenn Sie beide Komponenten auf einem System installieren und nach Beendigung der Installation den Server starten, kann dieser alle Clients mit Dokumenten bedienen. Siehe "Die AnswerBook2-Serversoftware installieren".
Installation von Server und Dokumentation auf getrennten Systemen
Sie können die Software für den Dokumentationsserver auf einem System installieren und dort einen Verweis auf die Buchreihen einrichten, die sich auf einem anderen System befinden. Diese Aufteilung ist z.B. sinnvoll, wenn die Speicherkapazität des Server-Systems begrenzt ist oder wenn Dokumentationsreihen bereits auf einem anderen System installiert sind. Hierzu müssen Sie alle Dokumentationsreihen manuell in die Datenbank des Servers und aufnehmen. Andernfalls kann die Funktion Lokal installierte Buchreihen suchen diese Buchreihen nicht finden. Siehe "Die AnswerBook2-Serversoftware installieren".
Ausführen eines Servers direkt von CD
Wenn Sie mit einem Einzelplatzsystem arbeiten, das nicht an ein Netzwerk angeschlossen ist, oder wenn Sie nur gelegentlich auf die Online-Dokumentation zugreifen, können Sie den AnswerBook2-Server auch direkt von der Solaris 7 Documentation CD-CD aus starten. Bei direkter Ausführung von CD ist die Ausführungsgeschwindigkeit des Dokumentationsservers geringer als bei Installation auf der Festplatte des Systems. Verwenden Sie dieses Verfahren nicht, wenn außer Ihnen auch noch andere Benutzer auf den Dokumentationsserver zugreifen möchten. Weitere Informationen finden Sie im Abschnitt "Einen Dokumentationsserver direkt von der Solaris 7 Documentation CD ausführen".
Die Installation der Software für den Dokumentationsserver kann wahlweise über die grafische Schnittstelle des Dienstprogramms Solaris Web StartTM oder über Standard-Installationsprogramme wie z.B.pkgadd durchgeführt werden.
Legen Sie die Solaris 7 Documentation CD in Ihr CD-ROM-Laufwerk ein.
Die CD wird vom Volume Manager automatisch eingehängt.
Wenn Sie zur Installation das Dienstprogramm Solaris Web Start verwenden, doppelklicken Sie auf das Installer-Symbol, befolgen Sie die Bildschirmanweisungen von Web Start und fahren Sie danach mit Schritt 6 fort.
Das Dienstprogramm Web Start bietet vorausgewählte Gruppen von Packages an, die installiert werden können. Befolgen Sie Bildschirmanweissungen von Web Start, um mit der Installation forzufahren.
Wenn Sie die Installation mit einem der Dienstprogramme pkgadd oder swmtool durchführen möchten, melden Sie sich als Superuser an den Dokumentationsserver an.
Hierzu geben Sie beispielsweise an der Befehlszeile folgendes ein:
% su - |
Wechseln Sie zum Verzeichnis, in dem sich die Dokumentationsserver-Packages befinden.
Bei einem SPARC-Server verwenden Sie hierzu beispielsweise den nachstehenden Befehl:
# cd cdrom/Solaris_2.7_Doc/sparc/Product/ |
Hierbei bezeichnet cdrom den Einhängepunkt für das CD-ROM-Laufwerk. Standardmäßig ist dies /cdrom/sol_2_7_doc
Starten Sie das Installationsprogramm, und wählen Sie die gewünschten Serversoftware-Packages aus.
Zum Aufruf des Dienstprogramms pkgadd verwenden Sie beispielsweise folgenden Befehl:
# pkgadd -d . |
Wählen Sie folgende Serversoftware-Packages aus:
SUNWab2r (0,25 MByte) - Konfigurations- und Startdateien, die auf der Root-Partition installiert werden.
SUNWab2s (1,00 MByte) - Gemeinsame Dateien zur Durchführung der Dokumentverarbeitung.
SUNWab2u (26,00 MByte) - Ausführbare Dateien und Backend-Verarbeitungsdateien für Server- und Verwaltungsfunktionen.
Starten Sie den Server, falls nötig.
Die Installation der Packages sollte den Start des Servers am Standardanschluß 8888 auslösen. Wenn das nicht der Fall ist, geben Sie den folgenden Startbefehl ein:
# /usr/lib/ab2/bin/ab2admin -o start |
Installieren Sie die Buchreihen.
Ihr Dokumentserver tritt erst dann in Funktion, wenn Dokumente installiert sind, die verfügbar gemacht werden sollen. Buchreihen können entweder von der Solaris 7 Documentation CD oder von anderen Orten aus installiert werden, etwa von vorhandenen Buchreihen oder Buchreihen auf anderen CDs. Weitere Informationen zur Installation von Buchreihen finden Sie unter "Buchreihen auf dem Server installieren".
(Optional) Ändern Sie die Konfigurationsdateien und erstellen Sie Verweise, um den Dokumentationsserver als CGI-Prozeß auf einem vorhandenen httpd-Server auszuführen.
Wenn bereits ein httpd-Server auf Ihrem System ausgeführt wird, können Sie darauf den Dokumentationsserver als CGI-Prozeß ausführen. Sie müssen die standardmäßige Dokumentationsserver-Software installieren, danach verschiedene Konfigurationdateien anpassen und Verweise erstellen, um den Dokumentationsserver als CGI-Prozeß auszuführen. Weitere Informationen finden Sie im unter "Ausführen des AnswerBook2-Servers als CGI-Prozeß".
(Optional) Registrieren Sie den Server.
Wenn es anderen Benutzern möglich sein soll, Ihren Dokumentserver automatisch über Federated Naming Service (FNS) zu finden, muß der Server registriert werden. Mit dem folgenden Befehl registrieren Sie Ihren Server:
# /usr/lib/ab2/bin/ab2regsvr server_url |
Dabei bezeichnet server_url den vollständigen URL für den Zugriff auf den Server (z.B.: http://imaserver.eng.sun.com:8888/). Siehe "Server-Registrierung".
Ihr Dokumentserver tritt erst dann in Funktion, wenn Dokumente installiert sind, die verfügbar gemacht werden sollen. Buchreihen können entweder von der Solaris 7 Documentation CD oder von anderen Orten aus installiert werden, etwa von vorhandenen Buchreihen oder Buchreihen auf anderen CDs.
Um Buchreihen-Packages von der Solaris 7 Documentation CD zu installieren, können Sie entweder die grafische Schnittstelle des Dienstprogramms Solaris Web Start oder Standard-Installationsprogramme wie beispielsweise pkgadd verwenden. Buchreihen installieren:
Legen Sie die Solaris 7 Documentation CD in Ihr CD-ROM-Laufwerk ein.
Die CD wird vom Volume Manager automatisch eingehängt.
Wenn Sie zur Installation das Dienstprogramm Solaris Web Start verwenden, doppelklicken Sie auf das Installer-Symbol, befolgen Sie die Bildschirmanweisungen von Web Start und fahren Sie danach mit Schritt 6 fort.
Das Dienstprogramm Web Start bietet vorausgewählte Gruppen von Packages an, die installiert werden können. Befolgen Sie die Bildschirmanweissungen von Web Start, um mit der Installation forzufahren.
Wenn Sie die Installation mit einem der Dienstprogramme pkgadd oder swmtool durchführen möchten, melden Sie sich als Superuser an den Dokumentationsserver an.
Hierzu geben Sie beispielsweise an der Befehlszeile folgendes ein:
% su - |
Wechseln Sie zum Verzeichnis, in dem sich die Dokumentationsserver-Packages befinden.
Beispiel:
# cd cdrom/Solaris_2.7_Doc/common/Product/ |
Hierbei bezeichnet cdrom den Einhängepunkt für das CD-ROM-Laufwerk. Standardmäßig ist dies /cdrom/sol_2_7_doc.
Starten Sie das Installationsprogramm, und wählen Sie die Serversoftware-Packages aus, die Sie installieren möchten.
Zum Aufruf des Dienstprogramms pkgadd verwenden Sie beispielsweise folgenden Befehl:
# pkgadd -d . |
Eine detaillierte Liste der auf der Solaris 7 Documentation CD gespeicherten Buchreihen finden Sie in der README-Datei dieser CD.
Die Buchreihen-Packages auf der Solaris 7 Documentation CD enthälten ein Skript zur nachträglichen Installation, um die Buchreihe in die Datenbank des Servers aufzunehmen und den Server erneut zu starten.
Um Buchreihen-Packages von anderen Orten als der Solaris 7 Documentation CD zu installieren, müssen Sie entweder die Funktion Buchreihen zur Liste hinzufügen der Admin-GUI oder den Befehl ab2admin -o add_coll ausführen, um diese Reihen in die Datenbank des Dokumentationsservers aufzunehmen.
Wenn auf Ihrem System bereits Buchreihen installiert sind, können Sie entweder den Befehl Lokal installierte Buchreihen suchen der Admin-GUI oder den Befehl ab2admin -o scan verwenden, um diese zu suchen und in die Datenbank des Dokumentationsservers aufzunehmen. Diese Funktion kann nur für lokal installierte Packages eingesetzt werden.
Um Buchreihen verfügbar zu machen, die sich auf einem anderen System befinden, verwenden Sie die Funktion Buchreihen zur Liste hinzufügen oder den Befehl ab2admin -o add_coll und geben den vollständigen Pfadnamen ab_cardcatalog oder collinfo an. Wenn der Dokumentationsserver beispielsweise imaserver heißt und dieser Buchreihen auf dem System bereitstellen soll, die sich an einem anderen Ort im System befinden, können Sie hierzu den folgenden Befehl verwenden:
# /usr/lib/ab2/bin/ab2admin -o add_coll -d /net/elsewhere/books/SUNWdtad/collinfo |
Um Benutzern die Möglichkeit zu geben, auf Ihren Dokumentationsserver auch ohne Kenntnis des URL zuzugreifen, können Sie den Namen Ihres Servers im FNS-System registrieren. Benutzer haben dabei immer noch Zugriff auf nicht registrierte Server, sofern sie deren URL kennen.
Das Verfahren zur Registrierung Ihres Servers hängt von zwei Faktoren ab:
Ihrer Kenntnis der FNS-Befehle
Wenn Sie mit den standardmäßigen FNS-Befehlen wie beispielsweise fnbind vertraut sind, können Sie den Server über FNS-Befehle registrieren. Andernfalls haben Sie auch die Möglichkeit, den Registrierungsvorgang automatisch mit dem Befehl /usr/lib/ab2/bin/ab2regsvr durchführen zu lassen. Weitere Informationen finden Sie unter "Registrieren des Servers mit dem Befehl ab2regsvr" und "Registrieren des Servers mit Standard-FNS-Befehlen".
Verwendeter Namen-Service
NIS+ (Network Information Service Plus) ist der für Solaris 2.6 und spätere Betriebssystemumgebungen verwendete primäre Namen-Service. Wenn Ihr System NIS+ verwendet und Sie Verwalterrechte besitzen, können Sie den Server registrieren, während Sie im Master- oder Client-System von NIS+ angemeldet sind.
NIS (Network Information Service) war der Standard-Namen-Service der Betriebssystemumgebungen SunOS 4.x (Solaris 1.x). Wenn Ihr System NIS verwendet, müssen Sie sich als root am NIS-Master-System anmelden, um den Dokumentationsserver zu registrieren.
Das Produkt AnswerBook2 funktioniert auch mit einem über das Dateisystem definierten Namen-System (files). Alle Namen müssen dann manuell in Datendateien eingegeben werden. Diese Dateien werden im Verzeichnis /var/fn/ gespeichert. In diesem Fall müssen Sie zur Registrierung des Servers root-Zugriff auf das System besitzen, und die Registrierung gilt nur für den Computer, auf dem sie vorgenommen wurde. Ein Server, der unter einem Dateisystem-Mechanismus registriert wurde, ist für andere Computer nicht sichtbar.
Zur Registrierung Ihres Servers führen Sie den Befehl ab2regsvr aus. Der Befehl ab2regsvr wertet Ihre Systemkonfiguration aus und richtet den passenden Namensplatz für Ihren Server ein.
Zur Registrierung Ihres Servers, geben Sie folgenden Befehl ein:
# /usr/lib/ab2/bin/ab2regsvr server_url |
Dabei bezeichnet server_url den vollständigen URL für den Zugriff auf den Server (z.B.: http://imaserver.eng.sun.com:8888/).
Der Befehl ab2regsvr bietet darüber hinaus einige weitere nützliche Optionen:
Anzeigen einer Liste der registrierten AnswerBook2-Server-URLs:
# /usr/lib/ab2/bin/ab2regsvr -l |
Entfernen eines registrierten Servers aus der Liste:
# /usr/lib/ab2/bin/ab2regsvr -d |
Ändern des URL für den aktuell registrierten AnswerBook2-Servers:
# /usr/lib/ab2/bin/ab2regsvr -r server_url |
Dabei ist server_url der neue URL für den Server (z.B. http://aserver.eng.sun.com:8888/). Dadurch wird ein vorhandener URL durch den angegebenen URL ersetzt.
Weitere Informationen über den Befehl ab2regsvr finden Sie in der Online-Dokumentation ab2regsvr(1m).
Wenn Sie die Registrierung Ihres Servers mit FNS-Befehlen vornehmen möchten und FNS bereits an Ihrem Standort installiert ist, können Sie den angegebenen URL mit dem nachstehenden Befehl als Dokumemntationsserver für Ihre Organisation (Domain) registrieren:
# fnbind -r thisorgunit/server/answerbook2 onc_answerbook2 \ onc_addr_answerbook2 server_url |
Dabei bezeichnet server_url den vollständigen URL für den Zugriff auf den Server (z.B.: http://imaserver.eng.sun.com:8888/).
Die aktuell registrierten Server ermitteln Sie mit folgendem Befehl:
% fnlookup -v thisorgunit/service/answerbook2 |
Die erzeugte Liste der registrierten Server hat folgenden Aufbau:
Reference type: onc_answerbook2 Address type: onc_addr_answerbook2 length: 19 data: 0x68 0x74 0x74 0x70 0x3a 0x2f 0x2f 0x61 0x6e 0x73 http://ans 0x77 0x65 0x72 0x73 0x3a 0x38 0x38 0x38 0x38 wers:8888 |
In diesem Beispiel bezeichnet http://answers:8888/ den registrierten Server.
Wenn Sie eine Antwort der folgenden Form erhalten, dann ist kein Dokumentserver mit FNS registriert:
Lookup of 'thisorgunit/service/answerbook2' failed: \ Name Not Found: 'answerbook2' |
Weitere Informationen zu FNS und dessen Installation finden Sie in der FNS-Dokumentation.
Anstatt die beschriebenen Namen-Services zur Suche eines Dokumentationsservers zu verwenden, kann der Benutzer auch einen standardmäßigen AnswerBook2-Server definieren. Hierzu dient die Umgebungsvariable AB2_DEFAULTSERVER. In die Datei .cshrc müßte dann eine Zeile ähnlich der folgenden eingefügt werden:
setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888 |
Wenn der Benutzer AnswerBook2 vom Desktop aus startet, ohne daß diese Variable gesetzt ist, ermittelt das Produkt, ob auf dem System, auf dem es gestartet wurde, ein Dokumentationsserver ausgeführt wird. Ist dies der Fall, ruft es den folgenden URL auf: http://localhost:port, wobei port standardmäßig auf folgenden Wert gesetzt ist: 8888.
Wenn der Benutzer AnswerBook2 vom Desktop eines Systems startet, das kein Dokumentationsserver ist und auf dem keine Umgebungsvariable definiert ist, führt das System den Befehl fnlookup thisorgunit/service/answerbook2 aus, um die verfügbaren Dokumentserver zu ermitteln. Dann wird einer davon ausgewählt und der AnswerBook2--Browser gestartet, wobei der Name des gewählten Servers in den URL eingesetzt wird.
Legen Sie die Solaris 7 Documentation CD in Ihr CD-ROM-Laufwerk ein.
Stellen Sie sicher, daß Sie als Superuser angemeldet sind.
% su - |
Wechseln auf auf dem CD-ROM-Laufwerk zum Volume der obersten Ebene (oder rufen Sie hierzu den auf.
Dies ist ähnlich der nachstehenden Position:
/cdrom/sol_2_7_doc/ |
Dieses Verzeicnnis enthält ein Unterverzeichnis, eine README-Datei, das Dienstprogramm Installer und das Skript ab2cd. Mit dem Skript ab2cd können Sie den Dokumentationsserver direkt von der CD ausführen.
Geben Sie den folgenden Befehl ein:
# ./ab2cd |
Greifen Sie auf Dokumentationsserver über den URL zu:
http://server:8888/ |
Dabei ist server der Name des Gerätes, mit dem das CD-ROM-Laufwerk verbunden ist.
Beachten Sie, daß der Dokumentationsserver beim Starten von der CD immer auf Anschluß 8888 ausgeführt wird.
(Optional) Damit die von der CD aufgerufene Server-Software auch Buchreihen erkennt, die bereits auf dem Server-Computer installiert sind, geben Sie den folgenden Befehl ein:
# ab2cd -s |
Diese Form des Befehls veranlaßt die von der CD gestartete Serversoftware, nach anderen auf dem System installierten Buchreihen zu suchen und diese in die Datenbank einzufügen.
Um die Ausführung des Servers von CD zu beenden, geben Sie den folgenden Befehl ein:
# /cdrom/sol_2_7_doc/ab2cd stop |
Die Ausführung des Dokumentationsservers von CD ist langsamer als von Fenstplatte. Verwenden Sie dieses Verfahren nicht, wenn außer Ihnen auch noch andere Benutzer auf den Dokumentationsserver zugreifen möchten.
Beachten Sie folgende Punkte, wenn Sie den Server von der CD ausführen:
Der AnswerBook2-Server wird beim direkten Aufruf von der CD immer auf dem Anschluß 8888 ausgeführt. Wenn auf Ihrem System bereits ein AnswerBook2-Server auf dem Standardanschluß (8888) ausgeführt wird, zeigt das Skript ab2cd die folgende Meldung an:
A document server is already running on this system as server:8888.
Please shut down the current server before running the ab2cd command.
Fahren Sie den vorhandenen Server mit dem folgenden Befehl herunter:
# /usr/lib/ab2/bin/ab2admin -o stop |
Beenden Sie einen von der CD gestarteten Server immer mit dem Befehlab2cd stop. Verwenden Sie hierzu nicht den Befehl /etc/init.d/ab2mgr stop.
Der Befehl ab2cd stop beendet den AnswerBook2-Server-Prozeß und bereinigt alle Dateien in den Verzeichnissen /tmp/ab2/ und /tmp/ab2cd_config/. Der Befehl /etc/init.d/ab2mgr stop beendet alle Server-Prozesse, fürht jedoch keine Bereinigung der Dateien in den Verzeichnissen /tmp/ab2/ und /tmp/ab2cd_config/ durch.
Wenn Sie zwei AnswerBook2-Server ausführen (einen vom System, den anderen von der CD), beachten Sie die folgenden Regeln:
Der Befehl /etc/init.d/ab2mgr start startet immer den auf dem System installierten Server.
Der Befehl ab2cd startet immer den Server von der CD.
Verwenden Sie immer den Befehl ab2cd stop, um den von der CD ausgeführten Server zu beenden.
Zum Beenden beider Server beenden Sie zuerst den von der CD ausgeführten Server mit dem Befehl ab2cd stop und führen danach entweder den Befehl /etc/init.d/ab2mgr stop oder /usr/lib/ab2/bin/ab2admin -o stop aus, um den vom System ausgeführten Server zu beenden.
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 |