Propriedades Específicas a Servidores Virtuais

As propriedades a seguir adicionais estão disponíveis para um servidor virtual.

sso-max-inactive-seconds

Especifica o número de segundos após o qual o registro de sign-on único de um usuário se torna qualificado para expurgação, caso nenhuma atividade do cliente seja recebida. Como o single sign-on é aplicável em várias aplicações no mesmo servidor virtual, o acesso a qualquer um das aplicações mantém ativo o registro de sign-on único.

O valor default é 300 segundos (5 minutos). Valor mais altos fornecem uma persistência mais longa de sign-on único para os usuários, porém, exige um uso de memória maior no servidor.

sso-reap-interval-seconds

Especifica o número de segundos entre as expurgações de registros de sign-on único expirados.

O valor default é 60.

ssoCookieSecure

Define o atributo Secure de quaisquer cookies JSESSIONIDSSO↓ associados às aplicações Web implantadas para esse servidor virtual. Essa propriedade só se aplicará se o sign-on único estiver ativado. Os valores permitidos são como segue:

verdadeiro

Define Secure como verdadeiro.

falso

Define Secure como falso.

dynamic

O cookie JSESSIONIDSSO herda a definição ↓Secure da primeira sessão participando no SSO.

Para definir um atributo Secure de um cookie JSESSIONID, use a propriedade cookieSecure cookie-properties no arquivo sun-web.xml. Para obter mais detalhes, consultecookie-properties em Oracle GlassFish Server Application Deployment Guide.

setCacheControl

Especifica uma lista separada por vírgulas de diretivas de resposta Controle por Cache. Para obter uma lista de diretivas válidas, consulte Section 14.9 do documento em http://www.ietf.org/rfc/rfc2616.txt (http://www.ietf.org/rfc/rfc2616.txt).

accessLogBufferSize

Especifica o tamanho em bytes do buffer onde as chamadas de log de acesso são armazenadas. Se o valor for menor do que 5.120, uma mensagem de advertência será emitida, e o valor é definido como 5.120. O valor default é 32.768.

accessLogWriterInterval

Especifica o número de segundos antes que o log seja gravado no disco. O log de acesso é gravado quando o buffer está cheio ou quando o intervalo expira. Se o valor é 0, o buffer é sempre gravado mesmo que não esteja cheio. Isso significa que, a cada vez que o servidor é acessado, a mensagem de log é armazenada diretamente no arquivo. O valor default é 300.

allowRemoteAddress

Especifica uma lista separada por vírgulas de padrões de expressões regulares, em relação a qual o endereço IP do cliente remoto é comparado. Se essa propriedade for especificada. o endereço remoto deverá coincidir para que a solicitação seja aceita. Se a propriedade não for especificada, todas as solicitações serão aceitas, a menos que o endereço remoto coincida com o padrão denyRemoteAddress.

denyRemoteAddress

Especifica uma lista separada por vírgulas de padrões de expressões regulares, em relação a qual o endereço IP do cliente remoto é comparado. Se essa propriedade for especificada. o endereço remoto não deverá coincidir para que a solicitação seja aceita. Se a propriedade não for especificada, a aceitação da solicitação será administrada exclusivamente pela propriedade allowRemoteAddress.

allowRemoteHost

Especifica uma lista separada por vírgulas de padrões de expressões regulares que o nome do host do cliente remoto (conforme retornado por [java.net.]Socket.getInetAddress().getHostName()) é comparado com. Se essa propriedade for especificada. o nome de host remoto deverá coincidir para que a solicitação seja aceita. Se a propriedade não for especificada, todas as solicitações serão aceitas, a menos que o nome de host remoto coincida com o padrão denyRemoteHost.

denyRemoteHost

Especifica uma lista separada por vírgulas de padrões de expressões regulares que o nome do host do cliente remoto (conforme retornado por [java.net.]Socket.getInetAddress().getHostName()) é comparado com. Se essa propriedade for especificada. o nome de host remoto não deverá coincidir para que a solicitação seja aceita. Se a propriedade não for especificada, a aceitação da solicitação será administrada exclusivamente pela propriedade allowRemoteHost.

A definição desta propriedade não tem efeito se o domínio do GlassFish Server é acessado através de um listener de rede que tenha a opção Interpretador JK ativada.

authRealm

Especifica o nome de um realm de autenticação, que substitui o realm default da instância do servidor por aplicações Web standalone implantadas neste servidor virtual. Um realm definido no arquivo web.xml de uma aplicação substitui substitui o realm do servidor virtual. Para obter mais informações, consulte Realms .

securePagesWithPragma

Defina essa propriedade como falso para garantir que todas as aplicações Web em downloads de arquivos do servidor virtual, usando SSL, funcionem adequadamente no Internet Explorer.

