Preinstalación en sistemas Linux

Debe llevar a cabo las tareas de preinstalación necesarias antes de instalar los agentes en los sistemas Linux. Algunas tareas de preinstalación son específicas del agente y otras tareas se aplican a varios agentes.

Nota: Estos requisitos son adicionales a los requisitos identificados en los Informes de compatibilidad de productos de software.
Para conocer los requisitos de versión actuales y las dependencias del agente, consulte System requirements (APM Developer Center) para obtener un enlace a los informes de compatibilidad de productos de software.

Todos los agentes

Las tarea de preinstalación siguientes son aplicables a todos los agentes:

Probar la conectividad
Antes de instalar los agentes, asegúrese de que el sistema puede comunicarse con el Servidor de Cloud APM. Para obtener información sobre la comprobación de conectividad con el Servidor de Cloud APM, consulte Conectividad de red.
Instalación de usuario no root
Debe tener permisos de lectura, grabación y ejecución sobre el directorio de instalación. De lo contrario se cancela la instalación. Para obtener más información sobre la instalación de usuario no root, consulte Instalación de agentes como usuarios no root.
Limitación de 70 caracteres para la vía de acceso de instalación
El directorio de instalación y la vía de acceso no deben tener más de 70 caracteres.
Establecimiento de la variable de entorno CANDLEHOME
Si previamente utilizó ITM Agent Converter para instalar y configurar un agente en el mismo sistema gestionado, la variable de entorno CANDLEHOME ha cambiado a ese directorio en el que instaló el agente con Agent Converter. Antes de instalar y configurar un agente Cloud APM nativo, debe establecer la variable de entorno CANDLEHOME en un directorio diferente, de lo contrario, el agente Cloud APM no se puede iniciar.

Sistemas operativos específicos

Red Hat Enterprise Linux (RHEL) 8
El paquete libnsl.so.1 es necesario en RHEL 8
De forma predeterminada, libnsl.so.1 no se instala en Red Hat Enterprise Linux release 8.0. Sin este paquete, ningún agente puede instalarse correctamente. Pida a su administrador que configure un repositorio yum y ejecute este mandato: 
yum install libnsl
Cuando la instalación se haya realizado correctamente, podrá ver /usr/lib64/libnsl.so.1.
Nota: El paquete libnsl.so.1 sólo es necesario para los agentes. No es necesario que realice este paso para los recopiladores de datos.
Eludir el escáner de requisitos previos para algunos agentes
Antes de actualizar el escáner de requisitos previos para que sea compatible con los requisitos más recientes, para algunos agentes, puede eludir el escáner de requisitos previos. Para conocer los escenarios adecuados e instrucciones, consulte Eludir la exploración de requisitos previos.
Nota: No es necesario que realice este paso para los recopiladores de datos.

Agentes específicos

Las tareas de preinstalación siguientes son aplicables a los agentes especificados:

Agente de DataPower
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. Este agente no puede instalarse en la misma máquina que el dispositivo DataPower que desea supervisar.
Agente de DataStage
  1. Habilite los parámetros en el archivo DSODBConfig.cfg. Complete los pasos siguientes:
    1. Abra el archivo DSODBConfig.cfg en la ubicación siguiente de un editor:
      • dir_instalación_infosphere_information_server/Server/DSODB
    2. Descomente los parámetros siguientes eliminado el símbolo #:
      • MonitorLinks=1
      • JobRunUsage=1
      • ResourceMonitor=1
      • DSODBON=1
    3. Edite los valores de estos parámetros igual que 1.
  2. Copie el controlador JDBC de la base de datos que se utiliza para la configuración del repositorio de metadatos en el sistema agente.
    1. JDBC 4 tipo 4 o posterior. Ejemplo: db2jcc4.jar
    2. Controlador JDBC tipo 4 para Oracle. Ejemplo: ojdbc6.jar
    3. Controlador JDBC para MS SQL:
      • Sqljdbc41.jar requiere un JRE de 7 y da soporte a la API de JDBC 4.1.
      • Sqljdbc42.jar requiere un JRE de 8 y da soporte a la API de JDBC 4.2.
