IBM Performance Management (SaaS)

Installation d'agents

Pour installer un agent de surveillance sur un système Linux ou AIX, vous devez télécharger le fichier archive des images d'installation d'agent à partir du site Web d'IBM® Service Engage, extraire les fichiers d'installation de l'agent, puis démarrer le script d'installation.

Les agents de surveillance que vous pouvez installer dépendent de votre niveau d'abonnement au service. Pour obtenir la liste des agents compris dans chaque niveau d'abonnement au service, voir Présentation du produit.

Pour obtenir la liste des agents qui s'exécutent sur un système Linux ou AIX, voir Tâches prérequises.

Avant de commencer

Vous pouvez installer toute combinaison des agents de surveillance sur un système géré. Par exemple, si vous installez l'agent de surveillance pour Ruby pour surveiller les applications Ruby On Rails, vous pouvez installer l'agent de surveillance des temps de réponse pour rassembler des informations de temps de réponse supplémentaires pour vos applications Ruby, et l'agent de surveillance pour le système d'exploitation Linux pour surveiller les autres aspects du système, comme l'UC globale, la mémoire et le disque.

Pourquoi et quand exécuter cette tâche

Des agents sont configurés et démarrés automatiquement. D'autres agents doivent être configurés avant le signalement des données :
  • Les agents suivants sont configurés et démarrés automatiquement :
    • agent de système d'exploitation Linux
    • agent de système d'exploitation UNIX
    • agent HTTP Server
    • Agent Response Time

    Pour l'agent HTTP Server, vous devez vérifier le fichier de configuration créé par l'agent pour HTTP Server. Vous devez ensuite ajouter manuellement la configuration du collecteur de données au fichier de configuration du serveur.

    Java™ Runtime est installé uniquement lorsque l'agent le requiert et il n'est pas toujours disponible. En outre, ksh n'a plus besoin d'effectuer l'installation des agents et SELinux en mode d'application est pris en charge.

  • Les agents suivants sont des agents d'instance multiples. Vous devez créer la première instance et démarrer l'agent manuellement. Un agent multi-instance signifie qu'une installation unique de l'agent instancie une instance de surveillance unique pour chaque instance d'application. Vous pouvez afficher ces instances depuis Performance Management console.
    • agent DataPower
    • agent DB2
    • agent HMC Baset
    • agent IBM Integration Bus
    • agent JBoss
    • agent Linux KVM
    • agent MongoDB
    • agent MySQL
    • agent Oracle Database
    • agent PHP
    • agent PostgreSQL
    • agent Python
    • agent Tomcat
    • Agent SAP
    • agent Ruby
    • agent VMware VI
    • agent WebSphere Infrastructure Manager
    • agent WebSphere MQ
  • agent DataPower : Avant l'installation de l'agent, le programme de vérification des prérequis vérifie que le paramètre ulimit correspond à unlimited sous AIX. 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.
  • agent HMC Baset : Si vous installez l'agent en tant que superutilisateur, vous devez vous assurer que le système TL07 est installé. Si vous installez l'agent en tant qu'utilisateur non superutilisateur, vous devez vous assurer que le système TL08 n'est installé que pour AIX6.
  • L'agent Linux KVM est également un agent à connexions multiples. Il prend en charge la connexion aux environnements d'hyperviseur KVM basé sur Enterprise Linux et Red Hat Enterprise Virtualization Manager (RHEVM).
  • agent Node.js : l'agent doit être configuré avant le signalement des données. Vous devez ajouter un plug-in de surveillance à votre application Node.js.
  • agent Ruby : pour des diagnostics approfondis, l'agent doit être configuré avant le signalement des données. Pour activer les tableaux de bord de diagnostics, vous devez installer et configurer le collecteur des données de diagnostic.
  • agent WebSphere Applications : l'agent est démarré automatiquement mais il doit être configuré avant le signalement des données.
Vous pouvez installer des agents de surveillance en tant qu'utilisateur root ou non root.

