IBM Tivoli Application Dependency Discovery Manager Versão Guia de Configuração e Referência do Enterprise Common Collector

Transcrição

1 IBM Tivoli Application Dependency Discovery Manager Versão Guia de Configuração e Referência do Enterprise Common Collector

2

3 IBM Tivoli Application Dependency Discovery Manager Versão Guia de Configuração e Referência do Enterprise Common Collector

4 Observação Antes de utilizar essas informações e o produto por elas suportado, leia as informações em Avisos na página 219. Esta edição se aplica à versão 7, liberação 2, modificação 2 do IBM Tivoli Application Dependency Discovery Manager (número do produto 5724-N55) e a todas as liberações e modificações subsequentes até que seja indicado de outra forma em novas edições. Copyright IBM Corporation 2012, 2014.

5 Índice Figuras v Tabelas vii Capítulo 1. Introdução Enterprise Common Collector Sensor do IBM Tivoli Application Dependency Discovery Manager zenterprise Pré-requisitos Capítulo 2. Considerações de Segurança 7 Segurança entre o Coletor e o HMC Segurança entre o Coletor e seus Clientes Capítulo 3. Configurando o System z Hardware Management Console para Uso com o Enterprise Common Collector Definindo um Usuário Ativando a API de Serviços da Web Implementando o Guest Platform Management Provider Adquirindo o Certificado do Hardware Management Console Considerações de Firewall Testando a Conexão do Enterprise Common Collector para os HMCs Capítulo 4. Instalando o Enterprise Common Collector Instalando o Enterprise Common Collector Usando o Assistente de Instalação Usando o Caminho Avançado para Configurar as Portas Instalando o Enterprise Common Collector a partir do Console Instalando o Enterprise Common Collector Usando o Método de Instalação Silenciosa Verificando se o Enterprise Common Collector Foi Instalado Corretamente Registrando Manualmente o Enterprise Common Collector como um Serviço Iniciando, Parando, Removendo, Instalando e Consultando o Status do Enterprise Common Collector Reconfigurando a Contagem de Login Inválido do Enterprise Common Collector para o ID do Usuário Admin Restaurando a Configuração Padrão do Enterprise Common Collector Desinstalando o Enterprise Common Collector Usando o Assistente de Instalação Desinstalando o Enterprise Common Collector a partir do Console Capítulo 5. Atualizando o o sensor TADDM zenterprise e o Enterprise Common Collector Capítulo 6. Customizando o Enterprise Common Collector Entendendo a Interface da Linha de Comandos.. 62 Efetuando Logon no Enterprise Common Collector Usando a Interface da Linha de Comandos Alterando a Senha de Administração Padrão Definindo se o Enterprise Common Collector Usa a Autenticação Base ou LDAP Usando a Linha de Comandos Gerenciando os Certificados Usando a Linha de Comandos Criando, Listando, Atualizado e Excluindo os Clientes Usando a Linha de Comandos Configurando o Perfil de Coleção Usando a Linha de Comandos Configurando as Origens de Dados HMC Usando a Linha de Comandos Configurando os Níveis de Log do Coletor Usando a Linha de Comandos Resumo de Comandos do Administrador Resumo dos Comandos de Utilitário Gerenciando o Contêiner da Web do Enterprise Common Collector Capítulo 7. Resolução de problemas do ambiente de gerenciamento de serviço do zenterprise Problemas e Soluções Alternativas Nenhum dado do zenterprise ou dados incorretos encontrados no o Data Management Portal Enterprise Common Collector Falha ao Inicializar Problemas Conhecidos e Soluções Alternativas 111 Componentes do Enterprise Common Collector Intervalos de Mensagens Mensagens Gerais do Enterprise Common Collector Mensagens da Interface da Linha de Comandos do Enterprise Common Collector Capítulo 8. Migrando e Fazendo Backup do Enterprise Common Collector Usando o Gerenciador de Migração Backup Manual Copyright IBM Corp. 2012, 2014 iii

6 Backup Automático Apêndice. Customizando o Enterprise Common Collector usando as APIs REST Segundo Plano na Interface de Serviços da Web 147 Iniciando e Encerrando uma Sessão da API Definindo se o Enterprise Common Collector Usa a Autenticação Base ou LDAP por meio da APIs REST Configurando Perfis de Coleção Usando a API REST Configurando as Origens de Dados do HMC Usando a API REST Gerenciando Certificados Usando a API REST Criando, Listando e Atualizando Clientes Usando a API REST Configurando os Níveis de Criação de Log do Coletor usando a API REST Gerenciando os Backups usando a API Rest Visão Geral de APIs de Configuração do Enterprise Common Collector DELETE /eccapi/admin/clients/{client-name} 157 DELETE /eccapi/admin/collection-profiles/ {name} DELETE /eccapi/admin/config/certificates/ {alias} DELETE /eccapi/admin/config/loggers/{loggername} DELETE /eccapi/admin/data-sources/{name} 160 DELETE /eccapi/sessions/this-session GET /eccapi/admin/backup GET /eccapi/admin/clients GET /eccapi/admin/clients/{client-name} GET /eccapi/admin/collection-profiles GET /eccapi/admin/collection-profiles/{name} 171 GET /eccapi/admin/config/authentication GET /eccapi/admin/config/certificates/ GET /eccapi/admin/config/certificates/{alias} 177 GET /eccapi/admin/config/certificates/trust-all 179 GET /eccapi/admin/config/loggers GET /eccapi/admin/config/loggers/{loggername} GET /eccapi/admin/data-sources GET /eccapi/admin/data-sources/{name} POST /eccapi/admin/backup POST /eccapi/admin/clients/ POST /eccapi/admin/collection-profiles POST /eccapi/admin/config/loggers POST /eccapi/admin/data-sources POST /eccapi/sessions/ PUT /eccapi/admin/clients/{client-name} PUT /eccapi/admin/clients/{client-name}/ resume PUT /eccapi/admin/collection-profiles/{name} 204 PUT /eccapi/admin/config/authentication PUT /eccapi/admin/config/certificates/{alias} 208 PUT /eccapi/admin/config/certificates/trust-all 210 PUT /eccapi/admin/config/loggers/{loggername} PUT /eccapi/admin/data-sources/{name} Informações de Suporte Avisos Marcas comerciais Glossário do zenterprise Índice Remissivo iv IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

7 Figuras 1. Tela de Boas-vindas do Enterprise Common Collector Tela Introdução do Enterprise Common Collector Tela Contrato de Licença do Software Enterprise Common Collector Tela Tipo de Instalação do Enterprise Common Collector Enterprise Common Collector - Tela Escolher Pasta de Instalação Tela Pasta Destino Não Suportado do Enterprise Common Collector Tela Resumo de Pré-instalação do Enterprise Common Collector Tela Instalando o Enterprise Common Collector do Enterprise Common Collector Tela Geração de Par de Chaves do Enterprise Common Collector Pop-up de Informações Incompletas do Enterprise Common Collector Pop-up Alias Já Existe do Enterprise Common Collector Tela Resultados de Geração do Par de Chaves do Enterprise Common Collector Tela Instalação Bem-sucedida do Enterprise Common Collector Tela Tipo de Instalação do Enterprise Common Collector com Avançado Selecionado Tela Tipo de Instalação do Enterprise Common Collector com Configurações de Porta Selecionadas Tela Tipo de Instalação do Enterprise Common Collector com Configurações de Porta Atuais Selecionadas Tela Introdução à Desinstalação do Desinstalar Enterprise Common Collector Tela Desinstalação Concluída do Desinstalar Enterprise Common Collector Fluxo de Processo de Backup Automatizado 145 Copyright IBM Corp. 2012, 2014 v

8 vi IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

9 Tabelas 1. Versões do Programa de Instalação Enterprise Common Collector por Plataforma As plataformas nas quais o Enterprise Common Collector pode ser instalado Funções de Tarefa que Determinam as Tarefas Permitidas para os Recursos Gerenciados Plataformas e Versões do Assistente de Instalação do Enterprise Common Collector Plataformas e Versões do Assistente de Instalação do Enterprise Common Collector Designações de Porta Padrão para o Programa de Instalação Plataformas e Versões da Instalação do Enterprise Common Collector Designações de Porta Padrão Parâmetros para Geração de Par de Chaves Plataformas e Versões da Instalação do Enterprise Common Collector Resumo de Comandos do Administrador Resumo dos Comandos de Utilitário Exceções Comuns Java Problemas Conhecidos do Enterprise Common Collector Intervalos de Mensagem e Componentes do Enterprise Common Collector Locais do Log de Mensagens para Mensagens da Interface da Linha de Comandos ECC APIs do Enterprise Common Collector configuração do modo de autenticação LDAP 207 Copyright IBM Corp. 2012, 2014 vii

10 viii IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

11 Capítulo 1. Introdução A interface do IBM Tivoli Application Dependency Discovery Manager (TADDM) com o Enterprise Common Collector (coletor) inclui dois componentes que são novos para o ambiente TADDM: v O Enterprise Common Collector v O o sensor TADDM zenterprise Enterprise Common Collector O Enterprise Common Collector (coletor) é um repositório de dados comuns que extrai e armazena dados do zenterprise System z Hardware Management Console (HMC) para ser usado por um número de componentes diferentes, incluindo o sensor TADDM zenterprise. O coletor é o ponto de coleta central dos dados do zenterprise, reunidos a partir de um ou mais System z HMCs. Esse componente pesquisa os HMCs em busca de dados de configuração e monitoramento do zenterprise de recursos físicos, virtuais e lógicos. O coletor armazena em cache os dados para uso ao solicitar aplicativos, como o Tivoli zenterprise Monitoring Agent ou o sensor do TADDM zenterprise. Os dados são trocados entre o coletor e o sensor do TADDM zenterprise e entre o coletor eotivoli zenterprise Monitoring Agent, usando uma interface REST (Representational State Transfer), um estilo de arquitetura de software cliente-servidor para sistemas hipermídia distribuídos, como a Worldwide Web, que consiste em um conjunto de fluxos de solicitação de HTTP e resposta. Quando o coletor é iniciado, seu banco de dados é preenchido com os recursos descritos no HMC. Após esta operação inicial para preencher o banco de dados, o coletor recebe e armazena as mudanças de propriedade, mudanças de status, estados do grupo de recursos de carga de trabalho e as métricas de desempenho e disponibilidade de todos os objetos gerenciados (físicos, lógicos e virtuais) para a empresa. O coletor mantém os dados descobertos em seu estado mais atual, atendendo as notificações emitidas pelos HMCs e redescobre periodicamente e atualiza os dados. O coletor possui os recursos a seguir: v Gerencia conexões individuais aos zenterprise System z Hardware Management Consoles (HMCs) v Coleta dados em paralelo a partir de diversos zenterprise HMCs v Processa as solicitações de monitoramento e inventário, e as atividades de coleta de dados de plano de fundo simultaneamente v Reflete as mudanças no inventário, status e propriedade nos dados solicitados da API do coletor O coletor fornece esses benefícios adicionais para programas que usam os serviços do coletor: v Reduz o carregamento de processamento no HMC fornecendo uma fonte alternativa de dados de desempenho e inventário. v Permite maior compartilhamento de informações atualmente disponíveis apenas para o conjunto limitado de usuários com acesso ao HMC e também diminui a quantidade de tráfego para e a partir do console. v Alivia os programas clientes do ônus da manipulação de mensagens normalmente necessária para manter os dados atuais. v Está disponível por meio de uma rede de IP para permitir que o coletor e os produtos de consumo sejam instalados em diferentes servidores físicos ou virtuais. v Inclui o valor para as informações de desempenho HMC, derivando os deltas e gerando novas métricas baseadas nos dados de amostra. Copyright IBM Corp. 2012,

12 Considerações de Instalação Instale e mantenha uma única versão do Enterprise Common Collector na sua empresa. Você pode instalar diversas cópias em diferentes hosts para teste de curto prazo antes de migrar uma versão na produção, mas apenas uma instância deste componente devem estar em uso em sua empresa. O coletor requer que todos os seus componentes (servidor bem como console administrativo) operem com as mesmas configurações de código de idiomas. Ao usar o console administrativo do Enterprise Common Collector, certifique-se de executá-lo no mesmo código de idioma que o serviço Enterprise Common Collector. No UNIX e Linux, o serviço Enterprise Common Collector é executado na conta root. O coletor usa as configurações do código de idioma da conta na inicialização do sistema. No Windows, o serviço do Enterprise Common Collector é executado sob a conta do Sistema Local. As configurações do código de idioma do usuário de instalação são usadas para determinar o código de idioma no qual o serviço Enterprise Common Collector é executado. A criação do serviço normalmente ocorre quando o Enterprise Common Collector é instalado. Se você já tiver instalado a mesma versão do Enterprise Common Collector como parte de outro produto, não o instale novamente. Ignore Capítulo 6, Customizando o Enterprise Common Collector, na página 61 e configure a versão instalada com outro produto para suporte do o sensor TADDM zenterprise. Se você tiver instalado uma versão mais antiga do Enterprise Common Collector como parte de outro produto, atualize o coletor existente para a versão fornecida com o TADDM antes de customizar o coletor para suportar o TADDM. Veja Capítulo 5, Atualizando o o sensor TADDM zenterprise e o Enterprise Common Collector, na página 59 para obter mais informações sobre como atualizar. Se você tiver instalado o agente de monitoramento do zenterprise, mas planejar usar o Enterprise Common Collector para preencher as visualizações do agente de monitoramento do zenterprise com recursos descritos no System z Hardware Management Console usando o Enterprise Common Collector, não instale o Enterprise Common Collector com o agente de monitoramento do zenterprise. Configure o agente de monitoramento do zenterprise para apontar para a versão do Enterprise Common Collector que foi instalado com o sensor do TADDM zenterprise. Consulte a documentação do agente de monitoramento do zenterprise para obter essas informações. Você tem uma opção das três maneiras a seguir para instalar o Enterprise Common Collector: v Usando a interface gráfica com o usuário (assistente de instalação). Consulte Instalando o Enterprise Common Collector Usando o Assistente de Instalação na página 20. v Usando a interface da comando de console. Consulte Instalando o Enterprise Common Collector a partir do Console na página 35. v Usando o método de instalação silenciosa. Consulte Instalando o Enterprise Common Collector Usando o Método de Instalação Silenciosa na página 40. Consulte a Tabela 1 para uma opção de seis programas de instalação que você pode usar com base no seu sistema operacional. Esses programas de instalação são encontrados no DVD IBM Tivoli Enterprise Common Collector V Tabela 1. Versões do Programa de Instalação Enterprise Common Collector por Plataforma Programa de Instalação setup_ecc_v1102_aix_ppc64.bin setup_ecc_v1102_linux_s390x.bin setup_ecc_v1102_linux_x86_32.bin setup_ecc_v1102_linux_x86_64.bin Plataforma de destino para instalar o coletor AIX POWER, 64 bits Linux on System z, 64 bits Linux on System x, 32 bits (Intel de 32 bits) Linux on System x, 64 bits (inclui EM64T (Xeon) e AMD64 (Opteron)) 2 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

13 Tabela 1. Versões do Programa de Instalação Enterprise Common Collector por Plataforma (continuação) Programa de Instalação Plataforma de destino para instalar o coletor setup_ecc_v1102_windows_x86_32.exe Windows Server, 32 bits setup_ecc_v1102_windows_x86_64.exe Windows Server, 64 bits O coletor é executado como um serviço do Windows (eccsrv com o nome de exibição "IBM Enterprise Common Collector Service") ou como um daemon Linux ou UNIX (eccsvc). Após a instalação, ao iniciar, parar, remover ou consultar o status do Enterprise Common Collector, você estará realmente endereçando esses comandos para o serviço Windows ou daemon Linux ou UNIX. O serviço ou daemon Enterprise Common Collector é configurado para ser iniciado quando o sistema operacional é iniciado e é executado em segundo plano enquanto o sistema operacional estiver em execução. O serviço também pode ser iniciado e parado manualmente quando necessário. Se você instalar o Enterprise Common Collector a partir de um ID do usuário com autoridade de administrador (nos sistemas Windows) ou raiz (nos sistemas Linux ou UNIX), o coletor poderá ser iniciado automaticamente quando o sistema operacional for iniciado porque o componente é executado como um serviço em sistemas Windows ou como um daemon nos sistemas Linux ou UNIX. Se tiver instalado uma versão anterior do Enterprise Common Collector, veja Capítulo 5, Atualizando o o sensor TADDM zenterprise e o Enterprise Common Collector, na página 59. Qualquer um dos três métodos de instalação (assistente de instalação, instalação do console ou instalação silenciosa) deve ser executado por um usuário com autoridade de administrador (Windows) ou raiz (Linux ou UNIX) para fazer com que o serviço Enterprise Common Collector seja iniciado automaticamente quando o sistema operacional for iniciado. Se você não executou a instalação do Enterprise Common Collector a partir de um ID do usuário com a autoridade correta, deve configurar o serviço do Enterprise Common Collector manualmente. Consulte Registrando Manualmente o Enterprise Common Collector como um Serviço na página 47. Sensor do IBM Tivoli Application Dependency Discovery Manager zenterprise O IBM Tivoli Application Dependency Discovery Manager (TADDM), a solução da IBM para automação da descoberta e visualização, fornece um sensor do zenterprise para descoberta de elementos físicos e virtuais dos sistemas zenterprise. O sensor do zenterprise usa o Enterprise Common Collector para recuperar as informações sobre o ambiente do zenterprise. Os recursos que o TADDM descobre usando o sensor do TADDM zenterprise são armazenados no TADDM Change and Configuration Management Database (CCMDB) ou no IBM SmartCloud Control Desk. Ter os recursos do zenterprise disponíveis no CCMDB ou no IBM SmarCloud Control Desk e TADDM resulta em economia de custo e inclui uma nova dimensão nos recursos de gerenciamento do TADDM. Para obter informações adicionais sobre o sensor do TADDM zenterprise, consulte o TADDM Sensor Reference. Considerações de Instalação Use as informações fornecidas na documentação do TADDM para instalar e configurar o sensor do TADDM zenterprise, como você faria com qualquer sensor TADDM. Capítulo 1. Introdução 3

14 Pré-requisitos Os seguintes produtos e versões de pré-requisito são necessários. Software Obrigatório Assegure-se de que produtos a seguir estejam instalados e configurados antes de iniciar a instalação. v O System z Hardware Management Console Hardware Management Console (HMC) versão , Pacote Configurável de Manutenção 34 ou posterior. Plataformas suportadas para instalação do do coletor O Enterprise Common Collector pode ser instalado em uma das seguintes plataformas: Tabela 2. As plataformas nas quais o Enterprise Common Collector pode ser instalado Sistema Operacional Uma dessas versões suportadas Linux no System z v Red Hat Enterprise Linux (RHEL) 5 ou superior v Novell SUSE Enterprise Server (SLES) 10 ou superior AIX v AIX versão 5.3 (Nível de Tecnologia 12) ou posterior v AIX versão 6.1 (Nível de Tecnologia 5) ou mais recente v AIX versão 7.1 ou mais recente Linux no System x v Red Hat Enterprise Linux (RHEL) 5.5 ou superior v Novell SUSE Enterprise Server (SLES) 10 SP4 ou superior (x86 e x86_64) v Novell SUSE Enterprise Server (SLES) 11 SP1 ou superior Windows Server 2008 (edições Datacenter, Enterprise e Standard) v Windows Server 2008 SP2 ou posterior com o Windows de 32 bits no subsistema Windows de 64 bits (WoW64) ativado Windows Server 2012 (edições v Windows Server 2008 R2 ou posterior com o Windows de 32 bits no subsistema Windows de 64 bits (WoW64) ativado Datacenter, Standard e Essential) v Windows Server 2012 com o Windows de 32 bits no subsistema Windows de 64 bits (WoW64) ativado Esses sistemas operacionais podem estar em execução localmente ou em qualquer desses ambientes suportados: v O Linux no System z em execução em uma partição lógica (LPAR) no hypervisor PR/SM v Sistemas operacionais guest Linux no System z em execução dentro da máquina virtual no hypervisor z/vm v Sistemas operacionais guest AIX em execução dentro da máquina virtual no hypervisor PowerVM (PHYP) v Sistemas operacionais guest Linux em execução dentro da máquina virtual no hypervisor KVM (XHYP) v Todas as edições Windows listadas na tabela anterior em ambas as plataformas suportadas de 32 bits e 64 bits v Sistemas operacionais convidados do Windows em execução dentro de uma máquina virtual no hypervisor KVM (XHYP) v VMware ESX e ESXi Server, versões 4.1 e 5.0 ou mais recente Espaço em disco necessário para o Enterprise Common Collector O Enterprise Common Collector requer o espaço máximo total do 900 MB, divido da seguinte maneira: v Arquivos instalados O Enterprise Common Collector requer aproximadamente 400 MB de espaço em disco para os arquivos instalados. Isso inclui os arquivos executáveis do coletor em si e dos componentes associados. v Arquivos de Log 4 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

15 Os arquivos de log do Enterprise Common Collector podem aumentar a um máximo de 250 MB. v Banco de Dados O Enterprise Common Collector usa um banco de dados para armazenar seus dados de configuração e os dados descobertos da operação de coleta de inventário HMC. Esses dados são persistentes no disco, de modo que é preservado sobre as reinicializações do coletor. O espaço em disco necessário deste banco de dados depende da configuração de seus HMCs. Ou seja, quanto mais objetos (por exemplo, servidores virtuais) forem descobertos nos HMCs, mais espaço em disco será necessário pelo banco de dados do Enterprise Common Collector. Você deve reservar pelo menos 250 MB para este banco de dados, que deve ser suficiente para a maioria das configurações HMC. Se o ambiente do seu HMC for muito grande (por exemplo, incluir milhares de servidores virtuais e grupos de recursos da carga de trabalho), a quantidade de espaço em disco deverá ser aumentada. Hardware Necessário Para os componentes do Enterprise Common Collector, consulte sysmgmt/products/support/tivoli_supported_platforms.html. Versões IP Suportadas O Enterprise Common Collector suportam endereços de rede em ambos protocolos, IPv4 e IPv6. Capítulo 1. Introdução 5

16 6 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

17 Capítulo 2. Considerações de Segurança O ambiente de gerenciamento de serviço zenterprise consiste em vários componentes que geralmente são distribuídos em diversos sistemas. É importante que as interações entre esses componentes sejam executadas de maneira segura, para assegurar a integridade do ambiente completo. Assegure-se de revisar os três aspectos de segurança a seguir quando instalar e configurar esse ambiente: v Autenticação: verificando a identidade de um solicitante de dados v Autorização: assegurando-se de que o solicitante vê apenas os dados aos quais está autorizado v Comunicações seguras: criptografando a transmissão de dados entre o solicitante eoprovedor para evitar interceptação desautorizada. O restante desta seção discute os três aspectos de segurança conforme se relacionam com o Enterprise Common Collector: v Como o coletor se comunica com os HMCs para reunir os dados zenterprise v Como os aplicativos cliente se comunicam com o coletor para acessar os dados zenterprise v Configurando o coletor Segurança entre o Coletor e o HMC A segurança do System z Hardware Management Console (HMC) é um tópico de muito grande interesse para os administradores do System z. Geralmente, alguns usuários em uma empresa realmente possuem permissão para efetuar logon no HMC. Mas as informações reunidas por este console são críticas para um número de usuários, incluindo planejadores de capacidade, analistas de desempenho, gerentes de negócios e operadores. Nenhum desses usuários deve ter acesso a uma interface tão sensível quanto o HMC, que é o motivo pelo qual i Enterprise Common Collector foi desenvolvido. O coletor reúne informações sobre recursos e relacionamentos do zenterprise (dados do inventário) e dados de desempenho (métricas) associados a esses recursos a partir de um ou mais HMCs. Neste contexto, o coletor é um cliente de cada um dos HMCs do qual reúne as informações. O HMC implementa a interface de programação de aplicativos Representational State Transfer (REST) para permitir que aplicativos como o coletor recupere esses dados. Mas, devido à natureza sensível desses dados HMC, o HMC implementa mecanismos de segurança nesta API REST para assegurar que os dados fiquem disponíveis apenas para os aplicativos autorizados. Para ser visto como um aplicativo autorizado, o coletor deve aderir a esses requisitos de segurança. Autenticação O HMC requer que cada cliente forneça credenciais para autenticação, na forma de um ID de usuário e senha. Essas credenciais são enviadas ao HMC pelos aplicativos cliente quando uma sessão é iniciada. Quando o HMC tiver autenticado com êxito as credenciais, uma sessão será estabelecida. Todo o acesso às funções de administração e dados do HMC é executado no contexto desta sessão autenticada. O HMC pode ser configurado para autenticar as credenciais do cliente usando sua própria lista de usuários autorizados ou usando um servidor LDAP. Os aplicativos clientes que usam a API de Serviços da Web HMC devem fornecer credenciais que são válidas para qualquer mecanismo de autenticação que Copyright IBM Corp. 2012,

18 esteja configurado para o HMC. Consulte Capítulo 3, Configurando o System z Hardware Management Console para Uso com o Enterprise Common Collector, na página 13 para obter informações sobre a configuração da API de Serviços da Web do HMC. O Enterprise Common Collector mantém uma ou mais definições de origem de dados que descrevem como se comunicar com HMCs. Cada definição de origem de dados inclui o nome de host TCP/IP do HMC de destino, as credenciais (ID do usuário e senha, criptografado no banco de dados) usadas para o HMC e vários outros atributos. Essas definições de origem de dados para o coletor são gerenciadas usando a interface da linha de comandos ou a interface de programação de aplicativos REST do Enterprise Common Collector. Consulte Configurando as Origens de Dados HMC Usando a Linha de Comandos na página 80 para obter detalhes adicionais sobre como manter as definições de origem de dados. Durante o processamento de inicialização (ou quando uma nova definição de origem de dados é criada), o coletor usa as informações em cada origem de dados para estabelecer uma sessão com o HMC de destino. Este processo de criação da sessão envolve enviar as credenciais da origem de dados para o HMC e o HMC autentica as credenciais usando sua lista de usuários autorizados. Se a autenticação for bem-sucedida, a sessão será estabelecida. Todos os acessos para o inventário do HMC e os dados de métrica pelo coletor são executados no contexto desta sessão autenticada. Autorização O HMC mantém um perfil para cada um dos usuários autorizados. Este perfil descreve os recursos do zenterprise aos quais o usuário tem permissão para ver e quais ações o usuário tem permissão para executar nesses recursos. Os usuários que tentam acessar os recursos aos quais não estão autorizados recebem uma resposta de erro proibida. Desta maneira, o HMC fornece um controle de acesso de granularidade muito fina para os recursos do zenterprise que gerencia. Para o HMC, o Enterprise Common Collector é apenas outro usuário de seus APIs de Serviços da Web. As informações retornadas ao coletor estarão de acordo com o perfil HMC do ID do usuário fornecido pelo coletor quando sua sessão HMC for estabelecida. O objetivo do coletor é permitir que os usuários e aplicativos visualizem o recurso zenterprise, o relacionamento e as informações de métrica que reúne dos HMCs. Portanto, é importante configurar cada uma das definições de origem de dados no coletor com um ID de usuário HMC que esteja autorizado a ver todos os recursos do zenterprise que o coletor espera fornecer. Consulte Definindo um Usuário na página 13 para obter informações sobre como definir os usuários HMC autorizados. Comunicação Segura O HMC permite que apenas usuários autenticados e autorizados acessem informações sobre os recursos zenterprise que ele gerencia. Mas mesmo as solicitações feitas por usuários autorizados não estariam completamente seguras se a comunicação entre o solicitante e o HMC não estivesse criptografada. Os dados em trânsito podem ser interceptados por alguém desautorizado. Esse é o motivo pelo qual o HMC suporta apenas conexões do HyperText Transfer Protocol Secure (HTTPS) de usuários HMC. As informações transmitidas sobre conexões HTTPS são criptografadas para evitar a intercepção desautorizada, que garante que apenas dois parceiros em comunicação para uma conexão (o HMC e seu cliente) possam interpretar os dados. As conexões HTTPS são estabelecidas usando os certificados digitais. Esses certificados não apenas fornecem as chaves de segurança que permitem a criptografia e decriptografia dos dados, mas os certificados também podem ser usados para identificar e autenticar o parceiro de comunicação. Quando um aplicativo inicia uma sessão HTTPS, ele pode autenticar a identidade de seu parceiro usando o certificado fornecido pelo sistema de destino durante a negociação da sessão. 8 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

19 O HMC usa os certificados digitais apenas para criptografia de sessão, não para autenticação do cliente. (Em vez disso, o HMC executa a autenticação exigindo que o solicitante envie as credenciais do usuário sobre a sessão criptografada, conforme descrito anteriormente.) O HMC fornece um certificado digital para aplicativos solicitantes, para permitir que os clientes executem a autenticação de servidor. Por padrão, o HMC usa um certificado autoassinado gerado quando o HMC é instalado e configurado inicialmente. Mas os clientes zenterprise podem optar por obter um certificado assinado por uma Autoridade de Certificação e instalar esse certificado no keystore do HMC no lugar do certificado autoassinado. O coletor inicia a sessão HTTPS com o HMC. Durante a negociação da sessão, o certificado do HMC é enviado para o coletor. O coletor pode ser configurado para processar o certificado do HMC de uma das duas maneiras: v Confiar em todos os certificados Nesta configuração, o coletor não executa qualquer autenticação do certificado do HMC, mas os dados transmitidos na sessão HTTPS ainda estão criptografados. Esse método é a configuração mais simples, mas também é a menos segura. Como o coletor não validou a identidade do HMC, aceitar a sessão e continuar pode fazer com que as credenciais do HMC do coletor (ID do usuário e senha) sejam enviadas para uma entidade desconhecida e, possivelmente, não confiável, em vez do HMC desejado. Esta configuração não é recomendada. v Validação do Certificado Nessa configuração, o coletor não executa a autenticação do certificado do HMC. Nesta configuração, o coletor deve ter um armazenamento confiável que contenha o certificado público do HMC ou o certificado público da Autoridade de Certificação que assinou o certificado do HMC. Desta maneira, o coletor pode validar a identidade do HMC antes de aceitar a sessão e passar as credenciais para o HMC. Consulte Gerenciando os Certificados Usando a Linha de Comandos na página 70 para obter informações adicionais sobre como definir as configurações HTTPS para as definições de origem de dados do coletor e importar os certificados necessários no armazenamento confiável do coletor. Segurança entre o Coletor e seus Clientes O Enterprise Common Collector reúne informações de recurso, relacionamento e métrica do zenterprise a partir de um ou mais System z Hardware Management Consoles (HMCs). O HMC fornece mecanismos de segurança (descritos em Segurança entre o Coletor e o HMC na página 7) para proteger o acesso a esta informação, devido à sua natureza sensível. Portanto, da mesma forma, o coletor também deve assegurar que apenas os aplicativos autorizados podem acessar os dados que reuniu dos HMCs. Nesse contexto, o coletor é um servidor e os aplicativos autorizados são clientes que estão recuperando os dados HMC reunidos ou executando funções de administração para o próprio coletor. O coletor implementa uma interface de programação de aplicativos Representational State Transfer (REST) para permitir que os aplicativos executem essas operações e implementa os mecanismos de segurança nesta API REST para assegurar que as operações são executadas apenas pelos aplicativos autorizados. Dois exemplos de aplicativos autorizados que se comunicam com o coletor são a interface de linha de comandos do coletor e o o sensor TADDM zenterprise. Cada um destes aplicativos está de acordo com os requisitos de segurança do coletor, conforme descrito nas seções a seguir. Autenticação O Enterprise Common Collector requer que cada um de seus clientes forneça credenciais para autenticação no formato de um ID de usuário e senha. Essas credenciais são enviadas para o coletor por aplicativos clientes quando uma sessão é iniciada. Quando o coletor tiver autenticado com êxito as Capítulo 2. Considerações de Segurança 9

20 credenciais, uma sessão estará estabelecida. Todo o acesso aos dados do coletor e funções de administração são executadas no contexto desta sessão autenticada. O coletor pode ser configurado para autenticar as credenciais do cliente, usando sua própria lista de usuários autorizados ou usando um servidor LDAP. Os aplicativos clientes que usam a API REST do coletor devem fornecer credenciais que são válidas para qualquer mecanismo de autenticação que estiver configurado para o coletor. Consulte Definindo se o Enterprise Common Collector Usa a Autenticação Base ou LDAP Usando a Linha de Comandos na página 69 para obter informações sobre como configurar o coletor para usar a autenticação local ou de LDAP. Consulte Criando, Listando, Atualizado e Excluindo os Clientes Usando a Linha de Comandos na página 72 para obter informações sobre como gerenciar a lista de usuários do coletor autorizado ao usar a autenticação local. Observe que mesmo se o Enterprise Common Collector estiver configurado para usar o LDAP, o ID do administrador padrão "admin" sempre será autenticado usando o mecanismo de autenticação próprio do coletor. Isso é feito para evitar que o ID do administrador padrão seja bloqueado do coletor em casos nos quais o servidor LDAP esteja offline, ou se a configuração LDAP não estiver correta. Os clientes do coletor podem ser bloqueados se a senha tiver expirado ou excessivas tentativas mal-sucedidas forem feitas para autenticar as credenciais do cliente. Se ocorrer um bloqueio, o cliente deve ser desbloqueado antes que possa ser usado novamente. Consulte Criando, Listando, Atualizado e Excluindo os Clientes Usando a Linha de Comandos na página 72 para obter informações sobre o gerenciamento de clientes usando as funções do administrador do coletor. Para o aplicativo da interface da linha de comandos do Enterprise Common Collector, é necessário que os usuários especifiquem um ID de usuário e senha no momento em que uma sessão de linha de comando é inicializada. O aplicativo da interface da linha de comandos usa este ID de usuário e senha para estabelecer sua sessão com o coletor. Consulte Entendendo a Interface da Linha de Comandos na página 62 para obter informações sobre o uso da interface da linha de comandos. Configure o o sensor TADDM zenterprise para se comunicar com o coletor e configure o ID do usuário e a senha do coletor ao mesmo tempo. Autorização O Enterprise Common Collector designa uma ou mais funções de cada cliente autorizado. Essas funções definem quais informações do coletor ou funções estão disponíveis ao cliente. Mesmo se o coletor estiver configurado para usar a autenticação LDAP, um cliente deve ser criado no coletor (sem uma senha) e associado a cada conta LDAP autorizada, para que as funções do coletor possam ser designadas à conta LDAP. As funções definidas pelo coletor são as seguintes: v Administrador: permissão para executar as funções de configuração e administração do próprio coletor, incluindo o gerenciamento de clientes e as funções e as definições da origem de dados do HMC v Explorer: permissão para recuperar as informações de relacionamento eorecurso zenterprise que o coletor reuniu a partir de um ou mais HMCs. v Operator: permissão para recuperar as informações da métrica de desempenho e monitoramento zenterprise e informações de relacionamento que o coletor coletou de um ou mais HMCs. v Serviço: permissão para recuperar as informações sobre o status do Enterprise Common Collector. Diversas funções podem ser designadas a um cliente. Para que um cliente tenha acesso a todos os aspectos do coletor, todas as quatro funções devem ser designadas ao cliente. Qualquer tentativa de acessar informações ou funções que não estejam autorizadas a um cliente por suas funções designadas resulta em uma resposta de erro HTTP 403 Proibido. 10 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

21 Os usuários da interface da linha de comandos do Enterprise Common Collector devem especificar as credenciais de um cliente de coletor a quem é designada a função Administrator. As credenciais configuradas para o o sensor TADDM zenterprise devem ser para um cliente coletor que está atribuído a função Explorer role. Consulte Criando, Listando, Atualizado e Excluindo os Clientes Usando a Linha de Comandos na página 72 para obter informações sobre o gerenciamento da lista de clientes de coletor e suas atribuições designadas. Comunicação Segura O Enterprise Common Collector permite que apenas usuários autenticados e autorizados a acessar as informações do zenterprise e funções de administração do coletor. Mas mesmo as solicitações feitas por usuários autorizados não estarão completamente seguras, se a comunicação entre o aplicativo cliente autorizado e o coletor não estiver criptografada. Os dados em trânsito poderiam ser interceptados por alguém desautorizado. Por esse motivo, o coletor suporta apenas conexões HyperText Transfer Protocol Secure (HTTPS) dos aplicativos clientes. As informações transmitidas sobre conexões HTTPS são criptografadas para evitar interceptação desautorizada, o que garante que somente os dois parceiros em comunicação para uma conexão (o coletor e seu aplicativo cliente) poderão interpretar os dados. As conexões HTTPS são estabelecidas usando os certificados digitais. Esses certificados não apenas fornecem as chaves de segurança que ativam a criptografia e a decriptografia de dados, mas também podem ser usados para identificar e autenticar o parceiro em comunicação. Quando um aplicativo inicia uma sessão HTTPS, ele pode autenticar a identidade de seu parceiro usando o certificado fornecido pelo sistema de destino durante a negociação da sessão. O coletor usa certificados digitais apenas para criptografia de sessão, não para autenticação de cliente. (Em vez disso, o coletor executa a autenticação, pedindo ao solicitante que envie as credenciais do usuário sobre a sessão criptografada, conforme descrito anteriormente). O coletor fornece um certificado digital aos aplicativos solicitantes, para permitir que esses clientes executem a autenticação de servidor. Por padrão, o coletor usa um certificado autoassinado que você gera quando instala o Enterprise Common Collector. Consulte Instalando o Enterprise Common Collector Usando o Assistente de Instalação na página 20 para obter informações sobre como gerar o par de chaves customizado que permite que um certificado autoassinado seja criado assegurando a comunicação segura entre o coletor e seus clientes. Também é possível optar por gerar um certificado autoassinado customizado ou obter um certificado assinado por uma Autoridade de Certificação confiável e instalar esse certificado no keystore do coletor no lugar do certificado de amostra. Consulte o centro de informações do WebSphere Community Edition no para obter informações adicionais sobre a inclusão dos certificados no keystore do coletor. Um aplicativo cliente autorizado inicia a sessão HTTPS com o coletor e, durante a negociação da sessão, o certificado do coletor é enviado ao cliente. O cliente pode processar o certificado do coletor de uma das duas maneiras: v Aceitar todos os certificados: Nessa configuração, o cliente não executa nenhuma autenticação do certificado do coletor em todos, mas os dados transmitidos na sessão HTTPS ainda são criptografados. Essa é a mais simples configuração, mas também é a menos segura. Como o cliente não validou a identidade do coletor, aceitar a sessão e continuar poderia fazer com que as credenciais do coletor do cliente (ID do usuário e senha, criptografados no banco de dados) fossem enviadas para uma entidade desconhecida e possivelmente não confiável, em vez do coletor desejado. Esta configuração não é recomendada. v Validação do Certificado: Nessa configuração, o cliente não executa a autenticação do certificado do coletor. Nessa configuração, o cliente deve ter um truststore que contém o certificado público do coletor ou o certificado público da Autoridade de Certificação que assinou o certificado do coletor. Isso Capítulo 2. Considerações de Segurança 11

22 permite que o cliente valide a identidade do coletor antes de aceitar a sessão e passar as credenciais ao coletor. Qualquer valor que você forneça para o nome do host deverá corresponder ao nome do host ou o endereço IP que esteja no certificado. A interface da linha de comandos do Enterprise Common Collector não executa nenhuma autenticação do certificado do coletor. Isso ocorre porque a interface da linha de comandos pode ser chamada apenas no sistema quando o coletor estiver em execução. Veja o centro de informações do WebSphere Community Edition em wasce/v2.1.1/en/index.html para obter mais informações sobre outros tipos de certificados na keystore do coletor. 12 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

23 Capítulo 3. Configurando o System z Hardware Management Console para Uso com o Enterprise Common Collector Antes que seja possível usar a API de Serviços da Web publicada para o System z Hardware Management Console (HMC), execute as etapas de configuração a seguir: 1. Defina um usuário com o escopo de gerenciamento apropriado e as funções da tarefa para acessar objetos e executar ações no HMC. 2. Ative a API de Serviços da Web e permita que o usuário definido na Etapa 1 para acesse essa interface. 3. Implemente e ative o Guest Platform Management Provider (GPMP) nos servidores virtuais, de modo que as informações operacionais específicas do sistema, como OSname e hostname, estejam disponíveis para o HMC e, portanto, para o coletor. Essas ações são descritas em detalhes nas seções a seguir. Para obter uma referência abrangente sobre escopo de gerenciamento e funções de tarefa, bem como para obter informações sobre as ações do console para administrar o ambiente HMC, consulte IBM System z Hardware Management Console: Guia de Operações Versão ou mais recente (SC ) e o IBM zenterprise System Hardware Management Console: Guia de Operações para Conjuntos, Versão ou mais recente (SC ). Definindo um Usuário Conclua o procedimento a seguir para definir um novo usuário. Procedimento 1. Efetue login no System z Hardware Management Console com um usuário ACSADMIN predefinido ou com um ID de usuário que tenha autorização equivalente. 2. Selecione a tarefa Perfis do Usuário. 3. Inclua um novo usuário: a. Selecione o tipo de Autenticação que você deseja ativar no Enterprise Common Collector. v Para Autenticação Local, insira uma senha. v Para usar um Servidor LDAP como o meio de autenticação, defina ou selecione o servidor que gerencia o diretório LDAP que contém o ID do usuário que deve ser autenticado. b. Selecione Funções de Recursos Gerenciados que determinam quais objetos esse usuário tem permissão para acessar. Para funções de sistemas de gerenciamento como monitoramento, descoberta e gerenciamento de disponibilidade, o usuário precisa de acesso a todos os recursos no escopo do conjunto gerenciado por este HMC. Para ativar esse nível de acesso, selecione as funções predefinidas a seguir. Se deseja limitar o acesso a determinados recursos, defina as funções correspondentes manualmente. Funções de Recursos Gerenciados: v Objetos BladeCenter v Objetos DPXI50z Blade v Objetos Gerenciados zcpc Definidos v Grupos de Objetos de Conjunto Criados por SYSPROG v Objetos IBM Blade v Objetos IBM Blade Virtual Server v Objetos ISAOPT Blade v Objetos Storage Resource v Objetos Virtual Network v Objetos Workload v Objetos z/vm Virtual Machine Copyright IBM Corp. 2012,

24 c. Selecione as Funções de Tarefa que determinam quais tarefas são permitidas nos Recursos Gerenciados selecionados na etapa anterior. Selecione as funções predefinidas a seguir ou funções equivalentes que você tenha criado para este HMC: Tabela 3. Funções de Tarefa que Determinam as Tarefas Permitidas para os Recursos Gerenciados Permissões de Tarefas Necessárias Tarefa de Relatório de Carga de Trabalho Função de tarefa HMC predefinida aplicável Tarefas do Operador do Performance Management Tarefa de Relatório de Classes de Serviço (grupo de tarefa do monitor) Gerenciar Recursos de Armazenamento Tarefas do Administrador do Recurso de Armazenamento (Grupo de tarefas de configuração) Elemento de Suporte Alternativo Tarefas do Programador do Sistema (grupo de tarefas de Gerenciamento de Mudanças) d. Selecione outras Propriedades de Usuário conforme necessário. Assegure-se de selecionar Permitir Acesso às Interfaces de Gerenciamento para que o novo usuário possa acessar a API de Serviços da Web. Ativando a API de Serviços da Web Faça o seguinte para ativar a API de Serviços da Web. Procedimento 1. Efetue logon no System z Hardware Management Console (HMC) como o ACSADMIN do usuário predefinido ou um usuário que tenha autorização equivalente (a autorização necessária para customizar as configurações de API). 2. Selecione a tarefa Customizar Configurações de API. 3. Selecione Serviços da WEB e ative TODOS os endereços IP ou endereços IP específicos que têm permissão para se conectar a este HMC. 4. Assegure-se de que o nome de usuário do Enterprise Common Collector que efetua logon no HMC esteja selecionado na seleção Controle de Acesso de Usuário. Observe que os usuários serão selecionados automaticamente se a propriedade de usuário Permitir Acesso a Interfaces de Gerenciamento estiver configurada para este usuário (consulte Definindo um Usuário na página 13). Implementando o Guest Platform Management Provider O Guest Platform Management Provider (GPMP) é um componente opcional que deve ser implementado e ativado nas plataformas guest individuais se o Enterprise Common Collector puder obter informações (como o nome do sistema operacional ou o nome do host) para correlacionar um servidor virtual com informações semelhantes obtidas de outro local. Nota: Para os sistemas z/os, será necessário apenas configurar e iniciar o GPMP porque esse componente já faz parte do z/os v1.12 ou sistema operacional posterior. As informações necessárias para esta implementação estão fora do escopo deste documento. Consulte IBM zenterprise System Ensemble Performance Management Guide (GC ), "Installing and configuring guest platform management providers" para obter detalhes adicionais. 14 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

