"title":"Ripristino di un backup — flussi completi e personalizzati | ProxMenux",
"description":"Il flusso di lavoro completo di ripristino. Documenta le tre azioni disponibili su qualsiasi backup (visualizzazione, download, ripristino), il controllo di compatibilità e i suoi risultati, le modalità di ripristino completo e personalizzato, la classificazione del percorso che decide cosa si applica dal vivo e cosa aspetta per il prossimo avvio, il dispacciatore di avvio, e il passaggio di reinstallazione del componente post-boot.",
"ogTitle":"ProxMenux Backup — ripristino",
"ogDescription":"Flussi di ripristino completi e personalizzati con il controllo di compatibilità, la classificazione del percorso, il dispacciatore on-boot e la reinstallazione post-boot.",
"twitterTitle":"Ripristino di un backup | ProxMenux",
"twitterDescription":"Come un backup host ProxMenux viene trasformato in un host Proxmox funzionante."
},
"header":{
"title":"Ripristino di un backup",
"description":"L’intero ripristino, dalla scelta dell’archivio a un host operativo: controllo della compatibilità, due modalità di ripristino, elaborazione all’avvio e reinstallazione dei componenti dopo l’avvio, con i meccanismi per ripristinare su host e kernel diversi.",
"section":"Backup e ripristino"
},
"intro":{
"title":"Il ripristino riproduce la fonte, non solo i file",
"body":"Ripristinare un backup ProxMenux richiede più della semplice estrazione. Prima delle modifiche, il manifesto rileva le differenze tra origine e destinazione, vengono esclusi i percorsi che potrebbero impedire l’avvio e adattate le impostazioni dell’utente non copiabili alla lettera. Dopo il riavvio necessario, viene tentata la reinstallazione dei componenti supportati registrati (driver NVIDIA, Coral TPU, strumenti GPU) per il kernel attivo della destinazione. Un solo archivio guida controllo della compatibilità, classificazione dei percorsi e operazioni all’avvio e successive. Verifica risultati dei componenti e log per confermare l’esito."
},
"threeActions":{
"heading":"Tre azioni su un backup",
"intro":"Selezionando un backup dall'elenco si apre un menu con tre azioni.",
"actionRows":[
{
"action":"Vista",
"detail":"Consente di visualizzare in sola lettura l'archivio: contenuti manifest.json (nome host sorgente, versione PVE, kernel, hardware, componenti installati), l'elenco dei percorsi all'interno di <code>rootfs/</code> e un diff di ciò che cambierebbe sull'host corrente se il backup fosse applicato."
},
{
"action":"Scarica",
"detail":"Esporta l'archivio come file portatile <code>.tar.zst</code> (tar compresso con zstd). Può essere estratto su qualsiasi sistema Linux con <code>tar --zstd -xf FILE.tar.zst</code>, o su macOS/Windows con qualsiasi strumento che supporta zstd (7-Zip, PeaZip, Keka...). L'albero estratto contiene <code>manifest.json</code>, <code>metadata/</code> e <code>rootfs/</code> — esattamente lo stesso layout che il ripristino consuma. Utile per l'ispezione offline o per il ripristino su un host senza accesso alla destinazione originale (PBS, Borg)."
},
{
"action":"Ripristina",
"detail":"Il percorso di scrittura. Estrae l'archivio in una directory di staging, esegue il controllo di compatibilità e presenta il raccoglitore di modalità (Full o Custom)."
}
]
},
"compatibilityCheck":{
"heading":"Il controllo della compatibilità",
"intro":"Prima che qualsiasi file sia scritto, <code>hb_compat_check</code> confronta lo stato descritto nel manifesto contro l'host di destinazione. Il controllo viene eseguito in sola lettura e produce quattro uscite indipendenti che guidano il resto del ripristino.",
"outputRows":[
{
"output":"Indicatore della direzione",
"detail":"<code>HB_COMPAT_KERNEL_DIRECTION</code> vale <code>same</code>, <code>bk_newer</code> o <code>bk_older</code> in base al confronto delle versioni principali del kernel del backup e della destinazione. Guida il filtro dei percorsi compatibili, attivo solo per <code>bk_older</code>, e l’adattamento delle impostazioni descritto nella pagina sul ripristino tra kernel diversi."
},
{
"output":"Elenco dei percorsi Skip-paths",
"detail":"<code>RS_SKIP_PATHS</code> — ogni percorso che il ripristino non deve applicarsi. Populate da due meccanismi: deriva dell'hardware (mancando NIC, ID di archiviazione mancante, straniero ZFS pool) e — quando la direzione è <code>bk_older</code> — l'elenco dei percorsi non sicuri per il cross-kernel."
},
{
"output":"Piano di rimappatura delle schede di rete",
"detail":"Quando un NIC sul bersaglio ha lo stesso MAC come uno sulla fonte ma un nome diverso (tipico dopo uno scambio di schede madri), il controllo di compatibilità registra un piano di rinomina (<code>HB_NIC_REMAP</code>) che riscriverà <code>/etc/network/interfaces</code> durante il ripristino."
},
{
"output":"Piano di rollback",
"detail":"Calcolato da <code>compute_rollback_plan.sh</code>. Elenca VM, LXC e componenti presenti sulla destinazione ma assenti dal backup. La conferma offre la rimozione facoltativa dei guest aggiuntivi prima del riavvio. I componenti vanno rimossi manualmente e l’eliminazione dei guest può fallire: non è garantita una corrispondenza esatta."
}
],
"reportBody":"Il controllo emette anche un rapporto strutturato (<code>HB_COMPAT_RESULTS</code>) classificato come PASS / INFO / WARN / FAIL. Le voci WARN e FAIL sono di superficie nel pannello pre-restore; il ripristino si rifiuta di procedere solo quando un FAIL è presente che l'utente non può risolvere facendo clic su Continua."
},
"twoModes":{
"heading":"Ripristino completo vs ripristino personalizzato",
"intro":"Dopo il controllo della compatibilità compare la scelta della modalità. Determina <em>cosa</em> applicare e non <em>come</em>: entrambe usano lo stesso processo.",
"modeRows":[
{
"mode":"Ripristino completo",
"detail":"Applica ogni percorso dell'archivio che sopravvive alla deriva e ai filtri cross-kernel. Esegue anche il pacchetto di installazione e il componente auto-reinstall pass. Questa è la scelta predefinita e raccomandata — l'obiettivo è quello di riprodurre la fonte, non selezionare i pezzi."
},
{
"mode":"Ripristino personalizzato",
"detail":"Apre una lista di controllo che mostra ogni percorso che l'archivio porta. L'utente segna un sottoinsieme. I percorsi bloccati dal filtro cross-kernel appaiono grigiati e non possono essere selezionati. L'installazione del pacchetto e la reinstallazione automatica del componente sono saltati per impostazione predefinita in modalità personalizzata — l'utente sta segnalando che vogliono applicazione parziale, non una riproduzione completa."
}
]
},
"pathClassification":{
"heading":"Come si classificano i percorsi",
"intro":"Ogni percorso selezionato per il ripristino è classificato da <code>hb_classify_path</code> in una delle tre categorie. La categoria determina quando il percorso viene applicato al sistema e perché.",
"rows":[
{
"class":"hot",
"detail":"Percorsi applicati <strong>immediatamente</strong> al sistema di esecuzione. Il servizio che li consuma raccoglie il cambiamento da solo o al successivo ricarico — nessun riavvio richiesto. Queste sono la maggior parte di un backup: <code>/etc/ssh</code>, <code>/etc/apt</code>, <code>/etc/cron.*</code>, <code>/root</code>, <code>/usr/local/bin</code>, file di configurazione di servizio generale, ecc."
"detail":"Percorsi rimandati al <strong>prossimo avvio</strong> anziché applicati <strong>immediatamente</strong> da questo processo. Riguardano la configurazione di avvio: la generazione del bootloader legge <code>/etc/default/grub</code>, i montaggi usano <code>/etc/fstab</code> e il caricamento dei moduli usa <code>/etc/modules</code>. I file differiti vengono applicati dopo il riavvio, poi vengono rigenerati gli elementi di avvio necessari. Esempi: <code>/etc/default/grub</code>, <code>/etc/kernel</code>, <code>/etc/modules</code>, <code>/etc/fstab</code>, <code>/etc/zfs</code>, <code>/etc/modprobe.d</code>."
"detail":"Percorsi <strong>NON applicati sul sistema in esecuzione</strong>: una scrittura a caldo potrebbe corrompere lo stato o interrompere la connessione attiva. Vengono messi nell’insieme in attesa: <code>/etc/network</code> viene scritto all’inizio del riavvio successivo, prima dell’avvio della rete, e <code>/etc/pve</code> viene scritto dal dispatcher post-avvio quando il file system del cluster è disponibile. Esempi: <code>/etc/pve</code> (pmxcfs è un montaggio FUSE con la configurazione attiva del cluster), <code>/var/lib/pve-cluster</code> (dati attivi del cluster, conservati nella directory di ripristino solo per il recupero manuale), <code>/etc/network</code> (potrebbe riconfigurare proprio l’interfaccia usata dalla connessione SSH e interrompere la sessione)."
"heading":"Il flusso di lavoro di ripristino completo",
"intro":"La pipeline completa dalla selezione di archivi a un host restaurato funzionante. Ogni fase alimenta il successivo; lo stato scritto da fasi precedenti è consumato da quelli successivi.",
