Installation de l'agent hôte sous Mac OS

Un kit de développement Java ( Java, JDK) doit être disponible pour l'agent. Vous pouvez voir la liste des JDK pris en charge comme suit. Deux options sont possibles :

1. Le plus simple est de placer ou de lier ce kit JDK à <instana-agent-install-dir>/jvm (de sorte que <instana-agent-install-dir>/jvm/bin/java existe).

2. La méthode personnalisable consiste à exporter une variable d'environnement appelée JAVA_HOME pour pointer vers ce JDK (cette variable d'environnement peut également être définie via instana-agent-install-dir>/bin/setenv).

Pour l'instant, les machines virtuelles Java suivantes sont prises en charge pour l'exécution de l'agent :

• IBM OpenJ9 JDK 11 (recommandé sur x64 )
• Azul Zulu JDK 11 (préféré sur Apple silicon)
• OpenJDK 11
• AdoptOpenJDK
• Oracle Point fort du JDK 11
• JDK 11 d'Amazon Corretto
• IBM J9 11

Il est important que tout utilisateur du système puisse exécuter la machine virtuelle Java. Il est recommandé d'utiliser la dernière version corrective disponible de la distribution Java de votre choix. L'agent nécessite un JDK prenant en charge l' TLSv1.3. (Disponible dans toutes les versions actuelles du JDK 11.) Notez que, en fonction de la distribution de votre système d'exploitation, les modules fournis par le distributeur de système d'exploitation peuvent ne pas contenir de support de chiffrement fort en raison du contrôle des exportations. Si vous utilisez un tel paquet, vous risquez de rencontrer des erreurs telles que : « java.lang.RuntimeException:. Impossible de générer une paire de clés DH. »

Pour installer et exécuter l'agent hôte, procédez comme suit:

1. Sur la page d'accueil de l'interface utilisateur d' Instana, cliquez sur « Agents et collecteurs ». Dans l'onglet « Agents » de l' Instana, sélectionnez « Installer les agents ».

   Remarque : si vous lancez une nouvelle instance d'essai d' Instana, le catalogue d'agents s'affiche et vous invite à sélectionner un agent hôte à installer.

2. Cliquez sur la vignette macOS - macOS (64bit -Intel & Apple silicon)

3. Sélectionnez l'option de conditionnement pour installer un agent dynamique ou statique.

4. Cliquez sur le lien de téléchargement pour télécharger le fichier archive de l'agent.

   Remarque : le fichier d'archive de l'agent est préconfiguré avec votre clé d'agent et le point de terminaison de l'agent hôte; il vous suffit donc de l'extraire, puis de lancer l'agent.

5. Procédez à l'extraction de l'archive d'agent.

   Vous devez utiliser un fichier GNU-tar pour extraire l'archive, car celle-ci contient des chemins de plus de 100 caractères. Si vous n'utilisez pas GNU-tar, l'agent ne pourra pas démarrer et renverra une erreur de type SEVERE : Impossible de lancer le framework.

1. Ouvrez Terminalet accédez au répertoire dans lequel vous avez extrait l'agent. Il s'agit généralement de ~/Downloads/instana-agent.

   cd ~/Downloads/instana-agent
    

2. Assurez-vous que la variable d'environnement JAVA_HOME est définie conformément à la section Prerequisites . Exécutez ensuite la commande suivante pour démarrer l'agent en arrière-plan:

   bin/start
    

3. Vérifiez si l'agent est opérationnel en exécutant la commande suivante dans le terminal:

   bin/status
    

4. Lors du premier démarrage de l'agent Instana sur des machines fonctionnant sous Apple silicon, un message d'avertissement provenant d' macOS peut s'afficher concernant une bibliothèque non signée nommée libsigar-universal64-macosx.dylib, qui est nécessaire au fonctionnement de l'agent.

   

   Pour autoriser l'utilisation de cette bibliothèque spécifique à l'architecture, vous devez l'approuver à partir de Préférences système -> Sécurité et confidentialité -> Général.

   

   Ensuite, redémarrez l'agent en exécutant la commande suivante dans le terminal et approuvez à nouveau la bibliothèque dans la fenêtre en incrustation à venir:

   bin/stop & bin/start
    

Une fois l'agent hôte installé, vous pouvez vérifier son état dans l'interface utilisateur d' Instana ou directement sur l'hôte. Pour plus d'informations, voir Vérification du statut de l'agent hôte.

• Instana offre une compatibilité optimale avec MacOS à des fins de développement et de test. Vous devez exécuter l'agent Instana sous un compte utilisateur standard, et non sous le root compte. De plus, la commande « Instana » ne surveillera que les processus exécutés par le même utilisateur. L'exécution de l'agent dans un conteneur Docker n'est pas prise en charge. Enfin, il n'est pas possible de surveiller les conteneurs Docker en raison de différences importantes au niveau du fonctionnement interne entre Docker Machine, Docker pour Mac et les versions standard Linux et Docker.

• Sur les machines basées sur Apple silicon, la bibliothèque spécifique à l'architecture n'est pas encore signée. Suivez l'étape 4 dans les instructions d'exécution de cette rubrique pour approuver la bibliothèque libsigar-universal64-macosx.dylib . Pour plus d'informations, consultez la documentation officielled'Apple.

Si l'installation de l'agent échoue au début, vous pouvez consulter les messages de journal et les conseils d'identification et de résolution des problèmes. Si cette section consacrée au dépannage ne répond pas à vos questions, veuillez contacter l'équipe d'assistance de IBM Instana en lui fournissant des détails sur votre expérience, afin que nous puissions vous aider et mettre à jour notre documentation en conséquence.

Pour obtenir des informations générales sur le traitement des incidents liés à tous les agents hôte, voir Gestion des agents hôte / Traitement des incidents.