Für virtuelle Server spezifische Eigenschaften

Die folgenden zusätzlichen Eigenschaften stehen für virtuelle Server zur Verfügung.

sso-max-inactive-seconds

Gibt den Zeitraum (in Sekunden) an, nach dem der SSO-Eintrag eines Benutzers zum Löschen freigegeben wird, wenn keine Clientaktivität verzeichnet wird. Da der SSO-Eintrag für verschiedene Anwendungen auf demselben virtuellen Server verwendet wird, wird er durch den Zugriff auf eine beliebige der Anwendungen aktiv gehalten.

Der Standardwert ist 300 Sekunden (5 Minuten). Höhere Werte ermöglichen eine längere SSO-Persistenz für die Benutzer, jedoch zu Lasten eines höheren Arbeitsspeicherverbrauchs auf dem Server.

sso-reap-interval-seconds

Gibt den Zeitraum (in Sekunden) an, der zwischen zwei Löschvorgängen für abgelaufene SSO-Einträge vergeht.

Der Standardwert ist 60.

ssoCookieSecure

Legt das Attribut Secure aller JSESSIONIDSSO-Cookies fest, die mit den auf diesem virtuellen Server bereitgestellten Webanwendungen verbunden sind. Diese Eigenschaft ist nur verfügbar, wenn Single Sign-On (SSO) aktiviert ist. Folgende Werte sind zulässig:

wahr

Legt Secure auf "true" fest.

falsch

Legt Secure auf "false" fest.

dynamic

Das Cookie JSESSIONIDSSO übernimmt die Secure-Einstellung der ersten Sitzung, die an SSO teilnimmt.

Zum Festlegen des Secure-Attributs eines JSESSIONID-Cookies verwenden Sie die Eigenschaft cookieSecure cookie-properties in der Datei sun-web.xml. Weitere Informationen finden Sie unter cookie-properties in Oracle GlassFish Server 3.1 Application Deployment Guide .

setCacheControl

Eine durch Kommata getrennte Liste von Direktiven für Cache-Control-Antworten. Eine Liste gültiger Direktiven finden Sie in Abschnitt 14.9 des Dokuments unter http://www.ietf.org/rfc/rfc2616.txt .

accessLogBufferSize

Gibt die Größe des Puffers, in dem Zugriffsprotokollaufrufe gespeichert werden, in Byte an. Ist der Wert kleiner als 5120, wird eine Warnmeldung ausgegeben, und der Wert wird auf 5120 gesetzt. Der Standardwert beträgt 32768.

accessLogWriterInterval

Gibt die Anzahl Sekunden an, bevor das Protokoll auf die Festplatte geschrieben wird. Das Zugriffsprotokoll wird geschrieben, wenn der Puffer voll ist oder das Intervall abläuft. Beim Wert 0 werden die Pufferdaten immer geschrieben, auch wenn der Puffer nicht voll ist. Dies bedeutet, dass das Meldungsprotokoll bei jedem Zugriff auf den Server direkt in der Datei gespeichert wird. Der Standardwert beträgt 300.

allowRemoteAddress

Eine Liste durch Kommata getrennter regulärer Ausdrucksmuster, mit der die IP-Adresse des Remote-Client verglichen wird. Wenn diese Eigenschaft angegeben ist, muss für die Remote-Adresse Übereinstimmung bestehen, damit diese Anforderung akzeptiert wird. Wenn diese Eigenschaft nicht angegeben ist, werden alle Anforderungen akzeptiert, es sei denn, die Remote-Adresse stimmt mit einem denyRemoteAddress-Muster überein.

denyRemoteAddress

Eine Liste durch Kommata getrennter regulärer Ausdrucksmuster, mit der die IP-Adresse des Remote-Client verglichen wird. Wenn diese Eigenschaft angegeben ist, darf für diese Remote-Adresse keine Übereinstimmung bestehen, damit diese Anforderung akzeptiert wird. Wenn diese Eigenschaft nicht angegeben ist, wird das Akzeptieren von Anforderungen allein über die Eigenschaft allowRemoteAddress geregelt.

allowRemoteHost

Eine Liste durch Kommata getrennter regulärer Ausdrucksmuster, mit der der Hostname des Remote-Client (wie zurückgegeben von [java.net.]Socket.getInetAddress().getHostName() ) verglichen wird. Wenn diese Eigenschaft angegeben ist, muss für den Hostnamen dieses Remote-Client Übereinstimmung bestehen, damit diese Anforderung akzeptiert wird. Wenn diese Eigenschaft nicht angegeben ist, werden alle Anforderungen akzeptiert, es sei denn, der Hostname dieses Remote-Client stimmt mit einem denyRemoteHost-Muster überein.

