Verwaltung und Programmierung

Konfigurieren von Net.Data zur Verwendung mit den Webserver-APIs

Die Verwendung einer Webserveranwendungsprogrammierschnittstelle (API) anstelle von CGI kann die Leistung von Net.Data wesentlich steigern. Net.Data unterstützt die folgenden Server-APIs:

Weitere Informationen zu den einzelnen APIs finden Sie in Verwenden von FastCGI und in der Informationsdatei (README) für Ihre Version von Net.Data.

Voraussetzung: Zur Ausführung von Net.Data im ISAPI- oder NSAPI-Modus müssen Sie Ihren Webserver rekonfigurieren, so dass er DLL-Dateien oder gemeinsam benutzte Bibliotheken von Net.Data als Serviceanweisungen verwendet. Nach dem Rekonfigurieren müssen Sie Ihren Webserver erneut starten, so dass die von Ihnen an der Net.Data-Initialisierungsdatei vorgenommenen Änderungen wirksam werden. Net.Data wird standardmäßig im CGI-Modus ausgeführt.

Konfigurieren Sie Net.Data so, dass nur jeweils eine Schnittstelle verwendet wird. Wenn Sie beispielsweise den Webserver so konfigurieren, dass Net.Data mit FastCGI ausgeführt wird, dürfen Sie den Webserver nicht zusätzlich so konfigurieren, dass Net.Data mit ISAPI oder einer anderen Schnittstelle ausgeführt wird. Wenn Sie Net.Data später mit einer anderen Schnittstelle ausführen wollen, z. B. NSAPI, müssen Sie den Webserver zur ausschließlichen Verwendung der neuen Schnittstelle rekonfigurieren.

In den folgenden Abschnitten wird beschrieben, wie Sie Net.Data und den Webserver zur Ausführung im API-Modus konfigurieren können. Die folgenden Schritte und Beispiele sind allgemein gehalten und weichen eventuell von Ihrem Betriebssystem ab. Spezifische Anweisungen finden Sie in der Net.Data-Informationsdatei (README) für Ihr Betriebssystem.

Gehen Sie wie folgt vor, um die Apache API zu konfigurieren:

  1. Stoppen Sie den Webserver.
  2. Stellen Sie sicher, dass libmod_db2www.so sich im Verzeichnis /opt/netdata/lib befindet.
  3. Nur für Linux: Kopieren Sie libmod_db2www.so (Linux) oder mod_db2www.dll (WinNT) in das Verzeichnis /apache/modules.
  4. Fügen Sie der Konfigurationsdatei des Webservers (httpd.conf) eine Serviceanweisung hinzu, um die API aufzurufen.

    Beispiel:

    LoadModule db2www_module /pot/netdata/lib/libmod_db2www.so AddHandler 
         db2 www_handler .db2www
    

    Spezifische Datei- und Verzeichnisnamen finden Sie in der Net.Data-Informationsdatei (README) für Ihr Betriebssystem.

  5. Starten Sie den Webserver erneut.

APAPI wird nur unter Windows NT, Linux und Linux s/390 unterstützt.

Gehen Sie wie folgt vor, um ISAPI zu konfigurieren:

  1. Stoppen Sie den Webserver.
  2. Kopieren Sie die mit Net.Data gelieferte DLL-Datei für ISAPI in das Unterverzeichnis des Servers. Beispiel:
    /inetsrv/scripts/dtwisapi.filetype
    

    Dabei gilt Folgendes: filetype ist für Windows NT und OS/2 .dll und für UNIX .o.

    Spezifische Datei- und Verzeichnisnamen finden Sie in der Net.Data-Informationsdatei (README) für Ihr Betriebssystem.

  3. Da ISAPI die CGI-Verarbeitung umgeht, können Sie den Teil cgi-bin/db2www/ der URL-Adresse in Formularen und Verbindungen (Links) auslassen. Verwenden Sie stattdessen dtwisapi.filetype. Beispiel: Die folgende URL-Adresse ruft Net.Data als CGI-Programm auf:
    http://server1.stl.ibm.com/cgi-bin/db2www/test1.dtw/report
    

    In diesem Fall müssen Sie Net.Data als ISAPI-Plug-In mit der folgenden URL-Adresse aufrufen:

    http://server1.stl.ibm.com/scripts/dtwisapi.dll/test1.dtw/report
    
  4. Wenn Sie Ihr Makro test1.dtw im Unterverzeichnis /order/ unter einem der in der Anweisung MACRO_PATH angegebenen Verzeichnisse oder im aktuellen Verzeichnis des Webservers gespeichert haben, rufen Sie Net.Data mit der folgenden URL-Adresse im CGI-Modus auf:
    http://server1.stl.ibm.com/cgi-bin/db2www/orders/test1.dtw/report
    

    Die entsprechende URL-Adresse zum Aufrufen von Net.Data im ISAPI-Modus lautet dann wie folgt:

    http://server1.stl.ibm.com/scripts/dtwisapi.dll/orders/test1.dtw/report
    
  5. Starten Sie den Webserver erneut.

