Pré-instalação em sistemas Linux

Deve-se concluir as tarefas de pré-instalação necessárias antes de instalar agentes nos sistemas Linux. Algumas tarefas de pré-instalação são específicas do agente e outras se aplicam a diversos agentes.

Nota: Estes requisitos são além dos requisitos identificados nos Software Product Compatibility Reports.

Para obter os requisitos e as dependências da versão atual para seu agente, consulte Requisitos do sistema (APM Developer Center) para obter um link para os Relatórios de compatibilidade de produto de software.

Todos os agentes

As tarefas de pré-instalação a seguir são aplicáveis a todos os agentes:

Testar conectividade: Antes de instalar os agentes, assegure-se de que seu sistema possa se comunicar com o Servidor Cloud APM. Para obter informações sobre a verificação de conectividade com o Servidor Cloud APM, consulte Conectividade de rede.
Instalação do usuário não raiz: Deve-se ter permissões de leitura, gravação e execução para o diretório de instalação. Caso contrário, a instalação será cancelada. Para obter mais informações sobre a instalação do usuário não raiz, consulte Instalando agentes como um usuário não raiz.
limitação de 70 caracteres para o caminho de instalação: O diretório de instalação e o caminho para ele devem ter, no máximo, 70 caracteres.
Configurando a variável de ambiente CANDLEHOME: Se você usou anteriormente o ITM Agent Converter para instalar e configurar um agente no mesmo sistema gerenciado, a variável de ambiente CANDLEHOME foi mudada para o diretório onde o agente foi instalado com o \Agent Converter. Antes de instalar e configurar um agente nativo Cloud APM, deve-se configurar a variável de ambiente CANDLEHOME para um diretório diferente, caso contrário, o agente nativo Cloud APM não poderá ser iniciado.

Sistemas operacionais específicos

Red Hat Enterprise Linux (RHEL) 8

O pacote libnsl.so.1 é necessário no RHEL 8

Por padrão, o libnsl.so.1 não é instalado no Red Hat Enterprise Linux liberação 8.0. Sem esse pacote, nenhum agente pode ser instalado com sucesso. Deixe seu administrador configurar um repositório yum para você e, em seguida, execute este comando:

yum install libnsl

Após a instalação bem-sucedida, é possível ver /usr/lib64/libnsl.so.1.

Nota: O pacote libnsl.so.1 é necessário somente para agentes. Não é preciso executar esta etapa para coletores de dados.

Ignorando o scanner de pré-requisitos para alguns agentes

Antes de o scanner de pré-requisitos ser atualizado para se tornar compatível com os requisitos mais recentes, para alguns agentes, é possível ignorar o scanner de pré-requisitos. Para obter cenários adequados e instruções, consulte Efetuando bypass do scanner de pré-requisitos.

Nota: Não é preciso executar esta etapa para coletores de dados.

Agentes específicos

As tarefas de pré-instalação a seguir são aplicáveis aos agentes especificados:

DataPower agent

Deve-se executar o comando ulimit -d unlimited para assegurar que a variável de ambiente do sistema max data segment size seja configurada como unlimited. Esse agente não pode ser instalado na mesma máquina que o dispositivo DataPower que você deseja monitorar.

DataStage agent

Ative parâmetros no arquivo DSODBConfig.cfg. Conclua as etapas a seguir:
1. Abra o arquivo DSODBConfig.cfg no seguinte local em um editor:
  - infosphere_information_server_install_dir/Server/DSODB
2. Remova o comentário dos seguintes parâmetros removendo o símbolo #:
  - MonitorLinks=1
  - JobRunUsage=1
  - ResourceMonitor=1
  - DSODBON=1
3. Edite valores desses parâmetros iguais a 1.
Copie o driver JDBC do banco de dados usado para configuração de repositório de metadados no computador agente.
1. Tipo 4 JDBC 4 ou mais recente. Exemplo: db2jcc4.jar
2. Driver JDBC Tipo 4 para Oracle. Exemplo: ojdbc6.jar
3. Driver JDBC para MS SQL:
  - Sqljdbc41.jar requer um JRE de 7 e suporta a API JDBC 4.1.
  - Sqljdbc42.jar requer um JRE de 8 e suporta a API JDBC 4.2.

Agente do Servidor HTTP

Se instalar esse agente como um usuário raiz, deverá usar o mesmo ID do usuário para executar e configurar o agente.

Ao instalar e executar o agente como um usuário não raiz, é necessário que o usuário não raiz tenha o mesmo ID de usuário que o usuário que iniciou o IBM® HTTP Server. Caso contrário, o agente tem problemas com a descoberta do IBM HTTP Server. É possível usar o mesmo ID do usuário para executar e configurar o agente.

agente do Linux KVM

O Monitoring Agent for Linux KVM é um agente de diversas instâncias e conexões e suporta conexões com o hypervisor KVM baseado no Linux Corporativo e nos ambientes do Red Hat Enterprise Virtualization Manager (RHEV-M). É possível criar múltiplas instâncias desse agente para monitorar múltiplos hypervisors em um ambiente do hypervisor RHEV-M ou KVM. É possível monitorar as cargas de trabalho virtualizadas e analisar a capacidade de recurso em diferentes máquinas virtuais. Para conectar o agente a uma máquina virtual no ambiente do hypervisor KVM, você deve instalar os pré-requisitos: libvirt * .rpm e Korn Shell Interpreter (pdksh). O agente coleta métricas conectando-se remotamente a um hypervisor libvirt que gerencia as máquinas virtuais.

Microsoft SQL Server agent

Para monitorar um ambiente Microsoft SQL, o driver Microsoft SQL Server e Microsoft SQL ODBC deve ser instalado antes de instalar o Monitoring Agent for Microsoft SQL Server. Por exemplo, para instalar o driver ODBC no Red Hat Enterprise Linux, use o comando a seguir:

sudo yum install unixODBC
sudo yum install msodbcsql17

Para concluir a execução do verificador de pré-requisitos, o agente precisa ser configurado na Correção provisória de servidor 15 do Cloud Application Performance Management Versão 8.1.4.0 (8.1.4.0-IBM-APM-SERVER-IF0015. tar) ou mais recente.

Agente MongoDB

Deve-se instalar e configurar o Agente MongoDB no sistema em que o servidor de banco de dados MongoDB está instalado.

Agente MySQL

Para monitorar um ambiente MySQL, o servidor MySQL e o driver JDBC MySQL deverão ser instalados antes de você instalar o Monitoring Agent for MySQL. Por exemplo, para instalar o driver JDBC no Red Hat Enterprise Linux, use o comando a seguir:

yum install mysql-connector-java

Após iniciar a instalação do agente e durante a verificação de pré-requisito para o nome do pacote MySQL, você pode receber um aviso se um provedor diferente de RedHat é usado, tal como Oracle. Se o MySQL Server e o driver JDBC estiverem disponíveis, o aviso não fará com que a instalação falhe e será possível desconsiderar a mensagem. Saída de amostra:

Scenario: Prerequisite Scan
KSE - Monitoring Agent for MySQL Prerequisite Checker [version 01000005]:
Property                               Result   Found                                     Expected 
========                      ====== =====       ======== 
os.package.mysql-server         WARN  Unavailable  mysql-server-5.1.12+
os.package.mysql-connector-java WARN Unavailable mysql-connector-java-5.
1.12+

Agente Node.js

A versão de Node.js usada para executar seu aplicativo monitorado deve ser a mesma que a versão padrão instalada.

Atualmente, Node.js v5 não é suportado.

OpenStack agent

Antes de poder usar o agente OpenStack agent, deve-se ter o software a seguir no servidor em que o agente é instalado:

Python 2.6.0 ou mais recente ou Python 2.7.0 ou mais recente
Clientes do OpenStack mais recente:
- OpenStack
- Pedra angular
- Neutron
- Swift
Para instalar os clientes da linha de comandos do OpenStack, consulte Instalar os clientes da linha de comandos do OpenStack.
Biblioteca Paramiko para acesso remoto em Python.
Nota: Se você deseja instalar o OpenStack agent em um servidor RedHat Linux limpo, antes de instalar a biblioteca Paramiko, execute o seguinte comando para instalar o software necessário:
```
Wget https://ftp.dlitz.net/pub/dlitz/crypto/pycrypto/pycrypto-2.6.1.tar.gz
Yum install gcc/openssl-devel/libffi-devel
```
ShellKorn

Agente Oracle Database

No Red Hat Enterprise Linux versão 5 e versão 6 e no SUSE Linux Enterprise Server versão 11 e versão 12 x64, se o Agente Oracle Database monitora o banco de dados Oracle remotamente, deve-se instalar os clientes instantâneos do Oracle primeiro. Instale os clientes instantâneos Oracle a partir do Oracle Technology Network - Instant Client Downloads.

Os clientes instantâneos v10.x ,v11.x e v12.x são suportados pelo Agente Oracle Database.

Agente PHP

Se o aplicativo PHP for implementado usando o usuário raiz, deve-se usar o usuário raiz para instalar, configurar, iniciar ou parar o agente. Se o aplicativo PHP for implementado usando um usuário não raiz, é possível usar o usuário raiz ou o mesmo usuário não raiz para instalar, configurar, iniciar ou parar o agente.

Você deve ter um aplicativo WordPress existente instalado. O Agente PHP monitora o WordPress V3.7.1 ou posterior.

O agente avalia somente o desempenho de solicitações PHP em aplicativos WordPress. Carregamento CSS e JS não são avaliados.

O agente não usa argumentos de URL para identificar URLs.

Coletor de dados do Python

O Coletor de dados do Python monitora aplicativos Django.

Response Time Monitoring Agent

Antes de instalar o Agente Response Time Monitoring, revise a seção de planejamento de instalação aqui: Planejando a Instalação.

SAP HANA Database agent

Instale o cliente de banco de dados SAP HANA HDBSQL versão 1.00.102.06 ou mais recente no sistema Linux.
Importante: Para o sistema operacional RHEL 5.x de 64 bits, instale o Linux SUSE 9 no cliente de banco de dados x86_64 64bit SAP HANA em vez do Linux on x86_64 64bit. Para os sistemas operacionais RHEL 6.x, ou mais recente de 64 bits, instale o Linux no cliente de banco de dados x86_64 64bit SAP HANA.
Execute o comando a seguir para incluir o caminho do diretório de instalação na variável de ambiente LD_LIBRARY_PATH:
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:install_directory_path

Exemplo: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/sap/hdbclient, onde /usr/sap/hdbclient indica o caminho de instalação do cliente de banco de dados do SAP HANA.

Importante:

Se o caminho de instalação do cliente de banco de dados do SAP HANA não for incluído na variável de ambiente LD_LIBRARY_PATH, o scanner de pré-requisitos retornará o resultado FAIL.

A variável de ambiente incluída usando o comando de exportação persistirá somente para uma determinada sessão do terminal. Portanto, certifique-se de executar o script de instalação do agente a partir do mesmo terminal usado para incluir a variável de ambiente.

Synthetic Playback agent

Para instalar o Synthetic Playback agent, o usuário do sistema operacional requer as seguintes permissões:

Ativar permissão de leitura e execução para a imagem de instalação
Ativar permissão de gravação para o início do agente

Para executar o Synthetic Playback agent, o usuário do sistema operacional requer as seguintes permissões:

Ativar permissão de leitura, gravação e execução para o local de instalação do agente e seus subdiretórios e arquivos.
Ativar permissão para executar o Mozilla Firefox.
Certifique-se de que o binário de execução do Mozilla Firefox esteja na variável de ambiente PATH do perfil do usuário.

Antes de instalar Synthetic Playback agent, deve-se concluir as etapas a seguir:

Sincronize os locais de instalação do agente com o Console do Cloud APM.
Instale o Mozilla Firefox e o servidor de exibição Xvfb.
Verifique se o servidor de exibição Xvfb está funcionando. Execute o comando:
```
# Xvfb -ac
```
Não deve haver nenhuma saída de erro.

Verifique se o processo Xvfb está em execução. Execute o seguinte comando:

# ps -ef|grep Xvfb

Saída de amostra:

root 7192 1 0 Jan14 ? 00:00:14 Xvfb -ac
root 20393 17900 0 02:05 pts/0 00:00:00 grep -i xvfb

Pare o processo Xvfb. Execute o seguinte comando:
```
# kill -9 7192
```
Navegue para install_dir/etc/hosts e edite o início dos arquivos host para incluir os parâmetros a seguir:
```
127.0.0.1 localhost
```
Em seguida, salve e feche os arquivos host.

WebSphere Applications agent

Antes de instalar o agente, o verificador de pré-requisitos verifica se ulimit está configurado como 524000 no sistema Linux. Você deve executar o comando ulimit -d 524000 para assegurar que a variável de ambiente do sistema max data segment size esteja configurada como 524000.