Distribuzione di più agenti Connector Windows su una singola macchina

A partire dalla versione dell'agente Windows 1.2.0, sono ora supportati più agenti su un singolo host Windows. Per utilizzare la versione >= 1.2.0 dell'agente Windows, sul server è necessario Microsoft.NET 3.5.

L'esecuzione di più agenti sullo stesso host Windows non è supportata per gli endpoint Satellite Connector Cloud, poiché l'ingress dell'endpoint Cloud è l'host Windows che esegue 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 nella CLI IBM Cloud, l'ID del processo del nodo viene aggiunto al nome del connettore e separato da un ..
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 l'agente 4th 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'esecuzione del traffico tra gli agenti comporta l'utilizzo di ~70MB di memoria e del 15% di CPU per agente, con una larghezza di banda che raggiunge i 150-200 Mbps per agente.

Installazione di più agenti Windows

Per distribuire più agenti su un singolo hots, è necessario utilizzare il 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 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 un agente multiplo di Windows, eseguire il seguente comando.

.\uninstall -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 hots, è necessario utilizzare il 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
```

Ottenete i dettagli del vostro Connettore.

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 l'agente singolo, eseguire il seguente comando.

.\unistall.sh

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ì, scaricare un file zip dell'agente Windows >= 1.2.0, decomprimerlo in una directory diversa da quella dell'installazione dell'agente Windows singolo esistente e configurare un SATELLITE_CONNECTOR_INSTANCE_NAME nel file di configurazione non denominato config.json L'uso di 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.