![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
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]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
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.
Das Produkt Web Server Plug-ins
Configuration Tool muss die Konfigurationsdatei für einen unterstützten Web-Server neu konfigurieren.
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.
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.
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.
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.
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.
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.
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]](../images/dist.gif)
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]](../images/dist.gif)
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.
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.
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.
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]](../images/iseries.gif)
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.
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.
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.
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.
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]](../images/dist.gif)