Instalar el agente en Windows
Instalación del agente de Lymen en Windows Server con PowerShell, y todas las opciones del instalador.
En esta página
Para qué sirve#
Hace lo mismo que en Linux: el agente corre como un servicio de Windows y le manda a Lymen las métricas del servidor (CPU, memoria, disco, red), el registro de eventos de Windows y los datos de tus aplicaciones. Lo ves en Infraestructura.
Importante: el instalador de Windows se probó solo hasta la lectura de opciones, la revisión previa y el registro del servidor. La parte que crea el servicio no se probó todavía en un Windows real. Hacé la primera instalación en un servidor de prueba y avisanos cómo te fue.
Requisitos#
- Windows de 64 bits (amd64). Pensado para Windows Server 2022.
- PowerShell abierto como administrador.
- Salida a internet hacia Lymen o un gateway de tu red que sí la tenga.
Paso a paso#
- En el portal, andá a Agregar datos › Agregar servidor y generá el comando (ver Agregar datos).
- Elegí la pestaña Windows y copialo.
- Abrí PowerShell como administrador en el servidor y pegalo.
- En 1-2 minutos el servidor aparece Conectado en Infraestructura.
El comando tiene esta forma (el código y la dirección son de ejemplo):
powershell
$env:LYMEN_ENROLAR='<código>'; $env:LYMEN_INGESTA='<tu-cuenta>-ingesta.lymen.app';
& ([scriptblock]::Create((iwr -useb https://<tu-cuenta>-ingesta.lymen.app/agente/instalar.ps1).Content)) --grupo produccionPara comprobar el servidor y las opciones sin instalar nada, agregá --verificar al final. No gasta el código.
Opciones del instalador#
Son las mismas que en Linux, con las mismas validaciones. La única diferencia es el formato de la huella del gateway.
| Opción | Variable de entorno | Para qué sirve | Por defecto | Valores válidos | Impacto |
|---|---|---|---|---|---|
--codigo X |
LYMEN_ENROLAR |
Código de un solo uso. | — (obligatorio, salvo --verificar) |
Letras, números, _ y -. |
Vence a las 24 horas y se gasta al usarlo. |
--ingesta X |
LYMEN_INGESTA |
Dirección de Lymen. | — (obligatorio) | Host o host:puerto. | Si está mal, no se registra. |
--gateway X |
LYMEN_GATEWAY |
Gateway por donde sale. Repetible y en orden (por entorno, separados por coma). | Ninguno: sale directo. | Hasta 5, sin repetidos. | Permite instalar un servidor sin salida a internet; si un gateway cae, usa el siguiente. |
--gateway-huella G=H |
LYMEN_GATEWAY_HUELLA |
Huella del certificado de un gateway. Repetible. La reparte el portal. | Sin huella: se valida con las autoridades de confianza de Windows. | gateway= + 64 caracteres hexadecimales (SHA-256 del certificado). |
Seguridad. Con huella solo se acepta ese certificado. En Windows se usa la huella del certificado, no la de la clave pública: copiá el comando de la pestaña Windows. |
--gateway-tls |
— | Habla con los gateways por https. | Activo. | — | Comportamiento normal. |
--gateway-sin-tls |
LYMEN_GATEWAY_SIN_TLS=si |
Habla con los gateways por http, sin cifrar. | Apagado. | si, true o 1 por entorno. |
Seguridad. El token y los datos viajan en claro por tu red. |
--grupo X |
LYMEN_GRUPO |
Grupo de servidores. | Sin grupo. | Hasta 60 caracteres, sin comas, comillas, barra invertida, $ ni acento grave. |
Define la política de actualización y la etiqueta grupo. Si no existe, se crea. |
--verificar |
— | Revisa y termina. | Apagado. | — | No registra ni instala. |
| — | LYMEN_INSTRUMENTAR=si |
Instala además el paquete de monitoreo en detalle de aplicaciones. | no |
si |
No toca ninguna aplicación hasta que lo actives en el portal. Ver Instrumentación. |
Qué hace el instalador#
- Revisa el servidor y las opciones (y que PowerShell esté como administrador).
- Registra el servidor con el código. Prueba directo a Lymen y, si no hay salida, por el primer gateway que responda.
- Baja el paquete de la versión publicada y comprueba su suma de verificación (SHA-256).
- Deja el programa en
C:\Program Files\lymen-agenty la configuración y los datos enC:\ProgramData\lymen-agent. Esa carpeta de datos la pueden leer solo SYSTEM y los Administradores. - Guarda el token en las variables del servicio (no de la máquina), así ningún otro proceso lo hereda.
- Crea el servicio Agente de Lymen (
lymen-agent), de inicio automático, que corre como SYSTEM. Si se cae, Windows lo reinicia a los 5 segundos, a los 5 y a los 60. - Crea una tarea programada (
lymen-agent-actualizar) que cada hora pregunta si le toca actualizarse. Ver Grupos y actualización. - Si el servidor es gateway, crea en
C:\ProgramData\lymen-agent\permitidosla lista de chequeos internos permitidos, vacía. Solo los Administradores pueden modificarla. Ver Gateways.
Lo que el instalador de Windows no incluye#
- Monitoreo de equipos de red (SNMP, trampas, syslog, ping): hoy lo instala solo el instalador de Linux. Para monitorear equipos de red necesitás un gateway en Linux.
- El inventario de procesos, servicios y conexiones del servidor, que sí se instala en Linux.
Problemas comunes#
| Síntoma | Qué hacer |
|---|---|
| "abri PowerShell como administrador" | Cerrá la consola y abrila con clic derecho › Ejecutar como administrador. |
| El comando falla al bajar el script | Revisá la salida a internet o usá --gateway. El instalador fuerza TLS 1.2. |
| "el código no es válido, ya se usó o venció" | Generá un código nuevo en el portal. |
| "huella no válida" | Pegaste una huella con formato de Linux. Generá el comando de la pestaña Windows. |
| Instalado, pero no aparece | Esperá 2 minutos y revisá en services.msc que Agente de Lymen esté En ejecución. |
Para sacar el agente, mirá Desinstalar.