Eigenschaften für Webserver-Plug-ins

Verwenden Sie diese Seite, um die Einstellungen einer Konfigurationsdatei eines Webserver-Plug-ins anzuzeigen oder zu ändern. Die Plug-in-Konfigurationsdatei plugin_cfg.xml enthält die Eigenschaften, die für die Kommunikation zwischen dem Webserver und dem Anwendungsserver erforderlich sind.

Klicken Sie zum Anzeigen dieser Seite der Administrationskonsole auf Server > Servertypen > Webserver > Name_des_Webservers > Plug-in-Eigenschaften.

Sie können die Felder auf der Registerkarte Konfiguration editieren. Die Felder auf der Registerkarte Laufzeit sind schreibgeschützt.

Die Registerkarte Laufzeit ist nur verfügbar, wenn der Webserver auf Anwendungen, die in den Anwendungsservern ausgeführt werden, zugegriffen hat und eine Datei http_plugin.log vorhanden ist.

Register 'Konfiguration'

DNS-Fehler beim Webserverstart ignorieren

Gibt an, ob das Plug-in beim Start DNS-Fehler in einer Konfiguration ignoriert.

Dieses Feld entspricht dem Element "IgnoreDNSFailures" in der Datei "plugin-cfg.xml".

Hat die Einstellung den Wert true, ignoriert das Plug-in DNS-Fehler in einer Konfiguration und wird gestartet, wenn mindestens ein Server pro Servercluster den Hostnamen auflösen kann. Jeder Server, für den der Hostname nicht aufgelöst werden kann, wird für die Lebensdauer der Konfiguration als nicht verfügbar gekennzeichnet. Bei der Weiterleitung von Anforderungen werden später keine Versuche unternommen, den Hostnamen aufzulösen. Tritt ein DNS-Fehler auf, wird eine Protokollnachricht in die Protokolldatei des Plug-in geschrieben, und die Initialisierung des Plug-in wird fortgesetzt und behindert nicht den Start des Webservers. Wenn Sie false angeben, verhindern DNS-Fehler das Starten des Webservers.

Datentyp String
Standardeinstellung false
Konfigurationsintervall aktualisieren

Gibt das Intervall (in Sekunden) an, in dem das Plug-in die Konfigurationsdatei auf Aktualisierungen oder Änderungen überprüfen soll. Das Plug-in überprüft die Datei auf alle Änderungen, die seit dem Zeitpunkt, zu dem die Plug-in-Konfiguration geladen wurde, vorgenommen wurden.

In einer Entwicklungsumgebung, in der Änderungen häufig auftreten, ist ein Wert, der niedriger als der Standardwert von 60 Sekunden ist, vorzuziehen. In Produktionsumgebungen ist ein höherer Wert als der Standardwert vorzuziehen, weil dort nicht mehr so häufig Änderungen an der Konfiguration vorgenommen werden. Sollte das erneute Laden des Plug-in fehlschlagen, wird eine entsprechende Nachricht in die Protokolldatei des Plug-in geschrieben und die vorherige Konfiguration so lange verwendet, bis die Konfigurationsdatei des Plug-in fehlerfrei geladen werden kann. Wenn die Änderungen, die Sie an der Plug-in-Konfiguration vorgenommen haben, nicht angezeigt werden, durchsuchen Sie die Protokolldatei des Plug-in nach Anhaltspunkten zum Fehler.

Datentyp Integer
Standardeinstellung 60 Sekunden
Name der Plug-in-Konfigurationsdatei

Gibt den Dateinamen der Konfigurationsdatei für das Plug-in an. Der Anwendungsserver generiert die Datei plugin-cfg.xml standardmäßig. Die Konfigurationsdatei definiert die Anwendungen, Anwendungsserver, Cluster und HTTP-Ports für den Webserver. Der Webserver verwendet die Datei, um auf die implementierten Anwendungen in verschiedenen Anwendungsservern zuzugreifen.

Sie können den Namen der Plug-in-Konfigurationsdatei ändern. Wenn Sie den Namen ändern, müssen Sie jedoch auch die Webserver-Konfiguration so ändern, dass sie auf die neue Plug-in-Konfigurationsdatei zeigt.

Wenn Sie während der Installation ein Webserver-Plug-in auswählen, konfiguriert das Installationsprogramm den Webserver und gibt, sofern möglich, die Position der Datei plugin-cfg.xml an. Die Plug-in-Konfigurationsdatei wird standardmäßig im Verzeichnis Plug-in-Stammverzeichnis/config/Name_des_Webservers installiert.