25 Adquirindo o Certificado do Hardware Management Console A comunicação sobre o HTTP seguro requer que todos os dados sejam criptografados usando uma chave segura Para troca de chave, o HMC envia seu certificado para o cliente que pode então validá-lo e, quando confiáveis, as chaves podem ser trocadas. Para permitir que o Enterprise Common Collector valide o certificado, seu armazenamento confiável deve conter uma cópia da parte pública do certificado do servidor ou deve ter uma cópia da parte pública do certificado da Autoridade de Certificação (CA). Se um certificado do servidor não for localizado no armazenamento confiável, mas se o certificado da CA que assinou o certificado do servidor for, a validação ainda pode ser executada. A maneira mais segura de configurar os certificados é transportar fisicamente o certificado para o cliente. No entanto, se você estiver configurando o coletor em um ambiente em que a segurança seja menos importante (por exemplo, um ambiente de teste), será possível usar o método a seguir. Seu administrador de segurança deve conseguir ajudá-lo nesta tarefa. Para certificados autoassinados ou para certificados que são assinados por uma CA que não está no armazenamento confiável do Enterprise Common Collector, você deve primeiro obter uma cópia do certificado (sua parte pública). Para obter uma cópia do certificado, digite o endereço da web do HMC no campo de endereço de seu navegador. A primeira vez que você acessar o HMC na sessão do navegador da web atual, você poderá receber um erro de certificado. Neste caso, siga as instruções fornecidas pelo navegador para visualizar e exportar o certificado. Talvez seja necessário autenticar com um ID de usuário e uma senha de administrador antes que o navegador permita exportar o certificado. Use o procedimento de amostra a seguir para acessar o HMC pela primeira vez no navegador Mozilla Firefox: 1. Insira o nome do host ou o endereço IP do HMC no campo de entrada de URL do navegador. 2. Se o certificado não puder ser validado, uma janela pop-up de aviso será exibida com o título "Esta Conexão Não É Confiável". Clique em "Eu Compreendo os Riscos" e, em seguida, clique em Incluir Exceção. O diálogo "Incluir Exceção de Segurança" é exibido. 3. Clique em Obter Certificado. Essa ação permite que o navegador recupere o certificado e faz com que o botão Visualizar seja ativado. 4. Clique em Visualizar para abrir a caixa de diálogo Visualizador do Certificado. 5. Verifique se as informações nos campos sobre quem emitiu o certificado e para quem foi emitido está correto. Se essas informações estiverem corretas, clique no botão Detalhes e, em seguida, no botão Exportar para salvar o certificado em seu disco. 6. O certificado é armazenado no formato de texto e agora pode ser copiado para o sistema em que o Enterprise Common Collector está sendo executado e importado no armazenamento confiável do coletor. Consulte Gerenciando os Certificados Usando a Linha de Comandos na página 70 para obter informações sobre a importação de um certificado. Considerações de Firewall Quando a API de Serviços da Web estiver ativada, o servidor HTTP da API System z Hardware Management Console (HMC) atenderá pelas conexões de soquete baseadas em SSL no TCP porta O HMC é ativado para os protocolos Secure Socket Layer (SSL) versão 3 e Transport Layer Security (TLS) versão 1 nesta porta SSL. Ele não aceita conexões não SSL. Capítulo 3. Configurando o System z Hardware Management Console para Uso com o Enterprise Common Collector 15

26 Como parte da API de Serviços da Web, o HMC também fornece um message broker Java Message Server (JMS) integrado baseado no Apache ActiveMQ Versão Este message broker fica ativo no HMC sempre que a API de Serviços da Web estiver ativada. Quando ativo, o broker integrado atende as conexões do cliente usando o protocolo OpenWire que flui nas conexões SSL, atendendo a porta: 61617, que é suportada pelo ActiveMQ. O broker é ativado para os protocolos SSL versão 3 e TLS versão 1 nessas portas SSL. As portas de atendimento listadas anteriormente para a API e para o message broker são números de portas fixos e não estão sujeitas à reconfiguração do cliente. Se você tiver firewalls entre o Enterprise Common Collector e o HMC, entre em contato com o administrador da rede para configurar regras de firewall que permitem a comunicação sobre estas portas por meio de firewalls. Testando a Conexão do Enterprise Common Collector para os HMCs Siga este procedimento para verificar a conexão entre o Enterprise Common Collector e o System z Hardware Management Console Procedimento 1. Determine e registre os nomes completos do host dos sistemas nos quais o System z Hardware Management Console cujas conexões ao Enterprise Common Collector você deseja testar. 2. Abra um navegador no sistema em que o Enterprise Common Collector está sendo executado. O navegador da web deve conseguir exibir o conteúdo JSON (por exemplo, Mozilla Firefox e certas configurações do Microsoft Internet Explorer). 3. Insira esta URL: em que hostname_hmc é o nome completo de host do HMC que você está testando. Se esta for a primeira vez que você usou este navegador para conectar este HMC, provavelmente precisará aceitar (temporariamente) o certificado deste HMC. Resultados Se conexão entre o HMC e o coletor estiver disponível, você deve ver um retorno semelhante a este: {"api-major-version": api_version, "hmc-version": hmc_version, "hmc-name": hmc_name, "api-minor-version": api_minor_version} Em que: api_version É a versão do código de API HMC (por exemplo, 1.2). hmc_version É a versão do software que o HMC está executando (por exemplo, ). hmc_name É o nome do HMC. api_minor_version É o nível de liberação da versão de API do HMC (por exemplo, 2). Aqui está a saída de amostra desse comando: {"api-major-version":1,"hmc-version":"2.11.1","hmc-name":"hmc510","api-minor-version":2} 16 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

27 Se você não encontrar esse retorno, a conexão não está funcionando. Consulte Capítulo 3, Configurando o System z Hardware Management Console para Uso com o Enterprise Common Collector, na página 13 para obter informações sobre a configuração do HMC. Capítulo 3. Configurando o System z Hardware Management Console para Uso com o Enterprise Common Collector 17

28 18 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

29 Capítulo 4. Instalando o Enterprise Common Collector Você deve instalar e configurar o Enterprise Common Collector antes de instalar os componentes que se conectam a ele. Use uma das três maneiras a seguir para instalar este componente. v Instalando o Enterprise Common Collector Usando o Assistente de Instalação na página 20 v Instalando o Enterprise Common Collector a partir do Console na página 35 v Instalando o Enterprise Common Collector Usando o Método de Instalação Silenciosa na página 40 Seis versões do programa de instalação que estão listadas na Tabela 4 podem ser encontradas no DVD IBM Tivoli Enterprise Common Collector V Nos procedimentos a seguir, use a versão aplicável à sua plataforma e sistema operacional. Tabela 4. Plataformas e Versões do Assistente de Instalação do Enterprise Common Collector Assistente de Instalação setup_ecc_v1102_aix_ppc64.bin setup_ecc_v1102_linux_s390x.bin setup_ecc_v1102_linux_x86_32.bin setup_ecc_v1102_linux_x86_64.bin setup_ecc_v1102_windows_x86_32.exe setup_ecc_v1102_windows_x86_64.exe Plataforma de destino para instalar o coletor AIX POWER, 64 bits Linux on System z, 64 bits Linux on System x, 32 bits (Intel de 32 bits) Linux on System x, 64 bits (inclui EM64T (Xeon) e AMD64 (Opteron)) Windows Server, 32 bits Windows Server, 64 bits Também existem inúmeras tarefas de configuração que devem ser executadas, a partir da interface da linha de comandos ou programaticamente usando uma interface de programação de aplicativos (API). Quando você concluir as tarefas neste capítulo, continue para Capítulo 6, Customizando o Enterprise Common Collector, na página 61. Instalar o Enterprise Common Collector a partir de um ID do Usuário com Autoridade de Administrador ou Raiz O Enterprise Common Collector foi projetado para ser executado como um serviço do Windows ou como um daemon Linux ou UNIX. Ao executar como um serviço do sistema ou o daemon, o Enterprise Common Collector pode ser iniciado automaticamente quando o sistema operacional for inicializado. A instalação como um serviço ou daemon requer um ID do usuário com privilégios administrativos ("Administrator" no Windows, "root" no UNIX ou Linux). Se não executar a instalação do Enterprise Common Collector a partir de um ID de usuário com a autoridade correta, você deve configurar o serviço manualmente. Consulte Registrando Manualmente o Enterprise Common Collector como um Serviço na página 47. Atualizando para uma nova versão Os scripts e painéis de amostra nesta seção refletem os padrões do sistema. No entanto, se você estiver atualizando, esses painéis refletirão os valores de sua instalação existente que as ferramentas migram para você, portanto, os valores serão diferentes. Copyright IBM Corp. 2012,

30 Para obter considerações sobre o upgrade, veja Capítulo 5, Atualizando o o sensor TADDM zenterprise e o Enterprise Common Collector, na página 59. Instalando o Enterprise Common Collector Usando o Assistente de Instalação Use este procedimento para instalar o Enterprise Common Collector, usando o assistente de instalação. Sobre Esta Tarefa Saia de todos os outros programas antes de iniciar esta instalação. É possível clicar em Cancelar durante a instalação para sair desta instalação até que atinja a tela Resumo de Pré-instalação. Se decidir cancelar o processo de instalação após esta etapa, os arquivos instalados não serão removidos automaticamente. Em vez disso, será necessário seguir o procedimento de desinstalação explicado em Desinstalando o Enterprise Common Collector Usando o Assistente de Instalação na página 54 para remover uma imagem do Enterprise Common Collector parcialmente instalada. É possível fazer backup para uma tela anterior, clicando em Anterior. O caminho padrão é clicar em Avançar. Os erros gerados por este processo de instalação são registrados em um desses arquivos de log específicos de plataforma: Plataforma Linux ou UNIX Windows Local do Log /tmp/ecc.log C:\tmp\ecc.log Procedimento 1. Insira o DVD IBM Tivoli Enterprise Common Collector V na unidade de DVD e inicie o assistente de instalação ativando no arquivo de configuração apropriado da plataforma. Tabela 5. Plataformas e Versões do Assistente de Instalação do Enterprise Common Collector Assistente de Instalação setup_ecc_v1102_aix_ppc64.bin setup_ecc_v1102_linux_s390x.bin setup_ecc_v1102_linux_x86_32.bin setup_ecc_v1102_linux_x86_64.bin setup_ecc_v1102_windows_x86_32.exe setup_ecc_v1102_windows_x86_64.exe Plataforma de destino para instalar o coletor AIX POWER, 64 bits Linux on System z, 64 bits Linux on System x, 32 bits (Intel de 32 bits) Linux on System x, 64 bits (inclui EM64T (Xeon) e AMD64 (Opteron)) Windows Server, 32 bits Windows Server, 64 bits A tela de Boas-vindas é exibida: 20 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

31 Figura 1. Tela de Boas-vindas do Enterprise Common Collector 2. Use o menu suspenso para selecionar seu idioma e clique em OK. 3. A tela Introdução é exibida. Clique em Avançar para aceitar os padrões e continuar. Clique em Avançar. Capítulo 4. Instalando o Enterprise Common Collector 21

32 Figura 2. Tela Introdução do Enterprise Common Collector 4. A tela Contrato de Licença de Software é exibida. Leia o contrato de licença. É possível clicar em Imprimir para criar uma cópia impressa do contrato. Você deve clicar no botão de opções adjacente a Eu Aceito os Termos no Contrato de Licença e clicar em Avançar para continuar. 22 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

33 Figura 3. Tela Contrato de Licença do Software Enterprise Common Collector 5. A tela Tipo de Instalação é exibida. É possível selecionar uma instalação Típica ou Avançada. A instalação Típica é recomendada para a maioria dos usuários. Se você tiver uma situação especial que requer que você altere as designações de porta padrão, clique no botão de opções adjacentes a Avançado. Caso contrário, clique no botão adjacente a Típico e clique em Avançar para continuar. Capítulo 4. Instalando o Enterprise Common Collector 23

34 Figura 4. Tela Tipo de Instalação do Enterprise Common Collector 6. Se você não selecionou Avançado na tela anterior, a tela Escolher Pasta de Instalação será exibida. A menos que você tenha uma razão convincente para instalar em um local diferente, aceite esse padrão. O local da instalação padrão é o seguinte: Plataforma Linux ou UNIX Windows Diretório Padrão /opt/ibm/ecc C:\IBM\ECC 24 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

35 Figura 5. Enterprise Common Collector - Tela Escolher Pasta de Instalação Nota: Se você estiver atualizando em vez de executar uma instalação pela primeira vez, não verá esta tela. Se você selecionar uma pasta inválida para instalar o Enterprise Common Collector, esta mensagem será mostrada: Figura 6. Tela Pasta Destino Não Suportado do Enterprise Common Collector 7. A tela Resumo de Pré-instalação é exibida. O resumo mostra a pasta de instalação selecionada e exibe a quantia de espaço em disco necessária e a quantia disponível. Se você concordar com essas informações, clique em Avançar para continuar. Capítulo 4. Instalando o Enterprise Common Collector 25

36 Figura 7. Tela Resumo de Pré-instalação do Enterprise Common Collector Nota: Se decidir cancelar o processo de instalação após esta etapa, os arquivos instalados não serão removidos automaticamente. Em vez disso, será necessário seguir o procedimento de desinstalação explicado em Desinstalando o Enterprise Common Collector Usando o Assistente de Instalação na página 54 para remover uma imagem do Enterprise Common Collector parcialmente instalada. 8. A tela Instalando o Enterprise Common Collector é exibida e a instalação é iniciada quando você pressiona Instalar. A barra de progresso mostra visualmente até onde você foi no processo de instalação. As mensagens são exibidas refletindo quais componentes estão sendo instalados (como o ambiente de tempo de execução Java eoarquivo Web Application Archive (WAR) do aplicativo). 26 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

