Préinstallation sur les systèmes Linux

Vous devez effectuer les tâches de préinstallation requises avant d'installer les agents sur les systèmes Linux. Certaines tâches de préinstallation sont spécifiques à un agent et d'autres tâches s'appliquent à plusieurs agents.

Remarque : Ces exigences viennent s'ajouter à celles identifiées dans les rapports sur la compatibilité du produit logiciel.
Pour obtenir la configuration requise pour la version actuelle et les dépendances pour votre agent, voir System requirements (APM Developer Center) qui fournit un lien vers les rapports sur la compatibilité du produit logiciel.

Tous les agents

Les tâches de préinstallation suivantes s'appliquent à tous les agents :

Tester la connectivité
Avant d'installer les agents, vérifiez que votre système puisse communiquer avec le serveur Cloud APM. Pour plus d'informations sur la vérification de la connectivité au serveur Cloud APM, voir Communication sécurisée.
Installation en tant qu'utilisateur non superutilisateur
Vous devez disposer des droits d'écriture, de lecture et d'exécution sur le répertoire d'installation. Autrement, l'installation est annulée. Pour plus d'informations sur l'installation en tant qu'utilisateur non superutilisateur, voir Installation des agents en tant qu'utilisateur non superutilisateur.
Limitation à 70 caractères pour le chemin d'installation
Le répertoire d'installation et son chemin d'accès ne doivent pas comporter plus de 70 caractères.
Définition de la variable d'environnement CANDLEHOME
Si vous avez utilisé ITM Agent Converter pour installer et configurer un agent sur le même système géré qu'auparavant, la variable d'environnement CANDLEHOME s'est vue affecter ce répertoire lorsque vous avez installé l'agent avec Agent Converter. Avant d'installer et de configurer un agent Cloud APM natif, vous devez affecter à la variable d'environnement CANDLEHOME un autre répertoire, faute de quoi l'agent Cloud APM natif ne peut pas démarrer.

Systèmes d'exploitation spécifiques

Red Hat Enterprise Linux (RHEL) 8
Le package libnsl.so.1 est nécessaire sur RHEL 8
Par défaut, libnsl.so.1 n'est pas installé sur Red Hat Enterprise Linux édition 8.0. Sans ce package, aucun agent ne peut être installé. Demandez à votre administrateur de configurer un référentiel YUM pour vous, puis exécutez cette commande : 
yum install libnsl
Une fois l'installation terminée, vous pouvez voir /usr/lib64/libnsl.so.1.
Remarque : Le package libnsl.so.1 est nécessaire uniquement pour les agents. Cette étape n'est pas nécessaire pour les collecteurs de données.
Contournement du scanner de prérequis pour certains agents
Vous pouvez ignorer le scanner de prérequis avant sa mise à jour en vue de sa compatibilité avec les dernières exigences. Pour en savoir plus sur les scénarios et les instructions appropriés, voir Contournement de l'analyse des prérequis.
Remarque : Cette étape n'est pas nécessaire pour les collecteurs de données.

Agents spécifiques

Les tâches de préinstallation suivantes s'appliquent aux agents spécifiés :

agent DataPower
Vous devez exécuter la commande ulimit -d unlimited pour vous assurer que la variable d'environnement système max data segment size est définie sur unlimited. Cet agent ne peut pas être installé sur la même machine que le dispositif DataPower à surveiller.
agent DataStage
  1. Activez les paramètres dans le fichier DSODBConfig.cfg. Effectuez les opérations suivantes :
    1. Ouvrez le fichier DSODBConfig.cfg dans un éditeur à la ligne suivante :
      • infosphere_information_server_install_dir/Server/DSODB
    2. Supprimez la mise en commentaire des paramètres suivants en supprimant le symbole # :
      • MonitorLinks=1
      • JobRunUsage=1
      • ResourceMonitor=1
      • DSODBON=1
    3. Editez les valeurs des paramètres définis sur 1.
  2. Copiez le pilote JDBC de la base de données utilisée pour la configuration du référentiel de métadonnées sur l'ordinateur agent.
    1. Entrez 4 pour le pilote JDBC 4 ou ultérieur. Exemple : db2jcc4.jar
    2. Entrez 4 pour le pilote JDBC pour Oracle. Exemple : ojdbc6.jar
    3. Pilote JDBC pour MS SQL :
      • Sqljdbc41.jar nécessite l'environnement d'exécution Java 7 et prend en charge l'API JDBC 4.1.
      • Sqljdbc42.jar nécessite l'environnement d'exécution Java 8 et prend en charge l'API JDBC 4.2.
agent HTTP Server
Si vous installez cet agent en tant que superutilisateur, vous devez utiliser le même ID utilisateur pour exécuter et configurer l'agent.
Si vous installez et exécutez l'agent en tant qu'utilisateur non root, ce dernier doit avoir le même ID utilisateur que l'utilisateur qui a démarré IBM® HTTP Server. Sinon, l'agent a des difficultés à reconnaître IBM HTTP Server. Vous pouvez utiliser le même ID utilisateur pour exécuter et configurer l'agent.
agent Linux KVM
Monitoring Agent for Linux KVM est un agent multi-instance et multiconnexion qui prend en charge des connexions d'hyperviseur KVM basé sur Enterprise Linux et des environnements RHEV-M (Red Hat Enterprise Virtualization Manager). Vous pouvez créer plusieurs instances de cet agent pour surveiller plusieurs hyperviseurs dans un environnement d'hyperviseur RHEV-M ou KVM. Vous pouvez surveiller les charges de travail virtualisées et analyser la capacité de ressources sur des machines virtuelles différentes. Pour connecter l'agent à une machine virtuelle dans l'environnement de l'hyperviseur KVM, vous devez installer les conditions préalables requises : libvirt*.rpm et interpréteur de commandes Korn (pdksh). L'agent collecte des indicateurs en se connectant à distance à un hyperviseur libvirt qui gère les machines virtuelles.
agent Microsoft SQL Server
Pour surveiller un environnement Microsoft SQL, les pilotes Microsoft SQL Server et Microsoft SQL ODBC doivent être installés préalablement à l'installation de Monitoring Agent for Microsoft SQL Server. Par exemple, pour installer le pilote ODBC sur Red Hat Enterprise Linux, utilisez la commande suivante :
sudo yum install unixODBC
sudo yum install msodbcsql17
Pour exécuter le programme de vérification, l'agent doit être configuré sur Cloud Application Performance Management version 8.1.4.0 Server correctif provisoire 15 (8.1.4.0-IBM-APM-SERVER-IF0015.tar) ou version ultérieure.
Agent MongoDB
Vous devez installer et configurer l'Agent MongoDB sur le système sur lequel le serveur de base de données MongoDB est installé.
Agent MySQL
Pour surveiller un environnement MySQL, le serveur MySQL et le pilote MySQL JDBC doivent être installés avant d'installer Monitoring Agent for MySQL. Par exemple, pour installer le pilote JDBC sur Red Hat Enterprise Linux, utilisez la commande suivante :
yum install mysql-connector-java
Une fois que vous avez démarré l'installation de l'agent et au cours du contrôle des prérequis du nom de package MySQL, un avertissement peut être affiché si un fournisseur autre que Red Hat, tel qu'Oracle, est utilisé. Si MySQL Server et le pilote JDBC sont disponibles, cet avertissement n'entraîne pas l'échec de l'installation et vous pouvez ignorer le message. Exemple de sortie : 
Scenario: Prerequisite Scan
KSE - Monitoring Agent for MySQL Prerequisite Checker [version 01000005]:
Property                               Result   Found                                     Expected 
========                      ====== =====       ======== 
os.package.mysql-server         WARN  Unavailable  mysql-server-5.1.12+
os.package.mysql-connector-java WARN Unavailable mysql-connector-java-5.
1.12+
Agent Node.js
La version de Node.js que vous utilisez pour exécuter l'application surveillée doit être identique à la version installée par défaut.
Node.js v5 n'est actuellement pas pris en charge.
Agent OpenStack
Avant de pouvoir utiliser l'Agent OpenStack vous devez avoir les logiciels suivants sur le serveur où vous installez l'agent :
  • Python 2.6.0, Python 2.7.0 ou une version ultérieure
  • Clients OpenStack les plus récents :
    • OpenStack
    • Keystone
    • Neutron
    • Swift

    Pour installer les clients de ligne de commande OpenStack, voir Install the OpenStack command-line clients.

  • Bibliothèque Paramiko pour l'accès à distance dans Python.
    Remarque : Si vous souhaitez installer l'Agent OpenStack sur un serveur RedHat Linux nettoyé, avant d'installer la bibliothèque Paramiko, exécutez la commande suivante pour installer le logiciel requis :
    wget https://ftp.dlitz.net/pub/dlitz/crypto/pycrypto/pycrypto-2.6.1.tar.gz
yum install gcc/openssl-devel/libffi-devel
  • Interpréteur de commandes Korn
