Breadcrumbs

Agente no aparece en el portal tras instalar DCA and Cloud Connector

Falla

Tras instalar DCA and Cloud Connector, el agente no aparece en el portal NDD Orbix.

Causa

En la carpeta de instalación del agente (C:\NDD TECH\Workfolder\logs), se ha generado un archivo .txt con uno de los errores. Cada error está asociado a una causa específica.

Causa 1: falla al insertar el nombre del distribuidor
[ERR] Agent authentication failed [{"ErrorCode":"4000","ErrorMessage":"Error while 
copying content to a stream. --- The response ended prematurely. 
(ResponseEnded)","PropertyName":null,"$type":"ApiError"}]  
[ERR] Failed to start Agent SDK.  
[ERR] Failed to setup AgentSDK. Error message: Agent autenticai-os failed: 
[{"ErrorCode":"4000","ErrorMessage":"Error while copying content to a stream. --- The 
response ended prematurely. (ResponseEnded)","PropertyName":null}]. Retrying in 30 
minute(s). 

Esta falla se produce cuando el nombre del distribuidor se ha insertado incorrectamente durante la instalación del agente, pero la clave de instalación del cliente es correcta.

Causa 2: falla al insertar la clave del cliente
[ERR] Agent authentication failed 
[{"ErrorCode":null,"ErrorMessage":"{\"ErrorCode\":500,\"ErrorMessage\":
\"Value cannot be null. (Parameter 'request')\"}","PropertyName":null,"$Type":"ApiError"}]

Esta falla se produce cuando la clave del cliente se ha introducido incorrectamente durante la instalación del agente.

Causa 3: falla de clase no válida
[ERR] Failed to get machine ID Microsoft.Management.Infrastructure.CimException: 
Classe inválida at 
Microsoft.Management.Infrastructure.Internal.Operations.CimSyncEnumeratorBase`1
.MoveNext() at System.Linq.Enumerable.TryGetFirst[TSource](IEnumerable`1 
source, Boolean& found) at 
System.Linq.Enumerable.FirstOrDefault[TSource](IEnumerable`1 source) at 
NDPAgents.SDK.Common.Helpers.EnviromentSettingsHelper.WindowsEnviromentS
ettingsHelper.GetMachineId() 2025-07-15 17:08:00.375 -03:00 [ERR] Failed to get 
machine ID Microsoft.Management.Infrastructure.CimException: Classe inválida

Esta falla está relacionada con el servicio WMI de Windows, utilizado por DCA and Cloud Connector para recopilar información del sistema y de los dispositivos.

Causa 4: falla de autenticación del agente
[ERR] Failed to get ram memory from the machine through the 
Win32_ComputerSystem class Microsoft.Management.Infrastructure.CimException: 
Não encontrado 

[ERR] Agent authentication failed 
[{"ErrorCode":"NotEmptyValidator","ErrorMessage":"'Machine Id' must not be 
empty.","PropertyName":"MachineId","$type":"ApiError"},{"ErrorCode":"NotEmptyVali
dator","ErrorMessage":"'OS' must not be 
empty.","PropertyName":"OS","$type":"ApiError"},{"ErrorCode":"LengthValidator","Err
orMessage":"'OS' must be between 1 and 255 characters. You entered 0 
characters.","PropertyName":"OS","$type":"ApiError"}

Esta falla está relacionada con el servicio WMI de Windows, utilizado por DCA and Cloud Connector para recopilar información del sistema y de los dispositivos.

Causa 5: falla de certificado no válido
[ERR] Failed to setup AgentSDK. Error message: Agent authentication failed: 
[{"ErrorCode":"4000","ErrorMessage":"The SSL connection could not be established, 
see inner exception. --- The remote certificate is invalid because of errors in the 
certificate chain: UntrustedRoot","PropertyName":null}]. 

Esta falla indica que el sistema operativo en el que está instalado el agente DCA and Cloud Connector no reconoce a la autoridad de certificación (CA) de GoDaddy como fuente fiable.

Esto suele ocurrir en versiones antiguas de Windows Server que no actualizan automáticamente las raíces de los certificados.

Solución

Aplique el procedimiento según la causa identificada.

Causa 1 (falla al insertar la clave del cliente) o 2 (falla al insertar el nombre del distribuidor)
  1. Desinstale el agente DCA and Cloud Connector del ordenador, tal y como se indica en Eliminar el agente en Windows

  2. Instale el agente DCA and Cloud Connector de nuevo, tal y como se indica en Instalar el agente en Windows

Causa 3 (falla de clase no válida) o 4 (falla de autenticación del agente)
  1. Por precaución, detenga el servicio DCA and Cloud Connector en Windows:

    1. Abra el Administrador de servicios como administrador (Win + R → introduzca services.msc OK)

    2. Busque y detenga el servicio NDD - DCA and Cloud Connector

  2. Restaure winmgmt:

    1. Abra Windows PowerShell como administrador

    2. Ejecute el comando winmgmt /resetrepository

Si no devuelve ningún error:

  1. Ejecute el comando (Get-CimInstance -ClassName Win32_ComputerSystemProduct).UUID

  2. Si se devuelve el GUID, inicie el servicio DCA and Cloud Connector en Windows:

    1. Abra el Administrador de servicios como administrador (Win + R → introduzca services.msc OK)

    2. Busque y arranque el servicio NDD - DCA and Cloud Connector

  3. En el portal NDD Orbix, compruebe que el servicio NDD - DCA and Cloud Connector aparece y tiene el Estado Online, tal y como se indica en Ver informaciones de los servicios

Si aparece el mensaje “Imposible ejecutar, ya que hay servicios o procesos en ejecución que dependen de él:

  1. Ejecute el comando Get-Service -Name winmgmt | Select-Object -ExpandProperty DependentServices para enumerar los servicios que se están ejecutando y que dependen directamente de winmgmt

image-20251003-182526.png
Ejemplo de retorno del comando
  1. Detenga todos los servicios con el estado Running:

    1. Ejecute el comando sc.exe stop <serviceName>, sustituyendo <serviceName> por el nombre del servicio

💡

Ejemplo

sc.exe stop vmns

  1. Después de detener todos los servicios, ejecute el comando winmgmt /resetrepository

  2. Inicie el servicio DCA and Cloud Connector en Windows:

    1. Abra el Administrador de servicios como administrador (Win + R → introduzca services.msc OK)

    2. Busque y arranque el servicio NDD - DCA and Cloud Connector

  3. En el portal NDD Orbix, compruebe que el servicio NDD - DCA and Cloud Connector aparece y tiene el Estado Online, tal y como se indica en Ver informaciones de los servicios

  4. Reinicie todos los servicios que se detuvieron en el paso 2:

    1. Ejecute el comando sc.exe start <serviceName>, sustituyendo <serviceName> por el nombre del servicio

💡

Ejemplo

sc.exe start vmns

Causa 5 (falla de certificado no válido)
  1. Obtenga el certificado raíz de GoDaddy:

    1. Acceda al repositorio de certificados de GoDaddy

    2. Busque y realice la descarga del certificado GoDaddy Class 2 Certification Authority Root - G2 (extensión .crt o .der)

Información

Si tiene dudas, realice la descarga del certificado GoDaddy Root Certificate Authority - G2.

  1. Instala el certificado en el ordenador:

    1. Abre Ejecutar (pulsa Win + R)

    2. Introduzca certlm.msc

    3. Pulsa Intro o haz clic en OK para abrir la pantalla de certificados

    4. En el menú de la izquierda, navega hasta Autoridades de certificación raíz de confianza > Certificados

    5. Haz clic con el botón derecho en la carpeta Certificados

    6. Haz clic en Todas las tareas > Importar…

    7. En el asistente para importar certificados, haga clic en Siguiente

    8. Haga clic en Examinar... y seleccione el archivo descargado en el paso 1

    9. Haga clic en Siguiente

    10. Asegúrese de que la opción Colocar todos los certificados en el siguiente repositorio esté marcada como Autoridades de certificación raíz de confianza

    11. Haga clic en Siguiente

    12. Haga clic en Finalizar

  2. Reinicie el servicio DCA and Cloud Connector en Windows:

    1. Abra Ejecutar (pulse Win + R)

    2. Introduzca services.msc

    3. Pulse Intro o haga clic en OK para abrir la pantalla de servicios

    4. Busque el servicio NDD - DCA and Cloud Connector y haga clic con el botón derecho sobre él

    5. Haga clic en Reiniciar