A interface administrativa do HATS pode ser utilizada para gerenciar conexões e executar determinação de problemas para aplicativos da Web HATS. Este capítulo descreve como é possível utilizar essas funções de gerenciamento. Para obter informações relacionadas aos aplicativos rich client do HATS, consulte Administrando Aplicativos Rich Client do HATS.
É possível incluir arquivos de suporte do console administrativo do HATS com o conjunto de aplicativos HATS contidos dentro de um arquivo .ear (Enterprise Archive) implementado para o WebSphere Application Server. O arquivo .ear implementado fornece um ambiente de tempo de execução, no qual o console administrativo do HATS permite gerenciar aplicativos HATS. Se você incluir os arquivos do console administrativo do HATS em vários projetos, mais de um console administrativo poderá ser iniciado utilizando diferentes nomes de aplicativos; no entanto, cada console administrativo fornece as mesmas visualizações e funções.
Em vez de incluir os arquivos de suporte do console administrativo do HATS em cada arquivo .ear, você pode criar um arquivo .ear que contenha apenas arquivos do console administrativo do HATS. Ao implementar este arquivo .ear, é possível iniciar o HATS console administrativo e alterar o escopo de gerenciamento para gerenciar remotamente os aplicativos HATS em vários arquivos .ear (bem como portlets HATS IBM® e padrão) com uma instância do console administrativo. O aplicativo implementado do console administrativo do HATS fornece um único ponto de administração para todos os aplicativos do HATS. Ao criar um novo projeto do HATS, você especifica se deve incluir os arquivos do console administrativo do HATS no projeto. Se você criar um projeto do console administrativo do HATS, não precisará mais incluir os arquivos de suporte de administração em outros projetos que criar.
Para criar um projeto do console administrativo do HATS no HATS Toolkit, siga o caminho Arquivo > Novo > Projeto > HATS > Projeto de Administração do HATS. Você deve especificar um nome de projeto Enterprise Application que identifique exclusivamente esse projeto como o projeto do console administrativo do HATS. O projeto do console administrativo do HATS apenas aparece no HATS Toolkit na guia Navegador. Implemente e inicie o arquivo .ear criado no WebSphere Application Server (consulte Iniciando o Console Administrativo do HATS). Para alterar o escopo do gerenciamento para o projeto do console administrativo do HATS, consulte Selecionando o Escopo de Gerenciamento.
Outros tópicos de administração estão descritos em Funções do Terminal de Vídeo.
O console administrativo do HATS utiliza um bean JMX (Java™ Management Extensions) para desempenhar a administração remota. Quando a segurança global do WebSphere Application Server está ativada, estas chamadas de JMX são autenticadas pela segurança do WebSphere e devem ter um nível válido de autorização no WebSphere. Conseqüentemente, a administração remota do console administrativo do HATS não funciona adequadamente, a menos que o ID do usuário esteja definido como um usuário do console administrativo do WebSphere Application Server com autoridade de Administrador ou de Operador.
O console administrativo do HATS permite visualizar e alterar configurações de determinação de problemas. Ele também permite visualizar status de conexão ou desconectar conexões do host. Quando você implementa um aplicativo do HATS com recursos administrativos do HATS, pode mapear cada uma das três funções do HATS para IDs de usuário do sistema específicos para segurança. As três funções do HATS definidas (HATSAdministrator, HATSOperator e HATSMonitor) possuem recursos diferentes dentro do console administrativo do HATS. Para obter informações adicionais, consulte Funções do Console Administrativo do HATS.
De modo semelhante, o console administrativo do WebSphere Application Server permite visualizar e alterar a configuração do ambiente do WebSphere Application Server. Ele permite instalar, iniciar, parar e desinstalar aplicativos da Web como aplicativos do HATS. Existem funções do usuário do console do WebSphere (Administrador, Configurador, Operador ou Monitor) que fornecem diferentes recursos no console administrativo do WebSphere Application Server. Os seguintes links do Centro de Informações do WebSphere Application Server fornecem detalhes adicionais sobre estas funções de segurança e políticas:
Se a segurança global do WebSphere estiver ativada, os IDs de usuários que possuem uma função do HATS poderão conectar-se ao console administrativo do HATS em um aplicativo do HATS e poderão desempenhar tarefas de administração apenas nesse aplicativo específico do HATS. Se o usuário tentar alterar o escopo de gerenciamento para administrar remotamente outro aplicativo do HATS, a segurança do WebSphere verificará a autoridade do ID do usuário. Se o ID do usuário não for um usuário válido do console administrativo do WebSphere Application Server com autoridade de Administrador ou Operador, as chamadas de JMX serão bloqueadas e a administração remota do HATS não funcionará adequadamente.
Por exemplo, se o ID do usuário não for definido como um usuário do console administrativo do WebSphere Application Server ou for definido com apenas autoridade de Monitor, a lista Selecionar Aplicativo em Escopo de Gerenciamento no console administrativo do HATS não exibirá nenhum outro aplicativo do HATS. Não será possível alterar o escopo do gerenciamento porque nenhum outro aplicativo está listado.
Como outro exemplo, se o ID do usuário estiver definido como um usuário do console administrativo do WebSphere Application Server com a autoridade de Configurador, a lista mostrará outros aplicativos do HATS e o usuário poderá alterar o escopo de um aplicativo para o outro. No entanto, as informações mostradas no console administrativo do HATS poderão estar incorretas e todas as alterações tentadas através da administração remota não terão efeito.
Portanto, se a segurança global do WebSphere estiver ativada, existirão duas opções para utilizar o console administrativo do HATS.
Para cada uma das opções, se a segurança global do WebSphere estiver ativada, certifique-se de que a opção Ativar Segurança do Aplicativo esteja selecionada. Para WebSphere Application Server V6.x, a partir do Console Administrativo WebSphere, selecione Segurança > Administração, Aplicativos e Infraestrutura Seguros > Segurança do Aplicativo > Ativar Segurança do Aplicativo. Para o WebSphere Application Server V7.x, a partir do Console Administrativo WebSphere, selecione Segurança > Segurança Global > Segurança do Aplicativo > Ativar Segurança do Aplicativo.
Em resumo, se a segurança global do WebSphere estiver ativada, os IDs de usuário que são mapeados para qualquer função do HATS também deverão ser mapeados para as funções de Administrador ou Operador do WebSphere Application Server para que a administração remota do HATS funcione adequadamente.
O console administrativo do HATS está vinculado à segurança do WebSphere. Isto significa que, quando a segurança do WebSphere Application Server está ativada, seus administradores de sistema devem ter a autenticação apropriada para desempenhar tarefas administrativas do HATS. As funções de segurança utilizadas pelo HATS são baseadas no processo de autenticação baseado em formulários do Java EE. Quando a segurança do WebSphere Application Server está ativada, as operações do console administrativo do HATS estarão restritas com base na função definida para um ID do usuário. Existem três funções definidas para utilização do console administrativo do HATS. Cada função tem recursos diferentes.
O mapeamento de funções para usuários ou grupos de usuários é executado utilizando o console administrativo do WebSphere.
Para o WebSphere Application Server V6.x, certifique-se de a opção Todos Autenticados no painel Mapear Funções de Segurança para Usuários/Grupos esteja marcada para a função apropriada do HATS. Para o WebSphere Application Server V7.x, certifique-se de que a opção Todos Autenticados na Região do Aplicativo esteja selecionada utilizando a opção suspensa Mapear Assuntos Especiais no painel Mapear Funções de Segurança para Usuários/Grupos para a função apropriada do HATS.
O console administrativo do HATS é baseado na Web. As tarefas de administração são desempenhadas utilizando um navegador da Web, através de uma interface com o usuário fornecida pelo servlet do console administrativo do HATS, HATSAdminServlet.
Para iniciar o console administrativo do HATS, carregue esta URL em seu navegador: http://host:port/appname/hatsadmin/admin, em que host é seu nome do host, port é o número de porta do transporte HTTP do servidor de aplicativos no qual o aplicativo do HATS está em execução e appname é o nome de um aplicativo do HATS que inclui o suporte à administração.
Quando você iniciar o console administrativo do HATS, ele utilizará o idioma padrão do servidor. Você pode, no entanto, alterar o idioma selecionando Preferências no quadro de navegação, escolhendo o idioma que você deseja e reiniciando o navegador. A nova opção de idioma permanece em vigor para esse navegador até que você selecione outro idioma em Preferências.
O console administrativo do HATS pode ser iniciado no HATS Toolkit, utilizando o modo Depurar no Servidor ou Executar no Servidor.
Para ativar o console administrativo do HATS para um projeto específico, clique com o botão direito do mouse no projeto na visualização Projetos HATS e clique em Abrir Console Administrativo.
Se o projeto ainda não estiver executando em um ambiente de teste local, então, ele será ativado utilizando o modo Depurar no Servidor e uma página do navegador da Web será aberta para a URL do console administrativo.
Se o projeto já estiver em execução utilizando o modo Executar no Servidor, será exibido um aviso informando que o servidor não está em execução no modo Depurar. Se você selecionar a opção Continuar no Modo Atual, o console administrativo abrirá no modo Executar no Servidor.
Para obter informações adicionais sobre a execução em modos de teste diferentes, consulte Testando modos para projetos da Web em Introdução ao HATS.
As configurações de tempo de execução alteradas ao executar o console administrativo no HATS Toolkit dependem de qual modo está sendo utilizado. Para obter informações adicionais, consulte Administrando Componentes de Determinação de Problemas.
Esta seção guiará você pelas diversas funções no console administrativo do HATS.
É possível selecionar o escopo de gerenciamento. O console administrativo do HATS mantém uma lista dos escopos de gerenciamento para a vida útil do HttpSession. Por padrão, o escopo inicial do gerenciamento é selecionado como o aplicativo corporativo HATS (.ear) do aplicativo HATS utilizado para acessar o console administrativo do HATS. Você pode alterar o escopo do gerenciamento para gerenciar outros aplicativos corporativos do HATS implementados na mesma célula do WebSphere.
A chave para alterar o escopo de gerenciamento é fornecer as informações de host e porta para o console administrativo do HATS para localizar os aplicativos corporativos HATS instalados. O valor de porta especificado deve ser uma porta BOOTSTRAP_ADDRESS do WebSphere ativa. Cada WebSphere Application Server, nó e célula possui uma porta BOOTSTRAP_ADDRESS. A especificação do valor de porta para um destes recursos do WebSphere ativa a administração dos aplicativos corporativos do HATS implementados para esse recurso. Especificar um host e porta de um nó do WebSphere ativa a administração de todos os aplicativos corporativos do HATS instalados nesse nó. Consulte a documentação do WebSphere Application Server para obter informações adicionais sobre a porta BOOTSTRAP_ADDRESS.
Em um ambiente seguro, um administrador pode ver a seguinte mensagem no console administrativo do HATS ao tentar alterar o escopo de administração:
Houve um problema ao tentar gerenciar o escopo selecionado. Não foi localizado nenhum aplicativo HATS. Seu escopo de gerenciamento não foi alterado.
Isto pode ocorrer porque em um ambiente protegido do WebSphere, o usuário não está autorizado a realizar a comunicação requerida para preencher a lista de aplicativos disponíveis a serem administrados.
Se o WebSphere estiver utilizando o sistema operacional local como o registro do usuário, o nome do usuário utilizado para acessar o console administrativo do HATS deverá ter direitos de administrador no registro do sistema operacional local. Se o WebSphere estiver utilizando LDAP como o registro do usuário, o nome do usuário utilizado para acessar o console administrativo do HATS deverá ser o ID do servidor utilizado pelo WebSphere para acessar o LDAP.
Existem dois painéis sob o título Gerenciamento de Licença no quadro de navegação esquerdo para gerenciar as informações de licença:
Existem painéis separados sob o título de Gerenciamento de Conexão no quadro de navegação esquerdo com o qual você pode monitorar os diferentes tipos de conexões:
Cada conexão mostrada nessas exibições representa um link de comunicação à origem de dados backend, como um aplicativo 3270 ou um banco de dados. As exibições permitem que você veja detalhes sobre quais usuários estão conectados a quais origens de dados e quais identificadores de conexão eles estão utilizando. Se existir um nome de LU ou Conjunto para uma conexão 3270, ele também será exibido. Você também pode encerrar sessões.
O painel Conjuntos de Conexões sob o título Gerenciamento de Conexão no quadro de navegação esquerdo exibe as informações sobre os conjuntos de conexão definidos. Um conjunto de conexões não é relacionado até que pelo menos uma conexão seja alocada no conjunto.
Os conjuntos de conexões são coleções de links de comunicação para origem de dados de backend, tais como bancos de dados ou aplicativos 3270. Quando um Objeto de Integração ou um aplicativo for executado devido à solicitação de um cliente, ele obtém uma conexão disponível de um conjunto, a utiliza para acessar a origem de dados e, em seguida retorna a conexão ao conjunto. Quando o conjunto de conexões é ativado, o uso do processador para estabelecer uma conexão é absorvido em sua primeira utilização. Cada reutilização desta conexão obtém benefícios da conexão estabelecida anteriormente e pode ser executada mais rápido.
O painel Definições do Conjunto de Conexões sob o título Gerenciamento de Conexão no quadro de navegação esquerdo exibe as informações de definição do conjunto para conexões do host e do banco de dados. Uma definição de conjunto não será listada até que ao menos uma conexão seja alocada a partir do conjunto definido.
Uma definição do conjunto fornece informações sobre uma coleção de conexões de fontes de dados. Algumas definições relacionadas estão associadas a uma definição de conjunto, por exemplo, definições de conexão e de macro e nome da lista de usuários. Além de criar associações entre várias outras definições, a definição do conjunto fornece parâmetros de configuração para todas as conexões no conjunto, como tamanho mínimo e máximo do conjunto (em termos de número de conexões ativas) e temporizadores de conexão.
O painel Listas de Usuários sob o título Gerenciamento de Usuário no quadro de navegação esquerdo exibe as informações sobre as listas de usuários.
As listas de usuários identificam os IDs de usuário e outros parâmetros específicos da conexão associados a uma determinada definição de conjunto de conexões. Para sistemas que permitem apenas uma única conexão por ID de usuário, o número de IDs de usuário determina o número de conexões que podem estar ativas em um único conjunto.
O console administrativo do HATS permite monitorar a criação de log e rastreio para ajudá-lo a resolver problemas. Você pode visualizar as mensagens no log e alterar as configurações de log e de rastreio, selecionando os links sob o título Resolução de Problemas no quadro de navegação esquerdo. Arquivos de propriedades mantêm configurações para esses auxílios de determinação de problemas.
Quando você altera configurações enquanto acessa o console administrativo do HATS em execução em um ambiente de tempo de execução, as alterações são salvas no arquivo runtime.properties. Embora não seja recomendado, você também pode editar o arquivo diretamente para alterar as configurações. O arquivo é localizado no diretório was_dir/installedApps/ear_name para um aplicativo corporativo HATS.
Quando você altera configurações enquanto acessa o console administrativo do HATS em execução em um ambiente de teste local no HATS Toolkit, as alterações são salvas em um de dois arquivos diferentes. As alterações são salvas no arquivo runtime.properties ao executar no modo Executar no Servidor e no arquivo runtime-debug.properties ao executar no modo Depurar no Servidor. Para obter informações adicionais, consulte Iniciando o Console Administrativo Enquanto Está no HATS Toolkit. Você também pode editar os arquivos diretamente para alterar as configurações. Os arquivos estão localizados na raiz do projeto .ear no HATS Toolkit. Esteja ciente de que qualquer alteração feita no arquivo runtime.properties no HATS Toolkit será retida e se tornará efetiva quando você implementar o aplicativo do HATS em um ambiente de tempo de execução. O arquivo runtime-debug.properties é ignorado no ambiente de tempo de execução.
Para obter informações adicionais sobre configurações de log e rastreio nestes arquivos, consulte Apêndice A. Arquivo de Propriedades de Tempo de Execução.
Os nomes de base dos arquivos de rastreio e log em runtime.properties são utilizados como modelos para gerar conjuntos exclusivos de arquivos de rastreio e log para cada servidor de aplicativos. O nome base padrão do arquivo de rastreio é trace.txt; o nome base padrão do arquivo de log é messages.txt. O nome do servidor de aplicativos é anexado ao nome básico do arquivo para gerar o modelo para os arquivos de rastreio e log para um servidor de aplicativos. O nome do servidor de aplicativos é o mesmo que o nome completo do servidor de aplicativos, conforme definido pelo WebSphere. Esse nome é cell_node_server, em que:
O servidor de aplicativos executando o HATS é a concatenação do caractere de sublinhado (_) seguido pelo nome do servidor de aplicativos, seguido por outro caractere de sublinhado (_).
Utilizando o arquivo de rastreio como exemplo, o nome se torna trace _cell_node_server_.txt. Finalmente, um índice (1, 2, 3 e assim por diante) será incluído nesse nome para diferenciar vários arquivos. Com vários arquivos de rastreio configurados, os nomes do arquivo de rastreio para este servidor de aplicativos são trace_cell_node_server_1.txt, trace_cell_node_server_2.txt e assim por diante.
Utilizando o painel Visualizar Log, você pode visualizar o arquivo de log do HATS, fazer download do arquivo inteiro ou limpar o arquivo. O arquivo de log registra as informações sobre dois tipos de eventos:
O arquivo de registro é destinado para você ler e utilizar como uma referência quando detectar problemas. A maioria das mensagens que aparecem no log é documentada na publicação Mensagens do HATS. Essa publicação contém sugestões para ações que você pode tomar para corrigir os problemas, quando necessário.
Utilizando o painel Configurações de Log, é possível controlar se as informações e eventos de avisos serão gravados no arquivo de log e definir o arquivo no qual os eventos de log serão gravados. Consulte Nomes dos Arquivos de Rastreio e Log para obter informações sobre como os arquivos de log são nomeados. Se o arquivo já existir, novos eventos serão anexados a ele. Eventos de erro são sempre gravados no arquivos de registro. Também é possível definir como os arquivos de log são mantidos e o tamanho máximo de cada arquivo de log.
Utilizando o painel Configurações do Rastreio, você pode selecionar um ou mais dos seguintes tipos de opções de rastreio:
Para rastrear várias sessões do host simultaneamente, a simulação do host utiliza várias portas TCP/IP. Utilize os campos Intervalo de Portas TCP/IP para Registro para configurar o intervalo de números de portas para uso de tempo de execução do servidor. A porta de início padrão no intervalo é 7021 e a porta de finalização padrão é 7050.
Ao depurar aplicativos em um sistema de teste, você pode controlar se uma janela do terminal que exibe telas do host é criada no vídeo do servidor. Você pode utilizar telas do host exibidas na janela do terminal para observar as interações entre os aplicativos HATS e o aplicativo host no tempo de execução. Você também pode interagir com o aplicativo do host utilizando a tela do host na janela do terminal. As telas do terminal são criadas apenas para conexões estabelecidas enquanto esta opção está ativada. Não são criadas para conexões existentes ou inativas. No entanto, o painel Conexões do Host no console administrativo do HATS inclui um botão Comutar Status de Vídeo que liga e desliga o terminal de vídeo para as conexões selecionadas.
Você pode ativar o terminal de vídeo para quaisquer novas conexões do host, selecionando a caixa Ativar Terminal de Vídeo no painel Configurações de Rastreio, sob o título Resolução de Problemas, no quadro de navegação esquerdo; no entanto, você pode utilizar Comutar Terminal de Vídeo no painel Conexões do Host para ativar e desativar o terminal de vídeo para uma conexão específica a qualquer momento, independentemente de você ter selecionado a caixa Ativar Terminal de Vídeo no painel Configurações de Rastreio.