Information Center

Configurando o servlet de configuração

Por padrão, os clientes do Host On-Demand que são criados utilizando o modelo baseado no Servidor de configuração ou no modelo Combinado utilizam a porta 8999 para acessar informações de configuração a partir do Gerenciador de Serviços. Para clientes do Host On-Demand que são criados utilizando o modelo baseado em HTML, todas as informações de configuração de sessão do host estão contidas nos próprios arquivos HTML. A única vez que os clientes criados utilizando o modelo baseado em HTML precisam acessar o servidor de configuração é quando a contagem do uso de licenças está ativada. Você pode desativar o LUM (gerenciamento de utilização de licenças) adicionando um parâmetro Desativar com um valor de LUM na janela de parâmetros HTML de Opções Avançadas no Assistente para Implementação.

Se qualquer um de seus clientes estiver fora do firewall, o administrador de firewall precisa abrir a porta 8999 internamente e externamente. No entanto, você pode evitar abrir esta porta personalizando os clientes para utilizarem o servlet de configuração para acessar as informações de configuração. O servlet de configuração encapsula as informações de configuração do cliente para o servidor de configuração por meio de uma conexão HTTP ou HTTPS utilizando a porta do servidor de configuração definida. Consulte Instalando o Servlet de Configuração no guia Planejando, Instalando e Configurando o Host On-Demand para obter informações sobre como instalar o servlet de configuração.

Parâmetros do servlet de configuração

O servlet de configuração do Host On-Demand reconhece estes parâmetros. Verifique o servidor da Web ou a documentação do mecanismo de servlet para obter instruções sobre como passar parâmetros para um servlet.

Parâmetro Valor Padrão Descrição
ConfigServer 127.0.0.1 Nome do host ou endereço IP do servidor Host On-Demand.
ConfigServerPort 8999 Número da porta que o Host On-Demand Service Manager atende.
BufferSize 4096 Tamanho do buffer a ser utilizado para cadeias de entrada ou saída protegidas.
PoolSize 5 Tamanho do buffer ou conjunto de dispositivos a suportar. Para desabilitar esta função, defina PoolSize para 0.
Rastreamento falso Quando definido para verdadeiro, o servlet de configuração escreve mensagens servlet para o log de arquivos do mecanismo servlet e para o navegador quando requerido, por motivos de depuração.
ShowStatsfalso Quando definido para verdadeiro, permite que o servlet de configuração retorne informações de configuração e estatísticas para requisições do navegador.

Parâmetros do Cliente

Os clientes Host On-Demand, assim como o cliente de administração (HODAdmin.html) e o cliente em cache (HODCached.html), reconhecem estes parâmetros:

Parâmetro Valor Padrão Descrição
ConfigServer Servidor Host On-Demand Nome do host do servidor Host On-Demand. O valor padrão é obtido da parte de nome de host do endereço do cliente.
ConfigServerPort 8999 Número da porta que o Host On-Demand Service Manager atende.
ConfigServerURL Não padrão Endereço ou alias do servlet de configuração Host On-Demand.

É possível definir os parâmetros do cliente no código HTML do cliente no arquivo config.properties colocado no diretório de publicação (o mesmo diretório dos arquivos HTML do cliente no servidor) ou permitir que os clientes utilizem os valores padrão do parâmetro. Quando os clientes são carregados, primeiro eles procuram os parâmetros definidos no código HTML. Se nenhum existir, eles procuram quaisquer parâmetros definidos em um arquivo config.properties. Se nenhum parâmetro estiver definido no config.properties ou se o config.properties não existir, os clientes utilizarão as definições padrão. O arquivo config.properties pode ser um arquivo de texto ASCII ou UTF-8 e contém pares name=value. Linhas que começam com "#" são tratadas como comentários.

Se você precisar editar o config.properties para um servidor z/OS, transfira primeiramente o arquivo em binário para um sistema baseado em ASCII, tal como Windows ou Unix. Edite o arquivo e, em seguida, transfira-o de volta para o sistema z/OS em binário. Se você precisar criar um arquivo config.properties, faça isso em um sistema ASCII e, em seguida, transfira o arquivo para o servidor z/OS em binário. O motivo para isso é que os applets do cliente esperam o texto ASCII no config.properties, mas os arquivos criados ou editados no z/OS estão armazenados em EBCDIC.

Por exemplo, para definir o número da porta que o cliente utiliza para entrar em contato com o Gerenciador de Serviços da porta padrão 8999 como 12345, coloque ConfigServerPort=12345 sozinho em uma linha do arquivo config.properties.

Quando existe um arquivo config.properties no diretório de publicação, todos os clientes utilizam o mesmo arquivo. Se desejar que alguns clientes utilizem suas próprias definições exclusivas, você pode configurar as opções de conexão do Servidor na janela Opções Avançadas do Assistente para Implementação quando estiver criando ou editando os arquivos HTML do cliente.

Quando especificar as opções de conexão do Servidor para um determinado arquivo HTML do cliente, as opções selecionadas sobrescreverão os valores do sistema que podem ter sido definidos no config.properties, tais como, os especificados durante o processo de instalação do Host On-Demand.

Você não pode utilizar o Assistente para Implementação para editar arquivos HTML criados manualmente. Também não pode utilizar o Assistente para Implementação para editar arquivos HTML criados com o Assistente e editados posteriormente de forma manual.

Como depurar informações

Você pode acessar informações de rastreio, configuração e estatística a partir do servlet de configuração, com a finalidade de depuração. Para acessar informações de rastreio é necessário definir o parâmetro Trace para verdadeiro para o servlet de configuração. Para exibir o rastreio, carregue http://server_name/servlet_alias/HODConfig/trace em seu navegador. As informações de rastreio do servlet de configuração serão exibidas no navegador e gravadas no arquivo de log do mecanismo do servlet.

Para acessar informações de configuração e estatística é necessário definir o parâmetro ShowStats para verdadeiro para o servlet de configuração. Para exibir as informações, carregue http://server_name/servlet_location/HODConfig/info em seu navegador.

Tópicos relacionados: