# Instalar el agente en Windows

## 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](https://lymen.app/docs/instalacion/gateways/) de tu red que sí la tenga.

## Paso a paso

1. En el portal, andá a **Agregar datos › Agregar servidor** y generá el comando (ver [Agregar datos](https://lymen.app/docs/instalacion/agregar-datos/)).
2. Elegí la pestaña **Windows** y copialo.
3. Abrí **PowerShell como administrador** en el servidor y pegalo.
4. 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 produccion
```

Para 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](https://lymen.app/docs/instalacion/instrumentacion-aplicaciones/). |

## Qué hace el instalador

1. Revisa el servidor y las opciones (y que PowerShell esté como administrador).
2. Registra el servidor con el código. Prueba directo a Lymen y, si no hay salida, por el primer gateway que responda.
3. Baja el paquete de la versión publicada y comprueba su suma de verificación (SHA-256).
4. Deja el programa en `C:\Program Files\lymen-agent` y la configuración y los datos en `C:\ProgramData\lymen-agent`. Esa carpeta de datos la pueden leer solo SYSTEM y los Administradores.
5. Guarda el token en las variables del **servicio** (no de la máquina), así ningún otro proceso lo hereda.
6. 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.
7. Crea una tarea programada (`lymen-agent-actualizar`) que cada hora pregunta si le toca actualizarse. Ver [Grupos y actualización](https://lymen.app/docs/instalacion/grupos-y-actualizacion/).
8. Si el servidor es gateway, crea en `C:\ProgramData\lymen-agent\permitidos` la lista de chequeos internos permitidos, vacía. Solo los Administradores pueden modificarla. Ver [Gateways](https://lymen.app/docs/instalacion/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](https://lymen.app/docs/instalacion/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](https://lymen.app/docs/instalacion/desinstalar/).