Propriedades de Plug-in do Servidor da Web

Use esta página para visualizar ou alterar as configurações de um arquivo de configuração de plug-in do servidor da Web. O arquivo de configuração do plug-in, plugin_cfg.xml, fornece propriedades para estabelecer a comunicação entre o servidor da Web e o Application Server.

Para visualizar a página do console administrativo, clique em Servidores > Tipos de Servidores > Servidores da Web > web_server_name > Propriedades do Plug-in.

Na guia Configuração, é possível editar os campos. Na guia Tempo de Execução, é possível ver as informações de leitura.

A guia Tempo de Execução estará disponível somente quando esse servidor da Web tiver acessado aplicativos em execução nos servidores de aplicativos e houver um arquivo http_plugin.log.

Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma alternativa recomendada, é possível configurar o servidor para usar a infraestrutura de log e de rastreio de High Performance Extensible Logging (HPEL) em vez de usar os arquivos SystemOut.log, SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM® i. Também é possível usar HPEL junto com os recursos de criação de log nativos do z/OS. Se estiver usando o HPEL, é possível acessar todas as informações de log e de rastreio usando a ferramenta de linha de comandos do LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre como usar HPEL para solucionar problemas de aplicativos para obter informações adicionais sobre como usar HPEL.

Ignorar Falhas de DNS Durante a Inicialização do Servidor da Web

Especifica se o plug-in ignora falhas de DNS dentro de uma configuração ao iniciar.

Este campo corresponde ao elemento IgnoreDNSFailures no arquivo plugin-cfg.xml.

Quando o valor for configurado como true, o plug-in ignorará as falhas de DNS de uma configuração e será iniciado com êxito, se pelo menos um servidor em cada ServerCluster puder resolver o nome de host. Se um nome de host não puder ser resolvido, ele será marcado como indisponível para que a configuração continue a existir. Não são feitas outras tentativas de resolver o nome de host durante o roteamento das solicitações. Se ocorrer uma falha de DNS, será gravada uma mensagem no arquivo de log do plug-in e o processo de inicialização do plug-in continuará.

Por padrão, quando o valor é false, as falhas de DNS fazem com que o plug-in não seja iniciado e as solicitações falhem. Entretanto, o servidor da Web é iniciado.

Informações	Valor
Tipo de dados	String
Padrão	falso

Atualizar Intervalo de Configuração

Especifica o intervalo de tempo, em segundos, no qual o plug-in deve verificar o arquivo de configuração para determinar se ocorreram atualizações ou alterações. O plug-in verifica no arquivo se ocorreram quaisquer modificações desde a última vez que a configuração do plug-in foi carregada.

Em um ambiente de desenvolvimento no qual alterações são freqüentes, uma definição mais baixa que a definição padrão de 60 segundos é preferível. Em produção, um valor mais alto do que o padrão é preferível porque as atualizações à configuração não ocorrerão com tanta freqüência. Se o recarregamento do plug-in falhar por algum motivo, uma mensagem será gravada no arquivo de registro do plug-in e a configuração anterior será utilizada até que o arquivo de configuração do plug-in seja carregado novamente com êxito. Se você não estiver vendo as alterações que fez na configuração de seu plug-in, verifique o arquivo de registro do plug-in para indicações do problema.

Informações	Valor
Tipo de dados	Número Inteiro
Padrão	60 segundos.

Nome do arquivo de configuração do plug-in

Especifica o nome do arquivo do arquivo de configuração para o plug-in. Por padrão, o Application Server gera o arquivo plugin-cfg.xml. O arquivo de configuração identifica aplicativos, servidores de aplicativos, clusters e portas HTTP para o servidor da Web. O servidor da Web utiliza o arquivo para acessar aplicativos implementados em vários servidores de aplicativos.

Evitar Problemas: Esse campo fica desativado e não pode ser alterado, mas o valor é exibido apenas para informações.gotcha

