Bereitstellen mehrerer Connector Windows-Agenten auf einem einzigen Computer

Ab der Windows-Agent-Version 1.2.0 werden nun mehrere Agenten auf einem einzelnen Windows-Host unterstützt. Auf dem Server ist Microsoft .NET >= 3.5 erforderlich, um die Version >= 1.2.0 des Windows-Agenten nutzen zu können.

Der Betrieb mehrerer Agenten auf demselben Windows-Host wird für Endpunkte des Satellite Connector Cloud nicht unterstützt, da der Eingangs-Endpunkt der Cloud der Windows-Host ist, auf dem der Agent ausgeführt wird. Cloud-Endpunkte und die Ausführung mehrerer Windows-Agenten auf einem einzigen Host schließen sich gegenseitig aus. Wenn Sie Cloud-Endpunkte mit Windows-Agenten verwenden müssen, wird empfohlen, dass Sie 1 Agent pro Windows-Host installieren.

Hinweise

Der Dienstname eines Windows-Agenten wurde in der Version 1.2.0 von satelliteconnectorservice.exe auf SatelliteConnectorService aktualisiert. Aufgrund dieser Änderung müssen Sie die Deinstallationsskripte verwenden, die mit dem zu entfernenden Agenten geliefert wurden.
In der Version 1.2.0 wurde zur Unterscheidung zwischen mehreren Windows-Agenten, die auf einem einzigen Windows-Host installiert sind, ein neuer Parameter in der Agenten-Konfigurationsdatei namens SATELLITE_CONNECTOR_INSTANCE_NAME eingeführt. Dieser Parameter wird an den Dienstnamen angehängt und durch ein - getrennt. Um mehrere Windows-Agenten zu installieren, müssen Sie jetzt eine Konfigurationsdatei angeben, wenn Sie die Installations- oder Deinstallationsskripte aufrufen.
Der Windows-Agent läuft als ein Knotenprozess auf dem Windows-Host. Sowohl in der IBM Cloud Konsole als auch in der IBM Cloud CLI wird die Prozess-ID des Knotens an den Namen des Connectors angehängt und durch ein . getrennt.
In früheren Versionen als 1.2.0 des Windows-Agenten war es nicht möglich, eine Konfigurationsdatei für die Installations- oder Deinstallationsskripte anzugeben. Stattdessen nahmen die Skripte automatisch die Datei config.json aus demselben Verzeichnis und verwendeten sie zur Installation oder Deinstallation eines einzelnen Windows-Agenten.
Für einen einzelnen Windows-Agenten sind mindestens 4 vCPU erforderlich, 4 GB werden empfohlen. Obwohl diese Konfiguration mehrere Agenten bewältigen kann, kommt es nach dem vierten Agenten zu einem erheblichen Leistungsabfall. Daher werden mindestens 8 vCPU und 8 GB für die Ausführung mehrerer Agenten empfohlen.
Der Betrieb mehrerer Agenten, die zum selben Connector gehören, bietet keine Vorteile. Am besten ist es, wenn 1 Agent pro Anschluss tätig ist.
Bei der Installation mehrerer Windows-Agenten muss für jeden Agenten 25MB Speicherplatz vorgehalten werden.
Der Datenverkehr über die Agenten hinweg beläuft sich auf ~70MB Speicherplatz und eine CPU-Auslastung von etwa 15 % pro Agent, wobei die Bandbreite 150–200 Mbit/s pro Agent erreicht. Quelle: Systemanforderungen für den Connector-Agenten.

Installieren mehrerer Windows-Agenten

Um mehrere Agenten auf einem einzigen Hotspot einzusetzen, müssen Sie den Parameter configFile verwenden.

Führen Sie über die Befehlszeilenschnittstelle (CLI) den folgenden Befehl aus, um die Agentendatei .zip herunterzuladen.

ibmcloud sat agent attach --platform windows

Beispielhafte Ausgabe.

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

Überprüfen Sie die sha512sum der .zip, indem Sie den folgenden Befehl in PowerShell ausführen.
```
Get-FileHash -Algorithm SHA512 -Path c:\windows_satellite_connector_1420916628.zip
```

Führen Sie den folgenden Befehl in PowerShell aus, um den Inhalt der Datei .zip zu extrahieren.

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

Führen Sie die Schritte im folgenden Abschnitt aus, um die extrahierten Konfigurationsdateien zu aktualisieren.

Bearbeiten Sie die Datei multi_instance_config.json und fügen Sie die Details Ihres Connectors hinzu.

{
  "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>
}

Füllen Sie die Konfigurationsdatei mit Ihren Connector-Details und Anmeldedaten. Nennen Sie die Datei nicht config.json. SATELLITE_CONNECTOR_INSTANCE_NAME ist erforderlich und muss mit einem Zeichen beginnen, darf nur die Zeichen (a-zA-Z), die Zahlen (0-9) und _ enthalten und muss insgesamt weniger als 50 Zeichen lang sein.
Führen Sie das Installationsskript unter PowerShell aus.
```
./install.ps1 -configFile multi_instance_config.json
```

Anzeigen der Agenten, die auf einem Windows Server laufen. Führen Sie den folgenden Befehl in PowerShell aus.

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

Anzeigen der Knotenprozesse, die auf einem Windows Server laufen. Führen Sie den folgenden Befehl in PowerShell aus.

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

Hier finden Sie die Details zu 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)

Zeigen Sie den zum Anschluss gehörenden Agenten an 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

Hier finden Sie die Details zu 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)

Zeigen Sie den zum Anschluss gehörenden Agenten an 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

Deinstallation mehrerer Windows-Agenten

Um einen Windows-Mehrfachagenten zu deinstallieren, führen Sie den folgenden Befehl aus.

.\uninstall -configFile config_connector1.json

Dieser Befehl deinstalliert den Windows-Agenten mit dem SATELLITE_CONNECTOR_INSTANCE_NAME von der configFile.

Mehrere Windows-Agenten aktualisieren

Um mehrere Windows-Agenten zu aktualisieren, deinstallieren Sie den Agenten, aktualisieren Sie die Konfigurationsdatei und installieren Sie den Agenten dann erneut mit der aktualisierten Konfigurationsdatei.

Installieren eines einzelnen Agenten

Gehen Sie die folgenden Schritte durch, um mit dem Skript install.ps1 nur einen einzelnen Agenten zu installieren.

Geben Sie den Parameter configFile nicht an. Damit ist die Abwärtskompatibilität für Agenten < 1.2.0 gewährleistet.
Der Name der Konfigurationsdatei muss config.json lauten.
Die Konfigurationsdatei config.json darf kein SATELLITE_CONNECTOR_INSTANCE_NAME enthalten.

Um mehrere Agenten auf einem einzigen Hotspot einzusetzen, müssen Sie den Parameter configFile verwenden.

Führen Sie über die Befehlszeilenschnittstelle (CLI) den folgenden Befehl aus, um die Agentendatei .zip herunterzuladen.

ibmcloud sat agent attach --platform windows

Beispielhafte Ausgabe.

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

Überprüfen Sie die sha512sum der .zip, indem Sie den folgenden Befehl in PowerShell ausführen.
```
Get-FileHash -Algorithm SHA512 -Path c:\windows_satellite_connector_1420916628.zip
```

Führen Sie den folgenden Befehl in PowerShell aus, um den Inhalt der Datei .zip zu extrahieren.

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

Führen Sie die Schritte im folgenden Abschnitt aus, um die extrahierten Konfigurationsdateien zu aktualisieren.

Bearbeiten Sie die Seite config.json und geben Sie Ihre Verbindungsdaten ein.

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

Führen Sie den Installationsbefehl auf Ihrem Windows-Host aus.
```
./install.ps1
```

Erfahren Sie mehr über Ihren Connector.

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)

Zeigen Sie den zum Konnektor gehörenden Agenten an.

ibmcloud sat agent ls --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyI

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

Deinstallation eines einzelnen Windows-Agenten

Um einen einzelnen Agenten zu deinstallieren, führen Sie den folgenden Befehl aus.

.\unistall.sh

Aktualisieren eines einzelnen Windows-Agenten

Um einen Windows-Einzelagenten zu aktualisieren, deinstallieren Sie den Agenten, aktualisieren Sie die Konfigurationsdatei, und installieren Sie den Agenten erneut mit der aktualisierten Konfigurationsdatei.

Häufig gestellte Fragen

Kann ich einen Multi-Windows-Agenten zu einer bestehenden Einzel-Windows-Agenten-Installation hinzufügen?: Ja, laden Sie eine Windows-Agenten-Zip-Datei >= 1.2.0 herunter, entpacken Sie sie in ein anderes Verzeichnis als die vorhandene einzelne Windows-Agenten-Installation und konfigurieren Sie eine SATELLITE_CONNECTOR_INSTANCE_NAME in der Konfigurationsdatei, die nicht config.json heißt. Verwenden Sie install.ps1 -configFile <agent-config-file.json>, um sie zu installieren.
Warum fehlt die update-service.ps1 in Versionen >= 1.2?: Die Website update-service.ps1 war eine Deinstallation mit anschließender Neuinstallation, so dass wir beschlossen, sie zu entfernen. Wenn Sie einen Windows-Agenten aktualisieren müssen, deinstallieren Sie ihn, aktualisieren Sie die Konfigurationsdatei und installieren Sie ihn erneut.
Welche Windows-Agent-Version ist auf meinem Windows-Host installiert?: Das Verzeichnis, in dem Sie den Agenten auf Ihrem Windows Server installiert haben, enthält eine Datei namens version.txt, die die Version des Agenten enthält. Wenn das Verzeichnis keine Datei mit dem Namen version.txt enthält, ist die Version <= 1.1.6.
Welche Agent-Version habe ich heruntergeladen?: Nach dem Herunterladen der Windows Agent-ZIP-Datei mit dem Befehl ibmcloud sat agent attach --platform windows und dem Entpacken mit Expand-Archive -Force -Path "$filename" -DestinationPath "." gibt es eine Datei namens version.txt, die die Agent-Version enthält.