Bei der Generierung der Konfigurationsdatei für das Web-Server-Plug-in verwendete Eigenschaften
Name | Type | Default | Description |
---|---|---|---|
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | Installationsposition des Web-Server-Plug-ins im Dateisystem auf dem Web-Server-Host |
webserverName | string | webserver1 | Der 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. |
webserverPort | int Min: -1 Max: 65535 | 80 | Web-Server-HTTP-Port |
webserverSecurePort | int Min: -1 Max: 65535 | 443 | Web-Server-HTTPS-Port |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | Vollständig qualifizierter Pfad zur SSL-Schlüsselringdatei auf dem Web-Server-Host |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | Vollständig qualifizierter Pfad zur SSL-Stashdatei auf dem Web-Server-Host |
sslCertlabel | string | Gibt die Bezeichnung des Zertifikats im Schlüsselring an, die das Plug-in verwenden soll, wenn der Web-Container ein Clientzertifikat vom Plug-in anfordert. | |
ipv6Preferred | boolean | false | Wird bei der Auflösung eines Anwendungsserver-Hostnamens {null} oder {0} verwendet, damit dieser Adresstyp bevorzugt verwendet wird. |
httpEndpointRef | Referenz auf das httpEndpoint-Element (string) der höchsten Ebene. | 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'. |
connectTimeout | Zeitraum mit Genauigkeit in Sekunden | 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. |
serverIOTimeout | Zeitraum mit Genauigkeit in Sekunden | 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. |
wsServerIOTimeout | Zeitraum mit Genauigkeit in Sekunden | 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 | Zeitraum mit Genauigkeit in Sekunden | 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. | |
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. |
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. |
logFileName | Pfad zu einer Datei | Ein 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. | |
logDirLocation | Pfad zu einem Verzeichnis | ${pluginInstallRoot}/logs/${webserverName} | Veraltet: Gibt das Verzeichnis an, in dem sich die Datei http_plugin.log befindet. Siehe Name der Protokolldatei. |
serverIOTimeoutRetry | int Min: -1 Max: 65535 | -1 | Beschrä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. |
loadBalanceWeight | int | 20 | Dieser 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 |
| PRIMARY | Die 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 |
ESIEnable | boolean | true | Die 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. |
ESIMaxCacheSize | int | 1024 | ESIMaxCacheSize 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. |
ESIInvalidationMonitor | boolean | false | ESIInvalidationMonitor 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. |
ESIEnableToPassCookies | boolean | false | ESIEnableToPassCookies 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. |
trustedProxyEnable | boolean | Ermöglicht die Verwendung vertrauenswürdiger Proxys. Wenn diese Eigenschaft angegeben wird, überschreibt diese Eigenschaft den Wert in der Web-Server-Plug-in-Konfigurationsdatei. | |
trustedProxyGroup | string | Eine 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. |
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'.
Name | Type | Default | Description |
---|---|---|---|
onError |
| 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. 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. |
enabled | boolean | true | Aktiviert bzw. inaktiviert einen Endpunkt. Wenn Sie diese Option auswählen, 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. |
httpPort | int Min: -1 Max: 65535 | Der für HTTP-Clientanforderungen verwendete Port. Verwenden Sie -1, um diesen Port zu inaktivieren. | |
httpsPort | int 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. | |
httpOptionsRef | Referenz auf das httpOptions-Element (string) der höchsten Ebene. | defaultHttpOptions | HTTP-Protokolloptionen für den Endpunkt. |
sslOptionsRef | Referenz auf das sslOptions-Element (string) der höchsten Ebene. | SSL-Protokolloptionen für den Endpunkt. | |
tcpOptionsRef | Referenz auf das tcpOptions-Element (string) der höchsten Ebene. | defaultTCPOptions | TCP-Protokolloptionen für den Endpunkt. |
accessLoggingRef | Referenz auf das httpAccessLogging-Element (string) der höchsten Ebene. | Konfiguration der HTTP-Zugriffsprotokollierung für den Endpunkt. |
HTTP-Protokolloptionen für den Endpunkt.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | boolean | true | Aktiviert 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. |
maxKeepAliveRequests | int Min: -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 | Zeitraum mit Genauigkeit in Sekunden | 30s | Gibt 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. |
readTimeout | Zeitraum mit Genauigkeit in Sekunden | 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. |
writeTimeout | Zeitraum mit Genauigkeit in Sekunden | 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. |
removeServerHeader | boolean | false | Entfernt die Informationen zur Serverimplementierung aus HTTP-Headern und inaktiviert die Standardeinführungsseite des Liberty-Profils. |
NoCacheCookiesControl | boolean | true | Ermö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. |
AutoDecompression | boolean | true | Gibt an, ob der HTTP-Kanal die Daten im Hauptteil eingehender Anforderungen automatisch dekomprimiert. |
SSL-Protokolloptionen für den Endpunkt.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | Zeitraum mit Genauigkeit in Sekunden | 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. |
suppressHandshakeErrors | boolean | false | Inaktiviert 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. |
sslRef | Referenz auf das ssl-Element (string) der höchsten Ebene. | Das SSL-Standardkonfigurationsrepertoire. Der Standardwert ist defaultSSLSettings. | |
sslSessionTimeout | Zeitraum mit Genauigkeit in Millisekunden | 8640ms | Das 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. |
TCP-Protokolloptionen für den Endpunkt.
Name | Type | Default | Description |
---|---|---|---|
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. |
addressIncludeList | string | Eine 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. | |
addressExcludeList | string | Eine 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. | |
hostNameIncludeList | string | Eine 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. | |
hostNameExcludeList | string | Eine 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. |
Konfiguration der HTTP-Zugriffsprotokollierung für den Endpunkt.
Name | Type | Default | Description |
---|---|---|---|
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 Min: 0 | 20 | Die 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. |
maxFiles | int Min: 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. |
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.