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

{
  "meta": {
    "title": "Post-instalación: Almacenamiento | Documentación de ProxMenux",
    "description": "Optimizaciones de almacenamiento en el script post-instalación Customizable de ProxMenux: dimensionado del ARC de ZFS basado en la RAM del host, zfs-auto-snapshot para snapshots periódicas, y eliminación de los límites de velocidad de backups vzdump."
  },
  "header": {
    "title": "Post-instalación: Almacenamiento",
    "section": "Configuración post instalación de Proxmox"
  },
  "intro": {
    "title": "Qué cubre esta categoría",
    "body": "Cuatro optimizaciones relacionadas con almacenamiento: tunear el tamaño de la caché <strong>ARC de ZFS</strong> a una fracción sensata de la RAM del host, instalar y programar <strong>auto-snapshots de ZFS</strong>, activar <strong>autotrim de ZFS</strong> en pools SSD/NVMe y eliminar throttles de <strong>vzdump</strong> para que los backups corran a máxima velocidad. Las cuatro son independientes — elige las que se ajusten a tu setup. Una quinta optimización cercana al almacenamiento, <link>Log2RAM</link>, reduce el desgaste del SSD/NVMe moviendo <code>/var/log</code> a una ramdisk — vive en la página Optional porque el menú Personalizable de ProxMenux la agrupa allí."
  },
  "trackedTitle": "Las cuatro se registran en el menú Desinstalar",
  "trackedBody": "Cada una de estas opciones registra un tool en <code>installed_tools.json</code>, así que aparecen en <link>Uninstall Optimizations</link>. Revertir <code>zfs_arc</code> elimina <code>/etc/modprobe.d/99-zfsarc.conf</code> y reconstruye initramfs; <code>zfs_auto_snapshot</code> revierte la programación cron y ofrece purgar el paquete; <code>zfs_autotrim</code> pone <code>autotrim=off</code> en los pools que activó; <code>vzdump_speed</code> restaura <code>/etc/vzdump.conf</code> desde el <code>.bak</code> que la instalación creó.",
  "arc": {
    "heading": "Optimizar el tamaño del ARC de ZFS",
    "intro": "La <strong>Adaptive Replacement Cache (ARC)</strong> es la caché de lectura en memoria de ZFS. Las instalaciones Proxmox VE desde 8.1 fijan un límite del 10% de RAM, con máximo 16 GiB; hosts antiguos o actualizados pueden diferir. Esta opción escribe su propio límite según la RAM. Revisa ajustes y carga: una caché menor no siempre es más rápida.",
    "sizingTitle": "Reglas de dimensionado",
    "headerRam": "RAM del host",
    "headerMax": "Límite del ARC",
    "rows": [
      {
        "ram": "Fórmula",
        "max": "RAM / 10, tope de 16 GiB, mínimo 64 MiB"
      },
      {
        "ram": "Host de 8 GB",
        "max": "≈ 819 MiB (RAM/10)"
      },
      {
        "ram": "Host de 16 GB",
        "max": "≈ 1,6 GiB (RAM/10)"
      },
      {
        "ram": "Host de 64 GB",
        "max": "≈ 6,4 GiB (RAM/10)"
      },
      {
        "ram": "Host ≥ 160 GB",
        "max": "16 GiB (tope)"
      }
    ],
    "after": "El archivo <code>/etc/modprobe.d/99-zfsarc.conf</code> contiene solo <code>options zfs zfs_arc_max=…</code>. Esta opción no ajusta otros parámetros ZFS (<code>zfs_arc_min</code>, lectura anticipada/límite de escritura L2ARC, tiempo de espera TXG). Antes busca otros <code>*.conf</code> en <code>/etc/modprobe.d/</code> que definan <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, los copia con un manifiesto a <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> y elimina las líneas en conflicto para que solo quede activo el archivo ARC de ProxMenux. Después ejecuta <code>update-initramfs -u -k all</code> y, si procede, <code>proxmox-boot-tool refresh</code> para incorporar el límite al initramfs de los sistemas con raíz ZFS.",
    "rebootTitle": "Requiere reinicio para surtir efecto",
    "rebootBody": "Los ajustes del ARC se leen cuando se carga el módulo del kernel <code>zfs</code>. Para que el cap se aplique en hosts ZFS-on-root, ProxMenux regenera el initramfs con <code>update-initramfs -u -k all</code> y, cuando corresponde, refresca el cargador de arranque con <code>proxmox-boot-tool refresh</code>. Un reinicio sigue siendo necesario para que el módulo relea el parámetro; el flag de \"se requiere reinicio\" se activa automáticamente.",
    "safeTitle": "Seguro en hosts sin ZFS",
    "safeBody": "La función solo escribe la configuración cuando <code>zpool list</code> reporta al menos un pool ZFS importado. En hosts Proxmox solo ext4 / LVM, o en máquinas con las utilidades ZFS instaladas pero sin ningún pool importado, marcar esta opción es un no-op — no se escribe nada.",
    "verifyTitle": "Verificación y reversión manual"
  },
  "autoSnap": {
    "heading": "Instalar ZFS auto-snapshot",
    "intro": "Instala el paquete <a>zfs-auto-snapshot</a> y reescribe sus schedules cron para que se tomen snapshots automáticamente en varios intervalos. Una gran red de seguridad sin esfuerzo encima de tus backups regulares con vzdump.",
    "cadenceTitle": "Cadencia de snapshots que configura ProxMenux",
    "headerLabel": "Etiqueta",
    "headerRuns": "Cuándo se ejecuta",
    "headerKept": "Snapshots conservadas",
    "rows": [
      {
        "label": "frecuentes",
        "runs": "cada 15 min",
        "kept": "4"
      },
      {
        "label": "horaria",
        "runs": "cada hora",
        "kept": "1"
      },
      {
        "label": "diario",
        "runs": "una vez al día",
        "kept": "1"
      },
      {
        "label": "semanales",
        "runs": "una vez por semana",
        "kept": "1"
      },
      {
        "label": "mensual",
        "runs": "una vez al mes",
        "kept": "1"
      }
    ],
    "conservativeTitle": "Conteos de retención conservadores",
    "conservativeBody": "ProxMenux viene con una retención conservadora (solo 4 frequent + 1 de cada intervalo más largo) para que el almacenamiento de snapshots de ZFS no se infle. Si quieres una retención mayor, edita los números en <code>/etc/cron.d/zfs-auto-snapshot</code>, <code>/etc/cron.hourly/zfs-auto-snapshot</code>, etc. después de ejecutar el script.",
    "onlyZfsTitle": "Solo útil en pools ZFS",
    "onlyZfsBody": "Instalar el paquete en un host solo ext4 es inofensivo pero inútil — no hay datasets ZFS de los que tomar snapshot. Sáltate esta opción si no usas ZFS.",
    "verifyTitle": "Verificación y reversión manual"
  },
  "autotrim": {
    "heading": "Activar ZFS autotrim (pools SSD/NVMe)",
    "intro": "Activa <code>autotrim</code> en pools ZFS formados exclusivamente por SSD o NVMe compatibles con TRIM. El script omite por precaución los pools con algún dispositivo rotacional. Conserva los pools que ya tenían <code>autotrim=on</code>.",
    "trimTitle": "Qué hace TRIM, y por qué importa en ZFS",
    "trimBody1": "Las SSDs / NVMe gestionan el almacenamiento interno en erase blocks de tamaño fijo que son mucho mayores que los sectores lógicos con los que habla el sistema de archivos. Cuando un sistema de archivos borra un archivo, el disco no lo sabe — sigue pensando que esos sectores están en uso, así que su garbage collector interno sigue moviendo datos obsoletos para liberar nuevos erase blocks. <strong>TRIM</strong> es el comando estándar que el SO usa para decirle al disco \"estos sectores ya están libres, puedes borrarlos por adelantado\".",
    "trimBody2": "Sin TRIM, el rendimiento de la SSD se degrada con el tiempo a medida que el disco se queda sin bloques pre-borrados y tiene que hacer erase-on-write, y la amplificación de escritura aumenta — ambas cosas acortan la vida útil del disco. Con TRIM activado, el disco puede mantener un pool saludable de bloques vacíos listos para escribir.",
    "trimBody3": "Con <code>autotrim=on</code>, ZFS aplica TRIM en segundo plano al espacio liberado recientemente, agrupando rangos. Otra opción es <code>zpool trim &lt;pool&gt;</code> periódico. Autotrim evita otra programación, pero su impacto depende del dispositivo; el TRIM manual periódico puede ir mejor en algunas unidades modestas.",
    "practicalTitle": "¿Por qué es práctico activarlo?",
    "practicalItems": [
      "<strong>Rendimiento de escritura sostenido.</strong> TRIM puede ayudar al disco a recuperar bloques sin uso. El beneficio y el impacto en latencia dependen del dispositivo y la carga.",
      "<strong>Vida útil del disco.</strong> Evitar copias internas innecesarias puede reducir la amplificación de escritura y el desgaste NAND. No garantiza una cantidad concreta de vida adicional.",
      "<strong>Sin cron programado que recordar.</strong> A diferencia de un <code>zpool trim</code> periódico, autotrim es fire-and-forget — el pool lo maneja por su cuenta."
    ],
    "whenTitle": "¿Cuándo es necesario?",
    "whenIntro1": "<strong>Considera activarlo</strong> en pools ZFS solo con SSD/NVMe compatibles con TRIM. Comprueba el comportamiento y la latencia; algunos equipos funcionan mejor con TRIM manual programado.",
    "whenIntro2": "<strong>El script se lo salta automáticamente</strong> en:",
    "whenSkipItems": [
      "Pools con algún vdev HDD rotacional: un filtro conservador de hardware del script.",
      "Discos sin <code>discard_granularity</code> expuesto en sysfs — normalmente SSDs viejas sin TRIM, o rutas pass-through donde el SO no puede ver el dispositivo subyacente.",
      "Pools donde ZFS mismo reporta la propiedad como no soportada (raro; pools muy antiguos).",
      "Pools ya configurados con <code>autotrim=on</code> (no-op)."
    ],
    "whenIntro3": "<strong>No relevante en hosts solo ext4</strong> — no hay nada que ZFS pueda trimear. La función sale con un mensaje amistoso en ese caso.",
    "recordedTitle": "Por qué solo se registran los pools que ProxMenux cambió",
    "recordedBody": "La función solo escribe un pool en su archivo de estado interno (<code>/usr/local/share/proxmenux/zfs_autotrim_pools</code>) cuando ha cambiado activamente ese pool de <code>off</code> a <code>on</code>. Los pools que ya tenías con autotrim antes de ejecutar el script se dejan fuera de la lista, para que un futuro Uninstall no apague ajustes que tú mismo configuraste — solo se revierten los cambios propios de ProxMenux.",
    "manualTitle": "Equivalente manual (ejecuta en tu servidor)",
    "manualIntro": "La secuencia completa que el script ejecuta contra cada pool es replicable a mano. Esto es lo que escribirías si quisieras hacer lo mismo en un solo pool sin ProxMenux:",
    "verifyTitle": "Verificación y reversión manual",
    "oneShotTitle": "¿Necesitas un trim puntual en lugar de continuo?",
    "oneShotBody": "Algunos operadores prefieren un trim manual durante horas de baja carga en lugar de actividad de trim continua. Desactiva autotrim y programa un cron que ejecute <code>zpool trim &lt;pool&gt;</code> — mismo objetivo final, distinta cadencia."
  },
  "vzdump": {
    "heading": "Aumentar la velocidad de backup de vzdump",
    "intro": "Escribe bwlimit: 0 e ionice: 5 en la configuración global de vzdump. Proxmox ya usa ancho de banda sin límite por defecto: solo elimina un límite si estaba configurado. Frente al ionice: 7 predeterminado, 5 da mayor prioridad de E/S de mejor esfuerzo cuando el planificador la respeta. Puede afectar a los huéspedes y no garantiza backups más rápidos.",
    "changedTitle": "Qué se cambia en /etc/vzdump.conf",
    "backupTitle": "La primera ejecución crea un .bak de vzdump.conf",
    "backupBody": "La primera vez que se ejecuta esta opción, ProxMenux copia <code>/etc/vzdump.conf</code> a <code>/etc/vzdump.conf.bak</code> antes de tocarlo. Las ejecuciones siguientes reutilizan ese backup y no lo sobrescriben, para que una configuración editada a mano previa a la primera aplicación se pueda recuperar. Los cambios sobre <code>bwlimit</code> y <code>ionice</code> se hacen con <code>sed</code>, y cualquier otra opción del fichero (compress, pigz, tmpdir, exclude-path, etc.) se preserva.",
    "skipTitle": "Cuándo saltárselo",
    "skipBody": "En un host con almacenamiento local lento y VMs sensibles a la latencia, quitar el cap de ancho de banda puede causar ralentizaciones notables durante los backups. Si previamente has puesto un <code>bwlimit</code> específico por esa razón, mantenlo — sáltate esta opción.",
    "verifyTitle": "Verificación y reversión manual"
  },
  "related": {
    "heading": "Relacionado",
    "items": [
      {
        "label": "Comandos de gestión de ZFS",
        "href": "/docs/help-info/zfs-commands",
        "tail": " — referencia zpool / zfs para ARC, snapshots, scrub."
      },
      {
        "label": "Comandos de almacenamiento y discos",
        "href": "/docs/help-info/storage-commands",
        "tail": " — referencia genérica de dispositivos de bloque y almacenamiento Proxmox."
      },
      {
        "label": "Comandos de backup y restauración",
        "href": "/docs/help-info/backup-commands",
        "tail": " — referencia de la CLI de vzdump para ancho de banda y prioridad de E/S."
      },
      {
        "label": "Desinstalar optimizaciones",
        "href": "/docs/post-install/uninstall",
        "tail": " — revierte cambios de ARC / vzdump."
      },
      {
        "label": "Log2RAM",
        "href": "/docs/post-install/optional#log2ram",
        "tail": " — reduce el desgaste del SSD/NVMe usando una ramdisk para /var/log; documentado en Optional."
      },
      {
        "label": "Post-instalación personalizable",
        "href": "/docs/post-install/customizable",
        "tail": " — volver al menú padre."
      }
    ]
  }
}