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

Plug-ins konfigurieren

Web Server Plug-ins Configuration Tool konfiguriert einen Anwendungsserver für einen Web-Server-Typ und erstellt eine Web-Serverkonfigurationsdefinition im Anwendungsserver. Lernen Sie die verschiedenen Verarbeitungspfade kennen, die Web Server Plug-ins Configuration Tool verwenden kann.

Dieser Artikel beschreibt die zwei Arten, auf die Web Server Plug-ins Configuration Tool einen Web-Server konfigurieren und die Plug-in-Konfigurationsdatei plugin-cfg.xml erstellen kann.

Unterstützte Konfigurationen Unterstützte Konfigurationen: Dieses Tool wird nur unter AIX, Linux und Windows unterstützt. Alternativ zu Web Server Plug-ins Configuration Tool können Sie auch das Befehlszeilentool "pct" mit einer Antwortdatei für die Konfiguration des Web-Servers verwenden. Weitere Informationen hierzu finden Sie im Abschnitt "Web-Server-Plug-in mit dem Tool pct konfigurieren".sptcfg
Vorbereitungen: Die Plug-ins und Web-Server-Konfigurationsdateien werden während der Konfiguration der Plug-ins aktualisiert. Falls Sie Web Server Plug-ins Configuration Tool oder das Befehlszeilentool pct als Benutzer ohne Rootberechtigung verwenden, stellen Sie vor Beginn einer Konfiguration sicher, dass Sie die entsprechenden Berechtigungen haben, um die Konfigurationsdateien für Web-Server-Plug-ins und für Ihren Web-Server (z. B. IHS) zu aktualisieren, besonders wenn Sie nicht der Eigner dieser Dateien sind.
Achtung: Wenn Sie Web Server Plug-ins Configuration Tool für die Konfiguration des IBM® HTTP Server-Administrationsservers verwenden, muss Websphere Customization Toolbox als "lokales" Konto mit Administrator- und Rootberechtigungen ausgeführt werden.

Außerdem muss die Standardkonfigurationsdatei httpd.conf im Verzeichnis <IHS-Ausgangsverzeichnis>/conf bleiben, und Sie müssen den Befehl setupadm nach der Administrationskonfiguration manuell ausführen.

Unterstützte Konfigurationen Unterstützte Konfigurationen: Web Server Plug-ins Configuration Tool ist für die Verwendung mit dem vollständigen Profil von WebSphere Application Server bestimmt. Für die Verwendung zum Generieren eines Web-Server-Plug-ins für das Liberty-Profil wird das Tool nicht benötigt und nicht unterstützt. Weitere Informationen zum Generieren eines Web-Server-Plug-ins für das Liberty-Profil finden Sie im Abschnitt Web-Server-Plug-in für das Liberty-Profil konfigurieren.sptcfg

Konfigurationsablauf

Web Server Plug-ins Configuration Tool löst alle Konfigurationen von Web-Server und WebSphere Application Server in zwei Szenareien auf: Ferne Plug-in-Konfiguration und lokale Plug-in-Konfiguration. Die Logik, die implementiert wird, um festzustellen, welches der Szenareien anzuwenden ist, sehen Sie in der folgenden Abbildung.

Plug-ins-Fluss der Design-Logik

Legende:
Installationstyp?
Der Installationstyp ist entweder fern oder lokal.

Wenn sich der Web-Server und der Anwendungsserver nicht auf demselben Computer befinden, wählen Sie das ferne Szenario. Wenn sich sowohl der Web-Server also auch der Anwendungsserver auf demselben Computer befinden, wählen Sie das lokale Szenario.

Profil?
Falls das Produkt installiert ist, das Profil aber versehentlich gelöscht wurde oder anderweitig fehlt, wird von einem fernen Installationsszenario ausgegangen. Erstellen Sie vor Ausführung des Scripts ein Profil.
Eigenständiger Anwendungsserver mit Web-Server-Definition?
Wenn das Profil eine vorhandene Web-Server-Definition hat, wird die Installation als ferne Plug-in-Konfiguration betrachtet. Für einen eigenständigen Anwendungsserver kann es nur eine Web-Server-Definition geben.

Szenario A. Lokale eigenständige Plug-in-Konfiguration

In diesem Szenario erstellt Web Server Plug-ins Configuration Tool eine Web-Server-Definition ohne Verwendung eines Scripts direkt im Anwendungsserverprofil.

