Déploiement de plusieurs agents Connector Windows sur une seule machine

À partir de la version 1.2.0 de l'agent Windows, la prise en charge de plusieurs agents sur un même hôte Windows est désormais possible. Microsoft .NET >= 3.5 est requis sur le serveur pour utiliser la version >= 1.2.0 de l'agent Windows.

L'exécution de plusieurs agents sur le même hôte Windows n'est pas prise en charge pour les points de terminaison Cloud d' Satellite, car le point d'entrée du point de terminaison Cloud correspond à l'hôte Windows sur lequel l'agent est exécuté. Les points d'extrémité en nuage et l'exécution de plusieurs agents Windows sur un seul hôte sont des fonctions qui s'excluent mutuellement. Si vous devez utiliser des points de terminaison Cloud avec des agents Windows, il est recommandé d'installer un agent par hôte Windows.

Considérations

  • Le nom de service d'un agent Windows a été mis à jour dans la version 1.2.0 de satelliteconnectorservice.exe à SatelliteConnectorService. En raison de ce changement, vous devez utiliser les scripts de désinstallation fournis avec l'agent que vous souhaitez supprimer.

  • Dans la version 1.2.0, pour faire la distinction entre les multiples agents Windows installés sur un seul hôte Windows, un nouveau paramètre a été introduit dans le fichier de configuration de l'agent, nommé SATELLITE_CONNECTOR_INSTANCE_NAME. Ce paramètre est ajouté au nom du service et séparé par un -. Pour installer plusieurs agents Windows, vous devez désormais spécifier un fichier de configuration lorsque vous appelez les scripts d'installation ou de désinstallation.

  • L'agent Windows s'exécute en tant que processus de nœud sur l'hôte Windows. Dans la console IBM Cloud ainsi que dans l'interface de ligne de commande (CLI) IBM Cloud, l'ID du processus du nœud est ajouté au nom du connecteur et séparé par un point ..

  • Dans les versions antérieures à 1.2.0 de l'agent Windows, vous n'étiez pas autorisé à spécifier un fichier de configuration pour les scripts d'installation ou de désinstallation. Au lieu de cela, les scripts prenaient automatiquement le fichier config.json du même répertoire et l'utilisaient pour installer ou désinstaller un seul agent Windows.

  • Un seul agent Windows nécessite au moins 4 vCPU et 4 Go sont recommandés. Bien que cette configuration puisse prendre en charge plusieurs agents, les performances chutent de manière significative après le quatrième agent. Il est donc recommandé de disposer d'au moins 8 vCPU et 8 Go pour l'exécution de plusieurs agents.

  • L'utilisation de plusieurs agents appartenant au même connecteur n'offre aucun avantage. La meilleure pratique consiste à avoir un agent par connecteur.

  • L'installation de plusieurs agents Windows nécessite de conserver 25MB de mémoire pour chaque agent.

  • L'exécution du trafic sur les agents représente environ 70 Mo de mémoire et environ 15 % d'utilisation du processeur par agent, avec une bande passante atteignant 150 à 200 Mbps par agent. Ces chiffres sont issus de tests de performances internes réalisés par l' IBM sur l'agent Windows du connecteur Satellite.

Installation de plusieurs agents Windows

Pour déployer plusieurs agents sur un même hôte, vous devez utiliser le paramètre configFile.

  1. Depuis l'interface de ligne de commande (CLI), exécutez la commande suivante pour télécharger le fichier de l'agent ( .zip archive ZIP).

    ibmcloud sat agent attach --platform windows

    Exemple de sortie.

    Downloading agent setup tools for windows...
OK
Satellite connector agent for windows was successfully returned /var/folders/17/y8wr4y_x1tb4yf__g3wr6g8m0000gp/T/windows_satellite_connector_4097559421.zip

  2. Vérifiez le site sha512sum de .zip en exécutant la commande suivante sur PowerShell.

    Get-FileHash -Algorithm SHA512 -Path c:\windows_satellite_connector_1420916628.zip

  3. Exécutez la commande suivante dans PowerShell pour extraire le contenu du fichier .zip.

    Expand-Archive -Path 'C:\path\to\windows_satellite_connector_4097559421.zip' -DestinationPath ‘C:\path\to\extract'

  4. Suivez les étapes de la section suivante pour mettre à jour les fichiers de configuration que vous avez extraits.

  5. Modifiez le fichier multi_instance_config.json pour y inclure les détails de votre connecteur.

    {
  "SATELLITE_CONNECTOR_ID": "<connector_id>",
  "SATELLITE_CONNECTOR_IAM_APIKEY": "<api_key>",
  "SATELLITE_CONNECTOR_TAGS": "<tags>",
  "SATELLITE_CONNECTOR_INSTANCE_NAME": "<instance_name>",
  "LOG_LEVEL": "<log_level>",
  "PRETTY_LOG": <true|false>
}

  6. Remplissez le fichier de configuration avec les détails et les informations d'identification de votre connecteur. Ne nommez pas le fichier config.json. Le SATELLITE_CONNECTOR_INSTANCE_NAME est obligatoire et doit commencer par un caractère. Il ne peut contenir que les caractères (a-zA-Z), les chiffres (0-9) et _, et sa longueur totale doit être inférieure à 50 caractères.

  7. Exécutez le script d'installation à l'adresse PowerShell.

    ./install.ps1 -configFile multi_instance_config.json

  8. Visualiser les agents en cours d'exécution sur un serveur Windows. Exécutez la commande suivante à l'adresse PowerShell.

    Get-Service -Name SatelliteConnectorService* | Format-Table -AutoSize

    Status  Name                                  DisplayName
