virtualHost - Virtueller Host (virtualHost)

Ein virtueller Host stellt eine logische Gruppierung für die Konfiguration von Webanwendungen auf einem bestimmten Host dar. Der virtuelle Standardhost (default_host) ist für die meisten einfachen Konfigurationen geeignet.

NameTypeDefaultDescription
idstringEine eindeutige Konfigurations-ID.
enabledbooleantrueAktiviert diesen virtuellen Host.
allowFromEndpointRefListe mit Referenzen auf httpEndpoint-Elemente der höchsten Ebene (durch Kommas getrennte Zeichenfolge).Geben Sie die IDs der HTTP-Endpunkte an, auf die Sie den eingehenden Datenverkehr für diesen virtuellen Hosts beschränken möchten.

hostAlias

Ordnen Sie diesem virtuellen Host einen Hostnamen und einen Port mit der Syntax Host:Port zu. Sie können eine IP-Adresse, den Hostnamen eines Domänennamensservers (DNS) mit einem Domänennamenssuffix, den DNS-Hostnamen oder * für eine Platzhaltersuche in allen Hostnamen angeben. IPv6-Adressen müssen in [] eingeschlossen werden.

allowFromEndpoint

Geben Sie die IDs der HTTP-Endpunkte an, auf die Sie den eingehenden Datenverkehr für diesen virtuellen Hosts beschränken möchten.

NameTypeDefaultDescription
idstringEine eindeutige Konfigurations-ID.
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.

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

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

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

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