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:
MacRimi
2026-10-18 13:57:26 +02:00
parent 85bea617d6
commit d3da2da48c
32 changed files with 48 additions and 48 deletions
@@ -1,7 +1,7 @@
{
"meta": {
"title": "Script post-installazione automatizzato | Documentazione ProxMenux",
"description": "Lo script post-installazione automatizzato ProxMenux esegue 14 ottimizzazioni predefinite in base all’hardware su un nuovo host Proxmox VE. Non presenta una lista di funzioni da selezionare, ma può chiedere conferma per rimuovere l’avviso di abbonamento, alcune installazioni Log2RAM e il riavvio. Le modifiche reversibili vengono registrate.",
"description": "Lo script post-installazione automatizzato ProxMenux esegue 14 ottimizzazioni predefinite in base all’hardware su un nuovo host Proxmox VE. Non presenta una lista di funzioni da selezionare, ma può chiedere conferma per l’aggiornamento del sistema, la rimozione dell’avviso di abbonamento, alcune installazioni Log2RAM e il riavvio. Le modifiche reversibili vengono registrate.",
"ogTitle": "Script post-installazione automatizzato | Documentazione ProxMenux",
"ogDescription": "14 ottimizzazioni predefinite in base all’hardware per un nuovo host Proxmox VE, con conferme per alcune azioni e registrazione delle modifiche reversibili."
},
@@ -83,13 +83,13 @@
"whyItems": [
"Aggiungere o rimuovere dispositivi PCIe può cambiare la numerazione del bus, trasformando <code>enp3s0</code> in <code>enp4s0</code>. Se <code>/etc/network/interfaces</code> fa riferimento al vecchio nome, il bridge scompare al riavvio.",
"Gli aggiornamenti BIOS o firmware a volte cambiano l’enumerazione dei dispositivi, con lo stesso effetto.",
"Lo script fissa i nomi delle schede fisiche, incluse le porte fisiche usate dai bond. Salta le interfacce virtuali, come veth LXC e i dispositivi bond stessi; non risolve le condizioni di gara nei nomi delle schede virtuali <code>hotplug</code>."
"Lo script scrive file <code>.link</code> per le schede fisiche, incluse le porte dei bond, con il MAC riportato da sysfs in quel momento; per le porte di un bond può essere il MAC condiviso del bond, quindi controllane i nomi dopo un riavvio. Salta le interfacce virtuali, come veth LXC e i dispositivi bond stessi; non risolve le condizioni di gara nei nomi delle schede virtuali <code>hotplug</code>."
],
"writtenTitle": "Cosa si scrive",
"writtenIntro": "Un file per NIC fisico, a <code>/etc/systemd/network/10-proxmenux-&lt;iface&gt;.link</code>. Ogni file inizia con l'intestazione <code># Managed by ProxMenux — do not edit</code> così ProxMenux può distinguere i propri file da file <code>.link</code> forniti dall'utente o dal pacchetto.",
"writtenOutro": "I file <code>.link</code> di altri pacchetti o scritti dall’utente vengono conservati; sono gestiti solo quelli con l’intestazione ProxMenux. A ogni esecuzione successiva la funzione verifica i propri file: rilegge <code>MACAddress=</code> da ogni <code>10-proxmenux-*.link</code> ed elimina quelli la cui MAC non compare più in <code>/sys/class/net/</code>. I file delle versioni precedenti nel formato <code>10-&lt;iface&gt;.link</code> vengono migrati automaticamente la prima volta.",
"pveTitle": "PVE 9 vs PVE 8",
"pveBody": "Lo script usa file systemd <code>.link</code> per i nomi persistenti. Su Proxmox VE 9 ricarica anche le regole udev dopo la scrittura, affinché le nuove schede possano usarle senza riavvio. Controlla le interfacce esistenti dopo un riavvio sia su PVE 8 sia su PVE 9. Questo non sostituisce <code>ifupdown2</code> sull’host. In entrambi i casi lo script segnala la necessità di riavvio alla post-installazione personalizzabile.",
"pveBody": "Lo script usa file systemd <code>.link</code> per i nomi persistenti. Su Proxmox VE 9 ricarica anche le regole udev dopo la scrittura, affinché una scheda già fissata che viene ricollegata o rilevata di nuovo applichi la sua regola senza riavvio. Controlla le interfacce esistenti dopo un riavvio sia su PVE 8 sia su PVE 9. Questo non sostituisce <code>ifupdown2</code> sull’host. In entrambi i casi lo script segnala la necessità di riavvio alla post-installazione personalizzabile.",
"reviewTitle": "Controlla prima il file /etc/network/interfaces esistente",
"reviewBody": "Se la configurazione precedente in <code>/etc/network/interfaces</code> usa nomi delle schede generati dal kernel, fissare quelli <em>attuali</em> è il risultato voluto. Se hai già adattato manualmente la configurazione a nomi specifici, verifica prima del riavvio che i nomi fissati corrispondano al file interfaces.",
"revertTitle": "Reversibile dal menu Disinstalla",
@@ -15,7 +15,7 @@
"trackedBody": "Ogni opzione si registra in <code>installed_tools.json</code> per <link>Disinstalla ottimizzazioni</link>. <code>zfs_arc</code> rimuove <code>/etc/modprobe.d/99-zfsarc.conf</code> e ricrea initramfs; <code>zfs_auto_snapshot</code> annulla la pianificazione cron e offre la rimozione completa del pacchetto; <code>zfs_autotrim</code> imposta <code>autotrim=off</code> sui pool che ha abilitato; <code>vzdump_speed</code> ripristina <code>/etc/vzdump.conf</code> dal <code>.bak</code> creato all’installazione.",
"arc": {
"heading": "Ottimizza dimensione ZFS ARC",
"intro": "La <strong>Adaptive Replacement Cache (ARC)</strong> è la cache di lettura ZFS in RAM. Le installazioni Proxmox VE dalla 8.1 impostano il 10% di RAM, massimo 16 GiB; host precedenti o aggiornati possono differire. Questa opzione scrive un proprio limite in base alla RAM. Controlla impostazioni e carico: una cache più piccola non è sempre più veloce.",
"intro": "La <strong>Adaptive Replacement Cache (ARC)</strong> è la cache di lettura ZFS in RAM. Le installazioni Proxmox VE dalla 8.1 impostano il 10% di RAM, massimo 16 GiB; host precedenti o aggiornati possono differire. Questa opzione scrive esplicitamente la stessa regola (RAM/10, massimo 16 GiB, minimo 64 MiB) in un proprio file, coprendo anche host precedenti o aggiornati. Controlla impostazioni e carico: una cache più piccola non è sempre più veloce.",
"sizingTitle": "Regole di dimensionamento",
"headerRam": "RAM dell'host",
"headerMax": "Limite ARC",
@@ -41,7 +41,7 @@
"max": "16 GiB (limite)"
}
],
"after": "Il file <code>/etc/modprobe.d/99-zfsarc.conf</code> contiene solo <code>options zfs zfs_arc_max=…</code>. Gli altri parametri ZFS (<code>zfs_arc_min</code>, prelettura/limite scritture L2ARC, timeout TXG) non vengono regolati. Prima, una verifica cerca altri <code>*.conf</code> in <code>/etc/modprobe.d/</code> che impostano <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, li salva con manifesto in <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> ed elimina le righe in conflitto, lasciando attivo solo il file ARC ProxMenux. Poi <code>update-initramfs -u -k all</code> e, se necessario, <code>proxmox-boot-tool refresh</code> portano il limite nell’initramfs dei sistemi con root ZFS.",
"after": "Il file <code>/etc/modprobe.d/99-zfsarc.conf</code> contiene solo <code>options zfs zfs_arc_max=…</code>. Gli altri parametri ZFS (<code>zfs_arc_min</code>, prelettura/limite scritture L2ARC, timeout TXG) non vengono regolati. Prima, una verifica cerca altri <code>*.conf</code> in <code>/etc/modprobe.d/</code> che impostano <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, li salva con manifesto in <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> e ne rimuove i valori <code>zfs_arc_min</code> / <code>zfs_arc_max</code> in conflitto (le altre opzioni di quelle righe restano), così solo il file ARC ProxMenux imposta il limite. Poi <code>update-initramfs -u -k all</code> e, se necessario, <code>proxmox-boot-tool refresh</code> portano il limite nell’initramfs dei sistemi con root ZFS.",
"rebootTitle": "Richiede un riavvio per prendere effetto",
"rebootBody": "Le impostazioni ARC vengono lette caricando il modulo <code>zfs</code>. Per gli host con root ZFS, ProxMenux rigenera initramfs con <code>update-initramfs -u -k all</code> e aggiorna se necessario il bootloader con <code>proxmox-boot-tool refresh</code>. Il nuovo parametro richiede comunque un riavvio, segnalato automaticamente.",
"safeTitle": "Sicuro su host non-ZFS",
@@ -103,7 +103,7 @@
"heading": "Verifica",
"intro": "Dopo aver applicato le ottimizzazioni del sistema:",
"tipTitle": "Ripristino e limiti",
"tipBody": "Le sei opzioni sono registrate in <code>installed_tools.json</code> e disponibili in <link>Disinstalla ottimizzazioni</link>. Il ripristino rimuove configurazioni, unità e alias kexec e ripristina journald/logrotate. Alcuni limiti attivi richiedono una nuova sessione o riavvio. Da /root/.profile viene rimosso solo il vecchio ulimit -n 256000; l’attuale ulimit -n 1048576 può restare e richiedere rimozione manuale."
"tipBody": "Le sei opzioni sono registrate in <code>installed_tools.json</code> e disponibili in <link>Disinstalla ottimizzazioni</link>. Il ripristino rimuove i file di configurazione, l’unità e l’alias kexec, riscrive journald.conf con i valori predefiniti di systemd e ripristina logrotate.conf dal backup. Alcuni limiti attivi richiedono una nuova sessione o un riavvio."
},
"related": {
"heading": "Correlati",