mirror of
https://github.com/amadvance/snapraid.git
synced 2026-10-26 10:51:54 -04:00
2000 lines
81 KiB
Text
2000 lines
81 KiB
Text
===================================
|
|
Backup SnapRAID per Array di Dischi
|
|
===================================
|
|
|
|
|
|
1 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]
|
|
|
|
|
|
2 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/
|
|
|
|
|
|
3 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.
|
|
|
|
|
|
4 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`.
|
|
|
|
4.1 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`.
|
|
|
|
4.2 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
|
|
|
|
4.3 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
|
|
|
|
4.4 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.
|
|
|
|
---- 4.4.1 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.
|
|
|
|
---- 4.4.2 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`!
|
|
|
|
---- 4.4.3 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.
|
|
|
|
---- 4.4.4 PASSO 4 -> Sincronizzazione (Sync) ----
|
|
Eseguire il comando `sync` per risincronizzare l'array con il nuovo disco.
|
|
|
|
snapraid sync
|
|
|
|
Se tutto è recuperato, questo comando è immediato.
|
|
|
|
|
|
5 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.
|
|
|
|
5.1 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.
|
|
|
|
5.2 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:
|
|
logfail - In passato, alcuni attributi erano inferiori alla
|
|
soglia.
|
|
logerr - Il log degli errori del dispositivo contiene errori.
|
|
selferr - Il log dell'autotest del dispositivo contiene errori.
|
|
|
|
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.
|
|
|
|
5.3 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.
|
|
|
|
5.4 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.
|
|
|
|
5.5 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.
|
|
|
|
5.6 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:
|
|
equal - File invariati rispetto a prima.
|
|
added - File aggiunti che non erano presenti prima.
|
|
removed - File rimossi.
|
|
updated - File con dimensioni o timestamp diversi, il che
|
|
significa che sono stati modificati.
|
|
moved - File spostati in una directory diversa sullo stesso
|
|
disco. Sono identificati dall'avere lo stesso nome,
|
|
dimensioni, timestamp e inode, ma una directory diversa.
|
|
copied - File copiati sullo stesso disco o su un disco diverso dove il
|
|
file originale esiste ancora.
|
|
Sono identificati dall'avere lo stesso nome, dimensione e timestamp.
|
|
Se il timestamp al sottomultiplo del secondo è zero,
|
|
il percorso completo deve corrispondere per essere
|
|
identificato, non solo il nome.
|
|
relocated - File spostati sullo stesso disco o su un disco
|
|
diverso dove l'originale è scomparso.
|
|
Sono identificati dall'avere lo stesso nome, dimensione
|
|
e timestamp.
|
|
Se il timestamp al sottomultiplo del secondo è zero,
|
|
il percorso completo deve corrispondere per essere
|
|
identificato.
|
|
A differenza dei file 'moved' sullo stesso disco,
|
|
i file ricollocati hanno un inode diverso.
|
|
restored - File con un inode diverso ma directory,
|
|
nome, dimensione e timestamp corrispondenti.
|
|
Questi sono solitamente file ripristinati dopo essere
|
|
stati eliminati.
|
|
|
|
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.
|
|
|
|
5.7 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.
|
|
|
|
5.8 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.
|
|
full - Esegue lo scrub di tutto.
|
|
0-100 - Esegue lo scrub della percentuale specificata di blocchi.
|
|
|
|
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.
|
|
|
|
5.9 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.
|
|
|
|
5.10 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.
|
|
|
|
5.11 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.
|
|
|
|
5.12 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.
|
|
|
|
5.13 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.
|
|
|
|
5.14 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.
|
|
|
|
5.15 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.
|
|
|
|
5.16 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.
|
|
|
|
5.17 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.
|
|
|
|
|
|
6 OPZIONI (OPTIONS)
|
|
===================
|
|
|
|
SnapRAID fornisce le seguenti opzioni:
|
|
|
|
-c, --conf CONFIG
|
|
Seleziona il file di configurazione da utilizzare. Se non
|
|
specificato, 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`.
|
|
|
|
-f, --filter PATTERN
|
|
Filtra i file da elaborare in `check` e `fix`.
|
|
Vengono elaborati solo i file che corrispondono al pattern
|
|
specificato.
|
|
Questa opzione può essere utilizzata più volte.
|
|
Vedere la sezione PATTERN per maggiori dettagli sulle
|
|
specifiche del pattern.
|
|
In Unix, assicurarsi che i caratteri di globbing siano citati
|
|
se usati.
|
|
Questa opzione può essere utilizzata solo con `check` e `fix`.
|
|
Non può essere utilizzata con `sync` e `scrub`, poiché elaborano
|
|
sempre l'intero array.
|
|
|
|
-d, --filter-disk NAME
|
|
Filtra i dischi da elaborare in `check`, `fix`, `up` e `down`.
|
|
È necessario specificare un nome di disco come definito nel file
|
|
di configurazione.
|
|
È anche possibile specificare i dischi di parità con i nomi:
|
|
`parity`, `2-parity`, `3-parity`, ecc., per limitare le operazioni
|
|
a un disco di parità specifico.
|
|
Se si combinano più opzioni --filter, --filter-disk e
|
|
--filter-missing, vengono selezionati solo i file che corrispondono
|
|
a tutti i filtri.
|
|
Questa opzione può essere utilizzata più volte.
|
|
Questa opzione può essere utilizzata solo con `check`, `fix`,
|
|
`up` e `down`.
|
|
Non può essere utilizzata con `sync` e `scrub`, poiché elaborano
|
|
sempre l'intero array.
|
|
|
|
-m, --filter-missing
|
|
Filtra i file da elaborare in `check` e `fix`.
|
|
Vengono elaborati solo i file mancanti o eliminati dall'array.
|
|
Quando usato con `fix`, questo agisce come un comando di
|
|
`undelete` (annullamento eliminazione).
|
|
Se si combinano più opzioni --filter, --filter-disk e
|
|
--filter-missing, vengono selezionati solo i file che corrispondono
|
|
a tutti i filtri.
|
|
Questa opzione può essere utilizzata solo con `check` e `fix`.
|
|
Non può essere utilizzata con `sync` e `scrub`, poiché elaborano
|
|
sempre l'intero array.
|
|
|
|
-e, --filter-error
|
|
Elabora i file con errori in `check` e `fix`.
|
|
Elabora solo i file che hanno blocchi contrassegnati con errori
|
|
silenti o di input/output durante `sync` e `scrub`, come
|
|
elencato in `status`.
|
|
Questa opzione può essere utilizzata solo con `check` e `fix`.
|
|
|
|
-p, --plan PERC|bad|new|full
|
|
Seleziona il piano di scrub. Se PERC è un valore numerico da 0 a
|
|
100, viene interpretato come la percentuale di blocchi da
|
|
sottoporre a scrub.
|
|
Invece di una percentuale, è possibile specificare un piano:
|
|
`bad` esegue lo scrub dei blocchi danneggiati, `new` esegue lo scrub
|
|
dei blocchi non ancora sottoposti a scrub, e `full` esegue lo
|
|
scrub di tutto.
|
|
Questa opzione può essere utilizzata solo con `scrub`.
|
|
|
|
-o, --older-than DAYS
|
|
Seleziona la parte più vecchia dell'array da elaborare in `scrub`.
|
|
DAYS è l'età minima in giorni per un blocco da sottoporre a
|
|
scrub; il valore predefinito è 10.
|
|
I blocchi contrassegnati come `bad` vengono sempre sottoposti a scrub
|
|
indipendentemente da questa opzione.
|
|
Questa opzione può essere utilizzata solo con `scrub`.
|
|
|
|
-a, --audit-only
|
|
In `check`, verifica l'hash dei file senza
|
|
controllare i dati di parità.
|
|
Se si è interessati solo al controllo dei dati del file, questa
|
|
opzione può velocizzare significativamente il processo di controllo.
|
|
Questa opzione può essere utilizzata solo con `check`.
|
|
|
|
-h, --pre-hash
|
|
In `sync`, esegue una fase preliminare di hashing di tutti i nuovi
|
|
dati per una verifica aggiuntiva prima del calcolo della parità.
|
|
Di solito, in `sync`, non viene eseguito alcun hashing preliminare
|
|
e i nuovi dati vengono sottoposti a hash subito prima del calcolo
|
|
della parità quando vengono letti per la prima volta.
|
|
Questo processo si verifica quando il sistema è sotto
|
|
carico pesante, con tutti i dischi che girano e una CPU occupata.
|
|
Questa è una condizione estrema per la macchina e, se presenta un
|
|
problema hardware latente, gli errori silenti potrebbero non
|
|
essere rilevati perché i dati non sono ancora stati sottoposti a hash.
|
|
Per evitare questo rischio, è possibile abilitare la modalità
|
|
`pre-hash` per far leggere tutti i dati due volte per garantirne
|
|
l'integrità.
|
|
Questa opzione verifica anche i file spostati all'interno dell'array
|
|
per garantire che l'operazione di spostamento sia andata a buon fine
|
|
e, se necessario, consente di eseguire un'operazione di fix
|
|
prima di procedere.
|
|
Questa opzione può essere utilizzata solo con `sync`.
|
|
|
|
-i, --import DIR
|
|
Importa dalla directory specificata tutti i file eliminati
|
|
dall'array dopo l'ultimo `sync`.
|
|
Se si hanno ancora tali file, possono essere utilizzati da `check`
|
|
e `fix` per migliorare il processo di recupero.
|
|
I file vengono letti, anche nelle sottodirectory, e sono
|
|
identificati indipendentemente dal loro nome.
|
|
Questa opzione può essere utilizzata solo con `check` e `fix`.
|
|
|
|
-s, --spin-down-on-error
|
|
In caso di errore, ferma (spin down) tutti i dischi gestiti prima
|
|
di uscire con un codice di stato non zero. Ciò impedisce alle unità
|
|
di rimanere attive e in rotazione dopo un'operazione interrotta,
|
|
contribuendo a evitare inutili accumuli di calore e consumo di
|
|
energia. Utilizzare questa opzione per garantire che i dischi siano
|
|
arrestati in modo sicuro anche in caso di errore di un comando.
|
|
|
|
-w, --bw-limit RATE
|
|
Applica un limite di larghezza di banda globale per tutti i dischi.
|
|
RATE è il numero di byte al secondo. È possibile specificare un
|
|
moltiplicatore come K, M, G o T (ad esempio, --bw-limit 1G).
|
|
|
|
-t, --tail SIZE
|
|
Limita l'elenco dei file a quelli che non utilizzano più della
|
|
porzione finale specificata dei dischi di parità.
|
|
È possibile utilizzare moltiplicatori come K, M, G o T (ad es. --tail 1G).
|
|
Questa opzione è valida solo se utilizzata insieme al comando
|
|
`locate`.
|
|
|
|
-A, --stats
|
|
Abilita una vista dello stato estesa che mostra informazioni
|
|
aggiuntive. La schermata visualizza due grafici:
|
|
Il primo grafico mostra il numero di stripe bufferizzate per
|
|
ciascun disco, insieme al percorso del file attualmente
|
|
acceduto su quel disco. In genere, il disco più lento non avrà
|
|
buffer disponibile, il che determina la larghezza di banda massima
|
|
raggiungibile.
|
|
Il secondo grafico mostra la percentuale di tempo trascorso in
|
|
attesa negli ultimi 100 secondi. Si prevede che il disco più
|
|
lento causi la maggior parte del tempo di attesa, mentre gli altri
|
|
dischi dovrebbero avere poco o nessun tempo di attesa perché possono
|
|
utilizzare le loro stripe bufferizzate.
|
|
Questo grafico mostra anche il tempo trascorso in attesa per
|
|
i calcoli di hash e i calcoli RAID.
|
|
Tutti i calcoli vengono eseguiti in parallelo con le operazioni
|
|
su disco. Pertanto, finché c'è un tempo di attesa misurabile per
|
|
almeno un disco, ciò indica che la CPU è abbastanza veloce da
|
|
tenere il passo con il carico di lavoro.
|
|
|
|
-Z, --force-zero
|
|
Forza l'operazione non sicura di sincronizzazione di un file con
|
|
dimensione zero che in precedenza era non zero.
|
|
Se SnapRAID rileva una tale condizione, interrompe la
|
|
prosecuzione a meno che non si specifichi questa opzione.
|
|
Ciò consente di rilevare facilmente quando, dopo un arresto
|
|
anomalo del sistema, alcuni file a cui si è acceduto sono stati
|
|
troncati.
|
|
Questa è una possibile condizione in Linux con i file system
|
|
ext3/ext4.
|
|
Questa opzione può essere utilizzata solo con `sync`.
|
|
|
|
-E, --force-empty
|
|
Forza l'operazione non sicura di sincronizzazione di un disco con
|
|
tutti i file originali mancanti.
|
|
Se SnapRAID rileva che tutti i file originariamente presenti
|
|
sul disco sono mancanti o riscritti, interrompe la prosecuzione
|
|
a meno che non si specifichi questa opzione.
|
|
Ciò consente di rilevare facilmente quando un file system di dati
|
|
non è montato.
|
|
Questa opzione può essere utilizzata solo con `sync`.
|
|
|
|
-U, --force-uuid
|
|
Forza l'operazione non sicura di sincronizzazione, controllo e
|
|
correzione con dischi che hanno cambiato il loro UUID.
|
|
Se SnapRAID rileva che alcuni dischi hanno cambiato UUID,
|
|
interrompe la prosecuzione a meno che non si specifichi questa
|
|
opzione.
|
|
Ciò consente di rilevare quando i dischi sono montati sui punti
|
|
di montaggio sbagliati.
|
|
Tuttavia, è consentito avere un singolo cambio di UUID con
|
|
parità singola e di più con parità multipla, perché questo è
|
|
il caso normale quando si sostituiscono i dischi dopo un recupero.
|
|
Questa opzione può essere utilizzata solo con `sync`, `check`
|
|
o `fix`.
|
|
|
|
-D, --force-device
|
|
Forza l'operazione non sicura di correzione con dischi inaccessibili
|
|
o con dischi sullo stesso dispositivo fisico.
|
|
Ad esempio, se si sono persi due dischi dati e si ha un disco di
|
|
riserva per recuperare solo il primo, è possibile ignorare il secondo
|
|
disco inaccessibile.
|
|
Oppure, se si desidera recuperare un disco nello spazio libero
|
|
rimasto su un disco già utilizzato, condividendo lo stesso dispositivo
|
|
fisico.
|
|
Questa opzione può essere utilizzata solo con `fix`.
|
|
|
|
-N, --force-nocopy
|
|
In `sync`, `check` e `fix`, disabilita l'euristica di rilevamento
|
|
della copia.
|
|
Senza questa opzione, SnapRAID presume che i file con gli stessi
|
|
attributi, come nome, dimensione e timestamp, siano copie con gli
|
|
stessi dati.
|
|
Ciò consente l'identificazione di file copiati o spostati da un
|
|
disco all'altro e riutilizza le informazioni di hash già calcolate
|
|
per rilevare errori silenti o per recuperare file mancanti.
|
|
In alcuni rari casi, questo comportamento può comportare falsi
|
|
positivi o un processo lento a causa di molte verifiche di hash,
|
|
e questa opzione consente di risolvere tali problemi.
|
|
Questa opzione può essere utilizzata solo con `sync`, `check`
|
|
e `fix`.
|
|
|
|
-F, --force-full
|
|
In `sync`, forza un ricalcolo completo della parità.
|
|
Questa opzione può essere utilizzata quando si aggiunge un nuovo
|
|
livello di parità o se si è tornati a un vecchio file di contenuto
|
|
utilizzando dati di parità più recenti.
|
|
Invece di ricreare la parità da zero, questo consente di riutilizzare
|
|
gli hash presenti nel file di contenuto per convalidare i dati e
|
|
mantenere la protezione dei dati durante il processo `sync`
|
|
utilizzando i dati di parità esistenti.
|
|
Questa opzione può essere utilizzata solo con `sync`.
|
|
|
|
-R, --force-realloc
|
|
In `sync`, forza una riallocazione completa dei file e la
|
|
ricostruzione della parità.
|
|
Questa opzione può essere utilizzata per riallocare completamente
|
|
tutti i file, rimuovendo la frammentazione, riutilizzando gli hash
|
|
presenti nel file di contenuto per convalidare i dati.
|
|
Questa opzione può essere utilizzata solo con `sync`.
|
|
ATTENZIONE! Questa opzione è solo per esperti ed è vivamente
|
|
sconsigliato utilizzarla.
|
|
NON si ha protezione dei dati durante l'operazione `sync`.
|
|
|
|
-W, --force-realloc-tail SIZE
|
|
Funziona come -R, --force-realloc, ma limitatamente alla porzione
|
|
di coda specificata (ultimi SIZE byte) di ogni file di parità.
|
|
Forza la riallocazione (spostamento) di qualsiasi frammento/blocco di file
|
|
attualmente memorizzato in quella sezione di coda, consentendo loro di essere
|
|
posizionati ovunque nei file di parità dove sia disponibile spazio libero
|
|
(inclusi i buchi esistenti).
|
|
Lo scopo principale di questa opzione è ridurre la dimensione su disco
|
|
del file di parità.
|
|
Se la riallocazione svuota con successo l'intera sezione di coda
|
|
(non rimangono blocchi che la utilizzano), il file di parità viene
|
|
troncato, recuperando lo spazio di coda inutilizzato.
|
|
È possibile utilizzare moltiplicatori come K, M, G o T (ad es.
|
|
--force-realloc-tail 1G).
|
|
È possibile utilizzare locate -t, --tail per conoscere in anticipo
|
|
i file interessati.
|
|
ATTENZIONE!
|
|
Questa opzione è solo per esperti ed è caldamente
|
|
raccomandato di non usarla.
|
|
NON si ha protezione dei dati durante l'operazione di `sync`
|
|
per i file interessati.
|
|
|
|
-l, --log FILE
|
|
Scrive un log dettagliato nel file specificato.
|
|
Se questa opzione non è specificata, gli errori imprevisti vengono
|
|
stampati sullo schermo, potenzialmente producendo un output
|
|
eccessivo in caso di molti errori. Quando -l, --log è specificato,
|
|
vengono stampati sullo schermo solo gli errori fatali che
|
|
causano l'arresto di SnapRAID.
|
|
Se il percorso inizia con `>>`, il file viene aperto in modalità
|
|
append. Le occorrenze di `%D` e `%T` nel nome vengono sostituite
|
|
con la data e l'ora nel formato YYYYMMDD e HHMMSS. Nei file batch
|
|
di Windows, è necessario raddoppiare il carattere `%`, ad esempio
|
|
result-%%D.log. Per utilizzare `>>`, è necessario racchiudere
|
|
il nome tra virgolette, ad esempio `">>result.log"`.
|
|
Per indirizzare l'output del log all'output standard o all'errore
|
|
standard, è possibile utilizzare `">&1"` e `">&2"`,
|
|
rispettivamente.
|
|
Vedere il file snapraid_log.txt o la pagina man per le descrizioni
|
|
dei tag di log.
|
|
|
|
-L, --error-limit NUMBER
|
|
Imposta un nuovo limite di errore prima di interrompere l'esecuzione.
|
|
Per impostazione predefinita, SnapRAID si interrompe se incontra
|
|
più di 100 errori di input/output, indicando che un disco
|
|
sta probabilmente fallendo.
|
|
Questa opzione influisce su `sync` e `scrub`, a cui è consentito
|
|
continuare dopo il primo set di errori del disco per cercare di
|
|
completare le loro operazioni.
|
|
Tuttavia, `check` e `fix` si interrompono sempre al primo errore.
|
|
|
|
-S, --start BLKSTART
|
|
Avvia l'elaborazione dal numero di blocco specificato.
|
|
Ciò può essere utile per riprovare a controllare o correggere
|
|
blocchi specifici in caso di disco danneggiato.
|
|
Questa opzione è principalmente per il recupero manuale avanzato
|
|
ed è supportata solo da `check` e `fix`.
|
|
|
|
-B, --count BLKCOUNT
|
|
Elabora solo il numero specificato di blocchi.
|
|
Questa opzione è principalmente per il recupero manuale avanzato
|
|
ed è supportata solo da `check` e `fix`.
|
|
|
|
-C, --gen-conf CONTENT
|
|
Genera un file di configurazione fittizio da un file di contenuto
|
|
esistente.
|
|
Il file di configurazione viene scritto nell'output standard e non
|
|
sovrascrive uno esistente.
|
|
Questo file di configurazione contiene anche le informazioni
|
|
necessarie per ricostruire i punti di montaggio del disco nel caso
|
|
in cui si perda l'intero sistema.
|
|
|
|
-v, --verbose
|
|
Stampa più informazioni sullo schermo.
|
|
Se specificato una volta, stampa i file esclusi
|
|
e statistiche aggiuntive.
|
|
Questa opzione non ha effetto sui file di log.
|
|
|
|
-q, --quiet
|
|
Stampa meno informazioni sullo schermo.
|
|
Se specificato una volta, rimuove la barra di avanzamento;
|
|
due volte, le operazioni in corso; tre volte, i messaggi di
|
|
informazione; quattro volte, i messaggi di stato.
|
|
Gli errori fatali vengono sempre stampati sullo schermo.
|
|
Questa opzione non ha effetto sui file di log.
|
|
|
|
-H, --help
|
|
Stampa una breve schermata di aiuto.
|
|
|
|
-V, --version
|
|
Stampa la versione del programma.
|
|
|
|
|
|
7 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):
|
|
|
|
7.1 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.
|
|
|
|
7.2 (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.
|
|
|
|
7.3 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.
|
|
|
|
7.4 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.
|
|
|
|
7.5 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.
|
|
|
|
7.6 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.
|
|
|
|
7.7 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.
|
|
|
|
7.8 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.
|
|
|
|
7.9 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`.
|
|
|
|
Vedere la sezione PATTERN per maggiori dettagli sulle specifiche
|
|
del pattern.
|
|
|
|
Questa opzione può essere utilizzata più volte.
|
|
|
|
7.10 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.
|
|
|
|
7.11 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
|
|
|
|
7.12 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.
|
|
|
|
7.13 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.
|
|
|
|
7.14 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.
|
|
|
|
7.15 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.
|
|
|
|
7.16 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.
|
|
|
|
7.17 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
|
|
|
|
7.18 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
|
|
|
|
7.19 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
|
|
|
|
|
|
8 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:
|
|
|
|
Coerenza - I file modificati sul file system live durante un sync o uno scrub di
|
|
lunga durata non causeranno discrepanze di parità o operazioni interrotte,
|
|
perché ogni file system con snapshot rimane invariato per l'intera durata
|
|
dell'operazione.
|
|
Recupero - Se un file viene aggiornato o eliminato dal file system live,
|
|
rimane preservato nello snapshot. Se si verifica un guasto al disco
|
|
prima dell'esecuzione del sync successivo, SnapRAID utilizza i dati preservati
|
|
nello snapshot per ricostruire il disco guasto.
|
|
|
|
In caso di guasto al disco durante un processo di sync attivo,
|
|
SnapRAID è anche in grado di leggere automaticamente sia dallo snapshot
|
|
del calcolo della parità precedente che da quello corrente.
|
|
Ciò massimizza la probabilità di un recupero completo fornendo
|
|
l'accesso agli esatti blocchi di dati richiesti per risolvere
|
|
le equazioni di parità, anche se quei blocchi sono stati modificati
|
|
o eliminati tra i sync.
|
|
|
|
Senza snapshot, un file aggiornato o eliminato su un disco integro
|
|
comporta la mancanza di blocchi di dati che potrebbero essere richiesti per
|
|
ripristinare altri dischi guasti.
|
|
|
|
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.
|
|
|
|
8.1 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.
|
|
|
|
|
|
9 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.
|
|
|
|
|
|
10 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 doppio asterisco `**` è più potente, corrisponde a qualsiasi sequenza di
|
|
caratteri inclusi i separatori di directory. Ciò consente ai pattern di corrispondere
|
|
attraverso più livelli di directory. Quando `**` appare inserito direttamente in
|
|
un pattern, può corrispondere a zero o più caratteri inclusi gli slash tra
|
|
il testo letterale circostante.
|
|
|
|
L'uso più importante di `**` è nella forma speciale `/**/`. Questa corrisponde a
|
|
zero o più livelli di directory completi, rendendo possibile la corrispondenza di file
|
|
a qualsiasi profondità in un albero di directory senza conoscere l'esatta struttura del percorso.
|
|
Per esempio, il pattern `src/**/main.js` corrisponde a `src/main.js` (saltando
|
|
zero directory), `src/ui/main.js` (saltando una directory), e
|
|
`src/ui/components/main.js` (saltando due directory).
|
|
|
|
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 `**` è l'unico pattern che può corrispondere attraverso
|
|
i separatori di directory.
|
|
|
|
Esistono quattro diversi tipi di pattern:
|
|
|
|
FILE
|
|
Seleziona qualsiasi file chiamato FILE.
|
|
Questo pattern si applica solo ai file, non alle directory.
|
|
|
|
DIR/
|
|
Seleziona qualsiasi directory chiamata DIR e tutto ciò che contiene.
|
|
Questo pattern si applica solo alle directory, non ai file.
|
|
|
|
/PATH/FILE
|
|
Seleziona l'esatto percorso del file specificato. Questo pattern si applica
|
|
solo ai file, non alle directory.
|
|
|
|
/PATH/DIR/
|
|
Seleziona l'esatto percorso della directory specificata e tutto ciò che
|
|
contiene. Questo pattern si applica solo alle directory, non ai file.
|
|
|
|
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/
|
|
|
|
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.
|
|
|
|
|
|
11 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:
|
|
|
|
FILE
|
|
Seleziona qualsiasi file chiamato FILE in questa directory o sotto di essa.
|
|
Segue le stesse regole di globbing del pattern globale.
|
|
|
|
DIR/
|
|
Seleziona qualsiasi directory chiamata DIR e tutto ciò che contiene,
|
|
che risieda in questa directory o sotto di essa.
|
|
|
|
/PATH/FILE
|
|
Seleziona l'esatto file specificato relativo alla posizione
|
|
del file `.snapraidignore`.
|
|
|
|
/PATH/DIR/
|
|
Seleziona l'esatta directory specificata e tutto ciò che contiene,
|
|
relativa alla posizione del file `.snapraidignore`.
|
|
|
|
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
|
|
|
|
|
|
12 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`.
|
|
|
|
|
|
13 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`.
|
|
|
|
|
|
14 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.
|
|
|
|
|
|
15 CODICE DI USCITA (EXIT CODE)
|
|
===============================
|
|
|
|
SnapRAID termina con i seguenti codici di errore:
|
|
|
|
0 - Tutto OK.
|
|
1 - Il comando ha riscontrato alcuni errori.
|
|
2 - Il comando `diff` ha rilevato che tutto è OK, ma è necessario un `sync`.
|
|
|
|
|
|
16 TRADUZIONE (TRANSLATION)
|
|
===========================
|
|
|
|
Questo documento è una traduzione automatica del manuale in inglese.
|
|
Fare riferimento al manuale in inglese per la versione ufficiale.
|
|
|
|
|
|
17 COPYRIGHT
|
|
============
|
|
|
|
Questo file è Copyright (C) 2026 Andrea Mazzoleni
|
|
|
|
|
|
18 VEDI ANCHE (SEE ALSO)
|
|
========================
|
|
|
|
snapraid_log(1), snapraidd(1), rsync(1)
|