Se for desejado um local diferente, será necessário executar novamente o Plug-in Configuration Tool (pct) para definir o novo local e, em seguida, executar o script configureWebserver produzido a partir do processo de instalação na máquina do WebSphere Application Server.

Se você selecionar um plug-in do servidor da Web durante a instalação, o programa instalador configurará o servidor da Web para identificar o local do arquivo plugin-cfg.xml, se possível. O arquivo de configuração de plug-in, por padrão, é instalado no diretório plugins_root/config/web_server_name.

O programa instalador inclui uma diretiva na configuração do servidor da Web que especifica o local do arquivo plugin-cfg.xml.

Para servidores da Web remotos, você deve copiar o arquivo do diretório local no qual o servidor de aplicativos está instalado para a máquina remota. Isto é conhecido como propagação do arquivo de configuração do plug-in. Se estiver utilizando o IBM HTTP Server V6.1 ou posterior para seu servidor da Web, o WebSphere Application Server poderá propagar automaticamente o arquivo de configuração de plug-in para você para máquinas remotas desde que haja um mecanismo de transporte HTTP em funcionamento para propagar o arquivo.

É possível clicar em Visualizar para exibir uma cópia do arquivo de configuração de plug-in atual.

Informações	Valor
Tipo de dados	String
Padrão	plugin-cfg.xml

Gerar Automaticamente o Arquivo de Configuração de Plug-in

Para gerar automaticamente um arquivo de configuração de plug-in para um servidor da Web remoto:

Este campo deve ser marcado.
O serviço de configuração do plug-in deve ser ativado

Quando o serviço de configuração do plug-in for ativado, um arquivo de configuração de plug-in será gerado automaticamente para um servidor da Web sempre que:

O administrador do WebSphere Application Server definir um novo servidor da Web.
Um aplicativo for implementado em um Application Server.
Um aplicativo for desinstalado.
Uma definição de host virtual for atualizada e salva.

Por padrão, este campo está marcado. Limpe a caixa de seleção se desejar gerar manualmente um arquivo de configuração de plug-in para este servidor da Web.

Importante: Quando o arquivo de configuração do plug-in é gerado, ele não inclui admin_host na lista de hosts virtuais. O artigo do Centro de Informações "Permitindo que servidores da web acessem o console administrativo" descreve como incluir admin_host na lista de hosts virtuais.

Propagar Automaticamente o Arquivo de Configuração de Plug-in

Especifica se você deseja ou não que o servidor de aplicativos propague automaticamente uma cópia de um arquivo de configuração de plug-in alterado para um servidor da Web:

Este campo deve ser marcado.
O serviço de configuração do plug-in deve ser ativado
Em um ambiente de Implementação de Rede, um agente de nó do WebSphere Application Server deve estar no nó que hospeda o servidor da Web associado ao arquivo de configuração de plug-in alterado.

Por padrão, este campo está marcado.

Nota: O arquivo de configuração de plug-in pode ser automaticamente propagado para um servidor da Web remoto se esse servidor da Web for um IBM HTTP Server V6.1 ou posterior e seu servidor de administração estiver em execução.

Como o serviço de configuração de plug-in é executado no segundo plano e não está vinculado ao console administrativo, o console administrativo não pode mostrar os resultados da propagação automática.

[AIX Solaris HP-UX Linux Windows] Para plataformas distribuídas, é possível verificar as mensagens relacionadas arquivo SystemOut.log do gerenciador de implementação para saber se a propagação automática foi concluída com êxito.

[z/OS] Para a plataforma z/OS, você pode verificar as mensagens relacionadas no registro TSO JOB para saber se a propagação automática foi concluída com êxito.

Nome do arquivo de armazenamento de chaves do plug-in

Especifica o caminho de diretório completo e o nome do arquivo do banco de dados que contém seus anéis de chaves de segurança que o plug-in do servidor da Web utiliza para pedidos HTTPS. Esse arquivo reside no servidor da Web associado ao plug-in do servidor da Web. Após especificar o caminho de diretório completo e o nome do arquivo do banco de dados, é possível:

