# Configurações do ODR

Utilize este tópico para desempenhar a configuração avançada em um ODR (On Demand Router). Com as configurações do ODR, é possível ajustar o comportamento do ODR. Em particular, é possível configurar as conexões e os pedidos para o servidor de aplicativos, ativar o armazenamento em cache, configurar os pedidos que devem ser rejeitados, definir como as repostas de erro são manipuladas e especificar o local dos logs do ODR.

Após a criação, o servidor ODR detecta o ambiente e é capaz de rotear as solicitações para o WebSphere® Application Server. Uma configuração adicional pode ser aplicada ao ODR para atender às necessidades de um ambiente específico. A configuração do ODR no DMZ não é suportada.

Para visualizar essa página de console administrativo, clique em Servidores > Tipos de Servidor > On Demand Routers > odr_name > Propriedades On Demand Router > Configurações On Demand Router.

Para alterar as configurações do ODR, você deve ter privilégios administrativos de administrador ou configurador.

É possível editar as definições dos campos configuráveis na guia Configuração.

## Conexão do Servidor de Conteúdo

Configure os parâmetros de conexão HTTP básicos entre o servidor proxy e os servidores de conteúdo.

Tempo Limite de Pedidos de Saída
  O número padrão de segundos em que o ODR aguarda por uma resposta antes de atingir o tempo limite de um pedido para um servidor de conteúdo. Considere essa opção cuidadosamente ao alterar o valor.

Tempo limite de conexão de saída
  O número de milissegundos que o ODR espera para se conectar a um servidor. Se esse tempo expirar, o servidor ODR tenta se conectar a um servidor diferente. Se não existir nenhum outro servidor disponível, o pedido tem o tempo limite excedido. Um valor igual a 0 indica que o servidor ODR deve utilizar o valor de tempo limite de kernel do sistema operacional.

Pool de Conexões para o Servidor de Conteúdo
  A opção de efetuar pool de conexões para o servidor é um recurso de otimização. A colocação em conjunto evita a necessidade de criar e destruir freqüentemente conexões de soquete ao servidor, permitindo que o ODR coloque em conjunto essas conexões e reutilize-as. O valor padrão do número máximo de conexões por servidor é 0, o que significa que o número de conexões pode aumentar conforme necessário.

Número Máximo de Conexões por Servidor
  O número máximo de conexões que estão em pool para qualquer servidor de conteúdo. As propriedades personalizadas do ODR que regulam as conexões do servidor de conteúdo são as seguintes:
  - key=http.maxTargetReconnects: Número máximo de reconexões com o mesmo servidor de conteúdo de destino para cada pedido. O padrão é 5.
  - key=http.maxTargetRetries: Número máximo de vezes que o ODR tenta selecionar um novo servidor de conteúdo de destino para cada pedido. O padrão é 5.
  - key=http.routing.sendReverseProxyNameInHost: Determina se o nome do ODR é ou não colocado no cabeçalho do host para um conteúdo que não é específico aos servidores de conteúdo do WebSphere Application Server. As opções são `true` ou `false` e não fazem distinção entre maiúsculas e minúsculas. O padrão é false.
  - key=http.compliance.disable: Determina se a conformidade HTTP V1.1 é aplicada a conexões de servidores de conteúdo do ODR. As opções são `true` ou `false` e não fazem distinção entre maiúsculas e minúsculas. O padrão é false.
  - key=http.compliance.via: O valor do cabeçalho que é anexado aos pedidos e respostas para conformidade com HTTP. Se o valor for nulo, um cabeçalho via não será anexado. Se o valor for true, um valor padrão de cabeçalho será anexado. Caso contrário, o valor da cadeia de cabeçalho especificado é anexado. O padrão é null.

## Armazenamento em Cache

O ODR pode ser configurado para armazenar em cache o conteúdo de servidores.

Por padrão, o armazenamento em cache de conteúdo é ativado. As propriedades a seguir aplicam-se somente se o armazenamento em cache estiver ativado:

Ativar Armazenamento em Cache
  Ativa a estrutura de armazenamento em cache para o servidor ODR e ativa o armazenamento em cache estático, definido pelas especificações HTTP 1.1.

