pluginConfiguration - Web-Server-Plug-in (pluginConfiguration)

Bei der Generierung der Konfigurationsdatei für das Web-Server-Plug-in verwendete Eigenschaften

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsInstallationsposition des Web-Server-Plug-ins im Dateisystem auf dem Web-Server-Host
webserverNamestringwebserver1Der Name des Web-Servers, in dem diese Konfiguration verwendet wird. Wird für die Generierung der Position der Plug-in-Protokolldatei verwendet, wenn diese nicht explizit über den Namen der Protokolldatei oder den Namen des Protokollverzeichnisses angegeben wird.
webserverPortint
Min: -1

Max: 65535
80Web-Server-HTTP-Port
webserverSecurePortint
Min: -1

Max: 65535
443Web-Server-HTTPS-Port
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbVollständig qualifizierter Pfad zur SSL-Schlüsselringdatei auf dem Web-Server-Host
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthVollständig qualifizierter Pfad zur SSL-Stashdatei auf dem Web-Server-Host
sslCertlabelstringGibt die Bezeichnung des Zertifikats im Schlüsselring an, die das Plug-in verwenden soll, wenn der Web-Container ein Clientzertifikat vom Plug-in anfordert.
ipv6PreferredbooleanfalseWird bei der Auflösung eines Anwendungsserver-Hostnamens {null} oder {0} verwendet, damit dieser Adresstyp bevorzugt verwendet wird.
httpEndpointRefReferenz auf das httpEndpoint-Element (string) der höchsten Ebene.defaultHttpEndpointGeben 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'.
connectTimeoutZeitraum mit Genauigkeit in Sekunden5sGibt 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.
serverIOTimeoutZeitraum mit Genauigkeit in Sekunden900sGibt 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.
wsServerIOTimeoutZeitraum mit Genauigkeit in SekundenGibt 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.
wsServerIdleTimeoutZeitraum mit Genauigkeit in SekundenGibt 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.
extendedHandshakebooleanfalseWenn diese Option ausgewählt ist (true), verwendet das Web-Server-Plug-in einen erweiterten Handshake, um festzustellen, ob der Anwendungsserver aktiv ist.
waitForContinuebooleanfalseWenn 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.
logFileNamePfad zu einer DateiEin vollständig qualifizierter Pfad zur Protokolldatei des Web-Server-Plug-ins. Die Verzeichniskomponente muss immer vorhanden sein. Bei Apache-basierten Web-Servern wird ein Pfad, der mit einem Pipezeichen beginnt, als externe Protokollfunktion, die über eine Pipe erreicht wird, interpretiert. Wenn Sie einen Pfad angeben, überschreibt dieser den Parameter logDirLocation.
logDirLocationPfad zu einem Verzeichnis${pluginInstallRoot}/logs/${webserverName}Veraltet: Gibt das Verzeichnis an, in dem sich die Datei http_plugin.log befindet. Siehe Name der Protokolldatei.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1Beschränkt die Anzahl der Anforderungswiederholungen nach einer Überschreitung des Lese- oder Schreibzeitlimits. Wenn Sie den Standardwert {-1} verwenden, werden keine weiteren Beschränkungen angewendet und die Anzahl der Wiederholungen wird durch die Anzahl verfügbarer Server im Cluster beschränkt. 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 Überschreitungen des Verbindungszeitlimits des HTTP-Plug-ins bzw. des Web-Socket-Zeitlimits.
loadBalanceWeightint20Dieser Wert wird zur Laufzeit dynamisch geändert. Die Wertigkeit des Servers verringert sich mit jeder Zuordnung, die diesem Server zugewiesen wird. Wenn die Wertigkeiten aller Server auf 0 oder darunter fallen, passt das Web-Server-Plug-in alle Wertigkeiten erneut an, sodass sie größer als 0 sind.
serverRole
  • BACKUP
  • PRIMARY
