Instalación de agentes

Puede instalar cualquier combinación de agentes de supervisión en un sistema gestionado. Por ejemplo, si instala el Agente de Ruby para supervisar las aplicaciones de Ruby On Rails, quizá prefiera instalar también el Agente de Supervisión de tiempo de respuesta, el Agente de sistema operativo Linux o los dos agentes. Con el Agente de Supervisión de tiempo de respuesta, puede recopilar más información de tiempo de respuesta de las aplicaciones de Ruby. Con el Agente de sistema operativo Linux, puede supervisar otros aspectos del sistema, como la CPU global, la memoria y el disco.

La oferta determina qué agentes de supervisión están disponibles para la instalación. Si desea una lista de los agentes incluidos en cada oferta, consulte Capacidades.

Para obtener una lista de los agentes que se ejecutan en los sistemas Linux, consulte Instalación de agentes en sistemas Linux.

Antes de empezar

Descargue los agentes. Consulte Descarga de los agentes y recopiladores de datos.

Revise la información de Requisitos del sistema para asegurarse de que cumple los requisitos para los agentes que planea instalar.

Revise las tareas previas a la instalación antes de instalar los agentes. Para obtener detalles, consulte Preinstalación en sistemas Linux.

Nota: Java™ Runtime solo se instala cuando el agente lo necesita y no siempre está disponible. Además, ksh ya no es necesario para la instalación del agente, excepto para la instalación del Agente de resumen y poda, que se instala durante la instalación del Servidor de Cloud APM. Se da soporte a SELinux en modalidad de imposición.

Acerca de esta tarea

Puede instalar los agentes de supervisión como un usuario root o no root. Si no tiene privilegios de usuario root y desea instalar un agente de supervisión, puede instalar el agente como usuario no root, consulte Instalación de agentes como usuarios no root. Además, puede instalar el agente como usuario no root si es administrador del sistema principal y no desea ejecutar el agente de supervisión como usuario root. El flujo de instalación es el mismo que para un usuario root.

Se da soporte a la coexistencia de agentes. Puede instalar agentes de IBM Cloud Application Performance Management en el mismo sistema donde están instalados los agentes de IBM Tivoli Monitoring. Sin embargo, ambos tipos de agente no se pueden instalar en el mismo directorio. Para obtener más información sobre la coexistencia de agentes, consulte Coexistencia del agente de Cloud APM y el agente de Tivoli Monitoring.

Procedimiento

Abra una sesión shell de terminal en el sistema Red Hat Enterprise Linux.
En el sistema, navegue al directorio donde ha descargado el archivo tar

Los agentes deben estar instalados en el sistema donde esté instalada la aplicación que desea supervisar. Si es necesario, transfiera el archivo de archivado de instalación al sistema para que se pueda supervisar. El archivo de archivado contiene el script de instalación y el de agente.

Recuerde: Asegúrese de que el directorio no contiene una versión más antigua del archivo de archivado.
Extraiga los archivos de instalación de mediante los mandatos siguientes, que dependen de la oferta:
```
tar -xf ./archivos_instalación.tar
```
donde archivos_instalación es el nombre del archivo de instalación correspondiente a su oferta.

El script de instalación se extrae en un directorio especificado para el archivo de archivado y la versión. Por ejemplo: oferta_Agent_Install_8.1.4.0. El archivo binario del agente y los archivos relacionados con la configuración se extraen en los subdirectorios dentro de este directorio.
Ejecute el script de instalación desde el directorio que se llama para el archivo de archivado y la versión:
```
./installAPMAgents.sh
```
Para instalar los agentes en modalidad silenciosa, consulte Instalación silenciosa de agentes.
Especifique si desea instalar agentes individuales, una combinación de los agentes o todos los agentes.
En función de si está instalando o actualizando los agentes, realice uno de los pasos siguientes:
- Si está instalando los agentes, especifique el directorio de inicio de instalación del agente o utilice el directorio predeterminado aplicable:
  - /opt/ibm/apm/agent
