Skip to main content
Instalas el agente de software de Myrmex desde la página Download Agent de la consola. El flujo es el mismo en todas las plataformas: obtén un token de instalación, ejecuta el instalador para tu sistema operativo y luego autoriza el nuevo dispositivo.
Esto instala el agente de software en un host. Una vez autorizado, los agentes de IA pueden leer su telemetría y actuar sobre el host.

Obtener un token de instalación

Cada instalación necesita un token de instalación, que la consola genera por ti:
1

Abre Download Agent

Abre la página Download Agent desde la consola.
2

Genera un token

Genera un token de instalación. Es válido durante 24 horas y es reutilizable dentro de esa ventana, por lo que un solo token puede incorporar muchos hosts.
3

Elige tu SO

Elige Windows, macOS o Linux para obtener el instalador correspondiente y un comando listo para ejecutar con el token ya incorporado.
Copia el comando exacto de la página Download Agent: ya incluye tu token. Los comandos de abajo muestran la forma general; el marcador de posición YOUR_TOKEN representa el que genera la consola.

Windows

Requisitos: Windows 10 o posterior, o Windows Server 2016 o posterior. Instala como Administrador local. Elige cualquiera de los dos métodos:
  • Paquete MSI: descarga el MSI desde la página Download Agent y ejecútalo. Aprueba el mensaje de Control de cuentas de usuario y sigue el asistente de configuración hasta el final.
  • Comando de una línea en PowerShell: ejecuta el comando de la consola en una sesión de PowerShell con privilegios elevados:
El agente se instala como un servicio del sistema y se inicia automáticamente.

macOS

Requisitos: una versión compatible de macOS en Apple Silicon (arm64). Elige cualquiera de los dos métodos:
  • Instalador .pkg: descarga el .pkg desde la página Download Agent y ejecútalo, siguiendo los mensajes.
  • Comando de una línea en Bash: ejecuta el comando de la consola en la Terminal:

Linux

Requisitos: una distribución compatible: Debian, Ubuntu, Fedora, RHEL, CentOS, Oracle Linux o Amazon Linux. Instala como root (o con sudo). Linux usa un único instalador universal que ejecutas con curl | bash, pasando tu token como una variable de entorno:
El instalador detecta tu distribución, instala el agente y lo registra como un servicio.
Durante la instalación, el host descarga paquetes de dependencias, así que permite el tráfico saliente por el 443 hacia *.myrmex.ai y hacia los repositorios oficiales de tu distribución. Consulta Modo Collector para ver el modelo de red completo.

Autorizar el dispositivo

Un dispositivo recién instalado aparece como unauthorized y no reporta nada hasta que lo apruebas. Este paso es obligatorio.
Abre el nuevo dispositivo desde la vista de Endpoints o su vista de detalle y elige Authorize. El dispositivo se activa y comienza a reportar, y entonces puedes definir su rol, sus reglas y más.

Migrar un Host Entre Contextos

Un contexto es la organización / tenant a la que reporta un host. Para mover un host ya instalado de un contexto a otro no desinstalas nada — vuelves a ejecutar el instalador con el token del nuevo contexto, y el agente se re-registra por sí mismo.
1

Obtén el comando de instalación del nuevo contexto

Cambia al contexto de destino y abre su página Download Agent. Genera allí un token de instalación y copia el comando listo para ejecutar — está limitado a ese contexto.
2

Ejecútalo en el host

Ejecuta ese comando exacto en el host como root / administrador — el mismo comando que una instalación nueva. El agente se re-registra en el nuevo contexto: obtiene una nueva identidad, reescribe config.yml / env.conf para apuntar al nuevo contexto y se reconecta. No hace falta desinstalar ni reiniciar.
3

Autorízalo en el nuevo contexto

El host aparece en la vista de Endpoints del nuevo contexto como unauthorized. Apruébalo allí para reactivar la telemetría y la respuesta. En el contexto anterior deja de reportar y puede eliminarse.
Ninguna integración se migra con esto. Las integraciones pertenecen al contexto — viven en la plataforma, no en el host — así que re-registrar un host solo mueve el agente de ese host. No copia, mueve ni elimina ninguna integración: el contexto anterior conserva sus integraciones y el nuevo usa lo que esté configurado en él.
Volver a ejecutar el instalador simplemente sobrescribe el vínculo de contexto del host (config.yml / env.conf) con el del nuevo contexto — eso es toda la migración. El binario del agente y sus servicios permanecen en su lugar.

A dónde ir después

Detalles y acciones del dispositivo

Autoriza, define el rol y ejecuta acciones en el host.

Endpoint vs. Collector

Elige cómo se ejecuta el dispositivo después de la instalación.

Comunicación del agente

Cómo funcionan la incorporación y el token internamente.

Capacidades del agente

Lo que hace el agente una vez que está activo.