Detecção de Problemas no Tivoli Kernel Services

Detecção de Problemas no Tivoli KernelServicesVersão 1.2

Detecção de Problemas no Tivoli KernelServicesVersão 1.2

Detecção de Problemas no Tivoli Kernel Services

Aviso Sobre Copyright

© Copyright IBM Corporation 2000, 2001 Todos os direitos reservados. Pode ser utilizado somente com um Contrato de Licença deSoftware da Tivoli Systems, de um Contrato de Licença de Software da IBM ou de um Adendo para Produtos Tivoli para Clientes daIBM ou em Contratos de Licença da IBM. Nenhuma parte desta publicação pode ser reproduzida, transmitida, transcrita, armazenadaem um sistema de recuperação ou traduzida em qualquer linguagem de computador, de qualquer forma ou por qualquer meio,eletrônico, mecânico, magnético, ótico, químico, manual, ou de outra maneira, sem permissão prévia, por escrito, da IBMCorporation. A IBM Corporation concede ao Cliente permissão limitada para fazer cópia impressa ou outras reproduções de qualquerdocumentação legível pela máquina para uso próprio, desde que cada reprodução contenha o aviso de copyright da IBM Corporation.Nenhum outro direito sob copyright é concedido sem permissão prévia, por escrito, da IBM Corporation. O documento não éplanejado para produção e é fornecido “como está” sem garantia de nenhum tipo.A empresa responsável se exime de todas asgarantias deste documento, incluindo as garantias de comercialização e adequação a um fim específico.

Marcas

IBM, o logotipo da IBM, Tivoli, o logotipo da Tivoli, AIX, NetView, RS/6000 e TME são marcas ou marcas registradas daInternational Business Machines Corporation ou da Tivoli Systems Inc. nos Estados Unidos e/ou em outros países.

Microsoft, Windows, Windows NT e o logotipo do Windows são marcas da Microsoft Corporation nos Estados Unidos e/ou emoutros países.

UNIX é marca registrada de The Open Group nos Estados Unidos e em outros países.

Java e todas as marcas com base em Java são marcas da Sun Microsystems, Inc. nos Estados Unidos e/ou em outros países.

Outros nomes de companhia, produto e serviço podem ser marcas ou marcas de serviço de terceiros.

Avisos

Referências nesta publicação a produtos, programas ou serviços Tivoli Systems ou IBM não significam que elas pretendam torná-losdisponíveis em todos os países onde a Tivoli Systems ou a IBM opera. Qualquer referência a estes produtos, programas ou serviçosnão significa que apenas os produtos, programas ou serviços da Tivoli Systems ou da IBM possam ser utilizados. Qualquer produto,programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da Tivoli Systems ou daIBM ou outros direitos legalmente protegidos, poderá ser utilizado em substituição a este programa, produto ou serviço. A avaliaçãoe verificação da operação em conjunto com outros produtos, exceto aqueles expressamente designados pela Tivoli Systems ou IBM,são de inteira responsabilidade do Cliente. A Tivoli Systems ou a IBM podem ter patentes ou solicitações de patentes relativas aassuntos tratados nesta publicação. O fornecimento deste documento não dá ao Cliente nenhuma licença relativa a estas patentes.Consultas sobre licenças devem ser enviadas, por escrito, para Gerência de Relações Comerciais e Industriais da IBM Brasil, Av.Pasteur, 138-146 - Botafogo - Rio de Janeiro, RJ - CEP 22.290-240. Consulte também “Avisos Adicionais” na página xv.

Índice

Prefácio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixQuem Deve Ler Este Documento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Pré-requisitos e Documentos Relacionados. . . . . . . . . . . . . . . . . . . . . . . . . . ix

Informações da Edição Corporativa do IBM Universal DB2. . . . . . . . . . x

O Que Este Documento Contém. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Convenções Utilizadas Neste Guia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Acessando Publicações Online. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Pedindo Publicações. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii

Fornecendo Feedback sobre Publicações. . . . . . . . . . . . . . . . . . . . . . . . . . .xiii

Como Entrar em Contato com o Suporte ao Cliente. . . . . . . . . . . . . . . . . .xiii

Avisos Adicionais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvOpenSSL License. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Original SSLeay License. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Apache e Apache Tomcat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xviii

Capítulo 1. Apresentando a Detecção de Problemas noTivoli Kernel Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Modelo de Componente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Visão Geral de Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Configuração Padrão do Registrador de Mensagens. . . . . . . . . . . . . . . . . . . . 5

Configuração Padrão do Log de Rastreios. . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Capítulo 2. Log e Rastreio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Visão Geral de Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Log Local. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

iiiDetecção de Problemas no Tivoli Kernel Services

Configuração Dinâmica. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Estrutura da Configuração do Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Configuração da Rotina de Tratamento. . . . . . . . . . . . . . . . . . . . . . . . . 23

Configuração de Formatadores e Filtros. . . . . . . . . . . . . . . . . . . . . . . . 29

Alterando a Localização do Arquivo de Log. . . . . . . . . . . . . . . . . . . . 31

Ligação Atrasada de Mensagens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Serviço de Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Quando Utilizar o Serviço de Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Como Utilizar um Único Serviço de Log. . . . . . . . . . . . . . . . . . . . . . . 35

Quando Utilizar Múltiplos Serviços de Log. . . . . . . . . . . . . . . . . . . . . 35

Como Implementar Outro Serviço de Log. . . . . . . . . . . . . . . . . . . . . . 36

Como Configurar um logServerHandler para Utilizar um Serviço deLog Específico. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Como Encadear os Serviços de Log. . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Criando um Banco de Dados de Log Adicional Após a Instalação. . . . . . . . 40

Utilizando Secaudit ou Outro Banco de Dados de Log. . . . . . . . . . . . . . . . . 41

Detecção de Problemas de Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Rastreio de Bootstrap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Rastreios Adicionais de Serviço de Log. . . . . . . . . . . . . . . . . . . . . . . . 45

Mensagens de Erro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Convertendo Arquivos de Log Serializados em Arquivos ASCII. . . . . . . . . . 46

Configurando o Ambiente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Convertendo os Arquivos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Capítulo 3. Detecção de Problemas na Instalação . . . . . 49Logs de Instalação. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Detecção de Problemas na Instalação do DB2. . . . . . . . . . . . . . . . . . . . . . . 51

Detecção de Problemas na Instalação do Servidor Tivoli DAS - DB2. . . . . . 53

Detecção de Problemas na Instalação do Servidor MQSeries. . . . . . . . . . . . 54

iv Versão 1.2

Detecção de Problemas na Instalação do Oracle. . . . . . . . . . . . . . . . . . . . . . 58

Detecção de Problemas no Depósito de Instalação. . . . . . . . . . . . . . . . . . . . 59

Detecção de Problemas na Instalação de Bootprint. . . . . . . . . . . . . . . . . . . . 60

Capítulo 4. Detecção de Problemas Gerais daOperação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Recuperando o Banco de Dados do Tivoli Kernel Services. . . . . . . . . . . . . . 63

Recuperando Bancos de Dados DB2 do Tivoli Kernel Services. . . . . . . . . . 65

Bancos de Dados DB2 do Tivoli Kernel Services. . . . . . . . . . . . . . . . . . . . . 65

Caracteres Unicode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Bancos de Dados DB2 do Tivoli Kernel Services: Erros Específicos 68

Detecção de Problemas no Oracle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Restaurando o Depósito de Instalação e o Servidor de Bootprint. . . . . . . . . 76

Servidor Tivoli DAS - DB2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Recuperando Consoles Após a Perda de Conexão do Servidor TivoliDAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Restaurando o Servidor Tivoli DAS. . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Servidor MQSeries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

ORBs de ID e Bootprint. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Tivoli Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Detecção de Outros Problemas Operacionais. . . . . . . . . . . . . . . . . . . . . . . 108

SJI (Simple Jar Installer). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Capítulo 5. Detecção de Problemas emComponentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Detecção de Problemas Comuns dos Componentes. . . . . . . . . . . . . . . . . . . 111

Ativando o Rastreio de Componentes. . . . . . . . . . . . . . . . . . . . . . . . . 111

Desativando o Rastreio de Componentes do Log. . . . . . . . . . . . . . . . 113

Registradores de Componentes do Tivoli Kernel Services. . . . . . . . . . . . . . 114

vDetecção de Problemas no Tivoli Kernel Services

Activation Framework. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Administrative Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Testando o Estado do Componente. . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Registradores de Mensagens e Rastreios. . . . . . . . . . . . . . . . . . . . . . . 120

Detecção de Problemas Adicionais. . . . . . . . . . . . . . . . . . . . . . . . . . . 120

Problemas Comuns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Command Line Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123


Component Distribution Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Component Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125


Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126




DCM (Data Connection Manager). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

DCI (Depot Component Installer). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133



Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134



Tamanho do Conjunto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Domain Builder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138



Gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139



vi Versão 1.2

InfoService. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141


Java Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

LCI (Local Component Installer). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142


LOCK (Local ORB Creator and Killer). . . . . . . . . . . . . . . . . . . . . . . . . . . 143

ORB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143



Network Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144



Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154




Security Registry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156



Serialized Persistence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Service Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158



SNMP Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159


TimeSync. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160


Capítulo 6. Padrão de Mensagens Tivoli . . . . . . . . . . . . . . . 161

viiDetecção de Problemas no Tivoli Kernel Services

Formato do ID da Mensagem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Descrições de Mensagens e Ajuda. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Índice Remissivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

viii Versão 1.2

Prefácio

Este documento fornece informações sobre detecção de problemaspara os bancos de dados, serviços e componentes do Tivoli KernelServices.

Quem Deve Ler Este DocumentoEste documento destina-se aos administradores de sistema que sãoresponsáveis pela manutenção do Tivoli Kernel Services. Paraexecutar a maioria das operações aqui descritas, você deve ter afunçãosuper administrator.

Pré-requisitos e Documentos RelacionadosO Tivoli Kernel Services fornece a seguinte documentaçãorelacionada:

¶ Planning for Tivoli Kernel Services

Explica como planejar a implementação do Tivoli KernelServices em seu ambiente operacional.

¶ Instalando o Tivoli Kernel Services

Fornece informações sobre instalação, implementação econfiguração do Tivoli Kernel Services.

¶ Introduzindo a Administração do Tivoli Kernel Services

Fornece informações sobre como administrar o Tivoli KernelServices através do Tivoli Console.

¶ Tivoli Kernel Services Command Reference

Fornece informações sobre a interface de linha de comandospara o Tivoli Kernel Services.

¶ Tivoli Kernel Services Command Quick Reference Card

Uma referência rápida que mostra um resumo da interface delinha de comandos do Tivoli Kernel Services.

¶ README do Tivoli Kernel Services

ixDetecção de Problemas no Tivoli Kernel Services

Fornece as últimas informações, tais como problemas e soluçõese disponibilidade de correções.

¶ Guided Tour of the Tivoli Console

Introdução baseada em HTML para o Tivoli Console, a interfacegráfica do usuário utilizada para administrar o Tivoli KernelServices.

A documentação do Tivoli Kernel Services, com exceção do auxílioonline integrado e do produto README, está localizada nossubdiretórios tivolidocs tanto no CD-ROM de instalação do TivoliKernel Services como no CD-ROM de Bootprint, nos formatosHTML e PDF. O README do produto está localizado no diretórioraiz do CD-ROM de Instalação.

Informações da Edição Corporativa do IBM UniversalDB2

As publicações necessárias para dar suporte ao IBM DB2 estãodisponíveis em formato HTML no CD-ROM da Edição Corporativado IBM DB2 Universal Database para plataformas específicasincluídas no pacote do Tivoli Kernel Services ou a partir do site daIBM na Web:http://www.ibm.com/software/data/db2/udb/.

O Que Este Documento ContémDetecção de Problemas no Tivoli Kernel Servicescontém asseguintes seções:

¶ “Apresentando a Detecção de Problemas no Tivoli KernelServices” na página 1

Fornece uma visão geral das funções de detecção de problemasinternas que existem no Tivoli Kernel Services, tais como oServiço de Failover e o log.

¶ “Log e Rastreio” na página 11

Fornece uma visão geral do subsistema log do Tivoli KernelServices, bem como detalhes sobre como configurar e utilizar osregistradores de mensagens e rastreios.

¶ “Detecção de Problemas na Instalação” na página 49

x Versão 1.2

Fornece informações úteis na detecção de problemas do processode instalação, incluindo bancos de dados, serviços associados e opróprio Tivoli Kernel Services.

¶ “Detecção de Problemas Gerais da Operação” na página 63

Explica como detectar problemas que ocorrem durante aoperação do Tivoli Kernel Services, incluindo erros de banco dedados.

¶ “Detecção de Problemas em Componentes” na página 111

Fornece informações sobre técnicas de detecção de problemasque podem ser utilizadas em todos os componentes do TivoliKernel Services, bem como etapas de detecção de problemas quesão específicas do componente.

¶ “Padrão de Mensagens Tivoli” na página 161

Fornece uma explicação do Padrão de Mensagens Tivoli, bemcomo uma lista de todas as mensagens do Tivoli KernelServices.

Convenções Utilizadas Neste GuiaO documento utiliza várias convenções de tipos para termos e açõesespeciais. Essas convenções possuem o seguinte significado:

Negrito Comandos, palavras-chave, sinalizadores e controlesde GUI, exceto títulos de janelas e de caixas dediálogo, aparecem emnegrito.

Itálico Variáveis e novos termos aparecem emitálico. Aspalavras e frases que são enfatizadas tambémaparecem emitálico.

Espaçamento FixoExemplos de códigos, saída e mensagens do sistemaaparecem em uma fonte de espaçamento fixo. Osnomes de classes e métodos Java e as marcaçõesXML ou HTML também aparecem emespaçamentofixo.

xiDetecção de Problemas no Tivoli Kernel Services

Este documento utiliza a convenção UNIX para variáveis deambiente específicas e para notação de diretório. Ao utilizar a linhade comandos do Windows NT, substitua$variable por %variable%para variáveis de ambiente e substitua cada barra (/) por uma barrainvertida (\) nos caminhos do diretório.

Nota: Quando utilizar um shell bash em um sistema Windows NT,você poderá utilizar as convenções do UNIX.