- Si está actualizando los agentes, después de que se le solicite el directorio de inicio de instalación de los agentes, especifique el directorio de instalación de la versión anterior de los agentes.
  1. Si existe una versión más antigua de los agentes en el directorio /opt/ibm/apm/agent, debe especificar un directorio de instalación nuevo. En el paso siguiente, se le preguntará si desea migrar la configuración del agente desde el directorio /opt/ibm/apm/agent.
  2. Si confirma que desea migrar la configuración de agente del directorio de instalación antiguo (/opt/ibm/ccm/agent) al directorio de instalación nuevo, por ejemplo /opt/ibm/apm/agent, debe iniciar el agente en la ubicación de instalación nueva.
    Restricción: La versión más antigua del agente se detiene automáticamente en la ubicación de instalación antigua, pero no se inicia automáticamente en la ubicación de instalación nueva.
  3. Tras verificar que la instalación se ha completado y que el agente funciona en el nuevo directorio de instalación, debe desinstalar la versión más antigua del agente desde el directorio /opt/ibm/ccm/agent. Si desea eliminar todos los agentes, ejecute el mandato /opt/ibm/ccm/agent/bin/smai-agent.sh uninstall_all.
Cuando se le pregunte si acepta el acuerdo de licencia, entre 1 para aceptar el acuerdo y continuar, o entre 2 para rechazarlo.
Tras entrar 1 (aceptar), se inicia una exploración de requisitos previos del entorno y tarda unos pocos minutos en completarse. Si faltan algunos requisitos, un mensaje le dirigirá a un archivo de registro que contiene la causa del error. La falta de un requisito previo, como por ejemplo la falta de una biblioteca o espacio de disco insuficiente detendrá la instalación. Debe resolver la anomalía y volver a iniciar el script de instalación.
Nota: Si la instalación existe con el mensaje siguiente, compruebe si se ha iniciado el servicio del servidor (Inicio -> Herramientas administrativas -> Servicios). Si no es así, inicie el servicio del servidor y vuelva a ejecutar installAPMAgents.bat.
```
Este script [installAPMAgents.bat] se debe ejecutar como Administrador.
```
Si ha instalado los agentes mediante un ID de usuario no root, debe actualizar los scripts de arranque del sistema (consulte Instalación de agentes como usuarios no root).
Cuando se haya completado la instalación y la línea de mandatos esté disponible, puede repetir los pasos de este procedimiento para instalar más agentes de supervisión en el sistema gestionado.

Qué hacer a continuación

Configure el agente como sea necesario. Si el agente de supervisión requiere configuración como se describe en Despliegue de agentes y recopiladores de datos o si desea revisar los valores predeterminados, consulte Configuración del entorno.

Si utiliza un proxy directo porque el cortafuegos no permite conexiones HTTPS salientes transparentes a hosts externos, debe editar el archivo de configuración de entorno del agente. Para obtener instrucciones, consulte Configuración de agentes para la comunicación mediante un proxy directo.
Si ha actualizado un agente desde una versión anterior, identifique cualquier tarea de reconfiguración o migración que debe completar antes de iniciar sesión en la Consola de Cloud APM. Para obtener información sobre esas tareas, consulte Actualización de los agentes. Después de una actualización, debe reiniciar todos los agentes que el instalador no configura e inicia automáticamente.

Para iniciar un agente, ejecute el mandato siguiente:

./nombre-agent.sh start

Para obtener más información sobre los mandatos de agente de supervisión, incluido el nombre que se va a utilizar, consulte Utilización de mandatos de agente. Si desea información sobre qué agentes se inician de forma automática y manual, consulte Despliegue de agentes y recopiladores de datos.

Después de una actualización, debe reiniciar todos los agentes que el instalador no configura e inicia automáticamente.

Después de configurar e iniciar el agente, vea los datos que el agente está recopilando.

Si no ha iniciado sesión, siga las instrucciones en Inicio de la Consola de Cloud APM.
Si desea ver sistemas gestionados del dominio de IBM Tivoli Monitoring en los Panel de instrumentos del rendimiento de aplicaciones, complete las tareas descritas en Integración con IBM Tivoli Monitoring V6.3.