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 automaticamente o ambiente, sendo capaz de rotear pedidos ao WebSphere Application Server. Uma configuração adicional pode ser aplicada ao ODR para atender às necessidades de um ambiente específico.

Para visualizar essa página do console administrativo, clique em Servidores> Roteadores On Demand > nome_do_ODR > Propriedades do Roteador On Demand > Configurações do Roteador On Demand.

É 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.

Alias SSL de Saída
O alias de repertório SSL (Secure Sockets Layer), configurado em Segurança > SSL, que é utilizado para proteger conexões com servidores de conteúdo. Se pedidos puderem ser manipulados somente através de conexões SSL, recomenda-se criar um novo alias SSL que contenha as autoridades de certificação confiáveis e apontem para esse alias. Crie um alias SSL no console administrativo clicando em Segurança > SSL > Novo Repertório JSSE.
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.
Pool de Conexões para o Servidor
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.
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 de objetos, utilizada para armazenar em cache todas as respostas de conteúdo estático e dinâmico. 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.

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 log 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 Log de Acesso
Selecione para ativar logs.
Tamanho máximo do log de acesso
O tamanho máximo do log em MB (megabytes). Um valor UNLIMITED indica ilimitado. 25 MB é o padrão.
Log 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.

Security

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

Proxies de Segurança Confiáveis
Algumas topologias possuem outra camada de rota 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.

Você pode definir um nível com base no qual gerar o plug-in. Para o escopo da célula, o servidor proxy gera uma configuração de plug-in que inclui todos os URIs manipulados por todos os servidores proxy da célula. O escopo do nó inclui todos os URIs configurados para o nó e, no nível do servidor, o servidor proxy gera somente um arquivo de configuração de plug-in para o servidor proxy atualmente configurado.

Script de Alteração de Config de Plug-in
Especifica o caminho para um script que é executado após 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 personalizada 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 essa opção não está selecionada, apenas os códigos de status de erro de resposta HTTP gerados pelo ODR são manipulados. Quando essa opção está selecionada, são manipulados os códigos de status de erro de resposta HTTP gerados pelo ODR e os códigos de status de erro de resposta HTTP gerados em outro local após o ODR nas respostas de erro de conexão com o servidor de conteúdo ODR. 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