37 Figura 8. Tela Instalando o Enterprise Common Collector do Enterprise Common Collector Nota: Se você estiver atualizando, não verá as Etapas 9 a 13. Isso ocorre porque o Enterprise Common Collector usa o mesmo par de chaves após o upgrade que foi criado durante a instalação inicial. Vá para Etapa A tela Geração de Par de Chaves é exibida. É solicitado que insira as informações necessárias para que o Enterprise Common Collector gere o par de chaves customizado que permite que um certificado autoassinado seja criado, garantindo uma comunicação segura entre o coletor e seus clientes. O valor padrão "desconhecido" é exibido, mas você deve alterar esses valores. Capítulo 4. Instalando o Enterprise Common Collector 27

38 Figura 9. Tela Geração de Par de Chaves do Enterprise Common Collector 10. Forneça as informações a seguir: v Nome completo do host deste sistema de computadores: O nome completo do host (incluindo o nome de domínio) do computador no qual o Enterprise Common Collector está sendo instalado. v Nome abreviado da organização: Um nome abreviado identificando sua organização no certificado no certificado autoassinado que é gerado para o par de chaves. v Alias de chave: O alias que é usado ao acessar este par de chaves no keystore do Enterprise Common Collector. Se um desses campos for deixado em branco ou for configurado como desconhecido "Unknown", esta mensagem será exibida: Figura 10. Pop-up de Informações Incompletas do Enterprise Common Collector 11. Clique em OK para fechar a janela pop-up e corrija as informações incorretas. Se você fornecer um alias que já exista no keystore, esta mensagem será mostrada: 28 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

39 Figura 11. Pop-up Alias Já Existe do Enterprise Common Collector 12. Clique em OK para fechar a janela pop-up e corrija as informações incorretas. Quando todas as informações estiverem corretas, clique em Avançar para continuar. 13. O processamento para esta solicitação ocorre e o status de tela denominado Aguarde é exibido. Finalmente, a janela pop-up Resultados de Geração de Par de Chaves confirma que seu par de chaves foi gerado com êxito e você será informado do local para onde o certificado será exportado. Figura 12. Tela Resultados de Geração do Par de Chaves do Enterprise Common Collector 14. Quando de instalação e configuração estiverem concluídas, a tela Instalação Completa será exibida. Clique em Pronto para sair do assistente de instalação. Capítulo 4. Instalando o Enterprise Common Collector 29

40 Figura 13. Tela Instalação Bem-sucedida do Enterprise Common Collector Se a sua instalação não foi concluída com êxito, você verá esta mensagem: A instalação do Enterprise Common Collector foi concluída, mas alguns erros ocorreram durante a instalação. Consulte o log de instalação para obter detalhes. Pressione "ENTER" para sair do instalador. ou esta mensagem: A instalação do Enterprise Common Collector foi concluída, mas alguns erros graves ocorreram durante a instalação. Consulte o log de instalação para obter detalhes. Abra o arquivo do log de instalação que está localizado neste local: Plataforma Linux ou UNIX Windows Local do Log /tmp/ecc.log C:\tmp\ecc.log Leia as mensagens para determinar o motivo pelo qual o coletor não foi instalado corretamente e tente a operação novamente. Usando o Caminho Avançado para Configurar as Portas Use este procedimento para alterar as portas padrão que o Enterprise Common Collector usa com o programa de instalação. Sobre Esta Tarefa As designações de porta padrão no Enterprise Common Collector são pré-selecionadas para minimizar o risco de conflitos de portas que possam existir no ambiente. Se você tiver uma razão convincente para 30 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

41 alterar as portas padrão, use este caminho no programa de instalação para fazer mudanças de porta. Procedimento 1. Continue com o processo de instalação conforme descrito em Instalando o Enterprise Common Collector Usando o Assistente de Instalação na página Quando você atingir o local no programa de instalação em que a tela Tipo de Instalação é exibida, selecione a instalação Avançada. Figura 14. Tela Tipo de Instalação do Enterprise Common Collector com Avançado Selecionado 3. Esta ação faz com que a tela Designações de Porta seja exibida. Capítulo 4. Instalando o Enterprise Common Collector 31

42 Figura 15. Tela Tipo de Instalação do Enterprise Common Collector com Configurações de Porta Selecionadas Quando você rolar esta tela, verá essas decisões de designação de porta adicionais. Use esta tabela para entender as designações de porta: Tabela 6. Designações de Porta Padrão para o Programa de Instalação Identificador de Porta Explicação Valor Padrão ActiveMQPort A porta usada pelo WebSphere Application Server Community Edition para se comunicar com o conector de transporte ActiveMQ (fila de mensagens ativas). No WebSphere Application Server Community Edition, as mensagens corporativas são implementadas usando o projeto de software livre do Apache ActiveMQ. Na configuração do servidor inicial, o broker ActiveMQ é configurado com os conectores de rede JMS a seguir: um listener TCP na porta e um listener Streaming Text Orientated Messaging Protocol (STOMP) na porta Consulte o website do projeto em para obter informações adicionais sobre o serviço de mensagem ActiveMQ e sua interoperabilidade com outros sistemas de mensagens IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

43 Tabela 6. Designações de Porta Padrão para o Programa de Instalação (continuação) Identificador de Porta Explicação Valor Padrão AJPPort O número da porta em que o WebSphere Application Server Community Edition atende por solicitações AJP. Quando o servidor é instalado, a configuração inicial do WebSphere Application Server Community Edition contém um conector que recebe as solicitações HTTP usando o Apache Jserv Protocol (AJP). Embora o WebSphere Application Server Community Edition possa receber as solicitações HTTP diretamente da rede, este conector permite que o WebSphere Application Server Community Edition receba as solicitações do software em uma camada inferior. Por exemplo, o WebSphere Application Server Community Edition pode receber solicitações de servidores da web (como Apache HTTP Server), servidores de proxy e sistemas de balanceamento de carga que suportam os protocolos AJP. AJPPort é o número de porta AJP para o WebSphere Application Server Community Edition COSNamingPort DerbyPort HTTPSPort JMXPort O número da porta de serviço de nomenclatura CORBA usado pelo WebSphere Application Server Community Edition. CORBA pode ser usado para controlar a comunicação entre um cliente aplicativo Java EE e o servidor ou para implementar um cliente de aplicativos do Java EE. A porta usada pelo WebSphere Application Server Community Edition para se comunicar com o Apache Derby. O Apache Derby é um banco de dados relacional de software livre implementado inteiramente no Java e fica disponível sob o Apache License, Versão 2.0. Para obter informações adicionais, consulte O número da porta no qual o WebSphere Application Server Community Edition atende pelas solicitações HTTP seguras. A porta usada pelo Java Management extension (JMX) para se conectar a uma instância em execução do WebSphere Application Server Community Edition. JMX é uma estrutura que fornece uma maneira padrão de expor os recursos Java, por exemplo, os servidores de aplicativos, para uma infraestrutura de gerenciamento de sistemas. Usando a estrutura JMX, um provedor pode implementar funções, como listar as definições de configuração e editar as configurações. Esta estrutura também inclui uma camada de notificação que os aplicativos de gerenciamento podem usar para monitorar eventos como a inicialização de um servidor de aplicativos. Nota: Este valor foi alterado do valor padrão IBM WebSphere Application Server Community Edition para resolver um conflito com o IBM Tivoli Monitoring Capítulo 4. Instalando o Enterprise Common Collector 33

44 Tabela 6. Designações de Porta Padrão para o Programa de Instalação (continuação) Identificador de Porta Explicação Valor Padrão JMXSecurePort MulticastDiscoveryPort MultipointPort NamingPort OpenEJBPort ORBPort ORBSSLPort SMTPPort A porta segura usada pelo Java Management extension (JMX) para se conectar a uma instância em execução do WebSphere Application Server Community Edition. JMX é uma estrutura que fornece uma maneira padrão de expor os recursos Java, por exemplo, os servidores de aplicativos, para uma infraestrutura de gerenciamento de sistemas. Usando a estrutura JMX, um provedor pode implementar funções, como listar as definições de configuração e editar as configurações. Esta estrutura também inclui uma camada de notificação que os aplicativos de gerenciamento podem usar para monitorar eventos como a inicialização de um servidor de aplicativos. Para WASCE e posterior, a opção --secure pode ser usada para se conectar ao servidor JMX usando um canal seguro com os comandos de implementação e encerramento. Define a porta multicast IPv6 por meio da qual o agente do nó envia pedidos de descoberta a seus servidores gerenciados. Define o número da porta usado para se comunicar com um nó remoto. A porta não deve ser a porta padrão 4201 do servidor openejb. A porta Jconsole para monitorar as informações gerais do servidor local, por exemplo, memórias, encadeamentos e resumos de VM. A porta de nomenclatura padrão para WebSphere Application Server Community Edition é Nota: Este valor foi alterado do valor padrão IBM WebSphere Application Server Community Edition para resolver um conflito com o IBM Tivoli Monitoring. A porta usada pelo OpenEJB (Enterprise JavaBeans) para fornecer os serviços EJB. A porta usada pelo WebSphere Application Server Community Edition OpenEJB ORB Adapter. A porta usada pelo WASCE Object Request Broker (ORB) Secure Socket Layer (SSL). O número da porta em que o WebSphere Application Server Community Edition atende por solicitações Simple Mail Transfer Protocol (SMTP) Para consultar o uso da porta atual para possíveis conflitos, você pode usar este método. O exemplo usa o valor padrão COSNamingPort de 1050 como um exemplo. a. Emita este comando: Plataforma Comando Linux netstat -tuln grep 1050 AIX netstat -an grep 1050 Windows netstat -an find "1050" b. Examine a saída de um retorno de valor Se nenhum valor for retornado, é provável que a porta 1050 não esteja atualmente em uso. 4. Altere quaisquer designações de porta que precisar para resolver diversos conflitos de porta de uso. Consulte a tela Configurações de Porta Atuais exibidas para confirmação. 34 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

45 Figura 16. Tela Tipo de Instalação do Enterprise Common Collector com Configurações de Porta Atuais Selecionadas 5. Clique em Avançar para retornar à tela Seleção de Caminho. As etapas a seguir são as mesmas para o caminho Típico. Instalando o Enterprise Common Collector a partir do Console Para instalar o Enterprise Common Collector a partir de um console, conclua o procedimento a seguir. Sobre Esta Tarefa Os erros gerados por este processo de instalação são registrados em um desses arquivos de log específicos de plataforma: Plataforma Windows Linux ou UNIX Local do Log C:\tmp\ecc.log /tmp/ecc.log Saia de todos os outros programas antes de iniciar esta instalação. É possível cancelar a instalação até atingir o prompt Resumo de Pré-instalação. Se decidir cancelar o processo de instalação após esta etapa, os arquivos instalados não serão removidos automaticamente. Em vez disso, será necessário seguir o procedimento de desinstalação explicado em Desinstalando o Enterprise Common Collector a partir do Console na página 56 para remover uma imagem do Enterprise Common Collector parcialmente instalada. Procedimento 1. Insira o DVD IBM Tivoli Enterprise Common Collector V na unidade de DVD e localize a versão correta para sua plataforma: Capítulo 4. Instalando o Enterprise Common Collector 35

46 Tabela 7. Plataformas e Versões da Instalação do Enterprise Common Collector Assistente de Instalação Plataforma de destino para instalar o coletor setup_ecc_v1102_aix_ppc64.bin AIX POWER, 64 bits setup_ecc_v1102_linux_s390x.bin Linux on System z, 64 bits setup_ecc_v1102_linux_x86_32.bin Linux on System x, 32 bits (Intel de 32 bits) setup_ecc_v1102_linux_x86_64.bin Linux on System x, 64 bits (inclui EM64T (Xeon) e AMD64 (Opteron)) setup_ecc_v1102_windows_x86_32.exe Windows Server, 32 bits setup_ecc_v1102_windows_x86_64.exe Windows Server, 64 bits 2. Instale o produto, emitindo o comando de instalação do console: <setup_file> -i console em que <setup_file> é um dos nomes de arquivo da tabela na Etapa 1. Uma janela de comando é exibida e é solicitada uma entrada. O exemplo a seguir mostram os diretórios para os sistemas Windows, mas os prompts para Linux ou UNIX são os mesmos (embora os caminhos sejam diferentes). 3. A janela de comando solicita um código de idioma: Escolha o Código de Idioma Deutsch ->2- English 3- Espagñol 4- Français 5- Italiano 6- Português (Brasil) CHOOSE LOCALE BY NUMBER:_ Insira o número para o seu código de idioma e pressione Enter. 4. Você verá o início da instalação Enterprise Common Collector: O InstallAnywhere conduzirá você através da instalação do Enterprise Common Collector v É altamente recomendado que você encerre todos os programas antes de continuar com esta instalação. Responda a cada prompt para continuar com a próxima etapa na instalação. deseja alterar algo em uma etapa anterior, digite back. Se É possível cancelar esta instalação a qualquer momento digitando quit. Para obter informações sobre instalação e configuração do Enterprise Common Collector, consulte ao manual de instalação localizado na biblioteca de documentação do produto usando esse componente. Aviso: Este programa é protegido pelas leis de copyright e tratados internacionais. A reprodução ou distribuição não autorizadas deste programa ou de qualquer parte dele pode resultar em ações penais graves. PRESSIONE <ENTER> PARA CONTINUAR: 5. O Contrato de Licença Internacional é exibido. Use estas instruções para continuar: 36 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

