Instalación de agentes

Puede instalar cualquier combinación de agentes de supervisión en un sistema gestionado. Por ejemplo, si instala el Monitoring Agent for MySQL para supervisar los servidores MySQL, quizá prefiera instalar también el Agente de Supervisión de tiempo de respuesta para recopilar información de tiempo de respuesta adicional para sus aplicaciones de Ruby. Quizá prefiera instalar también el Monitoring Agent for Windows OS para 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 un sistema Windows, consulte Preinstalación en sistemas Windows.

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 de requisito previo de agentes antes de instalar los agentes. Para obtener detalles, consulte Preinstalación en sistemas Windows.

Acerca de esta tarea

Asegúrese de que tiene el permiso adecuado para ejecutar el script de instalación de agente y los mandatos de agente. Debe haber iniciado la sesión utilizando uno de los siguientes tipos de cuenta de usuario:

cuenta de usuario administrador de Windows predeterminado
cuenta de usuario administrador
cuenta de usuario que sea miembro del grupo de administradores
cuenta de usuario que esté registrada como administrador en los servicios de Active Directory

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

Siga estos pasos para instalar los agentes de supervisión en máquinas virtuales y sistemas en los que esté instalado el sistema operativo Windows:

En el sistema, vaya al directorio donde ha descargado el archivo comprimido.
Extraiga los archivos de instalación del agente para la oferta (u ofertas) en la ubicación donde desea instalar el software del agente de supervisión.
El script de instalación .bat 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.
Abra un indicador de mandatos como administrador.
1. En el menú Inicio, escriba comando en el cuadro de búsqueda.
2. Pulse el botón derecho (del ratón) en el Símbolo del sistema en la lista que se muestra y seleccione Ejecutar como administrador.
En el indicador de mandatos, ejecute el script de instalación con privilegios de administrador desde el directorio especificado para el archivo de archivado y versión:
```
cd oferta_Agent_Install_versión
installAPMAgents.bat
```
Restricción: Para el Agente de WebSphere Applications, los privilegios de administrador debe ser los mismos privilegios que se han utilizado para instalar WebSphere Application Server.
Para instalar los agentes en modalidad silenciosa, consulte Instalación silenciosa de agentes.
Si está instalando los agentes, proporcione el nombre del directorio de instalación.
La vía de acceso de instalación predeterminada es C:\IBM\APM. El nombre del directorio de instalación no puede superar los 80 caracteres ni contener caracteres no ASCII, caracteres especiales o de doble byte. Los nombres de directorio de la vía de acceso solo pueden contener los caracteres siguientes: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ _\:0123456789()~-./.
Nota: Si la creación de nombres de archivo cortos (8dot3Name) está inhabilitada, si los nombres de directorio de la vía de acceso contienen espacios, la instalación no está soportada.

Si está actualizando el agente, este paso no es necesario y el agente se instala en el directorio de instalación anterior.
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.
```
Una vez completada la instalación y disponible el indicador de mandatos, repita estos pasos para instalar más agentes de supervisión.

Qué hacer a continuación

Configure los agentes según sea necesario. Para comprobar si el agente de supervisión requiere configuración manual, consulte Despliegue de agentes y recopiladores de datos. Para obtener instrucciones de configuración, o si desea revisar los valores de configuración predeterminados, consulte Configuración del entorno.

Antes de instalar nuevos agentes, Windows Installer detiene temporalmente todos los agentes actualmente en ejecución en la ubicación del producto instalado. Una vez finalizada la instalación, el instalador reinicia todos los agentes detenidos. Debe reiniciar manualmente los agentes de supervisión que no se hayan configurado automáticamente mediante el instalador.

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.

Utilice uno de los métodos siguientes para iniciar el agente:

Pulse Inicio > Todos los programas > Agentes de IBM Monitoring > IBM Cloud Application Performance Management. Pulse el botón derecho del ratón en un agente y pulse Iniciar.
Ejecute el mandato siguiente
```
nombre-agent.bat 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.