Procédure

  1. Pour télécharger le fichier archive d'installation, connectez-vous à Mes Services à partir du site Web IBM Service Engage.

    Cliquez sur Téléchargements pour afficher les modules disponibles pour téléchargement. Cliquez sur Download Agent sous le package Linux ou AIX pour votre abonnement de service. Enregistrez le fichier dans le répertoire de transfert de votre choix.

    Les agents doivent être installés sur le système sur lequel l'application est installée. Si nécessaire, transférez le fichier archive d'installation sur le système à surveiller. Le fichier archive contient les agents et le script d'installation.

    A faire : Vérifiez que le répertoire ne contient pas une ancienne version du fichier d'archive.
  2. Ouvrez une session shell de terminal sur le système Red Hat Enterprise Linux ou AIX.
  3. Accédez au répertoire dans lequel se trouve le fichier archive.
  4. Extrayez les fichiers d'installation de l' en utilisant les commandes suivantes en fonction de votre abonnement ou du produit :
    Linux
    • Pour IBM Application Performance Management on Cloud :
      tar -xf ./IAPMaaS_Agents_8.1.1.tar
    • Pour IBM Monitoring on Cloud : 
      tar -xf ./APMaaS_Agents_8.1.1.tar
    • Pour IBM Application Diagnostics on Cloud :
      tar -xf ./APDaaS_Agents_8.1.1.tar
    • IBM Application Performance Management Advanced on Cloud:
      Les commandes suivantes extraient des agents de l'abonnement Application Performance Management et de l'abonnement Application Diagnostics, ce qui permet de disposer de tous les agents dans l'abonnement Application Performance Management Advanced :
      tar -xf ./IAPMaaS_Agents_8.1.1.tar
      tar -xf ./APDaaS_Agents_8.1.1.tar
    AIX
    • Pour IBM Application Performance Management on Cloud :
      tar -xf ./IAPMaaS_AIX_Agents_8.1.1.tar
    • Pour IBM Monitoring on Cloud : 
      tar -xf ./APMaaS_AIX_Agents_8.1.1.tar
    • Pour IBM Application Diagnostics on Cloud :
      tar -xf ./APDaaS_AIX_Agents_8.1.1.tar
    • IBM Application Performance Management Advanced on Cloud:

      Les commandes suivantes extraient des agents de l'abonnement Application Performance Management et de l'abonnement Application Diagnostics, ce qui permet de disposer de tous les agents dans l'abonnement Application Performance Management Advanced :

      tar -xf ./IAPMaaS_AIX_Agents_8.1.1.tar
      tar -xf ./APDaaS_AIX_Agents_8.1.1.tar

    Le script d'installation est extrait dans un répertoire nommé en fonction du fichier archive et de la version. Par exemple : offre_Agent_Install_8.1.1. Les fichiers binaires de l'agent et les fichiers liés à la configuration sont extraits dans des sous-répertoires de ce répertoire.

  5. Exécutez le script d'installation à partir du répertoire nommé en fonction du fichier archive et de la version : 
    ./installAPMaaSAgents.sh
    Pour installer les agents en mode silencieux, voir Installation silencieuse des agents.
  6. Indiquez si vous souhaitez installer des agents individuels, une combinaison d'agents ou tous les agents.
  7. Selon que vous installez ou mettez à niveau les agents, effectuez l'une des étapes suivantes :
    • Si vous installez les agents, entrez le répertoire de base de l'installation de l'agent.
      • LinuxUtilisez le répertoire /opt/ibm/apm/agent par défaut ou spécifiez un autre répertoire.
      • AIXUtilisez le répertoire /opt/ibm/ccm/agent par défaut ou spécifiez un autre répertoire.
    • Si vous mettez à niveau les agents, entrez le répertoire d'installation de la version précédente des agents à l'invite du répertoire de base d'installation des agents.
      Linux
      1. S'il existe une ancienne version des agents dans /opt/ibm/ccm/agent, vous devez spécifier un nouveau répertoire d'installation. A l'étape suivante, le système vous demande si vous souhaitez migrer la configuration d'agent à partir de /opt/ibm/ccm/agent.
      2. Si vous confirmez vouloir migrer la configuration d'agent de l'ancien répertoire d'installation /opt/ibm/ccm/agent vers le nouveau répertoire d'installation (par exemple, /opt/ibm/apm/agent), vous devez démarrer l'agent dans le nouvel emplacement d'installation.
        Restriction : L'ancienne version de l'agent est arrêtée automatiquement dans l'ancien emplacement d'installation, mais elle n'est pas démarrée automatiquement dans le nouvel emplacement d'installation.
      3. Une fois que l'installation est terminée et que vous avez vérifié que l'agent fonctionne dans le nouveau répertoire d'installation, vous devez désinstaller l'ancienne version de l'agent du répertoire /opt/ibm/ccm/agent. Si vous souhaitez supprimer tous les agents, exécutez la commande /opt/ibm/ccm/agent/bin/smai-agent.sh uninstall_all.
  8. Après avoir été invité à accepter le contrat de licence, entrez 1 pour accepter le contrat et continuez, ou entrez 2 pour refuser. Après avoir saisi 1 (accepter), l'analyse des prérequis de votre environnement commence et prend un certain moment. Si des exigences ne sont pas satisfaites, un message vous dirige vers un fichier journal contenant la raison de l'échec. Si un prérequis est manquant (par exemple, bibliothèque manquante ou espace disque insuffisant), l'installation s'arrête. Vous devez corriger l'incident, et relancer le script d'installation.
  9. Si votre agent de surveillance requiert une configuration ou que vous souhaitez consulter les paramètres par défaut, voir Configuration des agents.

    Si vous avez mis à niveau un agent d'une version précédente, reportez-vous à cette rubrique pour connaître les tâches de reconfiguration ou de migration à effectuer avant de vous connecter à Performance Management console : Mise à niveau des agents de surveillance.

  10. Si vous voulez vérifier que l'agent est démarré, entrez les commandes suivantes :
    Commande Description
    ./nom-agent.sh start

    Démarrez l'agent de surveillance à partir du nouvel emplacement d'installation.
    ./nom-agent.sh status

    Vérifiez que l'agent de surveillance communique les données à la console.

    Après une mise à niveau, redémarrez l'agent qui n'est pas automatiquement configuré et démarré par le programme d'installation (voir A propose de cette tâche).

    Si vous avez effectué l'installation avec un ID utilisateur non root, effectuez l'étape ci-après avant de démarrer les agents.

  11. Si vous avez installé les agents à l'aide d'un ID utilisateur non root, vous devez effectuer les étapes suivantes en tant qu'utilisateur root pour terminer la configuration :
    1. Exécutez le script suivant : 
      rép_install /bin/SetPerm -a
      Où rép_install correspond au répertoire d'installation des agents.
    2. Exécutez le script suivant : 
      rép_install /bin/UpdateAutoRun.sh
    3. Redémarrez l'agent du système d'exploitation et les autres agents qui étaient démarrés en tant qu'utilisateur non root. (Etape 10)
  12. Une fois l'installation terminée et la ligne de commande disponible, vous pouvez répéter les étapes 5 et 9 pour installer d'autres agents de surveillance sur le système géré.

Que faire ensuite