Das Installationsprogramm fügt der Webserver-Konfiguration eine Anweisung hinzu, die die Position der Datei plugin-cfg.xml angibt.

Für ferne Webserver müssen Sie die Datei aus dem lokalen Verzeichnis, in dem der Anwendungsserver installiert ist, auf die ferne Maschine kopieren. Dieses Verfahren wird als Weitergabe der Plug-in-Konfigurationsdatei bezeichnet. Wenn Sie IBM HTTP Server Version 6.1 oder höher für Ihren Webserver verwenden, kann WebSphere Application Server die Plug-in-Konfigurationsdatei automatisch an ferne Maschinen weiterleiten, sofern ein funktionierender HTTP-Transportmechanismus für die Weitergabe der Datei vorhanden ist.

Sie können auf Anzeigen klicken, um eine Kopie der aktuellen Plug-in-Konfigurationsdatei anzuzeigen.

Datentyp String
Standardeinstellung plugin-cfg.xml
Plug-in-Konfigurationsdatei automatisch generieren
Gehen Sie wie folgt vor, wenn die Plug-in-Konfigurationsdatei für einen fernen Webserver automatisch erstellt werden soll:
  • Wählen Sie dieses Feld aus.
  • Stellen Sie sicher, dass der Konfigurationsservice für Plug-ins aktiviert ist.
Wenn der Konfigurationsservice für Plug-ins aktiviert ist, wird automatisch eine Plug-in-Konfigurationsdatei für einen Webserver erstellt, wenn
  • Der Administrator des WebSphere Application Server definiert einen neuen Webserver.
  • eine Anwendung in einem Anwendungsserver implementiert wird,
  • eine Anwendung deinstalliert wird,
  • die Definition eines virtuellen Hosts aktualisiert und gespeichert wird.

Dieses Feld ist standardmäßig ausgewählt. Wählen Sie das Kontrollkästchen ab, wenn Sie manuell eine Plug-in-Konfigurationsdatei für diesen Webserver erstellen möchten.

[AIX Solaris HP-UX Linux Windows] Wichtig: Wenn die Plug-in-Konfigurationsdatei generiert wird, ist "admin_host" nicht in der Liste der virtuellen Hosts enthalten. Der Artikel im Information Center, der sich damit befasst, wie man Webservern die Berechtigung für den Zugriff auf die Administrationskonsole erteilt, beschreibt, wie "admin_host" zur Liste virtueller Hosts hinzugefügt wird.
Plug-in-Konfigurationsdatei automatisch weitergeben
Gibt an, ob der Anwendungsserver automatisch eine Kopie einer geänderten Plug-in-Konfigurationsdatei an einen Webserver weitergeben soll:
  • Wählen Sie dieses Feld aus.
  • Stellen Sie sicher, dass der Konfigurationsservice für Plug-ins aktiviert ist.
  • In einer Network-Deployment-Umgebung muss ein Node Agent von WebSphere Application Server auf dem Knoten mit dem Webserver, der der geänderten Plug-in-Konfigurationsdatei zugeordnet ist, vorhanden sein.
Dieses Feld ist standardmäßig ausgewählt.
Anmerkung: Die Plug-in-Konfigurationsdatei kann nur dann automatisch an einen fernen Webserver weitergegeben werden, wenn dieser Webserver ein Webserver des Typs IBM HTTP Server Version 6.1 oder höher ist und der zugehörige Verwaltungsserver aktiv ist.

Da der Konfigurationsservice für Plug-ins im Hintergrund ausgeführt wird und nicht an die Administrationskonsole gebunden ist, kann die Administrationskonsole die Ergebnisse der automatischen Weitergabe nicht anzeigen.

[AIX Solaris HP-UX Linux Windows] Für verteilte Plattformen können Sie nach zugehörigen Nachrichten in der Datei "SystemOut.log" des Deployment Manager suchen, um sicherzustellen, dass die automatische Weitergabe ordnungsgemäß verlaufen ist.

[z/OS] Für die Plattform z/OS können Sie nach zugehörigen Nachrichten im Protokoll TSO JOB suchen, um sicherzustellen, dass die automatische Weitergabe ordnungsgemäß verlaufen ist.

