Sinossi (Synopsis)
snapraid [-c, --conf CONFIG] [-f, --filter PATTERN] [-d, --filter-disk NAME] [-m, --filter-missing] [-e, --filter-error] [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR] [-p, --plan PERC|bad|new|full] [-o, --older-than DAYS] [-l, --log FILE] [-s, --spin-down-on-error] [-w, --bw-limit RATE] [-t, --tail] [-Z, --force-zero] [-E, --force-empty] [-U, --force-uuid] [-D, --force-device] [-N, --force-nocopy] [-F, --force-full] [-R, --force-realloc] [-W, --force-realloc-tail] [-S, --start BLKSTART] [-B, --count BLKCOUNT] [-L, --error-limit NUMBER] [-A, --stats] [-v, --verbose] [-q, --quiet] status|smart|probe|up|down|diff|sync|scrub|fix|check |list|dup|pool|devices|touch|rehash|locate
snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]
Descrizione (Description)
SnapRAID è un programma di backup progettato per array di dischi, che memorizza informazioni di parità per il recupero dati in caso di guasto fino a sei dischi.
Destinato principalmente a centri multimediali domestici con file grandi e che cambiano raramente, SnapRAID offre diverse funzionalità:
- È possibile utilizzare dischi già pieni di file senza la necessità di riformattarli, accedendovi come al solito.
- Tutti i dati sono sottoposti ad hashing per garantire l'integrità dei dati e prevenire la corruzione silente.
- Quando il numero di dischi guasti supera il conteggio di parità, la perdita di dati è confinata ai dischi interessati; i dati sugli altri dischi rimangono accessibili.
- Se si eliminano accidentalmente dei file su un disco, il recupero è possibile.
- I dischi possono avere dimensioni diverse.
- È possibile aggiungere dischi in qualsiasi momento.
- SnapRAID non blocca i dati; è possibile smettere di usarlo in qualsiasi momento senza riformattare o spostare i dati.
- Per accedere a un file, è necessario avviare la rotazione di solo un singolo disco, risparmiando energia e riducendo il rumore.
Per maggiori informazioni, si prega di visitare il sito ufficiale SnapRAID:
https://www.snapraid.it/
Limitazioni (Limitations)
SnapRAID è un ibrido tra un RAID e un programma di backup, con l'obiettivo di combinare i migliori vantaggi di entrambi. Tuttavia, presenta alcune limitazioni che dovresti considerare prima di usarlo.
La limitazione principale è che se un disco si guasta, puoi recuperare i dati solo fino allo stato dell'ultima operazione di sync. Qualsiasi dato aggiunto o modifica apportata dopo l'ultimo sync sul disco guasto andrà perso.
Di conseguenza, SnapRAID è adatto principalmente per dati che cambiano raramente.
Per i dati che esistevano già all'ultimo sync, l'affidabilità del recupero dipende dall'uso o meno dell'opzione snapshot:
- Con il supporto snapshot (disponibile su Btrfs, ZFS, Bcachefs e NTFS), SnapRAID può mantenere automaticamente un riferimento congelato indipendente di ogni file system dati supportato. Ciò garantisce che anche se si modificano o si eliminano file sul file system live durante o dopo un sync, il processo di recupero rimane coerente e affidabile.
- Senza il supporto snapshot, eliminare o modificare file dopo un sync può impedire il recupero completo di altri dischi guasti. Ciò accade perché la parità non corrisponde più ai file modificati, anche se quei file non si trovano sul disco guasto. D'altra parte, i file aggiunti di recente non impediscono il recupero dei file già esistenti.
Altre limitazioni di SnapRAID sono:
- Con SnapRAID, si hanno ancora file system separati per ogni disco. Con RAID, si ottiene un unico grande file system.
- SnapRAID non esegue lo striping dei dati. Con RAID, si ottiene un aumento di velocità con lo striping.
- SnapRAID non supporta il recupero in tempo reale. Con RAID, non si deve smettere di lavorare quando un disco si guasta.
- SnapRAID può recuperare i dati solo da un numero limitato di guasti del disco. Con un backup, è possibile recuperare da un guasto completo dell'intero array di dischi.
- Vengono salvati solo nomi di file, timestamp, symlink e hardlink. Permessi, proprietà e attributi estesi non vengono salvati.
Primi passi (Getting Started)
Per usare SnapRAID, è necessario prima selezionare un disco nell'array di dischi da dedicare alle informazioni di parity (parità). Con un disco per la parità, si sarà in grado di recuperare da un singolo guasto del disco, in modo simile a RAID5.
Se si desidera recuperare da più guasti del disco, in modo simile a RAID6, è necessario riservare dischi aggiuntivi per la parità. Ogni disco di parità aggiuntivo consente il recupero da un guasto in più del disco.
Come dischi di parità, è necessario scegliere i dischi più grandi dell'array, poiché le informazioni di parità possono crescere fino alle dimensioni del più grande disco dati nell'array.
Questi dischi saranno dedicati alla memorizzazione dei file di parità. Non si dovrebbero memorizzare i propri dati su di essi.
Quindi, è necessario definire i dischi data (dati) che si desidera proteggere con SnapRAID. La protezione è più efficace se questi dischi contengono dati che cambiano raramente. Per questo motivo, è meglio NON includere il disco C:\ di Windows o le directory Unix /home, /var, e /tmp.
L'elenco dei file viene salvato nei file content (contenuto), di solito memorizzati sui dischi dati, di parità o di avvio. Questo file contiene i dettagli del backup, inclusi tutti i checksum per verificarne l'integrità. Il file content viene memorizzato in più copie e ogni copia deve essere su un disco diverso per garantire che, anche in caso di guasti multipli ai dischi, sia disponibile almeno una copia.
Ad esempio, supponiamo di essere interessati a un solo livello di protezione con parità e che i dischi si trovino in:
/mnt/diskp <- disco selezionato per la parità /mnt/disk1 <- primo disco da proteggere /mnt/disk2 <- secondo disco da proteggere /mnt/disk3 <- terzo disco da proteggere
È necessario creare il file di configurazione /etc/snapraid.conf con le seguenti opzioni:
parity /mnt/diskp/snapraid.parity content /var/snapraid/snapraid.content content /mnt/disk1/snapraid.content content /mnt/disk2/snapraid.content data d1 /mnt/disk1/ data d2 /mnt/disk2/ data d3 /mnt/disk3/
Se si è su Windows, si dovrebbe usare il formato del percorso di Windows, con lettere di unità e backslash invece di slash.
parity E:\snapraid.parity content C:\snapraid\snapraid.content content F:\array\snapraid.content content G:\array\snapraid.content data d1 F:\array\ data d2 G:\array\ data d3 H:\array\
Se si hanno molti dischi e si esauriscono le lettere di unità, è possibile montare i dischi direttamente nelle sottocartelle. Vedi:
https://www.google.com/search?q=Windows+mount+point
A questo punto, si è pronti per eseguire il comando sync per costruire le informazioni di parità.
snapraid sync
Questo processo può richiedere diverse ore la prima volta, a seconda delle dimensioni dei dati già presenti sui dischi. Se i dischi sono vuoti, il processo è immediato.
È possibile interromperlo in qualsiasi momento premendo Ctrl+C e, alla prossima esecuzione, riprenderà da dove è stato interrotto.
Quando questo comando è completato, i dati sono SICURI.
Ora è possibile iniziare a usare l'array come si desidera e aggiornare periodicamente le informazioni di parità eseguendo il comando sync.
Scrubbing (Scrubbing)
Per controllare periodicamente i dati e la parità per gli errori, è possibile eseguire il comando scrub.
snapraid scrub
Questo comando confronta i dati nell'array con l'hash calcolato durante il comando sync per verificarne l'integrità.
Ogni esecuzione del comando controlla circa l'8% dell'array, escludendo i dati già sottoposti a scrub nei 10 giorni precedenti. È possibile utilizzare l'opzione -p, --plan per specificare una quantità diversa e l'opzione -o, --older-than per specificare un'età diversa in giorni. Ad esempio, per controllare il 5% dell'array per blocchi più vecchi di 20 giorni, usare:
snapraid -p 5 -o 20 scrub
Se vengono trovati errori silenti o di input/output durante il processo, i blocchi corrispondenti vengono contrassegnati come bad (danneggiati) nel file content ed elencati nel comando status.
snapraid status
Per correggerli, è possibile utilizzare il comando fix, filtrando i blocchi danneggiati con l'opzione -e, --filter-error:
snapraid -e fix
Al prossimo scrub, gli errori scompariranno dal report status se sono stati veramente corretti. Per renderlo più veloce, è possibile utilizzare -p bad per eseguire lo scrub solo dei blocchi contrassegnati come bad.
snapraid -p bad scrub
L'esecuzione di scrub su un array non sincronizzato può riportare errori causati da file rimossi o modificati. Questi errori sono riportati nell'output di scrub, ma i blocchi correlati non sono contrassegnati come bad.
Pooling (Pooling)
Nota: La funzionalità di pooling descritta di seguito è stata sostituita dallo strumento mergerfs, che è ora l'opzione consigliata per gli utenti Linux nella comunità SnapRAID. Mergerfs fornisce un modo più flessibile ed efficiente per raggruppare più unità in un singolo punto di montaggio unificato, consentendo un accesso trasparente ai file attraverso l'array senza fare affidamento sui collegamenti simbolici. Si integra bene con SnapRAID per la protezione della parità ed è comunemente usato in configurazioni come OpenMediaVault (OMV) o NAS personalizzati.
Per avere tutti i file nell'array mostrati nello stesso albero di directory, è possibile abilitare la funzionalità di pooling. Crea una vista virtuale di sola lettura di tutti i file nell'array utilizzando collegamenti simbolici.
È possibile configurare la directory di pooling nel file di configurazione con:
pool /pool
o, se si è su Windows, con:
pool C:\pool
e quindi eseguire il comando pool per creare o aggiornare la vista virtuale.
snapraid pool
Se si sta utilizzando una piattaforma Unix e si desidera condividere questa directory sulla rete con macchine Windows o Unix, è necessario aggiungere le seguenti opzioni al file /etc/samba/smb.conf:
# Nella sezione globale di smb.conf unix extensions = no
# Nella sezione di condivisione di smb.conf [pool] comment = Pool path = /pool read only = yes guest ok = yes wide links = yes follow symlinks = yes
In Windows, la condivisione di collegamenti simbolici su una rete richiede che i client li risolvano da remoto. Per abilitare questo, oltre a condividere la directory pool, è necessario condividere anche tutti i dischi in modo indipendente, utilizzando i nomi dei dischi definiti nel file di configurazione come punti di condivisione. È inoltre necessario specificare nell'opzione share del file di configurazione il percorso UNC di Windows che i client remoti devono utilizzare per accedere a questi dischi condivisi.
Ad esempio, operando da un server chiamato darkstar, è possibile utilizzare le opzioni:
data d1 F:\array\ data d2 G:\array\ data d3 H:\array\ pool C:\pool share \\darkstar
e condividere le seguenti directory sulla rete:
\\darkstar\pool -> C:\pool \\darkstar\d1 -> F:\array \\darkstar\d2 -> G:\array \\darkstar\d3 -> H:\array
per consentire ai client remoti di accedere a tutti i file in \\darkstar\pool.
Potrebbe anche essere necessario configurare i client remoti per abilitare l'accesso ai symlink remoti con il comando:
fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
Annullamento eliminazione (Undeleting)
SnapRAID funziona più come un programma di backup che come un sistema RAID e può essere utilizzato per ripristinare i file al loro stato precedente o annullarne l'eliminazione utilizzando l'opzione -f, --filter:
snapraid fix -f FILE
o per una directory:
snapraid fix -f DIR/
È anche possibile usarlo per recuperare solo i file eliminati accidentalmente all'interno di una directory utilizzando l'opzione -m, --filter-missing, che ripristina solo i file mancanti, lasciando tutti gli altri intatti.
snapraid fix -m -f DIR/
O per recuperare tutti i file eliminati su tutte le unità con:
snapraid fix -m
Recupero (Recovering)
È successo il peggio e si sono persi uno o più dischi!
NON FARSI PRENDERE DAL PANICO! Sarà possibile recuperarli!
La prima cosa da fare è evitare ulteriori modifiche all'array di dischi. Disabilitare qualsiasi connessione remota ad esso e qualsiasi processo pianificato, incluso qualsiasi sync o scrub notturno pianificato di SnapRAID.
Quindi procedere con i seguenti passaggi.
PASSO 1 -> Riconfigurazione (Reconfigure)
È necessario un po' di spazio per recuperare, idealmente su dischi di riserva aggiuntivi, ma un disco USB esterno o un disco remoto saranno sufficienti.
Modificare il file di configurazione SnapRAID per far puntare l'opzione data o parity del disco guasto a una posizione con spazio vuoto sufficiente per recuperare i file.
Ad esempio, se il disco d1 è guasto, cambiare da:
data d1 /mnt/disk1/
a:
data d1 /mnt/new_spare_disk/
Se il disco da recuperare è un disco di parità, aggiornare l'opzione parity appropriata. Se si hanno più dischi guasti, aggiornare tutte le loro opzioni di configurazione.
PASSO 2 -> Correzione (Fix)
Eseguire il comando fix, memorizzando il log in un file esterno con:
snapraid -d NAME -l fix.log fix
Dove NAME è il nome del disco, come d1 nel nostro esempio precedente. Se il disco da recuperare è un disco di parità, usare i nomi parity, 2-parity, ecc. Se si hanno più dischi guasti, usare più opzioni -d per specificarli tutti.
Questo comando richiederà molto tempo.
Assicurarsi di avere alcuni gigabyte liberi per memorizzare il file fix.log. Eseguirlo da un disco con spazio libero sufficiente.
Ora si è recuperato tutto ciò che è recuperabile. Se alcuni file sono parzialmente o totalmente irrecuperabili, verranno rinominati aggiungendo l'estensione .unrecoverable.
È possibile trovare un elenco dettagliato di tutti i blocchi irrecuperabili nel file fix.log controllando tutte le righe che iniziano con unrecoverable:.
Se non si è soddisfatti del recupero, è possibile riprovare tutte le volte che si desidera.
Ad esempio, se si sono rimossi file dall'array dopo l'ultimo sync, questo può comportare che alcuni file non vengano recuperati. In questo caso, è possibile riprovare il fix usando l'opzione -i, --import, specificando dove si trovano ora questi file per includerli di nuovo nel processo di recupero.
Se si è soddisfatti del recupero, è possibile procedere oltre, ma notare che dopo la sincronizzazione, non è più possibile riprovare il comando fix!
PASSO 3 -> Controllo (Check)
Come controllo cauto, è ora possibile eseguire un comando check per assicurarsi che tutto sia corretto sul disco recuperato.
snapraid -d NAME -a check
Dove NAME è il nome del disco, come d1 nel nostro esempio precedente.
Le opzioni -d e -a dicono a SnapRAID di controllare solo il disco specificato e di ignorare tutti i dati di parità.
Questo comando richiederà molto tempo, ma se non si è eccessivamente cauti, è possibile saltarlo.
PASSO 4 -> Sincronizzazione (Sync)
Eseguire il comando sync per risincronizzare l'array con il nuovo disco.
snapraid sync
Se tutto è recuperato, questo comando è immediato.
Comandi (Commands)
SnapRAID fornisce alcuni semplici comandi che consentono di:
- Stampare lo stato dell'array -> status
- Controllare i dischi -> smart, probe, up, down
- Creare un punto di backup/recupero -> sync
- Controllare periodicamente i dati -> scrub
- Ripristinare l'ultimo punto di backup/recupero -> fix.
I comandi devono essere scritti in lettere minuscole.
status
Stampa un riepilogo dello stato dell'array di dischi.
Include informazioni sulla frammentazione della parità, quanto sono vecchi i blocchi senza essere controllati e tutti gli errori silenti registrati incontrati durante lo scrubbing.
Le informazioni presentate si riferiscono all'ultima volta che si è eseguito sync. Le modifiche successive non vengono prese in considerazione.
Se sono stati rilevati blocchi danneggiati, vengono elencati i loro numeri di blocco. Per correggerli, è possibile utilizzare il comando fix -e.
Mostra anche un grafico che rappresenta l'ultima volta che ogni blocco è stato sottoposto a scrub o sincronizzato. I blocchi sottoposti a scrub sono mostrati con *, i blocchi sincronizzati ma non ancora sottoposti a scrub con o.
Nulla viene modificato.
smart
Stampa un report SMART di tutti i dischi nel sistema.
Include una stima della probabilità di guasto nel prossimo anno, consentendo di pianificare sostituzioni di manutenzione di dischi che mostrano attributi sospetti.
Questa stima della probabilità è ottenuta correlando gli attributi SMART dei dischi con i dati Backblaze disponibili all'indirizzo:
https://www.backblaze.com/hard-drive-test-data.html
Se SMART segnala che un disco sta per guastarsi, viene stampato FAIL o PREFAIL per quel disco e SnapRAID restituisce un errore. In questo caso, si raccomanda vivamente la sostituzione immediata del disco.
Altre possibili stringhe di stato sono:
Se viene specificata l'opzione -v, --verbose, viene fornita un'analisi statistica più approfondita. Questa analisi può aiutare a decidere se è necessaria più o meno parità.
Questo comando utilizza lo strumento smartctl ed è equivalente all'esecuzione di smartctl -a su tutti i dispositivi.
Se i dispositivi non vengono rilevati automaticamente correttamente, è possibile specificare un comando personalizzato utilizzando l'opzione smartctl nel file di configurazione.
Nulla viene modificato.
probe
Stampa lo stato POWER di tutti i dischi nel sistema.
Standby significa che il disco non è in rotazione. Active significa che il disco è in rotazione.
Questo comando utilizza lo strumento smartctl ed è equivalente all'esecuzione di smartctl -n standby -i su tutti i dispositivi.
Se i dispositivi non vengono rilevati automaticamente correttamente, è possibile specificare un comando personalizzato utilizzando l'opzione smartctl nel file di configurazione.
Nulla viene modificato.
up
Avvia la rotazione di tutti i dischi dell'array.
È possibile avviare la rotazione di soli dischi specifici utilizzando l'opzione -d, --filter-disk.
Avviare la rotazione di tutti i dischi contemporaneamente richiede molta energia. Assicurarsi che l'alimentatore possa sostenerlo.
Nulla viene modificato.
down
Ferma tutti i dischi dell'array.
Questo comando utilizza lo strumento smartctl ed è equivalente all'esecuzione di smartctl -s standby,now su tutti i dispositivi.
È possibile fermare solo dischi specifici utilizzando l'opzione -d, --filter-disk.
Per fermare automaticamente in caso di errore, è possibile utilizzare l'opzione -s, --spin-down-on-error con qualsiasi altro comando, che è equivalente all'esecuzione manuale di down quando si verifica un errore.
Nulla viene modificato.
diff
Elenca tutti i file modificati dall'ultimo sync che devono avere i loro dati di parità ricalcolati.
Questo comando non controlla i dati del file, ma solo il timestamp del file, le dimensioni e l'inode.
Dopo aver elencato tutti i file modificati, viene presentato un riepilogo delle modifiche, raggruppate per:
Se è richiesto un sync, il codice di ritorno del processo è 2, invece del predefinito 0. Il codice di ritorno 1 è utilizzato per una condizione di errore generica.
Nulla viene modificato.
sync
Aggiorna le informazioni di parità. Tutti i file modificati nell'array di dischi vengono letti e i dati di parità corrispondenti vengono aggiornati.
È possibile interrompere questo processo in qualsiasi momento premendo Ctrl+C, senza perdere il lavoro già svolto. Alla prossima esecuzione, il processo sync riprenderà da dove è stato interrotto.
Se vengono trovati errori silenti o di input/output durante il processo, i blocchi corrispondenti vengono contrassegnati come bad (danneggiati).
I file sono identificati dal percorso e/o dall'inode e controllati per dimensione e timestamp. Se la dimensione o il timestamp del file differiscono, i dati di parità vengono ricalcolati per l'intero file. Se il file viene spostato o rinominato sullo stesso disco, mantenendo lo stesso inode, la parità non viene ricalcolata. Se il file viene spostato su un altro disco, la parità viene ricalcolata, ma le informazioni di hash precedentemente calcolate vengono mantenute.
I file content e parity vengono modificati se necessario. I file nell'array NON vengono modificati.
scrub
Esegue lo scrub dell'array, controllando la presenza di errori silenti o di input/output nei dischi dati e di parità.
Ogni invocazione controlla circa l'8% dell'array, escludendo i dati già sottoposti a scrub negli ultimi 10 giorni. Ciò significa che eseguire lo scrubbing una volta alla settimana garantisce che ogni bit di dati venga controllato almeno una volta ogni tre mesi.
È possibile definire un piano o una quantità di scrub diversa utilizzando l'opzione -p, --plan, che accetta: bad - Esegue lo scrub dei blocchi contrassegnati come bad. new - Esegue lo scrub dei blocchi appena sincronizzati non ancora
sottoposti a scrub.
Se si specifica una quantità percentuale, è anche possibile utilizzare l'opzione -o, --older-than per definire quanto deve essere vecchio il blocco. I blocchi più vecchi vengono sottoposti a scrub per primi, garantendo un controllo ottimale. Se si desidera eseguire lo scrub solo dei blocchi appena sincronizzati non ancora sottoposti a scrub, utilizzare l'opzione -p new.
Per ottenere i dettagli dello stato dello scrub, utilizzare il comando status.
Per qualsiasi errore silente o di input/output trovato, i blocchi corrispondenti vengono contrassegnati come bad nel file content. Questi blocchi danneggiati sono elencati in status e possono essere corretti con fix -e. Dopo la correzione, al prossimo scrub, verranno ricontrollati e, se trovati corretti, il contrassegno bad verrà rimosso. Per eseguire lo scrub solo dei blocchi danneggiati, è possibile utilizzare il comando scrub -p bad.
Si consiglia di eseguire scrub solo su un array sincronizzato per evitare errori segnalati causati da dati non sincronizzati. Questi errori sono riconosciuti come non essendo errori silenti e i blocchi non vengono contrassegnati come bad, ma tali errori sono riportati nell'output del comando.
Il file content viene modificato per aggiornare l'ora dell'ultimo controllo per ogni blocco e per contrassegnare i blocchi danneggiati. I file parity NON vengono modificati. I file nell'array NON vengono modificati.
fix
Ripristina tutti i file e i dati di parità.
Tutti i file e i dati di parità vengono confrontati con lo stato salvato nell'ultimo sync. Se viene trovata una differenza, questa viene ripristinata allo stato memorizzato.
ATTENZIONE! Il comando fix non distingue tra errori e modifiche intenzionali. Ripristina incondizionatamente lo stato del file all'ultimo sync.
Se non viene specificata nessun'altra opzione, l'intero array viene elaborato. Utilizzare le opzioni di filtro per selezionare un sottoinsieme di file o dischi su cui operare.
Per correggere solo i blocchi contrassegnati come bad (danneggiati) durante sync e scrub, utilizzare l'opzione -e, --filter-error. A differenza di altre opzioni di filtro, questa applica correzioni solo ai file che sono invariati dall'ultimo sync.
SnapRAID rinomina tutti i file che non possono essere corretti aggiungendo l'estensione .unrecoverable.
Prima di correggere, l'intero array viene scansionato per trovare eventuali file spostati dall'ultima operazione di sync. Questi file sono identificati dal loro timestamp, ignorando il loro nome e la directory, e vengono utilizzati nel processo di recupero se necessario. Se alcuni di essi sono stati spostati al di fuori dell'array, è possibile utilizzare l'opzione -i, --import per specificare directory aggiuntive da scansionare.
I file sono identificati solo dal percorso, non dall'inode.
Il file content NON viene modificato. I file parity vengono modificati se necessario. I file nell'array vengono modificati se necessario.
check
Verifica tutti i file e i dati di parità.
Funziona come fix, ma simula solo un recupero e nessuna modifica viene scritta nell'array.
Questo comando è destinato principalmente alla verifica manuale, ad esempio dopo un processo di recupero o in altre condizioni speciali. Per i controlli periodici e pianificati, utilizzare scrub.
Se si utilizza l'opzione -a, --audit-only, vengono controllati solo i dati dei file e i dati di parità vengono ignorati per un'esecuzione più veloce.
I file sono identificati solo dal percorso, non dall'inode.
Nulla viene modificato.
list
Elenca tutti i file contenuti nell'array al momento dell'ultimo sync.
Con -v o --verbose, viene mostrato anche il tempo sotto il secondo.
Nulla viene modificato.
dup
Elenca tutti i file duplicati. Due file sono considerati uguali se i loro hash corrispondono. I dati del file non vengono letti; vengono utilizzati solo gli hash precalcolati.
Nulla viene modificato.
pool
Crea o aggiorna una vista virtuale di tutti i file nell'array di dischi nella directory di pooling.
I file non vengono copiati ma collegati utilizzando collegamenti simbolici.
Durante l'aggiornamento, tutti i collegamenti simbolici esistenti e le sottodirectory vuote vengono eliminati e sostituiti con la nuova vista dell'array. Qualsiasi altro file regolare viene lasciato al suo posto.
Nulla viene modificato al di fuori della directory pool.
devices
Stampa i dispositivi di basso livello utilizzati dall'array.
Questo comando visualizza le associazioni dei dispositivi nell'array ed è principalmente destinato come interfaccia script.
Le prime due colonne sono l'ID e il percorso del dispositivo di basso livello. Le due colonne successive sono l'ID e il percorso del dispositivo di alto livello. L'ultima colonna è il nome del disco nell'array.
Nella maggior parte dei casi, si ha un dispositivo di basso livello per ogni disco nell'array, ma in alcune configurazioni più complesse, si potrebbe avere più dispositivi di basso livello utilizzati da un singolo disco nell'array.
Nulla viene modificato.
touch
Imposta un timestamp arbitrario sotto il secondo per tutti i file che lo hanno impostato a zero.
Questo migliora la capacità di SnapRAID di riconoscere i file spostati e copiati, poiché rende il timestamp quasi unico, riducendo possibili duplicati.
Più specificamente, se il timestamp sotto il secondo non è zero, un file spostato o copiato viene identificato come tale se corrisponde al nome, alle dimensioni e al timestamp. Se il timestamp sotto il secondo è zero, è considerato una copia solo se il percorso completo, le dimensioni e il timestamp corrispondono tutti.
Il timestamp di precisione al secondo non viene modificato, quindi tutte le date e gli orari dei file saranno conservati.
rehash
Pianifica un rehash dell'intero array.
Questo comando cambia il tipo di hash utilizzato, in genere quando si esegue l'aggiornamento da un sistema a 32 bit a uno a 64 bit, per passare da MurmurHash3 al più veloce SpookyHash.
Se si sta già utilizzando l'hash ottimale, questo comando non fa nulla e informa che non è necessaria alcuna azione.
Il rehash non viene eseguito immediatamente ma avviene progressivamente durante sync e scrub.
È possibile controllare lo stato del rehash utilizzando status.
Durante il rehash, SnapRAID mantiene la piena funzionalità, con l'unica eccezione che dup non è in grado di rilevare file duplicati utilizzando un hash diverso.
locate
Individua i file memorizzati nei dischi di parità. Per ogni file corrispondente, stampa la sua posizione all'interno del file di parità e il numero di frammenti che occupa.
È possibile utilizzare l'opzione -t, --tail per limitare l'operazione ai file che occupano la porzione di coda specificata della parità.
Se si desidera riallocare questi file, è possibile utilizzare l'opzione -W, --force-realloc-tail. Si tenga presente che tali file non saranno protetti dalla parità durante il processo di riallocazione.
Opzioni (Options)
SnapRAID fornisce le seguenti opzioni:
Configurazione (Configuration)
SnapRAID richiede un file di configurazione per sapere dove si trova l'array di dischi e dove memorizzare le informazioni di parità.
In Unix, utilizza il file /usr/local/etc/snapraid.conf se esiste, altrimenti /etc/snapraid.conf. In Windows, utilizza il file snapraid.conf nella stessa directory di snapraid.exe.
Deve contenere le seguenti opzioni (sensibili al maiuscolo/minuscolo):
parity FILE [,FILE] ...
Definisce i file da utilizzare per memorizzare le informazioni di parità. La parità consente la protezione da un singolo guasto del disco, simile a RAID5.
È possibile specificare più file, che devono essere su dischi diversi. Quando un file non può più crescere, viene utilizzato il successivo. Lo spazio totale disponibile deve essere almeno grande quanto il disco dati più grande dell'array.
È possibile aggiungere file di parità aggiuntivi in seguito, ma non è possibile riordinarli o rimuoverli.
Mantenere i dischi di parità riservati alla parità garantisce che non diventino frammentati, migliorando le prestazioni.
In Windows, 256 MB vengono lasciati inutilizzati su ogni disco per evitare l'avviso sui dischi pieni.
Questa opzione è obbligatoria e può essere utilizzata solo una volta.
(2,3,4,5,6)-parity FILE [,FILE] ...
Definisce i file da utilizzare per memorizzare informazioni di parità extra.
Per ogni livello di parità specificato, è abilitato un livello aggiuntivo di protezione:
- 2-parity abilita la doppia parità RAID6.
- 3-parity abilita la tripla parità.
- 4-parity abilita la parità quadrupla.
- 5-parity abilita la parità quintupla.
- 6-parity abilita la parità esapla.
Ogni livello di parità richiede la presenza di tutti i livelli di parità precedenti.
Si applicano le stesse considerazioni dell'opzione parity.
Queste opzioni sono facoltative e possono essere utilizzate solo una volta.
z-parity FILE [,FILE] ...
Definisce un file e un formato alternativi per memorizzare la tripla parità.
Questa opzione è un'alternativa a 3-parity, destinata principalmente a CPU di fascia bassa come ARM o AMD Phenom, Athlon e Opteron che non supportano il set di istruzioni SSSE3. In tali casi, fornisce prestazioni migliori.
Questo formato è simile ma più veloce di quello utilizzato da ZFS RAIDZ3. Come ZFS, non funziona oltre la tripla parità.
Quando si utilizza 3-parity, si verrà avvisati se è consigliato utilizzare il formato z-parity per un miglioramento delle prestazioni.
È possibile convertire da un formato all'altro regolando il file di configurazione con il file z-parity o 3-parity desiderato e utilizzando fix per ricrearlo.
content FILE
Definisce il file da utilizzare per memorizzare l'elenco e i checksum di tutti i file presenti nell'array di dischi.
Può essere posizionato su un disco utilizzato per dati, parità o qualsiasi altro disco disponibile. Se si utilizza un disco dati, questo file viene automaticamente escluso dal processo sync.
Questa opzione è obbligatoria e può essere utilizzata più volte per salvare più copie dello stesso file.
È necessario memorizzare almeno una copia per ogni disco di parità utilizzato più uno. L'utilizzo di copie aggiuntive non è dannoso.
data NAME DIR
Definisce il nome e il punto di montaggio dei dischi dati nell'array. NAME viene utilizzato per identificare il disco e deve essere unico. DIR è il punto di montaggio del disco nel file system.
È possibile cambiare il punto di montaggio secondo necessità, purché si mantenga fisso NAME.
Tuttavia, il percorso configurato deve puntare costantemente agli stessi dati sottostanti. Se il percorso contiene collegamenti simbolici, le loro destinazioni devono rimanere stabili. La modifica di tali symlink per cambiare la directory dei dati al volo non è supportata.
Si dovrebbe utilizzare un'opzione per ogni disco dati nell'array.
È possibile rinominare un disco in seguito modificando NAME direttamente nel file di configurazione e quindi eseguendo un comando sync. In caso di ridenominazione, l'associazione viene eseguita utilizzando l'UUID memorizzato dei dischi.
extra NAME DIR
Definisce il nome e il punto di montaggio di dischi aggiuntivi da monitorare con i comandi smart e probe.
Questo è utile per monitorare i dischi che non fanno parte dell' array ma sono necessari per il funzionamento del sistema, come il disco di avvio.
Si noti che tali dischi non sono influenzati dai comandi up e down perché si prevede che siano sempre in rotazione.
snapshot
Abilita l'uso degli snapshot del file system per i comandi sync, scrub, check e fix.
Quando abilitato, SnapRAID crea uno snapshot in sola lettura di ogni file system dati supportato all'inizio di un 'sync'. Ciò fornisce una vista stabile di ciascun file system, impedendo che modifiche successive cambino i dati utilizzati per il calcolo della parità.
Questo migliora significativamente il recupero: se un file viene eliminato dal file system live, rimane preservato nello snapshot. Ciò impedisce alla parità di diventare "corrotta" per quel blocco, assicurando che sia ancora possibile recuperare correttamente i dati se un altro disco si guasta.
Questa opzione si applica esclusivamente ai dischi dati formattati con i file system Btrfs, Bcachefs o ZFS in Linux e NTFS in Windows. I dischi di parità, o i dischi dati che utilizzano altri file system, utilizzeranno sempre la versione live del file system.
La creazione e l'eliminazione degli snapshot richiedono privilegi amministrativi. Assicurati che SnapRAID sia eseguito con i permessi necessari (es. sudo) quando questa opzione è abilitata.
Vedere la sezione SNAPSHOTS per una spiegazione dettagliata del ciclo di vita degli snapshot.
nohidden
Esclude tutti i file e le directory nascosti. In Unix, i file nascosti sono quelli che iniziano con .. In Windows, sono quelli con l'attributo nascosto.
exclude/include PATTERN
Definisce i pattern di file o directory da escludere o includere nel processo di sync. Tutti i pattern vengono elaborati nell'ordine specificato.
Se il primo pattern che corrisponde è un exclude, il file viene escluso. Se è un include, il file viene incluso. Se nessun pattern corrisponde, il file viene escluso se l'ultimo pattern specificato è un include, o incluso se l'ultimo pattern specificato è un exclude.
Si noti che il filtraggio avviene gerarchicamente durante l'attraversamento delle directory. Se una directory corrisponde a una regola exclude, l'intero sottoalbero viene saltato (potato), e le regole include per file o sottocartelle al suo interno non verranno valutate.
Vedere la sezione PATTERN per maggiori dettagli sulle specifiche del pattern.
Questa opzione può essere utilizzata più volte.
blocksize SIZE_IN_KIBIBYTES
Definisce la dimensione di blocco di base in kibibyte per la parità. Un kibibyte è 1024 byte.
La dimensione di blocco predefinita è 256, che dovrebbe funzionare nella maggior parte dei casi.
ATTENZIONE! Questa opzione è solo per esperti ed è vivamente sconsigliato modificare questo valore. Per modificare questo valore in futuro, sarà necessario ricreare l'intera parità!
Un motivo per utilizzare una dimensione di blocco diversa è se si hanno molti file piccoli, nell'ordine dei milioni.
Per ogni file, anche se solo pochi byte, viene allocato un intero blocco di parità e, con molti file, ciò può comportare uno spazio di parità inutilizzato significativo. Quando si riempie completamente il disco di parità, non è consentito aggiungere altri file ai dischi dati. Tuttavia, la parità sprecata non si accumula tra i dischi dati. Lo spazio sprecato risultante da un numero elevato di file su un disco dati limita solo la quantità di dati su quel disco dati, non gli altri.
Come approssimazione, si può presumere che metà della dimensione del blocco sia sprecata per ogni file. Ad esempio, con 100.000 file e una dimensione di blocco di 256 KiB, si sprecheranno 12,8 GB di parità, il che può comportare 12,8 GB in meno di spazio disponibile sul disco dati.
È possibile controllare la quantità di spazio sprecato su ogni disco utilizzando status. Questa è la quantità di spazio che è necessario lasciare libero sui dischi dati o utilizzare per i file non inclusi nell'array. Se questo valore è negativo, significa che si è vicini a riempire la parità e rappresenta lo spazio che è ancora possibile sprecare.
Per evitare questo problema, è possibile utilizzare una partizione più grande per la parità. Ad esempio, se la partizione di parità è 12,8 GB più grande dei dischi dati, si ha abbastanza spazio extra per gestire fino a 100.000 file su ogni disco dati senza alcuno spreco di spazio.
Un trucco per ottenere una partizione di parità più grande in Linux è formattarla con il comando:
mkfs.ext4 -m 0 -T largefile4 DEVICE
Ciò si traduce in circa l'1,5% di spazio extra, circa 60 GB per un disco da 4 TB, che consente circa 460.000 file su ogni disco dati senza alcuno spreco di spazio.
hashsize SIZE_IN_BYTES
Definisce la dimensione dell'hash in byte per i blocchi salvati.
La dimensione di hash predefinita è 16 byte (128 bit), che dovrebbe funzionare nella maggior parte dei casi.
ATTENZIONE! Questa opzione è solo per esperti ed è vivamente sconsigliato modificare questo valore. Per modificare questo valore in futuro, sarà necessario ricreare l'intera parità!
Un motivo per utilizzare una dimensione di hash diversa è se il sistema ha memoria limitata. Come regola generale, SnapRAID tipicamente richiede 1 GiB di RAM per ogni 16 TB di dati nell'array.
Nello specifico, per memorizzare gli hash dei dati, SnapRAID richiede circa TS*(1+HS)/BS byte di RAM, dove TS è la dimensione totale in byte dell'array di dischi, BS è la dimensione del blocco in byte e HS è la dimensione dell'hash in byte.
Ad esempio, con 8 dischi da 4 TB, una dimensione di blocco di 256 KiB (1 KiB = 1024 byte) e una dimensione di hash di 16, si ottiene:
RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB
Passando a una dimensione di hash di 8, si ottiene:
RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB
Passando a una dimensione di blocco di 512, si ottiene:
RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB
Passando sia a una dimensione di hash di 8 sia a una dimensione di blocco di 512, si ottiene:
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
autosave SIZE_IN_GIGABYTES
Salva automaticamente lo stato durante la sincronizzazione o lo scrubbing dopo la quantità specificata di GB elaborati. Questa opzione è utile per evitare di riavviare lunghi comandi sync da zero se interrotti da un arresto anomalo della macchina o qualsiasi altro evento.
temp_limit TEMPERATURE_CELSIUS
Imposta la temperatura massima del disco consentita in Celsius. Se specificato, SnapRAID controlla periodicamente la temperatura di tutti i dischi utilizzando lo strumento smartctl. Le temperature attuali dei dischi vengono visualizzate mentre SnapRAID è in funzione. Se un disco supera questo limite, tutte le operazioni si interrompono e i dischi vengono messi in stand-by (spin down) per la durata definita dall'opzione temp_sleep. Dopo il periodo di sonno, le operazioni riprendono, potenzialmente mettendosi in pausa di nuovo se il limite di temperatura viene raggiunto ancora una volta.
Durante il funzionamento, SnapRAID analizza anche la curva di riscaldamento di ciascun disco e stima la temperatura costante a lungo termine che dovrebbero raggiungere se l'attività continua. La stima viene eseguita solo dopo che la temperatura del disco è aumentata quattro volte, garantendo che siano disponibili abbastanza punti dati per stabilire una tendenza affidabile. Questa temperatura costante prevista è mostrata tra parentesi accanto al valore attuale e aiuta a valutare se il raffreddamento del sistema è adeguato. Questa temperatura stimata è solo a scopo informativo e non ha alcun effetto sul comportamento di SnapRAID. Le azioni del programma si basano esclusivamente sulle temperature effettive misurate del disco.
Per eseguire questa analisi, SnapRAID necessita di un riferimento per la temperatura del sistema. Tenta prima di leggerla dai sensori hardware disponibili. Se non è possibile accedere a nessun sensore di sistema, utilizza la temperatura del disco più bassa misurata all'inizio dell'esecuzione come riferimento di riserva.
Normalmente, SnapRAID mostra solo la temperatura del disco più caldo. Per visualizzare la temperatura di tutti i dischi, utilizzare l'opzione -A o --stats.
temp_sleep TIME_IN_MINUTES
Imposta il tempo di stand-by, in minuti, quando il limite di temperatura viene raggiunto. Durante questo periodo, i dischi rimangono fermi (spin down). Il valore predefinito è 5 minuti.
pool DIR
Definisce la directory di pooling in cui viene creata la vista virtuale dell'array di dischi utilizzando il comando pool.
La directory deve già esistere.
share UNC_DIR
Definisce il percorso UNC di Windows necessario per accedere ai dischi da remoto.
Se questa opzione è specificata, i collegamenti simbolici creati nella directory pool utilizzano questo percorso UNC per accedere ai dischi. Senza questa opzione, i collegamenti simbolici generati utilizzano solo percorsi locali, il che non consente la condivisione della directory pool sulla rete.
I collegamenti simbolici sono formati utilizzando il percorso UNC specificato, aggiungendo il nome del disco come specificato nell'opzione data e infine aggiungendo la directory e il nome del file.
Questa opzione è richiesta solo per Windows.
smartctl DISK/PARITY OPTIONS...
Definisce opzioni smartctl personalizzate per ottenere gli attributi SMART per ogni disco. Ciò potrebbe essere richiesto per controller RAID e alcuni dischi USB che non possono essere rilevati automaticamente. Il segnaposto %s viene sostituito dal nome del dispositivo, ma è facoltativo per dispositivi fissi come i controller RAID.
DISK è lo stesso nome del disco specificato nell'opzione data. PARITY è uno dei nomi di parità: parity, 2-parity, 3-parity, 4-parity, 5-parity, 6-parity o z-parity.
Nelle OPTIONS specificate, la stringa %s viene sostituita dal nome del dispositivo. Per i controller RAID, il dispositivo è probabilmente fisso e potrebbe non essere necessario utilizzare %s.
È inoltre possibile specificare una stringa di opzioni di informazioni personalizzate tramite il tag [info: ...] per sostituire l'opzione -a predefinita.
Fare riferimento alla documentazione di smartmontools per le possibili opzioni:
https://www.smartmontools.org/wiki/Supported_RAID-Controllers https://www.smartmontools.org/wiki/Supported_USB-Devices
Ad esempio:
smartctl d1 [info: -H -i -c -A] -d sat %s smartctl parity -d sat %s
smartignore DISK/PARITY ATTR [ATTR...]
Ignora l'attributo SMART specificato durante il calcolo della probabilità di guasto del disco. Questa opzione è utile se un disco segnala valori insoliti o fuorvianti per un particolare attributo.
DISK è lo stesso nome del disco specificato nell'opzione data. PARITY è uno dei nomi di parità: parity, 2-parity, 3-parity, 4-parity, 5-parity, 6-parity o z-parity. Il valore speciale * può essere utilizzato per ignorare l'attributo su tutti i dischi.
È possibile specificare più attributi separati da spazi. Ciascun attributo può essere specificato come un numero da 1 a 255, o come un nome insensibile al maiuscolo/minuscolo (ad es. Current_Pending_Sector).
Ad esempio, per ignorare gli attributi Current Pending Sector Count e Reallocated Sectors Count su tutti i dischi per numero o nome:
smartignore * 197 5 smartignore * Current_Pending_Sector Reallocated_Sector_Ct
Per ignorarli solo sul primo disco di parità:
smartignore parity 197 5
Esempi (Examples)
Un esempio di configurazione tipica per Unix è:
parity /mnt/diskp/snapraid.parity content /mnt/diskp/snapraid.content content /var/snapraid/snapraid.content data d1 /mnt/disk1/ data d2 /mnt/disk2/ data d3 /mnt/disk3/ exclude /lost+found/ exclude /tmp/ smartctl d1 [info: -H -i -c -A] -d sat %s smartctl d2 -d usbjmicron %s smartctl parity -d areca,1/1 /dev/sg0 smartctl 2-parity -d areca,2/1 /dev/sg0
Un esempio di configurazione tipica per Windows è:
parity E:\snapraid.parity content E:\snapraid.content content C:\snapraid\snapraid.content data d1 G:\array\ data d2 H:\array\ data d3 I:\array\ exclude Thumbs.db exclude \$RECYCLE.BIN exclude \System Volume Information smartctl d1 [info: -H -i -c -A] -d sat %s smartctl d2 -d usbjmicron %s smartctl parity -d areca,1/1 /dev/arcmsr0 smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshot (Snapshots)
Se l'opzione snapshot è abilitata nella configurazione, SnapRAID utilizza gli snapshot del file system per mantenere stabili i dati letti durante un'operazione, anche quando i file sui file system live vengono successivamente modificati o eliminati.
La gestione degli snapshot è completamente automatica e trasparente. È possibile continuare a utilizzare SnapRAID esattamente come prima, con la protezione aggiuntiva fornita dagli snapshot gestiti interamente in background.
Ciò fornisce due vantaggi primari:
Gli snapshot vengono creati solo per i dischi dati e solo se il file system sottostante supporta questa funzionalità. I dischi di parità usano sempre il file system live.
Attualmente, questo è supportato su Btrfs, Bcachefs e ZFS in Linux e su NTFS in Windows.
È possibile combinare dischi dati con file system diversi. Solo quelli che supportano gli snapshot li utilizzeranno, mentre gli altri dischi continueranno a operare direttamente sul file system live.
La creazione e l'eliminazione degli snapshot richiedono privilegi amministrativi. Assicurati che SnapRAID sia eseguito con i permessi necessari (es. sudo) quando gli snapshot sono abilitati.
Comportamento dei comandi con gli snapshot (Command Behavior with Snapshots)
I comandi sync e scrub utilizzano snapshot per i dischi dati i cui file system li supportano. Su un disco con snapshot, il comando vede un'immagine del file system stabile e non influenzata da modifiche simultanee sul file system live. Durante un sync, viene creato un nuovo snapshot in modo indipendente per ciascun file system dati supportato. Questi snapshot forniscono collettivamente i dati utilizzati per il calcolo della parità. Al contrario, il comando scrub utilizza l'ultimo snapshot, quello creato durante il sync più recente, per mantenere un punto di riferimento affidabile che corrisponda alla parità esistente.
Per i comandi check e fix, l'uso dell'ultimo snapshot dipende dal fatto che vengano presi di mira dischi specifici utilizzando l'opzione -d, --filter-disk.
Un disco esplicitamente selezionato tramite -d (il "target" dell'operazione) utilizza sempre il file system live. Per fix, questo consente di ripristinare i dati sul disco sostitutivo attivo. Per check, consente di simulare l'operazione fix nelle stesse condizioni.
Tutti gli altri dischi dati (i dischi di "riferimento") verranno acceduti tramite i loro snapshot. Ciò garantisce che anche se si stanno modificando file sui dischi integri mentre è in corso un recupero, SnapRAID ha un riferimento stabile e congelato per risolvere le equazioni di parità.
Se non viene fornita alcuna opzione -d, SnapRAID assume che l'operazione si applichi all'intero array; in questo caso, check e fix utilizzeranno esclusivamente i file system live.
Tutti gli altri comandi operano esclusivamente sul file system live.
Ciclo di vita degli snapshot (Snapshots Lifecycle)
SnapRAID gestisce tre snapshot specifici, stable, pending e scan, all'interno di una directory nascosta alla radice di ogni sottovolume dati. In Btrfs, Bcachefs e NTFS viene utilizzata la directory .snapraid/, in ZFS quella standard .zfs/snapshot/.
Lo snapshot stable rappresenta lo stato dell'ultimo sync completato con successo, contenente gli esatti dati utilizzati per computare la parità corrente. Funge da fonte di dati primaria per i comandi scrub, check e fix.
Lo snapshot scan è un'immagine temporanea creata all'inizio di un sync per fornire uno stato congelato per la scansione e il calcolo della parità. Dopo la scansione e il salvataggio del nuovo stato del contenuto, sostituisce il precedente snapshot pending.
Lo snapshot pending è l'immagine utilizzata da un sync interrotto. Al completamento con successo dell'operazione, il precedente snapshot stable viene eliminato e lo snapshot pending viene promosso per prendere il suo posto come nuovo riferimento stabile.
Se un sync viene interrotto, lo snapshot pending viene preservato. I successivi comandi scrub, check e fix utilizzeranno questo snapshot in sospeso poiché corrisponde allo stato del file system registrato nel file .content, anche se la parità è sincronizzata solo parzialmente.
In caso di interruzione del sync, anche i comandi check e fix leggono dallo snapshot stable per recuperare i blocchi di dati da file che sono stati aggiornati o eliminati durante il sync. Ciò è possibile perché il file .content conserva i metadati per tutti i file modificati o eliminati durante l'intero processo di sync. Queste informazioni storiche vengono cancellate solo al termine di un sync avvenuto con successo e quando viene salvata la versione finale del file .content.
Se un sync viene riavviato dopo un'interruzione, lo snapshot pending esistente viene eliminato e ne viene creato uno nuovo per acquisire lo stato corrente del file system live. Tuttavia, se un sync viene interrotto, evitare di modificare, eliminare, sostituire o spostare i file finché un sync successivo non viene completato con successo. La parità potrebbe ancora contenere blocchi calcolati dallo snapshot utilizzato dal sync interrotto. Un sync successivo potrebbe sostituire tale snapshot, rendendo le versioni intermedie dei file non disponibili per il recupero.
Backup esterni con snapshot del filesystem (External backups with filesystem snapshots)
Quando gli snapshot del filesystem sono abilitati, SnapRAID accede o crea gli snapshot alla radice di ciascun sottovolume, volume o dataset di dati.
Un modo semplice per evitare interferenze con gli strumenti esterni consiste nel far puntare la configurazione data a una sottodirectory ordinaria all'interno del subvolume o del volume (ad esempio /mnt/subvol/data invece di /mnt/subvol). SnapRAID crea sempre la directory degli snapshot alla radice del subvolume (ad esempio /mnt/subvol/.snapraid/), lasciando pulita la sottodirectory dei dati in modo che gli snapshot rimangano all'esterno e invisibili agli strumenti di backup che operano al suo interno.
Altrimenti, se la directory data configurata è essa stessa la radice del subvolume o del volume, SnapRAID crea una directory .snapraid/ direttamente al suo interno (su Btrfs, Bcachefs e NTFS). Sebbene SnapRAID escluda automaticamente questa directory dalla propria scansione, gli strumenti di backup esterni o i programmi di sincronizzazione dei file la incontreranno. Se non viene esclusa, potrebbero entrare negli snapshot o nei collegamenti di directory e copiare l'intero albero dei dati congelato, duplicando i dati ed esaurendo lo spazio di archiviazione dei backup. Configurare sempre gli strumenti di backup esterni in modo da escludere la directory .snapraid/.
Su ZFS, gli snapshot sono esposti tramite la directory virtuale standard .zfs/snapshot/ anziché .snapraid/. Di default (snapdir=hidden), ZFS nasconde questa directory dall'elenco delle directory, quindi gli strumenti di backup esterni non la attraverseranno. Se è stato abilitato snapdir=visible, assicurarsi che gli strumenti di backup escludano la directory .zfs/.
Pattern
I pattern offrono un modo flessibile per filtrare i file da includere o escludere. Usando i caratteri globbing, è possibile definire regole che corrispondano a nomi di file specifici o a intere strutture di directory senza elencare manualmente ogni percorso.
Il punto interrogativo ? corrisponde a qualsiasi carattere singolo eccetto il separatore di directory. Questo lo rende utile per far corrispondere nomi di file con caratteri variabili mantenendo il pattern confinato a un singolo livello di directory.
L'asterisco singolo * corrisponde a qualsiasi sequenza di caratteri, ma come il punto interrogativo, non attraversa mai i confini delle directory. Si ferma allo slash in avanti, rendendolo adatto per la corrispondenza all'interno di un singolo componente del percorso. Questo è il comportamento standard dei wildcard familiare dal globbing della shell.
Il carattere jolly doppio asterisco ** corrisponde attraverso i separatori di directory solo quando è adiacente a un separatore di directory (preceduto o seguito da uno slash). In questa forma, corrisponde a zero o più caratteri attraverso i livelli di directory. Per esempio, foo/**/bar corrisponde a foo/bar, foo/a/bar e foo/a/b/bar; **/build corrisponde a build e foo/bar/build; e src/**.js corrisponde a src/main.js e src/ui/components/main.js. La forma autonoma /**/ non è accettata come pattern completo.
Quando ** non è adiacente a uno slash, si comporta come * e non corrisponde ai separatori di directory. Per esempio, **.jpg corrisponde a photo.jpg nella directory corrente, ma non corrisponde a dir/photo.jpg. Usa **/*.jpg per questo scopo.
Le classi di caratteri che usano le parentesi quadre [] corrispondono a un singolo carattere da un set o intervallo specificato. Come gli altri pattern a carattere singolo, esse non corrispondono ai separatori di directory. Le classi supportano intervalli e la negazione usando un punto esclamativo.
La distinzione fondamentale da ricordare è che *, ? e le classi di caratteri rispettano tutti i confini delle directory e corrispondono solo all'interno di un singolo componente del percorso, mentre ** può corrispondere attraverso i separatori di directory solo quando è adiacente a uno slash.
Esistono quattro diversi tipi di pattern:
Quando si specifica un percorso assoluto che inizia con /, viene applicato alla directory radice dell'array, non alla directory radice del file system locale.
In Windows, è possibile utilizzare il backslash \ invece dello slash in avanti /. Le directory di sistema di Windows, le junction, i punti di montaggio e altre directory speciali di Windows sono trattati come file, il che significa che per escluderli, è necessario utilizzare una regola di file, non una di directory.
Se il nome del file contiene un carattere *, ?, [ o ], è necessario eseguirne l'escape per evitare che venga interpretato come un carattere di globbing. In Unix, il carattere di escape è \; in Windows, è ^. Quando il pattern è sulla riga di comando, è necessario raddoppiare il carattere di escape per evitare che venga interpretato dalla shell dei comandi.
Nel file di configurazione, è possibile utilizzare diverse strategie per filtrare i file da elaborare. L'approccio più semplice è utilizzare solo regole exclude per rimuovere tutti i file e le directory che non si desidera elaborare. Ad esempio:
# Esclude qualsiasi file denominato *.unrecoverable exclude *.unrecoverable # Esclude la directory radice /lost+found exclude /lost+found/ # Esclude qualsiasi sottodirectory denominata tmp exclude tmp/
L'approccio opposto è definire solo i file che si desidera elaborare, utilizzando solo regole include. Ad esempio:
# Include solo alcune directory include /movies/ include /musics/ include /pictures/
L'approccio finale è mescolare regole exclude e include. In questo caso, l'ordine delle regole è importante. Le regole precedenti hanno la precedenza su quelle successive. Per semplificare, è possibile elencare prima tutte le regole exclude e poi tutte le regole include. Ad esempio:
# Esclude qualsiasi file denominato *.unrecoverable exclude *.unrecoverable # Esclude qualsiasi sottodirectory denominata tmp exclude tmp/ # Include solo alcune directory include /movies/ include /musics/ include /pictures/
Si noti che l'esclusione di una directory (utilizzando DIR/ o /PATH/DIR/) impedisce a SnapRAID di entrare e scansionare quella directory. Pertanto, non è possibile re-includere un file o una sottodirectory all'interno di una cartella genitore esclusa, poiché il suo contenuto non viene mai scansionato.
Ad esempio, la seguente configurazione NON includerà file.dat perché /keep/ viene saltata prima che file.dat possa essere esaminato:
# NON funziona: /keep/ viene saltata completamente include /keep/file.dat exclude /keep/
Per escludere i file all'interno di una cartella mantenendone alcuni specifici, specificare il pattern dei file anziché escludere la directory stessa:
# Funziona: /keep/ viene attraversata, ma gli altri file sono esclusi include /keep/file.dat exclude /keep/*
Sulla riga di comando, utilizzando l'opzione -f, è possibile utilizzare solo pattern include. Ad esempio:
# Controlla solo i file .mp3. # In Unix, utilizzare le virgolette per evitare l'espansione # del globbing da parte della shell. snapraid -f "*.mp3" check
In Unix, quando si utilizzano caratteri di globbing sulla riga di comando, è necessario citarli per impedire alla shell di espanderli.
File da ignorare (Ignore File)
In aggiunta alle regole globali nel file di configurazione, è possibile inserire file .snapraidignore in qualsiasi directory all'interno dell'array per definire regole di esclusione decentralizzate.
Le regole definite in .snapraidignore vengono applicate dopo le regole nel file di configurazione. Ciò significa che hanno una priorità più alta e possono essere utilizzate per escludere file che erano stati precedentemente inclusi dalla configurazione globale. In pratica, se una regola locale corrisponde, il file viene escluso indipendentemente dalle impostazioni di inclusione globali.
La logica dei pattern in .snapraidignore rispecchia la configurazione globale ma vincola i pattern alla directory in cui si trova il file:
A differenza della configurazione globale, i file .snapraidignore supportano solo regole di esclusione; non è possibile utilizzare pattern include o negazioni (!).
Ad esempio, se hai un .snapraidignore in /mnt/disk1/projects/:
# Esclude SOLO /mnt/disk1/projects/output.bin /output.bin # Esclude qualsiasi directory chiamata build all'interno di projects/ build/ # Esclude qualsiasi file .tmp all'interno di projects/ o delle sue sottocartelle *.tmp
Contenuto (Content)
SnapRAID memorizza l'elenco e i checksum dei file nel file di contenuto.
È un file binario che elenca tutti i file presenti nell'array di dischi, insieme a tutti i checksum per verificarne l'integrità.
Il file di contenuto viene letto e scritto dai comandi sync, scrub, touch e rehash. Viene letto dai comandi status, diff, check, fix, list, dup, locate e pool, e viene completamente ignorato dai comandi smart, probe, up, down e devices.
Parità (Parity)
SnapRAID memorizza le informazioni di parità dell'array nei file di parità.
Questi sono file binari contenenti la parità calcolata di tutti i blocchi definiti nel file content.
Questi file vengono letti e scritti dai comandi sync e fix e solo letti dai comandi scrub e check.
Codifica (Encoding)
SnapRAID in Unix ignora qualsiasi codifica. Legge e memorizza i nomi dei file con la stessa codifica utilizzata dal file system.
In Windows, tutti i nomi letti dal file system vengono convertiti e elaborati in formato UTF-8.
Per avere i nomi dei file stampati correttamente, è necessario impostare la console di Windows in modalità UTF-8 con il comando chcp 65001 e utilizzare un carattere TrueType come Lucida Console come carattere della console. Questo influisce solo sui nomi dei file stampati; se si reindirizza l'output della console a un file, il file risultante è sempre in formato UTF-8.
Codice di uscita (Exit Code)
SnapRAID termina con i seguenti codici di errore:
Problemi noti (Known Issues)
Limiti del filesystem
SnapRAID non attraversa i confini di filesystem, punti di mount o subvolume durante la scansione di un disco dati. Quando viene rilevato un tale confine, SnapRAID segnala un WARNING e non prosegue la scansione al suo interno.
I file che si trovano oltre tali confini non sono inclusi nel disco dati e devono essere configurati separatamente se devono essere protetti.
Punti di mount con snapshot del filesystem
Quando le snapshot del filesystem sono abilitate, i punti di mount annidati e i bind mount all'interno di un disco dati non sono supportati.
I punti di mount fanno parte del namespace di mount del sistema in esecuzione e non vengono preservati nelle snapshot del filesystem. Di conseguenza, durante la scansione di una snapshot, una directory nascosta da un punto di mount nel filesystem live potrebbe diventare visibile.
Non inserire punti di mount annidati o bind mount all'interno dei dischi dati quando le snapshot del filesystem sono abilitate.
Configurazioni multiple con snapshot del filesystem
Il supporto per gli snapshot non può essere condiviso in sicurezza da più configurazioni SnapRAID indipendenti che utilizzano lo stesso namespace di snapshot del filesystem.
Su Btrfs e Bcachefs, una sola configurazione SnapRAID con supporto snapshot abilitato può utilizzare directory dati all'interno dello stesso subvolume. Su ZFS, la stessa restrizione si applica a un dataset, e su NTFS a un volume.
Le configurazioni multiple che condividono lo stesso namespace di snapshot utilizzano gli stessi snapshot stable, pending e scan. L'esecuzione di una configurazione può quindi sostituire o eliminare gli snapshot di ripristino richiesti da un'altra.
Modifiche ai file sul posto senza variazione di data/ora
SnapRAID rileva le modifiche ai file confrontando le dimensioni dei file e i timestamp di modifica (mtime).
Se un'applicazione modifica un file in-place senza alterarne la dimensione o aggiornarne il timestamp di modifica, "diff" e "sync" non rileveranno che il file è cambiato e la sua parità non verrà aggiornata.
Per garantire che SnapRAID riconosca tali modifiche, aggiornare il timestamp di modifica del file (ad esempio con l'utilità "touch"). Altrimenti, la differenza verrà rilevata solo come mancata corrispondenza dell'hash durante un successivo "scrub" o "check".
Corrispondenza maiuscole/minuscole non ASCII in Windows
SnapRAID utilizza la codifica UTF-8 standard e prevedibile su tutte le piattaforme, limitando la corrispondenza senza distinzione tra maiuscole e minuscole ai caratteri ASCII.
I filesystem di Windows soffrono della scelta progettuale obsoleta di imporre l'insensibilità al maiuscolo/minuscolo sui nomi di file Unicode tramite tabelle di conversione arbitrarie e dipendenti dal sistema. Di conseguenza, Windows maschera la realtà del filesystem trattando sequenze di byte Unicode completamente diverse come se fossero lo stesso file.
Ad esempio, À.txt e à.txt sono nomi Unicode distinti, eppure Windows illogicamente li tratta come identici, mentre SnapRAID ne preserva la reale distinzione.
Questa limitazione è causata dalla gestione incoerente dei nomi di file Unicode da parte di Windows e dalla sua insistenza nell'applicare alias insensibili al maiuscolo/minuscolo. Per prevenire discrepanze dovute alla conversione del maiuscolo/minuscolo di Windows, specificare sempre l'esatta combinazione di maiuscole/minuscole per qualsiasi carattere non ASCII nei percorsi di configurazione e nei filtri.
Recupero con fix parziale
Quando fix viene limitato usando -S, --start o -B, --count, SnapRAID opera solo sui blocchi selezionati e non esegue la finalizzazione a livello di file né la quarantena.
Se il recupero produce dati "best-effort" che non possono essere provati come rappresentativi del contenuto corrente, tali blocchi potrebbero comunque essere scritti con il normale nome di file. L'incertezza associata a questi blocchi recuperati non persiste dopo il termine del comando.
Di conseguenza, un successivo fix tratterà questi blocchi leggibili come dati di file validi e non tenterà di recuperarli nuovamente. Ciò può far sì che un recupero successivo segnali il successo pur lasciando nel file dati incompleti o obsoleti.
Le opzioni -S e -B sono destinate esclusivamente al recupero manuale avanzato, tipicamente dopo che un normale fix è fallito. Se un fix parziale segnala dati irrecuperabili, rimuovere o rinominare i file interessati prima di tentare un altro recupero, oppure verificarne manualmente il contenuto.
Hard link NTFS e percorsi esclusi
Su NTFS, le voci di directory memorizzano nella cache la dimensione del file e i timestamp in modo indipendente per ciascun hard link. Quando un file viene modificato tramite un link, le voci di directory degli altri link che puntano allo stesso file possono mantenere metadati obsoleti finché non vengono consultate.
SnapRAID rileva e normalizza automaticamente questa condizione ogni volta che incontra almeno due hard link allo stesso file durante una scansione. Tuttavia, se viene scansionato un solo hard link mentre gli altri sono esclusi dai filtri o risiedono all'esterno del percorso del disco dati, SnapRAID non può rilevare la collisione di inode e si affida ai metadati nella cache dell'unico link visibile.
Di conseguenza, le modifiche apportate tramite un hard link escluso o esterno potrebbero non essere notate da SnapRAID finché i metadati del link incluso non vengono aggiornati dal sistema operativo (ad esempio quando il file viene consultato o aperto tramite tale percorso).
Per evitare questa limitazione, evitare di modificare i file protetti tramite hard link esclusi da SnapRAID, oppure assicurarsi che tutti gli hard link a un file siano inclusi nella scansione in modo che SnapRAID possa normalizzarli.
Recupero dopo un sync a parità multipla interrotto
In un array con più dischi di parità, un sync interrotto può lasciare i livelli di parità temporaneamente disallineati tra loro. Ad esempio, la parità 1 potrebbe già contenere i dati appena aggiornati, mentre la parità 2 contiene ancora i vecchi dati.
Durante check o fix, SnapRAID prova diverse combinazioni di parità e convalida i dati ricostruiti rispetto agli hash dei blocchi noti (che coprono l'intero blocco, tipicamente 256 KiB).
Se SnapRAID tenta una ricostruzione utilizzando una combinazione incoerente di parità vecchia e nuova, le equazioni lineari del RAID produrranno dati errati. Affinché questa combinazione non valida venga accettata erroneamente, le equazioni dovrebbero accidentalmente ricostruire almeno un blocco completo da 256 KiB in modo così perfetto da far corrispondere il suo hash, mentre altri blocchi non sincronizzati nella stessa stripe vengono ricostruiti con dati errati.
Questo scenario non dipende da una collisione di hash; piuttosto, le equazioni di parità mista dovrebbero produrre casualmente l'esatto contenuto originale del blocco da 256 KiB. Sebbene matematicamente possibile con dati appositamente creati o fortemente ripetitivi, è praticamente impossibile con dati reali.
Se tutti i dischi sono integri, completare il sync interrotto prima di apportare ulteriori modifiche rimuove questa ambiguità. Se un disco si è guastato ed è necessario il recupero, evitare di modificare i dischi dati prima di eseguire check o fix.
Nomi di file e directory riservati
SnapRAID riserva alcuni nomi di file, directory e snapshot per le proprie operazioni interne. Non usare questi nomi per i dati utente:
L'uso di questi nomi per dati non correlati può causare l'ignoramento, l'errata interpretazione come metadati, la sovrascrittura, la ridenominazione o l'eliminazione di file o snapshot.
Su Windows, tutte le varianti di maiuscole e minuscole sono anch'esse riservate, anche nelle directory NTFS configurate per il funzionamento con distinzione tra maiuscole e minuscole (ad esempio, .SNAPRAIDIGNORE, .SnapRaid, CONTENT.TMP e CONTENT.Lock).
Traduzione (Translation)
Questo documento è una traduzione automatica del manuale in inglese. Fare riferimento al manuale in inglese per la versione ufficiale.
Vedi anche (See Also)
snapraid_log(1), snapraidd(1), rsync(1)