Propriétés propres aux serveurs virtuels

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

sso-max-inactive-seconds

Indique le délai (en secondes) au-delà duquel l'enregistrement de connexion unique d'un utilisateur peut être purgé si aucune activité client n'est détectée. Etant donné que la connexion unique s'applique à plusieurs applications sur le même serveur virtuel, le fait d'accéder à une application permet de garder l'enregistrement de connexion unique actif.

La valeur par défaut est de 300 secondes (5 minutes). Des valeurs supérieures offrent aux utilisateurs une persistance de connexion unique supérieure, mais avec 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 arrivés à expiration.

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 les suivantes :

True

Attribue la valeur True à l'attribut Secure.

False

Attribue la valeur False à l'attribut Secure.

dynamic

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

Pour définir l'attribut Secure d'un cookie JSESSIONID, utilisez la propriété cookieSecure cookie-properties dans le fichier sun-web.xml. Pour plus d'informations, reportez vous à cookie-properties dans le manuel Oracle GlassFish Server Application Deployment Guide.

setCacheControl

Fournit la liste des directives de réponse Cache-Control séparées par des virgules. Pour obtenir la liste des directives valides, reportez-vous à la section 14.9 du document disponible à l'adresse http://www.ietf.org/rfc/rfc2616.txt (http://www.ietf.org/rfc/rfc2616.txt).

accessLogBufferSize

Indique la taille (en octets) du tampon dans lequel sont stockés les appels du journal des accès. Si la valeur est inférieure à 5 120, un message d'avertissement est émis et la valeur est définie sur 5 120. La valeur par défaut est 32 768.

accessLogWriterInterval

Spécifie le délai (en secondes) avant l'écriture du journal sur le disque. Le journal des accès est écrit lorsque la mémoire tampon est pleine ou que l'intervalle expire. Si la valeur est égale à zéro, l'écriture continue dans la mémoire tampon même si elle n'est pas pleine. Autrement dit, chaque fois qu'un utilisateur accède au serveur, le message de journal est directement stocké dans le fichier. La valeur par défaut est 300.

allowRemoteAddress

Fournit une liste de modèles d'expression régulière (séparés par des virgules) 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 demande soit acceptée. Si cette propriété n'est pas spécifiée, toutes les demandes sont acceptées à moins que l'adresse distante ne corresponde au modèle denyRemoteAddress.

denyRemoteAddress

Fournit une liste de modèles d'expression régulière (séparés par des virgules) 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 demande soit acceptée. Si cette propriété n'est pas spécifiée, l'acceptation de la demande est régie uniquement par la propriété allowRemoteAddress.

allowRemoteHost

Fournit une liste de modèles d'expression régulière (séparés par des virgules) 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 demande soit acceptée. Si cette propriété n'est pas spécifiée, toutes les demandes sont acceptées à moins que le nom d'hôte distant ne corresponde au modèle denyRemoteHost.

denyRemoteHost

Fournit une liste de modèles d'expression régulière (séparés par des virgules) 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 demande soit acceptée. Si cette propriété n'est pas spécifiée, l'acceptation de la demande est régie uniquement par la propriété allowRemoteHost.

La définition de cette propriété n'a aucun effet si l'accès au domaine GlassFish Server est effectué par l'intermédiaire d'un processus d'écoute réseau avec l'option Processus d'écoute JK 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 à Domaines.

securePagesWithPragma

Attribuez la valeur false à cette propriété afin de vous assurer que, pour toutes les applications Web de ce serveur virtuel, les téléchargements de fichier via 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 plus d'informations, reportez-vous à glassfish-web-app dans le manuel Oracle GlassFish Server Application Deployment Guide.

La valeur par défaut est true.

alternatedocroot_n

Indique une autre racine de document (docroot), où n est un entier positif qui permet de spécifier plusieurs racines. Les autres racines de document permettent aux applications Web de traiter les demandes de certaines ressources en dehors de leur propre racine de document, selon que ces demandes correspondent à des modèles d'URI des autres racines de document de l'application Web.

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

Par exemple, les propriétés suivantes spécifient trois autres racines de document. Le modèle d'URI de la première autre racine de document utilise une correspondance exacte, tandis que les modèles d'URI des deuxième et troisième racines de document 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 chacune de ces racines de document dispose de deux composants : le premier composant, from, spécifie le modèle d'URI de la racine de document et le second, dir, en spécifie l'emplacement physique (répertoire). 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 plus d'informations, reportez-vous à glassfish-web-app dans le manuel Oracle GlassFish Server Application Deployment Guide.

contextXmlDefault

Indique l'emplacement relatif au répertoire domain-dir du fichier context.xml pour ce serveur virtuel, le cas échéant. Pour plus d'informations sur le fichier context.xml, reportez-vous au document The Context Container (http://tomcat.apache.org/tomcat-5.5-doc/config/context.html).

allowLinking

Si la valeur est true, 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 plus d'informations, reportez-vous à glassfish-web-app dans le manuel Oracle GlassFish Server Application Deployment Guide.

La valeur par défaut est false.


Attention:

Sous Windows, si vous attribuez la valeur True à cette propriété, le code source JSP devient visible.
send-error_n

Spécifie les mappings de 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 ces mappings de page d'erreur personnalisée dans son descripteur de déploiement web.xml. La valeur de chaque propriété send-error_n comporte 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, ainsi que la ligne de réponse suivante :

HTTP/1.1 401 MY-401-REASON
redirect_n

Spécifie qu'une demande d'ancienne URL est traitée comme une demande de nouvelle URL. Toutes les applications Web déployées sur le serveur virtuel héritent de ces propriétés. La valeur de chaque propriété redirect_n comporte 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 depuis Tomcat ou des versions précédentes de GlassFish Server ou l'interface org.glassfish.web.valve.GlassFishValve à partir de la version en cours de GlassFish Server. Exemple :

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

Vous pouvez définir cette propriété pour une application Web spécifique. Pour plus d'informations, reportez-vous à glassfish-web-app dans le manuel Oracle GlassFish Server Application Deployment Guide.

listener_n

Spécifie le nom de classe qualifié complet d'un processus d'écoute Catalina personnalisé, où n correspond à un entier positif qui permet d'en spécifier plusieurs. La classe de processus d'écoute doit implémenter l'interface org.apache.catalina.ContainerListener ou org.apache.catalina.LifecycleListener. Exemple :

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

Vous pouvez définir cette propriété pour une application Web spécifique. Pour plus d'informations, reportez-vous à glassfish-web-app dans le manuel Oracle GlassFish Server Application Deployment Guide.

errorReportValve

Spécifie le nom de classe qualifié 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 © 2005, 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices