ProxMenux/web/messages/es/docs/post-install/updates.json

{
  "meta": {
    "title": "Aplicar actualizaciones disponibles — Optimizaciones post-instalación | Documentación de ProxMenux",
    "description": "Cómo ProxMenux detecta las nuevas versiones de optimizaciones post-instalación (Log2Ram, ajustes de memoria, límites del sistema, Logrotate, red…) y cómo aplicarlas desde el menú post-instalación o el panel de Monitor."
  },
  "header": {
    "title": "Aplicar actualizaciones disponibles",
    "description": "Cuando una optimización post-instalación (Log2Ram, Memory Settings, System Limits, Logrotate…) tiene en disco una versión más nueva que la registrada actualmente en el host, ProxMenux la muestra como una actualización disponible. Puedes aplicarla desde el menú Post-Install (lado Scripts) o desde el panel del Monitor — ambas rutas vuelven a ejecutar la misma función post-instalación y refrescan el registro.",
    "section": "Configuración post instalación de Proxmox"
  },
  "intro": {
    "title": "Qué es esto",
    "body": "Las optimizaciones post-instalación de ProxMenux están versionadas. Cada script en el repositorio lleva un número de versión (p. ej. <code>Log2ram SSD Protection v1.2</code>), y el host mantiene un registro de qué optimizaciones están activas y en qué versión en <code>/usr/local/share/proxmenux/installed_tools.json</code>. Cuando una release nueva de ProxMenux distribuye una versión actualizada de cualquier optimización, ProxMenux detecta la discrepancia y ofrece reaplicarla solo a esa — sin volver a ejecutar toda la post-instalación."
  },
  "why": {
    "heading": "Por qué existe",
    "body": "Las optimizaciones post-instalación reciben mejoras: ajustes de sysctl, límites Logrotate más estrictos, nuevas reglas para dimensionar Log2RAM o correcciones de casos límite. Sin esta vía había que repetir el script, que reaplica <em>todas</em> las optimizaciones, o renunciar a la mejora. Aplicar actualizaciones disponibles permite elegir individualmente solo las optimizaciones cuya versión ha cambiado."
  },
  "detection": {
    "heading": "Cómo se detectan las actualizaciones",
    "steps": [
      {
        "title": "Scripts versionados en disco",
        "body": "Cada función post-instalación declara su versión dentro del script (<code>scripts/post_install/auto_post_install.sh</code> y <code>scripts/post_install/customizable_post_install.sh</code>). Un escáner extrae estas versiones de la fuente en disco."
      },
      {
        "title": "Registro versionado en el host",
        "body": "Cuando el usuario aplicó cada optimización, la llamada <code>register_tool</code> correspondiente escribió la versión activa en <code>/usr/local/share/proxmenux/installed_tools.json</code>. Ese archivo es la fuente de verdad de \"qué está activo en este host ahora mismo\"."
      },
      {
        "title": "El Monitor compara ambos lados",
        "body": "En el arranque y cada 24h, el Monitor compara las versiones de disco contra las versiones del registro. Cualquier discrepancia produce una entrada en <code>/usr/local/share/proxmenux/updates_available.json</code>. Ese archivo alimenta tanto la entrada del menú Post-Install como la tarjeta del panel del Monitor."
      },
      {
        "title": "Una notificación por versión nueva",
        "body": "Cuando hay al menos una actualización pendiente, Monitor envía una única notificación agrupada, por ejemplo <em>«4 actualizaciones de optimizaciones de ProxMenux disponibles»</em>, con una línea por herramienta en formato <code>name (vX → vY)</code>, igual que para los paquetes Proxmox. Evita repeticiones diarias del mismo conjunto: solo una versión nueva o una nueva herramienta en la lista vuelve a activarla."
      }
    ]
  },
  "pathA": {
    "heading": "Ruta A — Desde el menú post-instalación",
    "intro": "Desde el menú principal de ProxMenux, abre <strong>Configuración post instalación de Proxmox</strong>. Si hay actualizaciones pendientes, aparece <strong>Aplicar actualizaciones disponibles (N)</strong> justo encima de <em>Desinstalar optimizaciones</em>. El número indica cuántas optimizaciones tienen una versión en disco más reciente que la registrada. Si todo está al día, la entrada se oculta.",
    "menuAlt": "Menú de scripts post-instalación con la entrada condicional Aplicar actualizaciones disponibles (N) encima de Desinstalar optimizaciones; el contador indica cuántas optimizaciones tienen una versión más nueva en disco",
    "menuCaption": "La entrada <em>Aplicar actualizaciones disponibles (N)</em> solo aparece cuando al menos una optimización tiene una actualización pendiente; se oculta si el host está al día.",
    "checklistBody": "Seleccionar la entrada abre un checklist con cada actualización pendiente, cada fila formateada como <code>name (vX → vY)</code>. Todas las filas están pre-marcadas por defecto; desmarca las que no quieras aplicar esta ronda.",
    "checklistAlt": "Diálogo Aplicar actualizaciones disponibles con una fila por optimización pendiente, su nombre y el cambio de versión (actual → disponible). Todas las filas están seleccionadas.",
    "checklistCaption": "Selección individual por optimización: elige qué versiones actualizar. El mismo motor de Automatizado y Personalizable vuelve a aplicar cada función en segundo plano y actualiza su versión en el registro."
  },
  "pathB": {
    "heading": "Ruta B — Desde el panel del Monitor",
    "intro": "Las mismas actualizaciones aparecen en Monitor, en <link>Ajustes → Optimizaciones de ProxMenux</link>. Si hay actualizaciones pendientes, la tarjeta muestra un <strong>contador de actualizaciones</strong> que abre el selector por optimización. Cada herramienta también ofrece su propia acción de actualización.",
    "imageAlt": "Tarjeta Optimizaciones de ProxMenux en los ajustes de Monitor, con un contador de actualizaciones pendientes que abre el selector por optimización y acciones de actualización por herramienta",
    "imageCaption": "La tarjeta Optimizaciones de Monitor permite acceder a las actualizaciones mediante su contador cuando hay una versión más nueva en disco, sin entrar en la shell."
  },
  "applying": {
    "heading": "Qué pasa cuando aplicas",
    "steps": [
      {
        "title": "Re-ejecuta la función post-instalación",
        "body": "La función de la optimización elegida se vuelve a ejecutar contra el host. Como cada función post-instalación es <strong>idempotente</strong>, volver a ejecutarla no duplica configuración — sobrescribe la versión anterior con la nueva (archivos sysctl, drop-ins, units de servicio, etc.)."
      },
      {
        "title": "Refresca el registro",
        "body": "La llamada <code>register_tool</code> dentro de la función escribe la versión nueva en <code>installed_tools.json</code>. El siguiente escaneo ya no ve discrepancia y la entrada de actualización desaparece tanto del menú como de la tarjeta del Monitor."
      },
      {
        "title": "Sin reinicio salvo que la función lo diga",
        "body": "La mayoría de las actualizaciones surten efecto inmediatamente. Las actualizaciones que tocan módulos del kernel, nombres de interfaz persistentes o VFIO muestran el mismo prompt de reinicio que una instalación recién hecha."
      },
      {
        "title": "Refresco del registro enviado al Monitor",
        "body": "Al terminar el lote, el menú envía una petición POST a <code>http://127.0.0.1:8008/api/updates/post-install/scan</code> para reconstruir <code>/usr/local/share/proxmenux/updates_available.json</code>. Tras aplicar todo lo pendiente, desaparecen el contador de actualizaciones de la tarjeta Optimizaciones y la entrada condicional de la shell, sin esperar al siguiente análisis. La tarjeta Optimizaciones sigue disponible."
      }
    ],
    "jqTitle": "jq es obligatorio",
    "jqBody": "La checklist de la Ruta A depende de <code>jq</code> para parsear el JSON de actualizaciones pendientes. Si <code>jq</code> no está, el flujo termina en silencio — verías la entrada del menú con contador pero al elegir filas no ocurriría nada. En cualquier instalación moderna de Proxmox <code>jq</code> está presente; si tienes dudas ejecuta <code>apt install -y jq</code>."
  },
  "differs": {
    "heading": "En qué se diferencia de las otras rutas",
    "headerPath": "Path",
    "headerScope": "Alcance",
    "headerWhen": "Cuándo tiene sentido",
    "rows": [
      {
        "pathLabel": "Automatizado",
        "pathHref": "/docs/post-install/automated",
        "scope": "Reaplica <em>cada</em> optimización del bundle.",
        "when": "Host recién instalado o reaplicación completa de la base de un nodo totalmente gestionado."
      },
      {
        "pathLabel": "Personalizable",
        "pathHref": "/docs/post-install/customizable",
        "scope": "Elige del catálogo completo.",
        "when": "Selecciona qué optimizaciones están activas en el host."
      },
      {
        "pathLabel": "Aplicar actualizaciones disponibles",
        "pathHref": null,
        "scope": "Solo las optimizaciones cuya versión ha subido en disco.",
        "when": "Mantén las optimizaciones ya instaladas al día sin tocar el resto."
      },
      {
        "pathLabel": "Desinstalar optimizaciones",
        "pathHref": "/docs/post-install/uninstall",
        "scope": "Revierte la optimización y elimina su entrada del registro.",
        "when": "Hacer rollback de un cambio específico."
      }
    ]
  },
  "notifTitle": "Filtro de notificación",
  "notifBody": "El evento que anuncia las actualizaciones pendientes es <em>Actualizaciones de optimizaciones de ProxMenux disponibles</em>. Se activa por defecto en todos los canales y se puede silenciar por canal en <link>Ajustes → Notificaciones</link>. Evita repeticiones: se envía una vez por conjunto distinto de actualizaciones pendientes, no en cada análisis de 24 horas."
}