ES
Español
English
Português
    Agente de autodiagnóstico

    Esta funcionalidad permite realizar un diagnóstico de los módulos ADM, requeridos para la operación del agente; incluye pruebas de comunicación hacía el sitio de ADM, puertos de comunicación del sitio y locales, verificación de permisos y estado de los servicios necesarios en el equipo, para el funcionamiento de los módulos. Para realizar el proceso de autodiagnóstico realice los siguientes pasos:

    1. Descargue y guarde el paquete Aranda.Diagnostics.ADM.Agent.Cli.9.x.x.x.zip en una ruta específica, luego descomprímalo. Una vez realizado esto, encontrará dos archivos: appsettings.json y Aranda.Diagnostics.ADM.Agent.Cli.9.x.x.x.exe.



    2. Modifique el archivo appsettings.json en la línea dos URI por la URL del nodo, donde apunta o apuntará el agente.


    3. Ejecute como administrador el archivo Aranda.Diagnostics.ADM.Agent.Cli.exe; una vez ejecutado, el utilitario realiza las pruebas de arquitectura, servicios, accesos, permisos, puertos de comunicación.


    4. Una vez finalice el proceso de diagnóstico, cierre la ventana presionando cualquier tecla o cerrando manualmente la ventana. El resultado de las pruebas se almacena en la ruta del utilitario, en la carpeta reports, se guarda el archivo diagnostics.json y podrá visualizarlo en un editor de texto disponible.

    Archivo resultante


    Visualización de resultados en el archivo JSON


    Resultados de ejecución del utilitario como administrador, rol de administrador y estado del servicio WMI


    Resultados de acceso al recurso Admin$, permisos y estado de los servicios de ubicación


    Resultados de verificación de versión y enlace de descarga de agente ADM para futuras actualizaciones


    Resultados de prueba de registro y comunicación por WebSocket y HTTP al componente de administración remota por conexión saliente

    ⚐ Nota: Terminadas las pruebas de autodiagnóstico se recomienda eliminar el/los registro(s) de prueba creado(s) en consola, dependiendo de la cantidad de ejecuciones del utilitario. Si son varios registros, podrá eliminarlos filtrando por estado Sin inventario y agente 9.12.2110.106 y posterior ir a Más opciones > Todos y luego Eliminar dispositivos.


    Resultados de verificación de versión mínima de TLS y comunicación con MQTT


    Resultados de verificación carga de inventarios en el servidor


    Errores comunes en la ejecución de autodiagnóstico

    Al ejecutar el diagnóstico, podrá encontrar diferentes errores por alguna restricción local en firewall, antivirus o problemas de red:

    1. Error de comunicación al nodo configurado en el archivo appsettings.json


    Los casos de error se deben a una restricción de comunicación hacía la URL a la que se le está realizando la prueba. Valide primero si tiene salida a Internet y revise las restricciones de red configuradas a nivel de firewall y realice la excepción a la URL del nodo.

    2. Error al descargar perfil del agente o .EXE del instalador del agente


    Las causas más comunes para este error pueden ser:

    • Al apuntar a un Conserver, se presentan por la ausencia del recurso en la ruta de almacenamiento de archivos del Conserver, . Puede correr de nuevo la prueba de autodiagnóstico para que se ejecute de manera correcta. En la primera ejecución que genera error, el Conserver procesa la tarea que solicita el recurso y luego lo almacena.

    • Independiente del nodo en que se realiza la prueba, para el caso de descarga del .EXE del instalador del agente; la posible causa del error es que la tarea encargada de descargar el recurso, no se ha ejecutado, para mayor información consulte Despliegue de agentes.

    • Revise las excepciones de antivirus, ya que puede estar bloqueando la descarga de fuentes externas a las autorizadas por la compañía.

    3. Falla en consulta de servicio WMI

    Este error se presenta por una falla en el servicio Instrumental de administración de Windows (Winmgmt); revise si el servicio se encuentra habilitado e iniciado o que no se encuentre bloqueado por alguna política de dominio.

    4. Falla en administración remota

    Existen dos situaciones para esta falla:

    • Administración remota LAN:


    Si tiene el agente instalado, verifique desde el Monitor de recursos > Red > Puertos de escucha que el proceso de Aranda.Agent.ACOREService.exe esté corriendo en el puerto 9025. Valide que en la columna Estado de firewall diga Permitido, no restringido; en caso contrario confirme las reglas de firewall.


    • Adminisstración remota por conexión saliente:


    Las causas más comunes para este error pueden ser:

    • La falta de configuración de HTTPS sobre el nodo que se está realizando el diagnóstico. Para mayor información consulte los siguientes enlaces de acuerdo a su infraestructura:
    • La falta del componente de WebSocket en los roles y características.

    5. Falla en la verificación del TLS mínimo.


    Verifique que el servidor cumpla con los requisitos mínimos, como la versión mínima soportada de TLS (1.2) . Para mayor información consulte la nota A tener en cuenta Requisitos.

    6. Falla en servicios de ubicación.


    Las causas más comunes para este error pueden ser:

    • El Servicio de geolocalización (lfsvc) no está habilitado o tiene restriccioens de acceso por política de dominio.

    • Se tiene configuradas políticas de dominio con restricción de acceso a la ubicación. Si alguna de estas llaves de registro está creada con DWORD = 1, se deben eliminar:

    • Llave de registro: Software\Policies\Microsoft\Windows\LocationAndSensors\DisableLocation
    • Llave de registro: Software\Policies\Microsoft\Windows\LocationAndSensors\DisableSensors
    • Llave de registro: Software\Policies\Microsoft\Windows\LocationAndSensors\DisableWindowsLocationProvider

    7. Falla de comunicación con el componente de MQTT


    Verifique en las reglas de firewall alguna restricción en la IP o DNS configurado para el componente de MQTT por el puerto 1884 o valide que el servicio del MQTT en el servidor, esté operativo.

    8. En la carga de inventarios al servidor.


    Las causas más comunes para este error pueden ser:

    • No se tiene configurada una ruta de almacenamiento de archivos local o almacenamiento de blobs válida para el nodo al que está apuntando. Para mayor información consulte Comunicaciones

    • No se tienen permisos de lectura y escritura sobre la ruta de almacenamiento de archivos local o almacenamiento de blobs que tenga configurada para el nodo al que está apuntando.

    En el siguiente enlace podrá encontrar el ejecutable del agente de autodiagnóstico Agente Autodiagnóstico