[AIX Solaris HP-UX Linux Windows][IBM i]

Web-Server-Konfiguration

Die Plug-in-Konfiguration umfasst die Konfiguration des Web-Servers für die Verwendung des von WebSphere Application Server bereitgestellten binären Plug-in-Moduls. Die Plug-in-Konfiguration umfasst außerdem die Aktualisierung der Plug-in-XML-Konfigurationsdatei, damit diese die aktuelle Anwendungsserverkonfiguration wiedergibt. Das Binärmodul verwendet die XML-Datei für die Weiterleitung von Web-Client-Anforderungen.

[AIX Solaris HP-UX Linux Windows]Nach der Installation eines unterstützten Web-Servers müssen Sie durch Installation von Web Server Plug-ins ein binäres Plug-in-Modul für den Web-Server installieren. Durch das Plug-in-Modul kann der Web-Server mit dem Anwendungsserver kommunizieren. Mit Web Server Plug-ins Configuration Tool können Sie den Web-Server konfigurieren und eine Web-Server-Definition in der Konfiguration des Anwendungsservers erstellen. Web Server Plug-ins Configuration Tool verwendet die folgenden Dateien für die Konfiguration eines Plug-ins für den gewählten Web-Server:
  • Die Web-Server-Konfigurationsdatei auf der Web-Server-Maschine, z. B. die Datei httpd.conf für IBM® HTTP Server.
  • Die binäre Web-Server-Plug-in-Datei auf der Web-Server-Maschine.
  • Die Plug-in-Konfigurationsdatei plugin-cfg.xml auf der Anwendungsservermaschine, die Sie an eine Web-Server-Maschine weitergeben (kopieren).
  • Die (temporäre) Standard-Plug-in-Konfigurationsdatei plugin-cfg.xml auf der Web-Server-Maschine.
  • Das Script configureName_des_Web-Servers, das Sie von der Web-Server-Maschine auf die Anwendungsservermaschine kopieren.
[IBM i]Der Plug-ins-Konfigurationsprozess verwendet die folgenden Dateien für die Konfiguration eines Plug-ins für den gewählten Web-Server:
  • Die Web-Server-Konfigurationsdatei auf der Web-Server-Maschine, z. B. die Datei httpd.conf für IBM HTTP Server.
  • Die binäre Web-Server-Plug-in-Datei auf der Web-Server-Maschine.
  • Die Plug-in-Konfigurationsdatei plugin-cfg.xml auf der Anwendungsservermaschine, die Sie an eine Web-Server-Maschine weitergeben (kopieren).
  • Das Konfigurationsscript, um die Web-Server-Definition für Ihren Anwendungsserver in einem fernen HTTP-Szenario zu konfigurieren.

Weitere Informationen hierzu finden Sie in den folgenden Beschreibungen für jede Datei.

Web-Server-Konfigurationsdatei

Die Web-Server-Konfigurationsdatei wird als Teil des Web-Servers installiert.

[AIX Solaris HP-UX Linux Windows]Das Produkt Web Server Plug-ins Configuration Tool muss die Konfigurationsdatei für einen unterstützten Web-Server neu konfigurieren.

Die Konfiguration besteht aus dem Hinzufügen von Anweisungen, die die Dateiposition von zwei Dateien angeben:
  • Binäre Web-Server-Plug-in-Datei
  • Plug-in-Konfigurationsdatei plugin-cfg.xml

Binäre Web-Server-Plug-in-Datei

Ein Beispiel eines binären Plug-in-Moduls ist die Datei mod_was_ap22_http.dll für IBM HTTP Server auf der Windows-Plattform.

[IBM i]Ein weiteres Beispiel eines binären Plug-in-Moduls ist das Serviceprogramm QSVTAP20 auf der IBM i-Plattform.

Die binäre Plug-in-Datei ändert sich nicht. Die Konfigurationsdatei für das binäre Plug-in ist jedoch eine XML-Datei. Der Anwendungsserver ändert die Konfigurationsdatei wenn an Ihrer WebSphere Application Server-Konfiguration bestimmte Änderungen auftreten.

Das Binärmodul liest die XML-Datei, um Einstellungen anzupassen und Anforderungen an den Anwendungsserver weiterzuleiten.

Plug-in-Konfigurationsdatei plugin-cfg.xml