Gehen Sie wie folgt vor, um NSAPI zu konfigurieren:

  1. Stoppen Sie den Webserver.
  2. Kopieren Sie die mit Net.Data gelieferte DLL-Datei für NSAPI in das Serververzeichnis. Beispiel:
    /netscape/server/bin/httpd/dtwnsapi.filetype
    

    Dabei gilt Folgendes: filetype ist für Windows NT und OS/2 .dll und für UNIX .o.

    Spezifische Datei- und Verzeichnisnamen finden Sie in der Net.Data-Informationsdatei (README) für Ihr Betriebssystem.

  3. Ändern Sie Ihre Serverkonfigurationsdatei wie unten angegeben. Informationen zu den Unterschieden zwischen den Betriebssystemen finden Sie in der Net.Data-Informationsdatei (README) bzw. im Programmverzeichnis für Ihr Betriebssystem.
    obj.conf Fügen Sie am Anfang der Datei folgende Angaben hinzu:
    Init fn="load-modules" shlib="<path>dtwnsapi.dll" funcs=dtw_nsapi
    
    obj.conf Fügen Sie der Serviceanweisung folgende Angaben hinzu:
    Service fn="dtw_nsapi" method=(GET|HEAD|POST) type="magnus-internal/d2w"
    
    mime.types Fügen Sie diesen Typ hinzu, wobei d2w die Standarderweiterung des Makros ist. Sie können eine beliebige Kombination aus drei Zeichen angeben.
    type=magnus-internal/d2w exts=d2w
    
  4. Versetzen Sie die Net.Data-Makros aus dem Verzeichnis netdata/macro in das Dokumentstammverzeichnis des Servers:
    /netscape/server/docs/
    
  5. Fügen Sie der Anweisung MACRO_PATH in der Initialisierungsdatei das Dokumentstammverzeichnis des Servers hinzu. Durch diese Änderung wird Net.Data mitgeteilt, an welcher Position nach den Makros gesucht werden soll.
  6. Da NSAPI die CGI-Verarbeitung umgeht, können Sie den Teil cgi-bin/db2www/ der URL-Adresse in Formularen und Verbindungen (Links) auslassen. Der Server erkennt Dateien mit dem Dateityp d2w als Net.Data-Makros, weil Sie dies beim Ändern der Netscape-Konfigurationsdateien entsprechend definiert haben. Zum Beispiel ruft die folgende URL-Adresse Net.Data als CGI-Programm auf:
    http://server1.stl.ibm.com/cgi-bin/db2www/test1.dtw/report
    

    Die folgende URL-Adresse hingegen ruft Net.Data als NSAPI-Plug-In auf:

    http://server1.stl.ibm.com/test1.dtw/report
    
  7. Starten Sie den Webserver erneut.

Wenn Sie Ihre Net.Data-Makros in verschiedenen Verzeichnissen speichern, ändern sich die letzten drei Schritte:

  1. Versetzen Sie die Verzeichnisse mit den darin enthaltenen Net.Data-Makros in das Dokumentstammverzeichnis des Servers.
  2. Aktualisieren Sie die Variable MACRO_PATH in der Initialisierungsdatei so, dass sie alle Verzeichnisse und Unterverzeichnisse mit Makros enthält.
  3. Ändern Sie die Verbindungen (Links) und Formulare, die auf diese Net.Data-Makros verweisen, und behalten Sie die jeweiligen Verzeichnisnamen bei. Beispielsweise ruft die folgende URL-Adresse bei Ausführung in CGI ein Net.Data-Makro auf, das im Verzeichnis /orders/ gespeichert ist:
    http://server1.stl.ibm.com/cgi-bin/db2www/orders/test1.dtw/report
    

    Die aktualisierte URL-Adresse zum Aufrufen von Net.Data im NSAPI-Modus ist kürzer, behält jedoch den Verzeichnisnamen bei:

    http://server1.stl.ibm.com/orders/test1.dtw/report
    


[ Seitenanfang | Vorherige Seite | Nächste Seite ]