Web Server Plug-ins Configuration Tool konfiguriert den Web-Server für die Verwendung der Datei plugin-cfg.xml, die im Anwendungsserverprofil enthalten ist. Der 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.

Nach der Konfiguration des Anwendungsservers für den lokalen Web-Server können Sie den Anwendungsserver und den Web-Server sofort starten.
Tabelle 1. Für das lokale Anwendungsserverszenario kommt die folgende Konfiguration in Frage.    
Profiltyp Automatische Erstellung der Web-Server-Definition? Web-Server bereits in der Anwendungsserverkonfiguration definiert?
Anwendungsserver Ja Nein

Ein Anwendungsserverprofil mit einer vorhandenen Web-Server-Definition muss als ferne Plug-in-Konfiguration verarbeitet werden. Ein Anwendungsserver kann nur eine Web-Server-Definition haben.

Im Szenario B finden Sie eine Beschreibung dieses Knotentyps.

Die folgende Übersicht veranschaulicht die Prozedur für die Überprüfung der Web-Server-Konfiguration:

  1. Starten Sie den Web-Server mit der richtigen Prozedur für Ihren Web-Server.
    Starten Sie IBM HTTP Server beispielsweise über eine Befehlszeile:
    • [AIX][HP-UX][Linux][Solaris]./IHS-Stammverzeichnis/bin/apachectl start
    • [Windows]IHS-Stammverzeichnis\bin\apache
  2. Starten Sie den Anwendungsserver.
    Wechseln Sie in das Verzeichnis Profilstammverzeichnis/bin, und führen Sie den Befehl startServer aus:
    • [AIX][HP-UX][Linux][Solaris]./Profilstammverzeichnis/bin/startServer.sh server1
    • [Windows]Profilstammverzeichnis\bin\startServer server1
    Öffnen Sie die Administrationskonsole, und speichern Sie die geänderte Konfiguration.
  3. Um den vom Anwendungsserver bereitgestellten internen HTTP-Transport zu testen, rufen Sie in Ihrem Browser die URL http://localhost:9080/snoop auf. Rufen Sie in Ihrem Browser die URL http://Hostname_der_Web-Server-Maschine/snoop auf, um das Web-Server-Plug-in zu testen.
  4. Überprüfen Sie, ob beide Webadressen die Seite "Snoop-Servlet - Request/Client Information" anzeigen.

Web Server Plug-ins Configuration Tool erstellt innerhalb des verteilten Profils auf einer fernen Maschine nicht automatisch eine Web-Server-Definition. Stattdessen erstellt das Tool das Script configureName_des_Web-Servers.

Web Server Plug-ins Configuration Tool konfiguriert den Web-Server für die Verwendung der Datei plugin-cfg.xml, die auf der Web-Server-Maschine im Verzeichnis Stammverzeichnis_für_Plug-ins/config/Name_des_Web-Servers verwaltet wird. Diese Datei muss regelmäßig weitergegeben werden. Hierbei wird die aktuelle Datei plugin-cfg.xml von der Anwendungsservermaschine kopiert und ersetzt die Datei Stammverzeichnis_für_Plug-ins/config/Name_des_Web-Servers/plugin-cfg.xml.

Nach der Installation des binären Plug-ins für den lokalen Web-Server können Sie den Anwendungsserver und den Web-Server auch starten, ohne zuvor das Script auszuführen. Wenn Sie das Script nicht ausführen, können Sie jedoch nicht von den Vorteilen einer Web-Server-Definition auf dem Anwendungsserverknoten profitieren.
Tabelle 2. Für das ferne Anwendungsserverszenario kommen die folgenden Konfigurationen in Frage.    
Profiltyp Erstellung der Web-Server-Definition? Web-Server bereits in der Anwendungsserverkonfiguration definiert?
Ein beliebiges Profil, wenn Sie in Web Server Plug-ins Configuration Tool einen fernen Installationstyp auswählen Per Script Nicht zutreffend
Kein Profil Per Script Nicht zutreffend
Eigenständiges Anwendungsserverprofil mit vorhandener Web-Server-Definition Per Script Ja

Der folgende Überblick veranschaulicht die Prozedur für die Überprüfung der temporären Datei Stammverzeichnis_für_Plug-ins/config/Name_des_Web-Servers/plugin-cfg.xml