Agent Oracle Database
Sous Red Hat Enterprise Linux version 5 et version 6 et SUSE Linux Enterprise Server version 11 et version 12 x64, si l'Agent Oracle Database surveille la base de données Oracle à distance, vous devez commencer par installer les clients Oracle Instant. Installez les clients Oracle Instant à partir de la page Téléchargements Oracle Technology Network - Instant Client.
Les clients Instant v10.x ,v11.x et v12.x sont pris en charge par l'Agent Oracle Database.
Agent PHP
Si l'application PHP est déployée à l'aide du superutilisateur, vous devez utiliser ce dernier pour installer, configurer, démarrer ou arrêter l'agent. Si l'application PHP est déployée à l'aide d'un utilisateur non superutilisateur, vous pouvez utiliser le superutilisateur ou le même utilisateur non superutilisateur pour installer, configurer, démarrer ou arrêter l'agent.
Une application WordPress existante doit être installée. L'Agent PHP surveille WordPress version 3.7.1 ou ultérieure.
L'agent évalue uniquement les performances des requêtes PHP dans les applications WordPress. Le chargement CSS et JS n'est pas évalué.
L'agent n'utilise pas les arguments d'URL pour identifier les URL.
collecteur de données Python
Le collecteur de données Python surveille les applications Django.
Agent de surveillance des temps de réponse

Avant d'installer l'Agent de surveillance des temps de réponse, passez en revue la section relative à la planification de l'installation ici : Planification de l'installation.

Agent SAP HANA Database
  1. Installez le client de base de données SAP HANA HDBSQL version 1.00.102.06 ou ultérieure sur le système Linux.
    Important : Pour le système d'exploitation 64 bits RHEL 5.x, installez Linux SUSE 9 sur le client de base de données SAP HANA x86_64 64 bits au lieu de Linux sur x86_64 64 bits. Pour RHEL 6.x ou les systèmes d'exploitation 64 bits ultérieurs, installez Linux sur le client de base de données SAP HANA x86_64 64 bits.
  2. Exécutez la commande suivante pour ajouter le chemin du répertoire d'installation à la variable d'environnement LD_LIBRARY_PATH :

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:chemin_répertoire_install

    Exemple : export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/sap/hdbclient, où /usr/sap/hdbclient indique le chemin d'installation du client de base de données SAP HANA.

Important :

Si le chemin d'installation du client de base de données SAP HANA n'est pas ajouté à la variable d'environnement LD_LIBRARY_PATH, le scanner de prérequis renvoie le résultat FAIL.

La variable d'environnement que vous avez ajoutée à l'aide de la commande export est conservée uniquement pour une session donnée du terminal. Par conséquent, assurez-vous d'avoir exécuté le script d'installation de l'agent depuis le même terminal que celui utilisé pour ajouter la variable d'environnement.

Agent Synthetic Playback
Pour installer l'Agent Synthetic Playback, l'utilisateur du système d'exploitation doit disposer des droits suivants :
  • Activez le droit d'accès en lecture et exécution à l'image d'installation.
  • Activez le droit d'accès en écriture à l'agent principal.
Pour exécuter l'Agent Synthetic Playback, l'utilisateur du système d'exploitation doit disposer des droits suivants :
  • Activez le droit d'accès en lecture, écriture et exécution à l'emplacement d'installation de l'agent et à ses sous-répertoires et fichiers.
  • Activez le droit d'exécution de Mozilla Firefox.
  • Assurez-vous que les fichiers binaires d'exécution de Mozilla Firefox se trouvent dans la variable d'environnement PATH du profil de l'utilisateur.
Avant d'installer l'Agent Synthetic Playback, procédez comme suit :
  1. Synchronisez les emplacements d'installation de l'agent avec la console Cloud APM.
  2. Installez Mozilla Firefox et le serveur d'affichage Xvfb.
  3. Vérifiez que le serveur d'affichage Xvfb fonctionne. Exécutez la commande suivante :
    # Xvfb -ac

    Aucune erreur ne devrait apparaître dans la sortie.

  4. Vérifiez que le processus Xvfb est en cours. Exécutez la commande suivante : 
    # ps -ef|grep Xvfb

    Exemple de sortie :

    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. Arrêtez le processus Xvfb. Exécutez la commande suivante :
    # kill -9 7192
  6. Accédez à rép_install/etc/hosts et éditez le début du fichier hosts de sorte à inclure les paramètres suivants : 
    127.0.0.1 localhost

    Ensuite, sauvegardez et fermez le fichier hosts.

Agent WebSphere Applications
Avant l'installation de l'agent, le programme de vérification des prérequis vérifie que le paramètre ulimit est défini sur 524000 sur le système Linux. Vous devez exécuter la commande ulimit -d 524000 pour vous assurer que la variable d'environnement système max data segment size est définie sur 524000.