denyRemoteHost

Eine Liste durch Kommata getrennter regulärer Ausdrucksmuster, mit der der Hostname des Remote-Client (wie zurückgegeben von [java.net.]Socket.getInetAddress().getHostName() ) verglichen wird. Wenn diese Eigenschaft angegeben ist, darf für den Hostnamen dieses Remote-Client keine Übereinstimmung bestehen, damit diese Anforderung akzeptiert wird. Wenn diese Eigenschaft nicht angegeben ist, wird das Akzeptieren von Anforderungen allein über die Eigenschaft allowRemoteHost geregelt.

Die Festlegung dieser Eigenschaft hat keine Wirkung, wenn der Zugriff auf die GlassFish-Server-Domäne über ein Netzwerk-Zielgerät erfolgt, für das die Option "JK-Zielgerät" aktiviert ist.

authRealm

Gibt den Namen eines Authentifizierungsbereichs an, der den Standardbereich einer Serverinstanz für eigenständige Webanwendungen, die in diesem virtuellen Server bereitgestellt werden, außer Kraft setzt. Ein Bereich, der in einer web.xml-Datei einer eigenständigen Webanwendung definiert ist, setzt den Bereich des virtuellen Servers außer Kraft. Weitere Informationen finden Sie unter Realms.

securePagesWithPragma

Setzen Sie diese Eigenschaft auf false, um sicherzustellen, dass das Herunterladen von Dateien über Internet Explorer unter Verwendung von SSL für alle Webanwendungen auf diesem virtuellen Server korrekt funktioniert.

Einzelne Webanwendungen können diese Einstellung durch Verwendung des sun-web-app-Elements in der Datei sun-web.xml außer Kraft setzen. Weitere Informationen finden Sie unter glassfish-web-app in Oracle GlassFish Server 3.1 Application Deployment Guide .

Der Standardwert ist true.

alternatedocroot_n

Gibt eine alternative Dokumenten-Root (Docroot) an, wobei n eine positive Ganzzahl ist, die die Angabe von mehr als einer Docroot erlaubt. Alternative Docroots ermöglichen Webanwendungen das Bearbeiten von Anforderungen für bestimmte Ressourcen von außerhalb ihrer eigenen Docroot, abhängig davon, ob diese Anforderungen mit einem (oder mehreren) der URI-Muster der alternativen Docroots der Webanwendung übereinstimmen.

Wenn die Anforderung mit dem URI-Muster einer alternativen Docroot übereinstimmt, wird es der alternativen Docroot zugeordnet, indem der URI der Anforderung (minus der Kontext-Root der Webanwendung) an den physikalischen Speicherort der alternativen Docroot (Verzeichnis) angehängt wird. Wenn eine Anforderung mit mehreren URI-Mustern übereinstimmt, wird die alternative Docroot anhand dieser Reihenfolge festgelegt:

Die folgenden Eigenschaften geben beispielweise drei alternative Docroots an: Im URI-Muster der ersten alternativen Docroot wird eine exakte Übereinstimmung verwendet, wogegen im URI-Muster der zweiten und dritten alternativen Docroot eine Erweiterung bzw. das längste Pfadpräfix verwendet werden.

<property name="alternatedocroot_1" 
   value="from=/my.jpg dir=/srv/images/jpg"/>
<property name="alternatedocroot_2" 
   value="from=*.jpg dir=/srv/images/jpg"/>
<property name="alternatedocroot_3" 
   value="from=/jpg/* dir=/src/images"/>

Der Wert jeder alternativen Docroot hat zwei Komponenten: Die erste Komponente, from, gibt das URI-Muster der alternativen Docroot an, die zweite Komponente, dir, gibt den physikalischen Speicherort der alternativen Docroot an (das Verzeichnis). Bei der dir-Komponente sind Zwischenräume erlaubt.

Einzelne Webanwendungen können diese Einstellung durch Verwendung des sun-web-app-Elements in der Datei sun-web.xml außer Kraft setzen. Weitere Informationen finden Sie unter glassfish-web-app in Oracle GlassFish Server 3.1 Application Deployment Guide .

contextXmlDefault

Gibt, relativ zu domain-dir, den Speicherort der context.xml-Datei für diesen virtuellen Server an, falls einer verwendet wird. Weitere Informationen zur context.xml-Datei finden Sie unter The Context Container.

allowLinking

Wenn diese Eigenschaft auf true gesetzt wird, werden Ressourcen in Form von symbolischen Verknüpfungen für alle Webanwendungen verwendet, die auf diesem virtuellen Server bereitgestellt sind. Einzelne Webanwendungen können diese Einstellung durch Verwendung der sun-web-app-Eigenschaft allowLinking in der Datei sun-web.xml überschreiben:

<sun-web-app>
   <property name="allowLinking" 
      value="{true|false}"/>
</sun-web-app>

Weitere Informationen finden Sie unter glassfish-web-app in Oracle GlassFish Server 3.1 Application Deployment Guide .

Der Standardwert ist false.


Achtung - Wenn diese Eigenschaft auf Windows-Systemen auf "true" gesetzt wird, wird JSP-Quellcode offengelegt.


send-error_n

Gibt die benutzerdefinierten Fehlerseitenzuordnungen für den virtuellen Server an, der von allen durch den virtuellen Server bereitgestellten Webanwendungen übernommen wird. Eine Webanwendung kann diese benutzerdefinierten Fehlerseitenzuordnungen in ihrer web.xml-Bereitstellungsbeschreibung außer Kraft setzen. Der Wert jeder send-error_ n-Eigenschaft hat drei Komponenten, die in jeder beliebigen Reihenfolge angegeben werden können:

Beispiel:

<property name="send-error_1"
   value="code=401 path=/myhost/401.html reason=MY-401-REASON"/>

Dieses Beispiel einer Eigenschaftendefinition führt dazu, dass der Inhalt von /myhost/401.html mit 401-Antworten sowie dieser Antwortzeile zurückgegebenwird:

HTTP/1.1 401 MY-401-REASON
redirect_n

Legt fest, dass eine Anforderung für einen alten URL als Anforderung für einen neuen URL behandelt wird. Diese Eigenschaften werden von allen Webanwendungen übernommen, die auf dem virtuellen Server bereitgestellt werden. Der Wert jeder redirect_ n-Eigenschaft hat zwei Komponenten, die in beliebiger Reihenfolge angegeben werden können:

Beispiel:

<property name="redirect_1" 
  value="from=/dummy url-prefix=http://etude"/>
valve_n

Gibt einen vollständig qualifizierten Klassennamen eines benutzerdefinierten Valve an, wobei n eine positive Ganzzahl ist, die die Angabe von mehr als einem Valve ermöglicht. Die Valve-Klasse muss die Schnittstelle org.apache.catalina.Valve aus Tomcat oder früheren GlassFish-Server-Versionen oder aber die Schnittstelle org.glassfish.web.valve.GlassFishValve aus der aktuellen GlassFish-Server-Version implementieren. Beispiel:

<property name="valve_1"
value="org.glassfish.extension.Valve"/>

Sie können diese Eigenschaft für eine bestimmte Webanwendung festlegen. Weitere Informationen finden Sie unter glassfish-web-app in Oracle GlassFish Server 3.1 Application Deployment Guide .

listener_n

Gibt einen vollständig qualifizierten Klassennamen eines benutzerdefinierten Catalina-Zielgeräts an, wobei n eine positive Ganzzahl ist, die die Angabe von mehr als einem Zielgerät ermöglicht. Die Zielgeräteklasse muss die Schnittstelle org.apache.catalina.ContainerListener oder org.apache.catalina.LifecycleListener implementieren. Beispiel:

<property name="listener_1"
value="org.glassfish.extension.MyLifecycleListener"/>

Sie können diese Eigenschaft für eine bestimmte Webanwendung festlegen. Weitere Informationen finden Sie unter glassfish-web-app in Oracle GlassFish Server 3.1 Application Deployment Guide .

errorReportValve

Gibt einen vollständig qualifizierten Klassennamen eines benutzerdefinierten Ventils an, das Standard-Fehlerseiten für Anwendungen auf diesem virtuellen Server produziert. Geben Sie eine leere Zeichenfolge an, um den Standard- Fehlerseitenmechanismus für diesen virtuellen Server zu deaktivieren.

Copyright © 2010, Oracle und/oder verbundene Unternehmen. Alle Rechte vorbehalten. Rechtlicher Hinweis