Propriétés spécifiques aux serveurs virtuels

Les autres propriétés suivantes sont disponibles pour un serveur virtuel.

sso-max-inactive-seconds

Indique le nombre de secondes au-delà duquel l’enregistrement de connexion unique d’un utilisateur peut être supprimé si aucune activité cliente n’est reçue. Étant donné que la connexion unique s’applique à plusieurs applications du même serveur virtuel, le fait d’accéder à une application maintient l’enregistrement de connexion unique actif.

La valeur par défaut est de 300 secondes (5 minutes). Des valeurs supérieures offrent une persistance de connexion unique supérieure au détriment d’une plus grande consommation de mémoire sur le serveur.

sso-reap-interval-seconds

Indique le nombre de secondes entre les purges des enregistrements de connexion unique expirés.

La valeur par défaut est 60.

ssoCookieSecure

Définit l’attribut Secure de tous les cookies JSESSIONIDSSO associés aux applications Web déployées sur ce serveur virtuel. Cette propriété s’applique uniquement si la fonction de connexion unique est activée. Les valeurs autorisées sont :

true

Définit Secure sur true.

false

Définit Secure sur false.

dynamic

Le cookie JSESSIONIDSSO hérite du paramètre Secure de la première session participant à la SSO.

Pour définir l’attribut Secure d’un cookie JSESSIONID, utilisez la propriété cookie-properties de cookieSecure dans le fichier Sun-web.xml. Pour de plus amples détails, reportez-vous à la section cookie-properties du Oracle GlassFish Server 3.1 Application Deployment Guide.

setCacheControl

Spécifie une liste séparée par des virgules des directives de réponse Cache-Control. Pour obtenir une liste des directives valides, reportez-vous à la Section 14.9 du document à l’adresse http://www.ietf.org/rfc/rfc2616.txt .

accessLogBufferSize

Indique la taille (en octets) du tampon dans lequel sont enregistrés les appels du journal d’accès. Si la valeur est inférieure à 5120, un message d’avertissement est émis et la valeur est définie sur 5120. La valeur par défaut est 32768.

accessLogWriterInterval

Spécifie le délai (en secondes) avant que le journal ne soit écrit sur le disque. Le journal d’accès est écrit lorsque le tampon est saturé ou que l’intervalle expire. Si la valeur est égale à zéro, le tampon est toujours écrit, même s’il n’est pas plein. Autrement dit, chaque fois que l’utilisateur accède au serveur, le message journal est directement enregistré dans le fichier. La valeur par défaut est 300.

allowRemoteAddress

Spécifie une liste séparée par des virgules de modèles d’expressions régulières auxquels l’adresse IP du client distant est comparée. Si cette propriété est spécifiée, l’adresse distante doit correspondre pour que cette requête soit acceptée. Si cette propriété n’est pas spécifiée, toutes les requêtes sont acceptées à moins que l’adresse distante ne corresponde à un modèle denyRemoteAddress .

denyRemoteAddress

Spécifie une liste séparée par des virgules de modèles d’expressions régulières auxquels l’adresse IP du client distant est comparée. Si cette propriété est spécifiée, l’adresse distante ne doit pas correspondre pour que cette requête soit acceptée. Si cette propriété n’est pas spécifiée, l’acceptation de la requête est régie uniquement par la propriété allowRemoteAddress.

allowRemoteHost

Spécifie une liste séparée par des virgules de modèles d’expressions régulières auxquels le nom d’hôte du client distant (tel que renvoyé par [java.net.]Socket.getInetAddress().getHostName() ) est comparé. Si cette propriété est spécifiée, le nom d’hôte distant doit correspondre pour que cette requête soit acceptée. Si cette propriété n’est pas spécifiée, toutes les requêtes sont acceptées à moins que le nom d’hôte distant ne corresponde à un modèle denyRemoteHost .

denyRemoteHost

Spécifie une liste séparée par des virgules de modèles d’expressions régulières auxquels le nom d’hôte du client distant (tel que renvoyé par [java.net.]Socket.getInetAddress().getHostName() ) est comparé. Si cette propriété est spécifiée, le nom d’hôte distant ne doit pas correspondre pour que cette requête soit acceptée. Si cette propriété n’est pas spécifiée, l’acceptation de la requête est régie uniquement par la propriété allowRemoteHost.

Définir cette propriété n’a aucun effet si l’accès au domaine de GlassFish Server s’effectue par l’intermédiaire d’un auditeur de réseau dont l’option Listener JK est activée.

authRealm

Spécifie le nom d’un domaine d’authentification, qui remplace le domaine par défaut de l’instance du serveur pour les applications Web autonomes déployées sur ce serveur virtuel. Un domaine défini dans le fichier web.xml d’une application Web autonome remplace le domaine du serveur virtuel. Pour plus d’informations, reportez-vous à la rubrique Realms.

securePagesWithPragma

Définissez cette propriété sur false pour vous assurer que, pour toutes les applications Web sur ce serveur virtuel, les téléchargements de fichiers utilisant SSL fonctionnent correctement dans Internet Explorer.

Les applications Web individuelles peuvent remplacer ce paramètre en utilisant l’élément sun-web-app du fichier sun-web.xml. Pour de plus amples détails, reportez-vous à la section glassfish-web-app du Oracle GlassFish Server 3.1 Application Deployment Guide.

La valeur par défaut est true.

alternatedocroot_n

Spécifie une racine de document (docroot) alternative, où n est un entier positif qui permet la spécification de plus d’une racine. Les racines de document alternatives permettent aux applications Web de servir des requêtes pour certaines ressources en dehors de leur propre racine de document, selon que ces requêtes correspondent à un (ou plusieurs) des modèles URI des autres racines de document de l’application Web.

Si une requête correspond au modèle URI d’une racine de document alternative, elle est mappée à cette autre racine en ajoutant l’URI de requête (moins la racine contexte de l’application Web) à l’emplacement physique (répertoire) de la racine de document alternative. Si une requête correspond à plusieurs modèles URI, la racine de document alternative est déterminée en fonction de l’ordre de priorité suivant :

Par exemple, les propriétés suivantes spécifient trois racines de document alternatives. Le modèle URI de la première racine de document alternative utilise une correspondance exacte, tandis que les modèles URI des deuxième et troisième racines de document alternatives utilisent des correspondances d’extension et de préfixe de chemin le plus long, respectivement.

<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"/>

La valeur de chaque racine de document alternative dispose de deux composants : le premier composant, from, spécifie le modèle URI de la racine de document alternative et le second composant, dir, spécifie l’emplacement physique (répertoire) de la racine de document alternative. Les espaces sont autorisés dans le composant dir.

Les applications Web individuelles peuvent remplacer ce paramètre en utilisant l’élément sun-web-app du fichier sun-web.xml. Pour de plus amples détails, reportez-vous à la section glassfish-web-app du Oracle GlassFish Server 3.1 Application Deployment Guide.

contextXmlDefault

Spécifie l’emplacement, relatif à domain-dir, du fichier context.xml pour ce serveur virtuel, le cas échéant. Pour plus d’informations sur le fichier context.xml, consultez The Context Container.

allowLinking

Si la valeur est true (vrai), les ressources représentant des liens symboliques seront utilisées pour toutes les applications Web déployées sur ce serveur virtuel. Les applications Web individuelles peuvent remplacer ce paramètre en utilisant la propriété sun-web-app allowLinking du fichier sun-web.xml :

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

Pour de plus amples détails, reportez-vous à la section glassfish-web-app du Oracle GlassFish Server 3.1 Application Deployment Guide.

La valeur par défaut est false.


Attention - Sur les systèmes Windows, définir cette propriété sur true a pour effet d’exposer le code source JSP.


send-error_n

Spécifie les mappages de la page d’erreur personnalisée pour le serveur virtuel, qui sont hérités par toutes les applications Web déployées sur ce serveur virtuel. Une application Web peut remplacer les mappages de la page d’erreur personnalisée dans son descripteur de déploiement web.xml. La valeur de chaque propriété send-error_ n a trois composants, qui peuvent être spécifiés dans n’importe quel ordre :

Exemple :

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

Cet exemple de définition de propriété entraîne le renvoi du contenu de /myhost/401.html avec les réponses 401, avec la ligne de réponse suivante :

HTTP/1.1 401 MY-401-REASON
redirect_n

Spécifie qu’une requête pour une ancienne URL est traitée comme une requête pour une nouvelle URL. Ces propriétés sont héritées par toutes les applications Web déployées sur le serveur virtuel. La valeur de chaque propriété redirect_n a deux composants, qui peuvent être spécifiés dans n’importe quel ordre :

Exemple :

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

Spécifie le nom de classe qualifié complet d’une valve personnalisée, où n est un entier positif qui permet d’en spécifier plusieurs. La classe de valve doit implémenter l’interface org.apache.catalina.Valve à partir de Tomcat ou de versions précédentes de GlassFish Server ou l’interface org.glassfish.web.valve.GlassFishValve à partir de la version GlassFish Server actuelle. Exemple :

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

Vous pouvez définir cette propriété pour une application Web spécifique. Pour de plus amples détails, reportez-vous à la section glassfish-web-app du Oracle GlassFish Server 3.1 Application Deployment Guide.

listener_n

Spécifie le nom de classe qualifié complet d’un module d’écoute Catalina personnalisé, où n est un entier positif qui permet d’en spécifier plusieurs. La classe du module d’écoute doit implémenter l’interface org.apache.catalina.ContainerListener ou org.apache.catalina.LifecycleListener . Par exemple :

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

Vous pouvez définir cette propriété pour une application Web spécifique. Pour de plus amples détails, reportez-vous à la section glassfish-web-app du Oracle GlassFish Server 3.1 Application Deployment Guide.

errorReportValve

Spécifie le nom de classe complet d'une valve personnalisée produisant des pages d'erreur par défaut pour les applications sur ce serveur virtuel. Spécifiez une chaîne vide pour désactiver le mécanisme de page d'erreur par défaut pour ce serveur virtuel.

Copyright © 2010, Oracle et/ou ses affiliés. Tous droits réservés. Notice légale