Puedes instalar el Agente Uful mediante un asistente gráfico estándar para Windows.

Este asistente se encarga de instalar el Agente Uful y los servicios necesarios para su correcto funcionamiento.

• Grafana Alloy
  Grafana Alloy se utiliza para recopilar las métricas y los logs generados por el Agente Uful.
  Conoce más sobre Grafana Alloy en: documentación oficial de Grafana Alloy.

---

Requisitos previos

Antes de instalar el agente, verifica que el cliente cuente con lo siguiente:

• Acceso a la base de datos que integrará el agente.
• API Key del cliente.
• Permisos de instalación en el sistema operativo.
• Conectividad de red desde la máquina donde se instalará el agente hacia:
  • los servidores de Uful;
  • la base de datos del cliente.

---

Descarga e inicio

1. Ingresa al panel de socios/gasolineros de tu cuenta Uful.
2. En la parte superior derecha del panel, ubica el botón «Descargar Agente Uful».
3. Selecciona Agente Uful para Windows 10 / Windows 11.
4. Haz doble clic en el archivo uful-agent-setup-win-x64.exe para iniciar la instalación del agente.

Sigue los pasos del asistente de instalación.

Carpeta de instalación

Selecciona la carpeta donde deseas instalar el agente.

Componentes

Recomendamos dejar marcadas todas las casillas para que el asistente realice automáticamente la configuración de los servicios.

Instalación y configuración

Haz clic en Instalar y espera unos momentos mientras se inicia el proceso de configuración del agente. Se abrirá una ventana de comandos para completar el SetUp del Agente Uful.

• Cuando termines la configuración del Agente Uful, espera unos segundos mientras finaliza la configuración de los servicios necesarios.
• Cuando el proceso termine, haz clic en «Finalizar» en el asistente de instalación.

Listo. Tu Agente Uful ya está operativo.

---

Problemas comunes

Si durante la instalación aparece el siguiente error: «No se pudo instalar o refrescar el servicio del agente».

Este error puede ocurrir si el Agente Uful ya estaba instalado previamente y, al desinstalarlo, el servicio no se cerró correctamente.

En este caso, sigue estos pasos:

1. Abre la ventana Ejecutar con Win + R, escribe cmd y presiona Enter.
2. En la terminal, ejecuta el siguiente comando:

C:\Program Files\Uful\Agent\WinSW_UfulAgent.exe start
# O la ruta que hayas elegido.

Esto iniciará el servicio del Agente Uful.