Der Web-Server verwendet die temporäre Datei plugin-cfg.xml für die Kommunikation mit dem fernen Anwendungsserver.

Wenn dem HTTP-Transport im Anwendungsserver ein anderer Port als 9080 zugeordnet ist, kann der Test nicht erfolgreich ausgeführt werden. Fahren Sie mit dem nächsten Abschnitt fort, um auf dem Anwendungsserver die Web-Server-Definition zu erstellen und den Test der Konfiguration abzuschließen.

  1. Starten Sie den Web-Server mit der richtigen Prozedur für Ihren Web-Server.
    Starten Sie IBM HTTP Server beispielsweise über eine Befehlszeile:
    • [AIX][HP-UX][Linux][Solaris]./IHS-Stammverzeichnis/bin/apachectl start
    • [Windows]IHS-Stammverzeichnis\bin\apache
  2. Starten Sie den Anwendungsserver auf der fernen Maschine.
    Wechseln Sie in das Verzeichnis Profilstammverzeichnis/bin, und führen Sie den Befehl startServer aus:
    • [AIX][HP-UX][Linux][Solaris]./Profilstammverzeichnis/bin/startServer.sh server1
    • [Windows]Profilstammverzeichnis\bin\startServer server1
  3. Um den vom Anwendungsserver bereitgestellten internen HTTP-Transport zu testen, rufen Sie in Ihrem Browser die URL http://localhost:9080/snoop auf. Rufen Sie in Ihrem Browser die URL http://Hostname_der_Web-Server-Maschine/snoop auf, um das Web-Server-Plug-in zu testen.
  4. Überprüfen Sie, ob beide Webadressen die Seite "Snoop-Servlet - Request/Client Information" anzeigen.
Die folgende Übersicht veranschaulicht die Prozedur für die Durchführung der Konfiguration. Die Konfiguration ist erst abgeschlossen, wenn die Konfiguration des Anwendungsserverknotens eine Web-Server-Definition enthält. Die Web-Server-Definition ist ein zentrales Element bei der Neugenerierung einer gültigen Plug-in-Konfigurationsdatei plugin-cfg.xml.
  1. Erstellen Sie die Web-Server-Definition im Anwendungsserver.
    Führen Sie das Script aus, um die Web-Server-Definition in der Konfiguration des Anwendungsserverknotens manuell zu erstellen:
    1. Kopieren Sie das Script aus dem Verzeichnis Stammverzeichnis_für_Plug-ins/bin in das ferne Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin.
    2. Öffnen Sie ein Befehlsfenster und führen Sie das Script aus:
      • [AIX][HP-UX][Linux][Solaris]./configureName_des_Web-Servers.sh
      • [Windows]configureName_des_Web-Servers.bat
    Das Script configureName_des_Web-Servers kann drei Parameter enthalten: Profilname, Benutzername_Adminkonsole und Kennwort_Adminkonsole.
    • Profilname gibt den Namen des Profils an, mit dem die Web-Server-Definition erstellt wurde.
    • Benutzername_Adminkonsole gibt den Benutzernamen der Administrationskonsole an. Für das Profil mit der implementierten Administrationskonsole muss die Sicherheit der Administrationskonsole aktiviert sein. Dieser Parameter kann nicht verwendet werden, wenn kein Profilname angegeben wurde.
    • Kennwort_Adminkonsole gibt das zum Benutzernamen gehörige Kennwort an. Dieser Parameter kann nicht verwendet werden, wenn kein Profilname und kein Benutzername_Adminkonsole angegeben wurde.
    Anmerkung: Der Wert Knotenname_des_Web-Servers im Script ist eine Verknüpfung des Kurznamens, den Sie für den Web-Server ausgewählt haben und dem Suffix -node. Er wird während der Plug-in-Konfiguration automatisch erstellt und kann nicht geändert werden. Wenn Sie Ihren Web-Server während der Plug-in-Konfiguration beispielsweise meinServer genannt haben, ist der Wert für die zugehörige Web-Server-Definition, der nach der Ausführung des Scripts erstellt wird, meinServer-Knoten.

    Wenn die Sicherheit aktiviert oder der standardmäßig verwendete JMX-Connectortyp geändert wurde, bearbeiten Sie das Script, und geben Sie die erforderlichen Parameter an.

  2. Kopieren Sie die aktuelle Plug-in-Konfigurationsdatei plugin-cfg.xml im Verzeichnis Profilstammverzeichnis/config/cells/Zellenname/nodes/Name_des_Web-Servers_node/servers/Name_des_Web-Servers. Fügen Sie die Datei auf der Web-Server-Maschine ein, um die temporäre Datei Stammverzeichnis_für_Plug-ins/config/Name_des_Web-Servers/plugin-cfg.xml zu ersetzen. IBM HTTP Server unterstützt die automatische Weitergabe. Bei anderen Web-Servern kann eine manuelle Weitergabe erforderlich sein.
  3. Starten Sie den Web-Server mit der richtigen Prozedur für Ihren Web-Server.Öffnen Sie die Administrationskonsole, und speichern Sie die geänderte Konfiguration.
  4. Um den vom Anwendungsserver bereitgestellten internen HTTP-Transport zu testen, rufen Sie in Ihrem Browser die URL http://localhost:9080/snoop auf. Rufen Sie in Ihrem Browser die URL http://Hostname_der_Web-Server-Maschine/snoop auf, um das Web-Server-Plug-in zu testen.
  5. Überprüfen Sie, ob beide Webadressen die Seite "Snoop-Servlet - Request/Client Information" anzeigen.

Es gibt insgesamt zwei Szenarien für Web-Server-Plug-ins. Jedes Szenario bezieht sich auf eine eindeutige Position der Plug-in-Konfigurationsdatei plugin-cfg.xml.

Der Anwendungsserver generiert die Plug-in-Konfigurationsdatei. Aufgabe dieser Datei ist es, die Position aller für einen Web-Server relevanten Anwendungsserverobjekte zu publizieren und die Optionen für die Konfiguration des binären Plug-ins zu steuern. Die Datei gibt diese Objekte beispielsweise als Anwendungen und virtuelle Hosts für die Bereitstellung von Anwendungen an.

Falls der Web-Server nicht auf die Datei auf der Anwendungsservermaschine zugreifen kann, müssen Sie die Datei auf den Web-Server kopieren. Dieser Prozess wird als Weitergabe bezeichnet. Die Weitergabe erfolgt ausschließlich beim Szenario für ferne Plug-in-Konfiguration, in diesem Abschnitt also bei Szenario B.

Im lokalen Szenario kann der Web-Server auf die Datei plugin-cfg.xml zugreifen, da sich der Web-Server auf derselben Maschine wie die Datei befindet.

Bei allen Konfigurationen für das Szenario A befindet sich die Web-Server-Definition auf dem eigenen Web-Server-Knoten.

Durch eingeschränkte Verwaltungsoptionen können Sie die einzige Web-Server-Definition in der Administrationskonsole eines eigenständigen Anwendungsservers weder erstellen noch löschen. Da ein eigenständiger Anwendungsserver nicht in der Lage ist, eine Web-Server-Definition zu erstellen, werden die von Web Server Plug-ins Configuration Tool erstellten Konfigurationsscripts benötigt. Ohne diese Scripts können Sie auf einem eigenständigen Anwendungsserverknoten nicht einfach eine Web-Server-Definition erstellen.

Die Position der Datei plugin-cfg.xml für jede in diesem Artikel beschriebene Konfiguration wird in der folgenden Tabelle angegeben
Tabelle 3. Positionen der Plug-in-Konfigurationsdateien. In dieser Tabelle sind die Positionen der Plug-in-Konfigurationsdateien beschrieben.
Szenario Profiltyp Position der Datei plugin-cfg.xml
Stammverzeichnis_für_Plug-ins Profilstammverzeichnis auf dem Web-Server-Knoten
A Anwendungsserverprofil   X
B Ein beliebiges Profil, wenn Sie in Web Server Plug-ins Configuration Tool einen fernen Installationstyp auswählen X  
Kein Profil X  
Anwendungsserverprofil mit vorhandener Web-Server-Definition X  
Legende:
Stammverzeichnis_für_Plug-ins
Stammverzeichnis_für_Plug-ins/config/Name_des_Web-Servers/plugin-cfg.xml
Profilstammverzeichnis auf dem Web-Server-Knoten
Profilstammverzeichnis/config/cells/Zellenname/nodes/Name_des_Web-Servers_node/servers/Name_des_Web-Servers/plugin-cfg.xml

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



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