Distribuzione di più agenti Connector Windows su una singola macchina

A partire dalla versione 1.2.0 dell'agente Windows, è ora supportata la presenza di più agenti su un singolo host Windows. Per poter utilizzare la versione >= 1.2.0 dell’agente Windows, sul server è necessario che sia installato Microsoft .NET >= 3.5.

L'esecuzione di più agenti sullo stesso host Windows non è supportata per gli endpoint Cloud di Satellite Connector, poiché l'ingresso dell'endpoint Cloud è rappresentato dall'host Windows su cui è in esecuzione l'agente. Gli endpoint cloud e l'esecuzione di più agenti Windows su un singolo host sono caratteristiche che si escludono a vicenda. Se è necessario utilizzare endpoint Cloud con agenti Windows, si consiglia di installare 1 agente per host Windows.

Considerazioni

Il nome del servizio di un Agente Windows è stato aggiornato nella versione 1.2.0 da satelliteconnectorservice.exe a SatelliteConnectorService. A causa di questa modifica, è necessario utilizzare gli script di disinstallazione forniti con l'agente che si desidera rimuovere.
Nella versione 1.2.0, per distinguere tra più agenti Windows installati su un singolo host Windows, è stato introdotto un nuovo parametro nel file di configurazione dell'agente denominato SATELLITE_CONNECTOR_INSTANCE_NAME. Questo parametro viene aggiunto al nome del servizio e separato da -. Per installare più agenti Windows, ora è necessario specificare un file di configurazione quando si chiamano gli script di installazione o disinstallazione.
L'agente Windows viene eseguito come processo di nodo sull'host Windows. Sia nella console IBM Cloud che nell'interfaccia a riga di comando (CLI) IBM Cloud, l'ID del processo del nodo viene aggiunto al nome del Connector, separato da un punto ( .).
Nelle versioni precedenti a 1.2.0 dell'agente Windows, non era possibile specificare un file di configurazione per gli script di installazione o disinstallazione. Invece, gli script prendevano automaticamente il file config.json dalla stessa directory e lo utilizzavano per installare o disinstallare un singolo agente Windows.
Un singolo agente Windows richiede almeno 4 vCPU e si consigliano 4 GB. Sebbene questa configurazione possa gestire più agenti, dopo il quarto agente si verifica un calo significativo delle prestazioni. Pertanto, per l'esecuzione di più agenti si consigliano almeno 8 vCPU e 8 GB.
L'esecuzione di più agenti appartenenti allo stesso connettore non offre alcun vantaggio. La prassi migliore è quella di avere 1 agente per ogni connettore.
L'installazione di più agenti Windows richiede la conservazione di 25MB di memoria per ogni agente.
L'elaborazione del traffico sugli agenti comporta un consumo di memoria pari a circa 70 MB e un utilizzo della CPU pari a circa il 15% per agente, con una larghezza di banda che raggiunge i 150–200 Mbps per agente. Questi dati si basano su test interni di performance condotti d IBM sull'agente Windows del Connector Satellite.

Installazione di più agenti Windows

Per distribuire più agenti su un singolo host, è necessario utilizzare un parametro " configFile ".

Dalla CLI, eseguire il seguente comando per scaricare il file dell' .zip e dell'agente (archivio ZIP).

ibmcloud sat agent attach --platform windows

Output di esempio.

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

Verificate il sito sha512sum di .zip eseguendo il seguente comando in PowerShell.

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

Eseguite il seguente comando in PowerShell per estrarre il contenuto del file .zip.

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

Completate i passaggi della sezione seguente per aggiornare i file di configurazione estratti.

Modificare il file multi_instance_config.json per includere i dettagli del connettore.

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

Inserire nel file di configurazione i dati e le credenziali del Connector. Non nominare il file config.json. Il campo SATELLITE_CONNECTOR_INSTANCE_NAME è obbligatorio e deve iniziare con un carattere, può contenere solo i caratteri (a-zA-Z), i numeri (0-9) e _, e la lunghezza totale deve essere inferiore a 50 caratteri.

