IBM Performance Management (SaaS)

Instalación de agentes

Para instalar un agente de supervisión en un sistema Linux o AIX, debe descargar un archivo de archivado de la imagen de instalación del agente desde el sitio de descarga de IBM® Service Engage, extraiga los archivos de instalación del agente y, después, inicie el script de instalación.

El nivel de suscripción al servicio determina qué agentes de supervisión están disponibles para la instalación. Para obtener una lista de los agentes incluidos en cada nivel de suscripción de servicio, consulte Visión general del producto.

Para obtener una lista de los agentes que se ejecutan en un sistema Linux o AIX, consulte Tareas de requisito previo.

Antes de empezar

Puede instalar cualquier combinación de agentes de supervisión en un sistema gestionado. Por ejemplo, si instala el Agente de supervisión para Ruby para supervisar las aplicaciones Ruby On Rails, es posible que desee también instalar el Agente de supervisión de Tiempo de respuesta para recopilar información de tiempo de respuesta adicional para las aplicaciones Ruby y el Agente de supervisión para el sistema operativo Linux para supervisar otros aspectos del sistema como, por ejemplo, la CPU global, la memoria y el disco.

Acerca de esta tarea

Algunos de los agentes se configuran e inician automáticamente. Otros agentes deben estar configurados antes de informar de los datos:

Los siguientes agentes se configuran e inician automáticamente:
- Agente para el sistema operativo Linux
- Agente de sistema operativo UNIX
- Agente de HTTP Server
- agente Tiempo de respuesta
Para el Agente de HTTP Server, debe revisar el archivo de configuración que el agente crea para el servidor HTTP. A continuación, debe añadir la configuración del recopilador de datos manualmente en el archivo de configuración del servidor.

Java™ Runtime solo está instalado cuando el agente lo necesita y no siempre está disponible. Además, ksh ya no es necesario para realizar la instalación del agente y se da soporte a SELinux en modalidad de imposición.
Los siguientes agentes son agentes de varias instancias. Deberá crear la primera instancia e iniciar el agente manualmente. Un agente de varias instancias significa que una instalación única del agente crea una instancia de supervisión única para cada instancia de aplicación única. Estas instancias se visualizan en la Performance Management console como resultado.
- Agente DataPower
- agente de DB2
- Agente de HMC Base
- Agente de IBM Integration Bus
- Agente JBoss
- Agente de Linux KVM
- Agente de MongoDB
- Agente de MySQL
- agente de base de datos Oracle
- Agente PHP
- Agente de PostgreSQL
- Agente Python
- Agente de Tomcat
- agente de SAP
- Agente de Ruby
- Agente de VMware VI
- Agente de WebSphere Infrastructure Manager
- Agente de WebSphere MQ
Agente DataPower: Antes de que se instale el agente, el comprobador de requisitos comprueba que ulimit está establecido en unlimited en AIX. Debe ejecutar el mandato ulimit -d unlimited para asegurarse de que la variable de entorno del sistema max data segment size está establecida en unlimited.
Agente de HMC Base: si instala el agente es un usuario root, debe asegurarse de que el sistema TL07 esté instalado. Si instala el agente como un usuario no root, debe asegurarse de que el sistema TL08 esté instalado solo para AIX6.
El Agente de Linux KVM es un agente de varias conexiones. Permite la conexión tanto a entornos de hipervisor KVM basados en Enterprise Linux como a entornos de Red Hat Enterprise Virtualization Manager (RHEVM).
Agente de Node.js: El agente debe estar configurado antes de que se informe de los datos. Debe añadir un plug-in de supervisión a la aplicación Node.js.
Agente de Ruby: Para diagnósticos en profundidad, el agente debe estar configurado antes de que se informe de los datos. Para habilitar los paneles de instrumentos de diagnóstico, debe instalar y configurar el recopilador de datos de diagnóstico.
Agente de aplicaciones WebSphere : El agente se inicia automáticamente pero debe estar configurado antes de que se informe de los datos.

Puede instalar agentes de supervisión como usuario root o usuario no root.

Siga estos pasos para instalar los agentes de supervisión en VM y sistemas donde se ha instalado Red Hat Enterprise Linux o SUSE Linux Enterprise Server.
Siga estos pasos para instalar los agentes de supervisión en las LPAR y sistemas donde se ha instaladoAIX.

Procedimiento

Para descargar el archivo de archivado de la instalación, inicie una sesión en My Services desde el sitio web de IBM Service Engage.
Pulse Descargas para mostrar los paquetes disponibles para descarga. Pulse Descargar agente bajo el paquete de Linux o AIX para su suscripción de servicio. Guarde el archivo en el directorio intermedio de su elección.