Agente de HTTP Server
Si instala este agente como un usuario root, debe utilizar el mismo ID de usuario para ejecutar y configurar el agente.
Si instala y ejecuta el agente como un usuario no root, el usuario no root debe tener el mismo ID de usuario que el que ha iniciado el IBM® HTTP Server. De lo contrario, el agente tendrá problemas para descubrir el IBM HTTP Server. Puede utilizar el mismo ID de usuario para ejecutar y configurar el agente.
Agente de Linux KVM
El Monitoring Agent for Linux KVM es un agente multiinstancia y multiconexión, y da soporte a conexiones con el hipervisor KVM basado en Enterprise Linux y los entornos Red Hat Enterprise Virtualization Manager (RHEV-M). Puede crear varias instancias de este agente para supervisar varios hipervisores en un entorno de hipervisor de RHEV-M o KVM. Puede supervisar cargas de trabajo virtualizadas y analizar la capacidad de recursos entre varias máquinas virtuales. Para conectar el agente a una máquina virtual en el entorno de hipervisor KVM, debe instalar los requisitos previos: libvirt*.rpm y Korn Shell Interpreter (pdksh). El agente recopila medidas conectando remotamente a un hipervisor libvirt que gestiona las máquinas virtuales.
Agente de Microsoft SQL Server
Para supervisar un entorno de Microsoft SQL, el controlador ODBC de Microsoft SQL Server y Microsoft SQL debe estar instalado antes de instalar Monitoring Agent for Microsoft SQL Server. Por ejemplo, para instalar el controlador ODBC en Red Hat Enterprise Linux, utilice el siguiente mandato: 
sudo yum install unixODBC
sudo yum install msodbcsql17
Para completar la ejecución del comprobador de requisitos previos, el agente debe configurarse en el arreglo temporal 15 del servidor de Cloud Application Performance Management Versión 8.1.4.0 (8.1.4.0-IBM-APM-SERVER-IF0015.tar) o posterior.
Agente de MongoDB
Debe instalar y configurar el Agente de MongoDB en el sistema donde está instalado el servidor de bases de datos MongoDB.
Agente de MySQL
Para supervisar un entorno MySQL, el servidor MySQL y el controlador JDBC MySQL debe estar instalado antes de instalar el Monitoring Agent for MySQL. Por ejemplo, para instalar el controlador JDBC en Red Hat Enterprise Linux, utilice el mandato siguiente:
yum install mysql-connector-java
Después de iniciar la instalación del agente y durante la comprobación de requisitos previos del nombre de paquete MySQL, recibirá un aviso si se utiliza un proveedor que no sea Red Hat, como por ejemplo Oracle. Si el servidor MySQL y el controlador JDBC están disponibles, el aviso no hace que la instalación falle y puede pasar por alto el mensaje. Salida de ejemplo: 
Escenario: Exploración de requisitos previos
KSE - Comprobador de requisitos previos de Monitoring Agent for MySQL [versión 01000005]:
Propiedad                     Result Encontrado  Esperado 
========                      ====== =====       ======== 
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 de Node.js
la versión de Node.js que utilice para ejecutar la aplicación supervisada debe ser la misma que la versión instalada de forma predeterminada.
Actualmente Node.js v5 no está soportado.
Agente de OpenStack
Para poder utilizar Agente de OpenStack, debe tener el software siguiente en el servidor en el que instala el agente:
  • Python 2.6.0 o posterior, o Python 2.7.0 o posterior
  • Clientes OpenStack más recientes:
    • OpenStack
    • Keystone
    • Neutron
    • Swift

    Para instalar los clientes de línea de mandatos de OpenStack, consulte Instalar los clientes de línea de mandatos de OpenStack.

  • Biblioteca Paramiko para acceso remoto en Python.
    Nota: Si desea instalar Agente de OpenStack en un servidor RedHat Linux nuevo, antes de instalar la biblioteca Paramiko, ejecute el mandato siguiente para instalar el software necesario:
    wget https://ftp.dlitz.net/pub/dlitz/crypto/pycrypto/pycrypto-2.6.1.tar.gz
yum install gcc/openssl-devel/libffi-devel
  • KornShell
Agente de Oracle Database
En Red Hat Enterprise Linux versión 5 y versión 6 y SUSE Linux Enterprise Server versión 11 y versión 12 x64, si el Agente de Oracle Database supervisa la base de datos Oracle de forma remota, debe instalar primero los clientes instantáneos de Oracle. Instale los clientes instantáneos de Oracle desde Oracle Technology Network - Instant Client Downloads.
el cliente instantáneo v10.x, v11.x y v12.x están soportados en el Agente de Oracle Database.
Agente de PHP
Si la aplicación PHP se despliega mediante el usuario root, debe utilizar el usuario root para instalar, configurar, iniciar o detener el agente. Si la aplicación PHP se despliega mediante un usuario no root, puede utilizar el usuario root o el mismo usuario no root para instalar, configurar, iniciar o detener el agente.
Debe tener instalada una aplicación WordPress existente. El Agente de PHP supervisa WordPress V3.7.1 o posterior.
El agente solo evalúa el rendimiento de las peticiones PHP en aplicaciones WordPress. No se evalúan las cargas de CSS y JS.
El agente no utiliza argumentos de URL para identificar los URL.
Recopilador de datos de Python
El Recopilador de datos de Python supervisa aplicaciones Django.
Agente de Supervisión de tiempo de respuesta

Antes de instalar el Agente de Supervisión de tiempo de respuesta, revise la sección de planificación de la instalación aquí: Planificación de la instalación.

Agente de SAP HANA Database
  1. Instale el cliente HDBSQL del cliente de base de datos SAP HANA versión 1.00.102.06 o posterior en el sistema Linux.
    Importante: Para el sistema operativo RHEL 5.x de 64 bits, instale Linux SUSE 9 en el cliente de base de datos SAP HANA x86_64 64bit en lugar de Linux en x86_64 64bit. Para los sistemas operativos RHEL 6.x, o posterior de 64 bits, instale Linux en el cliente de base de datos SAP HANA x86_64 64bit.
  2. Ejecute el mandato siguiente para añadir la vía de acceso del directorio de instalación a la variable de entorno LD_LIBRARY_PATH:

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:vía_acceso_directorio_instalación

    Ejemplo: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/sap/hdbclient, donde /usr/sap/hdbclient es la vía de instalación del cliente de base de datos SAP HANA.

Importante:

Si la vía de instalación del cliente de base de datos SAP HANA no se añade a la variable de entorno LD_LIBRARY_PATH, el explorador de requisitos previos devuelve el resultado FAIL.

La variable de entorno que ha añadido mediante el mandato de exportación, sólo se conserva para la sesión concreta del terminal. Por lo tanto, asegúrese de que ejecuta el script de instalación del agente en el mismo terminal que ha utilizado para añadir la variable de entorno.

Agente de Synthetic Playback
Para instalar el Agente de Synthetic Playback, el usuario de sistema operativo requiere los siguientes permisos:
  • Habilite el permiso de lectura y ejecución para la imagen de instalación
  • Habilite el permiso de escritura para el inicio del agente
Para ejecutar el Agente de Synthetic Playback, el usuario de sistema operativo requiere los siguientes permisos:
  • Habilite el permiso de lectura, escritura y ejecución para la ubicación de instalación del agente y sus subdirectorios y archivos.
  • Habilite el permiso para ejecutar Mozilla Firefox.
  • Asegúrese de que el binario de ejecución de Mozilla Firefox está en la variable de entorno PATH del perfil del usuario.
Antes de instalar el Agente de Synthetic Playback, debe completar los pasos siguientes:
  1. Sincronice ubicaciones de instalación del agente con Consola de Cloud APM.
  2. Instale Mozilla Firefox y el servidor de visualización Xvfb.
  3. Verifique que el servidor de visualización Xvfb está en funcionamiento. Ejecute el mandato:
    # Xvfb -ac

    No debe haber ninguna salida de error.

  4. Compruebe que el proceso Xvfb se está ejecutando. Ejecute el mandato siguiente: 
    # ps -ef|grep Xvfb

    Salida de ejemplo:

    root 7192 1 0 Jan14 ? 00:00:14 Xvfb -ac
root 20393 17900 0 02:05 pts/0 00:00:00 grep -i xvfb
  5. Detenga el proceso Xvfb. Ejecute el mandato siguiente:
    # kill -9 7192
  6. Vaya a dir_instalación/etc/hosts y edite el principio del archivo hosts para incluir los parámetros siguientes: 
    127.0.0.1 localhost

    A continuación, guarde y cierre el archivo hosts.

Agente de WebSphere Applications
Antes de que se instale el agente, el comprobador de requisitos comprueba que ulimit está establecido en 524000 en el sistema Linux. Debe ejecutar el mandato ulimit -d 524000 para asegurarse de que la variable de entorno del sistema max data segment size está establecida en 524000.