Despliegue de varios agentes de Connector Windows en un único equipo

A partir de la versión 1.2.0 del agente de Windows, ahora se admiten varios agentes en un único host de Windows. Es necesario que el servidor tenga instalado Microsoft .NET >= 3.5 para poder utilizar la versión >= 1.2.0 del agente de Windows.

No se admite la ejecución de varios agentes en el mismo host de Windows para los puntos finales de Satellite Connector Cloud, ya que el punto de entrada del punto final en la nube es el host de Windows en el que se ejecuta el agente. Los puntos finales en la nube y la ejecución de varios agentes de Windows en un único host son características mutuamente excluyentes. Si necesita utilizar puntos finales Cloud con agentes Windows, se recomienda instalar 1 agente por host Windows.

Consideraciones

El nombre de servicio de un Agente de Windows se ha actualizado en la versión 1.2.0 de satelliteconnectorservice.exe a SatelliteConnectorService. Debido a este cambio, debe utilizar los scripts de desinstalación que vienen con el agente que desea eliminar.
En la versión 1.2.0, para distinguir entre los múltiples agentes Windows instalados en un único host Windows, se introdujo un nuevo parámetro en el archivo de configuración del agente denominado SATELLITE_CONNECTOR_INSTANCE_NAME. Este parámetro se añade al nombre del servicio y se separa con -. Para instalar varios agentes de Windows, ahora debe especificar un archivo de configuración al llamar a los scripts de instalación o desinstalación.
El agente de Windows se ejecuta como un proceso de nodo en el host de Windows. Tanto en la consola IBM Cloud como en la interfaz de línea comando (CLI) IBM Cloud, el ID del proceso del nodo se agrega al nombre del conector y se separa por un ..
En versiones anteriores a 1.2.0 del agente de Windows, no se podía especificar un archivo de configuración para los scripts de instalación o desinstalación. En su lugar, los scripts tomaban automáticamente el archivo config.json del mismo directorio y lo utilizaban para instalar o desinstalar un único agente de Windows.
Un único agente Windows requiere al menos 4 vCPU y se recomiendan 4 GB. Aunque esta configuración podría manejar múltiples agentes, hay una caída significativa en el rendimiento después del 4º agente. Por lo tanto, se recomiendan al menos 8 vCPU y 8 GB para ejecutar varios agentes.
Ejecutar varios agentes pertenecientes al mismo Conector no ofrece ninguna ventaja. La mejor práctica es tener 1 agente por Conector.
La instalación de varios agentes Windows requiere que se conserve 25MB de memoria para cada agente.
La ejecución del tráfico a través de los agentes supone aproximadamente 70 MB de memoria y un uso de la CPU de alrededor del 15 % por agente, con un ancho de banda que alcanza los 150-200 Mbps por agente. Estas cifras se basan en unas pruebas de rendimiento internas de IBM realizadas con el agente para Windows de Satellite Connector.

Instalación de varios agentes de Windows

Para implementar varios agentes en un único host, debes utilizar el parámetro configFile.

Desde la CLI, ejecute el siguiente comando para descargar el archivo del agente ( .zip archivo ZIP).

ibmcloud sat agent attach --platform windows

Ejemplo de salida.

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

Verifique el sha512sum del .zip ejecutando el siguiente comando en PowerShell.

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

Ejecute el siguiente comando en PowerShell para extraer el contenido del archivo .zip.

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

Complete los pasos de la siguiente sección para actualizar los archivos de configuración que extrajo.

Edita el archivo multi_instance_config.json para incluir los detalles de tu Conector.

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

Rellena el archivo de configuración con los datos y las credenciales de tu conector. No nombre el archivo config.json. SATELLITE_CONNECTOR_INSTANCE_NAME es obligatorio y debe empezar por un carácter, sólo puede contener los caracteres (a-zA-Z), los números (0-9) y _, y la longitud total debe ser inferior a 50 caracteres.

Ejecute el script de instalación en PowerShell.

