Instalando agentes

É possível instalar qualquer combinação de agentes de monitoramento em um sistema gerenciado. Por exemplo, se você instalar o Monitoring Agent for MySQL para o monitoramento de servidores MySQL, talvez também queira instalar o Response Time Monitoring Agent para reunir mais informações de tempo de resposta para seus aplicativos Ruby. Você também pode desejar instalar o Monitoring Agent for Windows OS para monitorar outros aspectos do sistema, tais como o total de CPU, memória e disco.

Sua oferta determina quais agentes de monitoramento estão disponíveis para instalação. Para obter uma lista dos agentes incluídos em cada oferta, consulte Capacidades.

Para obter uma lista dos agentes que são executados em um sistema Windows, consulte Pré-instalação em sistemas Windows.

Antes de Iniciar

Faça download dos agentes. Consulte Fazendo download de seus agentes e coletores de dados.

Revise as informações em Requisitos do sistema para ter certeza de que você atendeu os requisitos para os agentes que pretende instalar.

Revise as tarefas de pré-requisito do agente antes de instalar os agentes. Para obter detalhes, consulte Pré-instalação em sistemas Windows.

Sobre Esta Tarefa

Assegure-se de ter permissão adequada para executar o script de instalação do agente e comandos do agente. Deve-se ter efetuado login usando um dos seguintes tipos de conta do usuário:

conta do usuário administrador padrão do Windows
conta do usuário administrador
conta do usuário, que seja membro do grupo de administradores
conta do usuário, que seja registrada como um administrador nos serviços do Active Directory

A coexistência de agente é suportada. É possível instalar agentes do IBM Cloud Application Performance Management no mesmo computador no qual agentes do IBM Tivoli Monitoring estão instalados. Entretanto, os dois tipos de agentes não podem ser instalados no mesmo diretório. Para obter mais informações sobre a coexistência de agentes, consulte Coexistência do agente Cloud APM e do agente Tivoli Monitoring.

Procedimento

Conclua estas etapas para instalar agentes de monitoramento em VMs e sistemas nos quais o sistema operacional Windows está instalado:

Em seu sistema, navegue para o diretório no qual você transferiu o arquivo compactado por download.
Extraia os arquivos de instalação do agente para sua oferta (ou ofertas) para o local onde deseja instalar o software do agente de monitoramento.
O script de instalação .bat é extraído para um diretório nomeado para o archive e a versão. Por exemplo: offering_Agent_Install_8.1.4.0. Os arquivos binários e relacionados à configuração do agente são extraídos em subdiretórios dentro desse diretório.
Abra um prompt de comandos como administrador.
1. A partir do menu Iniciar, digite comando na caixa de procura.
2. Clique com o botão direito em Prompt de Comandos na lista que é exibida e selecione Executar como administrador.
No prompt de comandos, execute o script de instalação com privilégios de Administrador no diretório que é nomeado para o archive e a versão:
```
cd offering_Agent_Install_version
installAPMAgents.bat
```
Restrição: Para o WebSphere Applications agent, os privilégios de administrador devem ser os mesmos privilégios que foram usados para instalar o WebSphere Application Server.
Para instalar os agentes no modo silencioso, consulte Instalando agentes silenciosamente.
Se você estiver instalando os agentes, forneça o nome do diretório de instalação.
O caminho da instalação padrão é C:\IBM\APM. O nome do diretório de instalação não pode exceder 80 caracteres e nem conter caracteres não ASCII, especiais ou caracteres de byte duplo. Os nomes de diretórios no caminho podem conter somente os seguintes caracteres: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ _\:0123456789()~-./.
Nota: Quando a criação de nome curto de arquivo (8dot3Name) estiver desativada, se os nomes de diretório no caminho contiverem espaços, a instalação não será suportada.

Se estiver fazendo upgrade do agente, essa etapa será ignorada e o agente será instalado no diretório de instalação anterior.
Quando questionado se você aceita o contrato de licença, insira 1 para aceitar o contrato e continuar ou insira 2 para recusar.
Após inserir 1 (aceitar), uma varredura de pré-requisito de seu ambiente é iniciada e demora alguns minutos para ser concluída. Se algum dos requisitos estiver ausente, uma mensagem direcionará você para um arquivo de log com a razão da falha. A ausência de um pré-requisito, como uma biblioteca ausente ou espaço em disco insuficiente, para a instalação. Deve-se abordar a falha e iniciar o script de instalação novamente.
Nota: Se a instalação sair com a seguinte mensagem, verifique se o serviço do servidor foi iniciado (Iniciar -> Ferramentas Administrativas -> Serviços). Se não, inicie o serviço do Servidor e execute installAPMAgents.bat novamente.
```
This script [installAPMAgents.bat] must be run as Administrator.
```
Após a instalação ser concluída e o prompt de comandos estar disponível, repita estas etapas para instalar mais agentes de monitoramento.

O que Fazer Depois

Configure seus agentes conforme necessário. Para verificar se seu agente de monitoramento requer configuração manual, consulte Implementação do agente e do coletor de dados. Para obter instruções de configuração ou se desejar revisar as definições de configuração padrão, consulte Configurando seu Ambiente.

Antes de instalar os novos agentes, o Windows Installer para temporariamente todos os agentes atualmente em execução no local do produto instalado. Após a conclusão da instalação, o instalador reinicia quaisquer agentes interrompidos. Deve-se reiniciar manualmente qualquer agente de monitoramento que não tiver sido iniciado automaticamente pelo instalador.

Se você estiver usando um proxy de encaminhamento porque seu firewall não permite conexões HTTPS de saída transparentes para hosts externos, deverá editar o arquivo de configuração do ambiente do agente. Para obter instruções, veja Configurando agentes para se comunicar através de um proxy de encaminhamento.
Se você fez upgrade de um agente a partir de uma versão anterior, identifique qualquer tarefa de reconfiguração ou migração que precise concluir antes de efetuar login no Console do Cloud APM. Para obter informações sobre essas tarefas, consulte Fazendo upgrade de agentes.

Use um dos métodos a seguir para iniciar o agente:

Clique em Iniciar > Todos os programas > Agentes IBM Monitoring > IBM Cloud Application Performance Management. Clique com o botão direito em um agente e clique em Iniciar.
Execute o seguinte comando
```
name-agent.bat start
```

Para obter informações sobre os comandos do agente de monitoramento, incluindo o nome a ser utilizado, consulte Utilizando comandos do agente. Para obter informações sobre quais agentes são iniciados automaticamente e manualmente, consulte Implementação do agente e do coletor de dados

Após um upgrade, é necessário reiniciar qualquer agente que não seja configurado e iniciado automaticamente pelo instalador.

Depois de configurar e iniciar o agente, visualize os dados que o agente está coletando.

Se você não estiver com login efetuado, siga as instruções em Iniciando o Console do Cloud APM.
Se você deseja visualizar sistemas gerenciados de seu domínio do IBM Tivoli Monitoring no Application Performance Dashboard, conclua as tarefas descritas em Integrando com o IBM Tivoli Monitoring V6.3.