Dateiname des Plug-in-Keystores
Gibt den vollständig qualifizierten Verzeichnispfad und Dateinamen der Datenbankdatei mit den Sicherheitsschlüsselringen an, die das Webserver-Plug-in für HTTPS-Anforderungen. Diese Datei befindet sich auf dem Webserver, der diesem Webserver-Plug-in zugeordnet ist. Nachdem Sie den vollständig qualifizierten Verzeichnispfad und Dateinamen der Datenbankdatei angegeben haben, können Sie wie folgt vorgehen:
  • Klicken Sie auf Schlüssel und Zertifikate verwalten, um diese Datei zu aktualisieren.
  • Klicken Sie auf In das Keystore-Verzeichnis des Webservers kopieren, um eine Kopie dieser Datei zum Keystore-Verzeichnis für diesen Webserver hinzuzufügen.
Datentyp String
Standardeinstellung Ohne
Verzeichnis und Dateiname der Plug-in-Konfiguration

Gibt den vollständig qualifizierten Pfad der Webserverkopie der Webserver-Plug-in-Konfigurationsdatei an. Dieser Pfad enthält den Namen der Datei und die Position der Datei auf der Maschine, auf der der Webserver ausgeführt wird.

Verzeichnis und Dateiname des Plug-in-Keystores

Gibt den vollständig qualifizierten Pfad der Webserverkopie der Datenbankdatei an, die die Sicherheitsschlüsselringe enthält. Dieser Pfad enthält den Namen der Datei und die Position der Datei auf der Maschine, auf der der Webserver ausgeführt wird.

Plug-in-Protokollierung

Gibt die Position und den Namen der Datei http_plugin.log an. Diese Einstellung gibt auch den Geltungsbereich der Nachrichten im Protokoll an.

Das Protokoll beschreibt die Position und Stufe der Protokollnachrichten, die vom Plug-in geschrieben werden müssen. Wenn in der Konfigurationsdatei kein Protokoll angegeben wird, werden die Protokollnachrichten in einigen Fällen in das Fehlerprotokoll des Webservers geschrieben.

Wenn die Protokolldatei auf einer verteilten Plattform nicht vorhanden ist, wird sie erstellt. Ist die Protokolldatei bereits vorhanden, wird sie im Anhängemodus geöffnet, und die vorherigen Protokollnachrichten des Plug-in bleiben bestehen.

Name der Protokolldatei - Der vollständig qualifizierte Pfad zu der Protokolldatei, in die das Plug-in Fehlernachrichten schreibt.

Datentyp String
Standardeinstellung Plug-ins-Stammverzeichnis/logs/Name_des_Webservers/http_plugin.log

Geben Sie den Dateipfad der Datei http_plugin.log an.

Protokollstufe - Die Detaillierungsebene der Protokollnachrichten, die das Plug-in in das Protokoll schreiben muss. Sie können für dieses Attribut einen der folgenden Werte angeben:
  • Trace. Alle Schritte im Anforderungsprotokoll werden detailliert protokolliert.
  • Stats. Der für jede Anforderung ausgewählte Server und weitere Lastausgleichinformationen zur Anforderungsverarbeitung werden protokolliert.
  • Warn. Alle Warnungen und Fehlernachrichten, die Folge einer abnormalen Anforderungsverarbeitung sind, werden protokolliert.
  • Fehler. Es werden nur Fehlernachrichten, die Folge einer abnormalen Anforderungsverarbeitung sind, protokolliert.
  • Debug. Alle kritischen Schritte, die in Verarbeitungsanforderungen ausgeführt werden, werden protokolliert.
  • Detail. Alle Informationen zu Anforderungen und Antworten werden protokolliert.

Wenn keine Protokollstufe angegeben ist, wird der Standardwert Fehler verwendet.

Verwenden Sie die Einstellung Trace mit Vorsicht. Bei dieser Einstellung werden viele Nachrichten protokolliert, so dass der Plattenspeicherplatz sehr schnell erschöpft sein kann. In einer normalen Betriebsumgebung sollte die Einstellung Trace nicht verwendet werden, weil sie sich nachteilig auf den Durchsatz auswirkt.