------  ----                                  -----------
Running SatelliteConnectorService             SatelliteConnectorService
Running SatelliteConnectorService-connector_1 SatelliteConnectorService-connector_1
Running SatelliteConnectorService-connector_2 SatelliteConnectorService-connector_2

  9. Visualiser les processus de nœuds s'exécutant sur un serveur Windows. Exécutez la commande suivante à l'adresse PowerShell.

    get-process | Where-Object {$_ -match 'node'}

    NPM(K) PM(M) WS(M) CPU(s)   Id SI ProcessName
------ ----- ----- ------   -- -- -----------
    24 61.05 40.44   0.89 1796  0 node
    39 10.43 24.29   0.11 3436  0 node
    39 10.74 29.70   0.17 4288  0 node
    24 61.60 39.86   0.70 5720  0 node
    24 61.44 40.64   0.81 5924  0 node
    39 10.63 29.81   0.17 7932  0 node

  10. Obtenez les détails de connector_1.

    ibmcloud sat connector get --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzkwMjFpNnNlcnJxdTJlZyI

    OK
ID:                    U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzkwMjFpNnNlcnJxdTJlZyI
Name:                  connector_1
CRN:                   crn:v1:staging:public:satellite:us-south:a/1ae4eb57181a46ceade48465196706a7:U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzkwMjFpNnNlcnJxdTJlZyI::
Managed From:          Dallas (us-south)
Resource Group ID:     60735c4daed84fcea7d3fe99c298c9b3
Resource Group Name:   Default
State:                 created
Created Date:          2025-04-11 03:43:16 -0500 (48 minutes ago)

  11. Visualiser l'agent appartenant au connecteur connector_1.

    ibmcloud sat agent ls --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzkwMjFpNnNlcnJxdTJlZyI

    OK
Name                               Release                                               Tags
sat-link-e2e-wi/connector_1.1796   20250410-5f291315c59db895783cf54411765942806802ac_W   connector_1

  12. Obtenez les détails de connector_2.

    ibmcloud sat connector get --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzlzMjF0OWFsMjQ2YXZjMCI

    OK
ID:                    U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzlzMjF0OWFsMjQ2YXZjMCI
Name:                  connector_2
CRN:                   crn:v1:staging:public:satellite:us-south:a/1ae4eb57181a46ceade48465196706a7:U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzlzMjF0OWFsMjQ2YXZjMCI::
Managed From:          Dallas (us-south)
Resource Group ID:     60735c4daed84fcea7d3fe99c298c9b3
Resource Group Name:   Default
State:                 created
Created Date:          2025-04-11 03:43:19 -0500 (50 minutes ago)

  13. Visualiser l'agent appartenant au connecteur connector_2.

    ibmcloud sat agent ls --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkYzlzMjF0OWFsMjQ2YXZjMCI

    OK
Name                               Release                                               Tags
sat-link-e2e-wi/connector_2.5924   20250410-5f291315c59db895783cf54411765942806802ac_W   connector_2

Désinstallation de plusieurs agents Windows

Pour désinstaller plusieurs agents Windows, exécutez la commande suivante.

.\uninstall.ps1 -configFile config_connector1.json

Cette commande désinstalle l'agent Windows avec le site SATELLITE_CONNECTOR_INSTANCE_NAME à partir du site configFile.

Mise à jour de plusieurs agents Windows

Pour mettre à jour plusieurs agents Windows, désinstallez l'agent, mettez à jour le fichier de configuration, puis réinstallez l'agent en utilisant le fichier de configuration mis à jour.

Installation d'un seul agent