Eseguite lo script di installazione in PowerShell.

./install.ps1 -configFile multi_instance_config.json

Visualizzare gli agenti in esecuzione su un server Windows. Eseguite il seguente comando in 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

Visualizzare i processi dei nodi in esecuzione su un server Windows. Eseguite il seguente comando in 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

Scopri i dettagli di 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)

Visualizzare l'agente appartenente al connettore 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

Scopri i dettagli di 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)

Visualizzare l'agente appartenente al connettore 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

Disinstallazione di più agenti Windows

Per disinstallare più agenti Windows, eseguire il comando seguente.

.\uninstall.ps1 -configFile config_connector1.json

Questo comando disinstalla l'agente Windows con il sito SATELLITE_CONNECTOR_INSTANCE_NAME dal sito configFile.

Aggiornamento di più agenti Windows

Per aggiornare più agenti Windows, disinstallare l'agente, aggiornare il file di configurazione, quindi installare nuovamente l'agente utilizzando il file di configurazione aggiornato.

Installazione di un singolo agente

Esaminare i passaggi seguenti per utilizzare lo script install.ps1 per installare solo un singolo agente.

Non specificare il parametro configFile. Questo garantisce la retrocompatibilità per gli agenti < 1.2.0.
Il nome del file di configurazione deve essere config.json.
Il file di configurazione config.json non deve contenere un SATELLITE_CONNECTOR_INSTANCE_NAME.

Per distribuire più agenti su un singolo host, è necessario utilizzare un parametro " configFile ".

Dalla CLI, eseguire il seguente comando per scaricare il file .zip dell'agente.

ibmcloud sat agent attach --platform windows

Output di esempio.

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

Verificate il sito sha512sum di .zip eseguendo il seguente comando in PowerShell.

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

Eseguite il seguente comando in PowerShell per estrarre il contenuto del file .zip.

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

Completate i passaggi della sezione seguente per aggiornare i file di configurazione estratti.

Modificare il sito config.json e inserire i dettagli del connettore.

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

Eseguire il comando di installazione sull'host Windows.
```
./install.ps1
```

Scopri i dettagli del tuo 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)

Visualizzare l'agente appartenente al connettore.

ibmcloud sat agent ls --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyI

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

Disinstallazione di un singolo agente Windows

Per disinstallare un singolo agente, eseguire il seguente comando.

.\uninstall.ps1

Aggiornamento di un singolo agente Windows

Per aggiornare un agente singolo di Windows, disinstallare l'agente, aggiornare il file di configurazione e installare nuovamente l'agente utilizzando il file di configurazione aggiornato.

FAQ

È possibile aggiungere un agente multi Windows a un'installazione esistente di un agente singolo Windows?: Sì, scarica un file ZIP dell'agente Windows con versione pari o superiore a 1.2.0, decomprimilo in una directory diversa da quella dell'installazione esistente dell'agente Windows singolo e configura un SATELLITE_CONNECTOR_INSTANCE_NAME nel file di configurazione che non si chiami config.json. Quindi utilizza install.ps1 -configFile <agent-config-file.json> per installarlo.
Perché update-service.ps1 manca nelle versioni >= 1.2?: Il sito update-service.ps1 prevedeva una disinstallazione seguita da una nuova installazione, quindi abbiamo deciso di rimuoverlo. Se è necessario aggiornare un agente Windows, disinstallarlo, aggiornare il file di configurazione e installarlo di nuovo.
Quale versione dell'agente Windows è installata sul mio host Windows?: La directory in cui è stato installato l'agente sul server Windows contiene un file denominato version.txt, che contiene la versione dell'agente. Se la directory non contiene un file chiamato version.txt, la versione è <= 1.1.6.
Quale versione di Agent ho scaricato?: Dopo aver scaricato il file ZIP dell'Agente Windows con il comando ibmcloud sat agent attach --platform windows e averlo scompattato con Expand-Archive -Force -Path "$filename" -DestinationPath ".", si trova un file chiamato version.txt che contiene la versione dell'agente.