Nome da Instância de Cache
  A instância de cache de objetos do cache dinâmico, configurada em Recursos > Instâncias de Cache > Instâncias de Cache do Objeto, usada para armazenar em cache todas as respostas de conteúdo estáticas e dinâmicas. Essa instância de cache de objeto deve ser configurada para suportar APIs (Interfaces de Programa de Aplicativo) de NIO (Nova E/S).

Conteúdo SSL do Cache
  Determina se as conexões SSL do cliente ODR que são encerradas pelo ODR devem ter as respostas armazenadas em cache.

Armazenamento em cache agressivo
  Permite o armazenamento em cache de respostas HTTP que normalmente não seriam armazenadas. As regras de cache que são definidas pelo HTTP 1.1 podem ser divididas para obter a otimização do cache.

Cache de conteúdo dinâmico
  Determina se o conteúdo dinâmico gerado por WebSphere Application Servers V6.02, ou posterior, é armazenado em cache. O conteúdo dinâmico armazenado em cache gerado pelos servidores de conteúdo antes do WebSphere Application Server V6.02 não é suportado.

URI de Atualização de Cache
  Ao armazenar o conteúdo dinâmico em cache, esse é o URI relativo de um aplicativo instalado do servidor de conteúdo que é utilizado para invalidar as entradas no cache.

## Política de Compactação

Ativa a compactação do corpo da mensagem de resposta HTTP antes de enviá-la ao cliente.

gzip-only
  Compacta a resposta utilizando o mecanismo de compactação gzip. A resposta é compactada apenas se isso for aceitável ao cliente, com base no cabeçalho do pedido Accept-Encoding.

deflate-only
  Compacta a resposta utilizando o mecanismo de compactação deflate. A resposta é compactada apenas se isso for aceitável ao cliente, com base no cabeçalho do pedido Accept-Encoding.

auto-only
  Utilize gzip, deflate ou nenhuma compactação, como determinado pela preferência do cliente

## Exclusões

O ODR examina cada pedido que chega. É possível definir alguns métodos para exclusão e, se o método HTTP solicitado corresponder a qualquer um dos métodos configurados para exclusão, o ODR rejeitará os pedidos com um erro METHOD DISALLOWED.

Métodos HTTP Desativados
  Por padrão, os métodos CONNECT, PUT e DELETE estão desativados.

## Log

Pedidos de HTTP são registrados em um dos três logs: proxy, cache e local. A configuração de log local não está disponível no console administrativo, mas está disponível em ${SERVER_LOG_ROOT}local.log. Especifique o local desse registro configurando a propriedade customizada http.log.localFileName para o local do arquivo. O conteúdo de cada log é formatado com o uso do formato de log comum do NCSA (National Center for Supercomputing Applications).

Ativar Registro de Acesso
  Selecione para ativar logs.

Tamanho máximo do log de acesso
  O tamanho máximo do log em MB (megabytes). 25 MB é o padrão.

Registro de Acesso do Proxy
  Registra o log de respostas que são recebidas a partir de servidores remotos.

Log de Acesso do Cache
  Registra o log de mensagens que são atendidas a partir do cache local.

Log de acesso local
  Contém o nome do log local. Um valor de `NULL` indica que o padrão `${SERVER_LOG_ROOT}/local.log` é utilizado. Registra o log de todas as repostas locais que não são do cache, por exemplo, redirecionamentos e erros internos. Esse conteúdo não vem do cache do ODR.

## Segurança

Utilize esta seção para configurar opções de segurança.

Proxies de Segurança Confiáveis
  Algumas topologias possuem outra camada de roteamento ativada sobre o ODR. Por exemplo, os servidores da Web fazem a leitura de pedidos quem chegam para verificar a qual ODR eles devem ser roteados. Esse campo de configuração permite que intermediários que não sejam o servidor ODR manipulem o pedido, informando explicitamente ao ODR que eles são confiáveis. Utilize um Internet Protocol ou um nome completo de host nesse campo.

## Política de Configuração de Plug-in do Proxy

