Ripristino Indici Corrotti e Blocchi di Connessione in Kopia: Guida Pratica

Kopia è un software di backup moderno, veloce e sicuro. Offre crittografia end-to-end e deduplicazione avanzata lato client.

Tuttavia, possono verificarsi arresti anomali o improvvise interruzioni di rete. In questi casi, la presenza di indici corrotti in kopia può impedire l’avvio delle sessioni di salvataggio.

Questa guida illustra la procedura per ripristinare il repository. Se vuoi approfondire l’analisi dei log, consulta la nostra guida al debug di Kopia su Windows.

Perché si verificano errori negli indici e blocchi cloud

La struttura degli indici in Kopia

Kopia suddivide i file in blocchi crittografati chiamati blob. Questi elementi contengono dati compressi e metadati di sistema.

Gli indici tengono traccia della posizione di ogni singolo blob. Se un indice non si chiude correttamente, il repository diventa illeggibile.

Il client necessita sempre di una vista coerente del catalogo remoto. Una discrepanza genera errori immediati di sincronizzazione.

Cause dei blocchi di connessione remota

I blocchi cloud si verificano spesso per timeout improvvisi di rete. Anche la concorrenza tra client diversi causa conflitti analoghi.

Se due istanze provano ad aggiornare lo stesso bucket, scatta una protezione. Il server cloud segnala file di lock orfani o sessioni aperte.

Inoltre, l’interruzione brutale di uno snapshot lascia metadati parziali nello storage. Ciò impedisce la normale operatività dei processi successivi.

Diagnostica preliminare: individuare la corruzione

Analisi dei file di registro

Il primo passo consiste nell’esame attento dei log di errore. Su Windows si trovano nel percorso %APPDATA%\kopia\logs.

Su Linux o macOS puoi consultare la cartella ~/.cache/kopia/logs. Cerca righe contenenti le diciture *error opening repository* oppure *index blob invalid*.

I log indicano con precisione l’identificativo del blob danneggiato. Prendi nota di questi parametri per le riparazioni mirate.

Verifica dello stato del repository

Apri il prompt dei comandi o il terminale con privilegi adeguati. Esegui il comando di verifica dello stato:

kopia repository status

Spesso la presenza di indici corrotti in kopia si manifesta con errori di tipo index blob not found. In questa situazione, il comando restituisce un codice di errore bloccante.

Puoi approfondire l’ispezione con il modulo di controllo integrità:

kopia snapshot verify --verify-files-percent=5

Questo comando esamina una percentuale casuale degli archivi memorizzati. Conferma se il problema riguarda i metadati o i file reali.

Avviso di sicurezza: Prima di avviare qualsiasi operazione di riparazione o riscrittura, interrompi tutti i processi Kopia attivi sugli altri client collegati al medesimo repository cloud.

Procedura passo-passo per il ripristino degli indici

Pulizia della cache locale

Spesso il file danneggiato si trova solo nella cache locale. Eliminare la cache risolve il problema senza toccare il cloud.

1. Disconnetti il client locale dal repository cloud:

kopia repository disconnect

2. Accedi alla cartella della cache di Kopia sul disco locale. Cancella tutti i file presenti nella directory indexes.
3. Riconnetti il repository tramite i normali parametri di connessione. Kopia scaricherà gli indici integri dal cloud.

Recupero degli indici con comando dedicato

Se la risincronizzazione della cache non basta, bisogna agire sui metadati remoti. Per rimediare a scenari con indici corrotti in kopia, il comando primario è kopia index recover.

kopia index recover --commit

Questo comando scansiona tutti i blob presenti nello spazio cloud. Ricostruisce le tabelle degli indici basandosi sui chunk effettivamente trovati.

Il flag --commit rende definitive le modifiche calcolate. L’operazione può richiedere diversi minuti in base alla dimensione dell’archivio.

Compattazione e ottimizzazione

Dopo il recupero, è fondamentale compattare i nuovi indici creati. L’ottimizzazione elimina riferimenti orfani e velocizza le query.

Lancia questo comando dal tuo terminale:

kopia index optimize

Il client unirà piccoli indici frammentati in blob compatti. In questo modo ridurrai il traffico API verso il provider cloud.

Risoluzione dei blocchi di connessione e lock cloud

Gestione della manutenzione esclusiva

Kopia esegue task di manutenzione automatica per pulire i blocchi non utilizzati. Se la sessione si interrompe, il repository rimane bloccato.

Nessun client potrà scrivere finché il lock risulta assegnato. Per forzare la proprietà della manutenzione sul client attuale, digita:

kopia maintenance set --owner=me

Ora puoi sbloccare ed eseguire manualmente la manutenzione:

kopia maintenance run --full

Questo comando elimina i blocchi incompiuti. Ripristina il normale accesso a tutti gli utenti autorizzati.

Regolazione dei parametri cloud e throttling

I provider come Wasabi, Backblaze B2 o AWS S3 applicano rate limit rigidi. Una cattiva sincronizzazione con lo storage cloud può generare indici corrotti in kopia durante carichi intensi.

Per evitare errori di connessione, imposta parametri di rete più conservativi. Ad esempio, limita il numero di connessioni contemporanee:

kopia repository connect s3 --max-download-speed=50MB --max-upload-speed=30MB

Configura inoltre timeout più lunghi nelle opzioni del profilo storage. Ciò ridurrà i fallimenti dovuti a microinterruzioni di rete.

Best practice per preservare l’integrità del backup

Pianificazione della manutenzione ordinaria

Non affidare la manutenzione esclusivamente ai client portatili. Designa un unico server fisso come gestore della manutenzione.

Configura un’attività pianificata settimanale per eseguire controlli completi. Un ciclo regolare di compattazione previene errori catastrofici.

Verifica sempre che l’orario di sistema dei vari client sia sincronizzato via NTP. Discrepanze temporali creano problemi con i timestamp dei lock.

Monitoraggio proattivo degli snapshot

Monitorare regolarmente il sistema evita la ricomparsa di indici corrotti in kopia su storage remoti.

Imposta notifiche via webhook o script PowerShell al termine di ogni esecuzione. Controlla periodicamente i file di log per scovare avvisi precoci.

Testa il ripristino di una cartella di prova almeno una volta al mese. La validazione empirica è l’unica vera certezza di affidabilità.

Domande Frequenti (FAQ)

Il comando index recover cancella i miei file personali?

No, il comando opera esclusivamente sui metadati e sulle tabelle di puntamento. I dati crittografati degli snapshot non vengono modificati né eliminati.

Cosa fare se ricevo l’errore “repository is locked” durante il backup?

Significa che un’altra operazione è in corso o è fallita senza rilasciare il lock. Verifica che nessun client sia attivo, quindi esegui kopia maintenance run per rilasciare il blocco.

La pulizia della cache locale può causare perdita di dati?

Assolutamente no. La cache locale contiene copie temporanee degli indici cloud. Kopia le riscaricherà in modo trasparente alla connessione successiva.