Clicar em Gerenciar Chaves e Certificados para atualizar esse arquivo.
Clicar em Copiar para o Diretório de Armazenamento de Chaves do Servidor da Web para incluir uma cópia desse arquivo no diretório de armazenamento de chaves do servidor da Web.

Informações	Valor
Tipo de dados	String
Padrão	Nenhuma

Diretório e nome do arquivo de configuração do plug-in

Especifica o caminho completo da cópia do servidor da Web do arquivo de configuração de plug-in do servidor da Web. Esse caminho é o nome do arquivo e seu local na máquina na qual o servidor da Web está em execução.

Evitar Problemas: Esse campo fica desativado e não pode ser alterado, mas o valor é exibido apenas para informações.gotcha

Diretório e nome do arquivo do armazenamento de chaves do plug-in

Especifica o caminho completo da cópia do servidor da Web do arquivo de banco de dados que contém seus key rings de segurança. Esse caminho é o nome do arquivo e seu local na máquina na qual o servidor da Web está em execução.

Evitar Problemas: Esse campo fica desativado e não pode ser alterado, mas o valor é exibido apenas para informações.gotcha

Registro do Plug-in

Especifica o local e o nome do arquivo http_plugin.log. Também especifica o escopo de mensagens no registro.

O registro descreve a localização e o nível das mensagens de registro que são gravadas pelo plug-in. Se um log não for especificado no arquivo de configuração, então, em alguns casos, as mensagens de log serão gravadas no log de erros do servidor da Web.

Em uma plataforma distribuída, se o arquivo de registro não existir, ele será criado. Se o arquivo de registro já existir, ele será aberto no modo anexar e as mensagens de registro do plug-in anteriores permanecerão.

Nome do arquivo de log: O caminho completo para o arquivo de log no qual o plug-in gravará mensagens de erro.

Informações	Valor
Tipo de dados	String
Padrão	`plugins_root`/logs/`web_server_name`/http_plugin.log Especifique o caminho de arquivo do arquivo http_plugin.log.

Nível de log: O nível de detalhes das mensagens de log que o plug-in deve gravar no log. É possível especificar um dos valores a seguir para esse atributo:

Trace. Todas as etapas do processo de pedido são registradas em detalhes.
Stats. O servidor selecionado para cada pedido e outras informações de equilíbrio de carga relacionadas ao tratamento do pedido são registrados.
Warn. Todas as mensagens de aviso e de erro resultantes do processamento de pedidos anormal são registradas.
Error. Somente as mensagens de erro resultantes do processamento de pedidos anormal são registradas.
Debug. Todas as etapas críticas executadas no processamento de pedidos são registradas.
Detalhe. Todas as informações sobre pedidos e respostas são registradas.

Se um Nível de registro não for especificado, o valor padrão Error será utilizado.

Tenha atenção ao definir o nível como Trace. Muitas mensagens são registradas neste nível, o que causa o rápido preenchimento do espaço em disco/sistema de arquivos. Uma definição Trace nunca deve ser utilizada em um ambiente de funcionamento normal pois prejudica o desempenho.

Importante: Se o servidor da Web e o plug-in de servidor da Web estiverem em execução em um sistema AIX, HP-UX, Linux ou Solaris, e você mudar o nível de registro, no arquivo plugin-cfg.xml, essa mudança não será selecionada dinamicamente. Você deverá reiniciar o servidor da Web para captar a mudança. Por exemplo, no Solaris, se você não reiniciar o servidor da Web, a seguinte mensagem de erro aparecerá no arquivo Plugin_Home/logs/http_plugin.log:

ERRO: ws_config_parser:handleLogEnd: Falha em abrir o arquivo de registro 
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS

Informações	Valor
Tipo de dados	String
Padrão	Erro

Nome do arquivo: uwsv_plugin_props.html