Vous pouvez installer
toute combinaison des agents de surveillance sur un système géré.
Par exemple, si vous installez l'Agent Ruby pour surveiller les applications Ruby On Rails, vous souhaiterez peut-être également installer l'Agent de surveillance des temps de réponse et/ou l'Linux OS. Grâce à l'Agent de surveillance des temps de réponse, vous pouvez regrouper davantage d'informations sur les temps de réponse pour vos applications Ruby. Grâce à l'Linux OS, vous pouvez surveiller d'autres aspects du système, tels que l'unité centrale, la mémoire et le disque.
L'offre détermine les agents de surveillance pouvant être installés. Pour obtenir la liste des agents compris dans chaque offre, voir Fonctions.
Pour obtenir la liste des agents qui s'exécutent sur les systèmes Linux, voir Installation des agents sur les systèmes Linux.
Avant de commencer
Téléchargez les agents. Voir Téléchargement de vos agents et de vos collecteurs de données.
Lisez les informations de la section Configuration requise afin de vous assurer que vous répondez aux exigences liées aux agents que vous prévoyez d'installer.
Passez en revue les tâches de pré-installation des agents avant d'installer ces derniers. Pour plus d'informations, voir Préinstallation sur les systèmes Linux.
Remarque : Java™ Runtime est installé uniquement lorsque l'agent le requiert et il n'est pas toujours disponible.
En outre, ksh n'est plus nécessaire dans le cadre de l'installation des agents, sauf
en ce qui concerne l'Agent Summarization and Pruning, qui est
installé lors de l'installation du serveur Cloud
APM. SELinux en mode d'application n'est pas pris en charge.
Pourquoi et quand exécuter cette tâche
Vous pouvez installer des agents de surveillance en tant que superutilisateur ou utilisateur non superutilisateur. Si vous ne disposez pas des privilèges de superutilisateur et que vous souhaitez installer un agent de surveillance, vous pouvez installer l'agent en tant qu'utilisateur non superutilisateur (voir Installation des agents en tant qu'utilisateur non superutilisateur). En outre, vous ne pouvez pas installer l'agent comme utilisateur non superutilisateur si vous êtes administrateur d'hôte et que vous ne souhaitez pas exécuter l'agent de surveillance comme superutilisateur. Le
flux d'installation est le même que pour un superutilisateur.
La coexistence des agents est prise en charge. Vous pouvez installer les agents IBM Cloud Application Performance Management sur le même ordinateur que les agents IBM
Tivoli Monitoring. Cependant, les deux types d'agent ne peuvent pas être installés dans le même répertoire. Pour plus d'informations sur la coexistence des agents, voir Coexistence de l'agent Cloud APM et de l'agent Tivoli Monitoring.
Procédure
-
Ouvrez une session shell de terminal sur le système Red Hat Enterprise Linux.
-
Sur votre système, accédez au répertoire dans lequel vous avez téléchargé le fichier .tar
Les agents doivent être installés sur le système sur lequel l'application que vous voulez surveiller 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.
-
Extrayez les fichiers d'installation de l' en utilisant les commandes suivantes, qui dépendent de votre offre :
tar -xf ./fichiers d'installation.tar
où fichiers d'installation est le nom du fichier d'installation
correspondant à votre offre.
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.4.0. Les fichiers binaires de l'agent et les fichiers liés à la configuration sont extraits dans des sous-répertoires de ce répertoire.
-
Exécutez le script d'installation à partir du répertoire nommé en fonction du fichier archive et de la version :
-
Indiquez si vous souhaitez installer des agents individuels, une combinaison
d'agents ou tous les agents.
-
Selon que vous installez ou mettez à niveau les agents, effectuez
l'une des étapes suivantes :
- Si vous installez les agents, spécifiez un autre répertoire de base d'installation d'agent ou utilisez le répertoire par défaut applicable :
- 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.
- S'il existe une ancienne version des agents dans le répertoire /opt/ibm/apm/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 du répertoire /opt/ibm/apm/agent.
- 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.
- 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.
-
Lorsque vous êtes invité à accepter le contrat de licence, entrez 1 pour l'accepter et continuer ou 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.
Remarque : Si l'installation s'arrête avec le message ci-après, vérifiez si le service du serveur est démarré (Démarrer -> Outils d'administration -> Services). S'il ne l'est pas, démarrez-le, puis exécutez à nouveau
installAPMAgents.bat.
This script [installAPMAgents.bat] must be run as Administrator.
-
Si vous avez installé les agents à l'aide d'un ID utilisateur non superutilisateur, vous devez mettre à jour les scripts de démarrage du système (voir Installation des agents en tant qu'utilisateur non superutilisateur).
-
Une fois l'installation terminée et la ligne de commande disponible, vous pouvez répéter les étapes de cette procédure pour installer plus d'agents de surveillance sur le système géré.
Que faire ensuite
Configurez l'agent en fonction de vos besoins. Si votre agent de surveillance requiert des opérations de configuration comme indiqué dans
Déploiement d'agents et de collecteurs de données ou si vous voulez consulter les paramètres par défaut, voir
Configuration de votre environnement.
- Si vous utilisez un proxy direct étant donné que votre pare-feu n'autorise pas les connexions HTTPS sortantes transparentes aux hôtes externes, vous devez éditer le fichier de configuration d'environnement de l'agent. Pour obtenir des instructions, voir Configuration des agents pour qu'ils communiquent via un proxy direct.
- Si vous avez mis à niveau un agent d'une version précédente, identifiez les éventuelles tâches de reconfiguration ou de migration à effectuer avant de vous connecter à la console Cloud APM. Pour plus d'informations sur ces tâches, voir Mise à niveau de vos agents. Après une mise à niveau, vous devez redémarrer tous les agents qui ne sont pas automatiquement configurés et démarrés par le programme d'installation.
Après une mise à niveau, vous devez redémarrer tous les agents qui ne sont pas automatiquement configurés et démarrés par le programme d'installation.
Après avoir configuré et démarré l'agent, affichez les données que l'agent collecte.