# Grupos de servidores y actualización del agente

## Para qué sirve

El agente se **actualiza solo**, para que no tengas que entrar servidor por servidor. Esta página explica cómo controlar ese proceso y cómo usar **grupos** para tratar distinto a los servidores de producción, de pruebas o de cada sucursal.

Un **grupo** reúne servidores con la misma política de actualización. Además funciona como la etiqueta `grupo` en filtros, reglas y dashboards. Todo se configura desde el portal.

## Cuándo usarlo

- Querés que producción se actualice de madrugada y pruebas apenas salga una versión nueva.
- Querés frenar un servidor crítico en una versión que ya validaste.
- Querés actualizar a mano, ahora, todo un conjunto de servidores.
- Querés filtrar reglas o dashboards por sucursal o ambiente.

## Grupos

Cada servidor está en **un solo grupo** (o en ninguno). Se asigna al instalar, en **Grupo (opcional)** del diálogo **Agregar servidor**, o después, en el detalle del servidor, sección **Agente › Grupo** (y **Guardar**).

Los grupos se administran en **Configuración › Conexiones › Agregar datos**, tarjeta **Grupos de servidores**: **Nuevo grupo** crea uno y **Ver grupos** abre la lista. Cada fila muestra el nombre, la descripción, el resumen de su política y cuántos servidores tiene (cuántos *al día*, *por actualizar*, *actualizando* y *con problemas*), con los botones **Actualizar grupo** y **Editar**.

### Campos de un grupo

| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto de cambiarlo |
|---|---|---|---|---|
| **Nombre** | Identifica el grupo; también es el valor de la etiqueta `grupo`. | — (obligatorio) | Hasta 60 caracteres, sin comas, comillas, barra invertida, `$` ni acento grave. Hasta 100 grupos. | Cambiarlo cambia la etiqueta que usan tus filtros y reglas: revisalos. |
| **Descripción (opcional)** | Para reconocerlo. | Vacía | Hasta 200 caracteres. | Ninguno. |
| **Actualización de sus servidores** | La política del grupo. Ver más abajo. | Sin política propia: usa la de Lymen (se actualiza solo, canal estable). | — | Afecta a **todos** los servidores del grupo que no fijen su propia política. |