47 Pressione Enter para continuar visualizando o contrato de licença ou insira "1" para aceitar o contato, "2" para recusá-lo, "3" para imprimi-lo ou "99" para voltar para a tela anterior. 6. Ao aceitar o contrato de licença, você verá as designações de porta e terá a opção de aceitar essas designações de porta. Use o caminho Típico ou faça mudanças nessas designações de porta e use o caminho Avançado. =============================================================================== Tipo de Instalação Selecione o tipo de configuração "Típica" ou "Avançada" para a sua instalação. "Típica" solicitará os painéis mínimos de configuração do assistente necessários. O Enterprise Common Collector será instalado com as opções mais comuns. Esta opção é recomendada para a maioria dos usuários. Enterprise Common Collector. A opção "Avançada" fornecerá a oportunidade para customizar qualquer um dos valores da porta conforme listado. ActiveMQPort (ActiveMQ Transport Connector): AJPPort (Tomcat Connector AJP): 8009 COSNamingPort (CORBA Naming Service): 1050 DerbyPort (Derby Connector): 1527 HTTPSPort (Tomcat Connector HTTPS): 8443 JMXPort (JMX Remoting Connector): 8989 JMXSecurePort (JMX Secure Remoting Connector): 9998 MulticastDiscoveryPort (Multi Cast Discovery): 6142 MultipointPort (Multi Point Connector): 4212 NamingPort (RMI Naming): 2098 OpenEJBPort (OpenEJB Daemon): 4201 ORBPort (OpenEJB ORB Adapter): 6882 ORBSSLPort (OpenEJB ORB Adapter): 2001 SMTPPort (Simple Mail Transfer Protocol): 25 ->1- Típica 2- Avançada INSIRA O NÚMERO DE SUA OPÇÃO OU PRESSIONE <ENTER> PARA ACEITAR O PADRÃO: Neste exemplo, selecione Típica. Para obter informações adicionais sobre as designações de porta e seleção, consulte Usando o Caminho Avançado para Configurar as Portas na página Sua escolha do tipo de instalação Típica é exibida e você pode pressionar a tecla Backspace para alterar essa decisão para Avançar ou Enter para continuar. =============================================================================== Tipo de Instalação Típica Você selecionou o tipo de instalação "Típica". Continue concluindo o processo de instalação ou digite "back" para selecionar novamente o Tipo de Instalação. PRESSIONE <ENTER> PARA CONTINUAR: 8. Ao pressionar Enter, você verá o prompt para escolher a pasta de instalação. Se você estiver atualizando em vez de executar uma instalação pela primeira vez, não verá esta tela. =============================================================================== Escolha uma Pasta de Instalação Nota: A Pasta de Destino não deve incluir espaços em branco ou caracteres especiais. Onde você deseja instalar? Capítulo 4. Instalando o Enterprise Common Collector 37

48 Pasta de Instalação Padrão: c:\ibm\ecc INSIRA UM CAMINHO ABSOLUTO OU PRESSIONE <ENTER> PARA ACEITAR O PADRÃO : Insira um caminho ou pressione Enter para selecionar e aceitar o padrão. Se você especificar uma pasta inválida para instalar o Enterprise Common Collector, esta mensagem será mostrada: =============================================================================== Pasta Destino Não Suportado invalid_path não é suportado como um caminho de destino. O caminho de destino não deve incluir nenhum espaço em branco, colchetes ou outros caracteres especiais. PRESSIONE <ENTER> PARA ACEITAR O SEGUINTE (OK): 9. É exibido um Resumo de Pré-instalação semelhante ao mostrado a seguir. =============================================================================== Resumo de Pré-instalação Revise o Seguinte antes de Continuar: Nome do Produto: Enterprise Common Collector Pasta de Instalação: C:\IBM\ECC Informações de Espaço em Disco (para Destino de Instalação): Necessários: Bytes Disponíveis: Bytes PRESSIONE <ENTER> PARA CONTINUAR: Pressione Enter para continuar. 10. O prompt e resumo Pronto para Instalar é exibido: =============================================================================== Pronto para Instalar O InstallAnywhere agora está pronto para instalar o Enterprise Common Collector no seu sistema no local a seguir: C:\IBM\ECC Não tente a instalação se não houver espaço disponível suficiente (consulte "Resumo de Pré-instalação" anterior). Se você precisar fazer mudanças antes de iniciar a instalação, digite "back". Digite "quit" para terminar esta sessão de instalação. PRESSIONE <ENTER> PARA INSTALAR: Pressione Enter para continuar a instalação. Nota: Se decidir cancelar o processo de instalação após esta etapa, os arquivos instalados não serão removidos automaticamente. Em vez disso, será necessário seguir o procedimento de desinstalação 38 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

49 explicado em Desinstalando o Enterprise Common Collector a partir do Console na página 56 para remover uma imagem do Enterprise Common Collector parcialmente instalada. 11. A barra de progresso Instalando... é exibida. 12. Durante a instalação, é solicitado que insira as informações necessárias para que o Enterprise Common Collector gere o par de chaves customizado que permite que o um certificado autoassinado seja criado, garantindo uma comunicação segura entre o coletor e seus clientes. Nota: Se você estiver atualizando, não verá as Etapas 12 e 13. Isso ocorre porque o Enterprise Common Collector usa o mesmo par de chaves após o upgrade que foi criado durante a instalação inicial. Alterne para Etapa 14. =============================================================================== Geração do Par de Chaves O instalador Enterprise Common Collector agora vai gerar um par de chaves customizado para comunicação segura entre o Enterprise Common Collector e seus clientes. Todos os campos de entrada são obrigatórios. Forneça as informações a seguir: O nome do host completo deste sistema de computador: O nome do host, incluindo o nome de domínio do sistema de computador no qual o Enterprise Common Collector está sendo instalado. O nome abreviado da sua organização: Um nome breve identificando sua organização no certificado autoassinado que será gerado para o par de chaves. Alias da chave: O alias a ser usado ao acessar o par de chaves no keystore Enterprise Common Collector. : Se algum desses campos permanecer em branco ou estiver configurado como "Desconhecido" ou se você fornecer um alias que já exista no keystore ou um nome do host inválido, uma mensagem será exibida e solicitará novamente pelas informações válidas. Forneça as informações solicitadas e pressione Enter para continuar com a instalação. 13. Você receberá a confirmação de que seu par de chaves foi gerado com êxito e será informado do local para onde o certificado será exportado. =============================================================================== Resultados de Geração do Par de Chaves Geração de chaves concluída com êxito. O certificado foi exportado para o arquivo C:\IBM\ECC\certificates\IBMalias.cert PRESSIONE <ENTER> PARA ACEITAR O SEGUINTE (OK): Pressione Enter para continuar a instalação. 14. Quando a instalação for concluída, você verá esta mensagem: =============================================================================== Instalação Concluída Parabéns. O Enterprise Common Collector foi instalado com êxito em: Capítulo 4. Instalando o Enterprise Common Collector 39

50 C:\IBM\ECC Nota: A implementação do aplicativo está em andamento e ainda continuará sua inicialização por vários minutos. Sair desta seção de instalação do console não afetará seu processamento. PRESSIONE <ENTER> PARA SAIR DO INSTALADOR: Pressione Enter para sair do instalador. Instalando o Enterprise Common Collector Usando o Método de Instalação Silenciosa É possível instalar o Enterprise Common Collector em todas as plataformas suportadas usando a instalação silenciosa seguindo estas etapas. Procedimento 1. Insira o DVD IBM Tivoli Enterprise Common Collector V na unidade de DVD e localize o arquivo de resposta do Enterprise Common Collector setup_ecc_install.rsp. 2. Copie o arquivo de resposta setup_ecc_install.rsp de amostra para um local gravável para que seja possível editá-lo. 3. Edite o arquivo setup_ecc_install.rsp e forneça os valores para as variáveis de instalação a seguir. Se estiver atualizando, use o mesmo arquivo de respostas que você criou para instalar o Enterprise Common Collector pela primeira vez. a. Não altere esta lista se você planeja usar a instalação silenciosa: INSTALLER_UI=silent b. Altere o valor da variável LICENSE_ACCEPTED para true e remova o comentário desta linha (remova o #), se aceitar o contrato de licença. LICENSE_ACCEPTED=false em que os valores válidos são true ou false. v Se LICENSE_ACCEPTED for algo diferente de true, a instalação silenciosa será interrompida e nenhum log é produzido. Essa falta de um arquivo de log é o único indicador que você recebe de que a instalação silenciosa falhou. v Ao remover o sinal de número (#) e alterar o valor para LICENSE_ACCEPTED de false para true, você está indicando que aceita o contrato de licença. Se você deseja revisar esse arquivo, ele encontra-se no subdiretório license do DVD do produto. c. Especifique um diretório válido no qual o produto deve ser instalado. Remova o comentário das linhas a seguir (remova o #) no arquivo de resposta que corresponde à plataforma na qual você está instalando o Enterprise Common Collector. Plataforma Windows UNIX ou Linux Comando USER_INSTALL_DIR=C:\\IBM\\ECC USER_INSTALL_DIR=/opt/IBM/ecc d. Edite a seção Designações de Porta do programa de instalação silenciosa e faça as atualizações apropriadas para as configurações da porta padrão a seguir, conforme necessário, ou mantenha os valores padrão. v Examine o uso da porta atual de cada porta para expor os conflitos de porta. Use os comandos a seguir: 40 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

51 Plataforma Comando Windows netstat -an find /i "port_number" Em que port_number é o número da porta que você está consultando. UNIX ou Linux netstat -an grep port_number Em que port_number é o número da porta que você está consultando. Examine a saída deste comando para determinar se uma designação de porta padrão para o Enterprise Common Collector designou um uso diferente em seu ambiente. Em caso positivo, designe uma porta diferente. v O número da porta válido é um número de até cinco dígitos no intervalo de 1 a Se designar configurações de porta inválidas, os valores serão reconfigurados para seus respectivos valores padrão durante o processamento de instalação. v A menos que haja uma razão convincente para alterar a designação de porta, mantenha os padrões, o que simplifica as atualizações futuras. Tabela 8. Designações de Porta Padrão Identificador de Porta Explicação Valor Padrão ActiveMQPort AJPPort COSNamingPort A porta usada pelo WebSphere Application Server Community Edition para se comunicar com o conector de transporte ActiveMQ (fila de mensagens ativas). No WebSphere Application Server Community Edition, as mensagens corporativas são implementadas usando o projeto de software livre do Apache ActiveMQ. Na configuração do servidor inicial, o broker ActiveMQ é configurado com os conectores de rede JMS a seguir: um listener TCP na porta e um listener Streaming Text Orientated Messaging Protocol (STOMP) na porta Consulte o website do projeto em para obter informações adicionais sobre o serviço de mensagem ActiveMQ e sua interoperabilidade com outros sistemas de mensagens. O número da porta em que o WebSphere Application Server Community Edition atende por solicitações AJP. Quando o servidor é instalado, a configuração inicial do WebSphere Application Server Community Edition contém um conector que recebe as solicitações HTTP usando o Apache Jserv Protocol (AJP). Embora o WebSphere Application Server Community Edition possa receber as solicitações HTTP diretamente da rede, este conector permite que o WebSphere Application Server Community Edition receba as solicitações do software em uma camada inferior. Por exemplo, o WebSphere Application Server Community Edition pode receber solicitações de servidores da web (como Apache HTTP Server), servidores de proxy e sistemas de balanceamento de carga que suportam os protocolos AJP. AJPPort é o número de porta AJP para o WebSphere Application Server Community Edition. O número da porta de serviço de nomenclatura CORBA usado pelo WebSphere Application Server Community Edition. CORBA pode ser usado para controlar a comunicação entre um cliente aplicativo Java EE e o servidor ou para implementar um cliente de aplicativos do Java EE Capítulo 4. Instalando o Enterprise Common Collector 41

52 Tabela 8. Designações de Porta Padrão (continuação) Identificador de Porta Explicação Valor Padrão DerbyPort A porta usada pelo WebSphere Application Server Community Edition para se comunicar com o Apache Derby. O Apache Derby é um banco de dados relacional de software livre implementado inteiramente no Java e fica disponível sob o Apache License, Versão 2.0. Para obter informações adicionais, consulte HTTPSPort JMXPort JMXSecurePort MulticastDiscoveryPort MultipointPort NamingPort OpenEJBPort ORBPort O número da porta no qual o WebSphere Application Server Community Edition atende pelas solicitações HTTP seguras. A porta usada pelo Java Management extension (JMX) para se conectar a uma instância em execução do WebSphere Application Server Community Edition. JMX é uma estrutura que fornece uma maneira padrão de expor os recursos Java, por exemplo, os servidores de aplicativos, para uma infraestrutura de gerenciamento de sistemas. Usando a estrutura JMX, um provedor pode implementar funções, como listar as definições de configuração e editar as configurações. Esta estrutura também inclui uma camada de notificação que os aplicativos de gerenciamento podem usar para monitorar eventos como a inicialização de um servidor de aplicativos. Nota: Este valor foi alterado do valor padrão IBM WebSphere Application Server Community Edition para resolver um conflito com o IBM Tivoli Monitoring. A porta segura usada pelo Java Management extension (JMX) para se conectar a uma instância em execução do WebSphere Application Server Community Edition. JMX é uma estrutura que fornece uma maneira padrão de expor os recursos Java, por exemplo, os servidores de aplicativos, para uma infraestrutura de gerenciamento de sistemas. Usando a estrutura JMX, um provedor pode implementar funções, como listar as definições de configuração e editar as configurações. Esta estrutura também inclui uma camada de notificação que os aplicativos de gerenciamento podem usar para monitorar eventos como a inicialização de um servidor de aplicativos. Para WASCE e posterior, a opção --secure pode ser usada para se conectar ao servidor JMX usando um canal seguro com os comandos de implementação e encerramento. Define a porta multicast IPv6 por meio da qual o agente do nó envia pedidos de descoberta a seus servidores gerenciados. Define o número da porta usado para se comunicar com um nó remoto. A porta não deve ser a porta padrão 4201 do servidor openejb. A porta Jconsole para monitorar as informações gerais do servidor local, por exemplo, memórias, encadeamentos e resumos de VM. A porta de nomenclatura padrão para WebSphere Application Server Community Edition é Nota: Este valor foi alterado do valor padrão IBM WebSphere Application Server Community Edition para resolver um conflito com o IBM Tivoli Monitoring. A porta usada pelo OpenEJB (Enterprise JavaBeans) para fornecer os serviços EJB. A porta usada pelo WebSphere Application Server Community Edition OpenEJB ORB Adapter IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

53 Tabela 8. Designações de Porta Padrão (continuação) Identificador de Porta Explicação Valor Padrão ORBSSLPort SMTPPort A porta usada pelo WASCE Object Request Broker (ORB) Secure Socket Layer (SSL). O número da porta em que o WebSphere Application Server Community Edition atende por solicitações Simple Mail Transfer Protocol (SMTP) Para consultar o uso da porta atual para possíveis conflitos, você pode usar este método. O exemplo usa o valor padrão COSNamingPort de 1050 como um exemplo. 1) Emita este comando: Plataforma Comando Linux ou UNIX netstat -an grep 1050 Windows netstat -an find "1050" 2) Examine a saída de um retorno de valor Se nenhum valor for retornado, é provável que a porta 1050 não esteja atualmente em uso. e. Edite a seção que contém os parâmetros para geração de par de chaves customizado para comunicação segura com os clientes Enterprise Common Collector. Forneça as informações a seguir: Tabela 9. Parâmetros para Geração de Par de Chaves Parâmetro Explicação Valor Padrão ECC_CERT_O ECC_CERT_ALIAS O nome abreviado de sua organização (por exemplo, IBM). O alias sob o qual o par de chaves deve ser armazenado no keystore. Desconhecido Você não pode avançar sem substituir "desconhecido" por um valor válido. Desconhecido Você não pode avançar sem substituir "desconhecido" por um valor válido. 4. Salve o arquivo setup_ecc_install.rsp atualizado. 5. Execute o instalador correspondente ao seu sistema operacional e arquitetura. O instalador é executado sem prompts adicionais e com saída de tela mínima. Plataforma UNIX ou Linux Windows Comando./<setup_file> -f full_path/setup_ecc_install.rsp start /wait <setup_file> -f full_path\setup_ecc_install.rsp O comando start /wait impede que o arquivo setup_ecc_windows.exe retorne os valores imediatos. Se, em vez disso, o assistente de instalação for iniciado, isso significa que o parâmetro -f não é válido. Se o parâmetro -f informar ao instalador onde o arquivo de resposta está localizado e o nome do arquivo de resposta. Pare a instalação, verifique o caminho e o nome do arquivo para assegurar que eles estejam corretos e emita o comando novamente. Em que <setup_file> é um dos seguintes: Tabela 10. Plataformas e Versões da Instalação do Enterprise Common Collector assistente de instalação setup_ecc_v1102_aix_ppc64.bin Plataforma de destino para instalar o coletor AIX POWER, 64 bits Capítulo 4. Instalando o Enterprise Common Collector 43

