Net.Data Verwaltung und Programmierung für OS/2, Windows NT und UNIX


Konfigurieren von Net.Data zur Verwendung mit den Web-Server-APIs

Die Verwendung einer Web-Server-Anwendungsprogrammierschnittstelle (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 im Abschnitt Optimieren der Leistung mit den Web-Server-APIs und in der Informationsdatei (README) für Ihre Version von Net.Data.

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

In den folgenden Abschnitten wird beschrieben, wie Sie Net.Data und den Web-Server 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 ICAPI und GWAPI zu konfigurieren:

Domino Go Webserver ist das Nachfolgeprodukt von IBM Internet Connection Secure Server. Wenn Sie erweitern, erwägen Sie möglicherweise die Verwendung des neueren Produkts Domino Go Webserver. Beachten Sie, daß es sich bei GWAPI und ICAPI um das gleiche Produkt handelt, das lediglich umbenannt wurde, um anzugeben, welcher Web-Server verwendet wird.

  1. Stoppen Sie den Web-Server.

  2. Stellen Sie sicher, daß sich die DLL-Datei bzw. die gemeinsam benutzte Bibliothek von ICAPI bzw. GWAPI im Verzeichnis CGI-BIN bzw. ICAPI-LIB des Servers befindet.

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

  3. Fügen Sie der Konfigurationsdatei des Web-Servers (httpd.conf oder httpd.cnf) eine Serviceanweisung hinzu, um die API aufzurufen.

    Beispiel:

    Service /cgi-bin/db2www*   /usr/lpp/netdata/icapi-lib/db2www:dtw_icapi*
    

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

  4. Starten Sie den Web-Server erneut.

ICAPI und GWAPI verfügen über die volle Kompatibilität zur Unterstützung vorhandener Anwendungen. Verwenden Sie die gleichen Methoden wie bei CGI zum Aufrufen einer URL-Adresse, eines Formulars oder einer Programmverbindung (Link) mit ICAPI bzw. GWAPI. Ein mit CGI erfolgreich ausführbares Makro wird unter Verwendung von ICAPI bzw. GWAPI ebenfalls erfolgreich ausgeführt. An diesen Makros brauchen keine Änderungen vorgenommen zu werden.

Gehen Sie wie folgt vor, um ISAPI zu konfigurieren:

  1. Stoppen Sie den Web-Server.

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

    Dabei ist dateityp bei Windows NT und OS/2 .dll und bei 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 Programmverbindungen (Links) auslassen. Verwenden Sie stattdessen dtwisapi.dateityp. Beispiel: Die folgende URL-Adresse ruft Net.Data als CGI-Programm auf:
    http://server1.stl.ibm.com/cgi-bin/db2www/test1.d2w/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.d2w/report
    

  4. Wenn Sie Ihr Makro test1.d2w im Unterverzeichnis /order/ unter einem der in der Anweisung MACRO_PATH angegebenen Verzeichnisse oder im aktuellen Verzeichnis des Web-Servers 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.d2w/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.d2w/report
    

  5. Starten Sie den Web-Server erneut.

Gehen Sie wie folgt vor, um NSAPI zu konfigurieren:

  1. Stoppen Sie den Web-Server.

  2. Kopieren Sie die mit Net.Data gelieferte DLL-Datei für NSAPI in das Server-Verzeichnis. Beispiel:
    /netscape/server/bin/httpd/dtwnsapi.dateityp
    

    Dabei ist dateityp bei Windows NT und OS/2 .dll und bei UNIX .o.

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

  3. Ändern Sie Ihre Server-Konfigurationsdatei 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="<pfad>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 der Makrodatei ist. Sie können eine beliebige Kombination aus drei Zeichen angeben.
    type=magnum-internal/d2w exts=d2w
    

  4. Versetzen Sie die Net.Data-Makrodateien aus dem Verzeichnis netdata/macro in das Hauptdokumentverzeichnis des Servers:
    /netscape/server/docs/
    

  5. Fügen Sie der Anweisung MACRO_PATH in der Initialisierungsdatei das Hauptdokumentverzeichnis des Servers hinzu. Durch diese Änderung wird Net.Data mitgeteilt, an welcher Position nach den Dateien gesucht werden soll.

  6. Da NSAPI die CGI-Verarbeitung umgeht, können Sie den Teil cgi-bin/db2www/ der URL-Adresse in Formularen und Programmverbindungen (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.d2w/report
    

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

    http://server1.stl.ibm.com/test1.d2w/report
    

  7. Starten Sie den Web-Server 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 Hauptdokumentverzeichnis des Servers.

  2. Aktualisieren Sie die Variable MACRO_PATH in der Initialisierungsdatei so, daß sie alle Verzeichnisse und Unterverzeichnisse mit Makrodateien enthält.

  3. Ändern Sie die Programmverbindungen (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 im CGI-Modus ein Net.Data-Makro auf, das im Verzeichnis /orders/ gespeichert ist:
    http://server1.stl.ibm.com/cgi-bin/db2www/orders/test1.d2w/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.d2w/report
    


[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]