Propiedades Específicas de los Servidores Virtuales

Las siguientes propiedades adicionales están disponibles para un servidor virtual.

sso-max-inactive-seconds

Especifica el número de segundos después de los cuales el registro de single sign-on de un usuario cumple con los requisitos necesarios para ser depurado si no se detecta actividad de cliente. Dado que el single sign-on se aplica en varias aplicaciones en el mismo servidor virtual, el acceso a cualquiera de las aplicaciones mantiene activo el registro de single sign-on.

El valor por defecto es 300 segundos (5 minutos). Los valores más altos proporcionan una persistencia de single sign-on más larga para los usuarios a costa de un mayor consumo de memoria en el servidor.

sso-reap-interval-seconds

Especifica el número de segundos entre depuraciones de registros de single sign-on caducados.

El valor por defecto es 60.

ssoCookieSecure

Establece el atributo Secure de cualquier cookie JSESSIONIDSSO asociada a las aplicaciones web desplegadas en este servidor virtual. Esta propiedad únicamente se aplica si se activa el single sign-on. Los valores permitidos son los siguientes:

true

Establece Secure en true.

false

Establece Secure en false.

dynamic

La cookie JSESSIONIDSSO hereda el valor Secure de la primera sesión que participa en el SSO.

Para establecer el atributo Secure de una cookie JSESSIONID, utilice la propiedad cookieSecure cookie-properties del archivo sun-web.xml. Para obtener detalles, consulte cookie-properties en Oracle GlassFish Server Application Deployment Guide.

setCacheControl

Especifica una lista separada por comas de las directivas de respuesta de Cache-Control. Para obtener una lista de directivas válidas, consulte la Sección 14.9 del documento en http://www.ietf.org/rfc/rfc2616.txt (http://www.ietf.org/rfc/rfc2616.txt).

accessLogBufferSize

Especifica el tamaño (en bytes) del buffer en el que se almacenan las llamadas de log de acceso. Si el valor es inferior a 5120, se muestra un mensaje de advertencia y el valor se establece en 5120. El valor por defecto es 32768.

accessLogWriterInterval

Especifica el número de segundos antes de que el log se escriba en el disco. El log de acceso se escribe cuando el buffer está lleno o cuando caduca el intervalo. Si el valor es 0, el buffer siempre se escribirá aunque no esté lleno. Esto significa que cada vez que se accede al servidor, el mensaje log se almacena directamente en el archivo. El valor por defecto es 300.

allowRemoteAddress

Especifica una lista de patrones de expresión regular separados por comas con los que se compara la dirección IP del cliente. Si se especifica esta propiedad, la dirección remota debe coincidir para que se acepte esta solicitud. Si no se especifica esta propiedad, se aceptan todas las solicitudes a menos que la dirección remota coincida con un patrón denyRemoteAddress.

denyRemoteAddress

Especifica una lista de patrones de expresión regular separados por comas con los que se compara la dirección IP del cliente. Si se especifica esta propiedad, la dirección remota no debe coincidir para que se acepte esta solicitud. Si no se especifica esta propiedad, la aceptación de la solicitud se regula sólo por medio de la propiedad allowRemoteAddress.

allowRemoteHost

Especifica una lista de patrones de expresión regular separados por comas con el nombre de host del cliente remoto (devuelto por [java.net.]Socket.getInetAddress().getHostName()) se compara. Si se especifica esta propiedad, el nombre de host remoto debe coincidir para que se acepte esta solicitud. Si no se especifica esta propiedad, se aceptan todas las solicitudes a menos que el nombre de host remoto coincida con un patrón denyRemoteHost.

denyRemoteHost

Especifica una lista de patrones de expresión regular separados por comas con el nombre de host del cliente remoto (devuelto por [java.net.]Socket.getInetAddress().getHostName()) se compara. Si se especifica esta propiedad, el nombre de host remoto no debe coincidir para que se acepte esta solicitud. Si no se especifica esta propiedad, la aceptación de la solicitud se regula sólo por medio de la propiedad allowRemoteHost.

La configuración de esta propiedad no tiene ningún efecto si se accede al dominio de Servidor GlassFish a través del listener de red que tiene activada la opción Listener JK.

authRealm

Especifica el nombre de un dominio de autenticación que sustituye el dominio por defecto de la instancia del servidor para las aplicaciones web independientes desplegadas en este servidor virtual. Un dominio definido en el archivo web.xml de una aplicación web independiente sustituye al dominio del servidor virtual. Para obtener más información, consulte Dominios.

securePagesWithPragma

Establezca esta propiedad en false para garantizar que todas las aplicaciones web de las descargas de archivos de este servidor virtual que utilicen SSL funcionen correctamente en Internet Explorer.

