Web-Server-Plug-in (pluginConfiguration)
Beim Generieren der Konfigurationsdatei für Web-Server-Plug-ins verwendete Eigenschaften
| Attributname | Datentyp | Standardwert | Beschreibung |
|---|---|---|---|
| connectTimeout | Ein Zeitraum mit Sekundengenauigkeit. | 5s | Gibt an, wie lange der Anwendungsserver maximal eine Verbindung zum Web-Server verwaltet. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden. |
| extendedHandshake | boolean | false | Wenn diese Option ausgewählt ist (true), verwendet das Web-Server-Plug-in einen erweiterten Handshake, um festzustellen, ob der Anwendungsserver aktiv ist. |
| httpEndpointRef | Referenz auf das httpEndpoint-Element der höchsten Ebene (string) | defaultHttpEndpoint | Geben Sie die HTTP-Endpunkt-ID an, die in die generierte Datei plugin-cfg.xml eingeschlossen werden soll. Der Endpunkt definiert den Server im Cluster. Der Standardwert ist 'defaultHttpEndpoint'. |
| ipv6Preferred | boolean | false | Wird bei der Auflösung eines Anwendungsserver-Hostnamens {null} oder {0} verwendet, um den Typ der Adresse zu bevorzugen, sofern möchten. |
| logDirLocation | Pfad zu einem Verzeichnis | Veraltet: Gibt das Verzeichnis an, in dem sich die Datei http_plugin.log befindet. Siehe logFileName. | |
| logFileName | Pfad zu einer Datei | ${pluginInstallRoot}/logs/${webserverName}/http_plugin.log | Der vollständig qualifizierte Pfad zur Protokolldatei des Web-Server-Plug-ins. Die Verzeichniskomponente muss bereits vorhanden sein. Für Apache-basierte Web-Server wird ein Pfad, der mit einem Pipezeichen beginnt, als externe pipeorientierte Protokollfunktion interpretiert. Wenn diese Option angegeben ist, überschreibt der Pfad logDirLocation. |
| pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | Die Installationsposition des Web-Server-Plug-ins im Dateisystem des Web-Server-Hosts. |
| serverIOTimeout | Ein Zeitraum mit Sekundengenauigkeit. | 900s | Gibt an, wie lange das Web-Server-Plug-in maximal mit dem Senden einer Anforderung an den oder dem Empfang einer Antwort vom Anwendungsserver wartet. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden. |
| serverIOTimeoutRetry | int Minimum: -1 Maximum: 65535 |
-1 | Beschränkt die Anzahl der Anforderungswiederholungen nach einer Lese- oder Schreibzeitlimitüberschreitung. Wenn Sie den Standardwert {-1} angeben, gelten keine weiteren Limits, sodass die Wiederholungen durch die Anzahl der verfügbaren Server im Cluster beschränkt werden. Der Wert {0} gibt an, dass Anforderungen nicht wiederholt werden sollen. Dieser Wert gilt für den Server-Cluster und nicht für Verbindungsfehler oder Zeitlimitüberschreitungen, die auf eine Überschreitung des Verbindungszeitlimit des HTTP-Plug-ins oder auf Web-Socket-Zeitlimitüberschreitungen zurückzuführen sind. |
| sslCertlabel | string | Gibt den Kennsatz des Zertifikats in dem Schlüsselring an, den das Plug-in verwenden soll, wenn der Web-Container ein Clientzertifikat vom Plug-in anfordert. | |
| sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | Der vollständig qualifizierte Pfad der SSL-Schlüsselringdatei auf dem Web-Server-Host. |
| sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Der vollständig qualifizierte Pfad der SSL-Stashdatei auf dem Web-Server-Host. |
| waitForContinue | boolean | false | Wenn diese Option abgewählt ist (false, der Standardwert), sendet das Web-Server-Plug-in den Header "Expect: 100-continue" mit HTTP-Anforderungen, die einen Nachrichtenhauptteil haben. Wenn diese Option ausgewählt ist (true), sendet das Web-Server-Plug-in den Header "Expect: 100-continue" mit jeder HTTP-Anforderung. Sie können diese Einstellung auf den Wert true setzen, wenn Sie eine Firewall zwischen dem Web-Server und dem Anwendungsserver einsetzen und bei Anforderungswiederholungen ohne Anforderungshauptteil sensibel reagieren möchten. |
| webserverName | string | webserver1 | Der Name des Web-Servers, in dem diese Konfiguration verwendet wird. Wird verwendet, um die Position der Plug-in-Protokolldatei zu generieren, falls diese nicht explizit mit einen Protokolldateinamen oder -verzeichnis angegeben wird. |
| webserverPort | int Minimum: -1 Maximum: 65535 |
80 | Web-Server-HTTP-Port |
| webserverSecurePort | int Minimum: -1 Maximum: 65535 |
443 | Web-Server-HTTPS-Port |
| wsServerIOTimeout | Ein Zeitraum mit Sekundengenauigkeit. | Gibt an, wie lange das Web-Server-Plug-in maximal mit dem Senden einer Anforderung an den oder dem Empfang einer WebSockets-Antwort vom Anwendungsserver wartet. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden. | |
| wsServerIdleTimeout | Ein Zeitraum mit Sekundengenauigkeit. | Gibt an, wie lange das Web-Server-Plug-in maximal mit der Beendigung einer inaktiven WebSockets-Verbindung wartet. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden. |
- httpEndpoint
Beschreibung: Geben Sie die HTTP-Endpunkt-ID an, die in die generierte Datei plugin-cfg.xml eingeschlossen werden soll. Der Endpunkt definiert den Server im Cluster. Der Standardwert ist 'defaultHttpEndpoint'.Erforderlich: falseDatentyp: Attributname Datentyp Standardwert Beschreibung accessLoggingRef Referenz auf das httpAccessLogging-Element der höchsten Ebene (string) Konfiguration der HTTP-Zugriffsprotokollierung für den Endpunkt. enabled boolean true Aktiviert bzw. inaktiviert einen Endpunkt. Wenn Sie diese Eigenschaft auf "true" setzen, wird dieser Endpunkt vom Dispatcher für die Verarbeitung von HTTP-Anforderungen aktiviert. host string localhost Die IP-Adresse, der DNS-Hostname mit dem Domänennamenssuffix oder nur der DNS-Hostname der von einem Client für die Anforderung einer Ressource verwendet wird. Verwenden Sie '*' für alle verfügbaren Netzschnittstellen. httpOptionsRef Referenz auf das httpOptions-Element der höchsten Ebene (string) defaultHttpOptions HTTP-Protokolloptionen für den Endpunkt. httpPort int Minimum: -1
Maximum: 65535
Der für HTTP-Clientanforderungen verwendete Port. Verwenden Sie -1, um diesen Port zu inaktivieren. httpsPort int Minimum: -1
Maximum: 65535
Der für HTTP-Clientanforderungen, die mit SSL (https) gesichert sind, verwendete Port. Verwenden Sie -1, um diesen Port zu inaktivieren. onError - IGNORE
- FAIL
- WARN
WARN Aktion, die ausgeführt werden soll, wenn ein Endpunkt nicht gestartet werden konnte. - IGNORE
- Der Server gibt keine Warnungen und Fehlernachrichten aus, wenn ein Konfigurationsfehler auftritt.
- FAIL
- Der Server gibt eine Warnung oder Fehlernachricht beim ersten Auftreten des Fehlers aus und stoppt den Server dann.
- WARN
- Der Server gibt Warnungen und Fehlernachrichten aus, wenn ein Konfigurationsfehler auftritt.
sslOptionsRef Referenz auf das sslOptions-Element der höchsten Ebene (string) SSL-Protokolloptionen für den Endpunkt. tcpOptionsRef Referenz auf das tcpOptions-Element der höchsten Ebene (string) defaultTCPOptions TCP-Protokolloptionen für den Endpunkt. - httpEndpoint > accessLogging
Beschreibung: Konfiguration der HTTP-Zugriffsprotokollierung für den Endpunkt.Erforderlich: falseDatentyp: Attributname Datentyp Standardwert Beschreibung enabled boolean true Aktiviert die Zugriffsprotokollierung. filePath Pfad zu einer Datei ${server.output.dir}/logs/http_access.log Der Verzeichnispfad und der Name der Zugriffsprotokolldatei. Bei der Angabe des Verzeichnispfads können Standardvariablensubstitutionen wie ${server.output.dir} verwendet werden. logFormat string %h %u %{t}W "%r" %s %b Gibt das Protokollformat an, das für die Protokollierung von Clientzugriffsinformationen verwendet wird. maxFileSize int Minimum: 0
20 Die maximale Größe in MB, die eine Protokolldatei annehmen kann, bevor ein Rollover stattfindet. Der Wert 0 bedeutet, dass die Größe nicht begrenzt ist. maxFiles int Minimum: 0
2 Die maximale Anzahl an Protokolldateien, die erstellt werden können, bevor die älteste entfernt wird. Der Wert 0 bedeutet, dass die Anzahl nicht begrenzt ist.
- httpEndpoint > httpOptions
Beschreibung: HTTP-Protokolloptionen für den Endpunkt.Erforderlich: falseDatentyp: Attributname Datentyp Standardwert Beschreibung keepAliveEnabled boolean true Aktiviert persistente Verbindungen (HTTP-Keepalive). Wenn Sie diese Eigenschaft auf "true" setzen, bleiben Verbindungen für die Wiederverwendung durch mehrere aufeinanderfolgende Anforderungen und Antworten aktiv. Wenn Sie diese Eigenschaft auf "false" setzen, werden Verbindungen nach dem Senden der Antwort geschlossen. maxKeepAliveRequests int Minimum: -1
100 Gibt die maximal zulässige Anzahl persistenter Anforderungen in einer einzelnen HTTP-Verbindung an, wenn persistente Verbindungen aktiviert sind. Ein Wert von -1 bedeutet uneingeschränkt. persistTimeout Ein Zeitraum mit Sekundengenauigkeit. 30s Gibt an, wie lange ein Socket zwischen Anforderungen inaktiv bleiben darf. Diese Einstellung findet nur Anwendung, wenn persistente Verbindungen aktiviert sind. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden. readTimeout Ein Zeitraum mit Sekundengenauigkeit. 60s Gibt an, wie lange auf den Abschluss einer Leseanforderung an einem Socket nach Abschluss der ersten Leseanforderung gewartet wird. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden. removeServerHeader boolean false Entfernt die Informationen zur Serverimplementierung aus HTTP-Headern und inaktiviert die Standardeinführungsseite von Liberty Profile. writeTimeout Ein Zeitraum mit Sekundengenauigkeit. 60s Gibt an, wie lange an einem Socket auf die Übertragung jedes Teils der Antwortdaten gewartet wird. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden.
- httpEndpoint > sslOptions
Beschreibung: SSL-Protokolloptionen für den Endpunkt.Erforderlich: falseDatentyp: Attributname Datentyp Standardwert Beschreibung sessionTimeout Ein Zeitraum mit Sekundengenauigkeit. 1d Gibt an, wie lange auf den Abschluss einer Lese- oder Schreibanforderung an einem Socket gewartet wird. Dieser Wert wird von protokollspezifischen Zeitlimits überschrieben. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m) und Sekunden (s). Geben Sie 30 Sekunden beispielsweise als 30s an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1m30s entspricht beispielsweise 90 Sekunden. sslRef Referenz auf das ssl-Element der höchsten Ebene (string) Das SSL-Standardkonfigurationsrepertoire. Der Standardwert ist defaultSSLSettings. suppressHandshakeErrors boolean false Inaktiviert die Protokollierung von SSL-Handshake-Fehlern. SSL-Handshake-Fehler können während dem üblichen Betrieb auftreten. Diese Nachrichten können jedoch nützlich sein, wenn sich SSL nicht erwartungsgemäß verhält.
- httpEndpoint > tcpOptions
Beschreibung: TCP-Protokolloptionen für den Endpunkt.Erforderlich: falseDatentyp: Attributname Datentyp Standardwert Beschreibung inactivityTimeout Zeitraum mit Genauigkeit in Millisekunden 60s Gibt an, wie lange auf den Abschluss einer Lese- oder Schreibanforderung an einem Socket gewartet wird. Dieser Wert wird von protokollspezifischen Zeitlimits überschrieben. Geben Sie eine positive ganze Zahl, gefolgt von einer Zeiteinheit, an. Die gültigen Zeiteinheiten sind Stunden (h), Minuten (m), Sekunden (s) und Millisekunden (ms). Geben Sie 500 Millisekunden beispielsweise als 500ms an. Sie können mehrere Werte in einen einzigen Eintrag einschließen. 1s500ms entspricht beispielsweise 1,5 Sekunden. soReuseAddr boolean true Aktiviert die sofortige Neubindung an einen Port ohne aktiven Listener.
Referenzartikel