Passez en revue les étapes suivantes pour utiliser le script install.ps1 afin d'installer un seul agent.

  • Ne pas spécifier le paramètre configFile. Cela garantit une compatibilité ascendante pour les agents < 1.2.0.
  • Le nom du fichier de configuration doit être config.json.
  • Le fichier de configuration config.json ne doit pas contenir de SATELLITE_CONNECTOR_INSTANCE_NAME.

Pour déployer plusieurs agents sur un même hôte, vous devez utiliser le paramètre configFile.

  1. À partir de l'interface utilisateur, exécutez la commande suivante pour télécharger le fichier de l'agent .zip.

    ibmcloud sat agent attach --platform windows

    Exemple de sortie.

    Downloading agent setup tools for windows...
OK
Satellite connector agent for windows was successfully returned /var/folders/17/y8wr4y_x1tb4yf__g3wr6g8m0000gp/T/windows_satellite_connector_4097559421.zip

  2. Vérifiez le site sha512sum de .zip en exécutant la commande suivante sur PowerShell.

    Get-FileHash -Algorithm SHA512 -Path c:\windows_satellite_connector_1420916628.zip

  3. Exécutez la commande suivante dans PowerShell pour extraire le contenu du fichier .zip.

    Expand-Archive -Path 'C:\path\to\windows_satellite_connector_4097559421.zip' -DestinationPath ‘C:\path\to\extract'

  4. Suivez les étapes de la section suivante pour mettre à jour les fichiers de configuration que vous avez extraits.

  5. Modifiez le site config.json et entrez les détails de votre connecteur.

    {
  "SATELLITE_CONNECTOR_ID": "<connector_id>",
  "SATELLITE_CONNECTOR_IAM_APIKEY": "<api_key>",
  "SATELLITE_CONNECTOR_TAGS": "<tags>",
  "LOG_LEVEL": "<log_level>",
  "PRETTY_LOG": <true|false>
}

  6. Exécutez la commande d'installation sur votre hôte Windows.

    ./install.ps1

  7. Découvrez les détails de votre connecteur.

    ibmcloud sat connector get --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyI

    OK
ID:                    U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyI
Name:                  connector
CRN:                   crn:v1:staging:public:satellite:us-south:a/1ae4eb57181a46ceade48465196706a7:U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyI::
Managed From:          Dallas (us-south)
Resource Group ID:     60735c4daed84fcea7d3fe99c298c9b3
Resource Group Name:   Default
State:                 created
Created Date:          2025-04-11 04:06:33 -0500 (19 minutes ago)

  8. Visualiser l'agent appartenant au connecteur.

    ibmcloud sat agent ls --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyI

    OK
Name                   Release                                               Tags
sat-link-e2e-wi.5720   20250410-5f291315c59db895783cf54411765942806802ac_W   connector

Désinstallation d'un seul agent Windows

Pour désinstaller un seul agent, exécutez la commande suivante.

.\uninstall.ps1

Mise à jour d'un seul agent Windows

Pour mettre à jour un agent unique Windows, désinstallez l'agent, mettez à jour le fichier de configuration et réinstallez l'agent à l'aide du fichier de configuration mis à jour.

Foire aux questions

Puis-je ajouter un agent multi Windows à une installation existante d'un agent mono Windows?
Oui, téléchargez un fichier ZIP de l’agent Windows >= 1.2.0, décompressez-le dans un répertoire différent de celui de l’installation existante de l’agent Windows unique, puis configurez un SATELLITE_CONNECTOR_INSTANCE_NAME dans le fichier de configuration qui ne porte pas le nom config.json. Utilisez ensuite install.ps1 -configFile <agent-config-file.json> pour l'installer.
Pourquoi le site update-service.ps1 n'apparaît-il pas dans les versions >= 1.2?
Le site update-service.ps1 était une désinstallation suivie d'une nouvelle installation, nous avons donc décidé de le supprimer. Si vous devez mettre à jour un agent Windows, désinstallez-le, mettez à jour le fichier de configuration et réinstallez-le.
Quelle version de l'agent Windows est installée sur mon hôte Windows?
Le répertoire dans lequel vous avez installé l'agent sur votre serveur Windows contient un fichier nommé version.txt, qui contient la version de l'agent. Si le répertoire ne contient pas de fichier nommé version.txt, la version est <= 1.1.6.
Quelle version de l'agent ai-je téléchargée?
Après avoir téléchargé le fichier ZIP de l'agent Windows à l'aide de la commande ibmcloud sat agent attach --platform windows et l'avoir décompressé à l'aide de la commande Expand-Archive -Force -Path "$filename" -DestinationPath ".", un fichier nommé version.txt contient la version de l'agent.