Las aplicaciones web individuales pueden sustituir esta configuración utilizando el elemento sun-web-app del archivo sun-web.xml. Para obtener detalles, consulte glassfish-web-app en Oracle GlassFish Server Application Deployment Guide.

El valor por defecto es true.

alternatedocroot_n

Especifica una raíz de documento alternativa (raíz de documento), donde n es un entero positivo que permite la especificación de más de uno. Las raíces de documento alternativas permiten que las aplicaciones web atiendan solicitudes para ciertos recursos desde fuera de su propia raíz de documento, en función de si dichas solicitudes coinciden o no con uno (o más) de los patrones URI de las raíces de documento alternativas de la aplicación web.

Si una solicitud coincide con el patrón URI de la raíz de documento alternativa, se asigna agregando la solicitud URI (menos la raíz de contexto de la aplicación web) a la ubicación física de la raíz de documento alternativa (directorio). Si una solicitud coincide con varios patrones URI, se determina la raíz de documento alternativa según el orden especificado anteriormente:

Por ejemplo, las siguientes propiedades especifican tres raíces de documento alternativas. El patrón de URI de la primera raíz de documento alternativa utiliza una coincidencia exacta, mientras que los patrones URI de la segunda y tercera raíces de documento alternativas usan una extensión y coincidencias del prefijo de la ruta de acceso más larga, respectivamente.

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

El value de cada raíz de documento alternativa posee dos componentes: el primero, from, especifica el patrón URI de la raíz de documento alternativa, y el segundo, dir, especifica la ubicación física de la raíz de documento alternativa (directorio). Se permiten espacios en el componente dir.

Las aplicaciones web individuales pueden sustituir esta configuración utilizando el elemento sun-web-app del archivo sun-web.xml. Para obtener detalles, consulte glassfish-web-app en Oracle GlassFish Server Application Deployment Guide.

contextXmlDefault

Especifica la ubicación, en relación con domain-dir, del archivo context.xml para este servidor virtual, si se utiliza alguno. Para obtener más información sobre el archivo context.xml, consulte el apartado sobre el contenedor de contexto (http://tomcat.apache.org/tomcat-5.5-doc/config/context.html).

allowLinking

Si está propiedad es true, se atenderán los recursos que son enlaces simbólicos para todas las aplicaciones web desplegadas en este servidor virtual. Las aplicaciones web individuales pueden sustituir esta configuración utilizando la propiedad allowLinking de sun-web-app en el archivo sun-web.xml:

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

Para obtener detalles, consulte glassfish-web-app en Oracle GlassFish Server Application Deployment Guide.

El valor por defecto es false.


Atención:

La configuración de esta propiedad como true en los sistemas Windows expone el código fuente JSP.
send-error_n

Especifica las asignaciones de la página de errores personalizados para el servidor virtual, que heredan todas las aplicaciones web desplegadas en el servidor virtual. Una aplicación web puede sustituir estas asignaciones de páginas de errores personalizadas en su descriptor de despliegue web.xml. El valor de cada propiedad send-error_ n posee tres componentes, que pueden especificarse en cualquier orden:

Por ejemplo:

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

Este ejemplo de definición de la propiedad provoca que se devuelva el contenido de /myhost/401.html con las respuestas 401, junto con la línea de respuesta:

HTTP/1.1 401 MY-401-REASON
redirect_n

Especifica que una solicitud de una URL antigua de trata como una solicitud de una URL nueva. Todas las aplicaciones web desplegadas en el servidor virtual heredan estas propiedades. El valor de cada propiedad redirect_n posee dos componentes, que pueden especificarse en cualquier orden:

Por ejemplo:

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

Especifica un nombre de clase completo de una válvula personalizada, donde n es un número entero positivo que permite especificación de más de uno. La clase de válvula debe implementar la interfaz org.apache.catalina.Valve de Tomcat o de versiones anteriores de Servidor GlassFish, o la interfaz org.glassfish.web.valve.GlassFishValve de la versión actual de Servidor GlassFish. Por ejemplo:

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

Puede configurar esta propiedad para una determinada aplicación web. Para obtener detalles, consulte glassfish-web-app en Oracle GlassFish Server Application Deployment Guide.

listener_n

Especifica un nombre de clase completo de un listener Catalina personalizado, donde n es un número entero positivo que permite la especificación de más de uno. La clase de listener debe implementar la interfaz org.apache.catalina.ContainerListener o org.apache.catalina.LifecycleListener. Por ejemplo:

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

Puede configurar esta propiedad para una determinada aplicación web. Para obtener detalles, consulte glassfish-web-app en Oracle GlassFish Server Application Deployment Guide.

errorReportValve

Especifica un nombre de clase completo de una válvula personalizada que genera páginas de error por defecto para aplicaciones en este servidor virtual. Especifique una cadena vacía para desactivar el mecanismo de páginas de error por defecto para este servidor virtual.

Copyright © 2005, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices