Guia de Resolução de Problemas

Transcrição

1 Tioli OMEGAMON XE em z/vm e Linux Versão Guia de Resolução de Problemas G

2

3 Tioli OMEGAMON XE em z/vm e Linux Versão Guia de Resolução de Problemas G

4 Nota Antes de utilizar essas informações e o produto suportado por elas, leia as informações nos Aisos na página 77. Esta edição se aplica à Versão 4, Release 2, Modificação 0 de Tioli OMEGAMON XE no z/vm e Linux (número do produto 5698-A36) e a todos os releases e modificações subsequentes, até que seja indicado o contrário em noas edições. Copyright IBM Corporation 2006, 2010.

5 Índice Tabelas ii Prefácio ix Público-alo ix O Que Este Guia Contém ix Capítulo 1. Introdução à Resolução de Problemas Origens de Informações sobre Resolução de Problemas Coletando Dados Capítulo 2. Determinando a Causa de um Problema Fluxo de Resolução de Problemas para um Agente de Monitoramento do OMEGAMON XE Determinando qual Componente Pode Ser a Causa de um Problema Problemas que Podem Ser Reproduzidos como Problemas do Cliente do Tioli Enterprise Portal.. 6 Problemas que Podem Ser Reproduzidos Relatados como Problemas de Tioli Enterprise Portal Serer Tioli Enterprise Monitoring Serer em Computadores Windows ou em Computadores UNIX Tioli Data Warehouse eowarehouse Proxy Agente de Resumo e Limpeza Problemas que Afetam o Agente de Monitoramento do OMEGAMON XE on z/vm and Linux Rsastreio do RAS Sintaxe para Rastreios do RAS Configurando os Níeis de Rastreio de RAS1 para um Agente de Monitoramento do OMEGAMON XE Entendendo e Usando Logs do RAS Formato das Mensagens em um Log do RAS Configurando Níeis de Rrastreio em um Tioli Enterprise Monitoring Serer no z/os Usando a Ferramenta de Configuração Capturando Logs de z/os para Eniar para o Suporte de Software Usando a Ferramenta Log and Trace Analyzer Outras Fontes de Informações de Solução de Problemas Capítulo 3. Resolução de Problemas de Instalação e Configuração Executando a Versão Base (4.1.0) desse Agente de Monitoramento Executando uma Versão do Agente de Monitoramento com uma Versão do Sistema Operacional z/vm que não É Suportada Permissões Adequadas nos Computadores Linux ou UNIX Valor do ID do Usuário do Banco de Dados do Tioli Enterprise Portal Serer Bibliotecas Compartilhadas Necessárias Fazendo Upgrade de um Ambiente Existente do IBM Tioli Monitoring Instalação em um Noo Ambiente Ao Instalar o IBM Tioli Monitoring no Red Hat Enterprise Linux 5, se Vir a Mensagem de Erro: KCI1235E Encerrando... Problema ao Iniciar a Jaa Virtual Machine O Tioli Monitoring Agent para Linux OS Falha ao Iniciar Comandos Take Action não Estão Sendo Eniados para o Processador de Comandos Executando no Linux como um Usuário Não-root Ao Executar no Linux como Usuário Não Raiz, uma Mensagem de Erro é Exibida durante a Instalação do Agente de Monitoramento Limpando o Cache do Plug-in Jaa DCSS Definido com Acesso Somente Leitura (SR) Procedimento de Amostra para Definir um DCSS Determinando os Locais de Segmentos Existentes Estimando o Tamanho do DCSS Copyright IBM Corp. 2006, 2010 iii

6 Decidindo sobre o Local do DCSS Definindo o DCSS no z/vm Estendendo a Variação de Endereços do Linux Locais e Tamanhos do DCSS de Amostra Executando sem Memória no DCSS Nenhuma Área de Trabalho é Listada na Árore do Naegador em Sistemas z/vm Linux Tioli Enterprise Portal Indica que o Agente de Monitoramento Está em Execução em Algumas Instância quando ele não Está em Execução Instalando uma Versão de 31 Bits em um Sistema de 64 Bits Capítulo 4. Resolução de Problemas de Coleta de Dados O Performance Toolkit não Está Coletando Dados O Guest do Linux não Está Obtendo Dados do DCSS PERFOUT Atualizados deido ao daemon de Vários Caminhos O DCSS PERFOUT Está Coletando Dados? As Áreas de Trabalho não Estão Exibindo o Uso de Memória do Linux, a Atiidade da Carga de Trabalho e os Dados de Utilização da Rede Os Dados não São Exibidos no Tioli Enterprise Portal Muitos Dados Históricos São Coletados A Área de Trabalho Recém-conectada não Exibe Dados A Área de Trabalho Histórica não Exibe Dados ou Exibe Muitos Dados As Áreas de Trabalho Históricas não Contêm Dados Capítulo 5. Resolução de Problemas de Desempenho O Agente de Monitoramento Recebe Erros de Chamada de Procedimento Remoto durante o Warehousing com algumas Solicitações Expirando e Falhando Desempenho para o Banco de Dados do Tioli Data Warehouse Está Degradado ou Há Interalos em que os Dados Históricos Estão Indisponíeis por um Período de Coleta Especificado Tempos de Resposta Longos ou Nenhum Resultado Retornado ao Especificar as Amplitudes de Tempo de Coleta Histórica para Algumas Áreas de Trabalho Capítulo 6. Resolução de Problemas de Link de Área de Trabalho Dinâmica Problema ao Criar Link de uma Área de Trabalho do OMEGAMON XE no z/vm e Linux para uma Área de Trabalho do Tioli Monitoring Agent para SO Linux Links entre Produtos Ausentes na Lista de Links Capítulo 7. Resolução de Problemas de Uso No Linux, os Tópicos do IBM Tioli Monitoring Agent Não São Exibidos no Conteúdo da Ajuda ou nas Guias de Índice Não É Possíel Iniciar a Ajuda do Tioli Enterprise Portal Cabeçalho no Espaço de Trabalho Primário é Transportado para o Espaço de Trabalho Secundário 51 O Tipo do Dispositio É Desconhecido O Agente de Monitoramento não É Iniciado depois da Execução de Mkinitrd Se não Houer Dado a Serem Exibidos, Legendas de Gráficos não Aparecerão nas Áreas de Trabalho do OMEGAMON XE no z/vm e Linux Alterações no Horário de Verão fora dos Estados Unidos A Área de Trabalho Log de Operações do Agente Não Exibe Dados se um Agente Estier Conectado Utilizando um Seridor de Monitoramento Remoto As Consultas SQL do Tioli Data Warehouse Falham deido a Nome de Coluna Inálido A Ajuda Flyoer Não Aparece no Query Editor Capítulo 8. Resolução de Problemas de Globalização Os Painéis Ajuda ou os Painéis Conselho de Especialista Podem não Ser Carregados em um Ambiente de Linguagem de Chinês Simplificado ao Usar o Tioli Enterprise Portal no Modo do Naegador i IBM Tioli OMEGAMON XE no z/vm e Linux: Guia de Resolução de Problemas

7 Em Computadores SUSE Linux Enterprise Serer 10, o Tioli Enterprise Portal Exibe Recursos de Texto Corrompidos no Código do Idioma Japonês Capítulo 9. Mensagens Formato da Mensagem Mensagens Capítulo 10. Prefixos do Componente Suporte para Resolução de Problemas Utilizando o IBM Support Assistant Obtendo Correções Recebendo Atualizações de Suporte Semanais Entrando em Contato com o Suporte de Software IBM Determinando o Impacto para os Negócios Descreendo Problemas e Reunindo Informações Eniando Problemas Biblioteca de Documentação OMEGAMON XE no z/vm e Linux biblioteca OMEGAMON XE no z/vm e Linux ajuda on-line Publicações doibm Tioli Monitoring Sistema de Ajuda do Tioli Enterprise Portal Publicações Relacionadas Acessando a Terminologia On-line Acessando Publicações On-line Solicitando Publicações Acessibilidade Aisos Marcas Registradas Glossário Índice Remissio Índice

8 i IBM Tioli OMEGAMON XE no z/vm e Linux: Guia de Resolução de Problemas

9 Tabelas 1. Locais de log para o Tioli Enterprise Portal Locais de log do Tioli Enterprise Portal Serer Locais dos logs do Tioli Enterprise Monitoring Serer em plataformas distribuídas Locais das informações de log e de rastreio do Tioli Enterprise Monitoring Serer no z/os Locais de log para o Agente de Resumo e Limpeza em plataformas distribuídas Locais de log para o agente de monitoramento do OMEGAMON XE on z/vm and Linux Versões Suportadas do Sistema Operacional z/vm Locais e tamanhos do DCSS de amostra Prefixos que podem ser exibidos em arquios de mensagens e de rastreio Copyright IBM Corp. 2006, 2010 ii

10 iii IBM Tioli OMEGAMON XE no z/vm e Linux: Guia de Resolução de Problemas

11 Prefácio IBM Tioli OMEGAMON XE on z/vm and Linux ersão 4 release 2 (V4.2.0) é um dos elementos de um conjunto de produtos do IBM Tioli Management Serices. Estes produtos monitoram seus sistemas distribuídos e de mainframe em uma ariedade de plataformas, além de fornecer relatórios baseados em estações de trabalho que ocê pode utilizar para acompanhar tendências e resoler problemas relacionados ao sistema. O produto OMEGAMON XE no z/vm e Linux coleta informações de métrica e desempenho do sistema sobre o z/vm e o Linux on IBM System z. Os dados coletados são exibidos pelo aplicatio Tioli Enterprise Portal. Consulte a ajuda on-line e as publicações do Tioli Enterprise Portal para obter detalhes sobre esta interface. Este guia fornece informações de resolução de problemas para os problemas mais comumente encontrados com o agente de monitoramento do OMEGAMON XE no z/vm e Linux. Você pode usar este guia em conjunto com as outras publicações no OMEGAMON XE no z/vm e Linux biblioteca na página 71. Consulte também o Publicações doibm Tioli Monitoring na página 72, especialmente o IBM Tioli Monitoring Guia de Resolução de Problemas. Público-alo O público principal desta publicação é o programador de sistema z/vm ou o administrador do sistema responsáel por garantir a disponibilidade dos recursos do sistema z/vm. Esta publicação é também destinada ao programador do Linux no System z ou ao administrador do sistema responsáel por garantir a disponibilidade de sistemas em execução nos guests do Linux. As responsabilidades do programador ou administrador de sistemas incluem: Planejamento e superisão da instalação do produto Resolução de problemas do sistema e problemas de desempenho. Análise de dados de desempenho para resolução de problemas Fornecimento de dados de desempenho históricos para análise de tendências Os usuários desta publicação deem estar familiarizados com os seguintes tópicos: Conceitos de monitoramento de desempenho. Interface do IBM Tioli Monitoring e do Tioli Enterprise Portal Os sistemas operacionais Linux em zseries e seus conceitos associados O sistema operacional z/vm e seus conceitos associados O Performance Toolkit para VM O sistema operacional Microsoft Windows O Que Este Guia Contém Este guia contém os seguintes capítulos e apêndices: Capítulo 1, Introdução à Resolução de Problemas, na página 1 introduz a resolução de problemas e como ocê pode começar a procurar as causas ao ter um problema. Capítulo 2, Determinando a Causa de um Problema, na página 3 descree as ferramentas para diagnosticar problemas, com ênfase na criação de logs de rastreio. Capítulo 3, Resolução de Problemas de Instalação e Configuração, na página 29 explica problemas que podem ocorrer durante a instalação e a configuração. Copyright IBM Corp. 2006, 2010 ix

12 Capítulo 4, Resolução de Problemas de Coleta de Dados, na página 41 descree os problemas que podem ocorrer com a coleta de dados. Capítulo 5, Resolução de Problemas de Desempenho, na página 47 descree os problemas que podem ocorrer com o desempenho. Capítulo 6, Resolução de Problemas de Link de Área de Trabalho Dinâmica, na página 49 descree os problemas que podem ocorrer com o link entre produtos. Capítulo 7, Resolução de Problemas de Uso, na página 51 descree os problemas que podem ocorrer ao usar o agente de monitoramento. Capítulo 8, Resolução de Problemas de Globalização, na página 55 descree os problemas relacionados à globalização. Capítulo 9, Mensagens, na página 57 descree as mensagens exibidas para esse agente de monitoramento. Capítulo 10, Prefixos do Componente, na página 61 lista os prefixos para todos os componentes do Tioli Management Serices e para os agentes de monitoramento do OMEGAMON XE que podem ser exibidos em um arquio de log e de rastreio. Suporte para Resolução de Problemas na página 67 descree as opções disponíeis para obter suporte para produtos de software IBM. Biblioteca de Documentação na página 71 contém informações sobre as publicações para o OMEGAMON XE no z/vm e Linux. Este apêndice lista as publicações que estão associadas ao IBM Tioli Monitoring. Este apêndice também inclui uma seção sobre as publicações e os Web sites que são releantes a este agente de monitoramento. Aisos na página 77 contém informações de direitos autorais e marca registrada. x IBM Tioli OMEGAMON XE no z/vm e Linux: Guia de Resolução de Problemas

13 Capítulo 1. Introdução à Resolução de Problemas Este guia o ajuda a decidir onde começar a procurar as causas ao ter um problema com um agente de monitoramento. Normalmente, ocê começa com um sintoma ou um conjunto de sintomas e os rastreia de olta para sua causa. Esse processo é chamado resolução de problemas. Resolução de problemas não é o mesmo que solução de problemas, embora, durante o processo de resolução de problemas, ocê possa obter informações suficientes para solucionar um problema. Exemplos de situações em que isso pode acontecer incluem o seguinte: Erros de usuários finais Erros de programação de aplicatios Erros de programação do sistema, como na definições de recursos No entanto, pode ser que nem sempre ocê consiga solucionar um problema sozinho depois de ter determinado sua causa. Por exemplo, um problema de desempenho pode ser proocado por uma limitação de seu hardware. Se ocê não conseguir solucionar um problema sozinho, entre em contato com o Suporte de Software da IBM para obter uma solução. Consulte Suporte para Resolução de Problemas na página 67. Informações de seriço sobre os componentes distribuídos de Tioli Management Serices e tarefas de seriços comuns ao ambiente distribuído e ao ambiente do z/os são documentadas no IBM Tioli Monitoring Guia de Resolução de Problemas. Essa publicação também explica as ferramentas de diagnóstico e a configuração do rastreio para os ários componentes distribuídos do Tioli Management Serices. Origens de Informações sobre Resolução de Problemas O recurso principal de resolução de problemas é a criação de log. A criação de log refere-se às mensagens de texto e aos dados de rastreio gerados pelo software. As mensagens e os dados de rastreio são eniados para o destino de saída, como uma tela do console ou um arquio. Normalmente, as mensagens de texto retransmitem informações sobre o estado e o desempenho de um sistema ou aplicatio. As mensagens também alertam o administrador do sistema sobre condições excepcionais quando elas ocorrerem. Consulte a explicação e a resposta do operador associadas às mensagens exibidas para determinar a causa da falha. Consulte Capítulo 9, Mensagens, na página 57 para obter informações sobre as mensagens. Rastreie as informações temporárias de captura de dados sobre o ambiente operacional atual quando um componente ou aplicatio falhar em operar conforme designado. A equipe de Suporte de Software da IBM usa as informações de rastreio capturadas para determinar a origem de um erro ou condição inesperada. Consulte Capítulo 2, Determinando a Causa de um Problema, na página 3 para obter mais informações sobre rastreio. Coletando Dados Se ocê tier um problema que não consegue resoler usando as informações deste guia, colete as seguintes informações relacionadas ao problema e entre em contato com o Suporte de Software IBM para assistência adicional: Arquio de aplicatio monitorado, conforme especificado na declaração SOURCE FILE, se aplicáel Saída de rastreio RAS1 adequada Descrição do cenário de operação que leou ao problema Saída incorreta, como impressões de telas ou uma descrição de o que ocê obserou, se aplicáel Copyright IBM Corp. 2006,

14 Arquios de log - Coleta logs dos sistemas com falha. É possíel coletar todos os logs ou logs de um certo tipo, como RAS (confiabilidade, disponibilidade e capacidade de manutenção), logs de rastreio ou logs de mensagens. Informações do aplicatio: Número de ersão e níel de correção Arquio de dados do aplicatio de amostra (se estier monitorando um arquio) Número de ersão e níel de correção do sistema operacional Mensagens e outras informações exibidas na tela Número de ersão dos seguintes membros do ambiente de monitoramento: IBM Tioli Monitoring. Forneça também o níel de correção, se disponíel. Número de ersão do Agente de Monitoramento Tioli Enterprise Portal. Selecione Sobre Tioli Enterprise Portal... no menu Ajuda. Nota: O número de ersão do Tioli Enterprise Portal e o Tioli Enterprise Portal Serer deem sempre estar sincronizados. Capturas de tela de saída incorreta, se houer Se o sistema parar no Windows, colete os arquios drwtsn32.log e user.dmp, se disponíeis. Os arquios drwtsn32.log e user.dmp estão localizados em \Documents and Settings\All Users\Documents\DrWatson 1. Insira o seguinte comando no prompt de comandos para atiar o Dr. Watson como depurador padrão: drwtsn32 i 2. Insira o seguinte comando no prompt de comando para abrir o diálogo de configuração do Dr. Watson: drwtsn32 3. Configure o Tipo de dump de traamento como FULL. 4. Remoa a marca da caixa Tabela de Símbolos de Dump. 5. Coloque uma marca na caixa Dump de todos os Contextos de Encadeamento. 6. Coloque uma marca na caixa Criar Arquio de Dump de Traamento. Se o sistema parar em sistemas baseados em UNIX, colete o arquio principal de dump do diretório install_home/bin, em que install_home é o caminho do diretório em que ocê instalou o agente de monitoramento. 2 IBM Tioli OMEGAMON XE no z/vm e Linux: Guia de Resolução de Problemas

15 Capítulo 2. Determinando a Causa de um Problema Este capítulo fornece uma isão geral de informações de seriços que deem ser coletadas sobre um agente de monitoramento para determinar a origem de um problema. Este capítulo inclui instruções para configuração de rastreios e coleta de logs para seu próprio uso e para encaminhar para o Suporte de Software IBM. Os seguintes tópicos são cobertos: Fluxo de Resolução de Problemas para um Agente de Monitoramento do OMEGAMON XE Determinando qual Componente Pode Ser a Causa de um Problema na página 6 Rsastreio do RAS1 na página 12 Entendendo e Usando Logs do RAS1 na página 19 Capturando Logs de z/os para Eniar para o Suporte de Software na página 21 Configurando Níeis de Rrastreio em um Tioli Enterprise Monitoring Serer no z/os Usando a Ferramenta de Configuração na página 20 Fluxo de Resolução de Problemas para um Agente de Monitoramento do OMEGAMON XE Ao encontrar um problema com qualquer componente, o principal recurso de resolução de problemas é a criação de log. Um agente de monitoramento do OMEGAMON XE não exibe mensagens no Tioli Enterprise Portal. Em ez disso, as mensagens são eniadas para locais de saída mais comuns, como um arquio de log. A criação de log está atiada em todos os agentes de monitoramento por padrão. O rastreio, por outro lado, cria um registro do processamento de um programa ou transação do computador. Os logs de rastreio capturam informações sobre o ambiente operacional, quando o software do componente falha em operar como esperado. O tipo de log principal é o log de rastreio da confiabilidade, disponibilidade e capacidade de manutenção (RASI). Quando os componentes de Tioli Management Serices são inicializados, a inicialização do seriço RAS1 é um dos primeiros processos iniciados. Os logs de RAS estão apenas em inglês. O mecanismo de log de rastreio de RAS está disponíel no Tioli Enterprise Monitoring Serer, no Tioli Enterprise Portal Serer e nos agentes de monitoramento. A maioria dos logs está localizada em um subdiretório de logs no computador host. Os arquios de log são gerenciados da seguinte forma: No Windows, o nome do arquio de log inclui um registro de data e hora em formato hexadecimal. Por padrão, os logs são armazenados no caminho de de instalação para o IBM Tioli Monitoring. A seguir, está um exemplo de um nome de arquio de log que inclui o registro de data e hora em formato hexadecimal: ibm-kpmn80301_cq_472649ef-01.log Em sistemas baseados em UNIX, o nome do arquio de log inclui um registro de data e hora. Os arquios de log de RAS1 dos sistemas baseados em UNIX são armazenados no diretório /logs. A seguir, há um exemplo de um nome de arquio de log que inclui o registro de data e hora: f50pa2b_ux_ log O Suporte de Software da IBM usa as informações capturadas por logs de rastreio para controlar um problema até sua origem ou para determinar por que um erro ocorreu. A configuração padrão para rastreio, como se o rastreio está atiado ou desatiado e o níel de rastreio, depende da origem do rastreio. É possíel escolher quantos arquios manter quando o log rolar. Se não for possíel encontrar os arquios de log de que precisa, reinicie o sistema e tente noamente. Consulte o IBM Tioli Monitoring Guia de Resolução de Problemas para obter instruções sobre como configurar a criação de logs de rastreio. Copyright IBM Corp. 2006,

16 Em geral, um agente de monitoramento do OMEGAMON XE tem o rastreio mínimo atiado. A configuração KBB_RAS1=ERROR significa que apenas mensagens de erro são capturadas. Ao informar um problema, o Suporte de Software IBM pode pedir que ocê atie um formulário mais profundo e detalhado de rastreio, como um daqueles discutidos em Sintaxe para Rastreios do RAS1 na página 12. Atenção: Há gasto adicional de CPU e E/S associado a rastreio detalhado de RAS1 que pode degradar o desempenho do agente de monitoramento. É necessário restaurar o rastreio do RAS1 ao KBB_RAS1=ERROR mínimo, depois de o diagnóstico do problema ter sido concluído. Figura 1 na página 5 mostra o fluxo de procedimentos de resolução de problemas para um agente de monitoramento do OMEGAMON XE. 4 IBM Tioli OMEGAMON XE no z/vm e Linux: Guia de Resolução de Problemas

17 Figura 1. fluxo de resolução de problemas para um agente de monitoramento do OMEGAMON XE Capítulo 2. Determinando a Causa de um Problema 5

18 Determinando qual Componente Pode Ser a Causa de um Problema Uma das questões mais difíceis da resolução de problemas em um ambiente cliente/seridor, como o Tioli Management Serices, é determinar qual componente é a origem do problema. Na maioria dos casos, o problema pode parecer ser um problema do cliente do Tioli Enterprise Portal, pois é isso que ocê consegue er. Mas isso pode ser enganoso, pois o cliente do Tioli Enterprise Portal é um cliente apenas para exibição: ele pode exibir dados apenas se receber dados do Tioli Enterprise Monitoring Serer. Em qualquer cenário de problema, toda documentação deerá ser coletada no momento do erro. O que parece ser um problema do cliente pode, muito bem, ser um problema do seridor, especialmente no cenário em que os dados não estão aparecendo no cliente. As mensagens emitidas pelos produtos IBM Tioli Monitoring são registradas na documentação do produto para os agentes indiiduais. As mensagens estão listadas em ordem alfanumérica por número de mensagem. O número da mensagem começa com um prefixo que identifica o produto ou componente. Para as mensagens associadas a esse agente de monitoramento, consulte Mensagens na página 57. Ao encontrar um problema, primeiro marque as mensagens nos arquios de log para determinar se é um problema no seu ambiente ou com um produto do IBM Tioli Monitoring. Se parecer que o problema é um defeito do produto, ocê pode encontrar um problema que corresponda aos seus sintomas e uma solução no banco de dados IBM Support Knowledge. Consulte o Suporte para Resolução de Problemas na página 67 para obter detalhes sobre como utilizar esta ferramenta de suporte. O Suporte de Software IBM solicita a atiação do rastreio para que os arquios de log coletem informações adicionais necessárias para resoler o problema. Algumas das opções de rastreio produzem grandes quantidades de informações de rastreio. Monitore o espaço em disco ou em spool ao atiar o rastreio para eitar que o disco ou o spool atinja a capacidade. Retorne as configurações de rastreio para as configurações padrão após a coleta das informações de rastreio desejadas. À medida que ocê coleta logs, crie uma descrição exata do problema. Para problemas que podem ser reproduzidos, documente o caminho de naegação exato que produziu o erro. A impressão da tela também pode ajudar na resolução de problemas. No seu relatório de problemas, tente usar a terminologia correta ao descreer o problema (por exemplo, áreas de trabalho, isualizações, naegadores, eentos e links). O uso consistente da terminologia ajudará o Suporte de Software IBM a entender o problema rapidamente. As seções a seguir discutem os tipos de problemas que ocê pode encontrar e como capturar as informações necessárias para diagnosticar esses problemas. Problemas que Podem Ser Reproduzidos como Problemas do Cliente do Tioli Enterprise Portal Os arquios de log são criados automaticamente quando ocê inicia o Tioli Enterprise Portal. Você pode isualizar os arquios de log com qualquer editor de texto. Se o problema puder ser reproduzido e for informado como um problema do cliente do Tioli Enterprise Portal, enie o log do cliente. O local do log depende do tipo de cliente e do sistema operacional em que o cliente está sendo executado. Pode ser solicitado que ocê defina um rastreio no cliente e colete, em seguida, o log. Esse é um cenário muito proáel no caso em que um problema possa ser reproduzido. Além dos logs do cliente, colete os logs do Tioli Enterprise Monitoring Serer e do Tioli Enterprise Portal Serer. Embora esse problema possa ser informado como um problema do cliente do Tioli Enterprise Portal, o cliente pode estar com dificuldades por causa de uma falha do seridor. 6 IBM Tioli OMEGAMON XE no z/vm e Linux: Guia de Resolução de Problemas

19 Além disso, os prompts de logon e as mensagens de progresso são exibidos na barra de status da janela de Logon. Esta área também é utilizada para exibir mensagens de erro. Quando inestigar problemas com o Tioli Enterprise Portal, utilize o Visualizador de Eentos do Windows para erificar se o Tioli Enterprise Portal Serer foi iniciado corretamente e para procurar erros. Para obter informações adicionais sobre resolução de problemas no Tioli Enterprise Portal, consulte o IBM Tioli Monitoring Guia de Resolução de Problemas. Se o cliente de desktop do Tioli Enterprise Portal estier sendo usado, colete os logs listados em Tabela 1: Tabela 1. Locais de log para o Tioli Enterprise Portal Componente Sistemas baseados em Windows Sistemas baseados em UNIX cliente de desktop Tioli Enterprise Portal install_dir\cnp\logs\kcjras1.log em que todo o rastreio do RAS1 para o cliente do Tioli Enterprise Portal é encontrado install_dir\cnp\logs\kcjerror.log contém todos os erros que podem ter sido gerados pelas bibliotecas Sun Jaa usadas no cliente de desktop do Tioli Enterprise Portal install_dir/logs/hostname_pc_timestamp.log em que: install_dir hostname Especifica o diretório em que o Tioli Enterprise Portal Serer foi instalado. Especifica o nome do sistema que hospeda o produto PC Especifica o código do produto, cj para o cliente de desktop do Tioli Enterprise Portal. Consulte Capítulo 10, Prefixos do Componente, na página 61 para obter uma lista completa de códigos de produtos. timestamp Uma representação decimal do momento em que o processo foi iniciado. Log do Cliente do Naegador do Tioli Enterprise Portal Se o cliente do naegador do Tioli Enterprise Portal estier sendo usando, colete este log: C:\Documents and Settings\Administrator\Application Data\Jaa\Deployment\log\plugin142.trace O arquio de rastreio plugin142 contém o rastreio do RAS1 para o cliente do naegador do Tioli Enterprise Portal e quaisquer exceções do Jaa. Os logs do cliente do Tioli Enterprise Portal contêm informações ambientais, como a ersão e o níel da construção do cliente do Tioli Enterprise Portal. O log também contém o host e a porta do Tioli Enterprise Monitoring Serer à qual o cliente está se conectando. Problemas que não Podem Ser Reproduzidos Relatados como Problemas do Cliente do Tioli Enterprise Portal Se o problema não puder ser reproduzido e for reportado como problema do cliente do Tioli Enterprise Portal, colete os logs do cliente e do seridor. Os logs podem ser a única indicação do problema real. Sempre tente obter os logs no momento do erro. O cliente do Tioli Enterprise Portal tem criação de log dinâmico. Reiniciar os processos antes de coletar os logs reescreerá o log e quaisquer mensagens de erro anteriores poderão ser perdidas. Problemas que Podem Ser Reproduzidos Relatados como Problemas de Tioli Enterprise Portal Serer Se o problema for relatado como um problema de Tioli Enterprise Portal Serer, colete os logs do seridor. Se for um problema que pode ser reproduzido, pode ser solicitado que ocê defina rastreios de unidade para o Tioli Enterprise Portal Serer e, em seguida, que colete os logs. O local para os logs do seridor de portal é encontrado em Tabela 2 na página 8. Os arquios de log contêm informações de rastreio do RAS1. Além disso, colete o log do cliente no momento do erro, se ele estier disponíel. Capítulo 2. Determinando a Causa de um Problema 7

20 Os arquios de log são criados automaticamente quando ocê inicia o Tioli Enterprise Portal Serer. Você pode isualizar os arquios de log com qualquer editor de texto. Você pode alterar configurações de rastreio utilizando a janela Gerenciar Tioli Enterprise Monitoring Serices Ação > Aançado > Editar Parâmetros de Rastreio... Você também pode utilizar o Console de Seriço, acessíel no Tioli Enterprise Portal utilizando um naegador Internet Explorer para ler logs e atiar rastreios para diagnóstico e configuração do produto remoto. Para obter informações adicionais sobre resolução de problemas no Tioli Enterprise Portal Serer, consulte o IBM Tioli Monitoring Guia de Resolução de Problemas. Colete os logs listados em Tabela 2: Tabela 2. Locais de log do Tioli Enterprise Portal Serer Componente Sistemas baseados em Windows Sistemas baseados em UNIX Tioli Enterprise Portal Serer install_dir\logs install_dir/logs/hostname_pc_timestamp.log em que: install_dir hostname PC Especifica o diretório em que o Tioli Enterprise Portal Serer foi instalado. Especifica o nome do sistema que hospeda o produto Especifica o código do produto, cq, para o Tioli Enterprise Portal Serer. Consulte Capítulo 10, Prefixos do Componente, na página 61 para obter uma lista completa de códigos de produtos. timestamp Uma representação decimal do momento em que o processo foi iniciado. Tioli Enterprise Monitoring Serer em Computadores Windows ou em Computadores UNIX Os arquios de monitoramento do log do seridor são criados automaticamente ao iniciar o Tioli Enterprise Monitoring Serer em computadores Windows ou em computadores UNIX. Você pode isualizar os arquios de log com qualquer editor de texto. Ao inestigar problemas com o seridor de monitoramento, use o Windows Eent Viewer para erificar se o seridor de monitoramento foi iniciado corretamente e para procurar erros. Tabela 3 na página 9 mostra o local dos logs do seridor de monitoramento em plataformas distribuídas. 8 IBM Tioli OMEGAMON XE no z/vm e Linux: Guia de Resolução de Problemas

21 Tabela 3. Locais dos logs do Tioli Enterprise Monitoring Serer em plataformas distribuídas Componente Sistemas baseados em Windows Sistemas baseados em UNIX Tioli Enterprise Monitoring Serer install_dir\logs\hostname_pc_hextimestamp-nn.log em que: install_dir/logs/hostname_pc_timestamp.log em que: install_dir Especifica o diretório em que o Tioli Enterprise Monitoring Serer foi instalado. install_dir Especifica o diretório em que o Tioli Enterprise Portal Serer foi instalado. hostname PC Especifica o nome do sistema que hospeda o produto Especifica o código do produto, ms, para o Tioli Enterprise Monitoring Serer. Consulte Capítulo 10, Prefixos do Componente, na página 61 para obter uma lista completa de códigos de produtos HEXtimestamp Uma representação hexadecimal do momento em que o processo foi iniciado. hostname PC timestamp Especifica o nome do sistema que hospeda o produto Especifica o código do produto, ms, para o Tioli Enterprise Monitoring Serer. Consulte Capítulo 10, Prefixos do Componente, na página 61 para obter uma lista completa de códigos de produtos Uma representação decimal do momento em que o processo foi iniciado. nn Representa a sequência circular em que os logs são girados. Varia de 1 a 5, por padrão, embora o primeiro é sempre retido, pois inclui parâmetros de configuração. Problemas do Tioli Enterprise Monitoring Serer no z/os Tabela 4 explica o local dos arquios de log e de rastreio do Tioli Enterprise Monitoring Serer no z/os. Tabela 4. Locais das informações de log e de rastreio do Tioli Enterprise Monitoring Serer no z/os Componente Sistemas baseados no z/os Tioli Enterprise Monitoring Serer no z/os Como o Tioli Enterprise Monitoring Serer no z/os é executado no ITMS:Engine, toda a criação de log no ITMS:Engine é tratada da mesma maneira. Ou seja, dados de log e de rastreio são graados em RKLVLOGs e RKPDLOGs. Tioli Data Warehouse e o Warehouse Proxy Para isualizar o Log de Eentos do Aplicatio para Tioli Data Warehouse, inicie o Visualizador de Eentos clicando em Iniciar > Programas > Ferramentas Administratias> Visualizador de Eentos. Selecione Aplicatio no menu suspenso Log. No warehouse proxy, ocê pode configurar o rastreio de erros para capturar mensagens de erros adicionais que podem ser úteis na detecção de problemas. Consulte o IBM Tioli Monitoring Guia de Resolução de Problemas para obter informações adicionais. Agente de Resumo e Limpeza O Agente de Resumo e Limpeza usa rastreio RAS1 baseado em C, rastreio RAS1 baseado em Jaa e rastreio interno baseado em Jaa. Por padrão, os dados de rastreio do Agente de Resumo e Limpeza são graados em arquios no subdiretório de logs. Tabela 5 na página 10 explica os locais dos arquios de log e de rastreio para o Agente de Resumo e Limpeza. Capítulo 2. Determinando a Causa de um Problema 9

22 Tabela 5. Locais de log para o Agente de Resumo e Limpeza em plataformas distribuídas Componente Sistemas baseados em Windows Sistemas baseados em UNIX Agente de Resumo e Limpeza do Tioli install_dir\logs\hostname_pc_hextimestamp-nn.log install_dir\logs\hostname_pc_ras1jaa_hextimestamp-nn.log install_dir\logs\hostname_pc_jaa_hextimestamp-nn.log install_dir/logs/hostname_pc_hextimestamp-nn.log install_dir/logs/hostname_pc_ras1jaa_hextimestamp-nn.log install_dir/logs/hostname_pc_jaa_hextimestamp-nn.log em que: em que: install_dir Especifica se o diretório em que o Agente de Monitoramento do Tioli Enterprise foi instalado. install_dir Especifica o diretório em que o Agente de Monitoramento do Tioli Enterprise foi instalado. hostname PC Especifica o nome do sistema que hospeda o produto. Especifica o código do produto, sy, para o Agente de Resumo e Limpeza. Consulte Capítulo 10, Prefixos do Componente, na página 61 para obter uma lista completa de códigos de produtos HEXtimestamp Uma representação hexadecimal do momento em que o processo foi iniciado. nn Representa a sequência circular em que os logs são girados. Varia de 1 a 5, por padrão, embora o primeiro é sempre retido, pois inclui parâmetros de configuração. hostname PC Especifica o nome do sistema que hospeda o produto. Especifica o código do produto, sy, para o Agente de Resumo e Limpeza. Consulte Capítulo 10, Prefixos do Componente, na página 61 para obter uma lista completa de códigos de produtos HEXtimestamp Uma representação hexadecimal do momento em que o processo foi iniciado. timestamp nn Uma representação decimal do momento em que o processo foi iniciado. Representa a sequência circular em que os logs são girados. Varia de 1 a 5, por padrão, embora o primeiro é sempre retido, pois inclui parâmetros de configuração. Consulte o IBM Tioli Monitoring Guia de Resolução de Problemas para obter informações adicionais. Problemas que Afetam o Agente de Monitoramento do OMEGAMON XE on z/vm and Linux Depois de ocê ter eitado os problemas com os componentes do Tioli Management Serices e a funcionalidade para a qual ocê instalou esse agente de monitoramento ainda não estier disponíel, trate o problema como um problema do agente de monitoramento. Como obserado anteriormente, o fato de que problemas aparecem no Tioli Enterprise Portal não significa que o componente seja a origem da falha. Um problema de coleta de dados com um agente de monitoramento se manifestará como dados incorretos no Tioli Enterprise Portal ou como nenhum dado sendo exibido no Tioli Enterprise Portal. Para esse agente de monitoramento, o Performance Toolkit pode ter parado de coletar dados. Consulte o O Performance Toolkit não Está Coletando Dados na página 41 para obter informações sobre como se recuperar dessa situação. Também é possíel que o Discontiguous Saed Segment (DCSS) PERFOUT não seja grande suficiente para conter todos os dados disponíeis ou atiados para seu ambiente. Esse erro faz com que a coleta de dados pare. Consulte Executando sem Memória no DCSS na página 38 para obter detalhes. Nota: O nome padrão PERFOUT é utilizado neste documento para referir-se ao DCSS de saída formatado pelo comando FC MONCOLL SEGOUT. Se optar por criar seu próprio, com um nome diferente, substitua o nome por PERFOUT. Reise as seções a seguir para obter informações sobre resolução de problemas que podem ser necessárias para esse agente de monitoramento: Capítulo 3, Resolução de Problemas de Instalação e Configuração, na página 29 Capítulo 4, Resolução de Problemas de Coleta de Dados, na página 41 Capítulo 5, Resolução de Problemas de Desempenho, na página 47 Capítulo 6, Resolução de Problemas de Link de Área de Trabalho Dinâmica, na página IBM Tioli OMEGAMON XE no z/vm e Linux: Guia de Resolução de Problemas

23 Capítulo 7, Resolução de Problemas de Uso, na página 51 Capítulo 8, Resolução de Problemas de Globalização, na página 55 Tabela 6 explica os locais dos arquios de log e de rastreio do agente de monitoramento doomegamon XE on z/vm and Linux. Tabela 6. Locais de log para o agente de monitoramento do OMEGAMON XE on z/vm and Linux Componente Nome e caminho do arquio Description Tioli Enterprise Monitoring Agent install_dir/ logs/hostname_pc_timestamp.log em que: install_dir Especifica o diretório em que o agente de monitoramento foi instalado. Rastreia a atiidade no agente de monitoramento. Nota: Outros logs, como log para processos coletores e comandos Take Action (se disponíel), têm uma sintaxe semelhante. hostname PC Especifica o nome do sistema que hospeda o produto Especifica o código do produto, l, para o agente de monitoramento do OMEGAMON XE on z/vm and Linux. Consulte o Capítulo 10, Prefixos do Componente, na página 61 para obter uma lista completa de códigos de produtos. Executáel REXX do Processador do Comando Take Action (KVLCMD EXEC). timestamp KVL nn em que: Uma representação hexadecimal do momento em que o processo foi iniciado. nn - representa o nome incremental do arquio de log, que inicia com 1. O número de arquios de log gerados depende do parâmetro LOG_COUNT especificado no arquio KVL CONFIG. O log inicia o registro tantas ezes quantas as especificadas nessa configuração. Um máximo de cinco arquios de log atios pode ser retido. O padrão é 3. O arquio de log está localizado no disco A da máquina irtual do Command Processor. Um arquio de log é criado na primeira ez que o executáel do Command Processor REXX é executado. O arquio de log é atualizado conforme o sistema guest CMS processa comandos Take Action a partir do agente de monitoramento. O arquio de log é um log em andamento, contendo informações sobre todos os comandos recebidos pelo guest CMS. Arquios do Recurso Take Action Use o recurso Take Action no Tioli Enterprise Portal para emitir comandos CP, comandos CMS e executáeis REXX no sistema operacional z/vm. O guest CMS definido para Take Action opera como uma máquina irtual dedicada, não assistida, desconectada que espera para processar mensagens contendo comandos Take Action eniados do agente de monitoramento. Nota: O recurso Take Action é opcional. É necessário configurar o ambiente para o Take Action se pretender emitir comandos CP, comandos CMS executáeis REXX na interface do Tioli Enterprise Portal. Adicionalmente, ao criar uma situação ou editar uma situação predefinida, também é possíel emitir comandos utilizando a guia Ação do Situation Editor. O comando é eniado ao sistema quando a situação torna-se erdadeira. Os requisitos que se aplicam aos comandos Take Action se aplicam igualmente na utilização da guia Ação para emitir comandos que são executados no sistema operacional z/vm. Para obter informações detalhadas sobre os requisitos necessários, consulte o IBM Tioli OMEGAMON XE on z/vm and Linux Guia de Resolução de Problemas. Os arquios a seguir estão associados ao Processador do Comando Take Action (KVLCMD EXEC) desse agente de monitoramento: KVL CONFIG KVL DATA Arquio KVL CONFIG: Modifique o arquio KVL CONFIG para especificar a criação de log da saída dos comandos Take Action processados para o arquio de log KVL nn. No KVL CONFIG, ocê pode especificar as seguintes configurações: Capítulo 2. Determinando a Causa de um Problema 11

24 LOG_SIZE=<number of lines>. O interalo de tamanho do log é de 100 a linhas. O número de linhas padrão é de linhas. LOG_COUNT=<number>. O log inicia o registro tantas ezes quantas as especificadas nessa configuração. Por exemplo, KVL 1, KVL 2 e assim por diante. Um máximo de cinco arquios de log atios pode ser retido. Dois arquios de log são retidos como o padrão. LOG_RESP=Y ou N. Especifique se os resultados dos comandos processados serão ou não graados no arquio de log. O padrão é N - a saída não será graada no arquio de log. Importante: Atiar a criação de log pode resultar em arquios de log significatiamente grandes, dependendo do ambiente. Modifique as configurações para atender às necessidades de seu ambiente. O arquio KVL CONFIG também contém uma lista de usuários permitidos (AGENT_ID = o ID de usuário do z/vm do guest do Linux onde esse agente de monitoramento está sendo executado). Modifique esse arquio para incluir os IDs de usuário do z/vm dos guests do Linux em que o agente está sendo executado. Arquio de Log do KVL DATA: KVL DATA contém informações sobre os logs que foram gerados durante a execução deste agente de monitoramento. Este log contém as seguintes informações: LAST_COUNT=<number> - A última contagem do número de linhas geradas. LAST_LOG=<number> - O tipo de arquio do último log gerado. Rsastreio do RAS1 O rastreio do RAS1 fornece filtragem de tempo de execução das mensagens do produto e é a principal ferramenta de diagnóstico. Essa ferramenta faz parte do seriço de biblioteca kbb e é configurada usando a interface do IBM Tioli Monitoring Serice Console ou algum método mais direto de modificar manualmente o parâmetro KBB_RAS1. As mensagens do RAS1 são eniadas para stdout. Nem todos os produtos ou funções do OMEGAMON oferecem suporte ao rastreio do RAS1 e nem todos os produtos ou funções do OMEGAMON usam os filtros e classes da mesma maneira. Por exemplo, dois agentes de monitoramento podem usar os filtros e classes especificados no rastreio do RAS1 de maneira diferente e com frequências diferentes. O agente de monitoramento do OMEGAMON XE on z/vm and Linux oferece suporte ao rastreio do RAS1 por meio do uso da interface do IBM Tioli Monitoring Serice Console. Consulte Iniciando o IBM Tioli Monitoring Serice Console na página 15. Noamente, saiba que os arquios do log de rastreio do RAS1 podem ficar muito grandes com a quantidade errada de filtragem. Não há nenhuma função ou recurso de gerenciamento de log, portanto, cuidado com os níeis de rastreio especificados. Pode ser necessário executar um rastreio de erros para todos os componentes e, em seguida, quaisquer níeis adicionais, dependendo das necessidades de diagnóstico. Sintaxe para Rastreios do RAS1 A sintaxe é usada para especificar um rastreio de RAS1 no arquio KppENV. Depois de incluir esse comando ao arquio KppENV, é necessário parar e reiniciar o espaço de endereço para que ele tome efeito. Depois disso, ele permanecerá em efeito durante a ida toda do espaço de endereço. Para terminar esse rastreio de RAS1, é necessário editar o arquio KppENV noamente e redefinir o níel de rastreio e parar e iniciar o espaço de endereço. A sintaxe básica dos comandos de rastreio do RAS1 para rastreio de erro é a seguinte: KBB_RAS1= global_class (COMP: component_type) (ENTRY: entry_point) (UNIT: unit_name, class) Em que: 12 IBM Tioli OMEGAMON XE no z/vm e Linux: Guia de Resolução de Problemas

25 global_class Indica o níel de rastreio que ocê deseja er. Essa é uma configuração global que se aplica a todos os filtros de RAS1 do processo. Se ocê configurar essa classe global por si só, ela será global no escopo e o rastreio não poderá filtrar em nenhuma das outras palaras-chae. Separe as classes combinadas com um espaço. Os seguintes alores são possíeis: As abreiações álidas estão entre parênteses. ERROR (ER): retorna mensagens de erros graes apenas (esse é o padrão para a maioria dos aplicatios). STATE (ST): registra a condição ou a configuração atual de sinalizadores e ariáeis dentro do processo. Se o rastreio de estado estier atiado, ocê poderá er o estado atual de ariáeis ou sinalizadores específicos, à medida que o processo estier sendo executado. FLOW (FL): faz com que uma mensagem seja gerada em um ponto de entrada ou de saída de uma função. DETAIL (DE): produz um níel detalhado de rastreio. INPUT (IN): registra dados que são criados na execução de uma API, função ou processo específico. ALL: faz com que todas as mensagens disponíeis sejam registradas, uma combinação de todas as outras formas de rastreio. COMP A palara-chae que indica esse rastreio incluirá um tipo de componente. A palara-chae COMP é usada para rastrear grupos de rotinas relacionados por função (ou componente). Não use esse parâmetro, a menos que solicitado a fazê-lo pelo Suporte de Software IBM. component_type O identificador de um tipo de componente. Se um representante do Suporte de Software IBM instruí-lo a executar um rastreio de componente, ocê receberá um código para esse componente. Não use esse parâmetro, a menos que solicitado a fazê-lo pelo Suporte de Software IBM. ENTRY A palara-chae usada para limitar uma rotina de filtragem a um PONTO DE ENTRADA específico. Como ários pontos de entrada para uma única rotina não são comuns, essa palara-chae não é comumente usada e deerá ser usada apenas mediante solicitação explícita de um representante do Suporte de Software IBM. entry_point Uma ariáel que representa o nome do ponto de entrada. Se for solicitado que ocê especifique um alor para a palara-chae ENTRADA, um representante do Suporte de Software IBM informará qual o alor a ser especificado para entry_point. UNIT A palara-chae que indica que esse rastreio incluirá a coleta de informações com o uso da unidade de compilação, completa ou parcialmente qualificada. Uma correspondência é executada entre a unidade de compilação eniada e a unidade de compilação especificada na instrução do RAS1. Uma correspondência resulta em uma entrada de rastreio. unit_name Uma ariáel que representa o nome da unidade de compilação. Esse nome pode ser qualquer coisa que esteja relacionada ao nome do arquio do objeto ou nome de compilação da unidade. Na maioria das instâncias, esse nome define o componente que está sendo rastreado. Esse alor pode ser um dos componentes no Tabela 9 na página 61, mas na prática será, mais proaelmente, o identificador de componente de três caracteres para o agente de monitoramento. class Um dos mesmos alores especificados para Classe Global, mas, por causa de sua posição dentro dos parênteses, a classe é limitada em escopo para se aplicar apenas ao unit_name especificado. Os seguintes alores são possíeis: As abreiações álidas estão entre parênteses. ERROR (ER): retorna mensagens de erros graes apenas (esse é o padrão para a maioria das aplicações). Capítulo 2. Determinando a Causa de um Problema 13