Acessando Publicações OnlineO site do Tivoli Customer Support na Web(http://www.tivoli.com/support/ ) oferece um guia para serviços desuporte (oCustomer Support Handbook); perguntas freqüentes(FAQs); e informações técnicas, incluindo notas sobre release, guiasde usuário, redbooks e documentos técnicos. Você pode acessar aspublicações online do Tivoli no endereçohttp://www.tivoli.com/support/documents/. A documentação dealguns produtos está disponível nos formatos PDF e HTML. Paraalguns produtos, estão disponíveis, também, documentos traduzidos.

Para acessar a maioria da documentação, é necessário ter um ID euma senha. Para obter um ID para uso no site de suporte da Web, váparahttp://www.tivoli.com/support/getting/ .

Os revendedores devem consultarhttp://www.tivoli.com/support/smb/index.html para obter maisinformações sobre como obter documentação e suporte técnico doTivoli.

Os Parceiros Comerciais devem consultar “Pedindo Publicações” napágina xiii para obter mais informações sobre como obter adocumentação técnica do Tivoli.

xii Versão 1.2

Pedindo PublicaçõesPeça publicações online do Tivoli no endereçohttp://www.tivoli.com/support/Prodman/html/pub_order.html ouatravés do seguinte telefone:

¶ Clientes no Brasil:(0800) 787378

Fornecendo Feedback sobre PublicaçõesEstamos muito interessados em conhecer sua experiência com osprodutos e a documentação do Tivoli e receberemos suas sugestõespara melhorias com satisfação. Se você tiver comentários ousugestões sobre nossos produtos e nossa documentação, entre emcontato conosco por meio de uma das seguintes maneiras:

¶ Envie um e-mail [email protected].

¶ Preencha a nossa pesquisa de feedback de cliente emhttp://www.tivoli.com/support/survey/.

Como Entrar em Contato com o Suporte ao ClienteO Tivoli Customer Support Handbookemhttp://www.tivoli.com/support/handbook/ fornece informações sobretodos os aspectos do Tivoli Customer Support, incluindo o seguinte:

¶ Registro e elegibilidade.

¶ Como entrar em contato com o suporte, dependendo dagravidade do problema.

¶ Números de telefone e endereços de e-mail, dependendo do paísem que você está.

¶ Que informações você deve reunir antes de entrar em contatocom o serviço de suporte.

xiiiDetecção de Problemas no Tivoli Kernel Services

xiv Versão 1.2

Avisos Adicionais

OpenSSL LicenseCopyright (c) 1998-2000 The OpenSSL Project. Todos os direitosreservados.

A redistribuição e o uso em formatos de origem e binários, com ousem modificação, são permitidos, desde que as seguintes condiçõessejam respeitadas:

1. As redistribuições do código de origem devem mostrar o avisode copyright acima, esta lista de condições e a seguinte isençãode responsabilidades.

2. As redistribuições em formato binário devem reproduzir o avisode copyright acima, esta lista de condições e a seguinte isençãode responsabilidades na documentação e/ou outros materiaisfornecidos com a distribuição.

3. Todos os materiais de propaganda que mencionam recursos ou ouso deste software devem exibir o seguinte agradecimento:″Esteproduto inclui software desenvolvido pelo OpenSSL Project parauso no OpenSSL Toolkit. (http://www.openssl.org/)″

4. Os nomes″OpenSSL Toolkit″ e ″OpenSSL Project″ não devemser utilizados para endossar ou promover produtos derivadosdeste software sem prévia permissão por escrito. Para obterpermissão por escrito, entre em contato com [email protected].

5. Os produtos derivados deste software não podem ser chamados″OpenSSL″ nem o″OpenSSL″ aparecer em seus nomes, semprévia permissão por escrito do OpenSSL Project.

6. As redistribuições em qualquer formato devem mostrar oseguinte agradecimento:″Este produto inclui softwaredesenvolvido pelo OpenSSL Project para uso no OpenSSLToolkit (http://www.openssl.org/)″.

ESTE SOFTWARE É FORNECIDO PELO OpenSSL PROJECT″NO ESTADO″ E QUAISQUER GARANTIAS EXPRESSAS OU

xvDetecção de Problemas no Tivoli Kernel Services

IMPLÍCITAS, INCLUINDO, MAS NÃO LIMITADAS ÀSGARANTIAS IMPLÍCITAS DE COMERCIALIZAÇÃO EADEQUAÇÃO A UM FIM ESPECÍFICO SÃO ISENTAS DERESPONSABILIDADE. EM NENHUM CASO PODE O OpenSSLPROJECT OU SEUS CO-RESPONSÁVEIS SEREMRESPONSABILIZADOS POR QUAISQUER INDENIZAÇÕESPOR PERDAS E DANOS DIRETOS, INDIRETOS, INCIDENTAIS,ESPECIAIS, INDENIZAÇÕES PUNITIVAS (INCLUINDO, MASNÃO LIMITADOS AO FORNECIMENTO DE BENS OUSERVIÇOS SUBSTITUTOS; PERDAS POR USO, DADOS,LUCROS OU INTERRUPÇÃO DO NEGÓCIO) POR VENTURACAUSADOS E EM QUALQUER TEORIA DERESPONSABILIDADE, SE EM CONTRATO,RESPONSABILIDADE ESTRITA OU AÇÃO POR ATOS ILÍCITOS(INCLUINDO NEGLIGÊNCIA OU OUTRA CAUSA)OCASIONADOS EM QUALQUER FASE DE UTILIZAÇÃODESTE SOFTWARE, MESMO QUE AVISADOS DAPOSSIBILIDADE DE TAL DANO.

Este produto inclui software criptográfico escrito por Eric Young([email protected]). Este produto inclui o software escrito por TimHudson ([email protected]).

Original SSLeay LicenseCopyright (C) 1995-1998 Eric Young ([email protected]) Todos osdireitos reservados.

Este pacote é uma implementação SSL escrita por Eric Young([email protected]). A implementação foi escrita para ficar emconformidade com o SSL do Netscape.

Esta biblioteca é livre para uso comercial e não comercial desde queas seguintes condições estejam anexadas à mesma. As seguintescondições aplicam-se a todos os códigos encontrados nestadistribuição, sejam os códigos RC4, RSA, lhash, DES, etc., e nãosomente o código SSL. A documentação do SSL incluída com estadistribuição é coberta pelos mesmos termos de copyright, exceto queo proprietário é Tim Hudson ([email protected]).

xvi Versão 1.2

O Copyright permanece de Eric Young, e portanto nenhum aviso deCopyright no código deve ser removido. Se este pacote for utilizadoem um produto, deve ser atribuída a Eric Young a autoria das partesda biblioteca utilizada. Isso pode ser em formato de mensagem detexto na inicialização do programa ou de documentação (online ouem texto) fornecida com o pacote.

A redistribuição e o uso em formatos de origem e binários, com ousem modificação, são permitidos, desde que as seguintes condiçõessejam respeitadas:

1. As redistribuições do código de origem devem mostrar o avisode copyright acima, esta lista de condições e a seguinte isençãode responsabilidades.

2. As redistribuições em formato binário devem reproduzir o avisode copyright acima, esta lista de condições e a seguinte isençãode responsabilidades na documentação e/ou outros materiaisfornecidos com a distribuição.

3. Todos os materiais de propaganda que mencionam recursos ou ouso deste software devem exibir o seguinte agradecimento:″Esteproduto inclui software criptográfico escrito por Eric Young([email protected]).″ A palavra ’criptográfico’ pode ser deixadade lado, se as rotinas da biblioteca que estão sendo utilizadas nãoestiverem relacionadas com criptografia.

4. Se for incluído um código específico de Windows (ou umderivativo do mesmo) a partir do diretório apps (código deaplicativo), você deve incluir um agradecimento:″Este produtoinclui software escrito por Tim Hudson ([email protected])″

ESTE SOFTWARE É FORNECIDO POR ERIC YOUNG″NOESTADO″ E QUAISQUER GARANTIAS EXPRESSAS OUIMPLÍCITAS, INCLUINDO, MAS NÃO LIMITADAS ÀSGARANTIAS IMPLÍCITAS DE COMERCIALIZAÇÃO EADEQUAÇÃO A UM FIM ESPECÍFICO SÃO ISENTAS DERESPONSABILIDADE. EM NENHUM CASO PODE O AUTOROU SEUS CO-RESPONSÁVEIS SEREM RESPONSABILIZADOSPOR QUAISQUER INDENIZAÇÕES POR PERDAS E DANOSDIRETOS, INDIRETOS, INCIDENTAIS, ESPECIAIS,

xviiDetecção de Problemas no Tivoli Kernel Services

INDENIZAÇÕES PUNITIVAS (INCLUINDO, MAS NÃOLIMITADOS AO FORNECIMENTO DE BENS OU SERVIÇOSSUBSTITUTOS; PERDAS POR USO, DADOS, LUCROS OUINTERRUPÇÃO DO NEGÓCIO) POR VENTURA CAUSADOS EEM QUALQUER TEORIA DE RESPONSABILIDADE, SE EMCONTRATO, RESPONSABILIDADE ESTRITA OU AÇÃO PORATOS ILÍCITOS (INCLUINDO NEGLIGÊNCIA OU OUTRACAUSA) OCASIONADO EM QUALQUER FASE DEUTILIZAÇÃO DESTE SOFTWARE, MESMO QUE AVISADOSDA POSSIBILIDADE DE TAL DANO.

Os termos de licença e distribuição para qualquer versão disponívelpublicamente ou derivada deste código não podem ser alterados, istoé, este código não pode simplesmente ser copiado e colocado emoutra licença de distribuição [incluindo uma Licença Pública GNU].

Apache e Apache TomcatEsse produto inclui software desenvolvido pelo The Apache Grouppara utilização no projeto Servidor Apache HTTP(http://www.apache.org/).

Esse produto inclui software desenvolvido por Greg Stein<[email protected]> para utilização no módulo mod_dav para Apache(http://www.webdav.org/mod_dav/).

Esse produto inclui software derivado do software desenvolvido porHenry Spencer.

Esse produto inclui software derivado do RSA Data Security, Inc.MD5 Message-Digest Algorithm.

Os direitos autorais de partes de determinados componentes doPrograma são protegidos pela MERANT, 1991-1999.

xviii Versão 1.2

Apresentando a Detecção deProblemas no Tivoli KernelServices

O Tivoli Kernel Services fornece aplicativos com um conjunto decomponentes e funções para gerenciar uma ampla variedade deusuários, dispositivos e serviços. Desenvolvido sobre comunicaçõescomuns, sistema de mensagens, armazenamento de dados e serviçosde log, e enriquecido com segurança e uma nova interface dousuário baseada em funções, o Tivoli Kernel Services precisa de umanova abordagem para diagnóstico e resolução de erros e falhas. Estaabordagem inclui algumas funções internas do sistema e também acoleta de informações.

O Tivoli Kernel Services está organizado em torno de umaarquitetura modular denominada modelo de componente. Essescomponentes possuem um nível de tolerância a falhas, que émonitorado pelo Failover Service. Quando falhas e erros não podemser resolvidos pelo Failover Service, a ferramenta de diagnósticosprincipal do sistema, log, é utilizada para coletar informações edeterminar a causa exata do problema. Estes itens são fornecidosjuntos para formar uma série de etapas de detecção de problemasque os usuários podem executar ao encontrar problemas.

Este capítulo descreve o modelo de componente, o Failover Servicee os logs padrão do sistema.

1

1Detecção de Problemas no Tivoli Kernel Services

1.A

pres.a

Detecção

deP

rob.no

TK

S

Modelo de ComponenteO modelo de componente descreve as características de uma unidadefuncional do código em execução no Tivoli Kernel Services. Todocódigo que é instalado e executado como parte do Tivoli KernelServices, além dos aplicativos que utilizam o Tivoli Kernel Services,é definido em termos do modelo de componente. Isso permite que ainstalação e a manutenção do sistema operem dentro de um conjuntode elementos consistentemente definidos.

Um componente pode ser um serviço ou pode ser um conjunto decódigos utilizado para implementar a função utilizada diretamentepor outra parte do sistema distribuído. É possível instalar, removerou fazer upgrade de um componente, além de ele poder ser utilizadopor outros componentes para formar um sistema distribuído comfunções completas. Como a base do Tivoli Kernel Services consisteem componentes, a maioria das atividades de detecção de problemassão executadas no nível de componente.

O Tivoli Kernel Services é composto pelos seguintes tipos decomponentes e serviços:

Serviços de núcleoOs serviços de núcleo do Tivoli Kernel Services fornecemcapacidades básicas que são fundamentais para a operaçãodo sistema distribuído ou que fornecem serviços que podemser utilizados consistentemente em todo o sistema por todosos outros componentes. Este grupo de componentes inclui oORB (object request broker), que é o componente decontrole e roteamento central para o Tivoli Kernel Services,e os serviços para validar a identidade e os direitos de acessodo usuário, compartilhar e armazenar dados e entregarmensagens em todo o sistema distribuído.

Componentes do nível de componenteOs componentes do nível de componente do Tivoli KernelServices fornecem meios pelos quais as partes dosaplicativos e serviços podem ser gerenciadas em todo osistema Tivoli Kernel Services. Esse grupo de componentesinclui serviços para implementação de componentes para

2 Versão 1.2

uma operação mais eficiente do Tivoli Kernel Services,instalação de software e implementação do software naslocalizações corretas.

Componentes do nível de recursoOs componentes do nível de recurso do Tivoli KernelServices são aqueles que fornecem acesso direto aos recursosno sistema distribuído. Esse grupo de componentes inclui osgateways, o serviço de localização que determina qualgateway utilizar para um determinado recurso, e as pilhas deprotocolo e meta-dados utilizados para se comunicar com osrecursos.

Componentes do nível de aplicativoAlém das funções base fornecidas pelo Tivoli KernelServices, são poucos os componentes fornecidos que podemser considerados aplicativos por si só, ou pelo menos partesde um aplicativo em vez de parte do Tivoli Kernel Services.Este grupo de componentes inclui o Tivoli Console e a CLI(interface de linha de comandos), que permite a operação dopróprio Tivoli Kernel Services.

FailoverO mecanismo de resposta e detecção de erros para todo o sistema éo Failover Service. Este serviço monitora ativamente erros e falhasdos componentes tolerantes a falhas (apenas os que pedem para sermonitorados), serviços, ORBs e a JVM. Quando uma falha édetectada, o serviço tenta reiniciar o componente com falha namesma máquina. Se isso não der certo, uma versão de backup docomponente é iniciada; as informações de configuração docomponente contêm a localização de um backup, caso exista algum.A versão de backup do componente continuará sendo utilizada atéque falhe.

O Failover Service é executado no background, monitorandoautomaticamente todos os componentes tolerantes a falhas. O serviçoé constituído do Failover Agent, que monitora os componentes e énotificado quando os componentes são iniciados e encerrados. Aconfiguração do Agent é limitada à monitoração de ativação e


1.A

pres.a

Detecção

deP

rob.no

TK

S

desativação de componentes específicos e à alteração do intervalo deverificação de falhas do componente. Essas definições deconfiguração são feitas utilizando a interface de linha de comandos.Consulte oTivoli Kernel Services Command Referencepara obtermais informações sobre a configuração do Failover Agent.

O Failover Service contém dois registradores. O registrador demensagens do Failover Service é oFailoverMessageLogger. Eleregistra todas as mensagens geradas pelo Failover Service. Oregistrador de rastreios do Failover Service é oFailoverTraceLogger. Ele é utilizado para localizar todas asinformações de rastreio geradas pelo Failover Service e devefornecer informações suficientes para resolver a maioria dosproblemas. A maioria dos problemas com o Failover Service ocorremao iniciar, encerrar ou fazer upgrade de um serviço. Se você reiniciaro Failover Service, ele recarregará todas as informações deconfiguração e encerrará/iniciará a monitoração de todos oscomponentes configurados; isso pode ajudar a corrigir algunsproblemas.

Visão Geral de LogLog refere-se às mensagens de texto e dados de rastreio criadospelos componentes e aplicativos do Tivoli Kernel Services. Asmensagens e os dados são enviados para o destino de saída, tal comoum arquivo, banco de dados, tela de console e etc, para inspeçãoposterior. Os logs padrão operacionais são descritos neste capítulo eos logs padrão de instalação são descritos em “Detecção deProblemas na Instalação” na página 49. Detalhes adicionais sobre ocomponente e serviço de log, e como configurá-lo, são descritos em“Log e Rastreio” na página 11.

Geralmente, as mensagens de texto são utilizadas para retransmitirinformações sobre como o sistema ou aplicativo está sendoexecutado. As mensagens também são utilizadas para alertar oadministrador sobre condições excepcionais ocorridas. As mensagenssão internacionalizadas com base na localidade do visualizador demensagens e podem ser filtradas com base em um série de critérios.

4 Versão 1.2

Por outro lado, os dados de rastreio são utilizados para capturarinformações transientes sobre o ambiente operacional atual quando aoperação de um componente ou aplicativo não funcionaadequadamente. O pessoal do Suporte ao Cliente Tivoli utiliza asinformações de rastreio capturadas para determinar a origem de umerro ou a condição inesperada e para diagnosticar o problema. Porpadrão, o rastreio fica desativado e, como as mensagens de texto,pode ser filtrado com base em um grande número de critérios. Osdados do log de rastreios estão disponíveis atualmente somente eminglês.

Configuração Padrão do Registrador de MensagensA Figura 1 na página 7 fornece um resumo dos padrões doregistrador de mensagens. A saída do registrador de mensagens vaipara um ou mais arquivos de mensagens nomeados$ORBDIR/log/messagen.log e para o console, onde $ORBDIR é ocaminho completo do diretório de instalação do depósito deinstalação ou ORB de bootprint (por exemplo, C:\Tivoli\orb.1). Oprimeiro arquivo do log de mensagens é nomeado, por padrão,message1.log. Assim que este arquivo alcançar o tamanho padrão,ele é renomeado para message2.log, e um novo arquivomessage1.log é criado. Isso assegura que o arquivo message1.logcontenha as informações mais recentes do sistema.

Esses arquivos podem crescer até 512 KB; podem existir trêsarquivos separados; e o formato do arquivo é, por padrão, umarquivo de texto ASCII. Esses logs de mensagens podem serexibidos utilizando o comandotail no UNIX, ou por meio do Blocode Notas ou qualquer outro editor de texto no Windows. ConsulteInstalando o Tivoli Kernel Servicespara obter mais informaçõessobre como utilizar o comandotail . O tamanho do arquivo do log demensagens e o número de arquivos do log de mensagens sãoconfiguráveis. Consulte oTivoli Kernel Services Command Referencepara obter mais informações sobre como configurar os arquivos dolog de mensagens.


1.A

pres.a

Detecção

deP

rob.no

TK

S

O registrador de mensagens utiliza um formatador mínimo quemostra somente a marca de hora e o texto da mensagem. Ele utilizaum msgFilter que permite registrar todos os tipos de mensagem.

Nota: O símbolo $ no gráfico a seguir representa um prompt decomandos. Os exemplos dewcmd nestes gráficos pressupõemque a pessoa que está emitindo os comandos sejaimplicitamente identificada no Tivoli Kernel Services pelasinformações apropriadas de conta e usuário. Caso contrário,você deverá utilizar a opção-u em cadawcmd e especificarum ID de usuário do Tivoli Kernel Services que tenhaautorização para executar o comando. Informações adicionaispodem ser encontradas noTivoli Kernel Services CommandReference, na seção intituladaImplicações de Segurança paraComandos wcmd. Além disso, os comandos devem serdigitadosexatamentecomo são escritos. Quaisquer erros degrafia no nome do caminho, que utilizem a distinção entremaiúsculas e minúsculas, não são confirmados com umamensagem de erro e o comando é executado com asinformações incorretas.

6 Versão 1.2

Figura 1. Configuração padrão do registrador de mensagens


1.A

pres.a

Detecção

deP

rob.no

TK

S

Configuração Padrão do Log de Rastreios

A Figura 2 fornece um resumo dos padrões dos registradores derastreios. A saída do registrador de rastreios vai para um ou maisarquivos nomeados $ORBDIR/log/tracen.log. Esses arquivos podemaumentar até 512 KB; e, por padrão, podem existir três arquivosseparados. O primeiro arquivo do log de rastreios é nomeado, por

Figura 2. Configuração padrão do registrador de rastreios

8 Versão 1.2

padrão, trace1.log. Quando este arquivo alcança o tamanho padrão,ele é renomeado para trace2.log, e um novo arquivo trace1.log écriado. Isso assegura que o arquivo trace1.log contenha asinformações mais recentes do sistema. O tamanho do arquivo do logde rastreios e o número de arquivos do log de rastreios sãoconfiguráveis. Consulte oTivoli Kernel Services Command Referencepara obter mais informações sobre como configurar os arquivos dolog de rastreios.

O registrador de rastreios utiliza um trcFilter com uma máscaraTYPE_DEFAULT_TRACE. O registrador de rastreios utiliza umformatador máximo que mostra os campos, conforme ilustrado noexemplo a seguir.2000.10.26 13:56:59.321com.tivoli.core.logging.DistributedLogManagergetOrbAndElementName mainMyCorp/rshah1.dev.tivoli.com_9990systemaccount system/services/principals/orbEntry, parm 1 = msgFile

Uma explicação dos campos é mostrada a seguir:

logDate 2000.10.26

logTimestamp 13:56:59.321

logClass com.tivoli.core.logging.DistributedLogManager

logMethod getOrbAndElementName

logThread main

logServer MyCorp/rshah1.dev.tivoli.com_9990(Este é o namespaceName/orbName.)

logClient ″ ″

logPrincipal system/services/principals/orb

A saída mostra que é um ponto de rastreio para a entrada do métodogetOrbAndElementNamee o argumento para esse método émsgFile.


1.A

pres.a

Detecção

deP

rob.no

TK

S

10 Versão 1.2

Log e Rastreio

Log é o processo de registrar eventos do sistema para que essasações possam ser revistas posteriormente. O subsistema Log doTivoli Kernel Services se baseia no conjunto de ferramentas de logda IBM para Java. Este sistema inclui vários objetos para direcionare formatar registros de log. Também inclui um Serviço de Log, quepode ser configurado para executar o log de várias maneirasdiferentes.

Este capítulo descreve log, log local, configuração dinâmica de log,Serviço de Log, como criar e utilizar um banco de dados de logs,log de detecção de problemas, e como converter arquivos de logserializados em arquivos ASCII.

Visão Geral de LogO subsistema Log do Tivoli Kernel Services utiliza diversos objetospara gravar eventos do sistema. Esses objetos incluem registradores,rotinas de tratamento, filtros (também chamados de máscaras) eformatadores.Registradoressão objetos de software que gravam oseventos que ocorrem enquanto um componente está operando. Osubsistema Log suporta dois tipos de registradores: registradores demensagens e registradores de rastreios.

Registradores de mensagenssão utilizados para gravar mensagens detexto de um componente do Tivoli Kernel Services. Essas mensagens

2


2.Log

eR

astreio

são internacionalizadas para locais individuais. Os tipos demensagens associados a um registrador de mensagens, os quais sãoativados por padrão, incluem:

Mensagens informativasIndicam condições que são dignas de nota mas quenão exigem que o usuário tome precauções ouexecute uma ação.

Mensagens de avisoInformam ao usuário que foi detectada uma condiçãoda qual o usuário deve estar ciente, mas que nãoexige necessariamente uma ação. Por exemplo, essetipo de mensagem pode indicar que algum aspectode um programa não foi executado como previsto,mas que os padrões foram aplicados, de modo que oprograma continua a operar, mas a saída deve serexaminada para validação.

Mensagens de erroInformam o usuário sobre eventos sérios, tais como afalha de um componente ao registrar uma entrada dobanco de dados.

Mensagens fataisIndicam os erros mais sérios, tais como erros queexigem que um ORB seja reiniciado ou que umcomponente seja encerrado, uma vez que astentativas de recuperação de erro falharam.

Registradores de rastreiossão utilizados para capturar informaçõessobre o ambiente operacional quando o código do componente falhaao operar como previsto. Esses logs estão somente no idioma inglês.O pessoal de Suporte ao Cliente Tivoli utiliza as informaçõescapturadas pelos registradores de rastreios para rastrear um problemaem sua origem ou para determinar a razão de um erro. Geralmente,essas informações não são ativadas por padrão. Como as mensagensde rastreio são destinadas à equipe de suporte, elas geralmente sãogravadas em um arquivo que pode ser visualizado durante um exameposterior.

12 Versão 1.2

Como o log de mensagens e rastreios fica, por padrão, desativado,ele deve ser ativado para cada componente sobre o qual você desejareunir informações. “Detecção de Problemas em Componentes” napágina 111 lista e descreve os registradores de mensagens e rastreiospara cada componente do sistema. Contém também as etapasnecessárias para ativar e desativar um registrador individual.

Rotinas de tratamentosão objetos de software que direcionam paraum destino mensagens gravadas por um registrador. As mensagenspodem ser enviadas a um arquivo, um banco de dados, uma tela deconsole ou a outros destinos. É possível associar rotinas detratamento a registradores para enviar ao destino desejadoinformações gravadas por um registrador. O Tivoli Kernel Servicesfornece as definições de configuração para os seguintes tipos derotinas de tratamento:

Rotina de Tratamento de ConsoleGrava registros de log em umconsole (system.out).

Rotina de Tratamento de ArquivosGrava registros de log em umarquivo.

Rotina de Tratamento de Múltiplos ArquivosGrava registros de log em umconjunto rotativo de arquivos de log.

Rotina de Tratamento de Arquivos SeriaisGrava registros de log em arquivoscomo objetos serializados.

Rotina de Tratamento do Banco de DadosGrava registros de log em um bancode dados.

Rotina de Tratamento de ServidoresEnvia registros de log no modo batchpara serem processados pelo servidorde log remoto.


2.Log

eR

astreio

Filtros podem ser aplicados aos registradores, às rotinas detratamento, ou a ambos, registradores e rotinas de tratamento.Quando aplicado a um registrador, o filtro determina quais tipos deregistros de mensagem e rastreio são processados pelo registrador.Quando aplicado a uma rotina de tratamento, o filtro determina quaisregistros de mensagem e rastreio a rotina de tratamento envia a umdestino. Os filtros funcionam comparando um tipo de registro de loga um conjunto de critérios, ou a uma consulta, contidos no filtro.

A lista a seguir contém definições de configuração de filtros. Estesfiltros são fornecidos pelo JLog e são utilizados pelo Tivoli KernelServices:

AllMaskFilterUm registro de log poderá atravessar este filtrosomente se todos os bits do tipo de registroestiverem incluídos na máscara do filtro.

AnyMaskFilterUm registro de log poderá atravessar este filtro sequalquer um dos bits do tipo de registro estiverincluído na máscara do filtro. Este é o filtro padrãoutilizado pelo Tivoli Kernel Services.

ExcludeMaskFilterUm registro de log não poderá atravessar este filtrose qualquer um dos bits do tipo de registro estiverincluído na máscara do filtro. Isso pode ser aplicadoa um registrador ou a uma rotina de tratamento paraevitar o processamento de registros de log comdeterminados tipos de registro.

msgFilter Permite que qualquer mensagem atravesse o filtro.

Este é um AnyMaskFilter com um tipo de máscaraTYPE_DEFAULT_MESSAGE, que incluiTYPE_INFO, TYPE_WARN, TYPE_ERR eTYPE_FATAL.

trcFilter Permite a passagem das entradas de rastreio padrão.

14 Versão 1.2

Este é um AnyMaskFilter com um tipo de máscaraTYPE_DEFAULT_TRACE. Consulte a Tabela 1 paradeterminar quais tipos de rastreio estão incluídos.

Tabela 1. Máscaras de rastreioTipo de Rastreio Descrição

TYPE_ALL Especifica uma máscara que inclui todos os tipospossíveis.

TYPE_API Especifica se o método é um ponto de entradapara este produto, componente ou pacote.

TYPE_CALLBACK Define um ponto de rastreio do método callback.Os callbacks são geralmente utilizados nasclasses de ouvinte, que foram registradas comoutro objeto para notificação de um eventoespecífico.

TYPE_DEFAULT_TRACE

Define os tipos de rastreio padrão. O padrãoinclui o seguinte:

¶ TYPE_API | TYPE_CALLBACK |TYPE_ENTRY |

¶ TYPE_EXIT | TYPE_ERROR_EXC |TYPE_MISC_DATA |

¶ TYPE_OBJ_CREATE |TYPE_OBJ_DELETE |

¶ TYPE_PRIVATE | TYPE_PUBLIC |TYPE_STATIC |

¶ TYPE_SVC

TYPE_ENTRY Define os pontos de rastreio de entrada dométodo. Um ponto de rastreio de entrada deveexistir para que cada método significativoacompanhe a movimentação em um componenteou aplicativo.

TYPE_ERROR_EXC Define um ponto de rastreio de condição de erroou exceção.


2.Log

eR

astreio

Tabela 1. Máscaras de rastreio (continuação)Tipo de Rastreio Descrição

TYPE_EXIT Define pontos de rastreio de saída do método.Um ponto de rastreio de saída deve existir paraque cada método significativo acompanhe amovimentação em um componente ou aplicativo.

TYPE_LEVEL1 Define um ponto de rastreio de nível baixo quefornece poucos detalhes. Isso é fornecido paraimplementações de rastreio que preferem anoção de um nível de rastreio, no qual o nível 1implica detalhes mínimos, o nível 2 implica maisdetalhes e o nível 3 implica o maior número dedetalhes. Nesse tipo de sistema, esses três tiposseriam utilizados exclusivamente.

Este tipo de rastreio não é incluído noTYPE_DEFAULT_TRACE.

TYPE_LEVEL2 Define um ponto de rastreio de detalhe médioque fornece mais detalhes que oTYPE_LEVEL1.


TYPE_LEVEL3 Define um ponto de rastreio de detalhe alto quefornece a maior quantidade de detalhes, emcomparação ao TYPE_LEVEL1 ouTYPE_LEVEL2.


TYPE_MISC_DATA Define um ponto de rastreio de uma variedadede dados. Este tipo é utilizado por umcomponente ou aplicativo para registrar umavariedade de informações que não se encaixamnos outros tipos predefinidos.

TYPE_NONE Especifica um tipo de registro nulo que nãoatravessará um filtro; ou seja, este tipo deregistro não está registrado.

16 Versão 1.2

Tabela 1. Máscaras de rastreio (continuação)Tipo de Rastreio Descrição

TYPE_OBJ_CREATE Define um ponto de rastreio de criação, ouconstrutor, de objetos.

TYPE_OBJ_DELETE Define um ponto de rastreio de exclusão, oudestruidor, de objetos. Este tipo geralmente seriautilizado em um método finalize.

TYPE_PERF Define um ponto de rastreio de monitoração dedesempenho. Este tipo pode ser utilizado paramedir o tempo de execução de seçõesselecionadas em um aplicativo.


TYPE_PRIVATE Define um ponto de rastreio do método private.Os pontos de rastreio de private seriam definidosem métodos com o escopo private; ou seja, nãopublic, protected ou package.

TYPE_PUBLIC Define um ponto de rastreio do método public.Isso geralmente inclui o escopo package eprotected, visto que todos esses métodos podemser utilizados por outras classes.

TYPE_STATIC Define um ponto de rastreio do método static.

TYPE_SVC Define um ponto de rastreio do código deserviço. O código de serviço é geralmente umcódigo de nível baixo que fornece serviçoscomumente utilizados por outras classes.

Formatadoressão objetos de software utilizados para formatar asaída de informações contidas nos registros de log. Em geral, osformatadores podem ser utilizados para adaptar, por exemplo, marcasde data e hora para as convenções locais. Um único formatador podeser utilizado por várias rotinas de tratamento. As seguintes definiçõesde configuração de formatadores são fornecidas pelo Tivoli KernelServices:

mínimo Exibe a data, marca de hora e a mensagem


2.Log

eR

astreio

internacionalizada. Um formatador mínimo éutilizado para logs de mensagens.

máximo Exibe todos os campos associados aos dados.Consulte “Configuração Padrão do Log de Rastreios”na página 8 para obter uma lista completa e adescrição de todos os campos de dados. Umformatador máximo é utilizado para logs de rastreios.

Ter inúmeros registradores, rotinas de tratamento, filtros eformatadores pode fazer com que haja uma quantidade indevida deadministração de log a ser executada. Para reduzir a carga daadministração, você pode criar grupos. Umgrupo contémregistradores, rotinas de tratamento, filtros ou formatadores quepossuem propriedades comuns. Criando grupos, um registrador,rotina de tratamento, filtro ou formatador recém-criado compropriedades não definidas pode herdar valores das propriedades dogrupo. Se um registrador, rotina de tratamento, filtro ou formatadorpertencer a um grupo e suas propriedades forem atualizadas, todosos outros registradores, rotinas de tratamento, filtros ou formatadoresdesse grupo também terão essa propriedade atualizada. Isso elimina anecessidade de atualizar manualmente as propriedades individuais deregistradores, rotinas de tratamento, filtros ou formatadores.

O Log Manageré o núcleo do sistema de log. Ele cria e configuratodos os objetos de log descritos anteriormente. Ele está ligado aoORB, Configuration Service e Directory Service, para responder aospedidos de componentes e aplicativos para envio de mensagens delog para rotinas de tratamento e formatadores.

Log LocalEm todo o restante deste documento, é conveniente às vezesreferir-se aos registradores, rotinas de tratamento, filtros eformatadores utilizando um termo genérico que inclua um ou maisdestes objetos de software. O termoelemento de logserá utilizadoquando uma referência a um determinado tipo de objeto de log, talcomo um objeto formatador, não for necessária.

18 Versão 1.2

Cada ORB possui um gerenciador de logs associado a ele. As rotinasde tratamento podem ser locais ou remotas em relação ao aplicativode origem.

A Figura 3 mostra a arquitetura básica do log local e dos elementosde log. Em um ambiente de log local, todos os componentes e oselementos de log ficam sob o controle de um único ORB. A Tivolirecomenda que filtros sejam aplicados aos registradores porque issomantém a configuração simples e evita que dados não utilizadossejam passados para as rotinas de tratamento.

Configuração DinâmicaTodos os elementos de log, e o próprio componente Serviço de Log,podem ser configurados dinamicamente utilizando a CLI (interfacede linha de comandos) do log ou o Tivoli Console. O Tivoli Consolefornece auxílio online para ajudar na configuração do log. Para obter

Figura 3. Arquitetura de log local


2.Log

eR

astreio

informações sobre como utilizar o Tivoli Console para o log,consulteApresentando a Administração do Tivoli Kernel Servicese oauxílio online no Tivoli Console.

Informações sobre como utilizar a CLI de log são fornecidas nasseções seguintes para ajudar você a se familiarizar com aconfiguração dos elementos de log e o Serviço de Log.

Nota: Os exemplos dewcmd nesta seção pressupõem que a pessoaque está emitindo os comandos seja implicitamenteidentificada no Tivoli Kernel Services pelas informaçõesapropriadas de conta e usuário. Caso contrário, você deveráutilizar a opção-u em cadawcmd e especificar um ID deusuário do Tivoli Kernel Services que tenha autorização paraexecutar o comando. Informações adicionais podem serencontradas noTivoli Kernel Services Command Reference,na seção intituladaImplicações de Segurança para Comandoswcmd. Além disso, os comandos devem ser digitadosexatamentecomo são escritos. Quaisquer erros de grafia nonome do caminho, que utilizem a distinção entre maiúsculas eminúsculas, não são confirmados com uma mensagem de erroe o comando é executado com as informações incorretas.

Estrutura da Configuração do LogTodos os elementos de log utilizam a coalescência ou herança paradefinir os valores de propriedades. Isso significa que há uma relaçãoentre pai e filho. Se uma propriedade não estiver definida para umfilho, essa propriedade será herdada do pai.

Por exemplo, a Figura 4 na página 21 mostra que o nó derastreio/contêiner possui a propriedadeisLogging=false. Ambos osfilhos, o log e o diretório, herdam esta propriedade. No entanto, estapropriedade no grupo de logs pode ser substituída definindo-a paratrue. Portanto, o filho do log,managerTracepossui ocomportamentoisLogging=true.

20 Versão 1.2

O grupo de diretórios não substitui esta propriedade. Isso porque odiretório possui uma série de registradores de rastreios e gerammuitos dados de rastreio. Em vez disso, os registradores de rastreiosde diretório individuais, dirservice e slashtrace, possuem apropriedadeisLogging=true.

Na Figura 4, o nome do registrador de rastreios inclui seu grupo. Porexemplo, o registrador de rastreios managerTrace inclui seu grupo delog, como emlog.managerTrace. Ao emitir comandos da CLI delog, você precisa incluir o nome do grupo, seguido por um ponto e onome do registrador de rastreios. Não é necessário incluir o grupocom um ponto para os comandos de CLIwcmd cfg.

Além da coalescência da árvore do log, também há coalescência deORB nesta ordem:

Figura 4. Configuração do log


2.Log

eR

astreio

1. .orbdefaults: um conjunto de ORBs que não pode ser alteradopelo usuário. Contém as definições fornecidas pelo Tivoli KernelServices e é somente leitura.

2. .allorbs: um conjunto de ORBs que pode ser personalizado pelousuário final.

3. Conjuntos de ORBs: a coleção lógica de ORBs definidos.

4. ORB: o ORB específico que você está emitindo para owcmds.

O seguinte comando mostra como ativar o rastreio paralog.managerTrace em .allorbs.wcmd log -r .allorbs trace log.managerTrace -set isLogging=true

O recurso-r pode ser qualquer um dos seguintes:

¶ Pode ser um nome de ORB (por exemplo,orb/mymachine/mycorp/com_9990).

¶ Pode ser um conjunto de ORBs (por exemplo,orbset/testsetou.allorbs).

¶ Pode ser também um OID de ORB (por exemplo,3.af17bdf834eae996.1.d6caaf2223f8f495).

Atenção: É importante que vocênão emita o comando a seguir,porque ele ativa o rastreio paratodosos registradores de rastreios noTivoli Kernel Services e isso resulta em séria degradação dedesempenho:wcmd log trace -set isLogging=true

Em vez disso, emita um destes comandos (utilize o primeirocomando no nível de grupo e utilize o segundo comando para umregistrador de rastreios individual):wcmd log trace -g log -set isLogging=truewcmd log trace log log.managerTrace -set isLogging=true

Utilizando a Interface de Linha de Comandos do LogA CLI de log permite manipular os elementos de log a partir dalinha de comandos. Um Log Manager responde a pedidos do usuáriopara registrar objetos utilizando a CLI de log. Quando os usuários

22 Versão 1.2

desejam manipular um objeto de log, eles fazem isso especificando onome do objeto que desejam utilizar. As seções seguintes fornecemmais detalhes sobre como fazer isso.

Segurança da CLI de LogA CLI de log requer um nível de autorização mais baixo que a CLIde configuração e é ométodo recomendado para manipular oselementos de log. Consulte o comandowcmd log trace no TivoliKernel Services Command Referencepara obter os requisitos deautorização.

Utilizando a Interface de Linha de Comandos deConfiguração

A CLI de configuração também permite manipular os elementos delog a partir da linha de comandos. Consulte os comandoswcmd cfgno Tivoli Kernel Services Command Reference. Recomenda-se nãoutilizar a CLI wcmd cfg para ativar registradores de rastreios; utilizeos comandoswcmd log. Você precisará utilizar os comandoswcmdcfg quando criar nós que definem novas rotinas de tratamento,formatadores e filtros. A CLIwcmd cfg também permite navegarpelos nós da árvore /com/tivoli/util/logging.

Configuração da Rotina de TratamentoO Tivoli Kernel Services fornece definições padrão para as seguintesrotinas de tratamento:

console A saída vai para o console(system.out)

msgFile Múltiplos arquivos de mensagensASCII: $ORBDIR/log/messagen.log.

trcFile Múltiplos arquivos de rastreio ASCII:$ORBDIR/log/tracen.log.

serialMsgFile Arquivo de mensagens serial:$ORBDIR/log/serialMsgn.log.

serialTrcFile Arquivo de rastreio serial:$ORBDIR/log/serialTrcn.log.


2.Log

eR

astreio

logFile Arquivo de mensagens ASCII:$ORBDIR/log/loggingServicen.log.

logServerHandler Rotina de tratamento para gravar noServiço de Log. Consulte “Serviçode Log” na página 33 para obter maisinformações.

log.dbHandler Rotina de tratamento para gravarlogs de mensagens no banco dedados. Consulte “Criando um Bancode Dados de Log Adicional Após aInstalação” na página 40 para obtermais informações.

log.dbReader Rotina de tratamento para ler egravar logs de mensagens no bancode dados.

log.dbDelete Rotina de tratamento para gravar, lere excluir do banco de dados.

Listando Definições de Rotina de TratamentoPara obter uma lista de todas as definições de rotina de tratamento,emita o seguinte comando:wcmd log children -p /com/tivoli/util/logging/handler -f

A opção-f faz com que a saída exiba o caminho completo da rotinade tratamento. A omissão da opção-f faz com que a saída contenhasomente o nome da rotina de tratamento. Uma lista das rotinas detratamento atualmente definidas, mas não necessariamenteinstanciadas, é fornecida. Uma saída de amostra é semelhante a esta:/com/tivoli/util/logging/handler:

/com/tivoli/util/logging/handler/logServerHandler/com/tivoli/util/logging/handler/SerialGlobalMsgHandler/com/tivoli/util/logging/handler/ConsoleMsgHandler/com/tivoli/util/logging/handler/SerialGlobalTraceHandler/com/tivoli/util/logging/handler/console/com/tivoli/util/logging/handler/RasPfSerialTraceHandle/com/tivoli/util/logging/handler/FWPConsoleErrMsgHandler/com/tivoli/util/logging/handler/RasPfMFileTraceHandler/com/tivoli/util/logging/handler/log

24 Versão 1.2

/com/tivoli/util/logging/handler/logFile/com/tivoli/util/logging/handler/msgFile/com/tivoli/util/logging/handler/serialMsgFile/com/tivoli/util/logging/handler/sec/com/tivoli/util/logging/handler/MFileGlobalMsgHandler/com/tivoli/util/logging/handler/trcFile/com/tivoli/util/logging/handler/serialTrcFile/com/tivoli/util/logging/handler/ConsoleTraceHandler/com/tivoli/util/logging/handler/MFileGlobalTraceHandler

As definições de rotina de tratamento listadas não significam que arotina de tratamento tenha sido ativada.

Adicionando Sua Própria Rotina de TratamentoO subsistema log do Tivoli Kernel Services fornece rotinas detratamento que permitem que você direcione a saída do registradorpara qualquer número de destinos. A Figura 5 na página 26 mostraclasses de rotina de tratamento e ilustra os atributos e a hierarquia deherança para cada tipo. As rotinas de tratamento são fornecidas paradirecionar relatórios de log para bancos de dados, consoles,servidores de log e para uma variedade de tipos de arquivosdiferentes.


2.Log

eR

astreio

Para que o rastreio não seja direcionado para o arquivo de rastreiopadrão trace1.log, você precisa configurar sua própria rotina detratamento de múltiplos arquivos.

1. Crie um nó para a sua rotina de tratamento e especifique aspropriedades que são necessárias para uma rotina de tratamentode múltiplos arquivos, utilizando o comandowcmd cfg put. Aspropriedades a seguir são necessárias para configurar umMultiFileHandler.wcmd cfg put /com/tivoli/util/logging/handler/<nome escolhido>className=com.ibm.logging.MultiFileHandlerfileName=<nome do arquivo>formatterNames= maximal

DatabaseHandlercom.tivoli.core.logging.DatabaseHandler

DatabaseReader

DatabaseDelete

SerialFileHandlerReader

ServerHandlercom.tivoli.core.logging.ServerHandler

ConsoleHandlercom.tivoli.util.logging.ConsoleHandler

ConsoleHandlercom.ibm.logging.ConsoleHandler

FileHandlercom.ibm.logging.FileHandler

encodingfileName

MultiFileHandler

SerialFileHandler

maxFilesmaxFileSize

com.ibm.logging.Handler

= Rotinas de tratamento

Jlog da IBM

countrydriverbatchThresholdlanguagepasswordurlusernamevault

=TKSRotinas de tratamento

bulkRecordsSizeLoggingServerOrbReopenThresholdtimeoutPeriod

fetchSizequery

purgeInfoLogsAfter

wakeupTime

purgeWarnLogsAfterpurgeErrLogsAfterpurgeFatalLogsAfter

backupCapacityisBackupEnabledisCircularMaxRetriesqueueCapacityretryInterval

wcmd log handler -contentshandler_name

Figura 5. Classes de rotina de tratamento e suas propriedades

26 Versão 1.2

Por exemplo:wcmd cfg put /com/tivoli/util/logging/handler/directoryHandler

className=com.ibm.logging.MultiFileHandlerfileName=directory.logformatterNames=maximal

2. Verifique se você definiu todas as propriedades corretamenteutilizando o seguinte comando:wcmd log handler directoryHandler -contents

Por padrão, o com.ibm.logging.MultiFileHandler grava registrosde log em três arquivos de log rotativos, em vez de apenas umarquivo, o que acontece com outras rotinas de tratamento. Cadaum dos arquivos rotativos possuem, por padrão, 512 KB. Otamanho dos arquivos podem ser configurados conformenecessário. Os logs são gravados no diretório $ORBDIR/log.Além disso, um formatador máximo está sendo conectado àrotina de tratamento. Observe que o Tivoli Kernel Servicesfornece uma definição para o formatador máximo.

Conectando uma Rotina de Tratamento a um RegistradorPara conectar uma rotina de tratamento a um registrador, utilize oseguinte comando:wcmd log trace <-g grupo ou apenas um único componente>-set handlerNames=<contêiner utilizado acima>

Por exemplo:wcmd log trace -g directory -set handlerNames=directoryHandler

Rotinas de Tratamento RemotasA Figura 6 na página 28 descreve um cenário de log distribuído ondevocê utiliza uma rotina de tratamento remota. Em um ambiente delog distribuído, os componentes podem executar em um ORB e oselementos de log que processam as mensagens desse componentepodem residir em outro ORB. O modo de distribuição dos elementosde log dependerá da complexidade dos requisitos de instalação e docliente do Tivoli Kernel Services. Por exemplo, os registradorespodem ser executados no mesmo ORB que o componente que osutiliza e as rotinas de tratamento que fornecem as mensagensregistradas podem residir em ORBs remotos.


2.Log

eR

astreio

Esta figura ilustra como um componente no nó Austin pode utilizarregistradores locais para mensagens e dados de rastreio e ter osdados de rastreio registrados em um arquivo local e enviados parauma localização central. Neste exemplo, as mensagens de textoseriam enviadas para o console local, um arquivo local, ou ambos.Para tornar a ilustração mais simples, os filtros não são mostrados nafigura.

Os administradores do sistema podem alterar a associação entre osregistradores e as rotinas de tratamento e entre os formatadores e asrotinas de tratamento que utilizam operações de CLI ou de GUI doTivoli Kernel Services Administrative Console. Por exemplo, na

Figura 6. Rotina de tratamento remota

28 Versão 1.2

Figura 6 na página 28, um administrador poderia conectar uma rotinade tratamento do console ou uma rotina de tratamento de arquivoslocal ao registrador de rastreios e também conectar às rotinas detratamento em um ORB remoto para ativar o registro de dados derastreio em dois destinos. Um registrador de mensagens tambémpoderia ser configurado de modo semelhante, mas para tornar ailustração mais simples, apenas o registrador de rastreios seráilustrado como registrando dados de rastreio em duas localizações.

Como Utilizar uma Rotina de Tratamento RemotaO comando a seguir permite conectar uma rotina de tratamentoremota:wcmd log trace <yourTraceLogger>

-set handlerNames=<orbName/yourHandler>

Por exemplo:wcmd log trace log.managerTrace

-set handlerNames=rshah1.dev.tivoli.com_9990/trcFile

Você pode utilizar o comando a seguir para determinar os nomes detodos os ORBs em seu espaço de nome:wcmd info getOrbs

Configuração de Formatadores e FiltrosA lista a seguir contém definições de configuração de filtros. Estesfiltros são fornecidos pelo JLog e são utilizados pelo Tivoli KernelServices:

AllMaskFilterUm registro de log poderá atravessar este filtrosomente se todos os bits do tipo de registroestiverem incluídos na máscara do filtro.

AnyMaskFilterUm registro de log poderá atravessar este filtro sequalquer um dos bits do tipo de registro estiverincluído na máscara do filtro. Este é o filtro padrãoutilizado pelo Tivoli Kernel Services.

ExcludeMaskFilterUm registro de log não poderá atravessar este filtro


2.Log

eR

astreio

se qualquer um dos bits do tipo de registro estiverincluído na máscara do filtro. Isso pode ser aplicadoa um registrador ou a uma rotina de tratamento paraevitar o processamento de registros de log comdeterminados tipos de registro.

msgFilter Permite que qualquer mensagem atravesse o filtro.

Este é um AnyMaskFilter com um tipo de máscaraTYPE_DEFAULT_MESSAGE, que incluiTYPE_INFO, TYPE_WARN, TYPE_ERR eTYPE_FATAL.

trcFilter Permite a passagem das entradas de rastreio padrão.

Este é um AnyMaskFilter com um tipo de máscaraTYPE_DEFAULT_TRACE. Consulte Tabela 1 napágina 15 para determinar quais tipos de rastreioestão incluídos.

Definindo Seu Próprio FiltroSe você não desejar utilizar o filtro de rastreio padrãotrcFilter , seránecessário configurar seu filtro personalizado:

1. Crie um nó para o filtro e especifique as propriedades que sãonecessárias para um filtro, utilizando o comandowcmd cfg put.As propriedades a seguir são necessárias para configurar umJLog AnyMaskFilter.wcmd cfg put /com/tivoli/util/logging/filter/<nome escolhido>

className=com.ibm.logging.AnyMaskFilter

mask=

Por exemplo:wcmd cfg put /com/tivoli/util/logging/filter/directoryFilterclassName=com.ibm.logging.AnyMaskFiltermask=DEFAULT_TRACE_MASK TYPE_PERF

2. O directoryFilter também permite rastrear pontos de rastreio dedesempenho. Você pode verificar se as propriedades corretasforam definidas, utilizando o seguinte comando:wcmd filter directoryFilter -contents

30 Versão 1.2

Conectando um Filtro ao RegistradorPara conectar o filtro a um registrador, utilize a seguinte sintaxe decomando:wcmd log trace <-g grupo ou apenas um único componente>

-set filterNames=<contêiner utilizado acima>

Por exemplo:wcmd log trace -g directory -set filterNames=directoryFilter

Definindo Seu Próprio FormatadorSe você não desejar utilizar o formatador máximo ou mínimodefinido pelo Tivoli Kernel Services, será necessário configurar oformatador personalizado seguindo este procedimento:

1. Crie um nó para o formatador e especifique as propriedades quesão necessárias para um formatador, utilizando o comandowcmdcfg put. As propriedades a seguir são necessárias para configurarum formatador:wcmd cfg put /com/tivoli/util/logging/formatter/<nome escolhido>className=com.tivoli.util.logging.MessageFormatter

wcmd cfg put /com/tivoli/util/logging/formatter/directoryformatterclassName=com.tivoli.util.logging.MessageFormatterseparator=$

logServer=true

2. Verifique se você definiu todas as propriedades corretamente,utilizando o seguinte:wcmd log formatter directoryformatter -contents

Consulte as informações no comandowcmd log formatter no TivoliKernel Services Command Referencepara obter uma lista de opçõese chaves possíveis para o formatador.

Alterando a Localização do Arquivo de LogÉ possível alterar a localização do diretório de log, de $ORBDIR/logpara qualquer outra localização desejada.

1. Você precisa editar o LOCKCfg.properties em$ORBDIR/bin/interp.


2.Log

eR

astreio

2. Altere o LOGDIR para o local onde você deseja armazenar oslogs.

3. Encerre e reinicie o ORB para que esta alteração seja efetivada.

Ligação Atrasada de MensagensO DistributedLogManager permitirá ligação atrasada das mensagens.O subsistema log passa registros entre os registradores e as rotinasde tratamento. Os registros contêm o nome do arquivo de mensagensde base e a chave da mensagem. A ligação real da mensagemacontece durante a formatação da mensagem. A ligação ocorre ondea rotina de tratamento reside. Portanto, a mensagem é gerada nalocalidade da rotina de tratamento.

A Figura 7 mostra um exemplo de geração de uma mensagem emuma localidade diferente de onde ela foi registrada. Na figura:

1. Um componente na região Nova York emite uma mensagem delog destinada a um arquivo ou console na região Paris.

Figura 7. Ligação de mensagens

32 Versão 1.2

2. O registrador na região Nova York recebe o pedido e o ORB deNova York envia a mensagem para a rotina de tratamento e oformatador em Paris.

3. O formatador em Paris procura uma cópia local de um arquivode propriedade com as mensagens francesas. Se encontrar uma, amensagem será direcionada para o console de log ou arquivo delog Paris.

Se um arquivo de propriedade local (locale(fr)) não for encontrado(o idioma francês deverá ser selecionado durante a instalação paraque esta localidade seja criada), o carregador de classe do ORB Parisenviará um pedido para o depósito de instalação (que, nesteexemplo, existente no nó do ORB Nova York) para enviar o arquivode propriedade de mensagens em francês para o depósito deimplementação no nó Francês onde as mensagens são armazenadasem cache e acessadas pelo formatador de mensagens. A mensagem éextraída do arquivo em cache e é exibida no console de Paris ougravada no arquivo de log de Paris.

Serviço de LogServidores de log e uma rotina de tratamento de servidores podemser utilizados para eventos de rastreio e mensagem em batch em umservidor de log remoto, uma máquina que é geralmente dedicada aoprocessamento do tráfego de log. As rotinas de tratamento deservidores enfileiram eventos nos ORBs em que ocorrem e osenviam em batches para as máquinas remotas. O termo Serviço deLog refere-se ao ambiente no qual os registradores e as rotinas detratamento do servidor passam eventos em batch para outro servidorde log para serem processados.

O Tivoli Kernel Services possui a capacidade de distribuir seuServiço de Log. Você pode centralizar o log em um único operador.Ou, se sua instalação incluir uma localização de ramificação remota,que esteja geograficamente separada do depósito de instalação, éaconselhável ter um monitor de operador local para registrar asinformações. E certamente, à medida que a instalação cresce,


2.Log

eR

astreio

aumenta a necessidade de se ter múltiplos Serviços de Log. Vocêpode querer implementar várias ocorrências do Serviço de Log e ologServerHandler.

O Serviço de Log e o logServerHandler podem ser utilizados paracolocar mensagens de diferentes ORBs em um único log (remoto). ATivoli recomenda que as mensagens sejam colocadas em um únicolog (remoto). Os dados de rastreio não devem ser colocados nestelog, pois degradarão o desempenho do sistema. Você deve utilizar oslogs locais para coletar os dados de rastreio. Por padrão, os logs demensagens do Tivoli Kernel Services são gravados no console e noarquivo local message1.log. Cada ORB deve utilizar umlogServerHandler local para enviar mensagens para um Serviço deLog. Por padrão, o logServerHandler enfileira 10 registros de log nolado local e, depois, os envia para um Servidor de Log remoto. Estarotina de tratamento fornece um tratamento de erros para exceçõesremotas. As exceções remotas podem ocorrer pelas seguintes razões:

¶ A rede está inativa.

¶ O ORB está inativo.

¶ O Serviço de Log está inativo.

Quando ocorrer uma exceção remota, o logServerHandler gravará emum arquivo serializado local até que possa gravar novamente em umServiço de Log.

Quando Utilizar o Serviço de LogVocê deve utilizar o Serviço de Log nestas situações:

¶ Se for desejável ter todas as mensagens de log coletadas em umbanco de dados de log. Por exemplo, se você desejar manter umregistro de todas as mensagens de todos os ORBs no sistema emum único lugar, então o Serviço de Log deverá ser utilizado.

¶ Dependendo do tamanho da sua instalação e de quantasmensagens são produzidas, pode ser necessária a implementaçãode várias ocorrências do Serviço de Log.

34 Versão 1.2

Como Utilizar um Único Serviço de LogPor padrão, o Serviço de Log é iniciado no depósito de instalação.Você pode verificar isso procurando uma mensagem semelhante àseguinte:14:32:13.681 FNGCP0031I Iniciado log de componente

versão 5.1.1-200010142257

Você pode configurar todos os ORBs para enviar a saída para oServiço de Log, utilizando os seguintes comandos de log. Porexemplo, configure o registrador de mensagens padrão para gravarmensagens em um logServerHandler local. Este logServerHandlerserá conectado ao Serviço de Log. O comando a seguir configura asaída de todos os registradores de mensagens em todos os ORBs aserem enviados ao console, um arquivo local denominadomessage1.log e o Serviço de Log. Este é um comando muitopoderoso, pois afetará cada ORB. Seja cuidadoso quando utilizar-r.allorbs. Lembre-se de que você precisará da funçãologConfigurepara executar este comando:wcmd log message -r .allorbs

-set handlerNames=console,msgFile,logServerHandler

Se você tiver um banco de dados de log instalado, poderá direcionartoda a saída de um servidor de log para o banco de dados, utilizandoo seguinte comando. Este comando deve ser emitido para o ORBonde o Serviço de Log está sendo executado. Observe que estamosutilizando uma rotina de tratamento log.dbDelete porque queremoster a possibilidade de excluir os logs a cada sete dias.wcmd log message log.serverLogger -set handlerNames=log.dbDelete

Você pode verificar se os dados estão no banco de dados, utilizandoo visualizador de logs do Tivoli Console ou conectando-se ao bancode dados e emitindo o comando a seguir.Select texto_da_mensagem from fng_logdata

Quando Utilizar Múltiplos Serviços de LogUm único Serviço de Log poderia ser suficiente para pequenasinstalações com, talvez, aproximadamente uma centena deservidores. No entanto, não seria possível escalar para um sistemamaior. Nesse caso, você precisa implementar múltiplas ocorrências


2.Log

eR

astreio

do Serviço de Log. Os múltiplos Serviços de Log podem enviar suasaída para um único banco de dados de log, conforme mostrado naFigura 8.

Como Implementar Outro Serviço de LogSiga estas etapas para implementar um segundo Serviço de Log:

1. Você pode implementar o Serviço de Log somente a partir doORB do depósito de instalação. Portanto, se você estivertentando instalá-lo em um ORB de bootprint, será necessário

Figura 8. Utilizando múltiplos Serviços de Log

36 Versão 1.2

saber o nome do ORB do depósito de instalação. Emita estecomando no ORB de bootprint para obter uma lista de todos osORBs:wcmd info getOrbs

2. Para determinar a versão do Serviço de Log que precisa serimplementado, direcione o seguinte comando para o ORB dodepósito de instalação:wcmd -i <idOrbName> svc ls LSM

3. Implemente o Serviço de Log no ORB de bootprint a partir doORB do depósito de instalação. Utilize a versão que vocêdeterminou na etapa 2 e que é representada porv.r.m nocomando:wcmd -i <idOrbName> cds deploy [email protected] <bootprintORBname>

4. Inicie o Serviço de Log no ORB de bootprint utilizando estecomando, substituindo a versão apropriada parav.r.m nocomando:wcmd accmgr startService -s logging -v v.r.m

5. Verifique se o serviço foi iniciado no ORB de bootprint:wcmd svc ls LSM

6. Você precisa configurar o banco de dados de log, de acordo comas instruções em “Criando um Banco de Dados de Log AdicionalApós a Instalação” na página 40.

7. Em seguida, conecte a rotina de tratamento do banco de dados aoregistrador de mensagens associado ao Serviço de Log:wcmd log message log.serverLogger -set handlerNames=log.dbDelete

Como Configurar um logServerHandler para Utilizarum Serviço de Log Específico

Por padrão, o logServerHandler obtém o Serviço de Log a partir doService Manager. No entanto, quando há múltiplas ocorrências deum Serviço de Log, podemos especificar explicitamente qualconjunto de ORBs utilizará qual Serviço de Log. Você precisaexecutar as etapas a seguir para criar um conjunto de ORBs e, emseguida, especificar qual Serviço de Log ele utilizará.


2.Log

eR

astreio

1. Identifique os ORBs que precisam utilizar um Serviço de Logespecífico. Crie um conjunto de ORBs que inclua esses ORBs.Você pode executar este comando no ORB de bootprint:wcmd info crtorbset loggingset

2. Você pode obter os nomes e OIDs de todos os ORBs, utilizandoo seguinte comando:wcmd info getOrbs -oid

3. Você precisa especificar oorbName para ologgingServerOrb.wcmd log handler -r loggingset logServerHandler-set loggingServerOrb=<orbName>

4. Adicione os ORBs a este conjunto de ORBs. Por exemplo:wcmd info joinOrbset <orbset> <orb>

Onde<orb> pode ser o nome do ORB.

Como Encadear os Serviços de LogPara encadear os Serviços de Log, é preciso conectar ologServerHandler ao log.serverLogger de um Servidor de Log denível 1, e assim por diante, conforme mostrado na Figura 9 napágina 39.

1. Conecte o logServerHandler ao registrador de mensagens doServiço de Log de Nível 1:

wcmd log message log.serverLogger -sethandlerNames=logServerHandler

2. Especifique oorbName do Serviço de Log de nível seguinte(Nível 2):

wcmd log handler -r loggingset logServerHandler -setloggingServerOrb=<orbName>

38 Versão 1.2

Figura 9. Encadeando os Serviços de Log


2.Log

eR

astreio

Criando um Banco de Dados de Log Adicional Apósa Instalação

Se você pretende utilizar um banco de dados de log adicional, comoo banco de dados de auditoria de segurança, é preciso criar einicializá-lo. Se você utilizou o script tdacl.bat, ou o script tdacl.sh, eassumiu os valores padrão, um banco de dados de log denominadologging e um banco de dados de auditoria de segurança denominadosecauditforam criados automaticamente. O Tivoli Kernel Servicessuporta a utilização de múltiplos bancos de dados de log. Você podeutilizar o script tdacl para criar um segundo ou terceiro banco dedados de log.

Para criar um outro banco de dados de log, utilize o procedimento aseguir para executar o script tdacl:

1. Inicie sessão na máquina do servidor de banco de dados DB2utilizando o seu ID de usuário e senha do DB2.

2. Abra uma janela de comando do DB2.

3. Altere para o diretórioutil no CD-ROM de instalação.

4. Modifique o script tdacl da seguinte maneira:

DB2:

Altere a entrada LOG_DATABASE para o nome do novo bancode dados.

Oracle:

Altere a entrada LOG_USER para o nome do novo banco dedados.

5. Execute o script tdacl para criar o banco de dados de log.

Nota: Certifique-se de responder″no″ para todas as perguntasfeitas pelo script tdacl. Para obter mais informações sobreo tdacl, consulteInstalando o Tivoli Kernel Services.

Se aparecer uma mensagem de erro informando que você não possuiautoridade para executar a ação solicitada, inicie sessão utilizandoum ID de usuário e uma senha do DB2 com a autoridade apropriadae, em seguida, repita o script tdacl.

40 Versão 1.2

Utilizando Secaudit ou Outro Banco de Dados deLog

Esta seção descreve como configurar a rotina de tratamento do logpara que funcione com o servidor Tivoli DAS (Data AccessServices). Antes de utilizar este procedimento, você precisa tercriado um outro banco de dados de log, secaudit ou outro,executando o script tdacl.

Siga estas instruções antes de configurar uma rotina de tratamento dobanco de dados utilizando as tarefas do Tivoli Console; casocontrário, você receberá um erro e as tarefas não funcionarãocorretamente. Observe que o arquivo vault deve ser criado nomesmo ORB a partir do qual o registro será feito. Por exemplo, pararegistrar a partir do Tivoli Console em execução na máquina dodepósito de instalação, você deve criar o arquivo vault no orb.2.

Para criar um alias para o banco de dados do Tivoli DAS (DataAccess Services), execute o seguinte procedimento:

1. Encerre os ORBs.wcmd orb shutdown

2. Encerre o servidor Tivoli DAS (Data Access Services). ConsulteInstalando o Tivoli Kernel Servicespara obter informações sobrecomo parar o servidor Tivoli DAS.

3. Vá para a localização na máquina do servidor Tivoli DAS onde osoftware do servidor Tivoli DAS foi instalado.

4. Modifique o arquivo tivsql.cfg conforme a seguir, e substituanome do banco de dadospelo nome do banco de dados para oqual você deseja criar um alias:

¶ DB2

[nome do banco de dados]

DEFAULT=FALSE

DB=nome do banco de dados

DRV=DB2CLI

SRVR=nome do banco de dados


2.Log

eR

astreio

QUAL=db2admin

DBMS=DB2/2

¶ Oracle

[nome do banco de dados]

DEFAULT=FALSE

DB=nome da ocorrência do banco de dados

DRV=XOOR

SRVR=nome da ocorrência do banco de dados

QUAL=nome do banco de dados

DBMS=ORACLE

5. Modifique o arquivo dasOrbCfg.tks da seguinte maneira:

¶ Adicione o nome da origem de dados do Tivoli DAS à linhade origem de dados existente.DAServer.datasources=slash,tmd,ps,nome do banco de dados

¶ Adicione as seguintes linhas ao final do arquivo, substituindonome do banco de dadospelo nome da origem de dados doTivoli DAS:DAServer.datasource.nome do banco de dados.use_xa=noDAServer.datasource.nome do banco de dados.threadpool=20DAServer.datasource.nome do banco de dados.queue_size=102

6. Reinicie o servidor Tivoli DAS. ConsulteInstalando o TivoliKernel Servicespara obter informações sobre como reiniciar oservidor Tivoli DAS.

7. Crie o arquivo vault para o novo banco de dados de log,digitando o comandowcmd dir setdbinfo no depósito deinstalação. Quando o comando solicitar o novo alias do banco dedados de log, certifique-se de que as entradas correspondam demodo idêntico (incluindo maiúsculas e minúsculas) aos valoresadicionados ao arquivo de configuração do Tivoli DAS.

Este comando permite criar um banco de dados especificamentepara o Serviço de Log, um banco de dados de auditoria desegurança ou um banco de dados de log geral. Você tambémpode executar este comando em todos os ORBs onde uma rotina

42 Versão 1.2

de tratamento de banco de dados pode ser configurada. Porexemplo, para executar este comando no ORB 1, você digitaria:wcmd dir setdbinfo -o 9990

Para executar este comando no ORB 2, você digitaria:wcmd dir setdbinfo -o 9991

O comandowcmd dir setdbinfo deve ser executado no ORB apartir do qual o registro será feito. Por exemplo, se o registroestiver sendo feito no Tivoli Console em execução no depósitode instalação, certifique-se de emitir esse comando no ORB 2.

SelecioneArmazenamento de dados de auditoria desegurançapara criar um banco de dados de auditoria desegurança com um arquivo vault padrãosecAuditVault. Casocontrário, selecioneOutro e digite seu próprio nome para oarquivo vault, quando solicitado.

Depois de selecionar o tipo de armazenamento de dados,responda aos demais prompts:

¶ Digite o nome completo do servidor Tivoli DAS quando onome do servidor de banco de dados for solicitado.

¶ Especifique o número da porta a ser utilizada, se não for aporta padrão 8001, caso contrário apenas pressione Enter.

¶ Defina o alias do banco de dados para o nome da origem dedados do Tivoli DAS.

Nota: O alias do banco de dados utiliza a distinção entremaiúsculas e minúsculas e deve ser especificadoexatamente como foi definido no arquivodasDsnCfg.tks.

¶ Digite o seu ID de usuário e senha do DB2 ou Oracle.

¶ Confirme se você está utilizando o driver de banco de dadospadrão com.tivoli.das.jdbc.daDriver e pressioneEnter.

8. Se você criou um banco de dados de log geral, deverá mapear oarquivo vault para a rotina de tratamento de log específica. (Este


2.Log

eR

astreio

mapeamento ocorre automaticamente para o banco de dados deauditoria de segurança.) Mapeie o arquivo vault para a rotina detratamento de log, emitindo o seguinte comando, em uma únicalinha, e especificando a rotina de tratamento de log e o arquivovault: wcmd log handler <databaseHandlerName> -setvault=<vaultFileName>

9. Verifique a conexão do banco de dados para a rotina detratamento nomeada, utilizando o seguinte comando:

wcmd log dbtest -l <dbhandler_name> [-p]

ondedbhandler_nameé o nome da rotina de tratamento a sertestada e[-p] exibe um caminho de rastreio de pilha.

Detecção de Problemas de LogUma importante ferramenta de detecção de problemas é a capacidadede utilizar os logs de rastreios para registrar ações do sistema nonível de código. Como o rastreio fica, por padrão, desativado, eledeve ser ativado para cada componente sobre o qual você desejareunir informações. “Detecção de Problemas em Componentes” napágina 111 lista e descreve os registradores de rastreios para cadacomponente do sistema. Contém também as etapas necessárias paraativar e desativar um registrador de rastreios individual.

Se você estiver tendo problemas com o próprio componente de log,há vários rastreios e outros registradores que podem ser utilizadospara descobrir a origem do problema.

Rastreio de BootstrapO que você faz se o ORB não aparecer e você não vir quaisquerlogs denominados message1.log no $ORBDIR/log? Você pode ativaro que é denominado rastreio debootstrap, ou rastrear a primeiraseqüência de inicialização:

1. Edite o LOCKCfg.properties em $ORBDIR/bin/interp.

2. Adicione a seguinte propriedade aoJVMARGS :

-Dcom.tivoli.util.logging.bootTrace=true

3. A mensagem e o rastreio serão direcionados para o arquivobootstrap.log no diretório $ORBDIR/log.

44 Versão 1.2

4. Encerre e reinicie o ORB para que as alterações sejamefetivadas. ConsulteTivoli Kernel Services Command Referencepara obter informações sobre comandos para parar e reiniciarORBs.

Rastreios Adicionais de Serviço de LogHá três outros registradores de rastreios para o Serviço de Log.

¶ log.managerTracerastreia o gerenciador de logs local edistribuído. Utiliza TYPE_PERF, TYPE_MISC_DATA,TYPE_ENTRY e TYPE_EXIT para reunir as informações do logde rastreios.

¶ log.serverHandlerTracerastreia todas as chamadas da rotina detratamento do servidor. Utiliza os tipos de rastreioTYPE_MISC_DATA,TYPE_ENTRY e TYPE_EXIT para reunirinformações do log de rastreios.

¶ log.dbHandlerTracerastreia todas as chamadas através da rotinade tratamento do banco de dados e os utilitários de exclusão dobanco de dados. Utiliza os tipos de rastreio TYPE_MISC_DATA,TYPE_ENTRY e TYPE_EXIT para reunir informações do log derastreios.

Mensagens de ErroAs mensagens do Serviço de Log iniciam com um códigoFNGLG.Cada mensagem de erro contém ajuda detalhada que pode seracessada por meio do Tivoli Console. Consulte “Padrão deMensagens Tivoli” na página 161 para obter mais informações sobrecomo acessar a ajuda de mensagens de erro do Tivoli. As etapas dedetecção de problemas detalhadas para cada mensagem de erro nãosão descritas, apenas o agrupamento geral das mensagens de erro.Segue uma análise mais detalhada das mensagens do Serviço deLog:

¶ FNGLG00 - Gerenciador de logs local.

¶ FNGLG01 - Gerenciador de logs distribuído. O problema maiscomum com o gerenciador de logs distribuído é que o usuáriopossui privilégios insuficientes para acessar ou modificar os nósde preferência do Log.


2.Log

eR

astreio

¶ FNGLG02 - Rotina de tratamento do banco de dados. Oproblema mais comum da rotina de tratamento do banco dedados é a configuração incorreta.

¶ FNGLG03 - Rotina de tratamento do servidor. O problema maiscomum com a rotina de tratamento do servidor é que o Serviçode Log não é executado.

Convertendo Arquivos de Log Serializados emArquivos ASCII

O Tivoli Kernel Services armazena alguns arquivos de log comoarquivos serializados. Esses arquivos serializados contêminformações de log diferentes das do arquivo de log de mensagenspadrão. Os arquivos serializados contêm objetos que são convertidosem um fluxo de bytes que podem mais tarde ser desserializadosnovamente para um arquivo de texto no formato ASCII. Essesarquivos serializados podem ser exibidos no Tivoli Console. Paraconverter esses arquivos, o Tivoli Kernel Services fornece umarquivo batch e um script de shell.

Configurando o AmbientePara utilizar esta ferramenta, configure o ambiente da seguintemaneira:

1. Certifique-se de que o arquivo JAR, necessário para converter oslogs, esteja definido como uma variável de ambiente. Estavariável, JARDIR, precisa ser definida para o seguinte caminho:

Windows C:\Tivoli\orb.1\cd, onde C:\Tivoli representa odiretório onde você instalou o Tivoli KernelServices.

UNIX /Tivoli/orb.1/cd, onde /Tivoli representa odiretório onde você instalou o Tivoli KernelServices. Isso permite que [email protected] sejautilizado para converter os arquivos.

2. Execute o setupEnv.sh em sistemas UNIX, ou o setupenv.bat emsistemas Windows, no ORB que contém os logs a seremconvertidos.

46 Versão 1.2

3. Se você estiver convertendo logs de mensagens serializados,todos os pacotes de recursos desses logs de mensagens deverãoestar em seu CLASSPATH.

Nota: Os pacotes de recursos requeridos pelo Tivoli KernelServices já estão no CLASSPATH. Para processar os logsgerados por um aplicativo Tivoli, pode ser necessárioadicionar os pacotes de recursos apropriados aoCLASSPATH.

4. Mova o arquivo batch ou script de shell para o mesmo diretóriodo arquivo que está sendo convertido.

O script de shell convertSerialLog está localizado no seguintediretório:

Windows <Tivolidirectory>\orb.1\bin\w32-ix86

UNIX <Tivolidirectory>/orb.1/bin/generic

onde<Tivolidirectory> é o diretório no qual o Tivoli KernelServices foi instalado.

Os arquivos de log serializados estão localizados, por padrão, nodiretório orb.n/log.

Convertendo os ArquivosApós a configuração do ambiente, você pode converter os arquivos,digitando o seguinte comando em uma única linha:

convertSerialLog <nome base dos arquivos de logserializados> <arquivo ASCII de saída>

Por exemplo, para converter os seguintes arquivos de logserializados e colocar o resultado no arquivo ASCII output.txt:

GlobalSerialMsg1.log GlobalSerialMsg2.log . .GlobalSerialMsgN.log

digite o seguinte comando:

convertSerialLog GlobalSerialMsg.log output.txt


2.Log

eR

astreio

Observe que você só especifica onome basedos arquivos de logserializados no comando. Omita o número de log serial (o númeroanexo ao nome base.)

48 Versão 1.2

Detecção de Problemas naInstalação

A instalação do Tivoli Kernel Services, e dos bancos de dadosassociados, e de outros serviços é explicada emInstalando o TivoliKernel Services. O processo de instalação completo é constituído detrês partes: instalação do banco de dados, instalação do depósito deinstalação e instalação de bootprint. Esses processos são iniciadospela intervenção do usuário, executando o install.bat na máquinaMicrosoft® Windows ou ./install.sh em máquinas UNIX. Há váriospontos durante a instalação dos bancos de dados, depósito deinstalação ou instalação de bootprint em que podem ser encontradosproblemas. Este capítulo descreve como procurar e utilizar os logspadrão de instalação, e como detectar problemas no DB2, servidorTivoli DAS, servidor MQSeries, depósito de instalação e instalaçãode bootprint.

Logs de InstalaçãoA primeira etapa na detecção de problemas durante a instalação éreler os logs de instalação. O Tivoli Kernel Services cria doisarquivos durante a instalação:

¶ tksOut.log: contém mensagens de saída do fluxo de “SaídaPadrão”; mostra a saída do processo de instalação e o que estásendo feito.

3


3.D

etecçãode

Problem

asna

Instalação

¶ tksErr.log: contém quaisquer mensagens de erro possíveis, ofluxo de “Erro Padrão”; mostra os erros padrão de diferentesclasses Java que são chamadas dentro da instalação do depósitode instalação.

Estes dois arquivos são criados em um diretóriotemp, conformemostrado a seguir:

¶ AIX: /tmp.

¶ Sun Solaris: /var/tmp.

¶ Windows NT: C:\temp.

¶ Windows 2000: C:\Documentos e Configurações\<ID dousuário>\Configurações Locais\Temp.

Um administrador de sistema pode alterar a localização do diretóriotemp.

Toda vez que uma instalação é executada, o tksOut.log e o tksErr.logsão recriados; os arquivos anteriores são removidos e novas versõescontendo informações sobre a instalação atual são criados. O log deinstalação utiliza os arquivos individuais para cada fluxo de saída; asentradas de log não são separadas em categorias de log de rastreiosou mensagens. Não há parâmetros configuráveis para o log deinstalação. O Tivoli DAS, o script tdacl, o MQSeries e os servidoresIBM HTTP possuem seus próprios logs de instalação, o que podeoferecer algumas informações adicionais que não estão contidas noslogs de instalação do Tivoli Kernel Services. Para obter maisinformações sobre o log, consulte “Log e Rastreio” na página 11. Atabela a seguir lista todos os logs de instalação do Tivoli KernelServices.

50 Versão 1.2

Tabela 2. Logs de instalação do Tivoli Kernel ServicesArquivo Microsoft Windows UNIX

Log de saídado programa deinstalação

NT:%TEMP%\tksOut.log

2000:\Documentos eConfigurações\id dousuário\ConfiguraçõesLocais\Temp\tksOut.log

/var/tmp/tksOut.log

Log de errosdo programa deinstalação

NT:%TEMP%\tksErr.log

2000:\Documentos eConfigurações\id dousuário\ConfiguraçõesLocais\Temp\tksErr.log

/var/tmp/tksOut.log

Log deinstalação doservidorMQSeries

MQ_BASEDIR\ext\mqm\tksSi\ tksInstall.log

AIX: /usr/mqm/tksSi/tksInstall.log

Solaris:/opt/mqm/tksSi/tksInstall.log

tdacl log %TEMP%/tdacl.log %TEMP%\tdacl.log

Log deinstalação doservidor TivoliDAS

DAS_BASEDIR\ext\das\server\tksSi\ tksInstall.log

DAS_BASEDIR/ext/das/server/tksSi/ tksInstall.log

Log deinstalação doservidor IBMHTTP

TKS_BASEDIR\ext\ibmhttpd\ tksSi\tksInstall.log

TKS_BASEDIR/ext/ibmhttpd/ tksSi/tksInstall.log

Detecção de Problemas na Instalação do DB2O Tivoli Kernel Services utiliza atualmente o DB2 6.1 com oFixPack6, e o 7.1 com o FixPack2, para três bancos de dadosobrigatórios e dois opcionais. Esses bancos de dados são criadosutilizando o script tdacl. Este script está localizado no diretório utilna mídia de instalação, com um tdacl.sh para sistemas UNIX e umtdacl.bat para sistemas Windows. Este script deve ser executado noservidor DB2 e você deve iniciar sessão como um usuário do DB2para que seja possível criar os bancos de dados. No UNIX, você


3.D

etecçãode

Problem

asna

Instalação

também terá que obter o db2profile para definir o ambiente DB2; odb2profile está localizado em /<diretório pessoal do db2user>/sqllib.No Windows 2000 ou NT, utilize uma janela de comando do DB2em vez de uma janela de comando comum para certificar-se de queo ambiente DB2 esteja definido. O script tdacl não funcionarácorretamente se o ambiente DB2 não for obtido. Consulte Tabela 2na página 51 para obter informações sobre o log tdacl. Informaçõesadicionais sobre a instalação do DB2 e tdacl podem ser encontradasem Instalando o Tivoli Kernel Services.

Quando instalar o DB2, certifique-se de que exista espaço suficienteem disco. Aproximadamente 80-150 MB são necessários para osoftware, e 150 MB são necessários para os dados armazenados nodiretório pessoal do usuário do DB2 no UNIX ou no diretório deinstalação do DB2 no NT. Na instalação do DB2 no AIX, um erroAIX IPC impacta a utilização de memória compartilhada pelo DB2.Para o AIX 4.3.3.0, há uma limitação de doze (12) segmentos dememória compartilhada por processo. Esta limitação foi corrigida noAIX 4.3.3.16. Uma alternativa para este problema é catalogar todosos bancos de dados localmente, para que o DB2 utilize o TCP emvez da memória compartilhada para se comunicar com eles. Consulte“Servidor Tivoli DAS - DB2” na página 78 para obter maisinformações sobre como configurar o DB2 para utilizar o TCP/IP.Quando instalar o DB2 em uma máquina Sun Solaris, é muitoimportante ajustar o kernel corretamente para que o Tivoli KernelServices funcione. Consulte a documentação de instalação do DB2para obter todos os parâmetros de kernel. Além dos parâmetrosespecificados na documentação do DB2, definasemsys:seminfo_semume 50.

Após a instalação bem-sucedida do DB2 e o início da instalação doproduto, um conjunto de validações testa e relata falhas deconectividade do banco de dados, nomes de host, números de porta eoutros. Ele só permitirá que o processo de instalação continue se osbancos de dados forem instalados com êxito e for possívelconectar-se a eles. O conjunto de validações gera um rastreio depilha no tskOut.log e tksErr.log quando há um erro de validação. Seo código de validação falhar ao procurar/conectar-se a um banco dedados, algumas causas comuns são:

52 Versão 1.2

¶ O ID do usuário e a senha do DB2 estão incorretos.

¶ O banco de dados DB2 não foi criado ou o nome foi digitadoincorretamente.

¶ O banco de dados DB2 não está sendo executado ou não estáinstalado na máquina.

¶ O perfil do DB2 não foi executado no UNIX.

¶ O script tdacl não foi executado.

Detecção de Problemas na Instalação do ServidorTivoli DAS - DB2

O servidor Tivoli DAS (Data Access Services) é instalado para que oTivoli Kernel Service possa suportar diferentes fornecedores debanco de dados e um cliente do banco de dados não precise serinstalado em cada máquina ORB do ID. Ele deve ser instalado namesma máquina do servidor DB2. O servidor Tivoli DAS é instaladodurante a instalação do Tivoli Kernel Services, cujos detalhes podemser encontrados emInstalando o Tivoli Kernel Services. O programade instalação valida que a localização do sistema de arquivosescolhida para o servidor Tivoli DAS tenha pelo menos 20 MB deespaço; ele retornará um erro se o sistema de arquivos não tiver essaquantidade de espaço livre. Se você pretende instalar o servidorTivoli DAS em um sistema Sun Solaris, a classe da máquina deveráser Sun Ultra. Caso contrário, o servidor Tivoli DAS poderáencontrar erros ao trabalhar com sockets seguros.

A instalação do servidor Tivoli DAS pode falhar por várias razões.Uma causa comum é que o sistema não pode localizar a versãocorreta de db2java.zip. Este arquivo contém informações de variáveise configuração necessárias para uma instalação bem-sucedida doservidor Tivoli DAS. Se você estiver instalando o servidor TivoliDAS em uma máquina AIX ou Solaris, certifique-se de obter odb2profile. Se você estiver instalando o servidor Tivoli DAS em umamáquina Windows NT ou 2000, certifique-se de que o caminho deambiente inclua <DB2DIR>/SQLLIB/BIN para definir as variáveisde sistema necessárias, antes de determinar a instalação do servidorTivoli DAS.


3.D

etecçãode

Problem

asna

Instalação

Uma outra causa comum da falha de instalação do servidor TivoliDAS é executar o script tdacl durante o processo de instalação doservidor Tivoli DAS. Isso causará a falha do script tdacl e tambémcausará a falha dos trabalhos de instalação subseqüentes.Certifique-se de que o tdacl tenha concluído sua execução, antes deinstalar o servidor Tivoli DAS.

E por último, o script tdacl pode ficar obstruído, fazendo com que ainstalação do Tivoli DAS falhe ao se comunicar com os bancos dedados do sistema. O script pode ficar obstruído devido a:

¶ Não obtenção do perfil DB2 no UNIX.

¶ Não execução do script a partir da janela de comandos do DB2.

¶ Utilização de ID de usuário e senha incorretos para o DB2.

¶ DB2 não iniciado.

¶ Certifique-se de que seja possível conectar-se aos bancos dedados manualmente, utilizando a janela de comando do DB2.

Detecção de Problemas na Instalação do ServidorMQSeries

O servidor MQSeries é instalado para que os aplicativos possampublicar/associar-se, assincronicamente, às mensagens utilizando oJMS (Java Message Service). O Tivoli Kernel Services oferece umaopção para instalar o MQSeries e configurá-lo através da criação deum gerenciador de filas com uma convenção de nomenclatura padrãoQM-<nome completo do host>. Certifique-se sempre de que o nomecompleto do host seja utilizado para o servidor MQSeries durante ainstalação. Em algumas plataformas de sistema operacional, a nãoutilização de um nome completo faz com que o Tivoli KernelServices não consiga se conectar ao servidor MQSeries.

Se o seu arquivo de host for definido para retornar um nome curtoem vez de um nome completo, isso criará um problema com ainstalação do MQSeries e com os componentes do Tivoli KernelServices em geral. Os componentes do Tivoli Kernel Servicesesperam que o ORB sempre utilize os nomes completos de host.

54 Versão 1.2

Algumas máquinas podem ser configuradas para retornar um nomecurto de host, comokendall em vez de um nome completo de host,comokendall.myorg.mycompany.com.

Para assegurar que o sistema operacional seja configurado pararetornar um nome completo de host, execute as etapas a seguir combase no tipo de sistema operacional:

Solaris

Verifique se o arquivo /etc/resolv.conf existe e se contém asinformações apropriadas, tais como:

domain myorg.mycompany.com

nameserver 123.123.123.123

Um nome curto de host será utilizado se o arquivo /etc/nsswitch.conftiver uma linha que inicie com:

hosts: files

e o arquivo /etc/hosts tiver o nome curto da máquina. Para corrigirisso:

1. Altere a linha no arquivo /etc/nsswitch.conf para:

hosts: dns nis files

2. Encerre o serviço inet:

/etc/init.d/inetsvc stop

3. Reinicie o serviço inet:

/etc/init.d/inetsvc start

4. Recicle o ORB para que capte a alteração.

Windows NT


3.D

etecçãode

Problem

asna

Instalação

Especifique um Sufixo de DNS Primário nas definições de rede(Iniciar -> Configurações -> Painel de Controle -> Rede ->Protocolos -> Propriedades...-> DNS). Reinicialize a máquina,quando solicitado.

Windows 2000

Há dois lugares onde o Sufixo de DNS Primário pode ser definido,na Identificação da Rede e nas propriedades do sistema. Paraconfirmar se o Sufixo de DNS Primário está definido corretamente:

1. Clique com o botão direito do mouse emMeu Computador eclique emPropriedades.

2. Clique na guiaIdentificação da Rede.

3. Confirme se o campoNome Completo do Computadorexibe onome completo do host.

Se este campo não tiver um nome completo de host:

4. Clique emPropriedadese, em seguida,Mais....

5. Digite as informações de domínio no campoSufixo de DNSprimário para este computador.

Reinicialize a máquina, quando solicitado.

AIX

A ordem de pesquisa de nome de domínio padrão é:

¶ BIND/DNS (nomeado)

¶ NIS (Network Information Service)

¶ Arquivo /etc/hosts local

Para assegurar-se de que o AIX sempre forneça um nome completode host:

1. Verifique se o arquivo /etc/resolv.conf existe e se contém asinformações apropriadas, tais como:

56 Versão 1.2

domain myorg.mycompany.com

nameserver 123.123.123.123

(Se o arquivo /etc/resolv.conf não existir, o arquivo /etc/hosts serásempre utilizado.)

2. Se o nis+ for instalado, o arquivo /etc/irs.conf substituirá ocomportamento padrão.

hosts = bind,local

3. O arquivo /etc/netsvc.conf, se existir, substitui o arquivo/etc/irs.conf, bem como o comportamento padrão do sistema.

settings in the /etc/irs.conf file

hosts = bind,local

4. Se a variável de ambiente NSORDER for definida, ela substituirátodas as mencionadas anteriormente.

export NSORDER=bind,local

5. Se apenas o arquivo /etc/hosts for utilizado, o nome completo dohost deverá ser o primeiro listado após o endereço IP.

A configuração da rede deve ser feita adequadamente para que ossistemas possam ser alcançados, utilizando o nome curto ou nomecompleto do host. Isso é importante principalmente em ambientes desistemas operacionais mistos.

Algumas causas adicionais das falhas de instalação do MQSeries sãoque, no Windows NT, você deve ter o Internet Explorer 4.01 ouposterior, e o Service Pack 1 ou posterior. Em máquinas Windows2000, se a tela for definida para uma resolução baixa (640x480),ocorrerão problemas com a instalação do MQSeries. Além disso, odiretório temporário deverá ter espaço suficiente para a própriaextração e execução da instalação; pelo menos 5 MB. O processo deinstalação do MQSeries Windows cria seus próprios logs deinstalação, um log resumido e um log detalhado. O log resumido


3.D

etecçãode

Problem

asna

Instalação

está localizado no C:\setup.log e o log detalhado está localizado naestrutura de diretórios onde o MQSeries está instalado, <Diretório doMQ>\data\amqilogn.txt. Consulte a Tabela 2 na página 51 para obteruma lista completa de todos os logs de instalação do Tivoli KernelServices.

Se você pretende instalar os servidores MQSeries e Tivoli DAS nomesmo sistema Sun Solaris, será necessário instalar o servidorMQSeries por último. Depois de instalar o servidor MQSeries,substitua o arquivo /etc/system pelo arquivo /etc/system.updated.1 ereinicialize o sistema.

Detecção de Problemas na Instalação do OracleQuando instalar bancos de dados Oracle, certifique-se de seguirexatamente as instruções emInstalando o Tivoli Kernel Services.Informações adicionais de detecção de problemas para produtosOracle podem ser encontradas no seguinte site da Web:

http://technet.oracle.com/doc/platforms.htm

A lista a seguir contém os itens de detecção de problemas no Oracle:

¶ Quando instalar bancos de dados Oracle em uma máquinaWindows NT ou 2000, a documentação do produto Oraclemencionará que a variável de ambiente ORACLE_HOMEnãodeve ser definida. No entanto, para instalar corretamente o TivoliKernel Services, esta variável deverá ser definida para o mesmovalor que possui no registro; esse valor deve ser o caminhocompleto para o diretório no qual o Oracle foi instalado. Se estavariável não estiver definida, a instalação não será concluídacom êxito.

¶ Quando utilizar o banco de dados Oracle para o servidor TivoliDAS, certifique-se de utilizar, durante a execução do script tdacl,um usuáriosyse uma senhasys.

58 Versão 1.2

Detecção de Problemas no Depósito de InstalaçãoA instalação do Tivoli Kernel Services contém duas partes: ainstalação do depósito de instalação e a instalação de bootprint.ConsulteInstalando o Tivoli Kernel Servicespara obter informaçõesde detecção de problemas sobre os seguintes erros de instalaçãocomuns:

¶ Especificação incorreta da porta do MQSeries, porta do servidorde banco de dados, nomes de banco de dados, administrador debanco de dados, ID de usuário ou senha.

¶ Início do console antes de os ORBs do depósito de instalaçãoestarem totalmente ativos.

A instalação do depósito de instalação se comunica com o DB2,servidor Tivoli DAS e servidores MQSeries para validar as funçõesde conectividade, senha e banco de dados. Portanto, os servidoresTivoli DAS e MQSeries precisam ser instalados e executados antesde o depósito de instalação ser instalado. O depósito de instalação éo repositório para todos os componentes do Tivoli Kernel Services.

Quando uma instalação do depósito de instalação falha, você deveprimeiro consultar o diretório temporário de cada sistemaoperacional. Este diretório pode ser a origem do problema. Se odiretório temporário ficar cheio durante o processo de instalação dodepósito de instalação, pode ocorrer uma falha. Esta falha pode serdescoberta pela leitura do arquivo tskOut.log e pela procura doserros relatados. Consulte “Logs de Instalação” na página 49 paraobter mais informações sobre os logs de instalação padrão.

Uma outra falha de instalação do depósito de instalação ocorre emsistemas UNIX quando o processo de instalação falha quase queimediatamente e executa um dump de núcleo. A instalação do TivoliKernel Services é baseada em Java, utilizando Swing para a GUI(interface gráfica com o usuário). Quando a intensidade de cor doX-window é definida para mais de 8 bits, a instalação pode parar eum dump de núcleo é executado. Reduza a intensidade de cor para 8bits e esse problema poderá ser evitado. Uma outra falha deinstalação inicial ocorre quando o comprimento da variável de


3.D

etecçãode

Problem

asna

Instalação

ambiente PATH excede o máximo permitido pelo sistemaoperacional. Se você encontrar este problema, reduza o tamanho davariável de ambiente PATH e, em seguida, reinicie o programa deinstalação.

Quando instalar o Tivoli Kernel Services em uma máquina MicrosoftWindows, recomenda-se utilizar uma unidade NTFS. A Tivolinãorecomenda instalar o Tivoli Kernel Services em um disco formatadocom o sistema de arquivos FAT devido ao grande número de váriosarquivos pequenos instalados.

Detecção de Problemas na Instalação de BootprintUma instalação de bootprint é a menor quantidade de componentesnecessários para criar um ORB atualizável para o Tivoli KernelServices. É possível registrar o bootprint para ser configurado emum grupo como os consoles Java, os nós de extremidade ou osserviços regulares. O bootprint possui os mesmos recursos de logque a instalação do depósito de instalação. Quando uma instalaçãode bootprint falha, você deve primeiro consultar o diretóriotemporário de cada sistema operacional. Este diretório pode ser aorigem do problema. Se o diretório temporário ficar cheio durante oprocesso de instalação de bootprint, poderá ocorrer uma falha. Estafalha pode ser descoberta pela leitura do arquivo tskOut.log e pelaprocura de erros relatados. Consulte “Logs de Instalação” napágina 49 para obter mais informações sobre os logs de instalaçãopadrão.

Se uma instalação de bootprint falhar, é possível que o bootprinttenha sido instalado em uma máquina Microsoft Windows que estejaexecutando aplicativos Winsock. O Winsock é o componente doWindows que direciona o tráfego da Internet através de TCP/IP. Taisprogramas incluem discadores personalizados, programas de padrãosocks e algumas soluções de VPN. A desativação desses aplicativosnão corrige necessariamente o problema. Recomenda-se que vocênão tente instalar um bootprint em uma máquina com esses tipos deprogramas instalados.

60 Versão 1.2

Uma outra causa para a falha de instalação de bootprint é uma falhade conexão. Durante a instalação de bootprint, o ORB de bootprintdeve conectar-se ao ORB do ID para obter um certificado. Aexceção recusada pela conexão pode ser causada pelos seguintesmotivos:

¶ O ORB do ID está inativo.

¶ O ORB do ID está sendo executado em uma porta diferente daporta padrão 9990.

¶ O nome do host do ORB do ID está incorreto.

¶ Há um firewall impedindo o fluxo dos dados na porta entre oORB do ID e o ORB de bootprint.

¶ A máquina do ORB do ID está utilizando DHCP, e o nome dohost não é mais correto.

Se o ORB do ID estiver inativo ou sendo executado em uma portadiferente, otksErr.log conterá uma exceção com uma mensagemconexão negada. Se houver um firewall entre os ORBs de bootprinte ID, crie uma abertura de porta bidirecional através do firewall paraque os ORBs possam se comunicar. Se a máquina do ORB do IDestiver configurada para utilizar DHCP e estiver executando oMicrosoft Windows NT ou 2000, o DSN do nome do host atribuídoa esta máquina poderá ser diferente do nome da máquina.

Se você estiver executando o Microsoft Windows NT, execute asetapas a seguir para descobrir se o nome do host e o endereço IPcorrespondem:

1. Execute ping da máquina do ID por seu nome. Isso fornecerá oendereço IP.

C:\> ping demo.dev.tivoli.com

2. Execute o ping do endereço IP retornado na etapa anterior com aopção-a.

C:\> ping -a 146.84.1.1


3.D

etecçãode

Problem

asna

Instalação

A opção-a retornará o nome do host que está associado aoendereço IP do DNS. Se o nome do host retornado nesta etapanão for igual ao nome do host na etapa anterior, corrija o nomedo host em suas definições de TCP/IP.

Se você estiver executando o Microsoft Windows 2000, ou tiver onslookup instalado em sua máquina, execute as etapas a seguir paradescobrir se o nome do host e o endereço IP correspondem:

1. Invoque o nslookup com o nome do host.

nslookup demo.dev.tivoli.com

2. Invoque o nslookup com o endereço IP retornado na etapaanterior.

nslookup 146.84.1.1

O resultado deve corresponder ao nome do host da etapa anterior. Seos nomes não corresponderem, corrija o nome do host na suadefinição de TCP/IP.

62 Versão 1.2

Detecção de Problemas Geraisda Operação

O Tivoli Kernel Services foi projetado para ser tolerante a falhas,portanto, você não deverá encontrar problemas durante a operaçãonormal. Mas se encontrar um problema, releia primeiro as etapas etécnicas de detecção de problemas descritas neste capítulo. Se issonão resolver o problema, consulte “Detecção de Problemas emComponentes” na página 111 para a detecção de problemas com basenos componentes.

A primeira seção neste capítulo descreve como recuperar os bancosde dados DB2, a segunda seção descreve a detecção de problemasdo banco de dados DB2 do Tivoli Kernel Services, a terceira seçãodescreve como recuperar o servidor de bootprint ou ID, e a quarta equinta seções descrevem a detecção de problemas dos servidoresTivoli DAS e MQSeries, a sexta seção descreve a detecção deproblemas dos ORBs de bootprint e ID, e a seção final descrevecomo detectar problemas no Tivoli Console.

Recuperando o Banco de Dados do Tivoli KernelServices

O backup dos bancos de dados e logs associados do Tivoli KernelServices deve ser feito regularmente como parte das atividades demanutenção regulares nos sistemas. Esses backups são necessáriospara restaurar os bancos de dados do Tivoli Kernel Services para umestado consistente, no caso de perda do banco de dados durante um

4


4.D

etecçãode

Prob.

Gerais

daO

peração

desastre. ConsulteInstalando o Tivoli Kernel Servicespara obtermais informações sobre como fazer backup corretamente dos bancosde dados DB2. Você deve trabalhar em conjunto com seuadministrador de banco de dados para determinar a melhor estratégiade backup e recuperação em seu local.

Se você precisar recuperar os dados a partir de backups, encerreprimeiro todos os ORBs em execução na instalação e, em seguida,encerre o servidor Tivoli DAS. Em seguida, restaure os bancos dedados, determine os arquivos de log necessários para recuperaçãopor avanço, restaure esses logs, avance o banco de dados e, porúltimo, reinicie o servidor Tivoli DAS e os ORBs.

Por exemplo, se você executou um backup de banco de dados emdisco, utilizando o comando:db2 backup database <nome do banco de dados> online

Nota: Certifique-se de que o backup dos arquivos de log já tenhasido feito para uma nova localização, pois a operação derestauração do banco de dados apagará os logs.

A restauração do banco de dados é feita com as seguintes etapas:

1. Digite o seguinte na janela de comando do DB2:db2 restore database <nome do bd>

Nota: Você precisará ter autoridade SYSADMIN ou SYSCTRLno banco de dados para fazer backup dele ou restaurá-lo.

2. Determine os arquivos de log ativos necessários para arecuperação por avanço, digitando o seguinte a partir de umajanela de comando do DB2:db2 get database configuration for <nome do bd>

3. Os arquivos de log são numerados seqüencialmente. Qualquerarquivo igual ou com um número maior do que o especificadopelo parâmetroFirst active log file está ativo e, portanto, énecessário para concluir uma recuperação por avanço deste bancode dados.

64 Versão 1.2

4. Copie os arquivos de log ativos para o diretório de logespecificado pelo parâmetroPath to log files.

5. Digite o seguinte na janela de comando do DB2:db2 rollforward database <nome do bd> to end of logs and stop

6. Você também pode executar uma recuperação por avanço em umhorário específico, digitando o seguinte em uma janela decomando do DB2:db2 rollforward database <nome do bd> to yyyy-mm-dd-hh.mm.ss.xxxx and stop

Isso restaurará o banco de dados para seu estado na hora dobackup e, em seguida, avançará todas as alterações consolidadaso mais próximo possível do horário especificado.

Para ver as diversas opções para emitir este comando, consulte oDB2 Universal Database Command Reference.

Recuperando Bancos de Dados DB2 do Tivoli KernelServices

O backup dos bancos de dados do Tivoli Kernel Services deve serfeito regularmente como parte das atividades de manutençãoregulares nos sistemas. Esses backups são necessários para restauraros bancos de dados do Tivoli Kernel Services para o estado original,no caso de perda do banco de dados durante um desastre. ConsulteInstalando o Tivoli Kernel Servicespara obter mais informaçõessobre como fazer backup corretamente dos bancos de dados DB2.Você deve trabalhar juntamente com o seu administrador de bancode dados para determinar a melhor estratégia de backup erecuperação em seu local.

Bancos de Dados DB2 do Tivoli Kernel ServicesHá vários erros do DB2 que você pode encontrar durante umaoperação “normal”. Sua primeira ação ao tratar desses problemas éexecutar algumas etapas gerais de detecção de problemas quepermitem coletar mais informações e, talvez, entender exatamente oque há de errado com o banco de dados.


4.D

etecçãode

Prob.

Gerais

daO

peração

Quando você recebe um erro do DB2, sempre há informações sobreo erro e uma chave de mensagem. A chave de mensagem égeralmente a primeira parte do texto que é retornado e tem trêsletras, seguidas por uma série de números, seguidos por uma únicaletra, por exemploSQL1005Nou DB21056W. Normalmente, asinformações retornadas com o erro são gerais, no entanto, às vezes,podem conter informações importantes. Para obter mais informaçõessobre o erro, e possíveis respostas do usuário, digite o seguintecomando em uma janela do processador de linha de comandos doDB2:

db2 ? <chave de erro>

em que<chave de erro>é a chave de erro retornada com amensagem.

Por exemplo, para exibir informações de erro para SQL1005N, digiteo seguinte comando em uma janela do processador de linha decomandos do DB2:

db2 ? SQL1005N.

Isso retornará algumas informações detalhadas sobre o erro, epossivelmente uma resposta do usuário. Você deve utilizar a respostado usuário para corrigir o problema ou erro.

Se o problema ainda continuar, a próxima etapa é consultar odb2diag.log. Este arquivo pode ser encontrado no diretório <diretórioda ocorrência>/sqllib/db2dump e possui todas as mensagens e errosdo DB2 detectados pelo sistema de gerenciamento do DB2. Aoconsultar este arquivo, você deve procurar um bloco de mensagensque foi gerado próximo à, ou na, data de recebimento do erro dobanco de dados. O db2diag.log oferecerá mais informações sobre oque foi encontrado pelo banco de dados, e uma possível condutapara corrigir os problemas. Durante a análise do db2diag.log, vocêpode utilizar o comandodb2 ? <chave de erro>, além dadocumentação do DB2, para entender e corrigir o problema.

66 Versão 1.2

Às vezes, os problemas do banco de dados DB2 aparecerão porquevocê está criando ou catalogando um banco de dados já existente nodiretório do DB2. O DB2 mantém um diretório de banco de dadospor ocorrência no servidor ou cliente DB2. Não pode haverduplicação entre os nomes de bancos de dados dentro de umaocorrência. Aparecerá um erro SQL1005N para o usuário, quando eletentar criar ou catalogar um banco de dados já existente no diretóriodo sistema ou do banco de dados.

Quando surgem esses tipos de problemas, você deve determinar se épossível excluir o banco de dados antigo, eliminando-o oudescatalogando-o, ou criar o novo banco de dados com um nomediferente.

Se você puder excluir o banco de dados antigo, deverá emitir osseguintes comandos a partir de uma janela do processador de linhade comandos do DB2:

db2 drop database <nome do bd>

ou db2 uncatalog database <nome do bd>

onde<nome do bd>é o nome do banco de dados que você desejadescatalogar.

Esses comandos funcionarão no cliente e no servidor, no entanto,observe as diferenças entre os comandosdrop e uncatalog. Ocomandodrop apagará completamente todos os arquivos einformações do banco de dados do servidor DB2, e o banco dedados será irrecuperável. O comandouncatalog apagará apenas areferência ao banco de dados, e o banco de dados será recuperável.Para recuperar um banco de dados descatalogado, tudo o você devefazer é emitir o comando de banco de dadoscatalog encontrado naseção de configuração do cliente a seguir. O comandouncatalog égeralmente utilizado na máquina cliente para eliminar um banco dedados remoto catalogado.

Às vezes, o diretório do banco de dados chega a um estado em queo banco de dados existe, mas é descatalogado do diretório do banco


4.D

etecçãode

Prob.

Gerais

daO

peração

de dados, por exemplo, se um banco de dados tiver sido criado e,posteriormente, descatalogado. Se você listar todos os bancos dedados no sistema, o banco de dados descatalogado não será mostradona lista. Você pode tentar recriar o banco de dados, mas mesmoassim receberá o erro SQL1005N. Nesse caso, digite os seguintescomandos a partir de uma janela do processador de linha decomandos do DB2:

db2 catalog database <nome do bd>

Para excluir o antigo banco de dados, digite o seguinte comando apartir de uma janela do processador de linha de comandos do DB2:

db2 drop database <nome do bd>

onde<nome do bd>é o nome do banco de dados que você desejacatalogar ou eliminar.

Caracteres UnicodeO Tivoli Kernel Services armazena seus dados de caracteresUnicode, tais como informações de registro de segurança, nomes denós de preferência, chaves e valores, nos bancos de dados DB2criados pelo script tdacl. Utilize apenas caracteres Unicodesuportados por seu banco de dados.

Se você pretende executar o Tivoli Kernel Services em um ambientede vários idiomas ou multilíngüe, certifique-se de que tenha criadoseus próprios bancos de dados DB2 com a página de códigos,idioma e território adequados, para assegurar-se de que os dadosUnicode sejam armazenados e recuperados corretamente. Maisinformações podem ser encontradas emInstalando o Tivoli KernelServices.

Bancos de Dados DB2 do Tivoli Kernel Services:Erros Específicos

A lista a seguir contém erros específicos do DB2, além deexplicações do erro e ações de correção que podem ser seguidas pararesolver os erros.

¶ Eu estou recebendo um erro SQL1116N. O que devo fazer?

68 Versão 1.2

v Causa: Esse erro indica que o banco de dados está em umestado de backup pendente, o que significa que o banco dedados fica inutilizável até a conclusão do backup; osaplicativos não poderão ser conectados ao banco de dados. Arazão pela qual o banco de dados está nesse estado é porqueuma grande alteração ou evento de configuração ocorreu nobanco de dados, como a ativação de log de avanços.

v Alternativa: Você deve iniciar um backup completo,digitando o seguinte comando:

db2 backup database <nome do bd> to <diretório>

onde<nome do bd>é o nome do banco de dados do qual seráfeito o backup e<diretório> é o diretório onde o backup seráarmazenado.


v Causa: Esse erro indica que o banco de dados está em umestado de avanço pendente. O banco de dados é consideradoinutilizável até que um avanço seja concluído no banco dedados. A razão pela qual o banco de dados está neste estado éporque um comando de recuperação do banco de dados foidigitado, ou ocorreu um grande evento do sistema do bancode dados, e o sistema DB2 colocou o banco de dados em umestado de avanço pendente.

v Solução:Para tirar o banco de dados de um estado de avançopendente, você deve digitar um dos seguintes comandos emuma janela do processador de linha de comandos do DB2:

– Se você não desejar avançar, e tiver acabado de restauraro banco de dados, digite:

db2 restore database <nome do bd> withoutrolling forward

Nota: Esse é um comando de restauração simples, e oparâmetrowithout rolling forward mantém obanco de dados fora do estado de avanço pendente.


4.D

etecçãode

Prob.

Gerais

daO

peração

Para obter mais informações sobre o comando derestauração, consulte oDB2 Administration Guide.

– Se você desejar avançar o banco de dados, digite:

db2 rollforward database <nome do bd> to end oflogs

Nota: Esse é um comando de avanço simples queavançará o banco de dados até o final dos arquivosde log. Para obter mais informações sobre ocomando rollforward, consulte oDB2Administration Guide.


v Causa: Esse erro indica uma das duas coisas que podemestar erradas em seu ambiente. A causa principal deste erro éque ao executar o DB2 no AIX, um erro AIX IPC impacta autilização de memória compartilhada pelo DB2. Para o AIX4.3.3.0, há uma limitação de doze (12) segmentos dememória compartilhada por processo. Essa limitação foicorrigida no AIX 4.3.3.16. Uma alternativa para esseproblema é catalogar todos os bancos de dados localmente,para que o DB2 utilize o TCP em vez da memóriacompartilhada para se comunicar com eles. Consulte“Servidor Tivoli DAS - DB2” na página 78 para obter maisinformações sobre como configurar o DB2 para utilizar oTCP.

Se você não estiver executando o DB2 no AIX, digitedb2 ?sq12224na partir de uma janela do processador de linha decomandos do DB2 para obter mais informações sobre osproblemas que podem ter causado esse erro. Uma outra razãopara esse erro é que o sistema de gerenciamento de banco dedados está configurado incorretamente.

Há três variáveis que controlam quantos aplicativos podemacessar os bancos de dados individuais e o servidor DB2, etambém quantos bancos de dados podem estar ativos dentrodo servidor DB2 de uma vez:

– maxagents(variável de Ocorrência do DB2)

70 Versão 1.2

– numdb(variável de Ocorrência do DB2)

– maxappls(variável de Banco de Dados Individual)

v Solução:O maxappls adicionado a cada banco de dados temdeve ser igual ou menor que a quantidade de maxagents. Ovalor de numdb tem de ser definido para, pelo menos, onze,para que os bancos de dados do TKS funcionemcorretamente.

– Para recuperar os valores de variáveis de ocorrência doDB2, digite o seguinte comando a partir de uma janela doprocessador de linha de comandos do DB2, e procure osvalores dos pares variável=valor:

db2 get dbm cfg

– Para recuperar o valor da variável de banco de dadosindividual, digite o seguinte comando a partir de umajanela do processador de linha de comandos do DB2, eprocure pelo valor do par variável=valor:

db2 get db cfg for <nome do bd>

onde<nome do bd>é o nome do banco de dados sobreo qual você deseja obter informações.

– Para modificar as variáveis de ocorrência do DB2, digiteo seguinte comando a partir de uma janela do processadorde linha de comandos do DB2:

db2 update dbm cfg using <nome davariável>=<valor>

onde<nome da variável>é o nome da variável e<valor> é o valor a ser atribuído à variável.

– Para modificar a variável de banco de dados individual,digite o seguinte comando a partir de uma janela doprocessador de linha de comandos do DB2:

db2 update db cfg for <nome do bd> using <nomeda variável>=<valor>

onde<nome do bd>é o nome do banco de dados quevocê deseja modificar,<nome da variável>é o nome davariável, e<valor> é o valor a ser atribuído à variável.


4.D

etecçãode

Prob.

Gerais

daO

peração


v Causa:

Você normalmente verá esse erro em máquinas Solaris,porque o Servidor DB2 foi configurado incorretamente. Se asvariáveis do sistema não forem configuradas corretamente noarquivo de configuração kernel /etc/system, você receberáesse erro.

v Solução:

Além dos parâmetros especificados na documentação doDB2, definasemsys:semino_semume 50. Consulte“Detecção de Problemas na Instalação do DB2” na página 51para obter mais informações sobre esse erro e comocorrigi-lo.


v Causa: Esse erro pode indicar um de dois problemas. Oprimeiro problema pode ser que os programas utilitários doDB2 não estejam ligados ao banco de dados.

v Solução:Digite os seguintes comandos a partir de uma janelado processador de linha de comandos do DB2, na máquinado Servidor DB2, para corrigir o problema:

db2 bind @<caminho>/db2ubind.lst blocking all grantpublic

db2 bind @<caminho>/db2cli.lst blocking all grantpublic

onde<caminho> é o caminho no servidor DB2 para odiretório sqllib\lib.

Execute novamente a ação que retornou anteriormente o erro,e determine se o erro ainda existe. Se o erro ainda existir, osegundo problema é que há versões conflitantes do cliente eservidor DB2. Versões conflitantes significam que diferentesníveis de fix packs estão instalados no código do cliente eservidor DB2. Além disso, nessa situação, ocliente refere-seao código nativo do cliente DB2 instalado no sistema

72 Versão 1.2

operacional junto com o arquivo db2java.zip que o código doTKS está utilizando para se comunicar com o banco dedados.

Verifique se os níveis de versão do DB2 do código do clientee servidor correspondem, digitando o seguinte comando emuma janela do processador de linha de comandos do DB2:

db2level

Além disso, verifique se você substituiu o db2java.zip no<diretório do orb>\boot\external\db2java\1.0.0\ pela versão dodiretório <diretório da ocorrência do db2>\sqllib\java. O nívelde código do DB2 deve ser o mesmo no cliente e noservidor.

¶ Meu cliente está recebendo uma Exceção de Nível do JDBCausente. O que devo fazer?

Esse erro também indica que há um conflito entre o nível deversão do DB2 do código do servidor e do código do cliente.Além disso, nessa situação, ocliente refere-se ao código nativodo cliente DB2 instalado no sistema operacional junto com oarquivo db2java.zip que o código do TKS está utilizando para secomunicar com o banco de dados.

Verifique se os níveis de versão do DB2 do código do cliente eservidor correspondem, digitando o seguinte comando em umajanela do processador de linha de comandos do DB2:

db2level

Além disso, verifique se você substituiu o db2java.zip no<diretório do orb>\boot\external\db2java\1.0.0\ pela versão dodiretório <diretório da ocorrência do db2>\sqllib\java. O nível decódigo do DB2 deve ser o mesmo no cliente e no servidor.

¶ Eu estou recebendo a mensagem Nenhuma Exceção deDriver Adequada. O que devo fazer?

v Causa: Esse problema indica que o arquivoLOCKCfg.properties não está configurado corretamente ou ocódigo não pode encontrar o db2java.zip utilizando oclasspath.


4.D

etecçãode

Prob.

Gerais

daO

peração

v Solução:Primeiro, assegure-se de que o arquivo db2java.zipesteja localizado no diretório <diretório doorb>\boot\external\db2java\1.0.0.

Depois, assegure-se de que o arquivo LOCKCfg.properties,encontrado no <diretório do orb>\bin\<diretório do interp>,contenha o seguinte:

variável=pares de valores

onde<diretório do interp> é o diretório do sistemaoperacional que você está executando:

– DB2INSTANCE=<nome da ocorrência do db2>:

– LD_LIBRARY_PATH=<caminho da ocorrência dodb2>\sqllib\lib:......

– LIBPATH=<caminho da ocorrência do db2>\sqllib\lib:......

onde<nome da ocorrência do db2>é o nome daocorrência do DB2;<caminho da ocorrência do db2>éo caminho para o diretório da ocorrência do DB2; e...... équalquer caminho pré-existente que havia anteriormenteno arquivo.

¶ Quando utilizo o script tdacl ou runstats, eu recebo amensagem″SQL2310N O utilitário não pôde gerarestatísticas. O erro -964 foi retornado″ OU ″SQL0964C O logde transações do banco de dados está cheio.″ O que devofazer?

v Causa: Esse erro ocorre quando o DB2 não possui espaço delog suficiente para concluir uma transação. O tamanho doLOGPRIMARY deve ser aumentado.

v Solução:Aumente o tamanho do LOGPRIMARY executandoas etapas a seguir:

1. Digite o seguinte a partir de uma janela de comando doDB2:

db2 get db cfg for TMD | grep LOGP

2. Multiplique por três o valor retornado na etapa 1. Porexemplo, se 10 for retornado na etapa 1, utilize 30 para<newvalue>na etapa seguinte.

74 Versão 1.2

3. Digite o seguinte a partir de uma janela de comando doDB2:

db2 update db cfg for TMD using LOGPRIMARY<novovalor>

4. Encerre e reinicie o DB2.

Detecção de Problemas no OracleDepois que os bancos de dados Oracle estiverem no lugar adequado,podem ocorrer erros e problemas durante uma operação regular.Informações de detecção de problemas para produtos Oracle podemser encontradas no seguinte site da Web:

www.oracle.com

A lista a seguir contém os itens de detecção de problemas no Oracle:

¶ Certifique-se de que o ambiente Oracle esteja configuradocorretamente. Verifique se as variáveis de ambienteORACLE_HOME, TWO_TASK e ORACLE_SID estãodefinidas corretamente.

¶ Certifique-se de que o script sqlplus esteja em seu caminho.

¶ Utilize IDs de usuário e senhas válidos:

ID do usuário -sys, senha -sys.

ID do usuário -system, senha -manager.

¶ Certifique-se de que você esteja utilizando a versão suportada doOracle:

Windows NT ou 2000 - Oracle 8.1.6.3

Sun Solaris e AIX - Oracle 8.1.6.2


4.D

etecçãode

Prob.

Gerais

daO

peração

Restaurando o Depósito de Instalaçã o e o Servidorde Bootprint

O backup do depósito de instalação e do servidor de bootprint doTivoli Kernel Services deve ser feito regularmente como parte dasatividades normais de manutenção nos sistemas. Esses backups sãonecessários para restaurar o depósito de instalação e os servidores debootprint para o estado original, no caso de perda do sistema pordesastre. Para obter mais informações sobre como fazer backupdesses bancos de dados, consulteInstalando o Tivoli Kernel Services.

Depois de fazer backup dos servidores, você pode utilizar osseguintes processos para restaurá-los após um desastre. O processode restauração do depósito de instalação é diferente do processo derestauração de um servidor de bootprint.

Para restaurar o depósito de instalação, siga estas etapas:

Nota: Se você estiver restaurando o depósito de instalação devido auma alteração de configuração indesejada, ou porque desejarecuperar uma correção, a reinstalação do depósito deinstalação poderá ser saltada, pois a instalação básica aindapode ser recuperada. Só reinstale o depósito de instalação se ainstalação básica não estiver funcionando.

1. Reinstale o depósito de instalação no mesmo diretório de destinodo Tivoli Kernel Services em que foi instalado anteriormente.

Durante a reinstalação do depósito de instalação, desative ascaixas de opções para as seguintes opções:

¶ Iniciar automaticamente este depósito de instalação após aconclusão da instalação.

¶ Iniciar automaticamente este servidor de console após aconclusão da instalação.

2. Remover o conteúdo de %TKS_BASEDIR% da máquina.

3. Restaurar o %TKS_BASEDIR% da mídia de backup.

4. Reiniciar os ORBs do depósito de instalação.

76 Versão 1.2

Para reiniciar os ORBs do depósito de instalação, siga ainstrução no capítulo “Executando o Tivoli Kernel Services” deInstalando o Tivoli Kernel Services. Reinicie o ORB 1. Após ainicialização do ORB 1 ser concluída, reinicie o ORB 2.

Nota: Sempre que você reinstalar o depósito de instalação, eleserá tratado como uma nova instalação e, portanto,quaisquer servidores de bootprint precisarão também serreinstalados. Se você não reinstalar os bootprints, osORBs do depósito de instalação não funcionarãocorretamente.

Para restaurar o servidor de bootprint, siga estas etapas:

1. Reinstale o servidor de bootprint no mesmo diretório de destinodo Tivoli Kernel Services em que foi instalado anteriormente.

Durante a reinstalação do bootprint, desative a caixa de opçõespara a opçãoIniciar automaticamente este servidor debootprint após a conclusão da instalação.

2. Remover o conteúdo de %TKS_BASEDIR% da máquina.

3. Restaurar o %TKS_BASEDIR% da mídia de backup.

4. Reiniciar o ORB de bootprint.

Para reiniciar o ORB de bootprint, siga a instrução no capítulo“Executando o Tivoli Kernel Services” deInstalando o TivoliKernel Services. Reinicie o ORB 1.

Nota: É necessário fazer backup dos bootprints somente umavez. Depois, você pode utilizar esse backup para restauraro bootprint, e o sistema traz automaticamente o bootprintpara o nível de implementação atual. Você precisaráreciclar o ORB de bootprint após restaurar o%TKS_BASEDIR% para que ele seja executado no nívelmais recente do código.


4.D

etecçãode

Prob.

Gerais

daO

peração

Servidor Tivoli DAS - DB2O servidor Tivoli DAS contém registradores de rastreios que podemser utilizados para coleta de informações de detecção de problemas.O primeiro passo ao detectar problemas em um servidor Tivoli DASé ativar o rastreio para o próprio servidor:

1. Edite o arquivo dasOrbCfg.tks, localizado no diretório<dirInstalaçãoDAS>ext/das/server/tksSi, e altere oDAServer.trace e o DAServertracelevel. Os níveis de rastreiosuportados sãoEntryexit, Level1, Level2, Level3e All.

¶ Entryexit: Registra a entrada e saída para cada método doservidor Tivoli DAS.

¶ Level1:Registro somente mensagens de erro e de avisoespecíficas do banco de dados.

¶ Level2:Rastreio detalhado do fluxo lógico seguido noservidor ao receber pedidos do cliente JDBC. Isso pode sergerado em qualquer lugar, de três a dez entradas de log paracada chamada de método no JDBC.

¶ Level3:Rastreia dados reais no arquivo de log, para ver seos dados enviados correspondem aos dados recuperados.

¶ All: Todos os quatro níveis de rastreio combinados.

Nota: O nível de rastreio sugerido é Entryexit, Level1 e Level2.O rastreio Level3 e All inclui dados que tornam os logsmuito grandes e difíceis para trabalhar. No entanto,mesmo com o nível de rastreio sugerido, um tamanho dearquivo de log de 1 GB não é incomum.

2. Recicle o servidor Tivoli DAS para que as alterações de nível derastreio sejam efetivadas.

Há vários erros que você pode encontrar ao utilizar o servidor TivoliDAS. O primeiro tipo de erro é uma exceção de CORBA. Segue umexemplo de exceção de CORBA:

Exceção de CORBA: IDL:omg.org/CORBA/COMM_FAILURE:1.0 :125

78 Versão 1.2

No final da exceção, há um número de erro; no exemplo, essenúmero de erro é125. Esse é o código de erro mais comum parauma exceção de Corba. Um código de erro 125 significa que a portaestá sendo utilizada. A causa mais comum disso é quando há umServidor Tivoli DAS já em execução nesse número de porta.Certifique-se de que não exista outra ocorrência do Servidor TivoliDAS já em execução, digitando o seguinte em uma linha decomandos:

netstat -a

Esse comando verificará se a porta do Tivoli DAS (padrão 8001) nãoestá sendo utilizada.

Os números de erro são definidos no errno.h, que está localizado em/usr/include/sys/errno.h em máquinas Sun Solaris, e/usr/include/errno.h em máquinas AIX. Você deve consultar essearquivo para determinar o tipo de erro que o número do código deerro representa.

Um outro tipo de erro é o SQLState do servidor Tivoli DAS. Segueum exemplo de erro SQLState do servidor Tivoli DAS:

Texto do Erro:

com.tivoli.das.jdbc.daDriverjdbc:dastdo://cherry.austin.lab.tivoli.com:8001/ps SQLState: HZW02

O HZWO2é o código de erro SQLState. Os códigos SQLState doservidor Tivoli DAS estão em conformidade com o padrãoANSI/ISO-92. A tabela a seguir lista os códigos de erro SQLState ea mensagem de erro associada.

Tabela 3. Mensagens e códigos de erro SQLState do servidorTivoli DASCódigo de ErroSQLState

Mensagem de Erro

HYW01 Sem memória no servidor DAS.


4.D

etecçãode

Prob.

Gerais

daO

peração

Tabela 3. Mensagens e códigos de erro SQLState do servidorTivoli DAS (continuação)Código de ErroSQLState

Mensagem de Erro

HYW02 Exceção de compatibilidade do JDBC 2.0 emexecuteUpdate.

HYW03 Exceção de compatibilidade do JDBC 2.0 emexecuteQuery.

HYW04 Chamada de um método JDBC nãoimplementado/suportado.

HYW05 Erro de seqüência de função.

HZW01 Servidor DAS não-alcançável (gerado em clienteJDBC).

HZW02 A conexão é inválida porque o servidor de bancode dados não está disponível (gerado na camadaODBC).

HZW03 A conexão é inválida porque o identificador não éreconhecido no servidor de banco de dados.

WOW01 Erro de fornecedor não mapeado.

Você também pode ter problemas de conectividade do banco dedados ao executar o servidor de banco de dados DB2 e o servidorTivoli DAS em uma máquina AIX. Isso é causado pela utilização dememória compartilhada do DB2 ao se comunicar com o servidorTivoli DAS no AIX e por um problema AIX IPC.

Se houver problemas de conectividade nesse ambiente, você poderáconfigurar o servidor para que atue como um cliente remoto, o quefaz com que o DB2 utilize sockets TCP/IP em vez de memóriacompartilhada para comunicação. Para configurar o servidor debanco de dados DB2 para utilizar sockets TCP/IP para comunicaçãocom o servidor Tivoli DAS, execute as seguintes etapas:

1. Encerre todos os ORBs em execução na instalação.

2. Encerre o servidor Tivoli DAS.

80 Versão 1.2

3. Edite o arquivo/etc/services para indicar as portas deconexão e interrupção que serão utilizadas para a ocorrência doDB2. Se a ocorrência do DB2 for db2inst1, você poderáadicionar o seguinte:

db2cdb2inst1 50001 # porta de conexão para aocorrência db2inst1

db2idb2inst1 50002 # porta de interrupção para aocorrência db2inst1

4. Assegure-se de que o serviço esteja registrado no gerenciador debanco de dados, emitindo o comando a seguir, em uma únicalinha, e especificando o mesmo nome utilizado para a porta deconexão em /etc/services:

db2 update database manager configuration usingsvcename db2cdb2inst1

5. Catalogue o servidor de banco de dados local como um nó deservidor remoto na porta de conexão configurada, substituindo onome do servidor de banco de dados pelamáquina do bdeutilizando o número de porta apropriado no comando a seguir.

db2 catalog tcpip node máquina do bd remote máquina dobd server 50001

6. Catalogue os bancos de dados do Tivoli Kernel Services comoaliases remotos:

db2 catalog database SLASH as SLASHA at node máquinado bd

db2 catalog database PS as PSA at node máquina do bd

db2 catalog database TMD as TMDA at node máquina do bd

(Repita o processo para quaisquer outros bancos de dados emuso, como SECAUDIT ou LOGGING).

7. Reconfigure o servidor Tivoli DAS modificando o arquivo deconfiguração para utilizar os novos nomes aliases em vez dosnomes reais de banco de dados. Esse arquivo é:

/usr/local/das/ext/das/server/tksSi/dasDsnCfg.tks

Edite cada uma das sub-rotinas para alterar o parâmetro DB parautilizar o alias. Por exemplo, para o banco de dados slash, vocêalteraria o valor do parâmetro DB deslashparaslasha:


4.D

etecçãode

Prob.

Gerais

daO

peração

[slash]

UID=db2admin

DBMS=DB2/2

PWD=XV&UXa]b

DB=slasha

DEFAULT=FALSE

QUAL=db2admin

DRV=DB2CLI

8. Encerre e inicie o DB2:

db2stop

db2start

9. Reinicie o servidor Tivoli DAS e, em seguida, reinicie o depósitode instalação e os outros ORBs.

Recuperando Consoles Após a Perda de Conexão doServidor Tivoli DAS

Se a conexão entre um ORB e o servidor Tivoli DAS for perdida, aCLI (interface de linha de comandos) do Tivoli Kernel Services iráparar de funcionar. Além disso, se um Tivoli Console estiver emexecução no ORB afetado, o Tivoli Console irá parar de funcionar.

Após o restabelecimento da conectividade com o servidor TivoliDAS, os componentes PsMcrImpl, PsNsImpl e PsJcImpl emexecução no ORB do depósito de instalação, bem como todos osORBs do Tivoli Console, deverão ser reciclados. Esta seção forneceinformações sobre como reconhecer um problema de conectividadedo servidor Tivoli DAS e destaca as etapas necessárias, após orestabelecimento da conectividade, para recuperar os componentesem falha.

Situação de Perda de Conectividade com o Servidor TivoliDAS

As situações mais comuns de perda de conectividade com o servidorTivoli DAS são descritas nestes quatro casos:

¶ Caso 1:

82 Versão 1.2

Todos os ORBs na instalação podem perder conectividade com oservidor Tivoli DAS, devido a um problema de conectividade derede ou devido a uma falha do próprio servidor Tivoli DAS ouuma falha da máquina na qual o servidor Tivoli DAS estáexecutando. Nesse caso, os componentes MCR e NS emexecução no depósito de instalação (que possuem uma conexãode sessão permanente com o servidor Tivoli DAS), bem comotodos os ORBs executando o Tivoli Consoles, devem serreciclados. Para esse caso, consulte o Cenário 1, Cenário 2,Cenário 3 e Cenário 4 para reconhecer a situação.

¶ Caso 2:

Um ORB de bootprint do Tivoli Console pode perderconectividade com o servidor Tivoli DAS, mas pode não ocorrero mesmo com os componentes MCR e NS em execução nodepósito de instalação. Para esse caso, consulte o Cenário 1,Cenário 2 e Cenário 4 para reconhecer a situação.

¶ Caso 3:

Os componentes MCR e NS em execução no depósito deinstalação podem perder conectividade com o servidor TivoliDAS, mas o Tivoli Consoles em execução em outros ORBspodem permanecer conectados ao servidor Tivoli DAS. Para essecaso, consulte o Cenário 1, Cenário 2 e Cenário 3 parareconhecer a situação.

¶ Caso 4:

Nesse caso, os componentes MCR e NS permanecem emexecução no ORB do ID, e um ORB do Tivoli Console não estáem execução. O servidor Tivoli DAS fica inativo ou torna-senão-disponível e, em seguida, torna-se disponível novamente. OMCR e o NSparecerão estar sendo executados normalmente,como em:

wcmd comp status PsMcrImpl -> Running

wcmd comp status PsNsImpl -> Running

Inicie um ORB do Tivoli Console (que não estava em execuçãoantes do início desse cenário). A tela de início de sessão do


4.D

etecçãode

Prob.

Gerais

daO

peração

Tivoli Console aparecerá normalmente, mas a área de trabalhonão será criada. Para esse caso, utilize o Cenário 5 até o Cenário9 para reconhecer a situação.

Como Reconhecer o ProblemaOs cenários seguintes foram desenvolvidos para ajudar você areconhecer um problema com a conectividade do servidor TivoliDAS:

¶ Cenário 1:

Se você tentar selecionar uma ação no Portfólio no TivoliConsole e receber a seguinte mensagem de erro:

FWP00009E: Action operation failed. An exceptionmight have occurred in running the action.

¶ Cenário 2:

orb.2/logs/GlobalMsg1.log no depósito de instalação ouorb.1/logs em um bootprint do Tivoli Console mostra os seguinteerros:

2001.03.05 14:27:13.170 com.tivoli.pf.fmk.action.FmkActivationManager$FmkActionRequest invoke TivoliSystems Inc. Presentation Services

com.tivoli.pf.mcr.external.McrAccessException: Couldnot access database

2001.03.05 14:27:16.725 com.tivoli.pf.jc.portfolio.JcPortfolioViewer handleThrowable()Tivoli SystemsInc. Presentation Services FWP0009E Action operationfailed. An exception might have occurred in runningthe action.

2001.03.05 14:27:16.725 com.tivoli.pf.jc.portfolio.JcPortfolioViewer handleThrowable() Tivoli SystemsInc. Presentation Servicescom.tivoli.pf.mcr.external.McrAccess Exception: Couldnot access database

¶ Cenário 3:

orb.1/logs/GlobalMsg1.log no depósito de instalação mostra osseguintes erros:

84 Versão 1.2

2001.03.05 14:27:12.839 McrDbElement dbRetrieveProbePoint: 1 Tivoli Systems Inc. PresentationServices Mcrcom.tivoli.das.ordb.RdbErrorException$ERdbSQLException

at com.tivoli.das.ordb.RdbBaseException.<init>(RdbBaseException.java:58)

at com.tivoli.das.ordb.RdbErrorException.<init>(RdbErrorException.java:153)

at com.tivoli.das.ordb.RdbErrorException$ERdbSQLException.<init> (RdbErrorException.java:242)

atcom.tivoli.das.ordb.RdbWrapPreparedStatement.<init>(RdbWrapPreparedStatement.java)Compiled Code))

at com.tivoli.das.ordb.RdbConnection.getPreparedStatement(RdbConnection.java(CompiledCode))

at com.tivoli.das.ordb.RdbConnection.query(RdbConnection.java(Compiled Code))

at com.tivoli.das.ordb.RdbQuery.execute(RdbQuery.java(Compiled Code))

at com.tivoli.das.ordb.RdbQuery.execute(RdbQuery.java(Compiled Code))

at com.tivoli.pf.mcr.db.McrDbElement.dbRetrieve(McrDbElement.java:411)

at com.tivoli.pf.mcr.db.McrDbDisplayInfo.dbRetrieve(McrDbDisplayInfo.java:532)

at com.tivoli.pf.mcr.db.McrDbAction.postRetrieve(McrDbAction.java:943)

at com.tivoli.pf.mcr.db.McrDbAction.dbRetrieve(McrDbAction.java:567)

at com.tivoli.pf.mcr.query.McrQueryAction.fetch(McrQueryAction.java:277)

at com.tivoli.pf.mcr.query.McrQueryAction.query(McrQueryAction.java:124)


4.D

etecçãode

Prob.

Gerais

daO

peração

at com.tivoli.pf.mcr.McrClientServer.getAction(McrClientServer.java:233)

at com.tivoli.pf.mcr.McrImplComponent.getAction(McrImplComponent.java:98)

at java.lang.reflect.Method.invoke(Native Method)

at com.objectspace.voyager.reference.Function.invoke(Function.java(Compiled Code))

atcom.objectspace.voyager.orb.LocalReference.realInvoke(LocalReference.java(Compiled Code))

at com.objectspace.voyager.orb.LocalReference.invoke(LocalReference.java(Compiled Code))

at com.objectspace.voyager.orb.ReferenceHolder.invokeOnReference(ReferenceHolder.java(CompiledCode))

at com.objectspace.voyager.orb.ReferenceHolder.invoke(ReferenceHolder.java(Compiled Code))

at com.objectspace.voyager.vrmp.VrmpRequestHandler$Processor.invoke(VrmpRequestHandler.java(CompiledCode))

at com.objectspace.voyager.vrmp.VrmpRequestHandler.process(VrmpRequestHandler.java(Compiled Code))

at com.objectspace.voyager.tcp.RequestManager.process(RequestManager.java(Compiled Code))


at com.objectspace.voyager.tcp.RequestManager$1.run(RequestManager.java(Compiled Code))

at com.objectspace.lib.thread.ReusableThread.run(ReusableThread.java)

2001.03.05 14:27:13.030 McrQueryAction query(McrID,String, Locale) Tivoli Systems Inc. PresentationServices Mcrcom.tivoli.das.ordb.RdbErrorException$ERdbSQLException

86 Versão 1.2



atcom.tivoli.das.ordb.RdbErrorException$ERdbSQLException.<init>(RdbErrorException.java:225)

at com.tivoli.das.ordb.RdbConnection.commit(RdbConnection.java(Compiled Code))

at com.tivoli.das.ordb.RdbTransaction.commit(RdbTransaction.java(Compiled Code))








at com.objectspace.voyager.orb.ReferenceHolder.invokeOnReference (ReferenceHolder.java(CompiledCode))




4.D

etecçãode

Prob.

Gerais

daO

peração

atcom.objectspace.voyager.vrmp.VrmpRequestHandler.process(VrmpRequestHandler.java(Compiled Code))





2001.03.05 14:27:13.080 McrQueryAction query(McrID,String, Locale) Tivoli Systems Inc. PresentationServices Mcr FWP1709I The Management ComponentRepository service has detected an unexpected error.

¶ Cenário 4:

Ocorre o seguinte erro ao tentar fechar o Tivoli Console:

FWP1513W: An error has occurred while attempting tostore a property or user preference to the database.It will be available only during this session.

Ocorre o seguinte quando você continua trabalhando com osistema:

v O Tivoli Console é interrompido e o ORB pode não estar emboas condições neste ponto.

v As funções minimizar e maximizar da GUI funcionam, ocontrole ’X’ não funciona.

v A barra azul do quadro ’Fechar’ não funciona. A maior partede entrada do usuário fica impossível porque o thread da GUIestá em um ciclo infinito.

¶ Cenário 5:

Se você iniciar sessão no Tivoli Console sob as condições docenário 4, a seguinte mensagem de erro poderá ser exibida:

FWP0014E: Falha na inicialização do portfólio. Podeter ocorrido um erro no servidor ou repositório.

88 Versão 1.2

SelecioneFechar.

¶ Cenário 6:

orb.2/logs/GlobalMsg1.log no depósito de instalação ouorb.1/logs em um ORB de bootprint pode mostrar os seguinteserros:

2001.03.08 11:45:55.305 com.tivoli.pf.fmk.action.FmkActivationManager$FmkActionRequest invoke TivoliSystems Inc. Presentation Services com.tivoli.pf.mcr.external.McrAccessException: Could not accessdatabase

2001.03.08 11:45:55.305 com.tivoli.pf.fmk.action.FmkActivationManager performAction() Tivoli SystemsInc. Presentation Services com.tivoli.pf.mcr.external.McrAccessException: Could not accessdatabase

2001.03.08 11:46:05.420 com.tivoli.pf.jc.portfolio.JcPortfolio interpretResults(IFmkActionResultsresults) Tivoli Systems Inc. Presentation ServicesFWP0014E Portfolio initialization failed. An errormight have occurred in the server or the repository.

2001.03.08 11:46:05.420 com.tivoli.pf.jc.portfolio.JcPortfolio interpretResults(IFmkActionResultsresults) Tivoli Systems Inc. Presentation Servicescom.tivoli.pf. mcr.external.McrAccessException: Nãofoi possível acessar o banco de dados

¶ Cenário 7:

Aparece a seguinte mensagem de erro após a seleção deFecharno Cenário 5:

FWP0002E: Error creating desktop.

SelecioneFechar. A tela de início de sessão do Tivoli Consoleretornará. Se você iniciar sessão novamente, repetirá a seqüênciado Cenário 5 ao Cenário 9.

¶ Cenário 8:

orb.2/logs/GlobalMsg1.log no depósito de instalação ouorb.1/logs em um ORB de bootprint mostra os seguintes erros:


4.D

etecçãode

Prob.

Gerais

daO

peração

2001.03.08 11:46:06.651 com.tivoli.pf.jc.wam.JcWorkAreaManager ctor Tivoli Systems Inc.Presentation Services FWP0002E Error creatingdesktop.

2001.03.08 11:46:06.651 com.tivoli.pf.jc.wam.JcWorkAreaManager ctor Tivoli Systems Inc.Presentation Servicescom.tivoli.pf.jc.util.JcException: Could not accessdatabase

at com.tivoli.pf.jc.util.JcException.<init>(JcException.java:38)

at com.tivoli.pf.jc.portfolio.JcPortfolio.interpretResults (JcPortfolio.java:363)

at com.tivoli.pf.jc.portfolio.JcPortfolio.loadPortfolioViewer(JcPortfolio.java:165)

at com.tivoli.pf.jc.portfolio.JcPortfolio.<init>(JcPortfolio.java:79)

at com.tivoli.pf.jc.wam.JcWorkAreaManager.<init>(JcWorkAreaManager.java:96)

at com.tivoli.pf.jc.session.JcUserSession$EJcSignOnResponder.handleRespond(JcUserSession.java:534)

at com.tivoli.pf.common.external.APfResponder.respond (APfResponder.java:82)

at com.tivoli.pf.sc.connection.ScConnectionManager$EScSignOnRequest.handleRespond(ScConnectionManager.java:480)

at com.tivoli.pf.common.external.APfResponder.respond(APfResponder.java:82)

at com.tivoli.pf.common.tm.PfResponseRunnable.run(PfResponseRunnable.java:97)

atcom.tivoli.pf.common.tm.PfInvoker$EPfQueueServicingLoop.run(PfInvoker.java(Compiled Code))

at java.lang.Thread.run(Thread.java:481)

90 Versão 1.2

at com.tivoli.pf.common.tm.PfCrashsafeThread.run(PfCrashsafeThread.java:106)

2001.03.08 12:58:29.476 com.tivoli.pf.fmk.action.FmkActivationManager$FmkActionRequest invoke TivoliSystems Inc. Presentation Servicescom.tivoli.pf.mcr.external. McrAccessException: Couldnot access database

2001.03.08 12:58:29.476 com.tivoli.pf.fmk.action.FmkActivationManager performAction() Tivoli SystemsInc. Presentation Servicescom.tivoli.pf.mcr.external. McrAccessException: Couldnot access database

2001.03.08 12:59:59.025 com.tivoli.pf.jc.portfolio.JcPortfolio interpretResults(IFmkActionResultsresults) Tivoli Systems Inc. Presentation ServicesFWP0014E Portfolio initialization failed. An errormight have occurred in the server or the repository.

2001.03.08 12:59:59.025 com.tivoli.pf.jc.portfolio.JcPortfolio interpretResults(IFmkActionResultsresults) Tivoli Systems Inc. Presentation Servicescom.tivoli.pf.mcr. external.McrAccessException: Couldnot access database

¶ Cenário 9:

orb.1/logs/GlobalMsg1.log no depósito de instalação mostra osseguintes erros:

2001.03.08 12:58:29.146 McrDbElement dbRetrieveProbePoint: 1 Tivoli Systems Inc. PresentationServices Mcr com.tivoli.das.ordb.RdbErrorException$ERdbSQLException





4.D

etecçãode

Prob.

Gerais

daO

peração

atcom.tivoli.das.ordb.RdbWrapPreparedStatement.<init>(RdbWrapPreparedStatement.java (Compiled Code))

at com.tivoli.das.ordb.RdbConnection.getPreparedStatement (RdbConnection.java(CompiledCode))

at com.tivoli.das.ordb.RdbConnection.query(RdbConnection.java(Compiled Code))

atcom.tivoli.das.ordb.RdbQuery.execute(RdbQuery.java(Compiled Code))

at com.tivoli.das.ordb.RdbQuery.execute(RdbQuery.java (Compiled Code))

at com.tivoli.pf.mcr.db.McrDbElement.dbRetrieve(McrDbElement.java:411)

at com.tivoli.pf.mcr.db.McrDbDisplayInfo.dbRetrieve(McrDbDisplayInfo.java:532)

at com.tivoli.pf.mcr.db.McrDbAction.postRetrieve(McrDbAction.java:943)

at com.tivoli.pf.mcr.db.McrDbAction.dbRetrieve(McrDbAction.java:567)

at com.tivoli.pf.mcr.query.McrQueryAction.fetch(McrQueryAction.java:277)





at com.objectspace.voyager.reference.Function.invoke (Function.java(Compiled Code))


92 Versão 1.2

at com.objectspace.voyager.orb.LocalReference. invoke(LocalReference.java(Compiled Code))




at com.objectspace.voyager.vrmp.VrmpRequestHandler.process (VrmpRequestHandler.java(Compiled Code))

atcom.objectspace.voyager.tcp.RequestManager.process(RequestManager.java(Compiled Code))




2001.03.08 12:58:29.326 McrQueryAction query(McrID,String, Locale) Tivoli Systems Inc. PresentationServices Mcrcom.tivoli.das.ordb.RdbErrorException$ERdbSQLException




at com.tivoli.das.ordb.RdbConnection.commit(RdbConnection.java(Compiled Code))


4.D

etecçãode

Prob.

Gerais

daO

peração

at com.tivoli.das.ordb.RdbTransaction.commit(RdbTransaction.java(Compiled Code))









atcom.objectspace.voyager.orb.ReferenceHolder.invoke(ReferenceHolder.java(Compiled Code))


atcom.objectspace.voyager.vrmp.VrmpRequestHandler.process(VrmpRequestHandler.java(Compiled Code))




94 Versão 1.2


2001.03.08 12:58:29.376 McrQueryAction query(McrID,String, Locale) Tivoli Systems Inc. PresentationServices Mcr FWP1709I The Management ComponentRepository service has detected an unexpected error.

Procedimento de RecuperaçãoExecute este procedimento inteiro na janela de comando do orb.1 nodepósito de instalação:

1. Determine a versão do componente PsJcImpl instalado, emitindoo seguinte comando:

wcmd cds listComponentVersions PsJcImpl

2. Procure todos os ORBs do Tivoli Console para os quais estaversão do componente PsJcImpl foi implementada, digitando oseguinte comando, substituindo o número de versão apropriadopor 1.1.x:

wcmd cds listDeploymentTargetOrbNames [email protected]

O comando retornará algo semelhante ao seguinte:

consolesInDefaultRegion

Nesse exemplo, o resultado do comando era um conjunto deORBs,consolesInDefaultRegion.

3. Utilize o comando wcmd info getOrbsetMembership para obter onome completo do conjunto de ORBs. Por exemplo:

wcmd info getOrbsetMembershipOrbset/consolesInDefaultRegion

O comando retornará algo semelhante ao seguinte:

AU/Orb/dmills2.raleigh.tivoli.com_9991

Se aparecer uma mensagem de erro indicando que o conjunto deORBs não existe, verifique o nome e tente o comandonovamente. Você deve ter, agora, uma lista de todos os ORBsque possuem Tivoli Consoles. Se você receber um único nomeparcial de ORB na etapa 1 (anterior), procure seu nome completode ORB utilizando:

wcmd info getOrbs -oid


4.D

etecçãode

Prob.

Gerais

daO

peração

Isso retornará todos os ORBs com nomes completos de ORBcomo <espaço de nome>/Orb/<nome do orb>. Simplesmentecorresponda o nome do ORB e procure o nome <espaço denome>.

4. Você deve reiniciar o servidor Tivoli DAS antes de encerrar oscomponentes PsNsImpl e PsMcrImpl.Os componentes PsNsImple PsMcrImpl só serão encerrados após o servidor Tivoli DASestar disponível. Se isso não for feito, será necessário reciclar odepósito de instalação. Inicie o servidor Tivoli DAS utilizando oprocedimento descrito emInstalando o Tivoli Kernel Services.

5. Recicle os componentes PsNsImpl e PsMcrImpl utilizando aseqüência de comandos mostrada a seguir:

wcmd accmgr stopComponent -c PsNsImpl

wcmd accmgr stopComponent -c PsMcrImpl

Em seguida, reinicie-os:

wcmd accmgr startComponent -c PsMcrImpl

wcmd accmgr startComponent -c PsNsImpl

Depois, verifique se estão ativos:

wcmd comp status PsNsImpl

wcmd comp status PsMcrImpl

wcmd cli list

A saída de cada comando de status deve indicar que ocomponente está em execução. Procurepsmcre psnsna lista deCLIs exibidas pelo comando list.

6. Recicle todos os ORBs do Tivoli Console utilizando o seguintecomando:

wcmd -i <nome do orb> orb recycle

Isso liberará a ‘interrupção’ do Tivoli Console em cada ORB.

Nota: Se você iniciou os ORBs como serviços, o comandowcmd orb recycle funcionará. Se você iniciou os ORBsmanualmente utilizando LOCK, o comando recycleremoto não reiniciará o ORB; inicie cada ORB do TivoliConsole localmente utilizando LOCK.

96 Versão 1.2

7. Assegure-se de que o ORB do Tivoli Console esteja pronto,emitindo o seguinte comando:

wcmd -i <nome do orb> cli list

Procure porjclauncherna saída.

8. Inicie o Tivoli Console.

Mensagens Adicionais de Erro de Conectividade doServidor Tivoli DAS

A seguir, é mostrada uma lista de mensagens de erro adicionais quepoderão aparecer se houver perda de conectividade do servidorTivoli DAS durante as operações ativas do MCR (ManagementComponent Repository).

FWP1709I: The Management Component Repository service hasdetected an unexpected error.Explicação: O serviço MCR (Management Component Repository)do Tivoli Presentation Services detectou um erro inesperado.

Resposta do Administrador: Verifique se há outros erros nosarquivos de logs da mensagem e entre em contato com o provedorde serviços da Tivoli Systems.

Detecção de Problemas Adicionais:Essa mensagem informativa é oresultado de outros erros que impediram a conclusão de um pedidodo serviço MCR (Management Component Repository). Essa é umamensagem de erro muito muito comum, precedida por outrasmensagens ou exceções com mais detalhes. A seguir, é mostradauma lista de cenários durante os quais a exceção pode serencontrada.

¶ Durante a inicialização do MCR, essa mensagem indica perda deconexão do banco de dados ou um banco de dados danificado noTivoli Presentation Services.

¶ Durante a instalação de componentes, se o MCR achar um errode interpretação inesperado, ou encontrar um problema de dadospersistentes no banco de dados do Tivoli Presentation Services.

¶ Quando o MCR verifica as informações de acesso do usuário.


4.D

etecçãode

Prob.

Gerais

daO

peração

¶ Quando o MCR está consultando o banco de dados do TivoliPresentation Services.

Um outro registrador de rastreios que você pode ativar quandoencontrar esse erro é FWPRdbTraceLogger no ORB do ID. Verifiquese há outros erros nos logs de mensagens e rastreios.

FWP1713E: The Management Component Repository servicecould not store the management components from the file<Caminho do Arquivo do Pacote MC> to the database.Explicação: O Tivoli Presentation Services não pôde armazenar oscomponentes de gerenciamento importados do arquivo especificadono banco de dados.

Resposta do Administrador: Verifique o servidor no qual o bancode dados do Tivoli Presentation Services está instalado, paracertificar-se de que o servidor esteja ativo e conectado à rede e queo DAS (data access server) esteja sendo executado.

Detecção de Problemas Adicionais:Há alguma outra causaimpedindo o serviço MCR (Management Component Repository) dearmazenar dados no banco de dados do Tivoli Presentation Services.Verifique se o servidor de banco de dados pode ser acessado. OMCR pode ter perdido a conectividade de rede com o servidor debanco de dados ou pode ser um erro de socket. O banco de dadosinstalado e os logs de rastreios Rdb devem fornecer mensagens edetalhes adicionais para resolver o problema. Um registrador derastreios adicional que você pode ativar quando encontra esse erro éFWPRdbTraceLogger no ORB do ID. Verifique se há outros errosnos logs de mensagens e rastreios, e certifique-se de que o servidorTivoli DAS esteja sendo executado.

FWP1719E: The database transaction retry count was exceededfor transaction <nome da transação>.Explicação: Ao tentar repetidamente consultar ou gravar no bancode dados do Tivoli Presentation Services, a transação especificadaexcedeu um número predefinido de tentativas de repetições.

Resposta do Administrador: O Tivoli Presentation Services nãopode acessar o banco de dados do Tivoli Presentation Services.

98 Versão 1.2

Verifique o servidor onde o banco de dados do Tivoli PresentationServices está instalado para certificar-se de que o servidor estejaativo e conectado à rede e que o DAS (data access server) estejasendo executado.

FWP1720E: The database transaction <nome da transação> wascanceled.Explicação: Ao tentar consultar ou gravar no banco de dados doTivoli Presentation Services, a transação especificada foi canceladapor um evento externo.

Resposta do Administrador: O Tivoli Presentation Services podeter perdido o acesso ao banco de dados do Tivoli PresentationServices. Verifique o servidor onde o banco de dados do TivoliPresentation Services está instalado para certificar-se de que eleesteja ativo e conectado à rede e que o DAS (data access server)esteja sendo executado.

Detecção de Problemas Adicionais:Uma transação do banco dedados iniciada pelo MCR foi cancelada por algum evento externo. Oevento externo é o problema mais provável no banco de dadosinstalado. Verifique os logs de mensagens e rastreios no ORB do IDpara obter outras mensagens que possam indicar problemasanteriores no banco de dados. Verifique também no ORB do ID sehá mensagens emitidas pelo banco de dados. Entre em contato como administrador do banco de dados para obter assistência. Um outroregistrador de rastreios que você pode ativar quando encontrar esseerro é o FWPRdbTraceLogger no ORB do ID.

Restaurando o Servidor Tivoli DASPara restaurar o servidor Tivoli DAS, siga estas etapas:

1. Utilizando a mídia de instalação, remova a instalação e, emseguida, reinstale o servidor Tivoli DAS no %DASDIR%.

2. Encerre o servidor DAS.

3. Restaure o servidor DAS, restaurando os arquivos no%TKS_DASDIR% a partir da mídia de backup.

4. Reinicie o servidor DAS.


4.D

etecçãode

Prob.

Gerais

daO

peração

Para obter informações adicionais sobre como encerrar e iniciar oservidor Tivoli DAS, consulteInstalando o Tivoli Kernel Services.

Servidor MQSeriesHá vários erros que você pode encontrar ao trabalhar com o servidorMQSeries. Um erro é que um servidor MQSeries em execução emum sistema Microsoft Windows pode gerar muitos eventos, o quepoderia encher o log de eventos do aplicativo. Para corrigir esseproblema, aumente o tamanho do log de eventos do aplicativo ouative o reinício cíclico de eventos no log.

A maioria dos problemas no servidor MQSeries são devidos aoservidor entrar em um estado inconsistente. Você deve estar apto aidentificar esse estado inconsistente quando ele ocorrer, e estarpronto para tomar uma ação de correção apropriada. Essas etapas deação de correção incluem:

1. Verificar se o gerenciador de filas está ativo e aceitandoconexões com onetstat. Digite o seguinte a partir de uma linhade comandos para verificar se o ORB possui conexões de socketabertas para a porta do MQSeries:

netstat -an | grep 1414

Se o servidor estiver inativo, reinicie-o.

2. Verificar se o intermediário está sendo executado, digitando oseguinte a partir de uma linha de comandos:

dspmqbrk

Se o intermediário não estiver sendo executado, reinicie-odigitando o seguinte a partir de uma linha de comandos:

strmqbrk

3. Certificar-se de que o gerenciador de filas não estejasobrecarregado com assinantes.

4. Executar o textdemo para ver se o servidor está funcional.

Se você tiver executado as etapas anteriores e ainda estiverencontrando problemas com o servidor MQSeries, pode ser

100 Versão 1.2

necessário excluir e recriar o intermediário. Execute as seguintesetapas para excluir e recriar o intermediário:

1. Todos os ORBs para o servidor MQSeries devem ser encerrados.

2. Digite o seguinte em uma linha de comandos para encerrar ointermediário:

endmqbrk

3. Digite o seguinte em uma linha de comandos para excluir ointermediário:

dltmqbrk -m QM_host name

4. Digite o seguinte em uma linha de comandos para recriar einiciar o intermediário:

strmqbrk

Se depois de excluir e recriar o intermediário, você ainda encontrarproblemas, será necessário remover a instalação e reinstalar oservidor MQSeries.

ORBs de ID e BootprintHá alguns problemas que você pode encontrar ao trabalhar com oORB 1 e 2 dodepósito de instalação. Esses problemas são listados aseguir, juntamente com explicações do erro e ações de correção quepodem ser executadas para resolver os erros.

¶ O ORB do Depósito de Instalação não funciona se oMicrosoft IIS estiver em execução.

O ORB do depósito de instalação pode não funcionarcorretamente nos sistemas Microsoft Windows se o MicrosoftInternet Information Service (IIS), ou outro servidor Web, estiversendo executado. Um sintoma desse problema é que olançamento do ORB do depósito de instalação resulta em umamensagem de erro no log de mensagens do ORB, localizado no$ORBDIR/log/stdout, indicando que″http://nome-do-host″ estavasendo utilizando. Um outro sintoma desse problema é que vocênão pode conectar o navegador da Web aohttp://nome-do-host/Repository após o ORB estar em execução.


4.D

etecçãode

Prob.

Gerais

daO

peração

Para corrigir o problema, execute um dos procedimentos a seguirantes de lançar o ORB do depósito de instalação:

v Encerre ou remova a instalação do Microsoft InternetInformation Service ou outro servidor Web

v Configure o servidor Web existente para utilizar uma portadiferente de 80.

¶ Tempo de lançamento para ORBs.

O tempo de lançamento para o ORB de um depósito deinstalação ou de um bootprint, após a instalação e lançamentoiniciais, depende de uma série de fatores, tais como:

v A quantidade de memória disponível e a velocidade doprocessador da máquina

v Quais outros serviços e aplicativos estão em execução namáquina

v A localização dos servidores Tivoli DAS (Data AccessServices) e MQSeries em relação à máquina

v A localização da máquina do depósito de instalação emrelação à máquina de bootprint

v A freqüência com que os bancos de dados DB2 sãootimizados para desempenho, utilizando o script runstats

O tempo de lançamento do ORB também é afetado pelosoftware de gerenciamento Tivoli que está utilizando o TivoliKernel Services. Pressupondo os requisitos mínimos develocidade do processador e de memória, estima-se que olançamento do ORB do depósito de instalação seja concluído emaproximadamente 5 minutos. O lançamento do segundo ORB nodepósito de instalação ou o lançamento de um ORB de bootprintgeralmente é concluído em aproximadamente 2,5 minutos. Paraverificar o processo do ORB, você pode monitorar o log demensagens do ORB.

Esses tempos devem ser considerados o melhor caso dehardware mínimo recomendado, e foram medidos em nossolaboratório de testes sem o software de gerenciamento Tivoli

102 Versão 1.2

instalado. Os tempos de lançamento aumentam à medida queaplicativos Tivoli são adicionados à configuração. Informaçõesmais precisas estão incluídas na documentação fornecida com osoftware de gerenciamento Tivoli que você adquiriu.

¶ Erro no MFC42U.DLL ao executar o ORB de bootprint noWindows NT

Quando iniciar o ORB de bootprint em um sistema MicrosoftWindows NT 4.0, após a conclusão do programa de instalaçãode bootprint, você pode encontrar o seguinte erro:

The ordinal 6871 could not be located in the dynamiclink library MFC42U.DLL

Isso é causado por uma versão de nível mais baixo do arquivoMFC42U.DLL no sistema de destino. Localize o MFC42U.DLLno diretório do Windows e substitua-o pela versão atualizadafornecida com o Tivoli Kernel Services. O DLL apropriado paraser utilizado é\TivoliBP\orb.1\lib\w32-ix86\mfc42u.dl.Após a substituição do DLL, você deve reinicializar a máquina.O ORB de bootprint deve ser executado conforme previsto.

¶ O ORB está recebendo exceçõesjava.net.UnknownHostException

v Durante a instalação ou execução normal do Tivoli KernelServices, um ORB pode receber inesperadamente exceçõesjava.net.UnknownHostException. Essa exceção geralmenteocorre em ambientes de múltiplos domínios, onde o nomecurto para a máquina, em vez do nome completo do host, foiutilizado ou exportado.

Para determinar se essa foi a causa da exceção, localize aexceção no log de saída LOCK (Local ORB Creator andKiller). Consulte “LOCK (Local ORB Creator and Killer)” napágina 143 para obter mais informações sobre o log de saídaLOCK.

v Para resolver esse problema, verifique se você possuiconectividade de rede para ele, utilizando o comandoping.Se você tiver conectividade utilizando o nome completo dohost, a utilização do nome curto é a causa mais provável daexceção. Uma alternativa para essa situação é garantir que


4.D

etecçãode

Prob.

Gerais

daO

peração

todas as máquinas na instalação do Tivoli Kernel Servicessejam identificadas por seus nomes curtos, executando asseguintes etapas:

1. Encerre todos os ORBs em execução na instalação.

2. Modifique os arquivos /etc/hosts em cada máquina paramapear os nomes curtos de cada máquina para o nomecompleto do host. Certifique-se de incluir a máquina naqual a exceção foi encontrada.

3. Reinicie os ORBs que estavam em execução.

4. Reinicie o ORB que recebeu inicialmente a exceção, ouexecute o programa de instalação novamente se a falhativer ocorrido durante uma instalação.

¶ wcmd direcionado para um ORB falha com a mensagemFNGOB3013E

Você tem certeza de que um ORB está ativo e em execução, masquando direciona umwcmd para ele, utilizando a opção-i,aparece a seguinte mensagem:

FNGOB3013E No CLI server found for ORB ID nnnnnnnn

Verifique o log stderr.txt localizado em $ORBDIR/log/stderr paraver se ocorreu um java.net.UnknownHostException. Se tiverocorrido uma exceção, consulte as informações de alternativasno item de lista anterior.

¶ Mensagens de erro do servidor MQSeries após finalizaçãoanormal do ORB

Após uma finalização anormal do ORB, o Messaging Servicepode gerar mensagens de erro semelhantes às seguintes no logde mensagens do ORB:

FNGMS0007E Subscription references non-existent queuesuffixed.java.lang.Object/com.tivoli.tes.TESTopicImpl/

FNGMS0007E Subscription references non-existent queuejava.lang.Object/com.tivoli.tes.TESTopicImpl

FNGMS0008E Orphaned subscriber discoveredjava.lang.Object/com.tivoli.tes.TESTopicImpl

104 Versão 1.2

FNGMS0009I MQSeries subscription was successfullyderegisteredjava.lang.Object/com.tivoli.tes.TESTopicImpl

FNGMS0011E Unable to delete orphaned subscriber,MQSeries may become unstable java.lang.Object

Essas mensagens, que aparecem a cada 10 minutos, são causadaspelo Messaging Service que tenta excluir filas que já foramexcluídas. Essas mensagens não representam um problema epodem ser ignoradas.

¶ Reinstalar sempre o MQSeries se você estiver reinstalando oTivoli Kernel Services

Se você estiver reinstalando o Tivoli Kernel Services, é precisosempre reinstalar o MQSeries. O MQSeries não possui algumasinformações de estado armazenadas nele. Se você reutilizar omesmo servidor MQSeries para várias instalações, podemocorrer problemas.

Tivoli ConsoleHá alguns problemas que você pode encontrar ao trabalhar com oTivoli Console. Esses problemas são listados a seguir, juntamentecom explicações do erro e ações de correção que podem serexecutadas para resolver os erros.

¶ Os menus de contexto sempre são abertos à direita e abaixo docursor, independentemente da posição do cursor. Se você abrirum menu de contexto quando o cursor estiver próximo ao cantoinferior direito da tela, o menu de contexto se abriráparcialmente fora da tela. Você deve reposicionar ouredimensionar o Tivoli Console até que possa ver o menu decontexto por completo.

¶ As teclasPgUp e PgDn não funcionam corretamente para rolaro portfólio. Para rolagem do portfólio, utilize as teclas de seta oua barra de rolagem.

¶ O botão de rolagem em um mouse não é suportado no TivoliConsole. Para manipular as barras de rolagem, utilize oindicador do mouse ou um atalho do teclado.


4.D

etecçãode

Prob.

Gerais

daO

peração

¶ Quando você redimensiona o Tivoli Console, não ocorre aquebra da barra de menus para outra linha; portanto, algunsmenus podem ser ocultados. Para evitar este problema,redimensione sempre o Tivoli Console, de modo que a barra demenus inteira fique visível.

¶ O Tivoli Console não suporta resoluções da tela com apenas 256cores.

¶ Quando você fecha uma janela que é filha de uma janela detarefa desacoplada, o foco sempre retorna para o Tivoli Consoleem vez da janela de tarefa pai.

¶ Se a sessão entre o Tivoli Console e o servidor for perdida, evocê reiniciar sessão imediatamente no Tivoli Console, oportfólio poderá não refletir as novas tarefas que foramadicionadas como resultado da adição de novas funções aousuário existente. Para resolver este problema, saia do TivoliConsole e reinicie-o. As novas tarefas serão exibidas noportfólio.

¶ Às vezes quando você sai do Tivoli Console, as janelas detarefas se fecham, mas a janela do Tivoli Console permaneceaberta. Saia novamente do Tivoli Console e esta janela seráfechada.

¶ No sistema operacional AIX, o cursor deatividade(a ampulhetacom uma seta) no Tivoli Console é maior do que o cursornormal.

¶ Ocasionalmente, quando você fecha determinados tipos dejanelas no Tivoli Console, o portfólio se abre automaticamente.

¶ Pressionar a teclaEsc nem sempre cancela ou fecha uma janelade tarefa. Para fechar a janela de tarefa, clique no botãoCancelar ou noX no canto superior da janela.

¶ Em sistemas Sun Solaris, as teclas aceleradoras nem semprefuncionam em botões da janela. Para resolver isso, vá para obotão e pressioneEnter, ou clique diretamente no botãoutilizando o indicador do mouse.

106 Versão 1.2

¶ Os menus de contexto podem não se fechar quando você altera ofoco de uma janela de tarefa para outra. Para fechar o menu decontexto, clique em qualquer lugar na janela que contenha omenu de contexto.

¶ Na barra de tarefas, dicas de ferramentas são mostradas àesquerda da posição do cursor e as dicas de ferramentas longaspodem aparecer fora da tela à esquerda. Você deve reposicionarou redimensionar o Tivoli Console até que possa ver as dicas deferramentas por completo.

¶ Quando você clica em uma tarefa no portfólio, o cursor não éalterado para o estado de espera (a ampulheta) ou para o estadode atividade (a ampulheta com uma seta) até que o mouse sejalevemente movido. Para resolver isso, mova sempre um pouco omouse após clicar em uma tarefa no portfólio.

¶ Quando você imprimir um tópico no Tivoli Assistant, talvez aspáginas impressas não representem precisamente o conteúdo dotópico como é exibido no Tivoli Assistant.

¶ Quando você estiver trabalhando com tabelas, clique nos botõesde filtro somente uma vez. Múltiplos cliques nos botões de filtropodem abrir várias janelas. Se várias janelas forem abertas,feche-as, pressionandoAlt + F4 .

¶ Na primeira vez em que o Tivoli Console é iniciado após ainstalação do Tivoli Kernel Services a partir de um CD-ROM,um usuário pode ver a mensagemError loading help set.Isso indica que o depósito de instalação não construiucorretamente o auxílio online. Para reconstruir o auxílio online,faça o seguinte:

1. Encerre o ORB do depósito de instalação.

2. Inicie o ORB do depósito de instalação.

3. Após o ORB do depósito de instalação ser inicializado, emitao seguinte comando:

wcmd psmcr rebuildHelp

Talvez o auxílio online não esteja disponível por um tempo.Você pode saber quando o auxílio online está disponível,


4.D

etecçãode

Prob.

Gerais

daO

peração

verificando o arquivo pf.hs ou pf_<idioma>.hs no depósitode instalação: http://installation.depot.machine/help.

¶ Shift + F10 não abre atualmente o menu de texto do item emfoco.

¶ Em sistemas Sun Solaris, os ORBs são executados somente emuma ambiente inglês, independentemente da definição LANG. OTivoli Presentation Services não suporta outras definiçõesLANG.

¶ Configurações multilíngües do banco de dados, utilizando umconjunto de códigos UTF-8, não funcionam. O conjunto decódigos UTF-8 não pode ser utilizado para um ambiente delocalidade misto. Isso pode causar perda de dados.

¶ Se você encontrar um problema ou tiver um problemarelacionado ao auxílio online do Tivoli Console, será necessáriocompactar o conteúdo da seguinte estrutura de diretórios comoum arquivo ZIP, para a determinação de problemas:

Windows - %TKS_BASEDIR%\ext\ibmhttpd\tksDocs\help

UNIX - %TKS_BASEDIR%/ext/ibmhttpd/tksDocs/help

onde%TKS_BASEDIR% é o diretório onde você instalou odepósito de instalação do Tivoli Kernel Services.

Detecção de Outros Problemas OperacionaisO Tivoli Kernel Services Command Referencecontém uma lista decomandos do Tivoli Kernel Services. Esses comandos podem sermuito úteis ao tentar detectar erros do sistema e outros problemas. Alista a seguir contém alguns comandos adicionais de detecção deproblemas que podem ajudar nesse processo:

¶ wcmd comp findClass <nome><versão><nome da classe>-Tenta encontrar a classe especificada a partir do componenteClassLoader especificado.

Exemplo: wcmd comp findClass cm5.1.4com.tivoli.core.component.Component

¶ wcmd comp findNLSResource <recurso>- Tenta encontrar orecurso NLS utilizando o ResourceBundleClassLoader. Se

108 Versão 1.2

encontrado, a URL da qual o recurso pode ser encontrado seráimpressa. Isso mostrará o arquivo JAR a partir do qual elepoderá ser encontrado.

Exemplo: wcmd comp findNLSResource welcome/banner.gif

¶ wcmd comp findResource <nome> <versão> <recurso>-Tenta encontrar um recurso a partir do componente ClassLoaderespecificado. Se encontrado o recurso, a URL do recurso seráimpressa, o que indicará de qual arquivo JAR o arquivo éproveniente.

Exemplo: wcmd comp findResource cm 5.1.4com/tivoli/core/component/IComponent.class.

¶ wcmd comp getNLSString <nome do pacote> <chave>-Utiliza o ResourceBundleClassLoader para encontrar oResourceBundle especificado e obter a chave especificada. Eleimprimirá qual localidade está sendo solicitada, qual localidadefoi encontrada e se a chave existe no ResourceBundle.

Exemplo: wcmd comp getNLSStringcom.tivoli.core.component.ComponentManagerResourcesCOMPONENT_USAGE

¶ wcmd comp listNLS - Lista a versão de tempo de execução doarquivo index.rb que está sendo utilizado. Este é ummapeamento do nome do recurso para o nome do componente

Exemplo:com/tivoli/core/component/ComponentManagerResources.properties=cmMessages

¶ wcmd comp listNLSUrls - Lista as URLs atualmente presentesno ResourceBundleClassLoader.

SJI (Simple Jar Installer)A SJI (Simple Jar Installation) funciona com a LCI para instalarcomponentes. A LCI trata de implementação, retração, upgrade ereversão de componentes ORB. Quando um componente precisa serinstalado, a LCI certifica-se de que ele esteja disponível no depósitode componentes e que todos os componentes de pré-requisito estejamdisponíveis. Em seguida, marca os componentes desejados comoutilizáveis e mantém uma lista de tais componentes. A SJI monitora


4.D

etecçãode

Prob.

Gerais

daO

peração

esta lista de componentes utilizáveis, instala esses componentes emantém uma lista de todos os componentes instalados. A SJI sófunciona com, e lista,componentes do tipo jar simples, e nãosubstitui quaisquer ferramentas do Tivoli software distribution.Utilizando osji wcmds, você pode monitorar a lista de componentesutilizáveis, componentes instalados e forçar o reinício do processo deinstalação.

A lista a seguir contém comandos SJI que também podem ajudar noprocesso de detecção de problemas:

¶ wcmd sji showQueue- Mostra a fila que contém oscomponentes em que a SJI está atualmente trabalhando.

¶ wcmd sji getUsableList - Exibe a lista de componentesutilizáveis.

¶ wcmd sji getInstalledList - Exibe a lista de componentesinstalados.

¶ wcmd sji listDiff - Mostra a diferença entre as duas listas semmostrar que SJI está atualmente trabalhando.

¶ wcmd sji processQueue- Força o reinício da fila SJI, apesar deaguardar durante um determinado período de tempo.

110 Versão 1.2

Detecção de Problemas emComponentes

Cada componente no Tivoli Kernel Services possui seus própriosregistradores de mensagens e de rastreios. O modo de ativação edesativação dos registradores de mensagens e de rastreios é comumpara todos os componentes. Todos os componentes também possuemsuas próprias considerações de detecção de problemas e problemasexclusivos que podem ocorrer. A primeira seção deste capítulodescreve o processo comum para ativar os registradores demensagens e rastreios, e a segunda seção descreve as práticas equestões de detecção de problemas específicas do componente.

Detecção de Problemas Comuns dos ComponentesUma importante ferramenta de detecção de problemas é a capacidadede utilizar os logs de rastreio para registrar ações do sistema no nívelde código. Como o rastreio fica, por padrão, desativado, ele deve serativado para cada componente sobre o qual você deseja reunirinformações. As seções a seguir contêm as etapas necessárias paraativar e desativar um registrador de rastreios individual. Consulte asseções de componentes deste capítulo para obter os registradores demensagens e de rastreios específicos do componente.

Ativando o Rastreio de ComponentesAs etapas a seguir mostram como listar os registradores de rastreiosativados, enviar suas mensagens de rastreio para um arquivo derastreios padrão e ativar o rastreio para um componente específico:

5


5.D

etecçãode

Problem

asem

Com

ponentes

1. Utilize o comandowcmd log ls para listar os nomes dosregistradores de rastreios atualmente ativos para o ORB local.Observe que este comando lista todos os elementos de loginstanciados. Para listar os nomes em uma máquina diferente,você pode utilizar este comando:wcmd -i <orb id> log ls -trace

2. Agora, se você desejar que o rastreio seja direcionado para oarquivo de rastreio padrão trace1.log, basta ativar o rastreio parao grupo de logs:wcmd log trace -g log -set isLogging=true

3. Você pode verificar isso utilizando este comando:wcmd log trace -g log -contents

4. O exemplo a seguir mostra como ativar o rastreio para oregistrador de rastreios log.managerTrace. Consulte a Tabela 5 napágina 120 para obter uma lista de todos os registradores demensagens e de rastreios do Tivoli Kernel Services. Se você nãodeterminar um registrador de rastreios específico, todos osregistradores de rastreios do sistema serão ativados. Issodegradará o desempenho do sistema:

wcmd log trace log.managerTrace -set isLogging=true

Comando Wcmd log setLoggingSe um registrador não puder ser ativado ou desativado utilizando aopção-set isLoggingno comandowcmd log messageou wcmd logtrace, há um outro comando que pode ser utilizado para ativar oudesativar um registrador de mensagens ou rastreios. Este comando,wcmd log setLogging, pode fazer com que a tarefa Configurando oLog no Tivoli Console exiba um estado incorreto para umregistrador de mensagens ou rastreios, até que o ORB do registradorseja reiniciado. Os comandoswcmd log messagee wcmd log tracealteram os dados de configuração referentes ao estado de umregistrador, e este comando faz uma alteração não-persistente aoestado de um registrador. Portanto, utilize este comando apenasquando um registrador de mensagens ou rastreios não puder serativado ou desativado. Informações adicionais sobre este comandosão mostradas a seguir.

112 Versão 1.2

Sintaxe

wcmd log setLogging -llogger_name–f { true | false }

Descrição

O comandowcmd log setLoggingfaz uma alteração não-persistenteao estado de um registrador de mensagens ou rastreios O comandoativa ou desativa a capacidade de um registrador para capturarregistros do log de mensagens ou rastreios.

Opções

logger_nameEspecifica o nome do registrador a ser ativado oudesativado. Utilize o comandolog ls para obter uma lista deregistradores em um ORB.

true Ativa o registrador identificado porlogger_name.

false Desativa o registrador identificado porlogger_name.

Autorização

Requer direitoslogConfigure sobresistema/serviços/Log.

Exemplos

Para desativar o log para um registrador orb.ProxyTrace, utilize aseguinte sintaxe:wcmd log setLogging -l orb.ProxyTrace -ffalse

Desativando o Rastreio de Componentes do LogQuando o registrador de rastreios não é mais necessário, ele deve serdesativado para que não continue impactando o desempenho dosistema. Para encerrar o log de rastreios, siga este procedimento.

1. Antes de alterar os valores de log, exiba os valores atuaisemitindo estes comandos:

wcmd log handler console -contents

wcmd log trace <traceLoggerName> -contents


5.D

etecçãode

Problem

asem

Com

ponentes

2. Retorne o log para os valores padrão:

wcmd log handler console -set formatterNames=minimal

wcmd log trace <traceLoggerName> -set isLogging=falseUm comando opcional:

wcmd log trace <traceLoggerFile> -sethandlerNames=trcFile

Registradores de Componentes do Tivoli KernelServices

Cada componente no Tivoli Kernel Services contém um registradorde mensagens, um registrador de rastreios ou ambos. A tabela aseguir fornece uma lista de todos os componentes do sistema, equaisquer registradores que eles contenham.

Tabela 4. Registradores de Componentes do Tivoli KernelServicesComponente Registrador de

MensagensRegistrador deRastreios

Activation Framework orb.msgLogger orb.activation

Administrative Console mac.MessageLogger mac.TraceLogger

CLI (Command LineInterface)

cli cliTrace

Component DistributionService

Nenhum registrador demensagens específicodo componente

Nenhum registrador derastreios específico docomponente

Component Manager orb.componentManager orb.componentManager

114 Versão 1.2

Tabela 4. Registradores de Componentes do Tivoli KernelServices (continuação)Componente Registrador de


Configuration cfg.utilMsgLogger,cfg.orbMsgLogger

cfg.baseprefs,cfg.coalesce,cfg.dircache,cfg.dirprefs,cfg.eventsender,cfg.fileprefs, cfg.misc,cfg.omdprefs,cfg.orbres, cfg.orbutil,cfg.owner,cfg.persprefs,cfg.simpleprefs,cfg.swprefs, cfg.synch

DCM (Data ConnectionManager)

dcm.msglogger dcm.trclogger

DCI (Depot ComponentInstaller)


cds.DepotInstallerTrace

Directory directory.msglogger directory.dirservice,directory.directorytrace,directory.topleveltrace,directory.remotehashtablecontexttrace,dirctory.conntrace,directory.slashtrace,directory.dbslashtrace,directory.direventservice,directory.direventtrace,directory.dirvault,directory.wrappeddireventcontexttrace,directory.parsertrace,directory.smartenum

Domain Builder DomainBuilderLog DomainBuilderTrace


5.D

etecçãode

Problem

asem

Com

ponentes



Gateway aolog, nels,SnmpManagerLogger,GatewaySnmplog,correlatorMessage,GatewayIPlog

aotrace, neltrace,SnmpManagerTracer,GatewaySnmp,correlatorTrace,GatewayIP

InfoService Nenhum registrador demensagens específicodo componente

orb.InfoService

Java Policy Nenhum registrador demensagens específicodo componente

Nenhum registrador derastreios específico docomponente

CLI (Local ComponentInstaller)


cds.LocalInstallerTrace

LOCK (Local ORBCreator and Killer)


LOCK_TRACE

ORB orb.msglogger orb.tracelogger,orb.VoyagerPolicy,orb.tcpTransport,orb.tracer,orb.localReference,orb.proxyTrace,voyagerTracer

Network Security Nenhum registrador demensagens específicodo componente

ns.tracer, ns.ssltracer

Security sec.acnMessage,sec.aznMessage,sec.cacheMessage

sec.acnTrace,sec.aznTrace,sec.cacheTrace

Security Registry TMDMessageLogger TMDTraceLogger

116 Versão 1.2



Serialized Persistence ds.SerializedPersistenceLog

ds.SerializedPersistenceService,ds.SerializedPersistence,ds.SynchSerializedPersistence

Service Manager sm.messageLogger sm.traceLogger

SNMP Service Nenhum registrador demensagens específicodo componente

snmp

TimeSync Nenhum registrador demensagens específicodo componente

timeTrcLogger

Activation FrameworkO Activation Framework define os objetos utilizados na ativação (oprocesso de procurar um objeto armazenado e trazê-lo para amemória), OIDs (identificadores de objetos). Este framework éutilizado pelo Tivoli Kernel Services para fornecer OIDs de longaduração que nunca são alterados, podem ser utilizados por qualquerORB do sistema e podem ser persistentes. O registrador demensagens para este framework é o orb.msgLogger. Este registradorgrava quaisquer problemas de segurança encontrados durante ainicialização do ORB. O rastreador para este framework é oorb.activation. Este registrador grava as exceções lançadas noActivation Framework, tais como exceções de ID, exceções deDirectory Service e exceções de segurança. Também registrainformações de entrada e saída para cada ativação de OID.


5.D

etecçãode

Problem

asem

Com

ponentes

Administrative ConsoleO Tivoli Kernel Services Administrative Console é uma GUI(interface gráfica com o usuário) que permite a configuração e ogerenciamento do sistema distribuído. ConsulteIntroduzindo aAdministração do Tivoli Kernel Servicespara obter informaçõesdetalhadas sobre o conteúdo e a função do console.

Testando o Estado do ComponenteO estado do console é indicado principalmente pela instalaçãobem-sucedida do ORB do depósito de instalação e pelo console seroperacional. Algumas mensagens no tksOut.log que indicam umainstalação bem-sucedida de ORB do depósito de instalação são:

FNGCP0069I Todos os componentes foram iniciados. Talvezalguns componentes não estejam prontos para utilização.

FNGTM0005I Linha de base concluída em nnnnnnmilissegundos

FWP1734I O utilitário que foi iniciado pelo MCR(Management Component Repository) para construir a ajudafoi concluído com êxito.

Uma outra indicação da instalação bem-sucedida do ORB dodepósito de instalação é que o MCR (Management ComponentRepository) concluiu todas as importações. Essas importaçõesocupam o registro de segurança com as funções necessárias para oTivoli Kernel Services Administrative Console. Digite o seguinte apartir de uma linha de comandos:

wcmd ssm listChildren -p PS/PSServer/Roles/MACImpl/5.2.0

A saída deste comando é semelhante à seguinte:

Children of PS/PSServer/Roles/MACImpl/5.2.0:

MACInstallUser: ROLE

MACLimitedSecurityUser: ROLE

118 Versão 1.2

MACLoggingUser: ROLE

MACOrbUser: ROLE

MACResourceUser: ROLE

MACSecurityUser: ROLE

MACSeniorUser: ROLE

Uma última maneira de garantir que a instalação do ORB dodepósito de instalação tenha sido bem-sucedida é verificar se orepositório, localizado em http://nome-do-host/Repository, está sendoexecutado, digitando este endereço em um navegador da Web. Umíndice do repositório deve ser exibido no navegador, se este estiverem execução. Execute esta verificação após o ORB 1 ser executado,mas antes de o ORB 2 ser lançado.

Uma outra técnica de detecção de problemas no Tivoli KernelServices Administrative Console é verificar o estado do TivoliPresentation Services e dos componentes básicos do Tivoli KernelServices.

¶ Para verificar se o Tivoli Presentation Services está sendoexecutado e disponível no ORB do depósito de instalação, digiteo seguinte em uma linha de comandos:

wcmd svc ls DSM

Este comando deve retornar valores, incluindoPsNsImpl ePsMcrImpl .

¶ Para verificar se o Tivoli Presentation Services está executando oconsole, digite o seguinte em uma linha de comandos no ORBdo console:

wcmd svc ls LSM

Este comando deve retornar valores, incluindoPsJCLauncherService.

¶ Para verificar se todos os componentes básicos do Tivoli KernelServices estão funcionando, digite o seguinte em uma linha decomandos:


5.D

etecçãode

Problem

asem

Com

ponentes

wcmd dir ls

wcmd ssm listAllChildren -p root

Registradores de Mensagens e RastreiosO registrador de mensagens do Tivoli Kernel Services AdministrativeConsole é o mac.MessageLogger. Este registrador é utilizado pararegistrar mensagens de exceção geradas durante o processamento dosdrivers de tarefas do Tivoli Kernel Services, exceções Javauncaughte outras exceções exibidas na GUI. Digite o seguinte em uma linhade comandos para ativar o log de mensagens:

wcmd log message mac.MessageLogger -set isLogging=true

O registrador de rastreios do Tivoli Kernel Services AdministrativeConsole é o mac.TraceLogger. Este registrador é utilizado pararastrear as mesmas exceções encontradas no registrador demensagens; somente este log fornece mais contexto para asexceções. O objetivo dos rastreadores é ajudar a mostrar o fluxo deexecução de códigos e, assim, determinar onde ocorrem as falhas. Oregistrador de rastreios do Tivoli Kernel Administrative Consolemonitora getters/setters, leituras e gravações de backend e acesso aoscomponentes do Tivoli Kernel Services. Digite o seguinte em umalinha de comandos para ativar o log de rastreios:

wcmd log message mac.TraceLogger -set isLogging=true

Detecção de Problemas AdicionaisO Tivoli Kernel Services Administrative Console é constituído devários pacotes, que correspondem aos vários drivers de tarefas.Procurando o nome do pacote no log de rastreios, você podedescobrir qual driver de tarefa está com problema. Utilize a tabela aseguir para mapear os nomes de pacotes para drivers de tarefas.

Tabela 5. Nomes de pacotes/drivers de tarefas do TivoliKernel Services Administrative ConsoleNome do Pacote Driver de Tarefa (Função)

com.tivoli.core.console.common.abstractfu

Função comum do driver de tarefa

120 Versão 1.2

Tabela 5. Nomes de pacotes/drivers de tarefas do TivoliKernel Services Administrative Console (continuação)Nome do Pacote Driver de Tarefa (Função)

com.tivoli.core.console.common.util Função comum do driver de tarefa

com.tivoli.core.console.component GUI de Propriedades doComponente, GUI de Upgrades doComponente

com.tivoli.core.console.config Editor e utilitários genéricos deconfiguração

com.tivoli.core.console.dcm Tarefa Exibir Conexões de Dados

com.tivoli.core.console.directory Tarefa Exibir Diretório

com.tivoli.core.console.filter Base comum para filtrar GUIs(Segurança, ORB e Log)

com.tivoli.core.console.gateway Configuração do Gateway SNMP,Configuração do Gateway IP,Configuração do NEL

com.tivoli.core.console.hf Função comum para tabelas,exploradores, controladores de dadose provedores de dados

com.tivoli.core.console.ipconfig Navegador de Config de IP

com.tivoli.core.console.logging Tarefa Administrar Log

com.tivoli.core.console.meta Função comum de driver de tarefapara edição de propriedade

com.tivoli.core.console.mmcd Tarefa Implementar Conjuntos deORBs, tarefa Exibir Depósito deComponentes

com.tivoli.core.console.orb Tarefa Gerenciar ORBs

com.tivoli.core.console.sec Tarefa Administrar Segurança

com.tivoli.core.console.tes Tarefa Mostrar Estatísticas doMessaging Service

Problemas ComunsHá alguns problemas comuns que você pode encontrar ao trabalharcom o Tivoli Kernel Services Administrative Console. Um problemaé não conseguir iniciar sessão no console.


5.D

etecçãode

Problem

asem

Com

ponentes

¶ Verifique se você possui uma conta de kernel do Tivoli KernelServices, digitando o seguinte em uma linha de comandos:

Nota: Você terá que utilizar o ID de usuáriosuperadmin emtodos os comandos seguintes, e utilizarpasswordquandouma senha for solicitada.

wcmd ssm listAttributes -p <PathNameToKernelAccount>principal

¶ Verifique se o proprietário possui funções atribuídas a ele,digitando o seguinte em uma linha de comandos:

wcmd ssm listAttributes -p <PathNameToPrincipal>staticRole filterRole

¶ Se você encontrou a conta mas não se lembra de sua senha,digite o seguinte em uma linha de comandos para alterar suasenha:

wcmd ssm modifyAttributes -p<PathNameToKernelAccount> -op replace \password=newpassword

¶ Certifique-se de que tenha digitado o nome completo docaminho da conta, por exemplo:

PathNameToKernelAccount=MyOU/myFolder/JoeSmith

Um outro problema comum é que as tarefas não aparecem noportfólio, ou não é possível acessar um serviço utilizando uma tarefado portfólio.

¶ Certifique-se de que as funções corretas estejam atribuídas aoseu usuário (proprietário) para lançar e utilizar o driver detarefas do Tivoli Kernel Services Administrative Console.

¶ Para listar todas as funções do usuário, digite o seguinte em umalinha de comandos:

wcmd ssm listAttributes -p <PathNameToPrincipal>staticRole filterRole

122 Versão 1.2

Command Line InterfaceOs comandos do Tivoli Kernel Services permitem que você executeoperações do sistema a partir de uma CLI (interface de linha decomandos) em vez de utilizar o Tivoli Console. Isso fornece acessoao ORB, seus serviços e aplicativos.

Registradores de Mensagens e RastreiosO registrador de mensagens de command line interface é o cli. Eleregistra todas as mensagens. O registrador de rastreios de commandline interface é o cliTrace. Ele registra toda a entrada/saída, detalhesde execução de comandos e problemas de carregamento de pacotes.

Algumas mensagens comuns são listadas a seguir:

¶ Não foi possível abrir o socket, código:%d

Causa: O código numérico depende da plataforma. Aparece emsistemas Microsoft Windows com pilhas de winsock danificadas.

¶ Não foi possível conectar-se ao servidor com númerode porta%d (caminho%s):%s

Causa: Está faltando um processo do ORB ou o Serviço de CLIainda não foi iniciado.

¶ Tempo limite aguardando confirmação do servidor

Causa: O ORB não respondeu em um tempo razoável. A CPU eo ORB estão ocupados.

¶ FNGOB3001W Ocorreu uma IOException de CLI: exceção

Causa: Falha de comunicação no processo dowcmd. Causadogeralmente pelo pressionamento deCtrl+C no meio de umcomando.

¶ FNGOB3006E Pacote de comandos nome_do_pacote nãoencontrado.

Causa: O pacote não foi registrado com a CLI. Um tipo ou ocomponente que registra o pacote não está executando.

¶ FNGOB3009E O comando nome_do_comando não existe.


5.D

etecçãode

Problem

asem

Com

ponentes

Causa: O ORB de destino encontrou a implementação dopacote, mas o método do comando não existe. Geralmente umerro de grafia.

¶ FNGOB3011E valor recebido valor_esperado Esperado

Causa: Uma falha de protocolo entre owcmd e o Serviço deCLI.

¶ FNGOB3013E Nenhum servidor de CLI encontrado para oID do ORB id_do_orb

Causa: O ORB não pode ser localizado no ID especificado.Geralmente um erro de grafia.

¶ FNGOB3018E Falha de segurança de CLI: falha

Causa: O Serviço de CLI falhou ao autenticar o usuáriowcmd.O ID do usuário ou senha estavam incorretos ou não existem, oua opção-u não foi fornecida nowcmd.

¶ FNGOB3029E Esperava-se uma mensagem de controle;recebida: mensagem

Causa: Uma falha de protocolo entre o wcmd e o Serviço deCLI.

Component Distribution ServiceO Component Distribution Service é a base de processamento centralpara o gerenciamento de instalação e distribuição de componentespara os vários ORBs e conjuntos de ORBs. A maioria dos problemascom o Component Distribution Service são provenientes decomponentes incorretamente formados e de falhas de serviços depré-requisito. As falhas de banco de dados e de rede também podemcausar problemas no Component Distribution Service. Quandoocorrer um problema, utilize os rastreios de pilhas para reunirinformações sobre detecção de problemas quando o ComponentDistribution Service não tiver registradores de mensagens ourastreios específicos.

124 Versão 1.2

Component ManagerO Component Manager gerencia as partes do sistema Tivoli KernelServices em um ORB. Ele inicia, encerra e fornece acesso aoscomponentes dentro de um ORB. O Component Manager pode serremovido, mas isso não é recomendável pela Tivoli. O ORB seráinútil sem este componente.

O Component Manager contém vários comandoswcmd comp delinha de comandos que podem ser úteis na detecção de problemas decarregamento de recursos. Esses comandos verificam o que estádisponível para os registradores.

¶ findResource - Procura um recurso de classloaders de umcomponente.

¶ findNlsResource - Procura um recurso utilizando o mecanismoNLS.

¶ listNlsURLs - Lista as URLs atualmente disponíveis para ocarregador de recursos NLS.

¶ listNLS - Lista os recursos atualmente disponíveis para ocarregador de recursos NLS; classe, propriedade etc.

Registradores de Mensagens e RastreiosO registrador de mensagens para o Component Manager é oorb.componentManager. O registrador de rastreios para o ComponentManager é o orb.componentManager. Esses registradores sãoutilizados para rastrear componentes do ORB que são iniciados eencerrados, identificar erros de componentes e rastrear acessos aoscomponentes. O registrador de rastreios reúne as informações deTYPE_INFO, TYPE_ERR, TYPE_ERROR e TYPE_WARN.Consulte a Tabela 1 na página 15 para obter mais detalhes sobre estestipos de rastreio.


5.D

etecçãode

Problem

asem

Com

ponentes

ConfigurationO Configuration Component fornece um local para outroscomponentes, o Tivoli Kernel Services e o aplicativo para armazenaros dados de configuração que eles precisam movimentar. OConfiguration Component nãoconheceos dados que ele armazena,apenas os armazena.

Registradores de Mensagens e RastreiosO Configuration Component possui dois registradores de mensagens:cfg.utilMsgLogger e cfg.orbMsgLogger. O Configuration Componentpossui vários registradores de rastreios.

¶ cfg.baseprefs - Informações detalhadas sobre o enfileiramento deeventos de configuração. Este registrador de rastreios éraramente utilizado devido ao volume que ele gera e tambémporque não há muitos problemas nesta parte do código.

¶ cfg.coalesce - Detalhes do algoritmo de coalescência. O rastreiodo algoritmo de coalescência ocorre principalmente durante acriação do nó, e quando o conjunto de nós de coalescência éalterado. Os registros tendem a ser um pouco prolixos, mas nãomuito freqüentes após a inicialização do ORB estar completa. Amenos que o problema esteja na mecânica do algoritmo decoalescência propriamente dito, cfg.orbres e cfg.omdprefs sãogeralmente mais úteis para rastrear problemas de coalescência.

¶ cfg.dircache - Processamento dentro da lógica de cache dediretórios de configuração. Junto com o cfg.dirprefs, este é oregistrador mais útil para identificar problemas ao obter dadospara/do Directory Service. Se os dados de configuraçãoestiverem sendo atualizados rapidamente, por exemplo, duranteuma instalação ou remoção de instalação, os registros do rastreiode cfg.dircache são gerados freqüentemente e podem tornar-semuito grandes. O algoritmo de spackling é rastreado por esteregistrador.

¶ cfg.dirprefs - Transferência de dados de configuração para/dodiretório e a lógica que controla o estado do diretório e oseventos de diretório. Muito útil para rastrear a lógica quecontrola o estado e os eventos do Directory Service. Rastreia

126 Versão 1.2

também o mapeamento dos dados de configuração para/doDirectory Service, mas esta parte do código não tem tido muitosproblemas. Este registrador pode produzir grandes quantidadesde dados, especialmente se ocorrerem atualizações freqüentes.

¶ cfg.eventsender - Entrega de eventos de configuração. Esteregistrador raramente é útil, pois há muito pouco o que possasair errado, uma vez que o evento o cria nesta parte do código.A quantidade de rastreio gerada depende do número deatualizações feitas.

¶ cfg.fileprefs - Transferência de dados de configuração para/dosarquivos locais. A lógica do arquivo é utilizada somente emambientes não-ORB e como uma cópia de reserva dos dados dodiretório. Esta lógica tem sido muito sólida até o momento,portanto este registrador geralmente não é necessário. Produzuma quantidade moderada a grande de saída, especialmentedurante atualizações freqüentes.

¶ cfg.misc - Lógica de configuração diversa. Não utilize esteregistrador, pois os codepaths que ele abrange quase nunca sãoutilizados e são melhor abrangidos por cfg.dirprefs.

¶ cfg.omdprefs - API de configuração, alguns detalhes da chamadade VetoableChangeListener, algumas partes de computação deordem de coalescência. Útil para rastrear chamadas de API feitaspara a configuração. Este registrador também rastreia a lógicaque afeta as ordens de coalescência computadas no InfoService.Ele contém o rastreio que liga o cfg.orbres e o cfg.coalesce.

¶ cfg.orbres - Detalhes de interação com o InfoService ecomputação de ordens de coalescência. Utilizado para identificarproblemas de comunicação com o InfoService e computação deordens de coalescência. Este registrador não produz muitosdados, visto que estes algoritmos são executados com poucafreqüência e não lidam com grandes quantidades de dados.

¶ cfg.orbutil - Importação e remoção de dados de configuraçãodurante a instalação e remoção de instalação. Estes codepathssão utilizados somente durante os comandoswcmd cds install ewcmd cds uninstall. Esta é a lógica que analisa o XML de


5.D

etecçãode

Problem

asem

Com

ponentes

configuração padrão do componente. A quantidade de saídaproduzida depende dos componentes instalados/desinstalados.

¶ cfg.owner - Detalhes de propriedade dos dados de configuraçãono componente. Não muito útil, exceto para identificar erros econtrolar qual componente possui qual nó durante operaçõescomo, por exemplo, instalação, remoção de instalação e limpeza.Este registrador geralmente não produz muita saída.

¶ cfg.persprefs - Detalhes sobre os estados de nós e chaves.Utilizado para procurar problemas em estados de nós e chaves.Se muitas coisas estiverem ocorrendo, este registrador derastreios produzirá uma quantidade significativa de saída.

¶ cfg.simpleprefs - API de configuração utilizada em ambientesnão-ORB. Úteis somente ao executar em ambientes não-ORB,como instalação.

¶ cfg.swprefs - Lógica que controla a decisão de diretório/arquivolocal e sincronização de arquivos locais com o diretório,incluindo processamento de marca de hora. Utilizadoocasionalmente para procurar problemas na marca de hora ou natransição do arquivo para/do diretório. A lógica de shadow dearquivo raramente tem problemas, e este registrador produz umaquantidade moderada de saída.

¶ cfg.synch - Algoritmo que sincroniza os dados de configuraçãoquando o diretório torna-se disponível; a mensagemFNGCF1013I é gerada. Útil somente para controlar problemasno algoritmo de sincronização, que não tenha produzido muitosproblemas. Este registrador produz uma quantidade significativade saída durante o processo de sincronização.

Detecção de Problemas AdicionaisO código do Configuration Component pode ser considerado ummapeamento entre os dados armazenados do Directory Service e aAPI de Preferências, com camadas diferentes de armazenamento emcache para melhorar a disponibilidade e o desempenho. O controlede problemas é geralmente uma questão de examinar informações dedados e estado em vários níveis para determinar onde ocorreu oproblema. A maior parte disso pode ser feita utilizando comandoswcmd; normalmente o rastreio não é necessário para determinar se

128 Versão 1.2

um problema é causado por um defeito do programa. Utilize asetapas a seguir para detectar problemas no ConfigurationComponent:

1. Digite os comandoswcmd cfg getem uma linha de comandospara examinar os dados no nível de API. Se os dados estiveremcorretos, é possível que o usuário não esteja utilizando a APIcorretamente ou não esteja manuseando eventos de alteração.

2. Se os dados estiverem incorretos, talvez não haja ouvintesregistrados no nó que fariam com que ele fosse atualizadoautomaticamente. Digitewcmd cfg refresh em uma linha decomandos para ver se o valor é atualizado. Se for, o código dechamada precisará ser atualizado para registrar um ouvinte ouemitir suas próprias chamadas de API de atualização.

3. Se os dados ainda estiverem incorretos, verifique os dados dodiretório para ver se estão corretos, digitando o seguinte emuma linha de comandos:

wcmd dir ls -a /<namespace>/cfg/<oid>/....

4. Se os dados do diretório estiverem incorretos, provavelmente oproblema ocorreu ao gravar no diretório. Provavelmente estetambém será o caso se os dados estiverem consistentementeincorretos em outros ORBs.

Verifique o DirectoryNotAvailableExceptions que contémmensagens FNGCF1012E ou FNGCF1010W no log. Issotambém pode ser o resultado de alterações não esvaziadas emum ORB. Digitewcmd cfg flush em uma linha de comandosou verifique os dados nos arquivos locais para examinar isso oucorrigir quaisquer problemas.

5. Se os dados do diretório estiverem corretos, os ORBs quepossuem os dados incorretos podem ter perdido a conectividadecom o diretório ou com eventos do diretório. Verifique asmensagens FNGCF1010W ou FNGCF1014W no log demensagens.

6. Em qualquer um dos casos, os ORBs receberão os dadoscorretos, assim que a conectividade ou entrega de evento forretomada.


5.D

etecçãode

Problem

asem

Com

ponentes

7. Se a conectividade com o diretório estiver correta, o ORBpoderá ter sido encerrado anteriormente e perdido eventos dediretório. Isso pode ocorrer para.orbdefaults e .metadatadevido ao processamento de marca de hora para esses recursos.

Se esta for a causa, a remoção manual da marca de hora dosarquivos locais localizados em$TKS_BASEDIR/orb.x/cfg/<resource>/timestamp/.properties e areciclagem do ORB devem corrigir o problema.

8. Digite wcmd cfg getcoalescinge wcmd cfg contents/.coalescingem uma linha de comandos para assegurar que oORB possua a ordem correta de dados de coalescência. Casocontrário, certifique-se de que o InfoService esteja funcionandocorretamente.

9. Se não for encontrado nenhum dos problemas anteriores, dadosinválidos são provavelmente um problema no cache do diretóriode configuração ou no código de processamento de eventos dodiretório. Digitewcmd cfg dircache statspara verificar se ocache possui problemas que não estão sendo corrigidos.

10. Se nenhum dos itens anteriores ajudar, entre em contato com oServiço ao Cliente Tivoli.

Problemas ComunsHá alguns problemas comuns que você pode encontrar ao trabalharcom o Configuration Component. Um dos problemas é anão-disponibilidade do diretório:

¶ Sintomas:As mensagens FNGCF1010W ou FNGCF1014W ouuma DirectoryNotAvailableException são geradas.

¶ Causa: O Slash Service não pode ser alcançado ou estárespondendo muito lentamente.

¶ Solução:Restabeleça a conectividade; execute o runstats paramelhorar o desempenho do banco de dados slash. ConsulteInstalando o Tivoli Kernel Servicespara obter mais informaçõessobre como utilizar o comandorunstats.

Um outro problema é não encontrar o VetoableChangeListener:

130 Versão 1.2

¶ Sintomas: IllegalStateException a partir de uma operaçãocolocar ou remover. O texto da exceção pode indicar que umaclasse não foi encontrada.

¶ Causa: Um VetoableChangeListener foi registrado para os dadosde configuração, mas não pôde ser carregado. Digitewcmd cfgcontents <node>#e wcmd cfg contents <node>#<key>emuma linha de comandos para identificar oVetoableChangeListeners registrado e os componentes que oregistraram.

¶ Solução:Corrija o que está impedindo o carregamento doVetoableChangeListeners.

Um outro problema é um valor ou nó que não pode ser excluído:

¶ Sintomas: Depois de remover um nó ou chave, ele continuaexistindo.

¶ Causa:A chave ou nó está sendo coalescida em um conjunto deORBs.

¶ Solução:Digite wcmd cfg whenceou wcmd cfg getcoalescingem uma linha de comandos para determinar a proveniência dovalor coalescido.

Um outro problema é a geração de uma mensagem FNGCF1001E aoutilizar wcmds:

¶ Sintomas: Uma mensagem FNGCF1001E é gerada durante autilização dewcmds.

¶ Causa: O interpretador da linha de comandos esperava encontrarum nome de nó, mas encontrou uma cadeia que não inicia com“/”. Todos os nomes de nós ou comandoswcmd cfg deveminiciar com “/”. Isso é geralmente causado por nomes de ORBou conjunto de ORBs digitados incorretamente. Se ointerpretador da linha de comandos não puder interpretar umargumento como um ORB ou conjunto de ORBs, ele tentaráinterpretá-lo como um nome de nó.

¶ Solução:Verifique os erros de grafia na sintaxe do comando.


5.D

etecçãode

Problem

asem

Com

ponentes

Um outro problema é que os dados não são salvos quando um ORBé encerrado:

¶ Sintomas: Os dados parecem corretos durante um tempo apósser alterado, mas reverte para um valor antigo após mais umtempo ou após um reinício do ORB.

¶ Causa: Os dados foram alterados, mas nenhuma chamada deAPI foi feita para esvaziar os dados no diretório.

¶ Solução:O código que atualizou os dados precisa ser revisadopara emitir uma chamada de API de esvaziamento. Comoalternativa, o comandowcmd cfg flush não documentado podeser utilizado.

Um outro problema é que os dados não são ressincronizadoscorretamente durante um reinício do ORB:

¶ Sintomas: Os dados no diretório não correspondem aos dadosno cache de arquivos local e o reinício do ORB nãoressincroniza os dados.

¶ Causa:As marcas de hora no diretório e arquivos locaiscorrespondem, portanto o código de sincronização não acha queseja necessária uma ressincronização. O ORB pode entrar nesteestado se for finalizado com eventos de diretório nãoprocessados.

¶ Solução:Remova manualmente a marca de hora dos arquivoslocais localizados no$TKS_BASEDIR/orb.x/<resource>/.timestamp/.properties ereinicie o ORB. Uma mensagem FNGCF1009I deve ser geradaquando os dados são ressincronizados.

Um outro problema é que os dados são removidos do diretório, mascontinuam aparecendo em um ORB:

¶ Sintomas: Os dados foram excluídos de um ORB e foramremovidos do diretório, mas eles ainda aparecem em um ou maisORBs.

¶ Causa: Quando um nó é referido em um ORB, ele é sinalizadocomo localmente criado. Este sinalizador é limpo quando o nó é

132 Versão 1.2

esvaziado. Contanto que este sinalizador seja definido, o ORBignorará a remoção do nó no diretório; por exemplo, se ele forexcluído de um ORB diferente.

¶ Solução:Remova o nó do ORB que está tendo o problema.

DCM (Data Connection Manager)O DCM (Data Connection Manager) cria origens de dados que sãosalvas no registro de segurança. As origens de dados são contêinerespara dados de conexão, tais como o nome do servidor Tivoli DAS enomes de usuários que permitem que os aplicativos acessem o bancode dados sem codificação permanente de uma URL de conexão. Oregistrador de mensagens para o DCM é o dcm.msgLogger e oregistrador de rastreios é o dcm.trcLogger. Esses registradorescoletam uma quantidade mínima de informações, com o registradorde rastreios coletando apenas informações de entrada e de saída. Asegurança para o componente DCM não está funcionandocorretamente; todas as origens de dados no sistema podem servisualizadas, mesmo se o usuário não estiver atribuído a uma funçãode uma determinada origem de dados.

DCI (Depot Component Installer)O DCI (Depot Component Installer) mantém os arquivos JAR docomponente para que possam ser acessados por ORBs do cliente. Eleadiciona e remove arquivos do diretório exportado pelo servidorWeb. Ele pode suportar todos os bootprints com uma ocorrênciasendo executada no ORB do depósito de instalação.

Testando o Estado do ComponenteO estado do DCI é indicado pela configuração bem-sucedida doservidor Web. Este componente conta com a configuração doservidor Web e o componente de instalação para que funcionecorretamente. Durante a inicialização, o DCI se comunica com ocomponente do servidor Web para configurar uma URL para odiretório orb.1/cd. Esta URL é mapeada para http://<nome dohost>/Repository. Os bootprints utilizam esta URL para carregarnovos componentes, portanto é importante que ela estejafuncionando. Para verificar se o repositório está sendo executado,


5.D

etecçãode

Problem

asem

Com

ponentes

digite seu endereço em um navegador da Web. Um índice dorepositório deve ser exibido no navegador se ele estiver sendoexecutado. Efetue esta verificação após o ORB 1 ser executado, masantes de o ORB 2 ser lançado.

Registradores de Mensagens e RastreiosO registrador de rastreios do DCI é o cds.DepotInstallerTrace. Se umcomponente permanecer na fila, ou se a inicialização não forconcluída, este registrador de rastreios deverá ser utilizado paracoletar informações de detecção de problemas. Se um componentepermanecer na fila, execute as seguintes etapas:

1. Digite os seguintes comandos de DCI, nesta ordem, em umalinha de comandos:

wcmd dci rebuild

wcmd dci processQueue

wcmd dci showQueue

2. Execute o seguinte comando para determinar as URLs utilizadaspara registrar um novo componente:

wcmd cfg get /com/tivoli/core/mmcd/inventorynonOrbParentDepotURLs

É provável que um componente não esteja disponível a partir deuma das URLs retornadas.

Se a inicialização não for concluída, procure uma exceção ou umainstrução de problema de configuração/teste do servidor Web.

DirectoryO Directory Service fornece armazenamento persistente enão-persistente de dadosraramente gravados/freqüentemente lidos.Ele cria um banco de dados compartilhado de definições internas,que fornece uma localização de armazenamento central convenientepara os aplicativos.

Registradores de Mensagens e RastreiosO Directory Service contém vários registradores de rastreios. Estesregistradores não devem ser ativados simultaneamente porque

134 Versão 1.2

milhares de linhas de informações de rastreio serão produzidas empoucos segundos devido à quantidade de tráfego no diretório global.Os registradores de rastreios foram desenvolvidos para seremativados um ou dois por vez. Eles coletam o fluxo lógico externo demétodos e classes, entrada e saída de cada método, parâmetros dechave passados para os métodos, o fluxo lógico dentro de cadamétodo e exceções encontradas.

¶ directory.dirservice - Rastreia toda a atividade do ServiçoDirservice.

¶ directory.directorytrace - Rastreia toda a atividade de classes dediretório estáticas.

¶ directory.topleveltrace - Rastreia toda a atividade de contextoinicial de nível alto.

¶ directory.remotehashtablecontexttrace - Rastreia toda a atividadede contexto inicial de nível baixo.

¶ directory.conntrace - Rastreia a conexão do banco de dados e aatividade dos conjuntos de conexões de contexto slash.

¶ directory.cachetrace - Rastreia toda a atividade de caches dediretório internas.

¶ directory.slashtrace - Rastreia toda a atividade de banco de dadosde nível alto das APIs de contexto slash.

¶ directory.dbslashtrace - Rastreia toda a atividade de banco dedados de nível baixo das APIs de contexto slash.

¶ directory.direventservice - Rastreia toda a atividade de serviçosde envio.

¶ directory.direventtrace - Rastreia toda a atividade do banco dedados de eventos de envio.

¶ directory.dirvault - Rastreia toda a atividade de passagens dediretório.

¶ directory.wrappeddireventcontexttrace - Rastreia toda a atividadede contexto de diretório envolvido.

¶ directory.parsertrace - Rastreia toda a atividade do interpretadorde nomes.


5.D

etecçãode

Problem

asem

Com

ponentes

¶ directory.smartenum - Rastreia toda a atividade do SmartEnumerator, que é utilizada para retornar conjuntos de resultadospara os clientes, atividade.

Problemas ComunsHá alguns problemas comuns que você pode encontrar ao trabalharcom o Directory Service. Um dos problemas é que o Slash Servicenão consegue conectar-se ao banco de dados. Algumas causas desteproblema são:

¶ Bancos de dados relacionais (DB2, Oracle) não iniciados.

¶ Servidor Tivoli DAS não foi iniciado ou não está configuradocorretamente.

¶ Configuração incorreta do Directory Service.

¶ Arquivo vault ilegível.

¶ O conteúdo do arquivo vault está incorreto.

¶ Erro da rede.

Um outro problema é que o Configuration Service não consegueacessar o Directory Service. Algumas causas deste problema são:

¶ Problema no Directory Service.

¶ O Configuration Service tentou estabelecer contato com oDirectory Service antes que estivesse pronto.

¶ O Configuration Service tentou armazenar um item inválido noDirectory Service; tipo ou tamanho de dados inválido.

¶ Ocorreu uma falha no subsistema de configuração.

¶ Ocorreu uma falha no subsistema InfoService.

Um último problema com o Directory Service é que o banco dedados não está ajustado. Certifique-se de que as estatísticas tenhamsido geradas no banco de dados do diretório, utilizando o comandorunstats. ConsulteInstalando o Tivoli Kernel Servicespara obtermais informações sobre como utilizar o comandorunstats.

136 Versão 1.2

Tamanho do ConjuntoO tamanho do conjunto configura o tamanho do conjunto deconexões para o diretório do Directory Services. Ele é definidodurante a instalação do depósito de instalação do Tivoli KernelServices.

O valor padrão do tamanho do conjunto é 10. O valor mínimopermitido é 2 e ovalor máximo recomendado é 65. Em geral, ovalor do tamanho do conjunto deve aproximar-se do número deORBs e deve ser um pouco maior. Pode ser difícil estimar o valoradequado porque depende do número de pedidos de diretóriosimultâneos que ocorrem nos ORBs. Em alguns casos, apenas umORB pode estar ocupado o suficiente para sobrecarregar o diretóriode tal modo que as 10 conexões padrão não sejam suficientes paramanusear a carga. Além disso, certifique-se de configurarcorretamente o banco de dados do Directory Services nomeado, porpadrão,slash, para identificar o tamanho do conjunto de conexõesdefinido.

Ocorrências freqüentes do erro InsufficientResourcesException nodiretório são um sintoma de que o provedor de diretórios estásobrecarregado e não pode servir todas as chamadas simultâneas queestão sendo colocadas no diretório. Verifique o tamanho do conjuntode conexões configurado para o diretório, utilizando o seguintecomando:

wcmd cfg get /com/tivoli/core/directory/slashDBPOOL.CONNECTION.POOL.SIZE

Se o tamanho do conjunto tiver menos de 65 conexões (65 érecomendável, mas não é um limite absoluto), o tamanho doconjunto deverá ser aumentado. Ao mesmo tempo que o tamanho doconjunto é aumentado, é preciso examinar novamente os parâmetrosdo banco de dados, que controlam o número de aplicativossimultâneos que podem conectar-se ao banco de dados do diretóriopara verificar se estão definidos apropriadamente.


5.D

etecçãode

Problem

asem

Com

ponentes

Se o MAX_NUMBER_OF_ACTIVE_APPLICATIONS para o bancode dados de diretórios for menor que oDBPOOL.CONNECTION.POOL.SIZE, ele também deverá seraumentado.

Se o DBPOOL.CONNECTION.POOL.SIZE já estiver definido para65 e as mensagens InsufficientResourceExceptions forem freqüentes,cópias adicionais ou replicadas do diretório deverão ser configuradaspara manusear a carga de trabalho nesse ambiente do Tivoli KernelServices.

Domain BuilderO Domain Builder adiciona novos ORBs aos conjuntos de ORBs daregião. Este componente é executado somente no ORB do depósitode instalação. Ele utiliza o Directory e o InfoService Services parapersistir os conjuntos de ORBs que formam uma região. Issodepende da obtenção de informações sobre cada ORB noInfoService.

Registradores de Mensagens e RastreiosO registrador de mensagens para o Domain Builder é oDomainBuilderLog. Este registrador coleta mensagens que indicamerros de inicialização. O registrador de rastreios para o DomainBuilder é o DomainBuilderTrace. Este registrador coleta rastreiospara métodos de entrada e saída e para a construção de regiões.

Detecção de Problemas AdicionaisHá duas etapas principais de detecção de problemas para ocomponente Domain Builder. A primeira é certificar-se de que umapropriedade do ORB seja apropriada para seu tipo. Utilize o métodogetproperties do InfoService para exibir as propriedades do ORB. Aoutra etapa é certificar-se de que o novo ORB seja adicionado àsregiões adequadas. Todo ORB deve ser um membro do conjunto deORBs DefaultRegion e do conjunto de ORBs orbsInDefaultRegion.O ORB também será um membro de um dos outros três conjuntosde ORBs que possuem DefaultRegion em seu nome, com base notipo de ORB.

138 Versão 1.2

GatewayCada componente do Tivoli Kernel Services Gateway, GatewayIP eGatewaySNMP, executa pedidos emitidos pelos aplicativos do TivoliKernel Services. O gateway recebe pedidos de aplicativos em umaforma, converte-os ou transforma-os em sua forma de pedido nativoe, em seguida, emite-os para os nós de extremidade do Tivoli KernelServices.

O Gateway é constituído de vários componentes diferentes. Há doistipos de gateways no Tivoli Kernel Services, IP e SNMP. Tambémhá dois componentes de suporte chave, ActionObjects e NelService.ActionObjects são executados como parte do aplicativo de gateway.Um ActionObject é um pedido de gateway que o aplicativo constróie executa para fazer com que os pedidos de gateway sejamprocessados. O NelService é um serviço utilizado pelo ActionObjectspara determinar qual gateway deve executar o pedido.

Como o gateway é comprometido com vários elementos diferentes, adeterminação de problemas pode ser feita para todos ou algunsdestes elementos. Para utilizar o log de mensagens e rastreioseficazmente, é importante ativar os registradores somente para oselementos do gateway sob investigação. Além disso, esses elementospodem residir em várias máquinas diferentes. Os logs de rastreiodevem ser coletados das máquinas que contêm os componentes degateway suspeitos, e esses logs devem ser rotulados para que amáquina possa ser identificada.

Registradores de Mensagens e RastreiosO componente gateway contém vários registradores de mensagens e,por padrão, todos ficam ativados:

¶ aolog - Registrador de mensagens do objeto ação.

¶ nels - Registrador de mensagens NelService.

¶ SnmpManagerLogger, GatewaySNMPlog, correlatorMessage -registradores de mensagens do GatewaySNMP.

¶ GatewayIPlog - Registrador de mensagens do GatewayIP.

O componente Gateway contém vários registradores de rastreios:


5.D

etecçãode

Problem

asem

Com

ponentes

¶ aotrace - Registrador de rastreios de objetos ação que rastreia avalidação de objetos ação, resultados notáveis do NelService eretorna resultados do gateway.

¶ neltrace - Registrador de rastreios do NelService que rastreiavalidação de segurança, seleção de gateway e seleção degateway padrão.

¶ SnmpManagerTracer, GatewaySNMP, correlatorTrace -Registradores de rastreios do GatewaySNMP que rastreiamrecebimentos de pedidos, geração de pedidos e resultadosretornados.

Nota: correlatorTrace é necessário somente para o rastreio deprocessamento de trap.

¶ GatewayIP - Registrador de rastreio do GatewayIP que rastreia orecebimento de pedidos, o processamento de pedidos e osresultados retornados.

Problemas ComunsHá alguns problemas comuns que você pode encontrar ao trabalharcom o componente gateway. Um problema é a exceção de modoincorreta.

¶ Sintomas: O nó de extremidade de destino não pôde serresolvido, a segurança não está correta, o NelService não estádisponível ou os gateways não estão sendo executados.

¶ Solução:Digite wcmd NelService listGateways <type>emuma linha de comandos para retornar uma lista de gatewaysconfigurados. Digitewcmd IpConfig listNat em uma linha decomandos para retornar uma lista de IDs e nomes de NATconfigurados.

Um outro problema é um pedido que não retorna.

¶ Sintomas: O gateway não responde.

¶ Solução:O NelService retorna somente gateways em execução.Não há tempo limite entre o objeto ação e o gateway. Digitewcmd NelService listGateways <type>a partir de uma linha decomandos para retornar uma lista de gateways configurados.

140 Versão 1.2

InfoServiceNa verdade, o InfoService não é um componente do TKS, mas partedo software de núcleo ORB. Ele é iniciado automaticamente emtodos os ORBs. Ele cria e mantém um banco de dados de todos osespaços de nome, conjuntos de ORBs e ORBs na instalação doTivoli Kernel Services. A causa mais comum dos problemas com oInfoService é a falha de outros componentes.

Registradores de Mensagens e RastreiosO InfoService não possui um registrador de mensagens. Todos oserros são retornados como exceções localizadas. O registrador derastreios do InfoService é o orb.InfoService. Ele rastreia toda aentrada/saída para cada método do InfoService. Os logs de rastreiosfornecem uma indicação de onde a falha realmente ocorreu. Osrastreios de pilhas das exceções registradas são a chave. Algumasexceções não são necessariamente uma indicação de falha docomponente. Por exemplo, a NameNotFoundException, quando oInfoService tenta consultar um conjunto de ORBs não-existente, éuma exceção válida.

Java PolicyO Tivoli Kernel Services Java policy protege os recursos de sistemade nível baixo, assegurando que os componentes tenham permissõesapropriadas para acessar recursos do sistema. Também evita códigoindevido no carregamento para o sistema. O problema principal quepode ocorrer ao trabalhar com o Java policy é uma exceção decontrole de acesso. Esta exceção é gerada quando a verificação desegurança da JVM falha em um componente. Execute as etapas aseguir para detectar problemas de uma exceção de controle deacesso:

1. Edite o arquivo LOCKCfg.properties e altere o parâmetroLOCK_JVMARGS para:

LOCK_JVMARGS=-Xms32m -Xmx256-Djava.security.debug=access,failure

2. Lance o ORB novamente e tente produzir a exceção de controlede acesso.


5.D

etecçãode

Problem

asem

Com

ponentes

3. Procure no log/stderr.text por mensagensdenied e failedjuntamente com um rastreio de pilha.

4. Examine as mensagens de rastreio de pilha; elas devem dizerqual componente falhou no domínio de proteção.

LCI (Local Component Installer)O LCI (Local Component Installer) manuseia a implementação,retração, upgrade e reversão de componentes ORB. Cada ORBpossui um componente LCI para manusear estas ações. A LCImanuseia a implementação do componente por ORB. A fila deveconter o componente implementado em um ORB. Caso contrário, ocomponente concluiu a implementação ou o evento de configuraçãonão foi recebido. Um componente concluiu a implementação quandoele aparece na lista retornada com o comandowcmd lcilistDeployedComponents.

Registradores de Mensagens e RastreiosO registrador de rastreios para o LCI é o cds.LocalInstallerTrace. Seum componente permanecer na fila, ou se a inicialização não forconcluída, este registrador de rastreios deverá ser utilizado paracoletar informações de detecção de problemas. Se um componentepermanecer na fila, execute as etapas a seguir:

1. Verifique se o repositório, localizado em http://<nome dohost>/Repository, está em execução. Digite o endereço URLanterior em um navegador da Web. Um índice do repositóriodeve ser exibido no navegador, se ele estiver em execução.Execute esta verificação após o ORB 1 ser executado, mas antesde o ORB 2 ser lançado.

2. Digite o comando de LCIwcmd lci rebuild em uma linha decomandos para determinar se um componente de pré-requisitonecessário teve o tempo limite excedido na fila.

3. Digite o comando de LCIwcmd lci processQueuepara forçar oprocessamento.

4. Se os componentes ainda aparecerem após a execução dewcmdlci processQueue, quaisquer exceções no log de rastreiomostrarão o problema.

142 Versão 1.2

LOCK (Local ORB Creator and Killer)O LOCK (Local ORB Creator and Killer) é utilizado para iniciar,encerrar e reiniciar ORBs. É um elemento de código dependente deplataforma que normalmente é executado como um serviço emmáquinas Microsoft Windows NT e 2000, e um daemon emmáquinas UNIX. O registrador de rastreios para LOCK éLOCK_TRACE. Este registrador de rastreios coleta uma grandequantidade de informações. O LOCK iniciará o rastreio quando opróprio LOCK for encerrado e reiniciado, ou quando o ORB que eleestiver monitorando for reiniciado. Para ativar manualmente orastreio de LOCK, edite$ORBDIR/bin/$INTERP/LOCKCfg.properties e altere o valor deLOCK_TRACE defalseparatrue. Os arquivos de rastreio estãolocalizados no diretório especificado pela variávelLOCK_LOGDIRno arquivo LOCKCfg.properties. Os arquivos de log sãodenominados hour_minute_second.trc.

ORBO ORB (Object Request Broker) fornece uma estrutura dedistribuição de objetos, controla o processo deinicialização/encerramento/reciclagem do Tivoli Kernel Services efornece o gerenciador de segurança da JVM (Java Virtual Machine).

Registradores de Mensagens e RastreiosO registrador de mensagens do componente ORB é o orb.msglogger.O componente ORB possui vários registradores de rastreios:

¶ orb.tracelogger - Registrador de rastreios do ORB

¶ orb.VoyagerPolicy - Rastreia a atividade do parâmetro degerenciamento de configuração da conexão.

¶ orb.tcpTransport - Rastreia a atividade da conexão TCP/IP doORB.

¶ orb.tracer - Rastreia a atividade do conjunto de threads.

¶ orb.localReference - Rastreia todas as chamadas de métodos paraos objetos de destino.

¶ orb.proxyTrace - Utilizado para implementar o comandoodstat.


5.D

etecçãode

Problem

asem

Com

ponentes

¶ voyagerTracer - Rastreia mensagens do Voyager Console.

Detecção de Problemas AdicionaisUma área na qual a detecção de problemas adicionais pode sernecessária com relação à segurança da JVM. Os problemas desegurança da JVM são geralmente causados por código que executaum método para o qual ele não tem permissão. Esses problemas sãosemelhantes às exceções de segurança do aplicativo, mas sãorealmente causados pela JVM. A mensagem de erro conterá oseguinte texto:

java.security.AccessControlException

Para isolar a causa do problema, ative a depuração de segurança noarquivo LOCKCfg.properties, adicionando-Djava.security.debug=access,failureao valorLOCK_JVMARGSe, em seguida, encerre e reinicie o ORB. A saída mostrará o métodotransgressor e o arquivo jar; haverá uma grande quantidade de saída.

Network SecurityO suporte ao Tivoli Kernel Services Network Security fornece umaforma de gerar e utilizar certificados criptográficos para proteger ascomunicações entre os ORBs e para assinar digitalmente os dadossensitivos para proteção contra violação. O ORB do ID (depósito deinstalação) executa o Network Security Service que atua como a CA(Autoridade de Certificação). Durante a instalação inicial, umcertificado raiz é gerado para a CA, o qual é utilizadoSOMENTEpara assinar os certificados de sistema emitidos pela CA. O primeirocertificado de sistema emitido pela CA, que também é geradodurante a instalação do ORB do ID, é o certificado para o próprioORB do ID. O ORB do ID utiliza este certificado de sistema paraestabelecer conexões SSL com outros ORBs. Certificados de sistemaadicionais são emitidos pela CA para outros ORBs quando eles sãoinstalados. O texto de cada certificado emitido inclui o OID(identificador do ORB) do ORB para o qual ele foi emitido.

Os certificados são agrupados emkeyrings, que são armazenados emarquivos vault no sistema de arquivos local de cada ORB. Esses

144 Versão 1.2

arquivos vault contêm uma forma criptografada dos certificados,protegidos por senhas armazenadas na forma criptografada emarquivos stash, para fornecer alguma proteção contra violação, porémesses arquivos vault e stash não são à prova de violação. O TivoliKernel Services pressupõe que os sistemas de arquivos locais emmáquinas ORB estejam protegidos de acesso sem autorização e deviolação. Esses arquivos de certificado vault e stash, juntamente comoutros arquivos vault e stash, são mantidos no subdiretório privadodo diretório de instalação do ORB. Além disso, o ORB do ID, queatua como a CA, mantém um banco de dados de todos oscertificados emitidos pela CA, e este banco de dados de certificadostambém é mantido sob o diretório privado do ORB do ID.

Em resumo, o ORB do ID mantém os seguintes arquivos doNetwork Security:

Arquivos de Banco de Dados da CA

¶ $ORBDIR/private/ca/db/*.cdb

¶ $ORBDIR/private/ca/db/*.rdb

¶ $ORBDIR/private/ca/db/*.log

Certificados Raiz da CA

¶ $ORBDIR/private/ca/CAVault.keyring

¶ $ORBDIR/private/ca/CAVault.keyring.sth

Certificado de Sistema do ORB do ID

¶ $ORBDIR/private/LocalOrbVault.keyring

¶ $ORBDIR/private/LocalOrbVault.keyring.sth

Todos os outros ORBs mantêm os seguintes arquivos do NetworkSecurity(Certificado de Sistema do ORB):

¶ $ORBDIR/private/LocalOrbVault.keyring

¶ $ORBDIR/private/LocalOrbVault.keyring.sth


5.D

etecçãode

Problem

asem

Com

ponentes

Há determinadas circunstâncias incomuns que podem tornar estesarquivos do Network Security inutilizáveis ou não-confiáveis. Taiscondições incluem (mas não se limitam a):

¶ Dano acidental ou exclusão dos arquivos.

¶ Falha do disco ou da máquina na qual os arquivos estãoarmazenados.

¶ A segurança dos certificados contidos nos arquivos estácomprometida (ou seja, certificados violados).

Sob algumas destas condições, pode ser possível restaurar osarquivos danificados a partir de um backup; mas podem existir casosem que a restauração dos arquivos não é possível, por exemplo,quando não há backup, ou não é desejável, por exemplo, quando asegurança do certificado foi comprometida. Neste caso, é necessárioreconstruir esses arquivos e criar novos certificados para substituir oscertificados danificados/comprometidos. No entanto, os novoscertificados devem ser criados com o mesmo OID dos certificadosanteriores, para que as informações de configuração, mantidas combase no identificador do ORB, não sejam perdidas. Consulte“Detecção de Problemas Adicionais” para obter informações sobrecomo recuperar e recriar certificados danificados/comprometidos.

Registradores de Mensagens e RastreiosO componente Network Security possui os seguintes registradores derastreios:

¶ ns.tracer - Rastreia a atividade doNetSecurityService/NetSecurityClient, incluindo fluxos atravésdo código de segurança da rede.

¶ ns.ssltracer - Rastreia a atividade do transporte SSL.

Detecção de Problemas AdicionaisO utilitário nsrecoverpode ser utilizado para recuperar arquivos doNetwork Security nas raras ocorrências em que os arquivos nãopodem ser restaurados ou quando os certificados em arquivos vaulttiverem sido comprometidos. Este utilitário deve ser restringido asituações de recuperação de desastre, uma vez que na recuperação de

146 Versão 1.2

determinados arquivos com este utilitário, pode ser necessário emitirnovos certificados de sistema, e encerrar e reiniciar, cada e todoORB.

O utilitário nsrecoverdeve ser executado na máquina onde o ORBque está sendo recuperado está instalado. O ORB que está sendorecuperado deve ser encerrado antes de onsrecoverser utilizado.Para usar o utilitárionsrecover, primeiro é necessário definir avariável de ambiente $ORBDIR em um diretório de instalação doORB a partir do qual os arquivos ZIP e JAR do Tivoli KernelServices podem ser carregados.

Nota: Este não precisa ser necessariamente o diretório do ORB queestá sendo recuperado de vários ORBs que estivereminstalados na mesma máquina.

Quando a variável de ambiente $ORBDIR for definida, utilize oarquivo nsrecover.bat em máquinas Microsoft Windows ou o scriptde shell nsrecover em máquinas AIX/Solaris para invocar o utilitárionsrecover. Esses arquivos batch/shell estão localizados nosubdiretório bin do diretório de instalação do ORB. Invocarnsrecoversem quaisquer parâmetros de comando exibe informaçõesde ajuda que ilustram a sintaxe do comando para as diversasoperações de recuperação. O utilitárionsrecoverpode ser utilizadopara recuperar:

¶ O vault de Autoridade de Certificação e o banco de dados decertificados no ORB do ID

¶ O certificado de sistema para o ORB do ID

¶ O certificado de sistema para ORBs diferentes do ORB do ID

No entanto, a utilização densrecoverem cada uma das situaçõesanteriores varia um pouco, conforme descrito nas seções seguintes.

Recuperando o Vault de Autoridade de Certificação e oBanco de Dados de Certificados

O comandonsrecoverpode ser utilizado para recuperarsimultaneamente todos os arquivos de Network Security no ORB doID. Esta forma densrecovergera um novo certificado CA raiz e um


5.D

etecçãode

Problem

asem

Com

ponentes

novo banco de dados de certificados que não contém certificados,pois nenhum ainda foi assinado pelo novo certificado CA raiz. Umnovo certificado de sistema será emitido para o ORB do ID que estáassinado com o certificado CA raiz gerado recentemente.

Esta forma densrecoverdeve ser utilizada com bastante cuidado,pois exigirá a emissão de um novo certificado assinado pelo novocertificado CA raiz, para cada e todo ORB, o que significa que cadaORB terá que ser encerrado e reiniciado. As circunstânciasatenuantes que podem exigir a utilização desta forma densrecoverincluem:

¶ Os arquivos vault/stash de certificados CA raiz ou arquivos debanco de dados de CA foram danificados ou excluídos e nãopodem ser restaurados a partir das cópias de backup.

¶ A segurança do certificado CA raiz foi comprometida.

Para restaurar os arquivos de Autoridade de Certificação e todos osarquivos de Network Security para o ORB do ID:

1. Encerre o ORB do ID.

2. Abra um prompt de comandos na máquina do ORB do ID.

3. Defina a variável de ambiente $ORBDIR, conforme descritoanteriormente.

4. Invoque o script de shell ou o arquivo batchnsrecovercom aseguinte sintaxe:

nsrecover -d <orbdir> -i <oid> ca

onde<orbdir> é o caminho completo do diretório de instalaçãodo ORB do ID (por exemplo, C:\Tivoli\orb.1), e<oid> é oidentificador do ORB do ID (por exemplo,3.xxxxxxxxxxxxxxxx.1.xxxxxxxxxxxxxxxx).

Se os arquivos vault/stash que contêm o certificado de sistema doORB do ID existente estiverem disponíveis e intactos, o <oid>especificado será comparado ao identificador do ORB no certificadode sistema do ORB do ID existente; se não corresponderem, umamensagem de erro será emitida e o processamento densrecovernãoserá executado. Esta verificação é executada para assegurar que o

148 Versão 1.2

identificador do ORB do ID não seja alterado por engano durante oprocedimento de recuperação, devido a um erro tipográfico.

Se os arquivos vault/stash não existirem ou não estiverem intactos,esta verificação será ignorada e o <oid> especificado será utilizadocomo o identificador do ORB do ID pelonsrecover. Antes de iniciara operação de recuperação, onsrecover fará uma cópia de backupdo diretório privado do ORB do ID e de todos osarquivos/subdiretórios sob ele. O nome da cópia de backup seráprivate-yyyy-mm-dd-hh-mm-ss, onde yyyy-mm-dd-hh-mm-ss refletea data/hora em que o backup foi criado pornsrecover. Após acriação deste backup,nsrecover recupera/regenera os arquivosvault/stash de certificados CA raiz, os arquivos de banco de dados deCA e os arquivos vault/stash do certificado de sistema do ORB doID, utilizando o <oid> especificado como o identificador do ORB doID.

Neste ponto, o ORB do ID poderá ser reiniciado. Como o certificadode sistema do ORB do ID está agora assinado por um novocertificado CA raiz, outros ORBs terão que ser encerrados, terão quereceber um novo certificado de sistema da Autoridade deCertificação em execução neste ORB do ID e terão que serreiniciados comnsrecover, conforme descrito a seguir; casocontrário, os ORBs com certificados de sistemaold irão gerarexceções de segurança ao tentar se comunicar com este ORB do ID.

Recuperando o Vault do ORB do Depósito de InstalaçãoO comandonsrecoverpode ser utilizado para recuperar o certificadode sistema do ORB do ID, sem recuperar o certificado CA raiz dosarquivos de banco de dados de CA. Esta forma densrecoversóemitirá um novo certificado de sistema para o ORB do ID assinadocom o certificado CA raiz existente. As circunstâncias que podemprecisar da utilização desta forma de nsrecover incluem:

¶ Os arquivos vault/stash do certificado de sistema do ORB do IDforam danificados ou excluídos e não podem ser restaurados apartir das cópias de backup.

¶ A segurança do certificado de sistema do ORB do ID foicomprometida.


5.D

etecçãode

Problem

asem

Com

ponentes

Para restaurar os arquivos vault/stash do certificado de sistema doORB do ID:

1. Encerre o ORB do ID.

2. Abra um prompt de comandos na máquina do ORB do ID.


4. Invoque o script de shell ou arquivo batchnsrecovercom aseguinte sintaxe:

nsrecover -d <orbdir> -i <oid> idorbvault

onde<orbdir> é o caminho completo do diretório de instalaçãodo ORB do ID (por exemplo, C:\Tivoli\orb.1), e<oid> é oidentificador do ORB do ID (por exemplo,3.xxxxxxxxxxxxxxxx.1.xxxxxxxxxxxxxxxx).

Se os arquivos vault/stash que contêm o certificado de sistema doORB do ID existente estiverem disponíveis e intactos, o <oid>especificado será comparado ao identificador do ORB no certificadode sistema do ORB do ID existente; se não corresponderem, umamensagem de erro será emitida e o processamento densrecovernãoserá executado. Esta verificação é executada para assegurar que oidentificador do ORB do ID não seja alterado por engano durante oprocedimento de recuperação, devido a um erro tipográfico.

Se os arquivos vault/stash não existirem ou não estiverem intactos,esta verificação será ignorada e o <oid> especificado será utilizadocomo o identificador do ORB do ID pelonsrecover. Antes de iniciara operação de recuperação, onsrecover fará uma cópia de backupdos arquivos vault/stash do ORB do ID; o nome das cópias debackup serão LocalOrbVault.keyring-yyyy-mm-dd-hh-mm-ss eLocalOrbVault.keyring.sth-yyyy-mm-dd-hh-mm-ss, ondeyyyy-mm-dd-hh-mm-ss reflete a data/hora em que os backups foramcriados pornsrecover. Após a criação destes backups,nsrecoverrecupera/regenera os arquivos vault/stash do certificado de sistemado ORB do ID, utilizando o <oid> especificado como o identificadordo ORB do ID.

150 Versão 1.2

Neste ponto, o ORB do ID poderá ser reiniciado. Como o certificadode sistema recentemente recuperado é assinado pelo certificado deCA raiz existente, o ORB do ID ainda poderá se comunicarseguramente com outros ORBs sem ter que reemitir novoscertificados para os outros ORBs.

Recuperando o Vault de ORBs diferentes do Depósito deInstalação

O comandonsrecoverpode ser utilizado para recuperar o certificadode sistema de ORBs diferentes do ORB do ID. Esta forma densrecoversó emitirá um novo certificado de sistema para um ORBassinado com o certificado CA raiz existente no ORB do ID. Ascircunstâncias que podem precisar da utilização desta forma densrecover incluem:

¶ Os arquivos vault/stash do certificado de sistema de um ORBforam danificados ou excluídos e não podem ser restaurados apartir das cópias de backup.

¶ A segurança do certificado de sistema de um ORB foicomprometida.

Para restaurar os arquivos vault/stash do certificado de sistema deum ORB diferente do ORB do ID:

1. Certifique-se de que o ORB do ID esteja sendo executado.

2. Encerre o ORB que está sendo recuperado.

3. Abra um prompt de comandos na máquina do ORB que estásendo recuperada.


5. Invoque o script de shell ou o arquivo batch nsrecover com aseguinte sintaxe:

nsrecover -d <orbdir> -i <oid> -h <host name> -o<port> -u <userid> orbvault

onde<orbdir> é o caminho completo do diretório de instalaçãodo ORB (por exemplo, C:\Tivoli\orb.1),<oid> é o identificadordo ORB (por exemplo,


5.D

etecçãode

Problem

asem

Com

ponentes

3.xxxxxxxxxxxxxxxx.1.xxxxxxxxxxxxxxxx),<host name>é onome do host da máquina que está executando o ORB do ID,<port> é o número da porta do ORB do ID e<userid> é o IDdo usuário de um administrador do Tivoli Kernel Services comautoridadeInstaller.

Nota: O comandonsrecoverexibirá um diálogo para solicitar aoemissor do comando a senha do <userid> especificado.

Se os arquivos vault/stash que contêm o certificado de sistema doORB existente estiverem disponíveis e intactos, o <oid> especificadoserá comparado ao identificador do ORB no certificado de sistemado ORB existente; se não corresponderem, uma mensagem de erroserá emitida e o processamento densrecovernão será executado.Esta verificação é executada para assegurar que o identificador doORB não seja alterado por engano durante o procedimento derecuperação, devido a um erro tipográfico.

Se os arquivos vault/stash não existirem ou não estiverem intactos,esta verificação será ignorada e o <oid> especificado será utilizadocomo o identificador do ORB pelonsrecover. Antes de iniciar aoperação de recuperação, onsrecover fará uma cópia de backup dosarquivos vault/stash do ORB; o nome das cópias de backup serãoLocalOrbVault.keyring-yyyy-mm-dd-hh-mm-ss eLocalOrbVault.keyring.sth-yyyy-mm-dd-hh-mm-ss, ondeyyyy-mm-dd-hh-mm-ss reflete a data/hora em que os backups foramcriados por nsrecover. Após a criação destes backups,nsrecoverrecupera/regenera os arquivos vault/stash do certificado de sistemado ORB, utilizando o <oid> especificado como o identificador doORB. Neste ponto, o ORB pode ser reiniciado.

Problemas ComunsHá alguns problemas comuns que você pode encontrar ao trabalharcom o componente Network Security e o utilitário nsrecover. Oserros mais comuns com o utilitárionsrecoversão que o ID do ORBincorreto está especificado na linha de comandos, oNetSecurityService não está disponível porque o ORB do ID nãoestá ativo, ou um nome de host, porta, senha, ID de usuário incorretodo ORB do ID foi especificado na linha de comandos. Utilize o

152 Versão 1.2

parâmetro do comando-t para ativar o rastreio do utilitárionsrecover, o que faz com que as mensagens de rastreio sejamexibidas no Tivoli Console durante a execução densrecover.

Um problema no componente Network Security é que podem ocorrererros durante a instalação do ID:

¶ Sintomas: Impossível criar o banco de dados de CA, keyring deCAs raiz ou keyring de ORBs do ID.

¶ Solução:Examine o log de instalação, tskOut.log, para ver asmensagens de erro.

Um outro problema são os erros durante a instalação de bootprint:

¶ Sintomas: Impossível criar keyring de ORBs, oNetSecurityService não está disponível e o ORB do ID não estáativo.

¶ Solução:Examine o log de instalação, tksOut.log, para ver asmensagens de erro.

Um outro problema são as falhas de componentesNetSecurityService ou NetSecurityClient ou deconexão/comunicação:

¶ Sintomas: Banco de dados de CA, keyring de CAs raiz(NetSecurityService) ou keyring de ORBs (NetSecurityClient)ausentes ou danificados.

¶ Solução:Examine o $ORBDIR/log/stdout para ver as mensagensde erro.

Outros problemas são os certificados inválidos ou expirados, ou orecebimento de um erro de credenciais de segurança inválidas.Verifique se os relógios do TOD em todos os ORBs estãosincronizados e se o fuso horário em todos os ORBs está correto. Sevocê receber um erro de credenciais de segurança inválidas, a causamais comum é um ORB de bootprint instalado anteriormente quetenta conectar-se a um ORB de ID recentemente instalado.


5.D

etecçãode

Problem

asem

Com

ponentes

SecurityO Tivoli Kernel Services Security Service manuseia a autenticação,que valida a identidade de um usuário, e a autorização, quedetermina os direitos de acesso de um usuário, serviços paracomponentes e administração de informações de segurança contidasno security registry.

Testando o Estado do ComponenteQuando o ORB está sendo executado, é importante verificar se oscomponentes de segurança estão sendo executados corretamente.Para verificar se a autenticação está funcionando, digitewcmd -usuperadmin list em uma linha de comandos. Para verificar se osecurity registry possui todos os dados necessários, digitewcmd -usuperadmin ssm listAllChildren -p ″root″ e compare esta saídacom uma instalação correta conhecida.

Registradores de Mensagens e RastreiosO Security Service contém vários registradores de mensagens quecoletam dados de serviço.

¶ sec.acnMessage - Registrador de mensagens de autenticação doSecurity Registry.

¶ sec.aznMessage - Registrador de mensagens de autorização.

¶ sec.cacheMessage - Registrador de mensagensSDSRemoteService e SecurityCacheService.

¶ TMDMessageLogger - Registrador de mensagens do SecurityRegistry.

O Security Service contém vários registradores de rastreios quecoletam dados sobre pontos de entrada e saída para a maioria dosmétodos, e outros pontos-chave de interesse.

¶ sec.acnTrace - Registrador de rastreios de autenticação deSecurity Registry.

¶ sec.aznTrace - Registrador de rastreios de autorização.

¶ sec.cacheTrace - Registrador de rastreios de SDSRemoteServicee SecurityCacheService.

154 Versão 1.2

¶ TMDTraceLogger - Registrador de rastreios do SecurityRegistry.

Problemas ComunsHá alguns problemas comuns que você pode encontrar ao trabalharcom o Security Service. Um problema é a falha dowcmds nativolocal com uma exceção de segurança:Foi fornecido um ID deusuário ou senha incorretos.

¶ Causa: O usuário não está corretamente definido ou o sistemaoperacional não está configurado para resolver seu próprio nomede host como completo.

¶ Solução:Verifique se o usuário está corretamente definido;corrija o tipo de conta e o corrija o nome do host. Se vocêencontrou o caminho para a conta de Kernel e não se lembra desua senha, digite o seguinte em uma linha de comandos:

wcmd ssm modifyAttributes -p<pathNameToKernelAccount> -op replace \password=newpassword

Se o usuário estiver corretamente definido, consulte “Detecçãode Problemas na Instalação do Servidor MQSeries” na página 54para obter as etapas para verificar e redefinir o sistemaoperacional para que utilize nomes completos de host.

Um outro problema é uma mensagem FNGSC0032E que é geradarepetidamente.

¶ Causa: Muitas vezes há um ORB de bootprint antigo ouinválido que aponta o ORB do ID. A verificação de assinaturado Contexto de Segurança falha porque ele foi assinado com umconjunto de chaves diferente ou os ORBs não estãosincronizados.

¶ Solução:Procure um bootprint que não tenha sido instaladoenquanto aponta para o ORB do ID atual, de uma instalaçãoanterior ou diferente. Verifique os horários dos ORBs paracertificar-se de que correspondem. Se eles estiverem muitolonge, configure um servidor NTP.


5.D

etecçãode

Problem

asem

Com

ponentes

Um outro problema é a falha de início de sessão com a mensagem:Duas ou mais contas foram encontradas com o mesmo nome:<conta_do_usuário>.

¶ Causa:Alguém instalou uma conta idêntica àquela com a qual ousuário tentou iniciar sessão.

¶ Solução:Altere ou exclua um dos nomes de conta.

Security RegistryO security registry é o servidor de gerenciamento de dados quecontém a maior parte da lógica para administrar e manter as relaçõesentre proprietários, contas, funções e destinos. Os registradores demensagens e rastreios para o security registry são descritos em“Security” na página 154 neste capítulo.

O Tivoli Kernel Services não funcionará sem o security registry. Seo security registry falhar, o componente Failover tentará reiniciá-lo.Consulte “Failover” na página 3 para obter mais informações sobre ocomponente Failover. Se o servidor Tivoli DAS ou servidor DB2falhar, o security registry repetirá a conexão e, em seguida, retornaráuma exceção. Quando a conexão é restaurada, a primeira transaçãopode falhar.

Testando o Estado do ComponenteA forma de assegurar o estado do security registry é ajustarregularmente o banco de dados. O ajuste é feito através da geraçãode estatísticas para o banco de dados TMD em uma base regular,utilizando o comandorunstats. ConsulteInstalando o Tivoli KernelServicespara obter mais informações sobre como utilizar o comandorunstats.

Detecção de Problemas AdicionaisSe você encontrar problemas de desempenho com o security registry,utilize o comandorunstats para gerar estatísticas e ajustar o bancode dados. Além disso, verifique a utilização de CPU para o TivoliKernel Service, o servidor Tivoli DAS e o servidor DB2. Se oservidor DB2 estiver utilizando 90+% da CPU, o servidor DB2deverá ser ajustado.

156 Versão 1.2

Serialized PersistenceO componente Serialized Persistence fornece armazenamento local eeficiente de objetos Java serializáveis. Cada ORB pode persistirdados locais e ter acesso rápido a esses dados. Como esses dadossão vitais para garantir uma operação adequada do ORB, você devefazer backup deles periodicamente. Se os dados estiveremdanificados ou foram perdidos, você poderá utilizar um backup pararestaurar a operação normal. Para fazer backup de todos os dados depersistência em um sistema UNIX, digite o seguinte em uma linhade comandos:

cp -r $ORBDIR/ds $ORBDIR/ds.backup

Para restaurar dados de persistência, digite os dois comandos aseguir em uma linha de comandos:

rm -r $ORBDIR/ds

cp -r $ORBDIR/ds.backup $ORBDIR/ds

Para fazer backup de todos os dados de persistência em um sistemaWindows, execute as seguintes etapas:

1. Para fazer backup dos dados, utilize o explorer para copiar oconteúdo do diretório $ORBDIR/ds para outro diretório,denominado $ORBDIR/dsbackup.

2. Para restaurar os dados, utilize o explorer para copiar o conteúdodo $ORBDIR/dsbackup para o $ORBIDR/ds.

O registrador de mensagens para o Serialized Persistence é ods.SerializedPersistenceLog. Ele registra as mensagens que sãogeradas se uma falha da JVM tiver deixado arquivos LOCK em umdisco. Este componente possui três registradores de rastreios:

¶ ds.SerializedPersistenceService - Rastreia todos os métodos deentrada e saída dos bancos de dadosSerializedPersistenceService.

¶ ds.SerializedPersistence - Rastreia todos os métodos de entrada esaída dos mapas SerializedPersistence.


5.D

etecçãode

Problem

asem

Com

ponentes

¶ ds.SynchSerializedPersistence - Rastreia todos os métodos deentrada e saída dos mapas SynchSerializedPersistence.

Service ManagerO componente Tivoli Kernel Services Service Manager forneceacesso aos serviços no ambiente distribuído. Sua função principal égerenciar os serviços para que os clientes os acessem de uma formapadrão.

Registradores de Mensagens e RastreiosO registrador de mensagens para o Service Manager é osm.messageLogger. Ele fornece as informações mais importantessobre tempo de execução. O registrador de rastreios do ServiceManager é o sm.traceLogger. Ele fornece informações úteis sobredetecção de problemas.

Problemas ComunsHá alguns problemas comuns que você pode encontrar ao trabalharcom o Service Manager. Um problema comum é o recebimento damensagem de erro FMGSM006E:

¶ Causa: O serviço não está instalado ou em execução, ou falhaum arquivo JAR do serviço no ORB do originador da chamada.

¶ Solução:Se você souber em qual ORB o serviço está sendoexecutado, digitewcmd -i <orbid> svc ls lsmem uma linha decomandos para verificar se o serviço está ativo e em execução.Certifique-se de que o ORB do originador da chamada possui oarquivo JAR da interface do serviço.

Um outro problema comum é o recebimento da mensagem de erroFNGSM0033E:

¶ Causa: Nenhum serviço local corresponde aos critérios depesquisa, e os DSMs estão inativos.

¶ Solução:Verifique DSMPrimary e DSMBackups naconfiguração para certificar-se de que pelo menos um DSMesteja ativo e em execução, digitando os dois comandos a seguirem uma linha de comandos:

158 Versão 1.2

wcmd -i <orbid> cfgcontent\com\tivoli\core\serviceManager

wcmd -i <orbid> svc ls lsm

Um outro problema comum é o recebimento da mensagem de erroFNGSM005E:

¶ Causa: Há um erro de programação do aplicativo ou ainstalação está danificada.

¶ Solução:Vá para o diretório de configuração do ORB everifique o sistema de arquivos. Este diretório é<orb_dir>\cfg\.orbdefaults\com\tivoli\core\service\<service_name>\<service_version>.

SNMP ServiceO SNMP Service implementa o SNMP (Simple NetworkManagement Protocol) que é utilizado para se comunicar com ossistemas finais que estão sendo gerenciados. Este serviço pode serencerrado ou removido de um ORB. Para encerrar o SNMP Service,digite o seguinte comando em uma linha de comandos:

wcmd accmgr stopComponent -c SnmpService

Para remover o SNMP Service de um ORB, digite o seguintecomando em uma linha de comandos:

wcmd cds retract SnmpService@<version number> <orb id>

Registradores de Mensagens e RastreiosO registrador de rastreios para o SNMP Service é o snmp. Paraativar o rastreio do SNMP, digitewcmd snmp trace start em umalinha de comandos. Este registrador de rastreios coleta todos ospedidos e respostas enviados e recebidos pela pilha de protocolosSNMP, identificando o agente de origem ou destino. Essasinformações incluem:

¶ O endereço do agente.

¶ O thread que enviou/recebeu a mensagem.


5.D

etecçãode

Problem

asem

Com

ponentes

¶ Versão do protocolo SNMP.

¶ communityString - Informações sobre segurança de SNMP.

¶ errorStatus - Deve ser 0. Outros valores indicam que o erroocorreu ao processar a mensagem.

¶ errorIndex - Se o errorStatus não for 0, este valor indicará qualvarBind teve o problema.

¶ varBind list - Os itens reais de informações na mensagem.Podem existir vários destes itens em uma mensagem.

TimeSyncO componente TimeSync é uma implementação do Simple NetworkTime Protocol (9SNTP - RFC2030). O SNTP assegura a hora localexata, com referência aos relógios atômicos e de rádio localizados naInternet. A hora exata do sistema para todos os hosts distribuídos érequerida por vários componentes do Tivoli Kernel Services, taiscomo Security, Directory e Logging.

Registradores de Mensagens e RastreiosO registrador de rastreios do componente TimeSync éo timeTrcLogger. Ele utiliza as máscaras de rastreioTYPE_LEVEL1, TYPE_LEVEL2 e TYPE_LEVEL3 para determinarquais informações serão coletadas. A máscara de nível 1 mostra umresumo do que está acontecendo, o nível 2 mostra os detalhes dequais decisões de processamento são feitas e o nível 3 mostra todosos cálculos estatísticos e os pacotes NTP que são enviados.

160 Versão 1.2

Padrão de Mensagens Tivoli

As mensagens emitidas pelo Tivoli Kernel Services e pelo TivoliPresentation Services utilizam o Padrão de Mensagens Tivoli. OPadrão de Mensagens Tivoli especifica o formato padrão dasmensagens emitidas em um componente ou aplicativo Tivoli e temcomo objetivo fornecer uma forma consistente e significativa paraidentificar as mensagens em todo o conjunto de produtos Tivoli.

Formato do ID da MensagemO formato do ID da mensagem para o Tivoli Kernel Services éXXXYY####Z , onde:

XXX É o prefixo do produto com três caracteres para ocomponente ou aplicativo que produz a mensagem. Para oTivoli Kernel Services, o prefixo do produto éFNG. Para oTivoli Presentation Services, o prefixo do produto éFWP.

YY É um código de subsistema opcional de 1 ou 2 caracteresalfabéticos. O Tivoli Presentation Services não fornece umcódigo de subsistema. Os códigos do subsistema TivoliKernel Services se baseiam no componente, conformemostrado a seguir.

Componente Código de Subsistema

Component CP

Configuration CF

Console MC

6


6.P

adrãode

Mensagens

Tivoli

Componente Código de Subsistema

Data Storage DS

Directory DR

Domain Builder DO

Failover FT

Gateway GW

Gateway SNMP GS

ICMP IC

IPOP OP

Logging LG

Messaging Service MS

Network Security NS

ORB OB

Planning and Distribution PD

Sample SA

Security SC

Service Manager SM

Silent Installer SI

SNMP SP

Time Synchronization TM

Utilities UT

Zurich Correlator ZC

#### É o número de mensagem obrigatório. O número demensagem consiste em 4 dígitos numéricos. Os números demensagem são exclusivos por código de subsistema (valorXX ).

Z O tipo de mensagem.

I Informativa (TYPE_INFO)

W Aviso (TYPE_WARN)

E Erro (TYPE_ERR)

162 Versão 1.2

F Fatal (TYPE_FATAL)

Seguem algumas amostras de mensagens do Tivoli Kernel Services.15:06:25.457 FNGCP0031I Iniciado dirservice de componente versão 5.1.0-200011262259.15:06:25.457 FNGOB0004I Transição do ORB, do estado 2 para o estado 3.15:06:28.231 FNGSC4001I Serviço de Cache Raiz iniciado.15:06:28.261 FNGCP0027I Iniciando componente SecurityCacheServiceversão 5.1.0-200011262259.15:06:28.441 FNGCP0031I Componente SecurityCacheService versão5.1.0-200011262259 Iniciado.

A segunda mensagem, com o númeroFNGOB0004I, pode serinterpretada da seguinte maneira:

¶ Emitida no Tivoli Kernel Services (prefixo de produtoFNG)

¶ Emitida no componente ORB (código de subsistemaOB)

¶ Número de mensagem0004

¶ Mensagem informativa (tipoI )

Descrições de Mensagens e AjudaA documentação de mensagens fornece informações sobre umamensagem, detalhes explanatórios e etapas de correção a seremseguidas se a mensagem corresponder a uma condição de erro. Adocumentação de mensagens para o Tivoli Kernel Services, TivoliPresentation Services e todos os aplicativos instalados podem seracessados a partir do Tivoli Assistant no Tivoli Console. ConsulteIntroduzindo a Administração do Tivoli Kernel Servicespara obtermais informações sobre o Tivoli Assistant. Se você precisar acessar adocumentação da mensagens quando o Tivoli Console não estiverem execução, ou antes de sua instalação, a documentação demensagens do Tivoli Kernel Services e do Tivoli PresentationServices também estará disponível no CD-ROM do produto TivoliKernel Services na seguinte localização:readme\tivolidocs\pdf\tks120_messages.pdf.


6.P

adrãode

Mensagens

Tivoli

164 Versão 1.2

Índice Remissivo

AActivation Framework 117Administrative Console

detecção de problemas adicionaisnomes de pacotes/drivers de tarefas 120

problemas comuns 121registradores de mensagens e rastreios 120testando o estado do componente 118

AIXproblemas no banco de dados 52

arquivos de logalterando a localização 31convertendo serializados em ASCII 46instalação 49tksErr.log 50tksOut.log 49

arquivos de log de instalaçãolistagem completa 50visão geral 49

autoridade de certificaçãoarquivos de banco de dados 145certificados raiz 145

Bbanco de dados de Log

criando após a instalação 40utilizando 41

bancos de dados DB2códigos de erro 66

db2diag.log 66Exceção de Nível do JDBC 73Nenhuma Exceção de Driver

Adequada 73SQL0805N 72SQL0964C 74SQL1032N 72

bancos de dados DB2(continuação)códigos de erro(continuação)

SQL1116N 68SQL1117N 69SQL1224N 70SQL2310N 74

comando drop 67comando uncatalog 67

bootprintdetecção de problemas na instalação 60restaurando 77

Ccertificado de sistema

para o ORB do depósito de instalação 145CLI de log 22códigos de mensagem 161comando nsrecover 146comando runstats

utilizando com o Security Registry 156Command Line Interface

registradores de mensagens e rastreios 123Component Configuration

detecção de problemas adicionais 128problemas comuns 130registradores de mensagens e rastreios 126

Component Distribution Service 124Component Manager

registradores de mensagens e rastreios 125wcmds 125

componentesActivation Framework 117Administrative Console 118Command Line Interface 123Component Configuration 126Component Distribution Service 124


ÍndiceR

emissivo

componentes(continuação)Component Manager 125DCI (Depot Component Installer) 133DCM (Data Connection Manager) 133detecção de problemas comuns

ativando o rastreio 111desativando o rastreio 113

Directory 134Domain Builder 138Gateway 139InfoService 141Java Policy 141LCI (Local Component Installer) 142LOCK (Local ORB Creator and Killer) 143modelo 2Network Security 144ORBs 143registradores de mensagens e rastreios do

sistema 114Security 154Security Registry 156Serialized Persistence 157Service Manager 158SNMP Service 159TimeSync 160

configuração padrão do registrador demensagens 5

configuração padrão do registrador derastreios 8

DDB2

detecção de problemas na instalaçãoobtenção do db2profile 51problemas de espaço em disco 52problemas no AIX 52problemas no Sun Solaris 52

DCI (Depot Component Installer)registradores de mensagens e rastreios 134testando o estado do componente 133

DCM (Data Connection Manager) 133depósito de instalação

detecção de problemas na instalação 59

depósito de instalação(continuação)problemas no Microsoft IIS 101restaurando 76

Directoryproblemas comuns 136tamanho do conjunto 137

Diretórioregistradores de mensagens e rastreios 134

Domain Builderdetecção de problemas adicionais 138registradores de mensagens e rastreios 138

FFailover, descrição 3Failover Service

descrição 3registradores de mensagens e rastreios 4

filtrosconectando a um registrador 31configuração 29definindo 30descrição 14

formatadoresconfiguração 29definindo 31descrição 17

GGateway 139

problemas comuns 140registradores de mensagens e rastreios 139

grupos, objetos de log 18

Hherança de propriedade

no subsistema Log 20

166 Versão 1.2

IInfoService

registradores de mensagens e rastreios 141

JJava Policy 141

LLCI (Local Component Installer)

registradores de mensagens e rastreios 142LOCK (Local ORB Creator and Killer) 143

Mmáscaras de rastreio 15mensagens

acessando a ajuda fora do TivoliConsole 163

ligação atrasada 32tipos de gravidade 12

NNetwork Security 144

arquivos de banco de dados da autoridade decertificação 145

certificado de sistema do ORB 145certificado de sistema do ORB do depósito de

instalação 145certificados raiz da autoridade de

certificação 145comando nsrecover 146detecção de problemas adicionais 146problemas comuns 152

Network Security(continuação)recuperando o banco de dados de

certificados 147recuperando o vault de autoridade de

certificação 147recuperando o vault de outros ORBs 151recuperando o vault do ORB do depósito de

instalação 149registradores de mensagens e rastreios 146

OOracle

detecção de problemas gerais 75detecção de problemas na instalação 58

ORBsdepósito de instalação

certificado de sistema 145recuperando vault 149

detecção de problemas adicionais 144diferente do depósito de instalação

certificado de sistema 145recuperando o vault 151

ordem de coalescência 21registradores de mensagens e rastreios 143tempos de lançamento 102

ordem de coalescênciaORBs 21

PPadrão de Mensagens Tivoli

formato do ID da mensagem 161

Rrecuperando bancos de dados DB2 63, 65recuperando o banco de dados de

certificados 147


ÍndiceR

emissivo

recuperando o vault de autoridade decertificação 147

recuperando o vault de outros ORBs 151recuperando o vault do ORB do depósito de

instalação 149registradores

rastreios 12registradores de mensagens e rastreios do

sistema 114restaurando o bootprint 77restaurando o depósito de instalação 76rotinas de tratamento

adicionando 25conectando a um registrador 27configuração 23descrição 13listando definições 24opção -f 24remota

como utilizar 29remotas 27

SSecurity

problemas comuns 155testando o estado do componente 154

Security Registrycomando runstats 156testando o estado do componente 156

Segurançaregistradores de mensagens e rastreios 154

Serialized Persistence 157Service Manager

problemas comuns 158registradores de mensagens e rastreios 158

Serviço de Logconfigurar o logServer 37descrição 33mensagens de erro 45múltiplos 35

como implementar 36encadeando 38

quando utilizar 34

Serviço de Log(continuação)registradores de rastreios 45único 35

servidor MQSeriesdetecção de problemas na instalação

problemas de nome completo do host noAIX 56

problemas de nome completo do host noSolaris 55

problemas de nome completo do host noWindows 2000 56

problemas de nome completo do host noWindows NT 55

excluindo o intermediário 100problemas de estado inconsistente 100recriando o intermediário 100

servidor Tivoli DAScódigos de erro do SQLState 79detecção de problemas na instalação

problemas no db2java.zip 53problemas no tdacl 54

exceções de Corba 78logs de rastreios

níveis de rastreio 78mensagens de erro de conectividade 97problemas de conectividade no AIX 80recuperando consoles 82

procedimento de recuperação 95restaurando 99

Simple Jar Installervisão geral 109wcmds 110

SNMP Serviceregistradores de mensagens e rastreios 159

subsistema Logarquitetura de log local 19coalescência 20comando tail 5configuração padrão do registrador de

mensagens 5configuração padrão do registrador de

rastreios 8detecção de problemas 44

rastreio de bootstrap 44herança 20interface de linha de comandos do log 22

168 Versão 1.2

subsistema Log(continuação)Log Manager 18visão geral 4

Sun Solarisproblemas no banco de dados 52

TTimeSync

registradores de mensagens e rastreios 160Tivoli Consoles

detecção de problemas 105recuperando 82

procedimento de recuperação 95Tivoli Kernel Services

arquivos de log de instalação 50bancos de dados DB2

recuperando 63, 65caracteres Unicode 68componentes do nível de aplicativo 3componentes do nível de componente 2componentes do nível de recurso 3serviços de núcleo 2

Vvariáveis

variáveis de ambientenotação para xii

variáveis de ambientenotação para xii

Wwcmds

comandos para serem utilizados na detecçãode problemas 108

Component Manager 125ID do usuário e senha 20

wcmds (continuação)opção -u 20Simple Jar Installer 110


ÍndiceR

emissivo

170 Versão 1.2

Impresso em Brazil

Documents

Detecção de Problemas no Tivoli Kernel Services