./install.ps1 -configFile multi_instance_config.json

Ver los agentes que se ejecutan en un servidor Windows. Ejecute el siguiente comando en 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

Ver los procesos de nodo que se ejecutan en un servidor Windows. Ejecute el siguiente comando en 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

Obtenga los detalles 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)

Ver el agente perteneciente al conector 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

Obtenga los detalles 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)

Ver el agente perteneciente al conector 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

Desinstalación de varios agentes de Windows

Para desinstalar varios agentes de Windows, ejecute el siguiente comando.

.\uninstall.ps1 -configFile config_connector1.json

Este comando desinstala el agente de Windows con el SATELLITE_CONNECTOR_INSTANCE_NAME desde el configFile.

Actualización de varios agentes de Windows

Para actualizar varios agentes de Windows, desinstale el agente, actualice el archivo de configuración y, a continuación, instale de nuevo el agente utilizando el archivo de configuración actualizado.

Instalación de un único agente

Revise los siguientes pasos para utilizar el script install.ps1 para instalar un único agente.

No especifique el parámetro configFile. Esto garantiza la compatibilidad con versiones anteriores de Agentes < 1.2.0.
El nombre del archivo de configuración debe ser config.json.
El archivo de configuración config.json no debe contener un SATELLITE_CONNECTOR_INSTANCE_NAME.

Para implementar varios agentes en un único host, debes utilizar el parámetro configFile.

Desde la CLI, ejecute el siguiente comando para descargar el archivo .zip del agente.

ibmcloud sat agent attach --platform windows

Ejemplo de salida.

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

Verifique el sha512sum del .zip ejecutando el siguiente comando en PowerShell.

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

Ejecute el siguiente comando en PowerShell para extraer el contenido del archivo .zip.

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

Complete los pasos de la siguiente sección para actualizar los archivos de configuración que extrajo.

Edita la página config.json e introduce los datos de tu Conector.

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

Ejecute el comando de instalación en su host Windows.
```
./install.ps1
```

Consulta los detalles de tu conector.

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)

Ver el agente perteneciente al conector.

ibmcloud sat agent ls --connector-id U2F0ZWxsaXRlQ29ubmVjdG9yOiJjdnNkbjZmMjFyOTJxdTgyZ3BzZyI

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

Desinstalación de un único agente de Windows

Para desinstalar un único agente, ejecuta el siguiente comando.

.\uninstall.ps1

Actualización de un único agente de Windows

Para actualizar un agente único de Windows, desinstale el agente, actualice el archivo de configuración e instale de nuevo el agente utilizando el archivo de configuración actualizado.

Preguntas frecuentes

¿Puedo añadir un agente multi Windows a una instalación existente de agente único Windows?: Sí, descarga un archivo ZIP del agente de Windows >= 1.2.0, descomprímelo en un directorio distinto al de la instalación existente del agente único de Windows y configura un en SATELLITE_CONNECTOR_INSTANCE_NAME el archivo de configuración que no se llame config.json. A continuación, utilízalo install.ps1 -configFile <agent-config-file.json> para instalarlo.
¿Por qué falta update-service.ps1 en las versiones >= 1.2?: El update-service.ps1 era una desinstalación seguida de una nueva instalación, así que decidimos eliminarlo. Si necesita actualizar un agente de Windows, desinstálelo, actualice el archivo de configuración e instálelo de nuevo.
¿Qué versión del agente de Windows está instalada en mi host de Windows?: El directorio donde ha instalado el Agente en su Servidor Windows contiene un fichero llamado version.txt, que contiene la versión del agente. Si el directorio no contiene un archivo llamado version.txt, la versión es <= 1.1.6.
¿Qué versión de Agente he descargado?: Después de descargar el archivo ZIP del Agente de Windows con el comando ibmcloud sat agent attach --platform windows y descomprimirlo con Expand-Archive -Force -Path "$filename" -DestinationPath ".", hay un archivo llamado version.txt que contiene la versión del agente.