PRIMARYDie Serverrolle identifiziert einen Server als primären Server oder Backup-Server. Wenn primäre Server verfügbar sind, verwendet das Web-Server-Plug-in diese für Lastausgleich und Failover. Wenn jedoch keiner der primären Server verfügbar ist, verwendet das Web-Server-Plug-in nur Backup-Server für Lastausgleich und Failover.
BACKUP
Backup
PRIMARY
Primär
ESIEnablebooleantrueDie Eigenschaft ESIEnable ermöglicht der ESI-Verarbeitung (Edge Side Include), die Antworten zwischenzuspeichern. Mit dieser Eigenschaft kann ESI in der Konfigurationsdatei für Web-Server-Plug-ins inaktiviert werden.
ESIMaxCacheSizeint1024ESIMaxCacheSize legt die maximale Größe des Cache fest (standardmäßig 1 MB). Mit dieser Eigenschaft kann der Wert in der Konfigurationsdatei für Web-Server-Plug-ins überschrieben werden.
ESIInvalidationMonitorbooleanfalseESIInvalidationMonitor gibt an, ob der ESI-Prozessor Invalidierungen vom Anwendungsserver empfangen soll. Mit dieser Eigenschaft kann der Wert in der Konfigurationsdatei für Web-Server-Plug-ins überschrieben werden.
ESIEnableToPassCookiesbooleanfalseESIEnableToPassCookies ermöglicht die Weiterleitung von Sitzungscookies an WebSphere Application Server. Mit dieser Eigenschaft kann der Wert in der Konfigurationsdatei für Web-Server-Plug-ins überschrieben werden.
trustedProxyEnablebooleanErmöglicht die Verwendung vertrauenswürdiger Proxys. Wenn diese Eigenschaft angegeben wird, überschreibt diese Eigenschaft den Wert in der Web-Server-Plug-in-Konfigurationsdatei.
trustedProxyGroupstringEine durch Kommas getrennte Liste mit vertrauenswürdigen Proxys. Wenn diese Eigenschaft angegeben wird, überschreibt diese Eigenschaft den Wert in der Web-Server-Plug-in-Konfigurationsdatei.

httpEndpoint

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'.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARNAktion, 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.
WARN
Der Server gibt 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.
enabledbooleantrueAktiviert bzw. inaktiviert einen Endpunkt. Wenn Sie diese Option auswählen, wird dieser Endpunkt vom Dispatcher für die Verarbeitung von HTTP-Anforderungen aktiviert.
hoststringlocalhostDie 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.
httpPortint
Min: -1

Max: 65535
Der für HTTP-Clientanforderungen verwendete Port. Verwenden Sie -1, um diesen Port zu inaktivieren.
httpsPortint
Min: -1

Max: 65535
Der für HTTP-Clientanforderungen, die mit SSL (https) gesichert sind, verwendete Port. Verwenden Sie -1, um diesen Port zu inaktivieren.
httpOptionsRefReferenz auf das httpOptions-Element (string) der höchsten Ebene.defaultHttpOptionsHTTP-Protokolloptionen für den Endpunkt.
sslOptionsRefReferenz auf das sslOptions-Element (string) der höchsten Ebene.SSL-Protokolloptionen für den Endpunkt.
tcpOptionsRefReferenz auf das tcpOptions-Element (string) der höchsten Ebene.defaultTCPOptionsTCP-Protokolloptionen für den Endpunkt.
accessLoggingRefReferenz auf das httpAccessLogging-Element (string) der höchsten Ebene.Konfiguration der HTTP-Zugriffsprotokollierung für den Endpunkt.

httpEndpoint > httpOptions

HTTP-Protokolloptionen für den Endpunkt.

NameTypeDefaultDescription
keepAliveEnabledbooleantrueAktiviert persistente Verbindungen (HTTP-Keepalive). Wenn Sie diese Option auswählen, bleiben Verbindungen für die Wiederverwendung durch mehrere aufeinanderfolgende Anforderungen und Antworten aktiv. Wenn Sie diese Option nicht auswählen, werden Verbindungen nach dem Senden der Antwort geschlossen.
maxKeepAliveRequestsint
Min: -1
100Gibt 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.
persistTimeoutZeitraum mit Genauigkeit in Sekunden30sGibt an, wie lange ein Socket zwischen Anforderungen inaktiv bleiben darf. Diese Einstellung gilt nur 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.
readTimeoutZeitraum mit Genauigkeit in Sekunden60sGibt 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.
writeTimeoutZeitraum mit Genauigkeit in Sekunden60sGibt 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.
removeServerHeaderbooleanfalseEntfernt die Informationen zur Serverimplementierung aus HTTP-Headern und inaktiviert die Standardeinführungsseite des Liberty-Profils.
NoCacheCookiesControlbooleantrueErmöglicht dem Benutzer festzulegen, ob beim Vorhandensein eines Headers Set-Cookie der Header Cache-Control mit einem übereinstimmenden Wert für no-cache aktualisiert wird. Damit wird auch der Header Expires hinzugefügt.
AutoDecompressionbooleantrueGibt an, ob der HTTP-Kanal die Daten im Hauptteil eingehender Anforderungen automatisch dekomprimiert.

httpEndpoint > sslOptions

SSL-Protokolloptionen für den Endpunkt.

NameTypeDefaultDescription
sessionTimeoutZeitraum mit Genauigkeit in Sekunden1dGibt 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.
suppressHandshakeErrorsbooleanfalseInaktiviert die Protokollierung von SSL-Handshakefehlern. SSL-Handshakefehler können während des normalen Betriebs auftreten, aber diese Nachrichten können hilfreich sein, wenn sich SSL nicht wie erwartet verhält.
sslRefReferenz auf das ssl-Element (string) der höchsten Ebene.Das SSL-Standardkonfigurationsrepertoire. Der Standardwert ist defaultSSLSettings.
sslSessionTimeoutZeitraum mit Genauigkeit in Millisekunden8640msDas Zeitlimit für eine über den SSL-Kanal hergestellte SSL-Sitzung. 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.

httpEndpoint > tcpOptions

TCP-Protokolloptionen für den Endpunkt.

NameTypeDefaultDescription
inactivityTimeoutZeitraum mit Genauigkeit in Millisekunden60sGibt 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.
soReuseAddrbooleantrueAktiviert die sofortige Neubindung an einen Port ohne aktiven Listener.
addressIncludeListstringEine durch Kommas getrennte Liste mit Adressen, die eingehende Verbindungen an diesem Endpunkt herstellen können. Es können IPv4- oder IPv6-Adressen angegeben werden. Alle Werte in einer IPv4- oder IPv6-Adresse müssen durch eine Zahl oder ein Platzhalterzeichen (Stern) dargestellt werden.
addressExcludeListstringEine durch Kommas getrennte Liste mit Adressen, die keine eingehenden Verbindungen an diesem Endpunkt herstellen können. Es können IPv4- oder IPv6-Adressen angegeben werden. Alle Werte in einer IPv4- oder IPv6-Adresse müssen durch eine Zahl oder ein Platzhalterzeichen (Stern) dargestellt werden.
hostNameIncludeListstringEine durch Kommas getrennte Liste mit Hostnamen, die eingehende Verbindungen an diesem Endpunkt herstellen können. Hostnamen, bei denen die Groß-/Kleinschreibung nicht beachtet werden muss, können mit einem Stern, der als Platzhalter verwendet wird, beginnen. An anderen Stellen im Hostnamen kann kein Stern verwendet werden. So ist beispielsweise *.abc.com gültig, *.abc.* aber nicht.
hostNameExcludeListstringEine durch Kommas getrennte Liste mit Hostnamen, die keine eingehenden Verbindungen an diesem Endpunkt herstellen können. Hostnamen, bei denen die Groß-/Kleinschreibung nicht beachtet werden muss, können mit einem Stern, der als Platzhalter verwendet wird, beginnen. An anderen Stellen im Hostnamen kann kein Stern verwendet werden. So ist beispielsweise *.abc.com gültig, *.abc.* aber nicht.

httpEndpoint > accessLogging

Konfiguration der HTTP-Zugriffsprotokollierung für den Endpunkt.

NameTypeDefaultDescription
enabledbooleantrueAktiviert die Zugriffsprotokollierung.
filePathPfad zu einer Datei${server.output.dir}/logs/http_access.logDer Verzeichnispfad und der Name der Zugriffsprotokolldatei. Bei der Angabe des Verzeichnispfads können Standardvariablensubstitutionen wie ${server.output.dir} verwendet werden.
logFormatstring%h %u %{t}W "%r" %s %bGibt das Protokollformat an, das für die Protokollierung von Clientzugriffsinformationen verwendet wird.
maxFileSizeint
Min: 0
20Die maximale Größe in MB, die eine Protokolldatei annehmen kann, bevor sie von vorn überschrieben wird. Der Wert 0 bedeutet, dass die Größe nicht begrenzt ist.
maxFilesint
Min: 0
2Die maximale Anzahl an Protokolldateien, die erstellt werden können, bevor die älteste entfernt wird. Der Wert 0 bedeutet, dass die Anzahl nicht begrenzt ist.

extraConfigProperties

Weitere Eigenschaften, die dem Element Config in der generierten Plug-in-Konfigurationsdatei hinzugefügt werden sollen. Diese Eigenschaften können vom IBM Support angegeben werden, um das Verhalten des Web-Server-Plug-ins zu ändern.