mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 10:52:22 +00:00
Describe the post-install behaviour as the scripts run it
- The automated run can also ask to confirm the system update - Persistent NIC names, ZFS ARC reconcile and ARC policy match the code - Uninstall rewrites journald.conf with systemd defaults
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Script automatizado post-instalación | Documentación de ProxMenux",
|
||||
"description": "El script automatizado post-instalación de ProxMenux ejecuta un conjunto fijo de 14 optimizaciones adaptadas al hardware en un host Proxmox VE recién instalado. No ofrece una lista de funciones para elegir, pero puede pedir confirmación para ocultar el aviso de suscripción, instalar Log2RAM en ciertos casos y reiniciar. Los cambios reversibles se registran para restaurarlos después.",
|
||||
"description": "El script automatizado post-instalación de ProxMenux ejecuta un conjunto fijo de 14 optimizaciones adaptadas al hardware en un host Proxmox VE recién instalado. No ofrece una lista de funciones para elegir, pero puede pedir confirmación para la actualización del sistema, ocultar el aviso de suscripción, instalar Log2RAM en ciertos casos y reiniciar. Los cambios reversibles se registran para restaurarlos después.",
|
||||
"ogTitle": "Script automatizado post-instalación | Documentación de ProxMenux",
|
||||
"ogDescription": "14 optimizaciones fijas adaptadas al hardware para un host Proxmox VE nuevo, con confirmaciones para algunas acciones y registro de cambios reversibles."
|
||||
},
|
||||
|
||||
@@ -83,13 +83,13 @@
|
||||
"whyItems": [
|
||||
"Añadir o quitar dispositivos PCIe puede desplazar la numeración del bus, convirtiendo <code>enp3s0</code> en <code>enp4s0</code>. Si tu <code>/etc/network/interfaces</code> referencia el nombre antiguo, el bridge desaparece al reiniciar.",
|
||||
"Actualizaciones de BIOS / firmware a veces cambian cómo se enumeran los dispositivos, con el mismo efecto.",
|
||||
"El auxiliar fija los nombres de las NIC físicas, incluidos los puertos físicos de los bonds. Omite interfaces virtuales como veth de LXC y los propios dispositivos bond; no corrige carreras de nombres de NIC virtuales <code>hotplug</code>."
|
||||
"El auxiliar escribe archivos <code>.link</code> para las NIC físicas, incluidos los puertos de los bonds, con la MAC que muestra sysfs en ese momento; en los puertos de un bond puede ser la MAC compartida del bond, así que comprueba sus nombres tras reiniciar. Omite interfaces virtuales como veth de LXC y los propios dispositivos bond; no corrige carreras de nombres de NIC virtuales <code>hotplug</code>."
|
||||
],
|
||||
"writtenTitle": "Qué se escribe",
|
||||
"writtenIntro": "Un archivo por NIC física, en <code>/etc/systemd/network/10-proxmenux-<iface>.link</code>. Cada archivo comienza con la cabecera <code># Managed by ProxMenux — do not edit</code>, marca que permite a ProxMenux distinguir sus propios archivos de los <code>.link</code> provistos por el usuario o por otros paquetes.",
|
||||
"writtenOutro": "Los archivos <code>.link</code> de otros paquetes o escritos a mano por el usuario se dejan intactos — solo se gestionan los archivos que llevan la cabecera de ProxMenux. En cada nueva ejecución la función reconcilia su propio conjunto: relee <code>MACAddress=</code> de cada <code>10-proxmenux-*.link</code> y elimina los cuya MAC ya no aparece en <code>/sys/class/net/</code>. Los archivos escritos por una versión antigua de ProxMenux en el formato <code>10-<iface>.link</code> se migran automáticamente en la primera ejecución.",
|
||||
"pveTitle": "PVE 9 vs PVE 8",
|
||||
"pveBody": "El script utiliza archivos <code>.link</code> de systemd para los nombres persistentes. En Proxmox VE 9 también recarga las reglas udev al escribirlos, para que las NIC nuevas las apliquen sin reiniciar. Comprueba las interfaces existentes tras reiniciar tanto en PVE 8 como en PVE 9. Esto no sustituye <code>ifupdown2</code> en el host. El script marca el reinicio como necesario en ambos casos para que la post-instalación personalizable lo solicite.",
|
||||
"pveBody": "El script utiliza archivos <code>.link</code> de systemd para los nombres persistentes. En Proxmox VE 9 también recarga las reglas udev al escribirlos, para que una NIC ya fijada que se vuelva a conectar o detectar aplique su regla sin reiniciar. Comprueba las interfaces existentes tras reiniciar tanto en PVE 8 como en PVE 9. Esto no sustituye <code>ifupdown2</code> en el host. El script marca el reinicio como necesario en ambos casos para que la post-instalación personalizable lo solicite.",
|
||||
"reviewTitle": "Revisa antes el /etc/network/interfaces existente",
|
||||
"reviewBody": "Si tu host tiene configuración legacy en <code>/etc/network/interfaces</code> que referencia nombres de NIC generados por el esquema por defecto del kernel, fijar los nombres <em>de hoy</em> es exactamente lo que quieres. Pero si ya has customizado manualmente la configuración alrededor de nombres específicos, comprueba dos veces que el pinning coincide con lo que el archivo interfaces espera antes de reiniciar.",
|
||||
"revertTitle": "Reversible desde el menú Desinstalar",
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
"trackedBody": "Cada una de estas opciones registra un tool en <code>installed_tools.json</code>, así que aparecen en <link>Desinstalar optimizaciones</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.",
|
||||
"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 esa misma política de forma explícita (RAM/10, con un máximo de 16 GiB y un mínimo de 64 MiB) en su propio archivo, lo que cubre también hosts antiguos o actualizados. 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",
|
||||
@@ -41,7 +41,7 @@
|
||||
"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.",
|
||||
"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 de ellos los valores <code>zfs_arc_min</code> / <code>zfs_arc_max</code> en conflicto (el resto de opciones de esas líneas se conserva), para que solo el archivo ARC de ProxMenux fije el límite. 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",
|
||||
|
||||
@@ -103,7 +103,7 @@
|
||||
"heading": "Verificación",
|
||||
"intro": "Tras aplicar las optimizaciones de Sistema:",
|
||||
"tipTitle": "Restauración y limitaciones",
|
||||
"tipBody": "Las seis opciones se registran en <code>installed_tools.json</code> y aparecen en <link>Desinstalar optimizaciones</link>. La restauración elimina archivos de configuración, unidad y alias kexec, y restaura journald/logrotate. Algunos límites activos requieren otra sesión o reinicio. La limpieza de /root/.profile solo elimina el antiguo ulimit -n 256000; el actual ulimit -n 1048576 puede permanecer y requerir eliminación manual."
|
||||
"tipBody": "Las seis opciones se registran en <code>installed_tools.json</code> y aparecen en <link>Desinstalar optimizaciones</link>. La restauración elimina los archivos de configuración, la unidad y el alias de kexec, reescribe journald.conf con los valores predeterminados de systemd y restaura logrotate.conf desde su backup. Algunos límites activos requieren otra sesión o reinicio."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Relacionado",
|
||||
|
||||
Reference in New Issue
Block a user