54 Tabela 10. Plataformas e Versões da Instalação do Enterprise Common Collector (continuação) assistente de instalação Plataforma de destino para instalar o coletor setup_ecc_v1102_linux_s390x.bin Linux on System z, 64 bits setup_ecc_v1102_linux_x86_32.bin Linux on System x, 32 bits (Intel de 32 bits) setup_ecc_v1102_linux_x86_64.bin Linux on System x, 64 bits (inclui EM64T (Xeon) e AMD64 (Opteron)) setup_ecc_v1102_windows_x86_32.exe Windows Server, 32 bits setup_ecc_v1102_windows_x86_64.exe Windows Server, 64 bits Exemplo Aqui está o texto do arquivo de resposta: ## setup_ecc_install.rsp ## ## Variáveis InstallAnywhere para configurar a instalação silenciosa do Enterprise Common Collector ## ## Plataformas suportadas do Windows: ## ## Uso: start /wait setup_ecc_v1102_windows.exe -f <full_path>\setup_ecc_install.rsp ## ## Com windows, o comando "start /wait" evitará que setup_ecc_v1102_windows.exe ## seja retornado imediatamente. ## ## Se você encontrar o painel GUI no início, isso significa que o parâmetro -f ## não é válido. Pare de instalar, marque o parâmetro -f e inicie novamente. ## ## ## Plataformas suportadas Unix: ## ## Uso (exemplo do linux):./setup_ecc_v1102_xlinux.bin -f <full_path>/setup_ecc_install.rsp ## ## ## No mínimo, você DEVE atualizar e remover o comentários das instruções a seguir conforme observado ## na seção "Configurações de Instalação" abaixo: ## ## USER_INSTALL_DIR ## LICENSE_ACCEPTED ## ################################################################################################ ####################################### # Configurações de Instalação # ####################################### ############################################################### # Não altere a linha a seguir. Esta configuração indica # para usar esse arquivo para uma instalação silenciosa. ############################################################### INSTALLER_UI=silent ################################################################################ # # Configurar a Aceitação da Licença Silenciosa # # Aceitar contrato de licença: remover o sinal de número (#), # por exemplo, LICENSE_ACCEPTED=true # # Desinstalação Silenciosa: não defina LICENSE_ACCEPTED, # deixe-a com a linha comentada com o sinal de número (#) na frente. # # Se LICENSE_ACCEPTED for algo diferente de "true", # a instalação sairá, nenhum log será produzido 44 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

55 # e sem indicação de falha fornecida. # # Ao remover o sinal de número (#) e alterar o valor # para LICENSE_ACCEPTED de "false" para "true", você terá indicado # aceitação do contrato de licença.# ################################################################################ #LICENSE_ACCEPTED=false ##################################################################### # # Local de Instalação do Enterprise Common Collector # O local de instalação do produto. Especifique um diretório válido # no qual o produto deve ser instalado. # O caminho do diretório não deve incluir espaços, colchetes ou outros caracteres # especiais. # Os separadores de arquivo do Windows (\) deve ser escapado com um caractere barra invertida. # Por exemplo, para instalar o produto para C:\IBM\ECC, use C:\\IBM\\ECC # #---- Plataforma Windows: #USER_INSTALL_DIR=C:\\IBM\\ECC # #---- Plataforma UNIX: #USER_INSTALL_DIR=/opt/IBM/ecc ##################################################################### ################################################################################## # # Designações de Porta # # Selecione Avançar para manter esses valores da porta padrão conforme listados acima ou especificar outros # valores abaixo. É recomendável primeiro examinar o uso da porta atual # (com o comando netstat) para determinar se haverá conflitos de portas. # # O intervalo válido é de 1 a Apenas caracteres numéricos. # # Nota: As configurações de porta que não são válidas serão reconfiguradas para seus respectivos # valores padrão durante o processamento de instalação. # # Para referência, estes são os valores padrão: # # ActiveMQPort=61626 JMXPort=8989 OpenEJBPort=4201 # AJPPort=8009 JMXSecurePort=9998 ORBPort=6882 # COSNamingPort=1050 MulticastDiscoveryPort=6142 ORBSSLPort=2001 # DerbyPort=1527 MultipointPort=4212 SMTPPort=25 # HTTPSPort=8443 NamingPort=2098 # # Faça as atualizações apropriadas na configuração de porta abaixo ou mantenha os valores padrão: # ActiveMQPort=61626 AJPPort=8009 COSNamingPort=1050 DerbyPort=1527 HTTPSPort=8443 JMXPort=8989 JMXSecurePort=9998 MulticastDiscoveryPort=6142 MultipointPort=4212 NamingPort=2098 OpenEJBPort=4201 ORBPort=6882 ORBSSLPort=2001 SMTPPort=25 Capítulo 4. Instalando o Enterprise Common Collector 45

56 ################################################################################## ################################################################################## # # Parâmetros para geração de par de chaves customizados para comunicação segura com # clientes Enterprise Common Collector # # Substitua cada um dos valores especificados com um valor apropriado para a sua # organização # # ECC_CERT_O: Nome abreviado da sua organização (por exemplo, IBM) ECC_CERT_O=Unknown # ECC_CERT_ALIAS: O alias sob o qual o par de chaves deve ser armazenado no keystore # (por exemplo, MyAlias) ECC_CERT_ALIAS=Unknown Verificando se o Enterprise Common Collector Foi Instalado Corretamente Siga este procedimento para iniciar o Enterprise Common Collector e verifique se instalou o componente corretamente. Sobre Esta Tarefa Não tente executar quaisquer ações que envolvam o Enterprise Common Collector até que tenha concluído a configuração localizada em Capítulo 6, Customizando o Enterprise Common Collector, na página 61. Procedimento 1. Se você instalou o Enterprise Common Collector a partir de um ID do usuário com autoridade de Administrador (Windows) ou raiz (Linux ou UNIX), o coletor deve ser iniciado automaticamente como um serviço ou daemon. Se você não instalou o coletor desta maneira, deve registrar o serviço manualmente. Consulte Registrando Manualmente o Enterprise Common Collector como um Serviço na página Para confirmar se o Enterprise Common Collector foi iniciado com êxito, procure esta mensagem no arquivo de log do coletor. a. Navegue até o local e abra o log de mensagem Enterprise Common Collector: Plataforma Linux ou UNIX Windows Local do Log /opt/ibm/ecc/wasce/var/log/enterprisecommoncollector.0.log C:\IBM\ECC\wasce\var\log\EnterpriseCommonCollector.0.log b. Consulte esta mensagem: CTGEZ0101I Enterprise Common Collector iniciado com êxito. Essa mensagem indica que todos os componentes do coletor foram iniciados com êxito. 3. Para entender como iniciar e parar o serviço do Enterprise Common Collector, consulte Iniciando, Parando, Removendo, Instalando e Consultando o Status do Enterprise Common Collector na página IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

57 O que Fazer Depois Se não instalou o Enterprise Common Collector a partir de um ID do usuário com autoridade de administrador (Windows) ou raiz (Linux ou UNIX), você deve registrar o serviço Enterprise Common Collector manualmente. Consulte Registrando Manualmente o Enterprise Common Collector como um Serviço. Se você estiver pronto para configurar o Enterprise Common Collector, continue em Capítulo 6, Customizando o Enterprise Common Collector, na página 61. Registrando Manualmente o Enterprise Common Collector como um Serviço Se não instalou o Enterprise Common Collector a partir de um ID do usuário com autoridade de administrador (Windows) ou raiz (Linux ou UNIX) para o sistema operacional, então deve instalar o serviço Enterprise Common Collector manualmente. Sobre Esta Tarefa Esta tarefa deve ser executada a partir de um ID do usuário com autoridade de administrador (Windows) ou raiz (Linux ou UNIX) para o sistema operacional. Esta tarefa requer que pelo menos 100 KB de espaço fique disponível em seu diretório tmp. Este espaço no diretório tmp também é necessário no momento da instalação (ou seja, quando o instalador cria o serviço,/daemon). Procedimento 1. Navegue até o subdiretório no qual os scripts de inicialização de serviço ECC estão localizados: Plataforma UNIX ou Linux Windows Local do script de inicialização <install_dir>/bin/ <install_dir>\bin\ 2. Emita o comando específico de plataforma para ativar o serviço Enterprise Common Collector. Plataforma Linux ou UNIX Windows Comando./eccService.sh install eccservice install Uma janela é exibida brevemente. 3. Para confirmar se o serviço ou daemon do Enterprise Common Collector foi iniciado corretamente, abra uma janela de comando e navegue para este local: Plataforma UNIX ou Linux Windows Local <install_dir>/bin/ <install_dir>\bin\ E emita este comando: Plataforma Linux ou UNIX Windows Comando./eccService.sh status eccservice status Se o eccservice estiver em execução, você deve ver uma mensagem semelhante à mensagem a seguir: Capítulo 4. Instalando o Enterprise Common Collector 47

58 Plataforma UNIX ou Linux Windows Mensagem Status para Service eccsvc: O servidor da porta está em execução. Status de Serviço eccsrv : ExitCode Name ProcessId StartMode State Status 0 eccsrv 1168 Auto Running OK 4. Para confirmar melhor se o Enterprise Common Collector está em execução, acesse o arquivo de log Enterprise Common Collector localizado neste local: Plataforma UNIX ou Linux Local do Log <install_dir>/var/logs/ Em que <install_dir> é o diretório inicial para WebSphere Application Server Community Editions. Windows <install_dir>\var\logs\ Em que <install_dir> é o diretório inicial para WebSphere Application Server Community Editions. Consulte esta mensagem: CTGEZ0101I Enterprise Common Collector iniciado com êxito. Essa mensagem indica que todos os componentes do coletor foram iniciados com êxito. Se você não visualizar esta mensagem, tente iniciar o coletor de qualquer forma e ver se a falha era na operação de criação de log. Se o coletor também falhar ao iniciar, chame o Suporte ao Software IBM. Iniciando, Parando, Removendo, Instalando e Consultando o Status do Enterprise Common Collector O Enterprise Common Collector é executado como um serviço Windows denominado eccsrv ou como um daemon Linux ou UNIX denominado eccsvc. Sobre Esta Tarefa Após a instalação, ao iniciar, parar, remover ou consultar o status do Enterprise Common Collector, você estará realmente endereçando esses comandos para o serviço Windows ou daemon Linux ou UNIX. O serviço Enterprise Common Collector é configurado para iniciar quando o sistema operacional for reinicializado e é executado em segundo plano enquanto a operação está em execução. O serviço também pode ser iniciado e parado manualmente quando necessário. Depois que o ECC é instalado como um serviço, você pode: v Parar o serviço do Enterprise Common Collector v Iniciar o serviço do Enterprise Common Collector v Remover o serviço do Enterprise Common Collector v Instalar o serviço do Enterprise Common Collector depois que tiver sido removido v Consultar o status do serviço do Enterprise Common Collector v Lista quaisquer processos Java associados ao Java Runtime Environment instalado com o Enterprise Common Collector. v Executar kill de quaisquer processos Java que ainda possam estar em execução após um conflito que afete o Enterprise Common Collector. Se você emitir o comando eccservice sem parâmetros ou com parâmetros inválidos, será fornecida uma breve instrução de uso. A instrução de uso fornece uma lista de parâmetros válidos. 48 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

59 Procedimento 1. Para parar o serviço Enterprise Common Collector, execute o seguinte: a. Abra uma janela de comandos e navegue para o diretório no qual o script do utilitário eccservice está instalado. Plataforma Linux ou UNIX Windows Local do script de instalação <install_dir>/bin/ <install_dir>\bin\ b. A partir de um ID do usuário com autoridade de administrador (Windows) ou root (Linux ou UNIX), emita este comando: Plataforma Linux ou UNIX Windows Local do script de instalação./eccservice.sh stop eccservice stop É possível ver esta mensagem confirmando que o serviço Enterprise Common Collector foi parado. Plataforma Linux ou UNIX Windows Local do script de instalação "Parando o Service eccsvc... Encerrando o servidor na porta Esperando o processo <install_dir>/jre/jre/bin/java terminar... Nenhum processo Enterprise Common Collector Java localizado." O serviço eccsrv foi interrompido. Nenhum processo Enterprise Common Collector Java foi localizado. Agora, se deseja usar o Enterprise Common Collector, você deve iniciar o serviço ou reiniciar o computador (sistema operacional) no qual o Enterprise Common Collector está instalado. 2. Para iniciar o serviço Enterprise Common Collector manualmente, execute o seguinte: a. Abra uma janela de comandos e navegue para o diretório no qual o serviço Enterprise Common Collector está sendo executado. Plataforma Linux ou UNIX Windows Local do script de instalação <install_dir>/bin/ <install_dir>\bin\ b. A partir de um ID do usuário com autoridade de administrador (Windows) ou root (Linux ou UNIX), emita este comando: Plataforma Linux ou UNIX Windows Local do script de instalação./eccservice.sh start eccservice start É possível ver esta mensagem confirmando que o serviço Enterprise Common Collector foi iniciado. Plataforma Linux ou UNIX Local do script de instalação Iniciando o eccsvc de Serviço... Iniciando o servidor na porta Capítulo 4. Instalando o Enterprise Common Collector 49

