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 AIX y Solaris, consulte Instalación de agentes en sistemas UNIX.

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 los sistemas AIX, consulte el Preinstalación en sistemas AIX.
Para los sistemas Solaris, consulte Preinstalación en sistemas Solaris.

Importante: 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 y 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 en el shell de terminal en el sistema AIX o Solaris.
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 utilizando el mandato siguiente:
```
tar -xf ./archivos de instalación
```
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.
Opcional: Este paso SÓLO es necesario para Solaris 10. Debe crear un enlace dinámico a ksh antes de ejecutar el script de instalación en Solaris 10.
1. Realice una copia de seguridad del mandato /bin/sh:
```
mv /bin/sh /bin/sh.bkup_origin
```
2. Cree un enlace dinámico al mandato ksh:
```
ln -s /bin/ksh /bin/sh
```
3. Confirme que el resultado apunta a ksh:
```
ls -l /bin/sh
```
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.
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. Un requisito previo como 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.
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 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.