Eigenschaften für Web-Server-Plug-ins

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

Klicken Sie zum Anzeigen dieser Seite der Administrationskonsole auf Server > Servertypen > Web-Server > Name_des_Web-Servers > 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 Web-Server auf Anwendungen, die in den Anwendungsservern ausgeführt werden, zugegriffen hat und eine Datei http_plugin.log vorhanden ist.

Anmerkung: Dieser Artikel referenziert eine oder mehrere Protokolldateien des Anwendungsservers. Sie können alternativ (empfohlen) den Server dahingehend konfigurieren, dass er die HPEL-Protokoll- und -Traceinfrastruktur (High Performance Extensible Logging) verwendet und nicht die Dateien SystemOut.log , SystemErr.log, trace.log und activity.log auf verteilten Systemen und Systemen mit IBM i. Sie können HPEL auch in Verbindung mit Ihren nativen z/OS-Protokollierungsfunktionen verwenden. Wenn Sie HPEL verwenden, können Sie mit dem Befehlszeilentool LogViewer im Verzeichnis "bin" des Serverprofils auf alle Ihre Protokoll- und Tracedaten zugreifen. Weitere Informationen zur Verwendung von HPEL finden Sie in der Dokumentation zum Einsatz von HPEL für die Fehlerbehebung in Anwendungen.

DNS-Fehler beim Web-Serverstart 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 Server-Cluster den Hostnamen auflösen kann. Wenn der Server-Hostname nicht aufgelöst werden kann, wird er als nicht verfügbar markiert, so lange die Konfiguration existiert. Bei der Weiterleitung von Anforderungen werden später keine Versuche unternommen, den Hostnamen aufzulösen. Tritt ein DNS-Fehler auf, wird eine Nachricht in die Protokolldatei des Plug-ins geschrieben, und die Initialisierung des Plug-ins wird fortgesetzt.

Wenn der Wert false verwendet wird und DNS-Fehler auftreten, wird das Plug-in nicht initialisiert, und Anforderungen schlagen fehl. Der Web-Server wird jedoch gestartet.

Information	Wert
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.

Information	Wert
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 Web-Server. Der Web-Server verwendet die Datei, um auf die implementierten Anwendungen in verschiedenen Anwendungsservern zuzugreifen.

Fehler vermeiden: Das Feld ist inaktiviert und kann nicht geändert werden, wird aber für Informationszwecke angezeigt.gotcha

Wenn Sie eine andere Position verwenden möchten, müssen Sie Plug-in Configuration Tool erneut ausführen, um die neue Position zu definieren. Anschließend müssen Sie das neue Script configureWeb-Server ausführen, das vom Installationsprozess auf der Maschine mit WebSphere Application Server erzeugt wird.

Wenn Sie während der Installation ein Web-Server-Plug-in auswählen, konfiguriert das Installationsprogramm den Web-Server 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_Web-Servers installiert.

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

Für ferne Web-Server 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 Web-Server 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.

Information	Wert
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 Web-Server 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 Web-Server erstellt, wenn

Der Administrator des WebSphere Application Server definiert einen neuen Web-Server.
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 Web-Server erstellen möchten.

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 Web-Servern 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 Web-Server 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 Web-Server, 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 Web-Server weitergegeben werden, wenn dieser Web-Server ein Web-Server 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-Keystore

Gibt den vollständig qualifizierten Verzeichnispfad und Dateinamen der Datenbankdatei mit den Sicherheitsschlüsselringen an, die das Web-Server-Plug-in für HTTPS-Anforderungen. Diese Datei befindet sich auf dem Web-Server, der diesem Web-Server-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 Web-Servers kopieren, um eine Kopie dieser Datei zum Keystore-Verzeichnis für diesen Web-Server hinzuzufügen.

Information	Wert
Datentyp	String
Standardeinstellung	Ohne

Verzeichnis und Dateiname der Plug-in-Konfiguration

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

Fehler vermeiden: Das Feld ist inaktiviert und kann nicht geändert werden, wird aber für Informationszwecke angezeigt.gotcha

Verzeichnis und Dateiname des Plug-in-Keystore

Gibt den vollständig qualifizierten Pfad der Web-Serverkopie 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 Web-Server ausgeführt wird.

Fehler vermeiden: Das Feld ist inaktiviert und kann nicht geändert werden, wird aber für Informationszwecke angezeigt.gotcha

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 Web-Servers 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.

Information	Wert
Datentyp	String
Standardeinstellung	`Plug-ins-Stammverzeichnis`/logs/`Name_des_Web-Servers`/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.

Wichtig: Wenn der Web-Server 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 Web-Server erneut starten und die Änderung auswählen. Wenn Sie auf Solaris-System den Web-Server 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

Information	Wert
Datentyp	String
Standardeinstellung	Fehler

Dateiname: uwsv_plugin_props.html