Web-Server-Plug-in (pluginConfiguration)
Bei der Generierung der Konfigurationsdatei für das Web-Server-Plug-in verwendete Eigenschaften
Attributname | Datentyp | Standardwert | Beschreibung |
---|---|---|---|
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. |
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 (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'. |
ipv6Preferred | boolean | false | Wird bei der Auflösung eines Anwendungsserver-Hostnamens {null} oder {0} verwendet, damit dieser Adresstyp bevorzugt verwendet wird. |
loadBalanceWeight | int | 20 | %plugin.loadBalanceWeight.desc |
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. |
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. | |
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | Installationsposition des Web-Server-Plug-ins im Dateisystem auf dem Web-Server-Host |
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. |
serverIOTimeoutRetry | int
Minimum: -1 Maximum: 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. |
serverRole |
|
PRIMARY | %plugin.serverRole.desc
|
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. | |
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 |
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 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
Minimum: -1 Maximum: 65535 |
80 | Web-Server-HTTP-Port |
webserverSecurePort | int
Minimum: -1 Maximum: 65535 |
443 | Web-Server-HTTPS-Port |
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. |
- extraConfigProperties
Beschreibung: 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.Erforderlich: falseDatentyp:
- 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 (string) der höchsten Ebene. Konfiguration der HTTP-Zugriffsprotokollierung für den Endpunkt. 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. httpOptionsRef Referenz auf das httpOptions-Element (string) der höchsten Ebene. 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 (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. - 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 sie von vorn überschrieben wird. 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 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 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 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. removeServerHeader boolean false Entfernt die Informationen zur Serverimplementierung aus HTTP-Headern und inaktiviert die Standardeinführungsseite des Liberty-Profils. 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.
- httpEndpoint > sslOptions
Beschreibung: SSL-Protokolloptionen für den Endpunkt.Erforderlich: falseDatentyp: Attributname Datentyp Standardwert Beschreibung 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. 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 %ssl.sslSessionTimeout.desc. 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. 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.
- 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.