60 Plataforma Windows Local do script de instalação O comando inicial para o Service eccsrv foi emitido. Status de Serviço eccsrv : ExitCode Name ProcessId StartMode State Status 0 eccsrv 2164 Auto Running OK Se você não instalou o Enterprise Common Collector a partir de um ID do usuário com autoridade de administrador (Windows) ou root (Linux ou UNIX), precisará executar esta etapa sempre que iniciar o Enterprise Common Collector. Se você executou o script de registro descrito no Registrando Manualmente o Enterprise Common Collector como um Serviço na página 47, não precisará iniciar o serviço a menos que o tenha interrompido manualmente desde a última reinicialização do sistema operacional. c. Outra maneira de iniciar o serviço Enterprise Common Collector no Windows é executar o seguinte: 1) Acesse o local do Windows para iniciar o serviço do Enterprise Common Collector: Iniciar -> Painel de Controle -> Ferramentas Administrativas -> Serviços. 2) Desça a rolagem até IBM Enterprise Common Collector Service - eccsrv. 3) Clique nele com o botão direito e selecione Iniciar. 3. Para remover o serviço Enterprise Common Collector, execute o seguinte: a. Assegure-se de que o serviço Enterprise Common Collector esteja parado. b. Abra uma janela de comandos e navegue para o diretório no qual o script do utilitário eccservice está instalado. Plataforma Linux ou UNIX Windows Local do script de instalação <install_dir>/bin/ <install_dir>\bin\ c. A partir de um ID do usuário com autoridade de administrador (Windows) ou root (Linux ou UNIX), emita este comando: Plataforma Linux ou UNIX Windows Local do script de instalação./eccservice.sh remove eccservice remove É possível ver esta mensagem confirmando que o serviço Enterprise Common Collector foi removido. Plataforma Linux ou UNIX Windows Local do script de instalação Removendo o Service eccsvc... O serviço eccsrv foi removido. Observe que esta ação remove o serviço do conjunto de programas que são iniciados automaticamente quando o sistema operacional é inicializado. Ela não desinstala o Enterprise Common Collector. Para desinstalar o Enterprise Common Collector, consulte Desinstalando o Enterprise Common Collector Usando o Assistente de Instalação na página 54 ou Desinstalando o Enterprise Common Collector a partir do Console na página Se você removeu o serviço Enterprise Common Collector, deve instalá-lo novamente. Para isso, execute o seguinte: a. Abra uma janela de comandos e navegue para o diretório no qual o script do utilitário eccservice está instalado 50 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

61 Plataforma Linux ou UNIX Windows Local do script de instalação <install_dir>/bin/ <install_dir>\bin\ b. A partir de um ID do usuário com autoridade de administrador (Windows) ou root (Linux ou UNIX), emita este comando: Plataforma Linux ou UNIX Windows Local do script de instalação./eccservice.sh install eccservice install Você verá uma mensagem semelhante à seguinte: Plataforma Linux ou UNIX Windows Local do script de instalação Instalando o eccsvc de Serviço... O eccsrv de serviço foi instalado. 5. Para consultar o status do serviço Enterprise Common Collector, execute o seguinte: a. Abra uma janela de comandos e navegue para o diretório no qual o script do utilitário eccservice está instalado Plataforma Linux ou UNIX Windows Local do script de instalação <install_dir>/bin/ <install_dir>\bin\ b. A partir de um ID do usuário com autoridade de administrador (Windows) ou root (Linux ou UNIX), emita este comando: Plataforma Linux ou UNIX Windows Local do script de instalação./eccservice.sh status eccservice status Você verá uma mensagem semelhante à seguinte: Plataforma Linux ou UNIX Windows Local do script de instalação Status para Service eccsvc: O servidor na porta 2098 está em execução. Status de Serviço eccsrv : ExitCode Name ProcessId StartMode State Status 0 eccsrv 2164 Auto Running OK 6. Para listar alguns processos Java associados à instância do WebSphere Application Server Community Edition que é instalada com o Enterprise Common Collector, execute o seguinte: a. Abra uma janela de comandos e navegue para o diretório no qual o script do utilitário eccservice está instalado. Plataforma Linux ou UNIX Windows Local do script de instalação <install_dir>/bin/ <install_dir>\bin\ Capítulo 4. Instalando o Enterprise Common Collector 51

62 b. A partir de um ID do usuário com autoridade de administrador (Windows) ou root (Linux ou UNIX), emita este comando: Plataforma Linux ou UNIX Windows Local do script de instalação./eccservice.sh listproc eccservice listproc Você verá mensagens semelhantes ao seguinte: Plataforma Linux ou UNIX Windows Local do script de instalação Um dos seguintes: Nenhum processo Enterprise Common Collector Java localizado. Ou listará os processos, como: PID PORT COMMAND <install_dir>/jre/jre/bin/java Um dos seguintes: Nenhuma Instância Disponível. Ou listará os processos, como: HandleCount Name Priority ProcessId ThreadCount WorkingSetSize 653 java.exe Para parar todos os processos Java associados à instância do WebSphere Application Server Community Edition que é instalada com o Enterprise Common Collector, execute o seguinte: a. Abra uma janela de comandos e navegue para o diretório no qual o script do utilitário eccservice está instalado. Plataforma Linux ou UNIX Windows Local do script de instalação <install_dir>/bin/ <install_dir>\bin\ b. A partir de um ID do usuário com autoridade de administrador (Windows) ou root (Linux ou UNIX), emita este comando: Plataforma Linux ou UNIX Windows Local do script de instalação./eccservice.sh kill eccservice kill Atenção: Use o comando kill apenas se o comando stop falhar ao parar corretamente o daemon ou serviço ECC. Usar o comando kill pode resultar em perda de dados. Depois de emitir este comando, você verá uma mensagem semelhante à seguinte: Plataforma Linux ou UNIX Windows Local do script de instalação Se nenhum processo estiver disponível para kill: Nenhum processo Enterprise Common Collector Java localizado. Se houver um processo a ser encerrado: Finalizando os processos do Enterprise Common Collector: Finalizando o Processo O processo <install_dir>\jre\jre\bin\java.exe foi encerrado. 52 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

63 Reconfigurando a Contagem de Login Inválido do Enterprise Common Collector para o ID do Usuário Admin É permitido a você um máximo de três tentativas com falha de efetuar logon em qualquer ID de usuário do Enterprise Common Collector, incluindo o ID de usuário admin padrão. Mais tentativas falhas fazem com que o ID do usuário seja bloqueado ou desativado para logon. Essa condição pode surgir se um usuário maldoso estiver tentando efetuar logon como admin e estiver supondo incorretamente sua senha. Se você estiver outro ID de usuário do Enterprise Common Collector definido na função Administrator, será possível usar esse ID de usuário para reconfigurar a contagem de logon inválido para o ID do usuário admin. Portanto, a criação de um ID de usuário adicional na função Administrator durante o processo de instalação é sugerido. Consulte Criando, Listando, Atualizado e Excluindo os Clientes Usando a Linha de Comandos na página 72 para obter informações sobre como atualizar um ID do cliente para reconfigurar uma senha ou o número de tentativas de logon. No entanto, se admin for o único ID do usuário definido na função Administrator e ele será desativado devido a tentativas de senha incorretas, ele pode ser reconfigurado usando o script do utilitário reseteccadmin. Se o ID do usuário admin for o único com autoridade de administrador e estiver bloqueado, use este processo para reconfiguração a contagem de login inválido. Execute este script a partir do sistema em que o Enterprise Common Collector está instalado. 1. Pare o Enterprise Common Collector. (O script executa esse encerramento automaticamente se o Enterprise Common Collector estiver em execução.) 2. Navegue até o subdiretório onde os scripts do administrador estão localizados: Plataforma UNIX ou Linux Windows Diretório Padrão <install_dir>/bin/ <install_dir>\bin\ 3. A partir de um ID do usuário com autoridade de administrador (Windows) ou root (Linux ou UNIX), emita este comando: Plataforma Linux ou UNIX Windows Local do script de instalação./reseteccadmin.sh reseteccadmin.bat Este script reconfigura o atributo invalid-login-attempts para 0. Este script não altera a senha existente para o ID do usuário admin. Se a senha para o ID de usuário admin foi perdida, o banco de dados Enterprise Common Collector e o banco de dados do backup deve ser excluído e recriado e as definições de configuração restabelecidas. Você terá que executar as etapas de configuração a seguir novamente: a. Efetue login no console do administrador usando o ID do usuário e senha padrão no modo interativo. Consulte Efetuando Logon no Enterprise Common Collector Usando a Interface da Linha de Comandos na página 66. b. Se desejar usar a autenticação LDAP, consulte Definindo se o Enterprise Common Collector Usa a Autenticação Base ou LDAP Usando a Linha de Comandos na página 69. c. Se desejar usar um certificado que não seja o certificado autoassinado básico ou usar um um armazenamento confiável diferente, consulte Gerenciando os Certificados Usando a Linha de Comandos na página 70. d. Se desejar configurar os perfis de coleção que não sejam o perfil default, consulte Configurando o Perfil de Coleção Usando a Linha de Comandos na página 75. e. Você deve redefinir as origens de dados. Consulte Configurando as Origens de Dados HMC Usando a Linha de Comandos na página 80. Capítulo 4. Instalando o Enterprise Common Collector 53

64 f. Você deve redefinir os clientes. Consulte Criando, Listando, Atualizado e Excluindo os Clientes Usando a Linha de Comandos na página Reinicie o Enterprise Common Collector usando o procedimento descrito em Iniciando, Parando, Removendo, Instalando e Consultando o Status do Enterprise Common Collector na página 48. O script reseteccadmin reinicia automaticamente o Enterprise Common Collector se tiver sido considerado ativo quando o reseteccadmin foi iniciado. Restaurando a Configuração Padrão do Enterprise Common Collector Se for necessário reconfigurar o Enterprise Common Collector para sua configuração padrão, isso poderá ser feito com as etapas a seguir. Sobre Esta Tarefa Isso pode ser necessário, se, por exemplo, a senha para o ID do usuário admin for ausente e nenhum outro ID do usuário que possua a função Administrator estiver disponível para alterar esta senha. Certifique-se de que reconfigurar o Enterprise Common Collector para sua configuração padrão significa que você perde todas as configurações (como origens de dados, ID de usuário e perfis de configuração). Você terá que reconfigurar o coletor. Consulte Capítulo 6, Customizando o Enterprise Common Collector, na página 61 para obter uma visão geral dessas tarefas de configuração. Procedimento 1. Pare o Enterprise Common Collector. 2. Exclua os diretórios a seguir, incluindo todos os arquivos e subdiretórios contidos: Plataforma UNIX ou Linux Windows Diretório Padrão <install_dir>/wasce/var/ecc/backup <install_dir>/wasce/var/ecc/database <install_dir>\wasce\var\ecc\backup <install_dir>\wasce\var\ecc\database Nota: Se o coletor for iniciado com o diretório do banco de dados excluído, o coletor tentará reconfigurar-se a partir do último pacote configurável de backup disponível. Se esta tentativa for malsucedida, o coletor se reconfigurará com a configuração padrão. No entanto, uma reconfiguração do mais recente pacote configurável de backup poderia significar que a situação precisava de restauração da configuração padrão (uma senha perdida para o ID do usuário admin, por exemplo) ainda pode existir no pacote configurável de backup restaurado. 3. Inicie o Enterprise Common Collector. Durante a inicialização, o coletor recriará sua configuração padrão (incluindo o ID do usuário admin com a senha padrão). 4. Reconfigure o Enterprise Common Collector para corresponder às suas necessidades novamente. Consulte Capítulo 6, Customizando o Enterprise Common Collector, na página 61. Desinstalando o Enterprise Common Collector Usando o Assistente de Instalação Faça o seguinte para desinstalar o Enterprise Common Collector (ECC) usando o assistente de instalação. Sobre Esta Tarefa O processo de desinstalação geralmente é padronizado para o modo que você escolhe para instalação. Se você instalou no modo do console, por exemplo, o desinstalador será padronizado para o modo de console. Antes que ocorra uma desinstalação, os arquivos de log e backups do Enterprise Common Collector são copiados automaticamente para este local: 54 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector

65 Plataforma Linux ou UNIX Windows Diretório Padrão <install_dir>/backups <install_dir>\backups Nota: Em algumas instâncias, independentemente do tipo de operação de desinstalação que você especificou, o Windows pode executar uma desinstalação silenciosa. Se as telas de desinstalação não aparecerem, verifique se uma desinstalação ocorreu realmente antes de executar esta desinstalação novamente. Procedimento 1. Altere os diretórios para o diretório ECC de nível mais alto. Os padrões são os seguintes: Plataforma Linux ou UNIX Windows Diretório Padrão opt/ibm/ecc/_uninst C:\IBM\ECC\_uninst 2. Emita o comando específico de plataforma a seguir. Plataforma Linux ou UNIX Windows Diretório Padrão <install_dir>/_uninst/ecc_uninstall <install_dir>\_uninst\ ecc_uninstall.exe A tela Desinstalar a Introdução à Desinstalação do Enterprise Common Collector é exibida: Figura 17. Tela Introdução à Desinstalação do Desinstalar Enterprise Common Collector Clique em Desinstalar para continuar ou Cancelar para encerrar. Capítulo 4. Instalando o Enterprise Common Collector 55

66 3. Quando a operação de desinstalação for concluída, você verá a tela Desinstalação Concluída do Desinstalar Enterprise Common Collector. Figura 18. Tela Desinstalação Concluída do Desinstalar Enterprise Common Collector Clique em Pronto para sair. As mensagens de desinstalação estão localizadas neste local: Plataforma Linux ou UNIX Windows Local do Log /tmp/ecc_uninstall.log \tmp\ecc_uninstall.log 4. O processo de desinstalação não removerá o diretório de instalação do Enterprise Common Collector. Uma pasta de backups é criada sob o diretório de instalação que contém backups dos dados de configuração do coletor, além dos arquivos de log. Essas informações de backup serão restauradas se o coletor for reinstalado no mesmo local. Não exclua esses arquivos, a menos se o coletor não será reinstalado nesse sistema. Se esses arquivos são excluídos manualmente, a reinstalação do coletor nesse sistema exigirá que o coletor será reconfigurado. Desinstalando o Enterprise Common Collector a partir do Console Execute o seguinte para desinstalar o Enterprise Common Collector a partir do console. O processo de desinstalação é padronizado para o modo que você escolher para a instalação. Se você instalou no modo do console, por exemplo, o desinstalador será padronizado para o modo de console. Sobre Esta Tarefa Antes que ocorra uma desinstalação, o diretório de backup Enterprise Common é copiado automaticamente para este local: 56 IBM Tivoli Application Dependency Discovery Manager: Guia de Configuração e Referência do Enterprise Common Collector