Grupos de servidores y actualización del agente
Cómo agrupar servidores, y cómo controlar cuándo, cómo y a qué versión se actualiza el agente (política, canal, ventana y versión fija).
En esta página
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.
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:
- 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).
- Si la primera tanda vuelve sana, sigue el resto.
- Los gateways se actualizan de a uno, y antes que los servidores que dependen de ellos.
- 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. |