Installation de l'agent hôte sous Windows

Modifier en ligne

Vous pouvez installer l'agent d' Instana ation sur un hôte Windows en utilisant différentes méthodes, en fonction de vos besoins. Voir la liste suivante pour connaître toutes les options d'installation disponibles :

Remarque : Remarque : Une fois l'agent installé, les entrées de registre suivantes sont ajoutées à votre ordinateur Windows : HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\PerfProc\Performance:"ProcessNameFormat"=2 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\.NETFramework\Performance:"ProcessNameFormat"=2 Ces entrées de registre sont nécessaires pour que InstanaPCP puisse corréler correctement toutes les métriques provenant des compteurs de performances.

Installation interactive de l'agent hôte à l'aide d'un programme d'installation d' Windows

Modifier en ligne

Pour installer l'agent hôte de manière interactive à l'aide du programme d'installation d' Windows, 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 ».

  2. Sur la page du catalogue de déploiement des agents, cliquez sur la vignette « Windows - Windows Installer 64 bits ». La page « Windows - Windows Installer 64 bits » s'ouvre.

    Remarque : si vous souhaitez lancer la procédure d'installation en mode silencieux, sans aucune intervention de votre part, sélectionnez l'option « Windows - Windows Installer 64 bit (unattended) », puis suivez les étapes décrites dans la section « Installation silencieuse de l'agent hôte ».

  3. Sélectionnez l'option de conditionnement pour un agent hôte dynamique ou statique, et l'option d'exécution pour le JDK de votre choix.

  4. Cliquez sur le lien de téléchargement pour enregistrer le fichier d'installation d' Windows.

  5. Lancez le programme d'installation d' Windows pour ouvrir l'assistant de configuration d' Instana Agent sur l'ordinateur hôte Windows. Suivez l'assistant pour installer l'agent.

  6. À l'étape « Configuration de l'agent d' Instana » de l'assistant, copiez-collez les informations suivantes à partir de la page « Windows - Windows Installer 64 bits » de l'interface utilisateur Instana.

    • Adresse du back-end Instana
    • Port back-end Instana
    • Clé d'agent Instana
    • Télécharger la clé

Outre l'installation de l'agent, l'assistant installe également les composants préalables (.NET Framework, 4.5 et JVM ), enregistre l'agent en tant que service, configure le service pour qu'il démarre automatiquement et le lance à la fin de l'installation.

Après avoir installé l'agent, vous pouvez le gérer et le configurer selon vos besoins. Pour plus d'informations, consultez la section « Administration de l'agent » sur Windows.

Installation silencieuse de l'agent hôte

Modifier en ligne

Pour installer l'agent hôte sans intervention de l'utilisateur, vous pouvez exécuter le programme d'installation d' Windows. en mode silencieux en suivant les étapes suivantes :

  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 ».

  2. Sur la page du catalogue de déploiement des agents, cliquez sur la vignette « Programme d' Windows, version 64 bits (sans intervention) ».

  3. Téléchargez le programme d'installation d' Windows en cliquant sur le lien fourni.

  4. Copiez l'extrait de la commande d'installation comme indiqué dans l'exemple suivant :

    Remarque : une fois l'agent « Instana » installé, celui-ci se lance automatiquement au démarrage du système. Pour désactiver le démarrage automatique, ajoutez INSTANA_SERVICE_MODE=manual à la commande d'installation.
    @ECHO OFF

<installer_file_name> INSTANA_AGENT_ENDPOINT=<your_host> INSTANA_AGENT_ENDPOINT_PORT=<your_port> INSTANA_AGENT_KEY=<your_agent_key> INSTANA_DOWNLOAD_KEY=<your_agent_key> /quiet

    Remplacez " <installer_file_name> par le nom du fichier d'installation que vous avez téléchargé à l'étape 3.

    Remarque : vous devez indiquer l'option permettant /quiet d'empêcher l'affichage de l'interface graphique, afin de pouvoir exécuter le processus d'installation en mode silencieux, sans aucune intervention de l'utilisateur. Tous les autres paramètres requis sont pré-remplis dans le code de déploiement de l'agent.

  5. Exécutez la commande d'installation sur l'ordinateur hôte Windows sur lequel vous souhaitez installer l'agent hôte. Le processus d'installation s'exécute en arrière-plan et se charge d'installer l'agent ainsi que les prérequis (.NET Framework, 4.5 et JVM ).

    Le programme d'installation enregistre également l'agent en tant que service, configure le service pour qu'il démarre automatiquement et démarre le service après l'installation.

Après avoir installé l'agent, vous pouvez le gérer et le configurer selon vos besoins. Pour plus d'informations, consultez la section « Administration de l'agent » sur Windows.

Installation de l'agent hôte à l'aide d'un fichier .zip

Modifier en ligne

Vous pouvez installer l'agent hôte manuellement en téléchargeant et en extrayant un fichier " .zip de l'agent hôte.

Remarque : le fichier.zip contient les fichiers de l'agent, mais ne contient pas le fichier « JVM » nécessaire au fonctionnement de l'agent hôte. Assurez-vous d'installer une version prise en charge d' JVM sur l'ordinateur hôte Windows sur lequel vous souhaitez installer l'agent hôte.

Pour installer l'agent hôte à l'aide d'un fichier " .zip, procédez comme suit :

  1. Téléchargez l'archive de l'agent sur votre système local :

    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 ».

    2. Sur la page du catalogue de déploiement des agents, cliquez sur la vignette « Windows - Zip Archives ».

    3. Sélectionnez le mode de conditionnement de l'agent, dynamique ou statique. Pour plus d'informations sur les agents d'hébergement dynamiques et statiques, voir les types d'agents d'hébergement.

    4. Cliquez sur le lien de téléchargement correspondant à la version 32 bits ou 64 bits d' Windows pour enregistrer le .zip fichier.

      Le .zip fichier est téléchargé sur votre ordinateur hôte Windows.

  2. Extraire le fichier " .zip téléchargé dans un dossier (par exemple, " <instana-agent-install-dir>).

  3. Démarrez l'agent en exécutant la commande suivante :

    <instana-agent-install-dir>\bin\start.bat

    L'agent hôte est préconfiguré avec les paramètres de votre compte.

Après avoir installé l'agent, vous pouvez le gérer et le configurer selon vos besoins. Pour plus d'informations, consultez la section « Administration de l'agent » sur Windows.

Installation de l'agent hôte sur un environnement d' Windows s isolé physiquement

Modifier en ligne

Pour installer l'agent hôte sur un environnement d' Windows s isolé physiquement, 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 ».

  2. Sur la page « Installations d'agents Instana », cliquez sur la vignette « Windows – Isolé physiquement (Archive, Programme d'installation) ».

  3. Sur la page « Windows - Air-gapped (Installateur, Archive - 32bit, 64bit ) », cliquez sur l'icône « Télécharger l'installateur ou la copie d'archive » pour copier le fichier URL. Ensuite, collez l' URL e copiée dans une nouvelle fenêtre de navigateur pour ouvrir la page de téléchargement, où vous trouverez à la fois le programme d'installation et les fichiers d'archive (.zip). Téléchargez le programme d'installation ou le fichier d'archive (.zip) selon votre préférence.

  4. Si vous avez téléchargé le programme d'installation, consultez les instructions d'installation de la section « Installation de l'agent hôte à l'aide du programme d'installation interactif d' Windows » pour installer l'agent sur votre environnement Windows isolé.

  5. Si vous avez téléchargé le fichier d'archive (.zip), consultez les instructions d'installation de la section « Installation de l'agent hôte à l'aide d'un fichier.zip » pour installer l'agent sur votre environnement d' Windows isolé.

Facultatif : installation de l'agent hôte en tant que service Windows

Modifier en ligne

Si vous souhaitez installer l'agent hôte en tant que service « Windows », il est recommandé d'utiliser le wrapper de service « Windows ». Pour plus d'informations sur le « service wrapper », consultez la page WinSW.

Pour installer l'agent hôte en tant que service d' Windows, procédez comme suit :

  1. Téléchargez le fichier d'habillage du service, 'WinSW-<version>.exe, à partir de la page de publication deWinSW, et enregistrez-le dans le dossier dans lequel vous avez extrait l'archive.

  2. Renommez le fichier de l'enveloppe de service en " instana-agent.exe.

  3. Dans le même répertoire, créez un fichier de configuration 'instana-agent.xml et copiez-y la configuration suivante. Windows appelle le wrapper de service en utilisant ce fichier de configuration pour démarrer l'agent hôte.

    <service>
 <id>instana-agent</id>
 <name>Instana Agent</name>
 <description>Instana Agent</description>
 <!-- start -->
 <executable>"<instana-agent-install-dir>\bin\karaf.bat"</executable>
 <startargument>daemon</startargument>
 <!-- stop -->
 <stopexecutable>"<instana-agent-install-dir>\bin\karaf.bat"</stopexecutable>
 <stopargument>stop</stopargument>
 <stoptimeout>10sec</stoptimeout>
 <!-- logging -->
 <logpath><instana-agent-install-dir>\data\log</logpath>
 <log mode="roll-by-time">
   <pattern>yyyyMMdd</pattern>
 </log>
</service>

  4. Installez l'agent hôte en tant que service Windows en exécutant la commande suivante dans le répertoire où vous avez enregistré les fichiers instana-agent.xml instana-agent.exe et.

    instana-agent.exe install

    Lancez ensuite le service de l'agent hôte Windows en exécutant la commande suivante :

    net start instana-agent-service

Après avoir installé l'agent, vous pouvez le gérer et le configurer selon vos besoins. Pour plus d'informations, consultez la section « Administration de l'agent » sur Windows.