Un grupo también puede fijar **qué logs reciben sus servidores** (solo errores, advertencias, todo o ninguno). Eso no se edita acá sino en **Observar › Infraestructura › Qué logs recibir**: ver [Qué logs recibir](https://lymen.app/docs/instalacion/servidores-infraestructura/#que-logs-recibir).

Para **borrar** un grupo, abrilo con **Editar** y tocá **Borrar grupo**. Sus servidores quedan sin grupo (pierden la etiqueta `grupo`) y conservan su política propia. No se actualiza ni se quita ningún servidor.

## La política de actualización

Se define en el grupo (**Editar › Actualización de sus servidores**) o en un servidor puntual (detalle del servidor, sección **Actualización del agente**). Cada campo puede quedar en **"Igual que el grupo"** (o "Igual que Lymen", si es la política de un grupo). Se hereda campo por campo: servidor, después grupo, después la base de Lymen.

| Campo | Para qué sirve | Por defecto (base de Lymen) | Valores válidos | Impacto de cambiarlo |
|---|---|---|---|---|
| **Actualizar el agente solo** | Si el agente se actualiza sin que hagas nada. | Sí | *Igual que…*, *Sí, se actualiza solo*, *No, lo actualizo yo* | En *No*, el servidor se queda en su versión hasta que lo actualices a mano. Un agente viejo puede perder correcciones de seguridad y funciones nuevas. |
| **Canal** | Qué versiones recibe. | Estable | *Estable*, *Anticipado* | *Estable* recibe versiones ya probadas. *Anticipado* recibe las nuevas antes: más novedades, más riesgo. Si un servidor tiene versión anticipada y su política es *estable*, el sistema le va a pedir que vuelva a la estable; el portal lo avisa. |
| **Ventana de actualización** | Horario en el que se permite actualizar. | Todos los días de 01:00 a 05:00, en la hora de tu cuenta | *Igual que…* o *Una ventana propia*: **Desde**, **Hasta** (HH:MM) y **Días de la ventana** | Fuera de la ventana, la actualización espera. La ventana no puede empezar y terminar a la misma hora y tiene que tener al menos un día. Si cruza medianoche (por ejemplo 22:00 a 04:00), funciona igual. |
| **Versión fija** | Congela el agente en una versión. | Ninguna: sigue al canal | *Ninguna* o una versión disponible | El agente se queda (o vuelve) en esa versión y **no sigue al canal**. Útil para validar antes de actualizar; riesgoso si te olvidás de soltarla. |

En un servidor, la política se guarda recién cuando tocás **Guardar** en la barra de abajo de la pantalla; en un grupo, al guardar el diálogo.

### Cómo se actualiza: tandas y vuelta atrás

Lymen no actualiza todo junto:

1. **Primera tanda chica**: el 10 % de los servidores, con un mínimo de 1 y un máximo de 5. Van primero los servidores que menos afectan si algo falla (los que no son gateway ni dependen de uno).
2. Si la primera tanda **vuelve sana**, sigue el resto.
3. Los **gateways se actualizan de a uno**, y antes que los servidores que dependen de ellos.
4. Si un agente **no vuelve sano en unos 10 minutos**, vuelve solo a la versión anterior y se **frena la versión**: durante 7 días no se instala sola en los demás (salvo que la pidas a mano), o hasta que haya una nueva.

### Estados que vas a ver

| Estado | Qué significa |
|---|---|
| **Al día** | Tiene la última versión de su canal. |
| **Versión fija** | Se queda en la versión que fijaste. |
| **Actualización pendiente** | Le toca actualizarse; el motivo de la espera aparece abajo (esperando la ventana, otro gateway, etc.). |
| **Espera su turno** | Espera a que la primera tanda salga bien. |
| **Actualizando…** | En curso. Si no vuelve sano en unos minutos, vuelve solo. |
| **Volvió a la versión anterior** | La nueva no funcionó en este servidor. No se reintenta sola. |
| **Versión frenada** | La versión se frenó porque falló en otro servidor. |
| **Sin versión para este sistema** | No hay un paquete publicado para ese sistema. |
| **Actualización apagada** | La política tiene *No, lo actualizo yo*. |
| **Sin datos de versión** | Todavía no se sabe qué versión tiene (por ejemplo, recién instalado). |

## Acciones manuales

| Acción | Dónde | Qué hace | Cuidado |
|---|---|---|---|
| **Actualizar ahora** | Detalle del servidor | Actualiza ya, sin esperar la ventana. Podés elegir la versión. | Saltea tu ventana: elegila con cuidado en servidores críticos. Si no vuelve sano, vuelve solo a la anterior. |
| **Cancelar la actualización** | Detalle del servidor | Cancela una actualización pendiente o en espera. | Solo vale antes de que se entregue al servidor. |
| **Volver a la versión X** | Detalle del servidor | Regresa a la versión anterior y **la deja fija**. | Para que vuelva a seguir al canal, sacá la versión fija. |
| **Actualizar grupo** | Agregar datos › Grupos de servidores › Ver grupos | Actualiza los servidores conectados y atrasados del grupo, por tandas. | Respeta el orden de gateways y se frena si algo falla. |

## Ejemplos

- **Producción prudente**: grupo `produccion`, canal *Estable*, ventana propia domingos de 02:00 a 05:00.
- **Pruebas adelantadas**: grupo `pruebas`, canal *Anticipado*, ventana todos los días. Si algo sale mal, pasa ahí primero.
- **Servidor validado**: en el servidor, *Versión fija* en la versión que probaste.

## Problemas comunes

| Síntoma | Qué hacer |
|---|---|
| "Versión anticipada con política estable" | El servidor tiene una versión anticipada pero su política es estable. Pasalo al canal anticipado o fijá la versión para que se quede. |
| La actualización no arranca | Mirá la línea de estado: puede estar esperando la ventana (el portal muestra cuándo abre) o a otro gateway. |
| "Ya hay una actualización en curso" | Esperá a que termine o cancelala si todavía no se entregó. |
| "La versión X se frenó" | Falló en otro servidor; esperá una versión nueva o actualizá a mano un servidor de prueba con **Actualizar ahora**. |
| El botón "Actualizar ahora" no aparece | El servidor ya tiene la versión que le toca, o hay una actualización en marcha. |