[AIX Solaris HP-UX Linux Windows] [iSeries] [z/OS] Wichtig: Wenn der Webserver und das Webserver-Plug-in auf einem AIX-, HP-UX-, Linux- oder Solaris-System ausgeführt werden und Sie die Protokollstufe ändern, wird diese Änderung nicht dynamisch in der Datei "plugin-cfg.xml" nachvollzogen. Sie müssen den Webserver erneut starten und die Änderung auswählen. Wenn Sie auf Solaris-System den Webserver beispielsweise nicht erneut starten, erscheint die folgende Fehlernachricht in der Datei Ausgangsverzeichnis_des_Plug-in/logs/http_plugin.log:
ERROR: ws_config_parser:handleLogEnd: Failed to open log file 
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
Datentyp String
Standardeinstellung Fehler

Register 'Laufzeit'

Plug-in-Protokollierung

Gibt die Position und den Namen der Datei http_plugin.log an. Diese Einstellung gibt auch den Geltungsbereich der Nachrichten im Protokoll an.

Das Protokoll beschreibt die Position und Stufe der Protokollnachrichten, die vom Plug-in geschrieben werden müssen. Wenn in der Konfigurationsdatei kein Protokoll angegeben wird, werden die Protokollnachrichten in einigen Fällen in das Fehlerprotokoll des Webservers geschrieben.

Wenn die Protokolldatei auf einer verteilten Plattform nicht vorhanden ist, wird sie erstellt. Ist die Protokolldatei bereits vorhanden, wird sie im Anhängemodus geöffnet, und die vorherigen Protokollnachrichten des Plug-in bleiben bestehen.

Name der Protokolldatei - Der vollständig qualifizierte Pfad zu der Protokolldatei, in die das Plug-in Fehlernachrichten schreibt.

Datentyp String
Standardeinstellung Plug-ins-Stammverzeichnis/logs/Name_des_Webservers/http_plugin.log

Geben Sie den Dateipfad der Datei http_plugin.log an.

Protokollstufe - Die Detaillierungsebene der Protokollnachrichten, die das Plug-in in das Protokoll schreiben muss. Sie können für dieses Attribut einen der folgenden Werte angeben:
  • Trace. Alle Schritte im Anforderungsprotokoll werden detailliert protokolliert.
  • Stats. Der für jede Anforderung ausgewählte Server und weitere Lastausgleichinformationen zur Anforderungsverarbeitung werden protokolliert.
  • Warn. Alle Warnungen und Fehlernachrichten, die Folge einer abnormalen Anforderungsverarbeitung sind, werden protokolliert.
  • Fehler. Es werden nur Fehlernachrichten, die Folge einer abnormalen Anforderungsverarbeitung sind, protokolliert.
  • Debug. Alle kritischen Schritte, die in Verarbeitungsanforderungen ausgeführt werden, werden protokolliert.
  • Detail. Alle Informationen zu Anforderungen und Antworten werden protokolliert.

Wenn keine Protokollstufe angegeben ist, wird der Standardwert Fehler verwendet.

Verwenden Sie die Einstellung Trace mit Vorsicht. Bei dieser Einstellung werden viele Nachrichten protokolliert, so dass der Plattenspeicherplatz sehr schnell erschöpft sein kann. In einer normalen Betriebsumgebung sollte die Einstellung Trace nicht verwendet werden, weil sie sich nachteilig auf den Durchsatz auswirkt.

[AIX Solaris HP-UX Linux Windows] [iSeries] [z/OS] Wichtig: Wenn der Webserver und das Webserver-Plug-in auf einem AIX-, HP-UX-, Linux- oder Solaris-System ausgeführt werden und Sie die Protokollstufe ändern, wird diese Änderung nicht dynamisch in der Datei "plugin-cfg.xml" nachvollzogen. Sie müssen den Webserver erneut starten und die Änderung auswählen. Wenn Sie auf Solaris-System den Webserver beispielsweise nicht erneut starten, erscheint die folgende Fehlernachricht in der Datei Ausgangsverzeichnis_des_Plug-in/logs/http_plugin.log:
ERROR: ws_config_parser:handleLogEnd: Failed to open log file 
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS
Datentyp String
Standardeinstellung Fehler



Mit (online) gekennzeichnete Links setzen einen Internet-Zugang voraus.

Zugehörige Tasks
Zugehörige Verweise
Eigenschaften für die Anforderungs- und Antwortoptimierung eines Webserver-Plug-ins
Caching-Eigenschaften für Webserver-Plug-ins
Routing-Eigenschaften für Webserver-Plug-ins


Dateiname: uwsv_plugin_props.html