Los agentes deben estar instalados en el sistema donde esté instalada la aplicación. 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.
Abra una sesión de shell de terminal en el sistema Red Hat Enterprise Linux o AIX.
Vaya al directorio en el que se encuentra el archivo de archivado.
Extraiga los archivos de instalación de utilizando los mandatos siguientes en función de su suscripción o producto:
- Para IBM Application Performance Management on Cloud:
```
tar -xf ./IAPMaaS_Agents_8.1.1.tar
```
- Para IBM Monitoring on Cloud:
```
tar -xf ./APMaaS_Agents_8.1.1.tar
```
- Para IBM Application Diagnostics on Cloud:
```
tar -xf ./APDaaS_Agents_8.1.1.tar
```
- IBM Application Performance Management Advanced on Cloud:
  Los mandatos siguientes extraen agentes para la suscripción Application Performance Management y la suscripción Application Diagnostics, que le proporciona todos los agentes de la suscripción de Application Performance Management Advanced:
```
tar -xf ./IAPMaaS_Agents_8.1.1.tar
```
```
tar -xf ./APDaaS_Agents_8.1.1.tar
```
- Para IBM Application Performance Management on Cloud:
```
tar -xf ./IAPMaaS_AIX_Agents_8.1.1.tar
```
- Para IBM Monitoring on Cloud:
```
tar -xf ./APMaaS_AIX_Agents_8.1.1.tar
```
- Para IBM Application Diagnostics on Cloud:
```
tar -xf ./APDaaS_AIX_Agents_8.1.1.tar
```
- IBM Application Performance Management Advanced on Cloud:
  Los mandatos siguientes extraen agentes para la suscripción Application Performance Management y la suscripción Application Diagnostics, que le proporciona todos los agentes de la suscripción de Application Performance Management Advanced:
```
tar -xf ./IAPMaaS_AIX_Agents_8.1.1.tar
```
```
tar -xf ./APDaaS_AIX_Agents_8.1.1.tar
```
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.1. 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:
```
./installAPMaaSAgents.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 va a instalar los agentes, especifique el directorio de inicio de instalación del agente.
  - Utilice el /opt/ibm/apm/agent predeterminado o especifique un directorio diferente.
  - Utilice el /opt/ibm/ccm/agent predeterminado o especifique un directorio diferente.
- Si está actualizando los agentes, una vez 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 /opt/ibm/ccm/agent, debe especificar un directorio de instalación nuevo. En el paso siguiente se le pregunta si desea migrar la configuración del agente desde /opt/ibm/ccm/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.
Tras preguntarle 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 tiene que configurar el agente de supervisión o si desea revisar los valores predeterminados, consulte Configuración de los agentes.
Si ha actualizado un agente desde una versión anterior, revise este tema para cualquier tarea de reconfiguración o migración que debe completar antes de iniciar una sesión en Performance Management console: Actualización de los agentes de supervisión.

Si desea confirmar que el agente se ha iniciado, especifique uno de los siguientes mandatos:

Mandato	Descripción
`./nombre-agent.sh start`	Inicie el agente de supervisión de la ubicación de instalación nueva.
`./nombre-agent.sh status`	Verifique que el agente de supervisión reporta datos a la consola.

Después de una actualización, debe reiniciar cualquier agente que el instalador no configura e inicia automáticamente (consulte Acerca de esta tarea).

Si instaló con un ID de usuario no root, realice lo indicado en el paso siguientes antes de iniciar agentes.

Si instaló los agentes mediante un ID de usuario no root, debe completar los pasos siguientes como usuario root para finalizar la configuración:
1. Ejecute el script siguiente:
```
dir_instalación/bin/SetPerm -a
```
  Donde dir_instalación es el directorio de instalación de los agentes.
2. Ejecute el script siguiente:
```
dir_instalación/bin/UpdateAutoRun.sh
```
3. Reinicie el agente de OS y cualesquiera otros agentes iniciados como usuario no root. (Paso 10)
Cuando se haya completado la instalación y la línea de mandatos esté disponible, puede repetir los pasos 5 y 9 para instalar más agentes de supervisión en el sistema gestionado.

Qué hacer a continuación

Puede proteger la instalación del agente ejecutando el script dir_instalación/bin/secure.sh. Si desea obtener más información al respecto, consulte el apartado Asegurar los archivos de instalación de agente.
Si utiliza un proxy directo, debe editar el archivo de configuración del entorno del agente. Encontrará instrucciones en: Configuración de agentes para la comunicación mediante un proxy directo.
Si desea ver sistemas gestionados del dominio de IBM Tivoli Monitoring en los Paneles de instrumentos de Application Performance, complete las tareas descritas en Integración con Tivoli Monitoring.
Si no ha iniciado sesión, siga las instrucciones en Inicio de la Performance Management console.
Para obtener más información sobre los mandatos de agente de supervisión, incluyendo el nombre por utilizar, consulte Utilización de mandatos de agente.