aplicações Web individuais podem substituir essa definição, usando o elemento sun-web-app do arquivo sun-web.xml. Para obter mais detalhes, consulte glassfish-web-app em Oracle GlassFish Server Application Deployment Guide.

O valor default é verdadeiro.

alternatedocroot_n

Especifica uma raiz de documento alternativa (docroot), onde n é um inteiro positivo que permite a especificação de mais de um. Docroots alternativas permite que as aplicações da Web atendam solicitações de determinados recursos externos à própria docroot, dependendo de tais solicitações corresponderem a um (ou mais) dos padrões URI das docroots alternativas da aplicação Web.

Se uma solicitação corresponder a um padrão URI da docroot alternativa, ela será mapeada para uma docroot alternativa, acrescentando o URI da solicitação (menos a raiz de contexto da aplicação Web) à localização física (diretório) da docroot alternativa. Se uma solicitação corresponder a vários padrões URI, a docroot alternativa será determinada de acordo com esta ordem de precedência:

Por exemplo, as seguintes propriedades especificam três docroots alternativas: O padrão URI da primeira docroot alternativa usa uma correspondência exata, ao passo que os padrões URI da segunda e terceira docroots alternativas usam correspondências de prefixo de extensão e caminho mais longo, 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"/>

O valor de cada docroot alternativa tem dois componentes: o primeiro componente, de, especifica o padrão URI da docroot alternativa; o seguindo componente, dir, especifica a localização física (diretório) da docroot alternativa. Espaços são permitidos no componente dir.

aplicações Web individuais podem substituir essa definição, usando o elemento sun-web-app do arquivo sun-web.xml. Para obter mais detalhes, consulte glassfish-web-app em Oracle GlassFish Server Application Deployment Guide.

contextXmlDefault

Especifica a localização, relativa a domain-dir, do arquivo context.xml para este servidor virtual, se for usado. Para obter mais informações sobre o arquivo context.xml, consulte o Contêiner de Contexto (http://tomcat.apache.org/tomcat-5.5-doc/config/context.html).

allowLinking

Se verdadeiro, os recursos que forem links simbólicos serão atendidos por todas as aplicações Web implantadas no servidor virtual. aplicações Web individuais podem substituir essa definição, usando a propriedade sun-web-app allowLinking do arquivo sun-web.xml:

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

Para obter mais detalhes, consulte glassfish-web-app em Oracle GlassFish Server Application Deployment Guide.

O valor default é false.


Cuidado:

A definição desta propriedade como verdadeira nos sistemas Windows expõe o código-fonte JSP.
send-error_n

Especifica mapeamentos de páginas personalizadas de erros para o servidor virtual, os quais são herdados por todas as aplicações implantadas no servidor virtual. Uma aplicação Web pode substituir esses mapeamentos de páginas personalizadas de erros no respectivo descritor de implantação web.xml. O valor de cada propriedade send-error_n tem três componentes, que podem ser especificados em qualquer ordem:

Por exemplo:

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

Este exemplo de definição da propriedade faz com que o conteúdo de /myhost/401.html seja retornado com 401 respostas, junto dessa linha de respostas:

HTTP/1.1 401 MY-401-REASON
redirect_n

Especifica que uma solicitação para um URL antigo seja tratado como uma solicitação para um novo URL. Essas propriedades são herdadas por todas as aplicações Web implantadas no servidor virtual. O valor de cada propriedade de redirect_n tem dois componentes, que podem ser especificados em qualquer ordem:

Por exemplo:

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

Especifica um nome de classe totalmente qualificada de um Valve personalizado, onde n é um inteiro positivo que permite a especificação de mais de um. A classe da válvula deve implementar a interface org.apache.catalina.Valve do Tomcat ou versões anteriores do GlassFish Server ou da interface org.glassfish.web.valve.GlassFishValve da versão atual do GlassFish Server. Por exemplo:

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

Você pode definir esta propriedade para uma aplicação Web específica. Para obter mais detalhes, consulte glassfish-web-app em Oracle GlassFish Server Application Deployment Guide.

listener_n

Especifica um nome de classe completamente qualificada de um listenter Catalina personalizado, em que n é um positivo inteiro que permite especificar mais de uma. A classe de listener deve implementar a interface org.apache.catalina.ContainerListener ou org.apache.catalina.LifecycleListener. Por exemplo:

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

Você pode definir esta propriedade para uma aplicação Web específica. Para obter mais detalhes, consulte glassfish-web-app em Oracle GlassFish Server Application Deployment Guide.

errorReportValve

Especifica um nome de classe totalmente qualificado de um valve personalizado que cria páginas de erro default para as aplicações deste servidor virtual. Especifique uma string vazia para desativar o mecanismo da página de erro default deste servidor virtual.

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