Die Plug-in-Konfigurationsdatei ist eine XML-Datei mit Einstellungen, die Sie in der Administrationskonsole aktivieren können. Die Datei listet alle Anwendungen, die in der Web-Server-Definition installiert sind, auf. Das Binärmodul liest die XML-Datei, um Einstellung anzupassen und Anforderungen an den Anwendungsserver weiterzuleiten.

[AIX Solaris HP-UX Linux Windows]Der eigenständige Anwendungsserver generiert die Datei plugin-cfg.xml im Verzeichnis Profilstammverzeichnis/config/cells/Zellenname/nodes/Name_des_Web-Servers_node/servers/Name_des_Web-Servers neu. Diese Neugenerierung findet immer dann statt, wenn an der Anwendungsserverkonfiguration eine Änderung vorgenommen wird, die sich auf implementierte Anwendungen auswirkt.

[AIX Solaris HP-UX Linux Windows]Der Deployment Manager generiert die Datei plugin-cfg.xml im Verzeichnis Profilstammverzeichnis/config/cells/Zellenname/nodes/Knotenname/servers/Name_des_Web-Servers immer dann neu, wenn an der Anwendungsserverkonfiguration eine Änderung vorgenommen wird, die sich auf implementierte Anwendungen in dem verwalteten Knoten auswirkt.

[IBM i]Wenn Sie Änderungen an der Anwendungsserverkonfiguration vornehmen, die sich auf implementierte Anwendungen auswirken, generieren Sie die XML-Datei mit der Plug-in-Konfiguration neu.

Nach der Neugenerierung geben Sie die Datei an die Web-Server-Maschine weiter (kopieren). Das binäre Plug-in hat dann Zugriff auf die aktuelle Version der Konfigurationsdatei.

[AIX Solaris HP-UX Linux Windows]Die Datei plugin-cfg.xml wird vom Web-Server-Plug-in-Konfigurationsservice nach bestimmten Ereignissen, die die Konfiguration ändern, automatisch neu generiert. Der Konfigurationsservice gibt die Datei plugin-cfg.xml automatisch an eine IBM HTTP Server-Maschine weiter, wenn die Datei neu generiert wurde. Auf andere Web-Server müssen Sie die Datei manuell kopieren.

[IBM i]Auf IBM i-Systemen wird das Plug-in nicht automatisch generiert. Sie müssen die Datei manuell neu generieren und weitergeben.

[AIX Solaris HP-UX Linux Windows]

Plug-in-Standardkonfigurationsdatei plugin-cfg.xml

Web Server Plug-ins Configuration Tool erstellt die temporäre Datei plugin-cfg.xml im Verzeichnis Stammverzeichnis_für_Plug-ins/config/Name_des_Web-Servers. Das Tool erstellt die Datei für jedes ferne Installationsszenario.

Die Standarddatei ist ein Platzhalter und muss durch die Datei plugin-cfg.xml aus der Web-Server-Definition auf dem Anwendungsserver ersetzt werden. Die Standarddatei ist eine Kopie der Datei, die der Anwendungsserver für einen eigenständigen Standardanwendungsserver erstellt.

Für eine ferne Installation führen Sie das Script configureName_des_Web-Servers im Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin der Anwendungsservermaschine aus. Für eine lokale Installation führen Sie das Script direkt im Verzeichnis Stammverzeichnis_für_Plug-ins/bin aus. Das Script erstellt die Web-Server-Definition in den Konfigurationsdateien des Standardprofils. Um ein anderes Profil zu konfigurieren, bearbeiten Sie das Script configureName_des_Web-Servers. Verwenden Sie den Parameter -profileName, um ein anderes Profil als das Standardprofil anzugeben.

Nach der Erstellung der Web-Server-Definition erstellt der Web-Server-Plug-in-Konfigurationsservice im Anwendungsserver die erste Datei plugin-cfg.xml in der Web-Server-Definition auf der Anwendungsservermaschine. Wenn Sie eine Anwendung installieren, einen virtuellen Host erstellen oder eine andere Konfigurationsänderung ausführen, müssen Sie die aktualisierte Datei plugin-cfg.xml von der Anwendungsservermaschine an die Web-Server-Maschine weitergeben, um die Standarddatei zu ersetzen.

[AIX Solaris HP-UX Linux Windows]

Script configureName_des_Web-Servers für die Web-Server-Definition

Web Server Plug-ins Configuration Tool erstellt das Script configureName_des_Web-Servers auf der Web-Server-Maschine im Verzeichnis Stammverzeichnis_für_Plug-ins/bin. Wenn eine Maschine in einem fernen Szenario auf einem Betriebssystem wie AIX oder Linux ausgeführt werden und die andere Maschine unter Windows ausgeführt wird, verwenden Sie das im Verzeichnis Stammverzeichnis_für_Plug-ins/bin/crossPlatformScripts erstellte Script. Das Script wird nur für ferne Installationsszenarien erstellt.

Kopieren Sie das Script von der Web-Server-Maschine in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin auf einer fernen Anwendungsservermaschine. Für eine lokale Installation muss das Script nicht kopiert werden. Führen Sie das Script aus, um die Web-Server-Definition in der Anwendungsserverkonfiguration zu erstellen.

Wenn Sie IBM HTTP Server verwenden, müssen Sie auch den Verwaltungsserver von IBM HTTP Server konfigurieren. Der Verwaltungsserver von IBM HTTP Server verwendet die Administrationskonsole, um Web-Server-Definitionen zu verwalten. Verwenden Sie die Administrationskonsole außerdem, um Ihre Web-Server-Definition mit Optionen für ferne Web-Server-Verwaltung zu aktualisieren. Klicken Sie auf Server > Servertypen > Web-Server > Name_des_Web-Servers, um die Konfigurationsoptionen anzuzeigen. Klicken Sie beispielsweise auf Verwaltung des fernen Web-Servers um Eigenschaften wie die folgenden zu ändern:
  • Hostname
  • Verwaltungsport
  • Benutzer-ID
  • Kennwort
Wichtig: Öffnen Sie vor dem Ausführen dieses Scripts immer ein neues Befehlsfenster. Auf diese Weise können Sie potentielle Probleme vermeiden.

Das Problem ist ein potentieller Konflikt zwischen einer Shellumgebungsvariablen (WAS_USER_SCRIPT) und dem echten Standardprofil. Das Script arbeitet immer mit dem Standardprofil. Wenn die Umgebungsvariable WAS_USER_SCRIPT festgelegt wird, entsteht jedoch ein Konflikt, wenn das Script versucht, in dem mit der Variablen angegebenen Profil zu arbeiten.

Die Variable kann leicht versehentlich festgelegt werden. Wenn Sie im Verzeichnis Profilstammverzeichnis/bin eines Profils einen Befehl absetzen, wird die Variable auf dieses Profil eingestellt.

Wenn Sie in Ihrem System mehr als ein Profil haben, ist es potenziell möglich, dass das Standardprofil und das von der Variable angegebene Profil unterschiedlich sind. In diesem Fall entsteht ein Konflikt und das Script erstellt die Web-Server-Definition möglicherweise nicht im richtigen Profil oder erstellt die Web-Server-Definition überhaupt nicht.

Sie können die Variable auf eine der beiden folgenden Arten zurücksetzen:
  • Schließen Sie das Befehlsfenster, in dem die Variable gesetzt wurde, und öffnen Sie ein neues.
  • Wechseln Sie in das Verzeichnis Profilstammverzeichnis/bin des Standardprofils, und rufen Sie das Script setupCmdLine.sh auf:
    [Windows]
    1. Öffnen Sie ein Fenster mit Eingabeaufforderung.
    2. Wechseln Sie in das Verzeichnis Stammverzeichnis_des_Anwendungsservers\bin.
    3. Setzen Sie den Befehl setupCmdLine.bat ab.
    [AIX][HP-UX][Linux][Solaris]
    1. Öffnen Sie ein Fenster mit Befehlsshell.
    2. Wechseln Sie in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin.
    3. Setzen Sie den Befehl . ./setupCmdLine.bat ab. Achten Sie auf das Leerzeichen zwischen den Punkten. Dieses spezielle Befehlsformat bewirkt, dass der Befehl in der aktuellen Prozessumgebung ausgeführt wird, damit die Einstellung für alle in der Befehls-Shell gestarteten Prozesse gilt.

Wenn für einen eigenständigen Anwendungsserver bereits eine Web-Server-Definition vorhanden ist, wird beim Ausführen des Scripts keine neue Web-Server-Definition hinzugefügt. Jeder eigenständige Anwendungsserver kann nur eine Web-Server-Definition haben.

Mit der Administrationskonsole eines eigenständigen Anwendungsservers können Sie keine Web-Server-Definition hinzufügen oder löschen. Diese Tasks müssen über die Scripting-Verwaltungsschnittstelle ausgeführt werden:
  • Fügen Sie mit dem Script configureName_des_Web-Servers über das Tool wsadmin eine Web-Server-Definition hinzu. Das Script verwendet ein Jacl-Script (Java™ Command Language) mit dem Namen configureWebserverDefintion.jacl, um die Web-Server-Definition zu erstellen und zu konfigurieren.
  • Löschen Sie eine Web-Server-Definition mit wsadmin-Befehlen. Im folgenden Beispiel hat der Web-Server den Namen webserver1:
     set webserverName webserver1
     set webserverNodeSuffix _node
     set webserverNodeName   $webserverName$webserverNodeSuffix
     $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName/Server:$webserverName]
     $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName]
     $AdminConfig save   

Ein verwalteter Knoten kann dagegen mehrere Web-Server-Definitionen enthalten. Das Script erstellt eine neue Web-Server-Definition, wenn der Name des Web-Servers abweicht.

[IBM i]

Konfigurationsscript für die Web-Server-Definition

Wenn Sie Ihren Web-Server mit dem Script configureOs400WebserverDefinition oder über die Verwaltungsschnittstelle von IBM i konfigurieren, wird das Script configureName_des_Web-Servers im Verzeichnis Stammverzeichnis_für_Plug-ins/bin auf der Web-Server-Maschine erstellt. Das Script wird nur für ferne Installationsszenarien erstellt.

Kopieren Sie das Script von der Web-Server-Maschine in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin in der Partition von IBM i. Führen Sie das Script aus, um die Web-Server-Definition in der Anwendungsserverkonfiguration zu erstellen.

Die grafische Verwaltungsschnittstelle von IBM i verfügt über Plug-ins, die die Administrationskonsole zur Verwaltung von IBM HTTP Server verwendet. Verwenden Sie die Administrationskonsole, um Ihre Web-Server-Definition mit Optionen für ferne Web-Server-Verwaltung zu aktualisieren. Klicken Sie auf Server > Servertypen > Web-Server > Name_des_Web-Servers, um die Konfigurationsoptionen anzuzeigen. Klicken Sie beispielsweise auf Verwaltung des fernen Web-Servers um Eigenschaften wie die folgenden zu ändern:
  • Hostname
  • Verwaltungsport
  • Benutzer-ID
  • Kennwort

Wenn für einen eigenständigen Anwendungsserver bereits eine Web-Server-Definition vorhanden ist, wird beim Ausführen des Scripts keine neue Web-Server-Definition hinzugefügt. Jeder eigenständige Anwendungsserver kann nur eine Web-Server-Definition haben.

Mit der Administrationskonsole eines eigenständigen Anwendungsservers können Sie keine Web-Server-Definition hinzufügen oder löschen. Diese Tasks müssen über die Scripting-Verwaltungsschnittstelle ausgeführt werden:
  • Fügen Sie mit dem Script configureName_des_Web-Servers über das Tool wsadmin eine Web-Server-Definition hinzu. Das Script verwendet ein Jacl-Script (Java Command Language) mit dem Namen configureWebserverDefintion.jacl, um die Web-Server-Definition zu erstellen und zu konfigurieren.
  • Löschen Sie eine Web-Server-Definition mit wsadmin-Befehlen. Im folgenden Beispiel hat der Web-Server den Namen webserver1:
    set webserverName webserver1
    set webserverNodeSuffix _node
    set webserverNodeName 
    $webserverName$webserverNodeSuffix
    $AdminConfig remove 
      [$AdminConfig getid 
        /Node:$webserverNodeName/Server:$webserverName]
    $AdminConfig remove 
      [$AdminConfig getid /Node:$webserverNodeName]
    $AdminConfig save   

Alternativ können Sie die Scripts configureOs400WebServerDefinition und removeOs400WebServerDefinition verwenden, um diese Tasks auszuführen.

Ein verwalteter Knoten wiederum kann mehrere Web-Server-Definitionen haben. Das Script erstellt eine neue Web-Server-Definition, wenn der Name des Web-Servers abweicht.

Standard-Plug-in-Konfigurationsdatei durch die Datei der Web-Server-Definition ersetzen (Weitergabe)

Die Standarddatei verwendet festgelegte Parameterwerte, die möglicherweise nicht der echten Datei auf dem Anwendungsserver übereinstimmen. Die Standarddatei ist nur ein Platzhalter.

Die Datei kann keine Änderungen widerspiegeln, die an der Anwendungsserverkonfiguration vorgenommen werden. Die Datei kann außerdem keine von den Standardwerten abweichende Werte widerspiegeln, die im Anwendungsserver in Kraft sind.

[AIX Solaris HP-UX Linux Windows]Für den Anwendungsserver müssen die folgenden Werte in der echten Datei plugin-cfg.xml definiert sein. Nur dann kann die Standarddatei das binäre Plug-in-Modul ordnungsgemäß konfigurieren. Anschließend kann das Plug-in-Modul erfolgreich mit dem Web-Server und mit dem Anwendungsserver kommunizieren.

[AIX Solaris HP-UX Linux Windows]Sollten in der echten Datei plugin-cfg.xml des Anwendungsservers die folgenden Werte nicht definiert sein, konfiguriert die Standarddatei das binäre Plug-in-Modul nicht ordnungsgemäß. Das Plug-in-Modul kann immer mit dem Web-Server kommunizieren. Mit einer nicht ordnungsgemäß definierten Konfigurationsdatei ist das Plug-in-Modul jedoch nicht in der Lage, erfolgreich mit dem Anwendungsserver zu kommunizieren.

[AIX Solaris HP-UX Linux Windows]Nachfolgend sind die festgelegten Parameterwerte in der temporären Plug-in-Konfigurationsdatei aufgeführt.
  • Name des virtuellen Hosts

    Standardwert: default_host

    Dieser virtuelle Host ist so konfiguriert, dass er die Standardanwendung DefaultApplication bedient. In der Regel wird dieser Wert auch in der echten Datei plugin-cfg.xml verwendet. Nehmen wir jedoch an, Sie erstellen einen anderen virtuellen Host für die Anwendungen und installieren dort die Anwendung DefaultApplication. In diesem Fall wird die echte Datei plugin-cfg.xml neu generiert. Der Web-Server kann nicht auf die Anwendung DefaultApplication zugreifen. (Die Anwendung enthält die Servlets Snoop und HitCount.)

    Um auf Anwendungen im neuen virtuellen Host zugreifen zu können, geben Sie die echte Datei plugin-cfg.xml weiter. Bei der Weitergabe wird die aktualisierte Datei von der Anwendungsservermaschine auf die Web-Server-Maschine kopiert.

  • Port für HTTP-Transport

    Standardwert: 9080

    9080 ist der Standardwert für den HTTP-Transportport des virtuellen Hosts default_host. In der Regel wird dieser Wert auch in der aktualisierten Datei verwendet. Dieser Wert ändert sich jedoch für jedes Profil auf der Anwendungsservermaschine. Der Wert für den HTTP-Transportport muss für jeden Anwendungsserver eindeutig sein.

    Wenn Sie einen anderen Port verwenden möchten, müssen Sie den Wert ändern und die echte Datei plugin-cfg.xml weitergeben.

  • Empfangsport für Web-Server

    Standardwert: 80

    Der Wert 80 ist der Standardwert für den Port, der die Kommunikation mit dem Web-Server steuert. Jedes Anwendungsserverprofil muss für die Kommunikation mit einem Web-Server über einen eindeutigen Portwert verfügen. Der echte Portwert kann 81 oder eine andere Zahl sein.

    Um über einen anderen Port zu kommunizieren, geben Sie die echte Datei plugin-cfg.xml weiter.

  • Port für HTTPS-Transport

    Standardwert: 9443

    Der Wert 9443 ist der Standardwert für den Port für (sicheren) HTTPS-Transport des virtuellen Hosts Standardhost. Dieser Wert ist wahrscheinlich derselbe, wie der Wert in der aktualisierten Datei. Dieser Wert ändert sich jedoch für jedes Profil auf der Anwendungsservermaschine. Der Wert des Ports für HTTPS-Transport muss für jeden Anwendungsserver eindeutig sein.

    Um über einen anderen sicheren Port zu kommunizieren, geben Sie die echte Datei plugin-cfg.xml weiter.

  • Im Anwendungsserver server1 installierte Anwendungen

    Alle Standard-Servlets und Standardanwendungen sind in der Standarddatei enthalten.

    Um eine Anwendung zu bedienen, die Sie mit dem Web-Server entwickelt haben, geben Sie die echte Datei plugin-cfg.xml weiter.


Symbol, das den Typ des Artikels anzeigt. Konzeptartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cins_webserver
Dateiname:cins_webserver.html