Gerar Configuração de Plug-in
  Utilize esse parâmetro para a geração de um arquivo de configuração de plug-in do ODR que pode ser utilizado em um servidor da Web implementado na frente do ODR. O plug-in pode determinar o URI que está sendo manipulado pelo ODR em nome do servidor de aplicativos. O plug-in pode determinar o nó de extremidade ou os limites do ODR para que seja possível rotear corretamente os pedidos recebidos para o ODR. Esse recurso é útil para os que preferem implementar um servidor da Web comprovado na DMZ (Zona Desmilitarizada) que seja totalmente capaz de explorar a capacidade do ODR. Observe que a configuração do ODR no DMZ não é suportada.

  Você pode definir um nível com base no qual gerar o plug-in. Para o escopo da célula, o ODR gera uma configuração de plug-in que inclui todas as URIs gerenciadas por todos os ODRs da célula. Para o escopo do nó, o arquivo de configuração do plug-in contém todas as URIs gerenciadas pelos ODRs que estejam definidas no mesmo nó que o ODR que está gerando o plug-in. Além disso, todo o tráfego roteado pelo arquivo de configuração do plug-in é roteado somente através dos ODRs no mesmo nó que este ODR. Para o escopo do servidor, o arquivo de configuração do plug-in contém todas as URIs gerenciadas apenas pelo ODR que está gerando o plug-in e todo o tráfego roteado pelo arquivo de configuração do plug-in é roteado somente através deste ODR.

Script de Alteração de Config de Plug-in
  Especifica o caminho para um script que é executado seguindo a geração da configuração de plug-in do WebSphere Application Server.

## Política da Página de Erros Personalizada

Utilize esse campo para suportar a utilização das páginas de erro customizadas quando ocorrerem erros durante o processamento do pedido.

O padrão é nenhuma página de erro customizada gerada. As propriedades a seguir permitem que as páginas de erro customizadas sejam utilizadas quando ocorrerem erros durante o processamento de pedidos:

Erro de URI do aplicativo de geração de página
  Se um URI válido para um aplicativo instalado não for fornecido, a política de página de erro personalizada não manipulará pedidos.

Manipular erros remotos
  Quando não selecionados, os código de status do erro de resposta HTTP são manipulados apenas quando o ODR gera uma resposta de erro. Quando selecionados, os código de status do erro de resposta HTTP são manipulados quando o ODR gera uma resposta de erro, assim como quando um servidor de aplicativos gera uma resposta de erro. Uma boa prática é configurar um aplicativo de página de erro na mesma máquina física que o ODR.

Cabeçalhos a serem redirecionados a um aplicativo de página de erro
  Especifica valores de cabeçalho adicionais a partir do pedido do cliente a serem redirecionados ao aplicativo de página de erro como parâmetros de consulta. Os parâmetros de consulta responseCode e URI sempre são enviados ao aplicativo de página de erro, além daqueles que estão configurados. O parâmetro responseCode é o código de status HTTP que é gerado internamente ou é retornado pelo servidor de conteúdo. O parâmetro URI é o URI de pedido do cliente.
  Exemplo - O URI da página de erro é `/ErrorPageApp/ErrorPage`, os cabeçalhos a serem redirecionados contêm `Host` e um cliente envia o seguinte pedido:

      GET  /house/rooms/kitchen.jpg HTTP/1.1
      Host:  homeserver.companyx.com
      O pedido resulta em uma resposta HTTP 404 (local ou remota), e a URL de pedido para o aplicativo de página de erro pode ser:
      /ErrorPageApp/ErrorPage?responseCode=404&uri=/house/rooms/kitchen.jpg&Host= homeserver.companyx.com

Códigos de status HTTP que devem ser reconhecidos como erros
  Os códigos de status para os quais a política de página de erro fornece uma resposta. Se um código de status não for especificado, o conteúdo original das repostas com esse código de status será retornado. Se nenhum código de status HTTP for especificado, os padrões, `404` e `5XX`, serão utilizados. Em vez de especificar os códigos de status individualmente, o método a seguir é recomendado para representar um intervalo:
  - `5XX: 500-599`
  - `4XX: 400-499`
  - `3XX: 300-399`
  - `2XX: 200-299`

Informações relacionadas:
Coleção de roteadores sob demanda
Configurações do roteador sob demanda
Configurações de regra de armazenamento em cache estático de roteador sob demanda
Coleção de instâncias de cache de objetos do roteador sob demanda
Coleção de cadeias de transporte de roteador sob demanda
Configuração de roteador sob demanda
Regras de cache estático do roteador sob demanda
Criar um novo roteador sob demanda
Coleção de clusters sob demanda

Nome do Arquivo: odr_settings.html