Update translations

This commit is contained in:
Andrea Mazzoleni 2026-06-08 18:26:17 +02:00
parent 2b9895d5db
commit 2f3c1df404
42 changed files with 6830 additions and 1261 deletions

View file

@ -117,26 +117,34 @@ https://www.snapraid.it/
.PD 0
.PD
.RE
.SH LIMITATIONS
SnapRAID ist ein Hybrid aus einem RAID\- und einem Sicherungsprogramm,
das darauf abzielt, die besten Vorteile beider zu kombinieren.
Es hat jedoch einige Einschränkungen, die Sie vor der Verwendung
berücksichtigen sollten.
.SH EINSCHRäNKUNGEN
SnapRAID ist ein Hybrid aus RAID und einem Backup\-Programm mit dem Ziel, die
besten Vorteile von beiden zu kombinieren. Es hat jedoch einige Einschränkungen, die Sie
vor der Verwendung berücksichtigen sollten.
.PP
Die Haupteinschränkung besteht darin, dass wenn eine Festplatte
ausfällt und Sie in letzter Zeit keine Synchronisierung durchgeführt haben,
Sie möglicherweise nicht vollständig wiederherstellen können.
Genauer gesagt können Sie möglicherweise nicht bis zur Größe der
geänderten oder gelöschten Dateien seit der letzten \`sync\`\-Operation
wiederherstellen. Dies tritt auch dann auf, wenn die geänderten oder
gelöschten Dateien sich nicht auf der ausgefallenen Festplatte befinden.
Aus diesem Grund ist SnapRAID besser für Daten geeignet, die sich
selten ändern.
Die Haupteinschränkung besteht darin, dass Sie bei einem Festplattenausfall Daten nur bis zum
Zustand des letzten \`sync\`\-Vorgangs wiederherstellen können. Alle Daten, die seit dem
letzten Sync hinzugefügt oder geändert wurden und sich auf der ausgefallenen Festplatte befinden, gehen verloren.
.PP
Andererseits verhindern neu hinzugefügte Dateien die Wiederherstellung
von bereits vorhandenen Dateien nicht. Sie verlieren nur die
kürzlich hinzugefügten Dateien, wenn diese sich auf der ausgefallenen
Festplatte befinden.
Daher eignet sich SnapRAID in erster Linie für Daten, die sich selten ändern.
.PP
Für Daten, die beim letzten Sync bereits existierten, hängt die Wiederherstellungszuverlässigkeit
davon ab, ob die Option \`snapshot\` verwendet wird:
.PD 0
.IP \(bu
Mit Snapshot\-Unterstützung (verfügbar auf Btrfs, ZFS, Bcachefs und NTFS)
kann SnapRAID automatisch eine eingefrorene Referenz Ihrer Datenträger beibehalten.
Dies stellt sicher, dass der Wiederherstellungsprozess konsistent und zuverlässig bleibt,
selbst wenn Sie während oder nach einem Sync Dateien auf Ihrem Live\-Dateisystem ändern oder löschen.
.PD
.PD 0
.IP \(bu
Ohne Snapshot\-Unterstützung kann das Löschen oder Ändern von Dateien nach einem \`sync\`
die vollständige Wiederherstellung anderer ausgefallener Festplatten verhindern. Dies geschieht,
weil die Parität nicht mehr mit den geänderten Dateien übereinstimmt, selbst wenn
sich diese Dateien nicht auf der ausgefallenen Festplatte befinden. Neu hinzugefügte
Dateien verhindern dagegen die Wiederherstellung bereits vorhandener Dateien nicht.
.PD
.PP
Weitere Einschränkungen von SnapRAID sind:
.PD 0
@ -683,19 +691,19 @@ snapraid sync
.RE
.PP
Wenn alles wiederhergestellt ist, ist dieser Befehl sofort.
.SH COMMANDS
SnapRAID bietet einige einfache Befehle, mit denen Sie:
.SH BEFEHLE
SnapRAID bietet ein paar einfache Befehle, mit denen Sie:
.PD 0
.IP \(bu
Den Status des Arrays ausgeben \-> \`status\`
.IP \(bu
Die Festplatten steuern \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
Eine Sicherung/einen Snapshot erstellen \-> \`sync\`
Einen Backup\-/Wiederherstellungspunkt erstellen \-> \`sync\`
.IP \(bu
Daten regelmäßig überprüfen \-> \`scrub\`
.IP \(bu
Die letzte Sicherung/den letzten Snapshot wiederherstellen \-> \`fix\`.
Den letzten Backup\-/Wiederherstellungspunkt wiederherstellen \-> \`fix\`.
.PD
.PP
Befehle müssen in Kleinbuchstaben geschrieben werden.
@ -959,14 +967,14 @@ Blöcke zu markieren.
Die \`parity\`\-Dateien werden NICHT geändert.
Die Dateien im Array werden NICHT geändert.
.SS fix
Behebt alle Dateien und die Paritätsdaten.
Repariert alle Dateien und die Paritätsdaten.
.PP
Alle Dateien und Paritätsdaten werden mit dem Snapshot\-Zustand
verglichen, der beim letzten \`sync\` gespeichert wurde.
Wenn eine Abweichung gefunden wird, wird sie auf den gespeicherten
Snapshot zurückgesetzt.
Alle Dateien und Paritätsdaten werden mit dem im letzten \`sync\`
gespeicherten Zustand verglichen. Wenn ein Unterschied gefunden
wird, wird er auf den gespeicherten Zustand zurückgesetzt.
.PP
WARNUNG! Der Befehl \`fix\` unterscheidet nicht zwischen Fehlern und
WARNUNG!
Der Befehl \`fix\` unterscheidet nicht zwischen Fehlern und
beabsichtigten Änderungen. Er setzt den Dateizustand bedingungslos
auf den letzten \`sync\` zurück.
.PP
@ -1534,6 +1542,29 @@ z. B. die Boot\-Festplatte.
.PP
Beachten Sie, dass solche Festplatten nicht von den Befehlen \`up\` und \`down\`
betroffen sind, da von ihnen erwartet wird, dass sie sich immer drehen.
.SS snapshot
Aktiviert die Verwendung von Dateisystem\-Snapshots für die Befehle \`sync\`, \`scrub\`,
\`check\` und \`fix\`.
.PP
Wenn aktiviert, erstellt SnapRAID zu Beginn eines \'sync\' einen schreibgeschützten Snapshot Ihrer Daten.
Dies gewährleistet eine konsistente Point\-in\-Time\-Ansicht Ihrer Dateien und verhindert
Fehler, die durch gleichzeitige Dateiänderungen verursacht werden.
.PP
Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem Live\-Dateisystem gelöscht wird,
bleibt sie im Snapshot erhalten. Dies verhindert, dass die Parität für diesen Block
\[dq]beschädigt\[dq] wird, sodass Sie Daten immer noch erfolgreich wiederherstellen können,
wenn eine andere Festplatte ausfällt.
.PP
Diese Option gilt ausschließlich für Datenträger, die mit den Dateisystemen
Btrfs, Bcachefs oder ZFS unter Linux und NTFS unter Windows formatiert sind.
Paritätsfestplatten oder Datenträger mit anderen Dateisystemen verwenden immer
die Live\-Version des Dateisystems.
.PP
Das Erstellen und Löschen von Snapshots erfordert Administratorrechte.
Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) ausgeführt wird, wenn
diese Option aktiviert ist.
.PP
Eine detaillierte Erklärung des Snapshot\-Lebenszyklus finden Sie im Abschnitt SNAPSHOTS.
.SS nohidden
Schließt alle versteckten Dateien und Verzeichnisse aus.
Unter Unix sind versteckte Dateien solche, die mit \`.\` beginnen.
@ -1886,6 +1917,121 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS
Wenn die Snapshot\-Option in der Konfiguration aktiviert ist, nutzt SnapRAID
die Dateisystem\-Snapshot\-Funktionalität, um atomare und konsistente Operationen zu gewährleisten.
.PP
Die Verwaltung von Snapshots erfolgt vollständig automatisch und transparent.
Sie können SnapRAID genau wie bisher verwenden, wobei der zusätzliche Schutz
durch Snapshots vollständig im Hintergrund abgewickelt wird.
.PP
Dies bietet zwei wesentliche Vorteile:
.RS 0
.PD 0
.HP 4
.I Konsistenz
Dateien, die während eines lang laufenden Syncs oder Scrubs auf dem Live\-Dateisystem
geändert werden, verursachen keine Paritätskonflikte oder abgebrochenen Operationen,
da SnapRAID ein eingefrorenes Point\-in\-Time\-Abbild sieht.
.HP 4
.I Wiederherstellung
Wenn eine Datei im Live\-Dateisystem aktualisiert oder gelöscht wird,
bleibt sie im Snapshot erhalten. Wenn ein Festplattenausfall auftritt,
bevor der nächste Sync ausgeführt wird, verwendet SnapRAID die im Snapshot konservierten Daten,
um die ausgefallene Festplatte zu rekonstruieren.
.PD
.PP
.RS 4
.PD 0
Im Falle eines Festplattenausfalls während eines aktiven Sync\-Vorgangs
ist SnapRAID auch in der Lage, automatisch sowohl aus dem Snapshot
der vorherigen Paritätsberechnung als auch aus der aktuellen zu lesen.
Dies maximiert die Wahrscheinlichkeit einer vollständigen Wiederherstellung, indem
Zugriff auf die genauen Datenblöcke gewährt wird, die zur Lösung der Paritätsgleichungen
erforderlich sind, selbst wenn diese Blöcke zwischen den Syncs geändert oder gelöscht wurden.
.PD
.PP
.PD 0
Ohne Snapshots führt eine aktualisierte oder gelöschte Datei auf einer gesunden
Festplatte zu fehlenden Datenblöcken, die möglicherweise zur Reparatur
anderer ausgefallener Festplatten benötigt werden.
.PD
.RE
.RE
.PP
Snapshots werden nur für Datenträger erstellt und nur dann, wenn das zugrunde liegende
Dateisystem diese Funktionalität unterstützt. Paritätsfestplatten verwenden immer
das Live\-Dateisystem.
Derzeit wird dies auf Btrfs, Bcachefs und ZFS unter Linux
und auf NTFS unter Windows unterstützt.
.PP
Sie können Datenträger mit unterschiedlichen Dateisystemen mischen. Nur diejenigen, die
Snapshots unterstützen, werden diese nutzen, während andere Festplatten weiterhin
direkt auf dem Live\-Dateisystem arbeiten.
.PP
Das Erstellen und Löschen von Snapshots erfordert Administratorrechte.
Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo)
ausgeführt wird, wenn Snapshots aktiviert sind.
.SS Befehlsverhalten mit Snapshots
Die Befehle \`sync\` und \`scrub\` arbeiten beide ausschließlich auf Snapshots,
um sicherzustellen, dass alle Datenoperationen auf einem konsistenten,
eingefrorenen Zustand ausgeführt werden. Durch die Nutzung dieser Snapshots verhindert SnapRAID Paritätskonflikte,
die andernfalls durch gleichzeitige Dateiänderungen auf dem Live\-Dateisystem ausgelöst würden.
Während eines \`sync\` verwendet der Befehl einen neuen Snapshot, der zu Beginn des Prozesses
erstellt wurde, um den aktuellen Zustand für die Paritätsberechnung zu erfassen.
Im Gegensatz dazu verwendet der Befehl \`scrub\` den letzten Snapshot, also den, der
während des letzten erfolgreichen Syncs erstellt wurde, um einen zuverlässigen Referenzpunkt
beizubehalten, der mit der vorhandenen Parität übereinstimmt.
.PP
Bei den Befehlen \`check\` und \`fix\` hängt die Verwendung des letzten Snapshots
davon ab, ob bestimmte Festplatten mit der Option \-d, \-\-filter\-disk ausgewählt wurden.
.PP
Eine explizit über \-d ausgewählte Festplatte (das „Ziel“ der Operation)
verwendet immer das Live\-Dateisystem. Für \`fix\` ermöglicht dies das Wiederherstellen
von Daten auf dem aktiven Festplattenersatz. Für \`check\` ermöglicht es die Simulation
des \`fix\`\-Vorgangs unter denselben Bedingungen.
.PP
Auf alle anderen Datenträger (die „Referenz“\-Festplatten) wird über ihre Snapshots zugegriffen.
Dies stellt sicher, dass SnapRAID selbst dann, wenn Sie während einer laufenden Wiederherstellung
Dateien auf Ihren gesunden Festplatten ändern, eine stabile, eingefrorene Referenz hat,
um die Paritätsgleichungen zu lösen.
.PP
Wenn keine Option \-d angegeben ist, nimmt SnapRAID an, dass die Operation für das gesamte Array gilt.
In diesem Fall verwenden \`check\` und \`fix\` ausschließlich die Live\-Dateisysteme.
.PP
Alle anderen Befehle arbeiten ausschließlich auf dem Live\-Dateisystem.
.SH LEBENSZYKLUS VON SNAPSHOTS
SnapRAID verwaltet zwei spezifische Snapshots, \`stable\` und \`pending\`,
in einem versteckten Verzeichnis im Stammverzeichnis jedes Daten\-Subvolumes.
Unter Btrfs, Bcachefs und NTFS wird das Verzeichnis \`.snapraid/\` verwendet,
unter ZFS das Standardverzeichnis \`.zfs/snapshot/\`.
.PP
Der \`stable\`\-Snapshot repräsentiert den Zustand des letzten
erfolgreich abgeschlossenen \`sync\` und enthält die genauen Daten, die zur
Berechnung der aktuellen Parität verwendet wurden. Er dient als primäre Datenquelle
für die Befehle \`scrub\`, \`check\` und \`fix\`.
.PP
Der \`pending\`\-Snapshot ist ein temporäres Abbild, das zu Beginn eines \`sync\`
erstellt wird, um einen eingefrorenen Zustand für die Paritätsberechnung bereitzustellen.
Nach erfolgreichem Abschluss des Vorgangs wird der vorherige \`stable\`\-Snapshot gelöscht
und der \`pending\`\-Snapshot wird heraufgestuft, um seinen Platz als neue stabile Referenz einzunehmen.
.PP
Wenn ein \`sync\` unterbrochen wird, bleibt der \`pending\`\-Snapshot erhalten.
Nachfolgende \`scrub\`\-, \`check\`\- und \`fix\`\-Befehle verwenden diesen ausstehenden Snapshot,
da er mit dem in der .content\-Datei aufgezeichneten Dateisystemzustand übereinstimmt,
selbst wenn die Parität nur teilweise synchronisiert ist.
.PP
Im Falle einer \`sync\`\-Unterbrechung lesen die Befehle \`check\` und \`fix\`
auch aus dem \`stable\`\-Snapshot, um Datenblöcke von Dateien abzurufen,
die während des Syncs aktualisiert oder gelöscht wurden.
Dies ist möglich, da die .content\-Datei Metadaten für alle geänderten oder
gelöschten Dateien während des gesamten Sync\-Prozesses aufbewahrt.
Diese historischen Informationen werden erst gelöscht, wenn ein Sync erfolgreich abgeschlossen
und die endgültige Version der .content\-Datei gespeichert wurde.
.PP
Wenn ein \`sync\` nach einer Unterbrechung neu gestartet wird, wird der vorhandene
ausstehende (pending) Snapshot gelöscht und ein neuer erstellt, um den
aktuellen Zustand des Live\-Dateisystems zu erfassen.
.SH PATTERN
Muster bieten eine flexible Möglichkeit, Dateien für die Einbeziehung oder
den Ausschluss zu filtern. Durch die Verwendung von Globbing\-Zeichen können Sie Regeln definieren,

View file

@ -51,26 +51,30 @@ Description
:https://www.snapraid.it/
Limitations
SnapRAID ist ein Hybrid aus einem RAID- und einem Sicherungsprogramm,
das darauf abzielt, die besten Vorteile beider zu kombinieren.
Es hat jedoch einige Einschränkungen, die Sie vor der Verwendung
berücksichtigen sollten.
Einschränkungen
SnapRAID ist ein Hybrid aus RAID und einem Backup-Programm mit dem Ziel, die
besten Vorteile von beiden zu kombinieren. Es hat jedoch einige Einschränkungen, die Sie
vor der Verwendung berücksichtigen sollten.
Die Haupteinschränkung besteht darin, dass wenn eine Festplatte
ausfällt und Sie in letzter Zeit keine Synchronisierung durchgeführt haben,
Sie möglicherweise nicht vollständig wiederherstellen können.
Genauer gesagt können Sie möglicherweise nicht bis zur Größe der
geänderten oder gelöschten Dateien seit der letzten `sync`-Operation
wiederherstellen. Dies tritt auch dann auf, wenn die geänderten oder
gelöschten Dateien sich nicht auf der ausgefallenen Festplatte befinden.
Aus diesem Grund ist SnapRAID besser für Daten geeignet, die sich
selten ändern.
Die Haupteinschränkung besteht darin, dass Sie bei einem Festplattenausfall Daten nur bis zum
Zustand des letzten `sync`-Vorgangs wiederherstellen können. Alle Daten, die seit dem
letzten Sync hinzugefügt oder geändert wurden und sich auf der ausgefallenen Festplatte befinden, gehen verloren.
Andererseits verhindern neu hinzugefügte Dateien die Wiederherstellung
von bereits vorhandenen Dateien nicht. Sie verlieren nur die
kürzlich hinzugefügten Dateien, wenn diese sich auf der ausgefallenen
Festplatte befinden.
Daher eignet sich SnapRAID in erster Linie für Daten, die sich selten ändern.
Für Daten, die beim letzten Sync bereits existierten, hängt die Wiederherstellungszuverlässigkeit
davon ab, ob die Option `snapshot` verwendet wird:
* Mit Snapshot-Unterstützung (verfügbar auf Btrfs, ZFS, Bcachefs und NTFS)
kann SnapRAID automatisch eine eingefrorene Referenz Ihrer Datenträger beibehalten.
Dies stellt sicher, dass der Wiederherstellungsprozess konsistent und zuverlässig bleibt,
selbst wenn Sie während oder nach einem Sync Dateien auf Ihrem Live-Dateisystem ändern oder löschen.
* Ohne Snapshot-Unterstützung kann das Löschen oder Ändern von Dateien nach einem `sync`
die vollständige Wiederherstellung anderer ausgefallener Festplatten verhindern. Dies geschieht,
weil die Parität nicht mehr mit den geänderten Dateien übereinstimmt, selbst wenn
sich diese Dateien nicht auf der ausgefallenen Festplatte befinden. Neu hinzugefügte
Dateien verhindern dagegen die Wiederherstellung bereits vorhandener Dateien nicht.
Weitere Einschränkungen von SnapRAID sind:
@ -423,14 +427,14 @@ Getting Started
Wenn alles wiederhergestellt ist, ist dieser Befehl sofort.
Commands
SnapRAID bietet einige einfache Befehle, mit denen Sie:
Befehle
SnapRAID bietet ein paar einfache Befehle, mit denen Sie:
* Den Status des Arrays ausgeben -> `status`
* Die Festplatten steuern -> `smart`, `probe`, `up`, `down`
* Eine Sicherung/einen Snapshot erstellen -> `sync`
* Einen Backup-/Wiederherstellungspunkt erstellen -> `sync`
* Daten regelmäßig überprüfen -> `scrub`
* Die letzte Sicherung/den letzten Snapshot wiederherstellen -> `fix`.
* Den letzten Backup-/Wiederherstellungspunkt wiederherstellen -> `fix`.
Befehle müssen in Kleinbuchstaben geschrieben werden.
@ -657,14 +661,14 @@ Commands
Die Dateien im Array werden NICHT geändert.
fix
Behebt alle Dateien und die Paritätsdaten.
Repariert alle Dateien und die Paritätsdaten.
Alle Dateien und Paritätsdaten werden mit dem Snapshot-Zustand
verglichen, der beim letzten `sync` gespeichert wurde.
Wenn eine Abweichung gefunden wird, wird sie auf den gespeicherten
Snapshot zurückgesetzt.
Alle Dateien und Paritätsdaten werden mit dem im letzten `sync`
gespeicherten Zustand verglichen. Wenn ein Unterschied gefunden
wird, wird er auf den gespeicherten Zustand zurückgesetzt.
WARNUNG! Der Befehl `fix` unterscheidet nicht zwischen Fehlern und
WARNUNG!
Der Befehl `fix` unterscheidet nicht zwischen Fehlern und
beabsichtigten Änderungen. Er setzt den Dateizustand bedingungslos
auf den letzten `sync` zurück.
@ -1243,6 +1247,30 @@ Configuration
Beachten Sie, dass solche Festplatten nicht von den Befehlen `up` und `down`
betroffen sind, da von ihnen erwartet wird, dass sie sich immer drehen.
snapshot
Aktiviert die Verwendung von Dateisystem-Snapshots für die Befehle `sync`, `scrub`,
`check` und `fix`.
Wenn aktiviert, erstellt SnapRAID zu Beginn eines 'sync' einen schreibgeschützten Snapshot Ihrer Daten.
Dies gewährleistet eine konsistente Point-in-Time-Ansicht Ihrer Dateien und verhindert
Fehler, die durch gleichzeitige Dateiänderungen verursacht werden.
Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem Live-Dateisystem gelöscht wird,
bleibt sie im Snapshot erhalten. Dies verhindert, dass die Parität für diesen Block
"beschädigt" wird, sodass Sie Daten immer noch erfolgreich wiederherstellen können,
wenn eine andere Festplatte ausfällt.
Diese Option gilt ausschließlich für Datenträger, die mit den Dateisystemen
Btrfs, Bcachefs oder ZFS unter Linux und NTFS unter Windows formatiert sind.
Paritätsfestplatten oder Datenträger mit anderen Dateisystemen verwenden immer
die Live-Version des Dateisystems.
Das Erstellen und Löschen von Snapshots erfordert Administratorrechte.
Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) ausgeführt wird, wenn
diese Option aktiviert ist.
Eine detaillierte Erklärung des Snapshot-Lebenszyklus finden Sie im Abschnitt SNAPSHOTS.
nohidden
Schließt alle versteckten Dateien und Verzeichnisse aus.
Unter Unix sind versteckte Dateien solche, die mit `.` beginnen.
@ -1499,6 +1527,111 @@ Configuration
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots
Wenn die Snapshot-Option in der Konfiguration aktiviert ist, nutzt SnapRAID
die Dateisystem-Snapshot-Funktionalität, um atomare und konsistente Operationen zu gewährleisten.
Die Verwaltung von Snapshots erfolgt vollständig automatisch und transparent.
Sie können SnapRAID genau wie bisher verwenden, wobei der zusätzliche Schutz
durch Snapshots vollständig im Hintergrund abgewickelt wird.
Dies bietet zwei wesentliche Vorteile:
Konsistenz - Dateien, die während eines lang laufenden Syncs oder Scrubs auf dem Live-Dateisystem
geändert werden, verursachen keine Paritätskonflikte oder abgebrochenen Operationen,
da SnapRAID ein eingefrorenes Point-in-Time-Abbild sieht.
Wiederherstellung - Wenn eine Datei im Live-Dateisystem aktualisiert oder gelöscht wird,
bleibt sie im Snapshot erhalten. Wenn ein Festplattenausfall auftritt,
bevor der nächste Sync ausgeführt wird, verwendet SnapRAID die im Snapshot konservierten Daten,
um die ausgefallene Festplatte zu rekonstruieren.
Im Falle eines Festplattenausfalls während eines aktiven Sync-Vorgangs
ist SnapRAID auch in der Lage, automatisch sowohl aus dem Snapshot
der vorherigen Paritätsberechnung als auch aus der aktuellen zu lesen.
Dies maximiert die Wahrscheinlichkeit einer vollständigen Wiederherstellung, indem
Zugriff auf die genauen Datenblöcke gewährt wird, die zur Lösung der Paritätsgleichungen
erforderlich sind, selbst wenn diese Blöcke zwischen den Syncs geändert oder gelöscht wurden.
Ohne Snapshots führt eine aktualisierte oder gelöschte Datei auf einer gesunden
Festplatte zu fehlenden Datenblöcken, die möglicherweise zur Reparatur
anderer ausgefallener Festplatten benötigt werden.
Snapshots werden nur für Datenträger erstellt und nur dann, wenn das zugrunde liegende
Dateisystem diese Funktionalität unterstützt. Paritätsfestplatten verwenden immer
das Live-Dateisystem.
Derzeit wird dies auf Btrfs, Bcachefs und ZFS unter Linux
und auf NTFS unter Windows unterstützt.
Sie können Datenträger mit unterschiedlichen Dateisystemen mischen. Nur diejenigen, die
Snapshots unterstützen, werden diese nutzen, während andere Festplatten weiterhin
direkt auf dem Live-Dateisystem arbeiten.
Das Erstellen und Löschen von Snapshots erfordert Administratorrechte.
Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo)
ausgeführt wird, wenn Snapshots aktiviert sind.
Befehlsverhalten mit Snapshots
Die Befehle `sync` und `scrub` arbeiten beide ausschließlich auf Snapshots,
um sicherzustellen, dass alle Datenoperationen auf einem konsistenten,
eingefrorenen Zustand ausgeführt werden. Durch die Nutzung dieser Snapshots verhindert SnapRAID Paritätskonflikte,
die andernfalls durch gleichzeitige Dateiänderungen auf dem Live-Dateisystem ausgelöst würden.
Während eines `sync` verwendet der Befehl einen neuen Snapshot, der zu Beginn des Prozesses
erstellt wurde, um den aktuellen Zustand für die Paritätsberechnung zu erfassen.
Im Gegensatz dazu verwendet der Befehl `scrub` den letzten Snapshot, also den, der
während des letzten erfolgreichen Syncs erstellt wurde, um einen zuverlässigen Referenzpunkt
beizubehalten, der mit der vorhandenen Parität übereinstimmt.
Bei den Befehlen `check` und `fix` hängt die Verwendung des letzten Snapshots
davon ab, ob bestimmte Festplatten mit der Option -d, --filter-disk ausgewählt wurden.
Eine explizit über -d ausgewählte Festplatte (das „Ziel“ der Operation)
verwendet immer das Live-Dateisystem. Für `fix` ermöglicht dies das Wiederherstellen
von Daten auf dem aktiven Festplattenersatz. Für `check` ermöglicht es die Simulation
des `fix`-Vorgangs unter denselben Bedingungen.
Auf alle anderen Datenträger (die „Referenz“-Festplatten) wird über ihre Snapshots zugegriffen.
Dies stellt sicher, dass SnapRAID selbst dann, wenn Sie während einer laufenden Wiederherstellung
Dateien auf Ihren gesunden Festplatten ändern, eine stabile, eingefrorene Referenz hat,
um die Paritätsgleichungen zu lösen.
Wenn keine Option -d angegeben ist, nimmt SnapRAID an, dass die Operation für das gesamte Array gilt.
In diesem Fall verwenden `check` und `fix` ausschließlich die Live-Dateisysteme.
Alle anderen Befehle arbeiten ausschließlich auf dem Live-Dateisystem.
Lebenszyklus von Snapshots
SnapRAID verwaltet zwei spezifische Snapshots, `stable` und `pending`,
in einem versteckten Verzeichnis im Stammverzeichnis jedes Daten-Subvolumes.
Unter Btrfs, Bcachefs und NTFS wird das Verzeichnis `.snapraid/` verwendet,
unter ZFS das Standardverzeichnis `.zfs/snapshot/`.
Der `stable`-Snapshot repräsentiert den Zustand des letzten
erfolgreich abgeschlossenen `sync` und enthält die genauen Daten, die zur
Berechnung der aktuellen Parität verwendet wurden. Er dient als primäre Datenquelle
für die Befehle `scrub`, `check` und `fix`.
Der `pending`-Snapshot ist ein temporäres Abbild, das zu Beginn eines `sync`
erstellt wird, um einen eingefrorenen Zustand für die Paritätsberechnung bereitzustellen.
Nach erfolgreichem Abschluss des Vorgangs wird der vorherige `stable`-Snapshot gelöscht
und der `pending`-Snapshot wird heraufgestuft, um seinen Platz als neue stabile Referenz einzunehmen.
Wenn ein `sync` unterbrochen wird, bleibt der `pending`-Snapshot erhalten.
Nachfolgende `scrub`-, `check`- und `fix`-Befehle verwenden diesen ausstehenden Snapshot,
da er mit dem in der .content-Datei aufgezeichneten Dateisystemzustand übereinstimmt,
selbst wenn die Parität nur teilweise synchronisiert ist.
Im Falle einer `sync`-Unterbrechung lesen die Befehle `check` und `fix`
auch aus dem `stable`-Snapshot, um Datenblöcke von Dateien abzurufen,
die während des Syncs aktualisiert oder gelöscht wurden.
Dies ist möglich, da die .content-Datei Metadaten für alle geänderten oder
gelöschten Dateien während des gesamten Sync-Prozesses aufbewahrt.
Diese historischen Informationen werden erst gelöscht, wenn ein Sync erfolgreich abgeschlossen
und die endgültige Version der .content-Datei gespeichert wurde.
Wenn ein `sync` nach einer Unterbrechung neu gestartet wird, wird der vorhandene
ausstehende (pending) Snapshot gelöscht und ein neuer erstellt, um den
aktuellen Zustand des Live-Dateisystems zu erfassen.
Pattern
Muster bieten eine flexible Möglichkeit, Dateien für die Einbeziehung oder
den Ausschluss zu filtern. Durch die Verwendung von Globbing-Zeichen können Sie Regeln definieren,

View file

@ -59,28 +59,32 @@ Für weitere Informationen besuchen Sie bitte die offizielle SnapRAID-Website:
https://www.snapraid.it/
3 LIMITATIONS
=============
3 EINSCHRäNKUNGEN
=================
SnapRAID ist ein Hybrid aus einem RAID- und einem Sicherungsprogramm,
das darauf abzielt, die besten Vorteile beider zu kombinieren.
Es hat jedoch einige Einschränkungen, die Sie vor der Verwendung
berücksichtigen sollten.
SnapRAID ist ein Hybrid aus RAID und einem Backup-Programm mit dem Ziel, die
besten Vorteile von beiden zu kombinieren. Es hat jedoch einige Einschränkungen, die Sie
vor der Verwendung berücksichtigen sollten.
Die Haupteinschränkung besteht darin, dass wenn eine Festplatte
ausfällt und Sie in letzter Zeit keine Synchronisierung durchgeführt haben,
Sie möglicherweise nicht vollständig wiederherstellen können.
Genauer gesagt können Sie möglicherweise nicht bis zur Größe der
geänderten oder gelöschten Dateien seit der letzten `sync`-Operation
wiederherstellen. Dies tritt auch dann auf, wenn die geänderten oder
gelöschten Dateien sich nicht auf der ausgefallenen Festplatte befinden.
Aus diesem Grund ist SnapRAID besser für Daten geeignet, die sich
selten ändern.
Die Haupteinschränkung besteht darin, dass Sie bei einem Festplattenausfall Daten nur bis zum
Zustand des letzten `sync`-Vorgangs wiederherstellen können. Alle Daten, die seit dem
letzten Sync hinzugefügt oder geändert wurden und sich auf der ausgefallenen Festplatte befinden, gehen verloren.
Andererseits verhindern neu hinzugefügte Dateien die Wiederherstellung
von bereits vorhandenen Dateien nicht. Sie verlieren nur die
kürzlich hinzugefügten Dateien, wenn diese sich auf der ausgefallenen
Festplatte befinden.
Daher eignet sich SnapRAID in erster Linie für Daten, die sich selten ändern.
Für Daten, die beim letzten Sync bereits existierten, hängt die Wiederherstellungszuverlässigkeit
davon ab, ob die Option `snapshot` verwendet wird:
* Mit Snapshot-Unterstützung (verfügbar auf Btrfs, ZFS, Bcachefs und NTFS)
kann SnapRAID automatisch eine eingefrorene Referenz Ihrer Datenträger beibehalten.
Dies stellt sicher, dass der Wiederherstellungsprozess konsistent und zuverlässig bleibt,
selbst wenn Sie während oder nach einem Sync Dateien auf Ihrem Live-Dateisystem ändern oder löschen.
* Ohne Snapshot-Unterstützung kann das Löschen oder Ändern von Dateien nach einem `sync`
die vollständige Wiederherstellung anderer ausgefallener Festplatten verhindern. Dies geschieht,
weil die Parität nicht mehr mit den geänderten Dateien übereinstimmt, selbst wenn
sich diese Dateien nicht auf der ausgefallenen Festplatte befinden. Neu hinzugefügte
Dateien verhindern dagegen die Wiederherstellung bereits vorhandener Dateien nicht.
Weitere Einschränkungen von SnapRAID sind:
@ -445,16 +449,16 @@ Festplatte zu resynchronisieren.
Wenn alles wiederhergestellt ist, ist dieser Befehl sofort.
5 COMMANDS
==========
5 BEFEHLE
=========
SnapRAID bietet einige einfache Befehle, mit denen Sie:
SnapRAID bietet ein paar einfache Befehle, mit denen Sie:
* Den Status des Arrays ausgeben -> `status`
* Die Festplatten steuern -> `smart`, `probe`, `up`, `down`
* Eine Sicherung/einen Snapshot erstellen -> `sync`
* Einen Backup-/Wiederherstellungspunkt erstellen -> `sync`
* Daten regelmäßig überprüfen -> `scrub`
* Die letzte Sicherung/den letzten Snapshot wiederherstellen -> `fix`.
* Den letzten Backup-/Wiederherstellungspunkt wiederherstellen -> `fix`.
Befehle müssen in Kleinbuchstaben geschrieben werden.
@ -699,14 +703,14 @@ Die Dateien im Array werden NICHT geändert.
5.9 fix
-------
Behebt alle Dateien und die Paritätsdaten.
Repariert alle Dateien und die Paritätsdaten.
Alle Dateien und Paritätsdaten werden mit dem Snapshot-Zustand
verglichen, der beim letzten `sync` gespeichert wurde.
Wenn eine Abweichung gefunden wird, wird sie auf den gespeicherten
Snapshot zurückgesetzt.
Alle Dateien und Paritätsdaten werden mit dem im letzten `sync`
gespeicherten Zustand verglichen. Wenn ein Unterschied gefunden
wird, wird er auf den gespeicherten Zustand zurückgesetzt.
WARNUNG! Der Befehl `fix` unterscheidet nicht zwischen Fehlern und
WARNUNG!
Der Befehl `fix` unterscheidet nicht zwischen Fehlern und
beabsichtigten Änderungen. Er setzt den Dateizustand bedingungslos
auf den letzten `sync` zurück.
@ -1319,14 +1323,40 @@ z. B. die Boot-Festplatte.
Beachten Sie, dass solche Festplatten nicht von den Befehlen `up` und `down`
betroffen sind, da von ihnen erwartet wird, dass sie sich immer drehen.
7.7 nohidden
7.7 snapshot
------------
Aktiviert die Verwendung von Dateisystem-Snapshots für die Befehle `sync`, `scrub`,
`check` und `fix`.
Wenn aktiviert, erstellt SnapRAID zu Beginn eines 'sync' einen schreibgeschützten Snapshot Ihrer Daten.
Dies gewährleistet eine konsistente Point-in-Time-Ansicht Ihrer Dateien und verhindert
Fehler, die durch gleichzeitige Dateiänderungen verursacht werden.
Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem Live-Dateisystem gelöscht wird,
bleibt sie im Snapshot erhalten. Dies verhindert, dass die Parität für diesen Block
"beschädigt" wird, sodass Sie Daten immer noch erfolgreich wiederherstellen können,
wenn eine andere Festplatte ausfällt.
Diese Option gilt ausschließlich für Datenträger, die mit den Dateisystemen
Btrfs, Bcachefs oder ZFS unter Linux und NTFS unter Windows formatiert sind.
Paritätsfestplatten oder Datenträger mit anderen Dateisystemen verwenden immer
die Live-Version des Dateisystems.
Das Erstellen und Löschen von Snapshots erfordert Administratorrechte.
Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo) ausgeführt wird, wenn
diese Option aktiviert ist.
Eine detaillierte Erklärung des Snapshot-Lebenszyklus finden Sie im Abschnitt SNAPSHOTS.
7.8 nohidden
------------
Schließt alle versteckten Dateien und Verzeichnisse aus.
Unter Unix sind versteckte Dateien solche, die mit `.` beginnen.
Unter Windows sind es solche mit dem versteckten Attribut.
7.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
Definiert die Datei- oder Verzeichnismuster, die im `sync`-Vorgang
@ -1345,8 +1375,8 @@ PATTERN.
Diese Option kann mehrmals verwendet werden.
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
Definiert die grundlegende Blockgröße in Kibibytes für die Parität.
Ein Kibibyte entspricht 1024 Bytes.
@ -1399,7 +1429,7 @@ Dies führt zu etwa 1,5% zusätzlichem Speicherplatz, ungefähr 60 GB
für eine 4 TB Festplatte, was etwa 460.000 Dateien auf jeder
Datenfestplatte ohne verschwendeten Platz ermöglicht.
7.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
Definiert die Hash-Größe in Bytes für die gespeicherten Blöcke.
@ -1438,7 +1468,7 @@ von 512 erhalten Sie:
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
Speichert den Zustand beim Synchronisieren oder Scrubben automatisch
@ -1447,7 +1477,7 @@ Diese Option ist nützlich, um zu vermeiden, dass lange `sync`-Befehle
von vorne gestartet werden müssen, wenn sie durch einen Maschinenabsturz
oder ein anderes Ereignis unterbrochen werden.
7.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
Legt die maximal zulässige Festplattentemperatur in Celsius fest.
@ -1483,14 +1513,14 @@ Normalerweise zeigt SnapRAID nur die Temperatur der heißesten
Festplatte an. Um die Temperatur aller Festplatten anzuzeigen,
verwenden Sie die Option -A oder --stats.
7.13 temp_sleep TIME_IN_MINUTES
7.14 temp_sleep TIME_IN_MINUTES
-------------------------------
Legt die Standby-Zeit in Minuten fest, wenn der Temperaturgrenzwert
erreicht wird. Während dieser Zeit bleiben die Festplatten heruntergefahren.
Der Standardwert ist 5 Minuten.
7.14 pool DIR
7.15 pool DIR
-------------
Definiert das Pooling-Verzeichnis, in dem die virtuelle Ansicht des
@ -1498,7 +1528,7 @@ Festplatten-Arrays mithilfe des Befehls `pool` erstellt wird.
Das Verzeichnis muss bereits existieren.
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
Definiert den Windows UNC-Pfad, der für den Remote-Zugriff auf die
@ -1516,7 +1546,7 @@ und schließlich das Dateiverzeichnis und der Name hinzugefügt werden.
Diese Option ist nur für Windows erforderlich.
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
Definiert benutzerdefinierte smartctl-Optionen, um die SMART-Attribute
@ -1542,7 +1572,7 @@ Zum Beispiel:
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
Ignoriert das angegebene SMART-Attribut bei der Berechnung der
@ -1565,7 +1595,7 @@ Um es nur auf der ersten Paritätsfestplatte zu ignorieren:
smartignore parity 197
7.18 Examples
7.19 Examples
-------------
Ein Beispiel für eine typische Konfiguration für Unix ist:
@ -1600,8 +1630,121 @@ Ein Beispiel für eine typische Konfiguration für Windows ist:
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 PATTERN
=========
8 SNAPSHOTS
===========
Wenn die Snapshot-Option in der Konfiguration aktiviert ist, nutzt SnapRAID
die Dateisystem-Snapshot-Funktionalität, um atomare und konsistente Operationen zu gewährleisten.
Die Verwaltung von Snapshots erfolgt vollständig automatisch und transparent.
Sie können SnapRAID genau wie bisher verwenden, wobei der zusätzliche Schutz
durch Snapshots vollständig im Hintergrund abgewickelt wird.
Dies bietet zwei wesentliche Vorteile:
Konsistenz - Dateien, die während eines lang laufenden Syncs oder Scrubs auf dem Live-Dateisystem
geändert werden, verursachen keine Paritätskonflikte oder abgebrochenen Operationen,
da SnapRAID ein eingefrorenes Point-in-Time-Abbild sieht.
Wiederherstellung - Wenn eine Datei im Live-Dateisystem aktualisiert oder gelöscht wird,
bleibt sie im Snapshot erhalten. Wenn ein Festplattenausfall auftritt,
bevor der nächste Sync ausgeführt wird, verwendet SnapRAID die im Snapshot konservierten Daten,
um die ausgefallene Festplatte zu rekonstruieren.
Im Falle eines Festplattenausfalls während eines aktiven Sync-Vorgangs
ist SnapRAID auch in der Lage, automatisch sowohl aus dem Snapshot
der vorherigen Paritätsberechnung als auch aus der aktuellen zu lesen.
Dies maximiert die Wahrscheinlichkeit einer vollständigen Wiederherstellung, indem
Zugriff auf die genauen Datenblöcke gewährt wird, die zur Lösung der Paritätsgleichungen
erforderlich sind, selbst wenn diese Blöcke zwischen den Syncs geändert oder gelöscht wurden.
Ohne Snapshots führt eine aktualisierte oder gelöschte Datei auf einer gesunden
Festplatte zu fehlenden Datenblöcken, die möglicherweise zur Reparatur
anderer ausgefallener Festplatten benötigt werden.
Snapshots werden nur für Datenträger erstellt und nur dann, wenn das zugrunde liegende
Dateisystem diese Funktionalität unterstützt. Paritätsfestplatten verwenden immer
das Live-Dateisystem.
Derzeit wird dies auf Btrfs, Bcachefs und ZFS unter Linux
und auf NTFS unter Windows unterstützt.
Sie können Datenträger mit unterschiedlichen Dateisystemen mischen. Nur diejenigen, die
Snapshots unterstützen, werden diese nutzen, während andere Festplatten weiterhin
direkt auf dem Live-Dateisystem arbeiten.
Das Erstellen und Löschen von Snapshots erfordert Administratorrechte.
Stellen Sie sicher, dass SnapRAID mit den erforderlichen Berechtigungen (z. B. sudo)
ausgeführt wird, wenn Snapshots aktiviert sind.
8.1 Befehlsverhalten mit Snapshots
----------------------------------
Die Befehle `sync` und `scrub` arbeiten beide ausschließlich auf Snapshots,
um sicherzustellen, dass alle Datenoperationen auf einem konsistenten,
eingefrorenen Zustand ausgeführt werden. Durch die Nutzung dieser Snapshots verhindert SnapRAID Paritätskonflikte,
die andernfalls durch gleichzeitige Dateiänderungen auf dem Live-Dateisystem ausgelöst würden.
Während eines `sync` verwendet der Befehl einen neuen Snapshot, der zu Beginn des Prozesses
erstellt wurde, um den aktuellen Zustand für die Paritätsberechnung zu erfassen.
Im Gegensatz dazu verwendet der Befehl `scrub` den letzten Snapshot, also den, der
während des letzten erfolgreichen Syncs erstellt wurde, um einen zuverlässigen Referenzpunkt
beizubehalten, der mit der vorhandenen Parität übereinstimmt.
Bei den Befehlen `check` und `fix` hängt die Verwendung des letzten Snapshots
davon ab, ob bestimmte Festplatten mit der Option -d, --filter-disk ausgewählt wurden.
Eine explizit über -d ausgewählte Festplatte (das „Ziel“ der Operation)
verwendet immer das Live-Dateisystem. Für `fix` ermöglicht dies das Wiederherstellen
von Daten auf dem aktiven Festplattenersatz. Für `check` ermöglicht es die Simulation
des `fix`-Vorgangs unter denselben Bedingungen.
Auf alle anderen Datenträger (die „Referenz“-Festplatten) wird über ihre Snapshots zugegriffen.
Dies stellt sicher, dass SnapRAID selbst dann, wenn Sie während einer laufenden Wiederherstellung
Dateien auf Ihren gesunden Festplatten ändern, eine stabile, eingefrorene Referenz hat,
um die Paritätsgleichungen zu lösen.
Wenn keine Option -d angegeben ist, nimmt SnapRAID an, dass die Operation für das gesamte Array gilt.
In diesem Fall verwenden `check` und `fix` ausschließlich die Live-Dateisysteme.
Alle anderen Befehle arbeiten ausschließlich auf dem Live-Dateisystem.
9 LEBENSZYKLUS VON SNAPSHOTS
============================
SnapRAID verwaltet zwei spezifische Snapshots, `stable` und `pending`,
in einem versteckten Verzeichnis im Stammverzeichnis jedes Daten-Subvolumes.
Unter Btrfs, Bcachefs und NTFS wird das Verzeichnis `.snapraid/` verwendet,
unter ZFS das Standardverzeichnis `.zfs/snapshot/`.
Der `stable`-Snapshot repräsentiert den Zustand des letzten
erfolgreich abgeschlossenen `sync` und enthält die genauen Daten, die zur
Berechnung der aktuellen Parität verwendet wurden. Er dient als primäre Datenquelle
für die Befehle `scrub`, `check` und `fix`.
Der `pending`-Snapshot ist ein temporäres Abbild, das zu Beginn eines `sync`
erstellt wird, um einen eingefrorenen Zustand für die Paritätsberechnung bereitzustellen.
Nach erfolgreichem Abschluss des Vorgangs wird der vorherige `stable`-Snapshot gelöscht
und der `pending`-Snapshot wird heraufgestuft, um seinen Platz als neue stabile Referenz einzunehmen.
Wenn ein `sync` unterbrochen wird, bleibt der `pending`-Snapshot erhalten.
Nachfolgende `scrub`-, `check`- und `fix`-Befehle verwenden diesen ausstehenden Snapshot,
da er mit dem in der .content-Datei aufgezeichneten Dateisystemzustand übereinstimmt,
selbst wenn die Parität nur teilweise synchronisiert ist.
Im Falle einer `sync`-Unterbrechung lesen die Befehle `check` und `fix`
auch aus dem `stable`-Snapshot, um Datenblöcke von Dateien abzurufen,
die während des Syncs aktualisiert oder gelöscht wurden.
Dies ist möglich, da die .content-Datei Metadaten für alle geänderten oder
gelöschten Dateien während des gesamten Sync-Prozesses aufbewahrt.
Diese historischen Informationen werden erst gelöscht, wenn ein Sync erfolgreich abgeschlossen
und die endgültige Version der .content-Datei gespeichert wurde.
Wenn ein `sync` nach einer Unterbrechung neu gestartet wird, wird der vorhandene
ausstehende (pending) Snapshot gelöscht und ein neuer erstellt, um den
aktuellen Zustand des Live-Dateisystems zu erfassen.
10 PATTERN
==========
Muster bieten eine flexible Möglichkeit, Dateien für die Einbeziehung oder
den Ausschluss zu filtern. Durch die Verwendung von Globbing-Zeichen können Sie Regeln definieren,
@ -1724,8 +1867,8 @@ Unter Unix müssen Sie Globbing-Zeichen in der Befehlszeile in
Anführungszeichen setzen, um zu verhindern, dass die Shell sie erweitert.
9 DATEIEN IGNORIEREN
====================
11 DATEIEN IGNORIEREN
=====================
Zusätzlich zu den globalen Regeln in der Konfigurationsdatei können Sie
`.snapraidignore`-Dateien in jedem Verzeichnis innerhalb des Arrays platzieren,
@ -1769,7 +1912,7 @@ Wenn Sie beispielsweise eine `.snapraidignore` in `/mnt/disk1/projects/` haben:
*.tmp
10 CONTENT
12 CONTENT
==========
SnapRAID speichert die Liste und Prüfsummen Ihrer Dateien in der
@ -1783,7 +1926,7 @@ Diese Datei wird von den Befehlen `sync` und `scrub` gelesen und
geschrieben und von den Befehlen `fix`, `check` und `status` gelesen.
11 PARITY
13 PARITY
=========
SnapRAID speichert die Paritätsinformationen Ihres Arrays in den
@ -1796,7 +1939,7 @@ Diese Dateien werden von den Befehlen `sync` und `fix` gelesen
und geschrieben und nur von den Befehlen `scrub` und `check` gelesen.
12 ENCODING
14 ENCODING
===========
SnapRAID ignoriert unter Unix jede Kodierung. Es liest und speichert
@ -1814,13 +1957,13 @@ die Konsolenausgabe in eine Datei umleiten, ist die resultierende
Datei immer im UTF-8-Format.
13 COPYRIGHT
15 COPYRIGHT
============
Diese Datei ist Copyright (C) 2025 Andrea Mazzoleni
14 SEE ALSO
16 SEE ALSO
===========
snapraid_log(1), snapraidd(1)

View file

@ -118,23 +118,34 @@ https://www.snapraid.it/
.PD 0
.PD
.RE
.SH LIMITATIONS
SnapRAID es un híbrido entre un programa RAID y un programa de copia
de seguridad, con el objetivo de combinar los mejores beneficios de
ambos. Sin embargo, tiene algunas limitaciones que debe considerar
antes de usarlo.
.SH LIMITACIONES
SnapRAID es un híbrido entre un RAID y un programa de copia de seguridad, con el objetivo di combinar
los mejores beneficios de ambos. Sin embargo, tiene algunas limitaciones que debería
considerar antes de usarlo.
.PP
La principal limitación es que si un disco falla y no ha sincronizado
recientemente, es posible que no pueda recuperarse por completo.
Más específicamente, es posible que no pueda recuperar hasta el tamaño
de los archivos cambiados o eliminados desde la última operación de
sincronización. Esto ocurre incluso si los archivos cambiados o
eliminados no están en el disco fallido. Esta es la razón por la que
SnapRAID es más adecuado para datos que rara vez cambian.
La principal limitación es que si un disco falla, solo puede recuperar datos hasta el
estado de la última operación de sincronización (\`sync\`). Cualquier dato añadido o modificación realizada
desde la última sincronización que se encuentre en el disco dañado se perderá.
.PP
Por otro lado, los archivos recién agregados no impiden la recuperación
de los archivos ya existentes. Solo perderá los archivos recién
agregados si están en el disco fallido.
Por lo tanto, SnapRAID es adecuado principalmente para datos que cambian raramente.
.PP
Para los datos que ya existían en la última sincronización, la fiabilidad de la recuperación depende
de si se utiliza la opción de instantánea (\`snapshot\`):
.PD 0
.IP \(bu
Con soporte para instantáneas (disponible en Btrfs, ZFS, Bcachefs y NTFS),
SnapRAID puede mantener automáticamente una referencia congelada de sus discos de datos.
Esto garantiza que incluso si modifica o elimina archivos en su sistema de archivos activo
durante o después de un sync, el proceso de recuperación se mantenga consistente y confiable.
.PD
.PD 0
.IP \(bu
Sin soporte para instantáneas, eliminar o cambiar archivos después de un \`sync\`
puede impedir la recuperación completa de otros discos fallidos. Esto ocurre
porque la paridad ya no coincide con los archivos modificados, incluso si
esos archivos no están en el disco fallido. Por otro lado, los archivos recién añadidos
no impiden la recuperación de los archivos ya existentes.
.PD
.PP
Otras limitaciones de SnapRAID son:
.PD 0
@ -661,18 +672,18 @@ snapraid sync
.PP
Si todo se recupera, este comando es inmediato.
.SH COMMANDS
SnapRAID proporciona algunos comandos simples que le permiten:
SnapRAID proporciona unos pocos comandos simples que le permiten:
.PD 0
.IP \(bu
Imprimir el estado del array \-> \`status\`
Mostrar el estado de la matriz \-> \`status\`
.IP \(bu
Controlar los discos \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
Hacer una copia de seguridad/instantánea \-> \`sync\`
Crear un punto de copia de seguridad/recuperación \-> \`sync\`
.IP \(bu
Comprobar periódicamente los datos \-> \`scrub\`
.IP \(bu
Restaurar la última copia de seguridad/instantánea \-> \`fix\`.
Restaurar el último punto de copia de seguridad/recuperación \-> \`fix\`.
.PD
.PP
Los comandos deben escribirse en minúsculas.
@ -912,15 +923,14 @@ verificación de cada bloque y para marcar bloques defectuosos.
Los archivos \`parity\` NO se modifican.
Los archivos en el array NO se modifican.
.SS fix
Corrige todos los archivos y la información de paridad.
Repara todos los archivos y los datos de paridad.
.PP
Todos los archivos y la información de paridad se comparan con el
estado de instantánea guardado en el último \`sync\`.
Si se encuentra una diferencia, se revierte a la instantánea almacenada.
Todos los archivos y datos de paridad si comparan con el estado guardado en
el último \`sync\`. Si se encuentra una diferencia, se revierte al estado almacenado.
.PP
¡ADVERTENCIA! El comando \`fix\` no diferencia entre errores y
modificaciones intencionales. Revierte incondicionalmente el estado
del archivo al último \`sync\`.
¡ADVERTENCIA!
El comando \`fix\` no diferencia entre errores y modificaciones intencionadas.
Revierte incondicionalmente el estado del archivo al del último \`sync\`.
.PP
Si no se especifica otra opción, se procesa todo el array.
Utilice las opciones de filtro para seleccionar un subconjunto de
@ -1483,6 +1493,30 @@ el disco de arranque.
.PP
Tenga en cuenta que dichos discos no se ven afectados por los comandos \`up\` y \`down\`
porque se espera que estén siempre girando.
.SS snapshot
Habilita el uso de instantáneas del sistema de archivos para los comandos \`sync\`, \`scrub\`,
\`check\` y \`fix\`.
.PP
Cuando está habilitado, SnapRAID crea una instantánea de solo lectura de sus datos al
comienzo de un \'sync\'. Esto asegura una vista consistente y en un punto en el tiempo de sus
archivos, evitando errores causados por modificaciones concurrentes de archivos.
.PP
Esto mejora significativamente la recuperación: si un archivo se elimina del sistema de archivos activo,
permanece preservado en la instantánea. Esto evita que la paridad se \[dq]rompa\[dq]
para ese bloque, asegurando che aún pueda recuperar los datos con éxito
si falla otro disco.
.PP
Esta opción se aplica exclusivamente a discos de datos formateados con los sistemas de
archivos Btrfs, Bcachefs o ZFS en Linux y NTFS en Windows.
Los discos de paridad, o los discos de datos que usen otros sistemas de archivos, siempre usarán
la versión activa del sistema de archivos.
.PP
La creación y eliminación de instantáneas requieren privilegios administrativos.
Asegúrese de que SnapRAID se ejecute con los permisos necesarios (por ejemplo, sudo) cuando
esta opción esté habilitada.
.PP
Consulte la sección SNAPSHOTS para obtener una explicación detallada del ciclo de vida
de las instantáneas.
.SS nohidden
Excluye todos los archivos y directorios ocultos.
En Unix, los archivos ocultos son los que comienzan con \`.\`.
@ -1835,6 +1869,127 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS
Si la opción de instantánea está habilitada en la configuración, SnapRAID
utiliza la funcionalidad de instantáneas del sistema de archivos para garantizar operaciones atómicas
y consistentes.
.PP
La gestión de las instantáneas es completamente automática y transparente.
Puede continuar usando SnapRAID exactamente como antes, con la
protección adicional proporcionada por las instantáneas gestionadas completamente en
segundo plano.
.PP
Esto proporciona dos beneficios primordiales:
.RS 0
.PD 0
.HP 4
.I Consistencia
Los archivos modificados en el sistema de archivos activo durante un sync o scrub de
larga duración no causarán desajustes de paridad ni operaciones abortadas,
ya que SnapRAID ve una imagen congelada en el tiempo.
.HP 4
.I Recuperación
Si un archivo se actualiza o elimina del sistema de archivos activo,
permanece preservado en la instantánea. Si ocurre un fallo de disco
antes de que se ejecute el siguiente sync, SnapRAID utiliza los datos preservados
en la instantánea para reconstruir el disco fallido.
.PD
.PP
.RS 4
.PD 0
En caso de fallo de un disco durante un proceso de sync activo,
SnapRAID también es capaz de leer automáticamente tanto de la instantánea
del cómputo de paridad anterior como del actual.
Esto maximiza la probabilidad de una recuperación completa al
proporcionar acceso a los bloques de datos exactos requeridos para resolver
las ecuaciones de paridad, incluso si esos bloques fueron modificados
o eliminados entre syncs.
.PD
.PP
.PD 0
Sin instantáneas, un archivo actualizado o eliminado en un disco sano
da como resultado la pérdida de bloques de datos que pueden ser necesarios para
reparar otros discos fallidos.
.PD
.RE
.RE
.PP
Las instantáneas se crean solo para discos de datos y solo si el sistema de archivos
subyacente admite esta funcionalidad. Los discos de paridad siempre usan
el sistema de archivos activo.
Actualmente, esto es compatible con Btrfs, Bcachefs y ZFS en Linux
y con NTFS en Windows.
.PP
Puede mezclar discos de datos con diferentes sistemas de archivos. Solo aquellos que
admitan instantáneas las utilizarán, mientras que los demás discos continuarán
operando directamente en el sistema de archivos activo.
.PP
La creación y eliminación de instantáneas requieren privilegios administrativos.
Asegúrese de que SnapRAID se ejecute con los permisos necesarios (por ejemplo, sudo)
cuando las instantáneas estén habilitadas.
.SS Comportamiento de comandos con instantáneas
Los comandos \`sync\` y \`scrub\` operan exclusivamente en instantáneas
para garantizar que todas las operaciones de datos se realicen contra un estado consistente
y congelado. Al utilizar estas instantáneas, SnapRAID evita desajustes de paridad
que de otro modo serian provocados por modificaciones de archivos concurrentes en el sistema de archivos activo.
Durante un \`sync\`, el comando utiliza una nueva instantánea creada al
inicio del proceso para capturar el estado actual para el cómputo de paridad.
Por el contrario, el comando \`scrub\` utiliza la última instantánea, la
creada durante el sync más reciente, para mantener un punto de referencia confiable
que coincida con la paridad existente.
.PP
Para los comandos \`check\` y \`fix\`, el uso de la última instantánea
depende de si se seleccionan discos específicos mediante la opción
\-d, \-\-filter\-disk.
.PP
Un disco seleccionado explícitamente mediante \-d (el \[dq]objetivo\[dq] de la operación)
siempre utiliza el sistema de archivos activo. Para \`fix\`, esto permite restaurar
datos en el reemplazo de disco activo. Para \`check\`, permite simular
la operación \`fix\` bajo las mismas condiciones.
.PP
Todos los demás discos de datos (los discos de \[dq]referencia\[dq]) se accederán a través de
sus instantáneas. Esto garantiza que incluso si está modificando archivos
en sus discos sanos mientras se realiza una recuperación, SnapRAID
tenga una referencia estable y congelada para resolver las ecuaciones de paridad.
.PP
Si no se proporciona la opción \-d, SnapRAID asume que la operación se aplica
a toda la matriz, en cuyo caso, \`check\` y \`fix\` usarán los sistemas
de archivos activos exclusivamente.
.PP
Todos los demás comandos funcionan exclusivamente en el sistema de archivos activo.
.SH CICLO DE VIDA DE LAS INSTANTáNEAS
SnapRAID gestiona dos instantáneas específicas, \`stable\` y \`pending\`,
dentro de un directorio oculto en la raíz de cada subvolumen de datos.
En Btrfs, Bcachefs y NTFS se utiliza el directorio \`.snapraid/\`,
en ZFS el estándar \`.zfs/snapshot/\`.
.PP
La instantánea \`stable\` representa el estado del último
\`sync\` completado con éxito, que contiene los datos exactos utilizados para
calcular la paridad actual. Sirve como fuente de datos principal
para los comandos \`scrub\`, \`check\` y \`fix\`.
.PP
La instantánea \`pending\` es una imagen temporal creada al inicio
de un \`sync\` para proporcionar un estado congelado para el cómputo de paridad.
Una vez completada con éxito la operación, la instantánea \`stable\` anterior
se elimina y la instantánea \`pending\` se promueve para
tomar su lugar como la nueva referencia estable.
.PP
Si un \`sync\` se interrumpe, la instantánea \`pending\` se conserva.
Los comandos posteriores \`scrub\`, \`check\` y \`fix\` utilizarán esta
instantánea pendiente, ya que coincide con el estado del sistema de archivos registrado en
el archivo .content, incluso si la paridad solo está parcialmente sincronizada.
.PP
En caso de interrupción de un \`sync\`, los comandos \`check\` y \`fix\`
también leen de la instantánea \`stable\` para recuperar bloques de datos
de archivos que se actualizaron o eliminaron durante el sync.
Esto es posible porque el archivo .content conserva los metadatos de
todos los archivos modificados o eliminados durante todo el proceso de sync.
Esta información histórica solo se borra una vez que el sync finaliza
con éxito y se guarda la versión final del archivo .content.
.PP
Si un \`sync\` se reinicia después de una interrupción, la instantánea pending existente
se elimina y se crea una nueva para
capturar el estado actual del sistema de archivos activo.
.SH PATTERN
Los patrones proporcionan una forma flexible de filtrar archivos para su inclusión o
exclusión. Al usar caracteres de globbing, puede definir reglas que coincidan con

View file

@ -52,23 +52,30 @@ Description
:https://www.snapraid.it/
Limitations
SnapRAID es un híbrido entre un programa RAID y un programa de copia
de seguridad, con el objetivo de combinar los mejores beneficios de
ambos. Sin embargo, tiene algunas limitaciones que debe considerar
antes de usarlo.
Limitaciones
SnapRAID es un híbrido entre un RAID y un programa de copia de seguridad, con el objetivo di combinar
los mejores beneficios de ambos. Sin embargo, tiene algunas limitaciones que debería
considerar antes de usarlo.
La principal limitación es que si un disco falla y no ha sincronizado
recientemente, es posible que no pueda recuperarse por completo.
Más específicamente, es posible que no pueda recuperar hasta el tamaño
de los archivos cambiados o eliminados desde la última operación de
sincronización. Esto ocurre incluso si los archivos cambiados o
eliminados no están en el disco fallido. Esta es la razón por la que
SnapRAID es más adecuado para datos que rara vez cambian.
La principal limitación es que si un disco falla, solo puede recuperar datos hasta el
estado de la última operación de sincronización (`sync`). Cualquier dato añadido o modificación realizada
desde la última sincronización que se encuentre en el disco dañado se perderá.
Por otro lado, los archivos recién agregados no impiden la recuperación
de los archivos ya existentes. Solo perderá los archivos recién
agregados si están en el disco fallido.
Por lo tanto, SnapRAID es adecuado principalmente para datos que cambian raramente.
Para los datos que ya existían en la última sincronización, la fiabilidad de la recuperación depende
de si se utiliza la opción de instantánea (`snapshot`):
* Con soporte para instantáneas (disponible en Btrfs, ZFS, Bcachefs y NTFS),
SnapRAID puede mantener automáticamente una referencia congelada de sus discos de datos.
Esto garantiza que incluso si modifica o elimina archivos en su sistema de archivos activo
durante o después de un sync, el proceso de recuperación se mantenga consistente y confiable.
* Sin soporte para instantáneas, eliminar o cambiar archivos después de un `sync`
puede impedir la recuperación completa de otros discos fallidos. Esto ocurre
porque la paridad ya no coincide con los archivos modificados, incluso si
esos archivos no están en el disco fallido. Por otro lado, los archivos recién añadidos
no impiden la recuperación de los archivos ya existentes.
Otras limitaciones de SnapRAID son:
@ -401,13 +408,13 @@ Getting Started
Si todo se recupera, este comando es inmediato.
Commands
SnapRAID proporciona algunos comandos simples que le permiten:
SnapRAID proporciona unos pocos comandos simples que le permiten:
* Imprimir el estado del array -> `status`
* Mostrar el estado de la matriz -> `status`
* Controlar los discos -> `smart`, `probe`, `up`, `down`
* Hacer una copia de seguridad/instantánea -> `sync`
* Crear un punto de copia de seguridad/recuperación -> `sync`
* Comprobar periódicamente los datos -> `scrub`
* Restaurar la última copia de seguridad/instantánea -> `fix`.
* Restaurar el último punto de copia de seguridad/recuperación -> `fix`.
Los comandos deben escribirse en minúsculas.
@ -621,15 +628,14 @@ Commands
Los archivos en el array NO se modifican.
fix
Corrige todos los archivos y la información de paridad.
Repara todos los archivos y los datos de paridad.
Todos los archivos y la información de paridad se comparan con el
estado de instantánea guardado en el último `sync`.
Si se encuentra una diferencia, se revierte a la instantánea almacenada.
Todos los archivos y datos de paridad si comparan con el estado guardado en
el último `sync`. Si se encuentra una diferencia, se revierte al estado almacenado.
¡ADVERTENCIA! El comando `fix` no diferencia entre errores y
modificaciones intencionales. Revierte incondicionalmente el estado
del archivo al último `sync`.
¡ADVERTENCIA!
El comando `fix` no diferencia entre errores y modificaciones intencionadas.
Revierte incondicionalmente el estado del archivo al del último `sync`.
Si no se especifica otra opción, se procesa todo el array.
Utilice las opciones de filtro para seleccionar un subconjunto de
@ -1203,6 +1209,31 @@ Configuration
Tenga en cuenta que dichos discos no se ven afectados por los comandos `up` y `down`
porque se espera que estén siempre girando.
snapshot
Habilita el uso de instantáneas del sistema de archivos para los comandos `sync`, `scrub`,
`check` y `fix`.
Cuando está habilitado, SnapRAID crea una instantánea de solo lectura de sus datos al
comienzo de un 'sync'. Esto asegura una vista consistente y en un punto en el tiempo de sus
archivos, evitando errores causados por modificaciones concurrentes de archivos.
Esto mejora significativamente la recuperación: si un archivo se elimina del sistema de archivos activo,
permanece preservado en la instantánea. Esto evita que la paridad se "rompa"
para ese bloque, asegurando che aún pueda recuperar los datos con éxito
si falla otro disco.
Esta opción se aplica exclusivamente a discos de datos formateados con los sistemas de
archivos Btrfs, Bcachefs o ZFS en Linux y NTFS en Windows.
Los discos de paridad, o los discos de datos que usen otros sistemas de archivos, siempre usarán
la versión activa del sistema de archivos.
La creación y eliminación de instantáneas requieren privilegios administrativos.
Asegúrese de que SnapRAID se ejecute con los permisos necesarios (por ejemplo, sudo) cuando
esta opción esté habilitada.
Consulte la sección SNAPSHOTS para obtener una explicación detallada del ciclo de vida
de las instantáneas.
nohidden
Excluye todos los archivos y directorios ocultos.
En Unix, los archivos ocultos son los que comienzan con `.`.
@ -1459,6 +1490,117 @@ Configuration
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots
Si la opción de instantánea está habilitada en la configuración, SnapRAID
utiliza la funcionalidad de instantáneas del sistema de archivos para garantizar operaciones atómicas
y consistentes.
La gestión de las instantáneas es completamente automática y transparente.
Puede continuar usando SnapRAID exactamente como antes, con la
protección adicional proporcionada por las instantáneas gestionadas completamente en
segundo plano.
Esto proporciona dos beneficios primordiales:
Consistencia - Los archivos modificados en el sistema de archivos activo durante un sync o scrub de
larga duración no causarán desajustes de paridad ni operaciones abortadas,
ya que SnapRAID ve una imagen congelada en el tiempo.
Recuperación - Si un archivo se actualiza o elimina del sistema de archivos activo,
permanece preservado en la instantánea. Si ocurre un fallo de disco
antes de que se ejecute el siguiente sync, SnapRAID utiliza los datos preservados
en la instantánea para reconstruir el disco fallido.
En caso de fallo de un disco durante un proceso de sync activo,
SnapRAID también es capaz de leer automáticamente tanto de la instantánea
del cómputo de paridad anterior como del actual.
Esto maximiza la probabilidad de una recuperación completa al
proporcionar acceso a los bloques de datos exactos requeridos para resolver
las ecuaciones de paridad, incluso si esos bloques fueron modificados
o eliminados entre syncs.
Sin instantáneas, un archivo actualizado o eliminado en un disco sano
da como resultado la pérdida de bloques de datos que pueden ser necesarios para
reparar otros discos fallidos.
Las instantáneas se crean solo para discos de datos y solo si el sistema de archivos
subyacente admite esta funcionalidad. Los discos de paridad siempre usan
el sistema de archivos activo.
Actualmente, esto es compatible con Btrfs, Bcachefs y ZFS en Linux
y con NTFS en Windows.
Puede mezclar discos de datos con diferentes sistemas de archivos. Solo aquellos que
admitan instantáneas las utilizarán, mientras que los demás discos continuarán
operando directamente en el sistema de archivos activo.
La creación y eliminación de instantáneas requieren privilegios administrativos.
Asegúrese de que SnapRAID se ejecute con los permisos necesarios (por ejemplo, sudo)
cuando las instantáneas estén habilitadas.
Comportamiento de comandos con instantáneas
Los comandos `sync` y `scrub` operan exclusivamente en instantáneas
para garantizar que todas las operaciones de datos se realicen contra un estado consistente
y congelado. Al utilizar estas instantáneas, SnapRAID evita desajustes de paridad
que de otro modo serian provocados por modificaciones de archivos concurrentes en el sistema de archivos activo.
Durante un `sync`, el comando utiliza una nueva instantánea creada al
inicio del proceso para capturar el estado actual para el cómputo de paridad.
Por el contrario, el comando `scrub` utiliza la última instantánea, la
creada durante el sync más reciente, para mantener un punto de referencia confiable
que coincida con la paridad existente.
Para los comandos `check` y `fix`, el uso de la última instantánea
depende de si se seleccionan discos específicos mediante la opción
-d, --filter-disk.
Un disco seleccionado explícitamente mediante -d (el "objetivo" de la operación)
siempre utiliza el sistema de archivos activo. Para `fix`, esto permite restaurar
datos en el reemplazo de disco activo. Para `check`, permite simular
la operación `fix` bajo las mismas condiciones.
Todos los demás discos de datos (los discos de "referencia") se accederán a través de
sus instantáneas. Esto garantiza que incluso si está modificando archivos
en sus discos sanos mientras se realiza una recuperación, SnapRAID
tenga una referencia estable y congelada para resolver las ecuaciones de paridad.
Si no se proporciona la opción -d, SnapRAID asume que la operación se aplica
a toda la matriz, en cuyo caso, `check` y `fix` usarán los sistemas
de archivos activos exclusivamente.
Todos los demás comandos funcionan exclusivamente en el sistema de archivos activo.
Ciclo de vida de las instantáneas
SnapRAID gestiona dos instantáneas específicas, `stable` y `pending`,
dentro de un directorio oculto en la raíz de cada subvolumen de datos.
En Btrfs, Bcachefs y NTFS se utiliza el directorio `.snapraid/`,
en ZFS el estándar `.zfs/snapshot/`.
La instantánea `stable` representa el estado del último
`sync` completado con éxito, que contiene los datos exactos utilizados para
calcular la paridad actual. Sirve como fuente de datos principal
para los comandos `scrub`, `check` y `fix`.
La instantánea `pending` es una imagen temporal creada al inicio
de un `sync` para proporcionar un estado congelado para el cómputo de paridad.
Una vez completada con éxito la operación, la instantánea `stable` anterior
se elimina y la instantánea `pending` se promueve para
tomar su lugar como la nueva referencia estable.
Si un `sync` se interrumpe, la instantánea `pending` se conserva.
Los comandos posteriores `scrub`, `check` y `fix` utilizarán esta
instantánea pendiente, ya que coincide con el estado del sistema de archivos registrado en
el archivo .content, incluso si la paridad solo está parcialmente sincronizada.
En caso de interrupción de un `sync`, los comandos `check` y `fix`
también leen de la instantánea `stable` para recuperar bloques de datos
de archivos que se actualizaron o eliminaron durante el sync.
Esto es posible porque el archivo .content conserva los metadatos de
todos los archivos modificados o eliminados durante todo el proceso de sync.
Esta información histórica solo se borra una vez que el sync finaliza
con éxito y se guarda la versión final del archivo .content.
Si un `sync` se reinicia después de una interrupción, la instantánea pending existente
se elimina y se crea una nueva para
capturar el estado actual del sistema de archivos activo.
Pattern
Los patrones proporcionan una forma flexible de filtrar archivos para su inclusión o
exclusión. Al usar caracteres de globbing, puede definir reglas que coincidan con

View file

@ -60,25 +60,32 @@ Para más información, visite el sitio oficial de SnapRAID:
https://www.snapraid.it/
3 LIMITATIONS
=============
3 LIMITACIONES
==============
SnapRAID es un híbrido entre un programa RAID y un programa de copia
de seguridad, con el objetivo de combinar los mejores beneficios de
ambos. Sin embargo, tiene algunas limitaciones que debe considerar
antes de usarlo.
SnapRAID es un híbrido entre un RAID y un programa de copia de seguridad, con el objetivo di combinar
los mejores beneficios de ambos. Sin embargo, tiene algunas limitaciones que debería
considerar antes de usarlo.
La principal limitación es que si un disco falla y no ha sincronizado
recientemente, es posible que no pueda recuperarse por completo.
Más específicamente, es posible que no pueda recuperar hasta el tamaño
de los archivos cambiados o eliminados desde la última operación de
sincronización. Esto ocurre incluso si los archivos cambiados o
eliminados no están en el disco fallido. Esta es la razón por la que
SnapRAID es más adecuado para datos que rara vez cambian.
La principal limitación es que si un disco falla, solo puede recuperar datos hasta el
estado de la última operación de sincronización (`sync`). Cualquier dato añadido o modificación realizada
desde la última sincronización que se encuentre en el disco dañado se perderá.
Por otro lado, los archivos recién agregados no impiden la recuperación
de los archivos ya existentes. Solo perderá los archivos recién
agregados si están en el disco fallido.
Por lo tanto, SnapRAID es adecuado principalmente para datos que cambian raramente.
Para los datos que ya existían en la última sincronización, la fiabilidad de la recuperación depende
de si se utiliza la opción de instantánea (`snapshot`):
* Con soporte para instantáneas (disponible en Btrfs, ZFS, Bcachefs y NTFS),
SnapRAID puede mantener automáticamente una referencia congelada de sus discos de datos.
Esto garantiza que incluso si modifica o elimina archivos en su sistema de archivos activo
durante o después de un sync, el proceso de recuperación se mantenga consistente y confiable.
* Sin soporte para instantáneas, eliminar o cambiar archivos después de un `sync`
puede impedir la recuperación completa de otros discos fallidos. Esto ocurre
porque la paridad ya no coincide con los archivos modificados, incluso si
esos archivos no están en el disco fallido. Por otro lado, los archivos recién añadidos
no impiden la recuperación de los archivos ya existentes.
Otras limitaciones de SnapRAID son:
@ -425,13 +432,13 @@ Si todo se recupera, este comando es inmediato.
5 COMMANDS
==========
SnapRAID proporciona algunos comandos simples que le permiten:
SnapRAID proporciona unos pocos comandos simples que le permiten:
* Imprimir el estado del array -> `status`
* Mostrar el estado de la matriz -> `status`
* Controlar los discos -> `smart`, `probe`, `up`, `down`
* Hacer una copia de seguridad/instantánea -> `sync`
* Crear un punto de copia de seguridad/recuperación -> `sync`
* Comprobar periódicamente los datos -> `scrub`
* Restaurar la última copia de seguridad/instantánea -> `fix`.
* Restaurar el último punto de copia de seguridad/recuperación -> `fix`.
Los comandos deben escribirse en minúsculas.
@ -663,15 +670,14 @@ Los archivos en el array NO se modifican.
5.9 fix
-------
Corrige todos los archivos y la información de paridad.
Repara todos los archivos y los datos de paridad.
Todos los archivos y la información de paridad se comparan con el
estado de instantánea guardado en el último `sync`.
Si se encuentra una diferencia, se revierte a la instantánea almacenada.
Todos los archivos y datos de paridad si comparan con el estado guardado en
el último `sync`. Si se encuentra una diferencia, se revierte al estado almacenado.
¡ADVERTENCIA! El comando `fix` no diferencia entre errores y
modificaciones intencionales. Revierte incondicionalmente el estado
del archivo al último `sync`.
¡ADVERTENCIA!
El comando `fix` no diferencia entre errores y modificaciones intencionadas.
Revierte incondicionalmente el estado del archivo al del último `sync`.
Si no se especifica otra opción, se procesa todo el array.
Utilice las opciones de filtro para seleccionar un subconjunto de
@ -1279,14 +1285,41 @@ el disco de arranque.
Tenga en cuenta que dichos discos no se ven afectados por los comandos `up` y `down`
porque se espera que estén siempre girando.
7.7 nohidden
7.7 snapshot
------------
Habilita el uso de instantáneas del sistema de archivos para los comandos `sync`, `scrub`,
`check` y `fix`.
Cuando está habilitado, SnapRAID crea una instantánea de solo lectura de sus datos al
comienzo de un 'sync'. Esto asegura una vista consistente y en un punto en el tiempo de sus
archivos, evitando errores causados por modificaciones concurrentes de archivos.
Esto mejora significativamente la recuperación: si un archivo se elimina del sistema de archivos activo,
permanece preservado en la instantánea. Esto evita que la paridad se "rompa"
para ese bloque, asegurando che aún pueda recuperar los datos con éxito
si falla otro disco.
Esta opción se aplica exclusivamente a discos de datos formateados con los sistemas de
archivos Btrfs, Bcachefs o ZFS en Linux y NTFS en Windows.
Los discos de paridad, o los discos de datos que usen otros sistemas de archivos, siempre usarán
la versión activa del sistema de archivos.
La creación y eliminación de instantáneas requieren privilegios administrativos.
Asegúrese de que SnapRAID se ejecute con los permisos necesarios (por ejemplo, sudo) cuando
esta opción esté habilitada.
Consulte la sección SNAPSHOTS para obtener una explicación detallada del ciclo de vida
de las instantáneas.
7.8 nohidden
------------
Excluye todos los archivos y directorios ocultos.
En Unix, los archivos ocultos son los que comienzan con `.`.
En Windows, son los que tienen el atributo oculto.
7.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
Define los patrones de archivo o directorio a excluir o incluir
@ -1304,8 +1337,8 @@ las especificaciones de patrones.
Esta opción se puede usar varias veces.
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
Define el tamaño de bloque básico en kibibytes para la paridad.
Un kibibyte es 1024 bytes.
@ -1358,7 +1391,7 @@ aproximadamente 60 GB para un disco de 4 TB, lo que permite
alrededor de 460,000 archivos en cada disco de datos sin ningún
espacio desperdiciado.
7.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
Define el tamaño del hash en bytes para los bloques guardados.
@ -1397,7 +1430,7 @@ obtiene:
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
Guarda automáticamente el estado al sincronizar o fregar después de
@ -1406,7 +1439,7 @@ Esta opción es útil para evitar reiniciar comandos `sync` largos
desde cero si son interrumpidos por un fallo de la máquina o
cualquier otro evento.
7.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
Establece la temperatura máxima permitida del disco en Celsius.
@ -1443,14 +1476,14 @@ Normalmente, SnapRAID solo muestra la temperatura del disco más
caliente. Para mostrar la temperatura de todos los discos, use
la opción -A o --stats.
7.13 temp_sleep TIME_IN_MINUTES
7.14 temp_sleep TIME_IN_MINUTES
-------------------------------
Establece el tiempo de espera, en minutos, cuando se alcanza el
límite de temperatura. Durante este período, los discos permanecen
detenidos. El valor predeterminado es de 5 minutos.
7.14 pool DIR
7.15 pool DIR
-------------
Define el directorio de agrupación (pooling) donde se crea la vista
@ -1458,7 +1491,7 @@ virtual del array de discos utilizando el comando `pool`.
El directorio ya debe existir.
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
Define la ruta UNC de Windows requerida para acceder a los discos
@ -1476,7 +1509,7 @@ y finalmente agregando el directorio y el nombre del archivo.
Esta opción solo es necesaria para Windows.
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
Define opciones personalizadas de smartctl para obtener los atributos
@ -1503,7 +1536,7 @@ Por ejemplo:
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
Ignora el atributo SMART especificado al calcular la probabilidad
@ -1525,7 +1558,7 @@ Para ignorarlo solo en el primer disco de paridad:
smartignore parity 197
7.18 Examples
7.19 Examples
-------------
Un ejemplo de una configuración típica para Unix es:
@ -1560,8 +1593,127 @@ Un ejemplo de una configuración típica para Windows es:
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 PATTERN
=========
8 SNAPSHOTS
===========
Si la opción de instantánea está habilitada en la configuración, SnapRAID
utiliza la funcionalidad de instantáneas del sistema de archivos para garantizar operaciones atómicas
y consistentes.
La gestión de las instantáneas es completamente automática y transparente.
Puede continuar usando SnapRAID exactamente como antes, con la
protección adicional proporcionada por las instantáneas gestionadas completamente en
segundo plano.
Esto proporciona dos beneficios primordiales:
Consistencia - Los archivos modificados en el sistema de archivos activo durante un sync o scrub de
larga duración no causarán desajustes de paridad ni operaciones abortadas,
ya que SnapRAID ve una imagen congelada en el tiempo.
Recuperación - Si un archivo se actualiza o elimina del sistema de archivos activo,
permanece preservado en la instantánea. Si ocurre un fallo de disco
antes de que se ejecute el siguiente sync, SnapRAID utiliza los datos preservados
en la instantánea para reconstruir el disco fallido.
En caso de fallo de un disco durante un proceso de sync activo,
SnapRAID también es capaz de leer automáticamente tanto de la instantánea
del cómputo de paridad anterior como del actual.
Esto maximiza la probabilidad de una recuperación completa al
proporcionar acceso a los bloques de datos exactos requeridos para resolver
las ecuaciones de paridad, incluso si esos bloques fueron modificados
o eliminados entre syncs.
Sin instantáneas, un archivo actualizado o eliminado en un disco sano
da como resultado la pérdida de bloques de datos que pueden ser necesarios para
reparar otros discos fallidos.
Las instantáneas se crean solo para discos de datos y solo si el sistema de archivos
subyacente admite esta funcionalidad. Los discos de paridad siempre usan
el sistema de archivos activo.
Actualmente, esto es compatible con Btrfs, Bcachefs y ZFS en Linux
y con NTFS en Windows.
Puede mezclar discos de datos con diferentes sistemas de archivos. Solo aquellos que
admitan instantáneas las utilizarán, mientras que los demás discos continuarán
operando directamente en el sistema de archivos activo.
La creación y eliminación de instantáneas requieren privilegios administrativos.
Asegúrese de que SnapRAID se ejecute con los permisos necesarios (por ejemplo, sudo)
cuando las instantáneas estén habilitadas.
8.1 Comportamiento de comandos con instantáneas
-----------------------------------------------
Los comandos `sync` y `scrub` operan exclusivamente en instantáneas
para garantizar que todas las operaciones de datos se realicen contra un estado consistente
y congelado. Al utilizar estas instantáneas, SnapRAID evita desajustes de paridad
que de otro modo serian provocados por modificaciones de archivos concurrentes en el sistema de archivos activo.
Durante un `sync`, el comando utiliza una nueva instantánea creada al
inicio del proceso para capturar el estado actual para el cómputo de paridad.
Por el contrario, el comando `scrub` utiliza la última instantánea, la
creada durante el sync más reciente, para mantener un punto de referencia confiable
que coincida con la paridad existente.
Para los comandos `check` y `fix`, el uso de la última instantánea
depende de si se seleccionan discos específicos mediante la opción
-d, --filter-disk.
Un disco seleccionado explícitamente mediante -d (el "objetivo" de la operación)
siempre utiliza el sistema de archivos activo. Para `fix`, esto permite restaurar
datos en el reemplazo de disco activo. Para `check`, permite simular
la operación `fix` bajo las mismas condiciones.
Todos los demás discos de datos (los discos de "referencia") se accederán a través de
sus instantáneas. Esto garantiza que incluso si está modificando archivos
en sus discos sanos mientras se realiza una recuperación, SnapRAID
tenga una referencia estable y congelada para resolver las ecuaciones de paridad.
Si no se proporciona la opción -d, SnapRAID asume que la operación se aplica
a toda la matriz, en cuyo caso, `check` y `fix` usarán los sistemas
de archivos activos exclusivamente.
Todos los demás comandos funcionan exclusivamente en el sistema de archivos activo.
9 CICLO DE VIDA DE LAS INSTANTáNEAS
===================================
SnapRAID gestiona dos instantáneas específicas, `stable` y `pending`,
dentro de un directorio oculto en la raíz de cada subvolumen de datos.
En Btrfs, Bcachefs y NTFS se utiliza el directorio `.snapraid/`,
en ZFS el estándar `.zfs/snapshot/`.
La instantánea `stable` representa el estado del último
`sync` completado con éxito, que contiene los datos exactos utilizados para
calcular la paridad actual. Sirve como fuente de datos principal
para los comandos `scrub`, `check` y `fix`.
La instantánea `pending` es una imagen temporal creada al inicio
de un `sync` para proporcionar un estado congelado para el cómputo de paridad.
Una vez completada con éxito la operación, la instantánea `stable` anterior
se elimina y la instantánea `pending` se promueve para
tomar su lugar como la nueva referencia estable.
Si un `sync` se interrumpe, la instantánea `pending` se conserva.
Los comandos posteriores `scrub`, `check` y `fix` utilizarán esta
instantánea pendiente, ya que coincide con el estado del sistema de archivos registrado en
el archivo .content, incluso si la paridad solo está parcialmente sincronizada.
En caso de interrupción de un `sync`, los comandos `check` y `fix`
también leen de la instantánea `stable` para recuperar bloques de datos
de archivos que se actualizaron o eliminaron durante el sync.
Esto es posible porque el archivo .content conserva los metadatos de
todos los archivos modificados o eliminados durante todo el proceso de sync.
Esta información histórica solo se borra una vez que el sync finaliza
con éxito y se guarda la versión final del archivo .content.
Si un `sync` se reinicia después de una interrupción, la instantánea pending existente
se elimina y se crea una nueva para
capturar el estado actual del sistema de archivos activo.
10 PATTERN
==========
Los patrones proporcionan una forma flexible de filtrar archivos para su inclusión o
exclusión. Al usar caracteres de globbing, puede definir reglas que coincidan con
@ -1683,8 +1835,8 @@ En Unix, al usar caracteres globbing en la línea de comandos, debe
ponerlos entre comillas para evitar que el shell los expanda.
9 IGNORAR ARCHIVOS
==================
11 IGNORAR ARCHIVOS
===================
Además de las reglas globales en el archivo de configuración, puedes
colocar archivos `.snapraidignore` en cualquier directorio dentro del array
@ -1728,7 +1880,7 @@ Por ejemplo, si tienes un `.snapraidignore` en `/mnt/disk1/projects/`:
*.tmp
10 CONTENT
12 CONTENT
==========
SnapRAID almacena la lista y las sumas de comprobación de sus
@ -1742,7 +1894,7 @@ Este archivo es leído y escrito por los comandos `sync` y `scrub`
y leído por los comandos `fix`, `check` y `status`.
11 PARITY
13 PARITY
=========
SnapRAID almacena la información de paridad de su array en los
@ -1755,7 +1907,7 @@ Estos archivos son leídos y escritos por los comandos `sync` y `fix`
y solo leídos por los comandos `scrub` y `check`.
12 ENCODING
14 ENCODING
===========
SnapRAID en Unix ignora cualquier codificación. Lee y almacena los
@ -1773,13 +1925,13 @@ archivo impresos; si redirige la salida de la consola a un archivo,
el archivo resultante siempre está en formato UTF-8.
13 COPYRIGHT
15 COPYRIGHT
============
Este archivo es Copyright (C) 2025 Andrea Mazzoleni
14 SEE ALSO
16 SEE ALSO
===========
snapraid_log(1), snapraidd(1)

View file

@ -114,23 +114,33 @@ https://www.snapraid.it/
.PD
.RE
.SH LIMITATIONS
SnapRAID est un hybride entre un programme RAID et un programme de sauvegarde,
visant à combiner les meilleurs avantages des deux. Cependant, il a quelques
limitations que vous devriez considérer avant de l\'utiliser.
SnapRAID est un hybride entre un RAID et un programme de sauvegarde, visant à combiner
les meilleurs avantages des deux. Cependant, il présente certaines limitations que vous devriez
prendre en compte avant de l\'utiliser.
.PP
La principale limitation est que si un disque tombe en panne et que vous
n\'avez pas synchronisé récemment, vous pourriez ne pas être en mesure de
récupérer complètement.
Plus précisément, vous pourriez ne pas être en mesure de récupérer jusqu\'à
la taille des fichiers modifiés ou supprimés depuis la dernière opération
de synchronisation.
Cela se produit même si les fichiers modifiés ou supprimés ne se trouvent
pas sur le disque défaillant. C\'est pourquoi SnapRAID est mieux adapté
aux données qui changent rarement.
La principale limitation est que si un disque tombe en panne, vous ne pouvez récupérer les données que jusqu\'à
l\'état du dernier processus \`sync\`. Toutes les données ajoutées ou modifications effectuées
depuis la dernière synchronisation situées sur le disque défectueux seront perdues.
.PP
D\'un autre côté, les fichiers nouvellement ajoutés n\'empêchent pas
la récupération des fichiers déjà existants. Vous ne perdrez que les
fichiers récemment ajoutés s\'ils se trouvent sur le disque défaillant.
Par conséquent, SnapRAID est principalement adapté aux données qui changent rarement.
.PP
Pour les données qui existaient déjà lors de la dernière synchronisation, la fiabilité de la récupération dépend
de l\'utilisation ou non de l\'option \`snapshot\` :
.PD 0
.IP \(bu
Avec la prise en charge des instantanés (disponible sur Btrfs, ZFS, Bcachefs et NTFS),
SnapRAID peut maintenir automatiquement une référence figée de vos disques de données.
Cela garantit que même si vous modifiez ou supprimez des fichiers sur votre système de fichiers actif
pendant ou après une synchronisation, le processus de récupération reste cohérent et fiable.
.PD
.PD 0
.IP \(bu
Sans la prise en charge des instantanés, la suppression ou la modification de fichiers après un \`sync\`
peut empêcher la récupération complète d\'autres disques en panne. Cela se produit
parce que la parité ne correspond plus aux fichiers modifiés, même si
ces fichiers ne se trouvent pas sur le disque défectueux. D\'un autre côté, les fichiers nouvellement ajoutés
n\'empêchent pas la récupération des fichiers déjà existants.
.PD
.PP
Les autres limitations de SnapRAID sont :
.PD 0
@ -675,15 +685,15 @@ Si tout est récupéré, cette commande est immédiate.
SnapRAID fournit quelques commandes simples qui vous permettent de :
.PD 0
.IP \(bu
Afficher l\'état de la baie de disques \-> \`status\`
Afficher l\'état de la grappe \-> \`status\`
.IP \(bu
Contrôler les disques \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
Faire une sauvegarde/instantané \-> \`sync\`
Créer un point de sauvegarde/récupération \-> \`sync\`
.IP \(bu
Vérifier périodiquement les données \-> \`scrub\`
.IP \(bu
Restaurer la dernière sauvegarde/instantané \-> \`fix\`.
Restaurer le dernier point de sauvegarde/récupération \-> \`fix\`.
.PD
.PP
Les commandes doivent être écrites en minuscules.
@ -927,15 +937,15 @@ vérification de chaque bloc et pour marquer les mauvais blocs.
Les fichiers \`parity\` NE SONT PAS modifiés.
Les fichiers dans la baie NE SONT PAS modifiés.
.SS fix
Corrige tous les fichiers et les données de parité.
Répare tous les fichiers et les données de parité.
.PP
Tous les fichiers et les données de parité sont comparés à l\'état
de l\'instantané enregistré lors du dernier \`sync\`.
Si une différence est trouvée, elle est rétablie à l\'instantané stocké.
Tous les fichiers et les données de parité sont comparés à l\'état sauvegardé lors
du dernier \`sync\`. Si une différence est trouvée, elle est restaurée à l\'état enregistré.
.PP
AVERTISSEMENT ! La commande \`fix\` ne fait pas de distinction entre
les erreurs et les modifications intentionnelles. Elle rétablit
inconditionnellement l\'état du fichier au dernier \`sync\`.
AVERTISSEMENT !
La commande \`fix\` ne fait pas de différence entre les erreurs et
les modifications intentionnelles. Elle rétablit inconditionnellement l\'état des fichiers
tel qu\'il était lors du dernier \`sync\`.
.PP
Si aucune autre option n\'est spécifiée, l\'intégralité de la baie est traitée.
Utilisez les options de filtre pour sélectionner un sous\-ensemble de
@ -1516,6 +1526,30 @@ comme le disque de démarrage.
.PP
Notez que ces disques ne sont pas affectés par les commandes \`up\` et
\`down\` car ils sont censés toujours être en rotation.
.SS snapshot
Active l\'utilisation des instantanés du système de fichiers pour les commandes \`sync\`, \`scrub\`,
\`check\` et \`fix\`.
.PP
Lorsqu\'elle est activée, SnapRAID crée un instantané en lecture seule de vos données au
début d\'un \'sync\'. Cela garantit une vue cohérente et temporelle de vos
fichiers, évitant les erreurs causées par des modifications de fichiers simultanées.
.PP
Cela améliore considérablement la récupération : si un fichier est supprimé du système de fichiers actif,
il reste préservé dans l\'instantané. Cela évite que la parité ne devienne \[dq]rompue\[dq]
pour ce bloc, garantissant que vous pouvez toujours récupérer les données avec succès
si un autre disque tombe en panne.
.PP
Cette option s\'applique exclusivement aux disques de données formatés avec les
systèmes de fichiers Btrfs, Bcachefs ou ZFS sous Linux et NTFS sous Windows.
Les disques de parité, ou les disques de données utilisant d\'autres systèmes de fichiers, utiliseront toujours
la version active du système de fichiers.
.PP
La création et la suppression d\'instantanés nécessitent des privilèges d\'administration.
Assurez\-vous que SnapRAID est exécuté avec les autorisations nécessaires (par exemple, sudo) lorsque
cette option est activée.
.PP
Consultez la section SNAPSHOTS pour une explication détaillée du cycle de vie
des instantanés.
.SS nohidden
Exclut tous les fichiers et répertoires cachés.
Sous Unix, les fichiers cachés sont ceux commençant par \`.\`.
@ -1867,6 +1901,127 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS
Si l\'option snapshot est activée dans la configuration, SnapRAID
utilise la fonctionnalité d\'instantané du système de fichiers pour garantir des opérations atomiques
et cohérentes.
.PP
La gestion des instantanés est entièrement automatique et transparente.
Vous pouvez continuer à utiliser SnapRAID exactement comme avant, avec la
protection supplémentaire fournie par les instantanés gérés entièrement en
arrière\-plan.
.PP
Cela offre deux avantages principaux :
.RS 0
.PD 0
.HP 4
.I Cohérence
Les fichiers modifiés sur le système de fichiers actif pendant un sync ou un scrub
de longue durée ne provoqueront pas de déséquilibres de parité ni d\'opérations abandonnées,
car SnapRAID voit une image figée dans le temps.
.HP 4
.I Récupération
Si un fichier est mis à jour ou supprimé du système de fichiers actif,
il reste préservé dans l\'instantané. Si une panne de disque survient
avant l\'exécution du prochain sync, SnapRAID utilise les données préservées
dans l\'instantané pour reconstruire le disque défaillant.
.PD
.PP
.RS 4
.PD 0
En cas de panne de disque pendant un processus de sync actif,
SnapRAID est également capable de lire automatiquement à la fois l\'instantané
du calcul de parité précédent et celui en cours.
Cela maximise la probabilité d\'une récupération complète en
fournissant un accès aux blocs de données exacts requis pour résoudre
les équations de parité, même si ces blocs ont été modifiés
ou supprimés entre les syncs.
.PD
.PP
.PD 0
Sans instantanés, un fichier mis à jour ou supprimé sur un disque sain
entraîne des blocs de données manquants qui pourraient être nécessaires pour
réparer d\'autres disques défaillants.
.PD
.RE
.RE
.PP
Les instantanés sont créés uniquement pour les disques de données et uniquement si le système de fichiers
sous\-jacent prend en charge cette fonctionnalité. Les disques de parité utilisent toujours
le système de fichiers actif.
Actuellement, cela est pris en charge sur Btrfs, Bcachefs et ZFS sous Linux
et sur NTFS sous Windows.
.PP
Vous pouvez mélanger des disques de données avec différents systèmes de fichiers. Seuls ceux qui
prennent en charge les instantanés les utiliseront, tandis que les autres disques continueront
à fonctionner directement sur le système de fichiers actif.
.PP
La création et la suppression d\'instantanés nécessitent des privilèges d\'administration.
Assurez\-vous que SnapRAID est exécuté avec les autorisations nécessaires (par exemple, sudo)
lorsque les instantanés sont activés.
.SS Comportement des commandes avec les instantanés
Les commandes \`sync\` et \`scrub\` fonctionnent toutes deux exclusivement sur les instantanés
pour garantir que toutes les opérations sur les données sont effectuées par rapport à un état cohérent
et figé. En utilisant ces instantanés, SnapRAID empêche les écarts de parité
qui seraient autrement déclenchés par des modifications simultanées de fichiers sur le système de fichiers actif.
Pendant un \`sync\`, la commande utilise un nouvel instantané créé au
début du processus pour capturer l\'état actuel pour le calcul de la parité.
En contrepartie, la commande \`scrub\` utilise le dernier instantané, celui
créé lors du sync le plus récent, pour maintenir un point de référence fiable
qui correspond à la parité existante.
.PP
Pour les commandes \`check\` et \`fix\`, l\'utilisation du dernier instantané
dépend du ciblage ou non de disques spécifiques à l\'aide de l\'option
\-d, \-\-filter\-disk.
.PP
Un disque explicitement sélectionné via \-d (la \[dq]cible\[dq] de l\'opération)
utilise toujours le système de fichiers actif. Pour \`fix\`, cela permet de restaurer
les données sur le disque de remplacement actif. Pour \`check\`, cela permet de simuler
l\'opération \`fix\` dans les mêmes conditions.
.PP
Tous les autres disques de données (les disques de \[dq]référence\[dq]) seront accessibles via
leurs instantanés. Cela garantit que même si vous modifiez des fichiers
sur vos disques sains pendant qu\'une récupération est en cours, SnapRAID
dispose d\'une référence stable et figée pour résoudre les équations de parité.
.PP
Si aucune option \-d n\'est fournie, SnapRAID suppose que l\'opération s\'applique
à l\'ensemble de la grappe, dans ce cas, \`check\` et \`fix\` utiliseront exclusivement
les systèmes de fichiers actifs.
.PP
Toutes les autres commandes fonctionnent exclusivement sur le système de fichiers actif.
.SH CYCLE DE VIE DES INSTANTANéS
SnapRAID gère deux instantanés spécifiques, \`stable\` et \`pending\`,
dans un répertoire caché à la racine de chaque sous\-volume de données.
Dans Btrfs, Bcachefs et NTFS, le répertoire \`.snapraid/\` est utilisé,
dans ZFS, le répertoire standard \`.zfs/snapshot/\`.
.PP
L\'instantané \`stable\` représente l\'état du dernier
\`sync\` terminé avec succès, contenant les données exactes utilisées pour
calculer la parité actuelle. Il sert de source de données principale
pour les commandes \`scrub\`, \`check\` et \`fix\`.
.PP
L\'instantané \`pending\` est une image temporaire créée au début
d\'un \`sync\` pour fournir un état figé pour le calcul de la parité.
Une fois l\'opération terminée avec succès, l\'instantané \`stable\` précédent
est supprimé, et l\'instantané \`pending\` est promu pour
prendre sa place en tant que nouvelle référence stable.
.PP
Si un \`sync\` est interrompu, l\'instantané \`pending\` est préservé.
Les commandes ultérieures \`scrub\`, \`check\` et \`fix\` utiliseront cet
instantané en attente car il correspond à l\'état du système de fichiers enregistré dans
le fichier .content, même si la parité n\'est que partiellement synchronisée.
.PP
En cas d\'interruption de \`sync\`, les commandes \`check\` et \`fix\`
lisent également à partir de l\'instantané \`stable\` pour récupérer les blocs de données
des fichiers qui ont été mis à jour ou supprimés pendant le sync.
Cela est possible car le fichier .content conserve les métadonnées de
tous les fichiers modifiés ou supprimés tout au long du processus de sync.
Ces informations historiques ne sont effacées qu\'une fois qu\'un sync se termine
avec succès et que la version finale du fichier .content est enregistrée.
.PP
Si un \`sync\` est redémarré après une interruption, l\'instantané pending existant
est supprimé et un nouveau est créé pour
capturer l\'état actuel du système de fichiers actif.
.SH MOTIF (PATTERN)
Les motifs offrent un moyen flexible de filtrer les fichiers à inclure ou
à exclure. En utilisant des caractères de \[dq]globbing\[dq], vous pouvez définir des règles qui

View file

@ -51,23 +51,29 @@ Description
:https://www.snapraid.it/
Limitations
SnapRAID est un hybride entre un programme RAID et un programme de sauvegarde,
visant à combiner les meilleurs avantages des deux. Cependant, il a quelques
limitations que vous devriez considérer avant de l'utiliser.
SnapRAID est un hybride entre un RAID et un programme de sauvegarde, visant à combiner
les meilleurs avantages des deux. Cependant, il présente certaines limitations que vous devriez
prendre en compte avant de l'utiliser.
La principale limitation est que si un disque tombe en panne et que vous
n'avez pas synchronisé récemment, vous pourriez ne pas être en mesure de
récupérer complètement.
Plus précisément, vous pourriez ne pas être en mesure de récupérer jusqu'à
la taille des fichiers modifiés ou supprimés depuis la dernière opération
de synchronisation.
Cela se produit même si les fichiers modifiés ou supprimés ne se trouvent
pas sur le disque défaillant. C'est pourquoi SnapRAID est mieux adapté
aux données qui changent rarement.
La principale limitation est que si un disque tombe en panne, vous ne pouvez récupérer les données que jusqu'à
l'état du dernier processus `sync`. Toutes les données ajoutées ou modifications effectuées
depuis la dernière synchronisation situées sur le disque défectueux seront perdues.
D'un autre côté, les fichiers nouvellement ajoutés n'empêchent pas
la récupération des fichiers déjà existants. Vous ne perdrez que les
fichiers récemment ajoutés s'ils se trouvent sur le disque défaillant.
Par conséquent, SnapRAID est principalement adapté aux données qui changent rarement.
Pour les données qui existaient déjà lors de la dernière synchronisation, la fiabilité de la récupération dépend
de l'utilisation ou non de l'option `snapshot` :
* Avec la prise en charge des instantanés (disponible sur Btrfs, ZFS, Bcachefs et NTFS),
SnapRAID peut maintenir automatiquement une référence figée de vos disques de données.
Cela garantit que même si vous modifiez ou supprimez des fichiers sur votre système de fichiers actif
pendant ou après une synchronisation, le processus de récupération reste cohérent et fiable.
* Sans la prise en charge des instantanés, la suppression ou la modification de fichiers après un `sync`
peut empêcher la récupération complète d'autres disques en panne. Cela se produit
parce que la parité ne correspond plus aux fichiers modifiés, même si
ces fichiers ne se trouvent pas sur le disque défectueux. D'un autre côté, les fichiers nouvellement ajoutés
n'empêchent pas la récupération des fichiers déjà existants.
Les autres limitations de SnapRAID sont :
@ -417,11 +423,11 @@ Démarrer
Commandes
SnapRAID fournit quelques commandes simples qui vous permettent de :
* Afficher l'état de la baie de disques -> `status`
* Afficher l'état de la grappe -> `status`
* Contrôler les disques -> `smart`, `probe`, `up`, `down`
* Faire une sauvegarde/instantané -> `sync`
* Créer un point de sauvegarde/récupération -> `sync`
* Vérifier périodiquement les données -> `scrub`
* Restaurer la dernière sauvegarde/instantané -> `fix`.
* Restaurer le dernier point de sauvegarde/récupération -> `fix`.
Les commandes doivent être écrites en minuscules.
@ -639,15 +645,15 @@ Commandes
Les fichiers dans la baie NE SONT PAS modifiés.
fix
Corrige tous les fichiers et les données de parité.
Répare tous les fichiers et les données de parité.
Tous les fichiers et les données de parité sont comparés à l'état
de l'instantané enregistré lors du dernier `sync`.
Si une différence est trouvée, elle est rétablie à l'instantané stocké.
Tous les fichiers et les données de parité sont comparés à l'état sauvegardé lors
du dernier `sync`. Si une différence est trouvée, elle est restaurée à l'état enregistré.
AVERTISSEMENT ! La commande `fix` ne fait pas de distinction entre
les erreurs et les modifications intentionnelles. Elle rétablit
inconditionnellement l'état du fichier au dernier `sync`.
AVERTISSEMENT !
La commande `fix` ne fait pas de différence entre les erreurs et
les modifications intentionnelles. Elle rétablit inconditionnellement l'état des fichiers
tel qu'il était lors du dernier `sync`.
Si aucune autre option n'est spécifiée, l'intégralité de la baie est traitée.
Utilisez les options de filtre pour sélectionner un sous-ensemble de
@ -1239,6 +1245,31 @@ Configuration
Notez que ces disques ne sont pas affectés par les commandes `up` et
`down` car ils sont censés toujours être en rotation.
snapshot
Active l'utilisation des instantanés du système de fichiers pour les commandes `sync`, `scrub`,
`check` et `fix`.
Lorsqu'elle est activée, SnapRAID crée un instantané en lecture seule de vos données au
début d'un 'sync'. Cela garantit une vue cohérente et temporelle de vos
fichiers, évitant les erreurs causées par des modifications de fichiers simultanées.
Cela améliore considérablement la récupération : si un fichier est supprimé du système de fichiers actif,
il reste préservé dans l'instantané. Cela évite que la parité ne devienne "rompue"
pour ce bloc, garantissant que vous pouvez toujours récupérer les données avec succès
si un autre disque tombe en panne.
Cette option s'applique exclusivement aux disques de données formatés avec les
systèmes de fichiers Btrfs, Bcachefs ou ZFS sous Linux et NTFS sous Windows.
Les disques de parité, ou les disques de données utilisant d'autres systèmes de fichiers, utiliseront toujours
la version active du système de fichiers.
La création et la suppression d'instantanés nécessitent des privilèges d'administration.
Assurez-vous que SnapRAID est exécuté avec les autorisations nécessaires (par exemple, sudo) lorsque
cette option est activée.
Consultez la section SNAPSHOTS pour une explication détaillée du cycle de vie
des instantanés.
nohidden
Exclut tous les fichiers et répertoires cachés.
Sous Unix, les fichiers cachés sont ceux commençant par `.`.
@ -1494,6 +1525,117 @@ Configuration
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots
Si l'option snapshot est activée dans la configuration, SnapRAID
utilise la fonctionnalité d'instantané du système de fichiers pour garantir des opérations atomiques
et cohérentes.
La gestion des instantanés est entièrement automatique et transparente.
Vous pouvez continuer à utiliser SnapRAID exactement comme avant, avec la
protection supplémentaire fournie par les instantanés gérés entièrement en
arrière-plan.
Cela offre deux avantages principaux :
Cohérence - Les fichiers modifiés sur le système de fichiers actif pendant un sync ou un scrub
de longue durée ne provoqueront pas de déséquilibres de parité ni d'opérations abandonnées,
car SnapRAID voit une image figée dans le temps.
Récupération - Si un fichier est mis à jour ou supprimé du système de fichiers actif,
il reste préservé dans l'instantané. Si une panne de disque survient
avant l'exécution du prochain sync, SnapRAID utilise les données préservées
dans l'instantané pour reconstruire le disque défaillant.
En cas de panne de disque pendant un processus de sync actif,
SnapRAID est également capable de lire automatiquement à la fois l'instantané
du calcul de parité précédent et celui en cours.
Cela maximise la probabilité d'une récupération complète en
fournissant un accès aux blocs de données exacts requis pour résoudre
les équations de parité, même si ces blocs ont été modifiés
ou supprimés entre les syncs.
Sans instantanés, un fichier mis à jour ou supprimé sur un disque sain
entraîne des blocs de données manquants qui pourraient être nécessaires pour
réparer d'autres disques défaillants.
Les instantanés sont créés uniquement pour les disques de données et uniquement si le système de fichiers
sous-jacent prend en charge cette fonctionnalité. Les disques de parité utilisent toujours
le système de fichiers actif.
Actuellement, cela est pris en charge sur Btrfs, Bcachefs et ZFS sous Linux
et sur NTFS sous Windows.
Vous pouvez mélanger des disques de données avec différents systèmes de fichiers. Seuls ceux qui
prennent en charge les instantanés les utiliseront, tandis que les autres disques continueront
à fonctionner directement sur le système de fichiers actif.
La création et la suppression d'instantanés nécessitent des privilèges d'administration.
Assurez-vous que SnapRAID est exécuté avec les autorisations nécessaires (par exemple, sudo)
lorsque les instantanés sont activés.
Comportement des commandes avec les instantanés
Les commandes `sync` et `scrub` fonctionnent toutes deux exclusivement sur les instantanés
pour garantir que toutes les opérations sur les données sont effectuées par rapport à un état cohérent
et figé. En utilisant ces instantanés, SnapRAID empêche les écarts de parité
qui seraient autrement déclenchés par des modifications simultanées de fichiers sur le système de fichiers actif.
Pendant un `sync`, la commande utilise un nouvel instantané créé au
début du processus pour capturer l'état actuel pour le calcul de la parité.
En contrepartie, la commande `scrub` utilise le dernier instantané, celui
créé lors du sync le plus récent, pour maintenir un point de référence fiable
qui correspond à la parité existante.
Pour les commandes `check` et `fix`, l'utilisation du dernier instantané
dépend du ciblage ou non de disques spécifiques à l'aide de l'option
-d, --filter-disk.
Un disque explicitement sélectionné via -d (la "cible" de l'opération)
utilise toujours le système de fichiers actif. Pour `fix`, cela permet de restaurer
les données sur le disque de remplacement actif. Pour `check`, cela permet de simuler
l'opération `fix` dans les mêmes conditions.
Tous les autres disques de données (les disques de "référence") seront accessibles via
leurs instantanés. Cela garantit que même si vous modifiez des fichiers
sur vos disques sains pendant qu'une récupération est en cours, SnapRAID
dispose d'une référence stable et figée pour résoudre les équations de parité.
Si aucune option -d n'est fournie, SnapRAID suppose que l'opération s'applique
à l'ensemble de la grappe, dans ce cas, `check` et `fix` utiliseront exclusivement
les systèmes de fichiers actifs.
Toutes les autres commandes fonctionnent exclusivement sur le système de fichiers actif.
Cycle de vie des instantanés
SnapRAID gère deux instantanés spécifiques, `stable` et `pending`,
dans un répertoire caché à la racine de chaque sous-volume de données.
Dans Btrfs, Bcachefs et NTFS, le répertoire `.snapraid/` est utilisé,
dans ZFS, le répertoire standard `.zfs/snapshot/`.
L'instantané `stable` représente l'état du dernier
`sync` terminé avec succès, contenant les données exactes utilisées pour
calculer la parité actuelle. Il sert de source de données principale
pour les commandes `scrub`, `check` et `fix`.
L'instantané `pending` est une image temporaire créée au début
d'un `sync` pour fournir un état figé pour le calcul de la parité.
Une fois l'opération terminée avec succès, l'instantané `stable` précédent
est supprimé, et l'instantané `pending` est promu pour
prendre sa place en tant que nouvelle référence stable.
Si un `sync` est interrompu, l'instantané `pending` est préservé.
Les commandes ultérieures `scrub`, `check` et `fix` utiliseront cet
instantané en attente car il correspond à l'état du système de fichiers enregistré dans
le fichier .content, même si la parité n'est que partiellement synchronisée.
En cas d'interruption de `sync`, les commandes `check` et `fix`
lisent également à partir de l'instantané `stable` pour récupérer les blocs de données
des fichiers qui ont été mis à jour ou supprimés pendant le sync.
Cela est possible car le fichier .content conserve les métadonnées de
tous les fichiers modifiés ou supprimés tout au long du processus de sync.
Ces informations historiques ne sont effacées qu'une fois qu'un sync se termine
avec succès et que la version finale du fichier .content est enregistrée.
Si un `sync` est redémarré après une interruption, l'instantané pending existant
est supprimé et un nouveau est créé pour
capturer l'état actuel du système de fichiers actif.
Motif (Pattern)
Les motifs offrent un moyen flexible de filtrer les fichiers à inclure ou
à exclure. En utilisant des caractères de "globbing", vous pouvez définir des règles qui

View file

@ -61,23 +61,29 @@ Pour plus d'informations, veuillez visiter le site officiel de SnapRAID :
3 LIMITATIONS
=============
SnapRAID est un hybride entre un programme RAID et un programme de sauvegarde,
visant à combiner les meilleurs avantages des deux. Cependant, il a quelques
limitations que vous devriez considérer avant de l'utiliser.
SnapRAID est un hybride entre un RAID et un programme de sauvegarde, visant à combiner
les meilleurs avantages des deux. Cependant, il présente certaines limitations que vous devriez
prendre en compte avant de l'utiliser.
La principale limitation est que si un disque tombe en panne et que vous
n'avez pas synchronisé récemment, vous pourriez ne pas être en mesure de
récupérer complètement.
Plus précisément, vous pourriez ne pas être en mesure de récupérer jusqu'à
la taille des fichiers modifiés ou supprimés depuis la dernière opération
de synchronisation.
Cela se produit même si les fichiers modifiés ou supprimés ne se trouvent
pas sur le disque défaillant. C'est pourquoi SnapRAID est mieux adapté
aux données qui changent rarement.
La principale limitation est que si un disque tombe en panne, vous ne pouvez récupérer les données que jusqu'à
l'état du dernier processus `sync`. Toutes les données ajoutées ou modifications effectuées
depuis la dernière synchronisation situées sur le disque défectueux seront perdues.
D'un autre côté, les fichiers nouvellement ajoutés n'empêchent pas
la récupération des fichiers déjà existants. Vous ne perdrez que les
fichiers récemment ajoutés s'ils se trouvent sur le disque défaillant.
Par conséquent, SnapRAID est principalement adapté aux données qui changent rarement.
Pour les données qui existaient déjà lors de la dernière synchronisation, la fiabilité de la récupération dépend
de l'utilisation ou non de l'option `snapshot` :
* Avec la prise en charge des instantanés (disponible sur Btrfs, ZFS, Bcachefs et NTFS),
SnapRAID peut maintenir automatiquement une référence figée de vos disques de données.
Cela garantit que même si vous modifiez ou supprimez des fichiers sur votre système de fichiers actif
pendant ou après une synchronisation, le processus de récupération reste cohérent et fiable.
* Sans la prise en charge des instantanés, la suppression ou la modification de fichiers après un `sync`
peut empêcher la récupération complète d'autres disques en panne. Cela se produit
parce que la parité ne correspond plus aux fichiers modifiés, même si
ces fichiers ne se trouvent pas sur le disque défectueux. D'un autre côté, les fichiers nouvellement ajoutés
n'empêchent pas la récupération des fichiers déjà existants.
Les autres limitations de SnapRAID sont :
@ -441,11 +447,11 @@ Si tout est récupéré, cette commande est immédiate.
SnapRAID fournit quelques commandes simples qui vous permettent de :
* Afficher l'état de la baie de disques -> `status`
* Afficher l'état de la grappe -> `status`
* Contrôler les disques -> `smart`, `probe`, `up`, `down`
* Faire une sauvegarde/instantané -> `sync`
* Créer un point de sauvegarde/récupération -> `sync`
* Vérifier périodiquement les données -> `scrub`
* Restaurer la dernière sauvegarde/instantané -> `fix`.
* Restaurer le dernier point de sauvegarde/récupération -> `fix`.
Les commandes doivent être écrites en minuscules.
@ -681,15 +687,15 @@ Les fichiers dans la baie NE SONT PAS modifiés.
5.9 fix
-------
Corrige tous les fichiers et les données de parité.
Répare tous les fichiers et les données de parité.
Tous les fichiers et les données de parité sont comparés à l'état
de l'instantané enregistré lors du dernier `sync`.
Si une différence est trouvée, elle est rétablie à l'instantané stocké.
Tous les fichiers et les données de parité sont comparés à l'état sauvegardé lors
du dernier `sync`. Si une différence est trouvée, elle est restaurée à l'état enregistré.
AVERTISSEMENT ! La commande `fix` ne fait pas de distinction entre
les erreurs et les modifications intentionnelles. Elle rétablit
inconditionnellement l'état du fichier au dernier `sync`.
AVERTISSEMENT !
La commande `fix` ne fait pas de différence entre les erreurs et
les modifications intentionnelles. Elle rétablit inconditionnellement l'état des fichiers
tel qu'il était lors du dernier `sync`.
Si aucune autre option n'est spécifiée, l'intégralité de la baie est traitée.
Utilisez les options de filtre pour sélectionner un sous-ensemble de
@ -1315,14 +1321,41 @@ comme le disque de démarrage.
Notez que ces disques ne sont pas affectés par les commandes `up` et
`down` car ils sont censés toujours être en rotation.
7.7 nohidden
7.7 snapshot
------------
Active l'utilisation des instantanés du système de fichiers pour les commandes `sync`, `scrub`,
`check` et `fix`.
Lorsqu'elle est activée, SnapRAID crée un instantané en lecture seule de vos données au
début d'un 'sync'. Cela garantit une vue cohérente et temporelle de vos
fichiers, évitant les erreurs causées par des modifications de fichiers simultanées.
Cela améliore considérablement la récupération : si un fichier est supprimé du système de fichiers actif,
il reste préservé dans l'instantané. Cela évite que la parité ne devienne "rompue"
pour ce bloc, garantissant que vous pouvez toujours récupérer les données avec succès
si un autre disque tombe en panne.
Cette option s'applique exclusivement aux disques de données formatés avec les
systèmes de fichiers Btrfs, Bcachefs ou ZFS sous Linux et NTFS sous Windows.
Les disques de parité, ou les disques de données utilisant d'autres systèmes de fichiers, utiliseront toujours
la version active du système de fichiers.
La création et la suppression d'instantanés nécessitent des privilèges d'administration.
Assurez-vous que SnapRAID est exécuté avec les autorisations nécessaires (par exemple, sudo) lorsque
cette option est activée.
Consultez la section SNAPSHOTS pour une explication détaillée du cycle de vie
des instantanés.
7.8 nohidden
------------
Exclut tous les fichiers et répertoires cachés.
Sous Unix, les fichiers cachés sont ceux commençant par `.`.
Sous Windows, ce sont ceux avec l'attribut caché.
7.8 exclude/include MOTIF
7.9 exclude/include MOTIF
-------------------------
Définit les motifs de fichiers ou de répertoires à exclure ou à inclure
@ -1340,8 +1373,8 @@ spécifications de motifs.
Cette option peut être utilisée plusieurs fois.
7.9 blocksize TAILLE_EN_KIBIOCTETS
----------------------------------
7.10 blocksize TAILLE_EN_KIBIOCTETS
-----------------------------------
Définit la taille de bloc de base en kibioctets pour la parité.
Un kibioctet est de 1024 octets.
@ -1395,7 +1428,7 @@ Cela se traduit par environ 1,5 % d'espace supplémentaire, environ 60 Go
pour un disque de 4 To, ce qui permet environ 460 000 fichiers sur
chaque disque de données sans aucun espace gaspillé.
7.10 hashsize TAILLE_EN_OCTETS
7.11 hashsize TAILLE_EN_OCTETS
------------------------------
Définit la taille du hachage en octets pour les blocs enregistrés.
@ -1434,7 +1467,7 @@ bloc de 512, vous obtenez :
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 Gio
7.11 autosave TAILLE_EN_GIGAOCTETS
7.12 autosave TAILLE_EN_GIGAOCTETS
----------------------------------
Enregistre automatiquement l'état lors de la synchronisation ou du
@ -1443,7 +1476,7 @@ Cette option est utile pour éviter de redémarrer de longues commandes
`sync` à partir de zéro si elles sont interrompues par un plantage
de la machine ou tout autre événement.
7.12 temp_limit TEMPÉRATURE_CELSIUS
7.13 temp_limit TEMPÉRATURE_CELSIUS
-----------------------------------
Définit la température maximale autorisée du disque en Celsius.
@ -1479,14 +1512,14 @@ Normalement, SnapRAID n'affiche que la température du disque le plus chaud.
Pour afficher la température de tous les disques, utilisez l'option
-A ou --stats.
7.13 temp_sleep TEMPS_EN_MINUTES
7.14 temp_sleep TEMPS_EN_MINUTES
--------------------------------
Définit le temps de veille, en minutes, lorsque la limite de température
est atteinte. Pendant cette période, les disques restent arrêtés.
La valeur par défaut est de 5 minutes.
7.14 pool DOSSIER
7.15 pool DOSSIER
-----------------
Définit le répertoire de mise en commun où la vue virtuelle de la
@ -1494,7 +1527,7 @@ baie de disques est créée à l'aide de la commande `pool`.
Le répertoire doit déjà exister.
7.15 share CHEMIN_UNC
7.16 share CHEMIN_UNC
---------------------
Définit le chemin UNC Windows requis pour accéder aux disques à distance.
@ -1511,7 +1544,7 @@ et en ajoutant enfin le répertoire et le nom du fichier.
Cette option est requise uniquement pour Windows.
7.16 smartctl DISQUE/PARITÉ OPTIONS...
7.17 smartctl DISQUE/PARITÉ OPTIONS...
--------------------------------------
Définit les options smartctl personnalisées pour obtenir les attributs
@ -1538,7 +1571,7 @@ Par exemple :
smartctl parity -d sat %s
7.17 smartignore DISQUE/PARITÉ ATTR [ATTR...]
7.18 smartignore DISQUE/PARITÉ ATTR [ATTR...]
---------------------------------------------
Ignore l'attribut SMART spécifié lors du calcul de la probabilité
@ -1560,7 +1593,7 @@ Pour l'ignorer uniquement sur le premier disque de parité :
smartignore parity 197
7.18 Exemples
7.19 Exemples
-------------
Un exemple de configuration typique pour Unix est :
@ -1595,8 +1628,127 @@ Un exemple de configuration typique pour Windows est :
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 MOTIF (PATTERN)
=================
8 SNAPSHOTS
===========
Si l'option snapshot est activée dans la configuration, SnapRAID
utilise la fonctionnalité d'instantané du système de fichiers pour garantir des opérations atomiques
et cohérentes.
La gestion des instantanés est entièrement automatique et transparente.
Vous pouvez continuer à utiliser SnapRAID exactement comme avant, avec la
protection supplémentaire fournie par les instantanés gérés entièrement en
arrière-plan.
Cela offre deux avantages principaux :
Cohérence - Les fichiers modifiés sur le système de fichiers actif pendant un sync ou un scrub
de longue durée ne provoqueront pas de déséquilibres de parité ni d'opérations abandonnées,
car SnapRAID voit une image figée dans le temps.
Récupération - Si un fichier est mis à jour ou supprimé du système de fichiers actif,
il reste préservé dans l'instantané. Si une panne de disque survient
avant l'exécution du prochain sync, SnapRAID utilise les données préservées
dans l'instantané pour reconstruire le disque défaillant.
En cas de panne de disque pendant un processus de sync actif,
SnapRAID est également capable de lire automatiquement à la fois l'instantané
du calcul de parité précédent et celui en cours.
Cela maximise la probabilité d'une récupération complète en
fournissant un accès aux blocs de données exacts requis pour résoudre
les équations de parité, même si ces blocs ont été modifiés
ou supprimés entre les syncs.
Sans instantanés, un fichier mis à jour ou supprimé sur un disque sain
entraîne des blocs de données manquants qui pourraient être nécessaires pour
réparer d'autres disques défaillants.
Les instantanés sont créés uniquement pour les disques de données et uniquement si le système de fichiers
sous-jacent prend en charge cette fonctionnalité. Les disques de parité utilisent toujours
le système de fichiers actif.
Actuellement, cela est pris en charge sur Btrfs, Bcachefs et ZFS sous Linux
et sur NTFS sous Windows.
Vous pouvez mélanger des disques de données avec différents systèmes de fichiers. Seuls ceux qui
prennent en charge les instantanés les utiliseront, tandis que les autres disques continueront
à fonctionner directement sur le système de fichiers actif.
La création et la suppression d'instantanés nécessitent des privilèges d'administration.
Assurez-vous que SnapRAID est exécuté avec les autorisations nécessaires (par exemple, sudo)
lorsque les instantanés sont activés.
8.1 Comportement des commandes avec les instantanés
---------------------------------------------------
Les commandes `sync` et `scrub` fonctionnent toutes deux exclusivement sur les instantanés
pour garantir que toutes les opérations sur les données sont effectuées par rapport à un état cohérent
et figé. En utilisant ces instantanés, SnapRAID empêche les écarts de parité
qui seraient autrement déclenchés par des modifications simultanées de fichiers sur le système de fichiers actif.
Pendant un `sync`, la commande utilise un nouvel instantané créé au
début du processus pour capturer l'état actuel pour le calcul de la parité.
En contrepartie, la commande `scrub` utilise le dernier instantané, celui
créé lors du sync le plus récent, pour maintenir un point de référence fiable
qui correspond à la parité existante.
Pour les commandes `check` et `fix`, l'utilisation du dernier instantané
dépend du ciblage ou non de disques spécifiques à l'aide de l'option
-d, --filter-disk.
Un disque explicitement sélectionné via -d (la "cible" de l'opération)
utilise toujours le système de fichiers actif. Pour `fix`, cela permet de restaurer
les données sur le disque de remplacement actif. Pour `check`, cela permet de simuler
l'opération `fix` dans les mêmes conditions.
Tous les autres disques de données (les disques de "référence") seront accessibles via
leurs instantanés. Cela garantit que même si vous modifiez des fichiers
sur vos disques sains pendant qu'une récupération est en cours, SnapRAID
dispose d'une référence stable et figée pour résoudre les équations de parité.
Si aucune option -d n'est fournie, SnapRAID suppose que l'opération s'applique
à l'ensemble de la grappe, dans ce cas, `check` et `fix` utiliseront exclusivement
les systèmes de fichiers actifs.
Toutes les autres commandes fonctionnent exclusivement sur le système de fichiers actif.
9 CYCLE DE VIE DES INSTANTANéS
==============================
SnapRAID gère deux instantanés spécifiques, `stable` et `pending`,
dans un répertoire caché à la racine de chaque sous-volume de données.
Dans Btrfs, Bcachefs et NTFS, le répertoire `.snapraid/` est utilisé,
dans ZFS, le répertoire standard `.zfs/snapshot/`.
L'instantané `stable` représente l'état du dernier
`sync` terminé avec succès, contenant les données exactes utilisées pour
calculer la parité actuelle. Il sert de source de données principale
pour les commandes `scrub`, `check` et `fix`.
L'instantané `pending` est une image temporaire créée au début
d'un `sync` pour fournir un état figé pour le calcul de la parité.
Une fois l'opération terminée avec succès, l'instantané `stable` précédent
est supprimé, et l'instantané `pending` est promu pour
prendre sa place en tant que nouvelle référence stable.
Si un `sync` est interrompu, l'instantané `pending` est préservé.
Les commandes ultérieures `scrub`, `check` et `fix` utiliseront cet
instantané en attente car il correspond à l'état du système de fichiers enregistré dans
le fichier .content, même si la parité n'est que partiellement synchronisée.
En cas d'interruption de `sync`, les commandes `check` et `fix`
lisent également à partir de l'instantané `stable` pour récupérer les blocs de données
des fichiers qui ont été mis à jour ou supprimés pendant le sync.
Cela est possible car le fichier .content conserve les métadonnées de
tous les fichiers modifiés ou supprimés tout au long du processus de sync.
Ces informations historiques ne sont effacées qu'une fois qu'un sync se termine
avec succès et que la version finale du fichier .content est enregistrée.
Si un `sync` est redémarré après une interruption, l'instantané pending existant
est supprimé et un nouveau est créé pour
capturer l'état actuel du système de fichiers actif.
10 MOTIF (PATTERN)
==================
Les motifs offrent un moyen flexible de filtrer les fichiers à inclure ou
à exclure. En utilisant des caractères de "globbing", vous pouvez définir des règles qui
@ -1722,8 +1874,8 @@ ligne de commande, vous devez les mettre entre guillemets pour empêcher
le shell de les développer.
9 IGNORER DES FICHIERS (IGNORE FILES)
=====================================
11 IGNORER DES FICHIERS (IGNORE FILES)
======================================
En plus des règles globales du fichier de configuration, vous pouvez
placer des fichiers `.snapraidignore` dans n'importe quel répertoire de la grappe
@ -1767,7 +1919,7 @@ Par exemple, si vous avez un `.snapraidignore` dans `/mnt/disk1/projects/` :
*.tmp
10 CONTENU (CONTENT)
12 CONTENU (CONTENT)
====================
SnapRAID stocke la liste et les sommes de contrôle de vos fichiers
@ -1781,7 +1933,7 @@ Ce fichier est lu et écrit par les commandes `sync` et `scrub` et
lu par les commandes `fix`, `check` et `status`.
11 PARITé (PARITY)
13 PARITé (PARITY)
==================
SnapRAID stocke les informations de parité de votre baie dans
@ -1794,7 +1946,7 @@ Ces fichiers sont lus et écrits par les commandes `sync` et `fix` et
lus uniquement par les commandes `scrub` et `check`.
12 ENCODAGE
14 ENCODAGE
===========
SnapRAID sous Unix ignore tout encodage. Il lit et stocke les
@ -1813,13 +1965,13 @@ redirigez la sortie de la console vers un fichier, le fichier
résultant est toujours au format UTF-8.
13 DROITS D'AUTEUR (COPYRIGHT)
15 DROITS D'AUTEUR (COPYRIGHT)
==============================
Ce fichier est Copyright (C) 2025 Andrea Mazzoleni
14 VOIR AUSSI (SEE ALSO)
16 VOIR AUSSI (SEE ALSO)
========================
snapraid_log(1), snapraidd(1)

View file

@ -118,22 +118,33 @@ https://www.snapraid.it/
.PD
.RE
.SH LIMITAZIONI
SnapRAID è un ibrido tra un programma RAID e un programma di backup,
che mira a combinare i migliori vantaggi di entrambi. Tuttavia, ha
alcune limitazioni che si dovrebbero considerare prima di usarlo.
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.
.PP
La limitazione principale è che se un disco si guasta e non si è
effettuato un sync di recente, potrebbe non essere possibile recuperare
completamente.
Più specificamente, potrebbe non essere possibile recuperare fino alla
dimensione dei file modificati o eliminati dall\'ultima operazione di sync.
Ciò accade anche se i file modificati o eliminati non si trovano sul
disco guasto. Questo è il motivo per cui SnapRAID è più adatto per dati
che cambiano raramente.
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
dall\'ultimo sync che si trova sul disco guasto andrà perso.
.PP
D\'altra parte, i file appena aggiunti non impediscono il recupero dei
file già esistenti. Si perderanno solo i file aggiunti di recente se si
trovano sul disco guasto.
Di conseguenza, SnapRAID è adatto principalmente per dati che cambiano raramente.
.PP
Per i dati che esistevano già all\'ultimo sync, l\'affidabilità del recupero dipende
dall\'uso o meno dell\'opzione \`snapshot\`:
.PD 0
.IP \(bu
Con il supporto snapshot (disponibile su Btrfs, ZFS, Bcachefs e NTFS),
SnapRAID può mantenere automaticamente un riferimento congelato dei dischi dati.
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.
.PD
.PD 0
.IP \(bu
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.
.PD
.PP
Altre limitazioni di SnapRAID sono:
.PD 0
@ -668,14 +679,14 @@ Stampare lo stato dell\'array \-> \`status\`
.IP \(bu
Controllare i dischi \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
Effettuare un backup/snapshot \-> \`sync\`
Creare un punto di backup/recupero \-> \`sync\`
.IP \(bu
Controllare periodicamente i dati \-> \`scrub\`
.IP \(bu
Ripristinare l\'ultimo backup/snapshot \-> \`fix\`.
Ripristinare l\'ultimo punto di backup/recupero \-> \`fix\`.
.PD
.PP
I comandi devono essere scritti in minuscolo.
I comandi devono essere scritti in lettere minuscole.
.SS status
Stampa un riepilogo dello stato dell\'array di dischi.
.PP
@ -930,16 +941,14 @@ controllo per ogni blocco e per contrassegnare i blocchi bad.
I file \`parity\` NON vengono modificati.
I file nell\'array NON vengono modificati.
.SS fix
Corregge tutti i file e i dati di parità.
Ripristina tutti i file e i dati di parità.
.PP
Tutti i file e i dati di parità vengono confrontati con lo stato
snapshot salvato nell\'ultimo \`sync\`.
Se viene trovata una differenza, viene ripristinata allo snapshot
memorizzato.
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.
.PP
ATTENZIONE! Il comando \`fix\` non differenzia tra errori e modifiche
intenzionali. Ripristina incondizionatamente lo stato del file
all\'ultimo \`sync\`.
ATTENZIONE!
Il comando \`fix\` non distingue tra errori e modifiche intenzionali.
Ripristina incondizionatamente lo stato del file all\'ultimo \`sync\`.
.PP
Se non viene specificata nessun\'altra opzione, l\'intero array viene
elaborato. Utilizzare le opzioni di filtro per selezionare un
@ -1508,6 +1517,30 @@ il disco di avvio.
.PP
Si noti che tali dischi non sono influenzati dai comandi \`up\` e \`down\`
perché si prevede che siano sempre in rotazione.
.SS snapshot
Abilita l\'uso degli snapshot del file system per i comandi \`sync\`, \`scrub\`,
\`check\` e \`fix\`.
.PP
Quando abilitato, SnapRAID crea uno snapshot in sola lettura dei dati all\'inizio
di un \'sync\'. Ciò garantisce una vista coerente e puntuale dei tuoi file,
prevenendo errori causati da modifiche simultanee dei file.
.PP
Questo migliora significativamente il recupero: se un file viene eliminato dal file system live,
rimane preservato nello snapshot. Ciò impedisce alla parità di diventare \[dq]corrotta\[dq]
per quel blocco, assicurando che sia ancora possibile recuperare correttamente i dati
se un altro disco si guasta.
.PP
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.
.PP
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.
.PP
Vedere la sezione SNAPSHOTS per una spiegazione dettagliata del ciclo di vita
degli snapshot.
.SS nohidden
Esclude tutti i file e le directory nascosti.
In Unix, i file nascosti sono quelli che iniziano con \`.\`.
@ -1859,6 +1892,127 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS
Se l\'opzione snapshot è abilitata nella configurazione, SnapRAID
utilizza le funzionalità di snapshot del file system per garantire operazioni atomiche
e coerenti.
.PP
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.
.PP
Ciò fornisce due vantaggi primari:
.RS 0
.PD 0
.HP 4
.I 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,
poiché SnapRAID vede un\'immagine congelata nel tempo.
.HP 4
.I 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.
.PD
.PP
.RS 4
.PD 0
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.
.PD
.PP
.PD 0
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.
.PD
.RE
.RE
.PP
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.
.PP
È 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.
.PP
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.
.SS Comportamento dei comandi con gli snapshot
I comandi \`sync\` e \`scrub\` operano entrambi esclusivamente sugli snapshot
per garantire che tutte le operazioni sui dati siano eseguite rispetto a uno stato coerente
e congelato. Utilizzando questi snapshot, SnapRAID previene le discrepanze di parità
che verrebbero altrimenti innescate da modifiche simultanee dei file sul file system live.
Durante un \`sync\`, il comando utilizza un nuovo snapshot creato all\'inizio
del processo per catturare lo stato corrente 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.
.PP
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.
.PP
Un disco esplicitamente selezionato tramite \-d (il \[dq]target\[dq] 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.
.PP
Tutti gli altri dischi dati (i dischi di \[dq]riferimento\[dq]) verranno cercati 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à.
.PP
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.
.PP
Tutti gli altri comandi operano esclusivamente sul file system live.
.SH CICLO DI VITA DEGLI SNAPSHOT
SnapRAID gestisce due snapshot specifici, \`stable\` e \`pending\`,
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/\`.
.PP
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\`.
.PP
Lo snapshot \`pending\` è un\'immagine temporanea creata all\'inizio
di un \`sync\` per fornire uno stato congelato per il calcolo della parità.
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.
.PP
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.
.PP
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.
.PP
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.
.SH PATTERN
I pattern offrono un modo flessibile per filtrare i file da includere o
escludere. Usando i caratteri globbing, è possibile definire regole che

View file

@ -52,22 +52,29 @@ Descrizione
:https://www.snapraid.it/
Limitazioni
SnapRAID è un ibrido tra un programma RAID e un programma di backup,
che mira a combinare i migliori vantaggi di entrambi. Tuttavia, ha
alcune limitazioni che si dovrebbero considerare prima di usarlo.
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 e non si è
effettuato un sync di recente, potrebbe non essere possibile recuperare
completamente.
Più specificamente, potrebbe non essere possibile recuperare fino alla
dimensione dei file modificati o eliminati dall'ultima operazione di sync.
Ciò accade anche se i file modificati o eliminati non si trovano sul
disco guasto. Questo è il motivo per cui SnapRAID è più adatto per dati
che cambiano raramente.
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
dall'ultimo sync che si trova sul disco guasto andrà perso.
D'altra parte, i file appena aggiunti non impediscono il recupero dei
file già esistenti. Si perderanno solo i file aggiunti di recente se si
trovano sul disco guasto.
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 dei dischi dati.
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:
@ -405,11 +412,11 @@ Comandi
* Stampare lo stato dell'array -> `status`
* Controllare i dischi -> `smart`, `probe`, `up`, `down`
* Effettuare un backup/snapshot -> `sync`
* Creare un punto di backup/recupero -> `sync`
* Controllare periodicamente i dati -> `scrub`
* Ripristinare l'ultimo backup/snapshot -> `fix`.
* Ripristinare l'ultimo punto di backup/recupero -> `fix`.
I comandi devono essere scritti in minuscolo.
I comandi devono essere scritti in lettere minuscole.
status
Stampa un riepilogo dello stato dell'array di dischi.
@ -628,16 +635,14 @@ Comandi
I file nell'array NON vengono modificati.
fix
Corregge tutti i file e i dati di parità.
Ripristina tutti i file e i dati di parità.
Tutti i file e i dati di parità vengono confrontati con lo stato
snapshot salvato nell'ultimo `sync`.
Se viene trovata una differenza, viene ripristinata allo snapshot
memorizzato.
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 differenzia tra errori e modifiche
intenzionali. Ripristina incondizionatamente lo stato del file
all'ultimo `sync`.
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
@ -1217,6 +1222,31 @@ Configurazione
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 dei dati all'inizio
di un 'sync'. Ciò garantisce una vista coerente e puntuale dei tuoi file,
prevenendo errori causati da modifiche simultanee dei file.
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 `.`.
@ -1472,6 +1502,117 @@ Configurazione
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots
Se l'opzione snapshot è abilitata nella configurazione, SnapRAID
utilizza le funzionalità di snapshot del file system per garantire operazioni atomiche
e coerenti.
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,
poiché SnapRAID vede un'immagine congelata nel tempo.
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.
Comportamento dei comandi con gli snapshot
I comandi `sync` e `scrub` operano entrambi esclusivamente sugli snapshot
per garantire che tutte le operazioni sui dati siano eseguite rispetto a uno stato coerente
e congelato. Utilizzando questi snapshot, SnapRAID previene le discrepanze di parità
che verrebbero altrimenti innescate da modifiche simultanee dei file sul file system live.
Durante un `sync`, il comando utilizza un nuovo snapshot creato all'inizio
del processo per catturare lo stato corrente 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 cercati 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
SnapRAID gestisce due snapshot specifici, `stable` e `pending`,
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 `pending` è un'immagine temporanea creata all'inizio
di un `sync` per fornire uno stato congelato per il calcolo della parità.
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.
Pattern
I pattern offrono un modo flessibile per filtrare i file da includere o
escludere. Usando i caratteri globbing, è possibile definire regole che

View file

@ -62,22 +62,29 @@ Per maggiori informazioni, si prega di visitare il sito ufficiale SnapRAID:
3 LIMITAZIONI
=============
SnapRAID è un ibrido tra un programma RAID e un programma di backup,
che mira a combinare i migliori vantaggi di entrambi. Tuttavia, ha
alcune limitazioni che si dovrebbero considerare prima di usarlo.
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 e non si è
effettuato un sync di recente, potrebbe non essere possibile recuperare
completamente.
Più specificamente, potrebbe non essere possibile recuperare fino alla
dimensione dei file modificati o eliminati dall'ultima operazione di sync.
Ciò accade anche se i file modificati o eliminati non si trovano sul
disco guasto. Questo è il motivo per cui SnapRAID è più adatto per dati
che cambiano raramente.
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
dall'ultimo sync che si trova sul disco guasto andrà perso.
D'altra parte, i file appena aggiunti non impediscono il recupero dei
file già esistenti. Si perderanno solo i file aggiunti di recente se si
trovano sul disco guasto.
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 dei dischi dati.
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:
@ -429,11 +436,11 @@ SnapRAID fornisce alcuni semplici comandi che consentono di:
* Stampare lo stato dell'array -> `status`
* Controllare i dischi -> `smart`, `probe`, `up`, `down`
* Effettuare un backup/snapshot -> `sync`
* Creare un punto di backup/recupero -> `sync`
* Controllare periodicamente i dati -> `scrub`
* Ripristinare l'ultimo backup/snapshot -> `fix`.
* Ripristinare l'ultimo punto di backup/recupero -> `fix`.
I comandi devono essere scritti in minuscolo.
I comandi devono essere scritti in lettere minuscole.
5.1 status
----------
@ -670,16 +677,14 @@ I file nell'array NON vengono modificati.
5.9 fix
-------
Corregge tutti i file e i dati di parità.
Ripristina tutti i file e i dati di parità.
Tutti i file e i dati di parità vengono confrontati con lo stato
snapshot salvato nell'ultimo `sync`.
Se viene trovata una differenza, viene ripristinata allo snapshot
memorizzato.
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 differenzia tra errori e modifiche
intenzionali. Ripristina incondizionatamente lo stato del file
all'ultimo `sync`.
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
@ -1293,14 +1298,41 @@ 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 nohidden
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 dei dati all'inizio
di un 'sync'. Ciò garantisce una vista coerente e puntuale dei tuoi file,
prevenendo errori causati da modifiche simultanee dei file.
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.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
Definisce i modelli di file o directory da escludere o includere
@ -1318,8 +1350,8 @@ del modello.
Questa opzione può essere utilizzata più volte.
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
Definisce la dimensione di blocco di base in kibibyte per la parità.
Un kibibyte è 1024 byte.
@ -1372,7 +1404,7 @@ 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.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
Definisce la dimensione dell'hash in byte per i blocchi salvati.
@ -1411,7 +1443,7 @@ blocco di 512, si ottiene:
RAM = $(8 * 4 * 10^{12}) * (1+8) / (512 * 2^{10}) = 0.51 \text{ GiB}$
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
Salva automaticamente lo stato durante la sincronizzazione o lo scrubbing
@ -1420,7 +1452,7 @@ 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.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
Imposta la temperatura massima del disco consentita in Celsius. Se
@ -1456,14 +1488,14 @@ 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.13 temp_sleep TIME_IN_MINUTES
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.14 pool DIR
7.15 pool DIR
-------------
Definisce la directory di pooling in cui viene creata la vista virtuale
@ -1471,7 +1503,7 @@ dell'array di dischi utilizzando il comando `pool`.
La directory deve già esistere.
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
Definisce il percorso UNC di Windows necessario per accedere ai dischi
@ -1489,7 +1521,7 @@ specificato, aggiungendo il nome del disco come specificato nell'opzione
Questa opzione è richiesta solo per Windows.
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
Definisce opzioni smartctl personalizzate per ottenere gli attributi
@ -1516,7 +1548,7 @@ Ad esempio:
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
Ignora l'attributo SMART specificato durante il calcolo della
@ -1538,7 +1570,7 @@ Per ignorarlo solo sul primo disco di parità:
smartignore parity 197
7.18 Esempi
7.19 Esempi
-----------
Un esempio di configurazione tipica per Unix è:
@ -1573,8 +1605,127 @@ Un esempio di configurazione tipica per Windows è:
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 PATTERN
=========
8 SNAPSHOTS
===========
Se l'opzione snapshot è abilitata nella configurazione, SnapRAID
utilizza le funzionalità di snapshot del file system per garantire operazioni atomiche
e coerenti.
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,
poiché SnapRAID vede un'immagine congelata nel tempo.
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
----------------------------------------------
I comandi `sync` e `scrub` operano entrambi esclusivamente sugli snapshot
per garantire che tutte le operazioni sui dati siano eseguite rispetto a uno stato coerente
e congelato. Utilizzando questi snapshot, SnapRAID previene le discrepanze di parità
che verrebbero altrimenti innescate da modifiche simultanee dei file sul file system live.
Durante un `sync`, il comando utilizza un nuovo snapshot creato all'inizio
del processo per catturare lo stato corrente 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 cercati 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
==============================
SnapRAID gestisce due snapshot specifici, `stable` e `pending`,
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 `pending` è un'immagine temporanea creata all'inizio
di un `sync` per fornire uno stato congelato per il calcolo della parità.
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.
10 PATTERN
==========
I pattern offrono un modo flessibile per filtrare i file da includere o
escludere. Usando i caratteri globbing, è possibile definire regole che
@ -1698,8 +1849,8 @@ In Unix, quando si utilizzano caratteri di globbing sulla riga di
comando, è necessario citarli per impedire alla shell di espanderli.
9 IGNORE FILE
=============
11 IGNORE FILE
==============
In aggiunta alle regole globali nel file di configurazione, è possibile
inserire file `.snapraidignore` in qualsiasi directory all'interno dell'array
@ -1743,7 +1894,7 @@ Ad esempio, se hai un `.snapraidignore` in `/mnt/disk1/projects/`:
*.tmp
10 CONTENT
12 CONTENT
==========
SnapRAID memorizza l'elenco e i checksum dei file nel file di contenuto.
@ -1755,7 +1906,7 @@ Questo file viene letto e scritto dai comandi `sync` e `scrub` e
letto dai comandi `fix`, `check` e `status`.
11 PARITY
13 PARITY
=========
SnapRAID memorizza le informazioni di parità dell'array nei file di
@ -1768,7 +1919,7 @@ Questi file vengono letti e scritti dai comandi `sync` e `fix` e
solo letti dai comandi `scrub` e `check`.
12 CODIFICA
14 CODIFICA
===========
SnapRAID in Unix ignora qualsiasi codifica. Legge e memorizza i
@ -1786,13 +1937,13 @@ reindirizza l'output della console a un file, il file risultante è
sempre in formato UTF-8.
13 COPYRIGHT
15 COPYRIGHT
============
Questo file è Copyright (C) 2025 Andrea Mazzoleni
14 VEDI ANCHE
16 VEDI ANCHE
=============
snapraid_log(1), snapraidd(1)

View file

@ -113,19 +113,33 @@ https://www.snapraid.it/
.PD 0
.PD
.RE
.SH LIMITATIONS
.SH 制限事項
SnapRAIDはRAIDとバックアッププログラムのハイブリッドであり、両方の利点を組み合わせることを
目指しています。ただし、使用する前に考慮すべきいくつかの制限があります。
目指しています。ただし、使用する前に考慮すべきいくつかの制限事項があります。
.PP
主な制限は、ディスクが故障し、最近 \`sync\` を実行していない場合、完全に復旧できない
可能性があることです。
より具体的には、最後の \`sync\` 操作以降に変更または削除されたファイルのサイズまでのデータが
復旧できない可能性があります。
これは、変更または削除されたファイルが故障したディスク上にない場合でも発生します。
このため、SnapRAIDは**めったに変更されない**データに適しています。
主な制限事項は、ディスクが故障した場合、最後の \`sync\`(同期)処理の状態までしか
データを復元できないことです。最後の同期以降に追加されたデータや、故障したディスク上で行われた
変更はすべて失われます。
.PP
一方で、新しく追加されたファイルは、既に存在するファイルの復旧を妨げません。
新しく追加されたファイルが故障したディスク上にある場合にのみ、それらのファイルが失われます。
そのため、SnapRAIDは主にデータの変更がほとんどない環境に適しています。
.PP
最後の同期時にすでに存在していたデータについて、復元の信頼性は \`snapshot\`(スナップショット)
オプションが使用されているかどうかによって異なります。
.PD 0
.IP \(bu
スナップショットサポートがある場合(Btrfs、ZFS、Bcachefs、およびNTFSで利用可能):
SnapRAIDはデータディスクの凍結されたリファレンスを自動的に維持できます。
これにより、同期中または同期後にライブファイルシステム上のファイルを変更または削除した場合でも、
復元プロセスの整合性と信頼性が保たれます。
.PD
.PD 0
.IP \(bu
スナップショットサポートがない場合:
\`sync\` 後にファイルを削除または変更すると、他の故障したディスクの完全な復元が妨げられる
可能性があります。これは、変更されたファイルが故障したディスク上にない場合でも、
パリティが変更後のファイルと一致しなくなるために発生します。一方で、新しく追加されたファイルが
すでに存在するファイルの復元を妨げることはありません。
.PD
.PP
その他のSnapRAIDの制限は次のとおりです。
.PD 0
@ -623,22 +637,22 @@ snapraid sync
.RE
.PP
すべてが復旧されていれば、このコマンドは即座に完了します。
.SH COMMANDS
SnapRAIDは、次のことを可能にするいくつかの簡単なコマンドを提供します。
.SH コマンド
SnapRAIDは、以下の操作を行ういくつかのシンプルなコマンドを提供します。
.PD 0
.IP \(bu
アレイの状態の概要を出力 \-> \`status\`
アレイの状態を表示する \-> \`status\`
.IP \(bu
ディスクの制御 \-> \`smart\`、\`probe\`、\`up\`、\`down\`
ディスクを制御する \-> \`smart\`、\`probe\`、\`up\`、\`down\`
.IP \(bu
バックアップ/スナップショットの作成 \-> \`sync\`
バックアップ/復元ポイントを作成する \-> \`sync\`
.IP \(bu
データの定期的なチェック \-> \`scrub\`
データを定期的にチェックする \-> \`scrub\`
.IP \(bu
最後のバックアップ/スナップショットの復元 \-> \`fix\`。
最後のバックアップ/復元ポイントを復元する \-> \`fix\`
.PD
.PP
コマンドは**小文字**で記述する必要があります。
コマンドは小文字で入力する必要があります。
.SS status
ディスクアレイの状態の概要を出力します。
.PP
@ -858,14 +872,14 @@ full \- すべてをスクラブします。
\`parity\` ファイルは**変更されません**。
アレイ内のファイルは**変更されません**。
.SS fix
すべてのファイルとパリティデータを修正します。
すべてのファイルとパリティデータを修復(復元)します。
.PP
すべてのファイルとパリティデータは、最後の \`sync\` で保存されたスナップショット状態と
比較されます。
違いが見つかった場合、保存されたスナップショットに**元に戻されます**。
すべてのファイルとパリティデータが、最後の \`sync\` で保存された状態と比較されます。
差異が見つかった場合、保存されていた状態に巻き戻されます。
.PP
**警告!** \`fix\` コマンドは、エラーと意図的な変更を区別しません。
ファイルの_状態を_最後の \`sync\` に**無条件に元に戻します**。
警告!
\`fix\` コマンドは、エラーと意図的な変更を区別しません。
ファイルの変更状態を無条件で最後の \`sync\` の状態に戻します。
.PP
他のオプションが指定されていない場合、アレイ全体が処理されます。
フィルタオプションを使用して、操作するファイルまたはディスクのサブセットを
@ -1348,6 +1362,27 @@ NAME を固定したままにしておけば、必要に応じてマウントポ
.PP
これらのディスクは常に回転していることが期待されるため、\`up\` およ
び \`down\` コマンドの影響を受けないことに注意してください。
.SS snapshot
\`sync\`、\`scrub\`、\`check\`、および \`fix\` コマンドでファイルシステムスナップショットの
使用を有効にします。
.PP
有効にすると、SnapRAIDは \`sync\` の開始時にデータの読み取り専用スナップショットを作成します。
これにより、ファイルの整合性を保った特定の時点のビューが確保され、ファイルの同時変更によって
発生するエラーを防ぎます。
.PP
これにより復元が大幅に向上します。ライブファイルシステムからファイルが削除されても、
スナップショット内に保存され続けます。これにより、そのブロックのパリティが「破損」するのを防ぎ、
別のディスクが故障した場合でもデータを正常に復元できるようになります。
.PP
このオプションは、LinuxのBtrfs、Bcachefs、ZFS、およびWindowsのNTFSでフォーマットされた
データディスクにのみ適用されます。
パリティディスク、または他のファイルシステムを使用しているデータディスクは、常にファイルシステムの
ライブバージョンを使用します。
.PP
スナップショットの作成と削除には管理者権限が必要です。
このオプションが有効な場合は、SnapRAIDが必要な権限(例:sudo)で実行されていることを確認してください。
.PP
スナップショットのライフサイクルの詳細な説明については、SNAPSHOTSのセクションを参照してください。
.SS nohidden
すべての隠しファイルとディレクトリを除外します。
Unixでは、隠しファイルは \`.\` で始まるファイルです。
@ -1663,6 +1698,103 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS(スナップショット)
設定でスナップショットオプションが有効になっている場合、SnapRAIDは
ファイルシステムのスナップショット機能を利用して、アトミックで一貫性のある操作を保証します。
.PP
スナップショットの管理は完全に自動かつ透過的です。
バックグラウンドで完全に処理されるスナップショットによる追加の保護を受けながら、
これまでとまったく同じようにSnapRAIDを使用し続けることができます。
.PP
これには主に2つのメリットがあります。
.RS 0
.PD 0
.HP 4
.I 整合性
長時間かかるsyncやscrubの実行中にライブファイルシステム上でファイルが変更されても、
SnapRAIDは凍結された時点のイメージを参照するため、パリティの不一致や処理の中断は発生しません。
.HP 4
.I 復元
ライブファイルシステムからファイルが更新または削除されても、スナップショット内に保存され続けます。
次のsyncが実行される前にディスク故障が発生した場合、SnapRAIDはスナップショットに保存されている
データを使用して、故障したディスクを再構築します。
.PD
.PP
.RS 4
.PD 0
アクティブなsync処理中にディスクが故障した場合、SnapRAIDは前のパリティ計算の
スナップショットと現在のスナップショットの両方から自動的に読み取ることも可能です。
これにより、同期の間にブロックが変更または削除されていた場合でも、パリティ方程式を解くために
必要な正確なデータブロックへのアクセスが提供され、完全な復元の可能性が最大化されます。
.PD
.PP
.PD 0
スナップショットがない場合、正常なディスク上の更新または削除されたファイルはデータブロックの欠損を
招き、他の故障したディスクを修復するために必要となるブロックが失われる可能性があります。
.PD
.RE
.RE
.PP
スナップショットはデータディスクに対してのみ、かつ基礎となるファイルシステムがその機能をサポートして
いる場合にのみ作成されます。パリティディスクは常にライブファイルシステムを使用します。
現在、これはLinuxのBtrfs、Bcachefs、ZFS、およびWindowsのNTFSでサポートされています。
.PP
異なるファイルシステムを持つデータディスクを混在させることができます。スナップショットをサポートして
いるディスクのみがそれを利用し、他のディスクはライブファイルシステム上で直接動作し続けます。
.PP
スナップショットの作成と削除には管理者権限が必要です。
スナップショットが有効な場合は、SnapRAIDが必要な権限(例:sudo)で実行されていることを確認してください。
.SS スナップショット使用時のコマンドの挙動
\`sync\` と \`scrub\` コマンドは、すべてのデータ操作が一貫した凍結状態に対して行われることを
保証するために、いずれもスナップショット上でのみ動作します。これらのスナップショットを利用することで、
SnapRAIDはライブファイルシステム上での同時ファイル変更によってトリガーされるパリティの不一致を防ぎます。
\`sync\` の実行中、コマンドはプロセスの開始時に作成された新しいスナップショットを使用して、パリティ計算の
ための現在の状態をキャプチャします。
対照的に、\`scrub\` コマンドは、既存のパリティと一致する信頼できる参照ポイントを維持するために、
最も直近の同期中に作成された最後のスナップショットを利用します。
.PP
\`check\` および \`fix\` コマンドの場合、最後のスナップショットの使用は、
\-d, \-\-filter\-disk オプションを使用して特定のディスクがターゲットに指定されているかどうかによって異なります。
.TP
.B \-d を介して明示的に選択されたディスク(操作の「ターゲット」)は、常にライブファイルシステムを使用します。
\`fix\` の場合、これによりアクティブな交換ディスクにデータを復元できます。
\`check\` の場合、同じ条件下で \`fix\` 操作をシミュレートできます。
.PP
他のすべてのデータディスク(「参照」ディスク)は、それぞれのスナップショットを介してアクセスされます。
これにより、復旧の進行中に正常なディスク上のファイルを変更している場合でも、SnapRAIDは
パリティ方程式を解くための安定した凍結された参照を持つことができます。
.TP
.B \-d オプションが指定されていない場合、SnapRAIDは操作がアレイ全体に適用されると想定します。
この場合、\`check\` と \`fix\` はライブファイルシステムのみを排他的に使用します。
.PP
他のすべてのコマンドは、ライブファイルシステム上でのみ動作します。
.SH スナップショットのライフサイクル
SnapRAIDは、各データサブボリュームのルートにある隠しディレクトリ内で、
\`stable\`(安定)と \`pending\`(保留)という2つの特定のスナップショットを管理します。
Btrfs、Bcachefs、およびNTFSでは \`.snapraid/\` ディレクトリが使用され、
ZFSでは標準の \`.zfs/snapshot/\` が使用されます。
.PP
\`stable\` スナップショットは、最後に正常に完了した \`sync\` の状態を表し、
現在のパリティの計算に使用された正確なデータを含んでいます。これは、
\`scrub\`、\`check\`、および \`fix\` コマンドの主要なデータソースとして機能します。
.PP
\`pending\` スナップショットは、パリティ計算のための凍結された状態を提供するために、
\`sync\` の開始時に作成される一時的なイメージです。
操作が正常に完了すると、以前の \`stable\` スナップショットが削除され、
\`pending\` スナップショットが新しい安定した参照として昇格します。
.PP
\`sync\` が中断された場合、\`pending\` スナップショットは保持されます。
パリティが部分的にしか同期されていない場合でも、.content ファイルに記録されたファイルシステム状態と
一致するため、その後の \`scrub\`、\`check\`、および \`fix\` コマンドはこの保留中のスナップショットを使用します。
.PP
\`sync\` が中断された場合、\`check\` および \`fix\` コマンドは \`stable\` スナップショットからも
読み取りを行い、同期中に更新または削除されたファイルからデータブロックを取得します。
これは、.content ファイルが同期プロセス全体を通じて、変更または削除されたすべてのファイルの
メタデータを保持しているために可能です。
この履歴情報は、syncが正常に終了し、.content ファイルの最終バージョンが保存されたときにのみクリアされます。
.PP
中断後に \`sync\` が再開されると、既存の保留中(pending)のスナップショットは削除され、
ライブファイルシステムの現在の状態をキャプチャするために新しいスナップショットが作成されます。
.SH PATTERN
パターンは、含めるファイルまたは除外するファイルをフィルタリングするための柔軟な方法を
提供します。グロブ文字を使用することで、すべてのパスを手動でリストすることなく、

View file

@ -47,19 +47,29 @@ Description
:https://www.snapraid.it/
Limitations
制限事項
SnapRAIDはRAIDとバックアッププログラムのハイブリッドであり、両方の利点を組み合わせることを
目指しています。ただし、使用する前に考慮すべきいくつかの制限があります。
目指しています。ただし、使用する前に考慮すべきいくつかの制限事項があります。
主な制限は、ディスクが故障し、最近 `sync` を実行していない場合、完全に復旧できない
可能性があることです。
より具体的には、最後の `sync` 操作以降に変更または削除されたファイルのサイズまでのデータが
復旧できない可能性があります。
これは、変更または削除されたファイルが故障したディスク上にない場合でも発生します。
このため、SnapRAIDは**めったに変更されない**データに適しています。
主な制限事項は、ディスクが故障した場合、最後の `sync`(同期)処理の状態までしか
データを復元できないことです。最後の同期以降に追加されたデータや、故障したディスク上で行われた
変更はすべて失われます。
一方で、新しく追加されたファイルは、既に存在するファイルの復旧を妨げません。
新しく追加されたファイルが故障したディスク上にある場合にのみ、それらのファイルが失われます。
そのため、SnapRAIDは主にデータの変更がほとんどない環境に適しています。
最後の同期時にすでに存在していたデータについて、復元の信頼性は `snapshot`(スナップショット)
オプションが使用されているかどうかによって異なります。
* スナップショットサポートがある場合(Btrfs、ZFS、Bcachefs、およびNTFSで利用可能):
SnapRAIDはデータディスクの凍結されたリファレンスを自動的に維持できます。
これにより、同期中または同期後にライブファイルシステム上のファイルを変更または削除した場合でも、
復元プロセスの整合性と信頼性が保たれます。
* スナップショットサポートがない場合:
`sync` 後にファイルを削除または変更すると、他の故障したディスクの完全な復元が妨げられる
可能性があります。これは、変更されたファイルが故障したディスク上にない場合でも、
パリティが変更後のファイルと一致しなくなるために発生します。一方で、新しく追加されたファイルが
すでに存在するファイルの復元を妨げることはありません。
その他のSnapRAIDの制限は次のとおりです。
@ -363,16 +373,16 @@ Getting Started
すべてが復旧されていれば、このコマンドは即座に完了します。
Commands
SnapRAIDは、次のことを可能にするいくつかの簡単なコマンドを提供します。
コマンド
SnapRAIDは、以下の操作を行ういくつかのシンプルなコマンドを提供します。
* アレイの状態の概要を出力 -> `status`
* ディスクの制御 -> `smart`、`probe`、`up`、`down`
* バックアップ/スナップショットの作成 -> `sync`
* データの定期的なチェック -> `scrub`
* 最後のバックアップ/スナップショットの復元 -> `fix`。
* アレイの状態を表示する -> `status`
* ディスクを制御する -> `smart`、`probe`、`up`、`down`
* バックアップ/復元ポイントを作成する -> `sync`
* データを定期的にチェックする -> `scrub`
* 最後のバックアップ/復元ポイントを復元する -> `fix`
コマンドは**小文字**で記述する必要があります。
コマンドは小文字で入力する必要があります。
status
ディスクアレイの状態の概要を出力します。
@ -567,14 +577,14 @@ Commands
アレイ内のファイルは**変更されません**。
fix
すべてのファイルとパリティデータを修正します。
すべてのファイルとパリティデータを修復(復元)します。
すべてのファイルとパリティデータは、最後の `sync` で保存されたスナップショット状態と
比較されます。
違いが見つかった場合、保存されたスナップショットに**元に戻されます**。
すべてのファイルとパリティデータが、最後の `sync` で保存された状態と比較されます。
差異が見つかった場合、保存されていた状態に巻き戻されます。
**警告!** `fix` コマンドは、エラーと意図的な変更を区別しません。
ファイルの_状態を_最後の `sync` に**無条件に元に戻します**。
警告!
`fix` コマンドは、エラーと意図的な変更を区別しません。
ファイルの変更状態を無条件で最後の `sync` の状態に戻します。
他のオプションが指定されていない場合、アレイ全体が処理されます。
フィルタオプションを使用して、操作するファイルまたはディスクのサブセットを
@ -1068,6 +1078,28 @@ Configuration
これらのディスクは常に回転していることが期待されるため、`up` およ
び `down` コマンドの影響を受けないことに注意してください。
snapshot
`sync`、`scrub`、`check`、および `fix` コマンドでファイルシステムスナップショットの
使用を有効にします。
有効にすると、SnapRAIDは `sync` の開始時にデータの読み取り専用スナップショットを作成します。
これにより、ファイルの整合性を保った特定の時点のビューが確保され、ファイルの同時変更によって
発生するエラーを防ぎます。
これにより復元が大幅に向上します。ライブファイルシステムからファイルが削除されても、
スナップショット内に保存され続けます。これにより、そのブロックのパリティが「破損」するのを防ぎ、
別のディスクが故障した場合でもデータを正常に復元できるようになります。
このオプションは、LinuxのBtrfs、Bcachefs、ZFS、およびWindowsのNTFSでフォーマットされた
データディスクにのみ適用されます。
パリティディスク、または他のファイルシステムを使用しているデータディスクは、常にファイルシステムの
ライブバージョンを使用します。
スナップショットの作成と削除には管理者権限が必要です。
このオプションが有効な場合は、SnapRAIDが必要な権限(例:sudo)で実行されていることを確認してください。
スナップショットのライフサイクルの詳細な説明については、SNAPSHOTSのセクションを参照してください。
nohidden
すべての隠しファイルとディレクトリを除外します。
Unixでは、隠しファイルは `.` で始まるファイルです。
@ -1287,6 +1319,93 @@ Configuration
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots(スナップショット)
設定でスナップショットオプションが有効になっている場合、SnapRAIDは
ファイルシステムのスナップショット機能を利用して、アトミックで一貫性のある操作を保証します。
スナップショットの管理は完全に自動かつ透過的です。
バックグラウンドで完全に処理されるスナップショットによる追加の保護を受けながら、
これまでとまったく同じようにSnapRAIDを使用し続けることができます。
これには主に2つのメリットがあります。
整合性 - 長時間かかるsyncやscrubの実行中にライブファイルシステム上でファイルが変更されても、
SnapRAIDは凍結された時点のイメージを参照するため、パリティの不一致や処理の中断は発生しません。
復元 - ライブファイルシステムからファイルが更新または削除されても、スナップショット内に保存され続けます。
次のsyncが実行される前にディスク故障が発生した場合、SnapRAIDはスナップショットに保存されている
データを使用して、故障したディスクを再構築します。
アクティブなsync処理中にディスクが故障した場合、SnapRAIDは前のパリティ計算の
スナップショットと現在のスナップショットの両方から自動的に読み取ることも可能です。
これにより、同期の間にブロックが変更または削除されていた場合でも、パリティ方程式を解くために
必要な正確なデータブロックへのアクセスが提供され、完全な復元の可能性が最大化されます。
スナップショットがない場合、正常なディスク上の更新または削除されたファイルはデータブロックの欠損を
招き、他の故障したディスクを修復するために必要となるブロックが失われる可能性があります。
スナップショットはデータディスクに対してのみ、かつ基礎となるファイルシステムがその機能をサポートして
いる場合にのみ作成されます。パリティディスクは常にライブファイルシステムを使用します。
現在、これはLinuxのBtrfs、Bcachefs、ZFS、およびWindowsのNTFSでサポートされています。
異なるファイルシステムを持つデータディスクを混在させることができます。スナップショットをサポートして
いるディスクのみがそれを利用し、他のディスクはライブファイルシステム上で直接動作し続けます。
スナップショットの作成と削除には管理者権限が必要です。
スナップショットが有効な場合は、SnapRAIDが必要な権限(例:sudo)で実行されていることを確認してください。
スナップショット使用時のコマンドの挙動
`sync` と `scrub` コマンドは、すべてのデータ操作が一貫した凍結状態に対して行われることを
保証するために、いずれもスナップショット上でのみ動作します。これらのスナップショットを利用することで、
SnapRAIDはライブファイルシステム上での同時ファイル変更によってトリガーされるパリティの不一致を防ぎます。
`sync` の実行中、コマンドはプロセスの開始時に作成された新しいスナップショットを使用して、パリティ計算の
ための現在の状態をキャプチャします。
対照的に、`scrub` コマンドは、既存のパリティと一致する信頼できる参照ポイントを維持するために、
最も直近の同期中に作成された最後のスナップショットを利用します。
`check` および `fix` コマンドの場合、最後のスナップショットの使用は、
-d, --filter-disk オプションを使用して特定のディスクがターゲットに指定されているかどうかによって異なります。
-d を介して明示的に選択されたディスク(操作の「ターゲット」)は、常にライブファイルシステムを使用します。
`fix` の場合、これによりアクティブな交換ディスクにデータを復元できます。
`check` の場合、同じ条件下で `fix` 操作をシミュレートできます。
他のすべてのデータディスク(「参照」ディスク)は、それぞれのスナップショットを介してアクセスされます。
これにより、復旧の進行中に正常なディスク上のファイルを変更している場合でも、SnapRAIDは
パリティ方程式を解くための安定した凍結された参照を持つことができます。
-d オプションが指定されていない場合、SnapRAIDは操作がアレイ全体に適用されると想定します。
この場合、`check` と `fix` はライブファイルシステムのみを排他的に使用します。
他のすべてのコマンドは、ライブファイルシステム上でのみ動作します。
スナップショットのライフサイクル
SnapRAIDは、各データサブボリュームのルートにある隠しディレクトリ内で、
`stable`(安定)と `pending`(保留)という2つの特定のスナップショットを管理します。
Btrfs、Bcachefs、およびNTFSでは `.snapraid/` ディレクトリが使用され、
ZFSでは標準の `.zfs/snapshot/` が使用されます。
`stable` スナップショットは、最後に正常に完了した `sync` の状態を表し、
現在のパリティの計算に使用された正確なデータを含んでいます。これは、
`scrub`、`check`、および `fix` コマンドの主要なデータソースとして機能します。
`pending` スナップショットは、パリティ計算のための凍結された状態を提供するために、
`sync` の開始時に作成される一時的なイメージです。
操作が正常に完了すると、以前の `stable` スナップショットが削除され、
`pending` スナップショットが新しい安定した参照として昇格します。
`sync` が中断された場合、`pending` スナップショットは保持されます。
パリティが部分的にしか同期されていない場合でも、.content ファイルに記録されたファイルシステム状態と
一致するため、その後の `scrub`、`check`、および `fix` コマンドはこの保留中のスナップショットを使用します。
`sync` が中断された場合、`check` および `fix` コマンドは `stable` スナップショットからも
読み取りを行い、同期中に更新または削除されたファイルからデータブロックを取得します。
これは、.content ファイルが同期プロセス全体を通じて、変更または削除されたすべてのファイルの
メタデータを保持しているために可能です。
この履歴情報は、syncが正常に終了し、.content ファイルの最終バージョンが保存されたときにのみクリアされます。
中断後に `sync` が再開されると、既存の保留中(pending)のスナップショットは削除され、
ライブファイルシステムの現在の状態をキャプチャするために新しいスナップショットが作成されます。
Pattern
パターンは、含めるファイルまたは除外するファイルをフィルタリングするための柔軟な方法を
提供します。グロブ文字を使用することで、すべてのパスを手動でリストすることなく、

View file

@ -55,21 +55,31 @@ SnapRAIDにはいくつかの機能があります。
https://www.snapraid.it/
3 LIMITATIONS
=============
3 制限事項
======
SnapRAIDはRAIDとバックアッププログラムのハイブリッドであり、両方の利点を組み合わせることを
目指しています。ただし、使用する前に考慮すべきいくつかの制限があります。
目指しています。ただし、使用する前に考慮すべきいくつかの制限事項があります。
主な制限は、ディスクが故障し、最近 `sync` を実行していない場合、完全に復旧できない
可能性があることです。
より具体的には、最後の `sync` 操作以降に変更または削除されたファイルのサイズまでのデータが
復旧できない可能性があります。
これは、変更または削除されたファイルが故障したディスク上にない場合でも発生します。
このため、SnapRAIDは**めったに変更されない**データに適しています。
主な制限事項は、ディスクが故障した場合、最後の `sync`(同期)処理の状態までしか
データを復元できないことです。最後の同期以降に追加されたデータや、故障したディスク上で行われた
変更はすべて失われます。
一方で、新しく追加されたファイルは、既に存在するファイルの復旧を妨げません。
新しく追加されたファイルが故障したディスク上にある場合にのみ、それらのファイルが失われます。
そのため、SnapRAIDは主にデータの変更がほとんどない環境に適しています。
最後の同期時にすでに存在していたデータについて、復元の信頼性は `snapshot`(スナップショット)
オプションが使用されているかどうかによって異なります。
* スナップショットサポートがある場合(Btrfs、ZFS、Bcachefs、およびNTFSで利用可能):
SnapRAIDはデータディスクの凍結されたリファレンスを自動的に維持できます。
これにより、同期中または同期後にライブファイルシステム上のファイルを変更または削除した場合でも、
復元プロセスの整合性と信頼性が保たれます。
* スナップショットサポートがない場合:
`sync` 後にファイルを削除または変更すると、他の故障したディスクの完全な復元が妨げられる
可能性があります。これは、変更されたファイルが故障したディスク上にない場合でも、
パリティが変更後のファイルと一致しなくなるために発生します。一方で、新しく追加されたファイルが
すでに存在するファイルの復元を妨げることはありません。
その他のSnapRAIDの制限は次のとおりです。
@ -385,18 +395,18 @@ SnapRAIDの構成ファイルを変更して、故障したディスクの `data
すべてが復旧されていれば、このコマンドは即座に完了します。
5 COMMANDS
==========
5 コマンド
======
SnapRAIDは、次のことを可能にするいくつかの簡単なコマンドを提供します。
SnapRAIDは、以下の操作を行ういくつかのシンプルなコマンドを提供します。
* アレイの状態の概要を出力 -> `status`
* ディスクの制御 -> `smart`、`probe`、`up`、`down`
* バックアップ/スナップショットの作成 -> `sync`
* データの定期的なチェック -> `scrub`
* 最後のバックアップ/スナップショットの復元 -> `fix`。
* アレイの状態を表示する -> `status`
* ディスクを制御する -> `smart`、`probe`、`up`、`down`
* バックアップ/復元ポイントを作成する -> `sync`
* データを定期的にチェックする -> `scrub`
* 最後のバックアップ/復元ポイントを復元する -> `fix`
コマンドは**小文字**で記述する必要があります。
コマンドは小文字で入力する必要があります。
5.1 status
----------
@ -609,14 +619,14 @@ full - すべてをスクラブします。
5.9 fix
-------
すべてのファイルとパリティデータを修正します。
すべてのファイルとパリティデータを修復(復元)します。
すべてのファイルとパリティデータは、最後の `sync` で保存されたスナップショット状態と
比較されます。
違いが見つかった場合、保存されたスナップショットに**元に戻されます**。
すべてのファイルとパリティデータが、最後の `sync` で保存された状態と比較されます。
差異が見つかった場合、保存されていた状態に巻き戻されます。
**警告!** `fix` コマンドは、エラーと意図的な変更を区別しません。
ファイルの_状態を_最後の `sync` に**無条件に元に戻します**。
警告!
`fix` コマンドは、エラーと意図的な変更を区別しません。
ファイルの変更状態を無条件で最後の `sync` の状態に戻します。
他のオプションが指定されていない場合、アレイ全体が処理されます。
フィルタオプションを使用して、操作するファイルまたはディスクのサブセットを
@ -1144,14 +1154,38 @@ NAME を固定したままにしておけば、必要に応じてマウントポ
これらのディスクは常に回転していることが期待されるため、`up` およ
び `down` コマンドの影響を受けないことに注意してください。
7.7 nohidden
7.7 snapshot
------------
`sync`、`scrub`、`check`、および `fix` コマンドでファイルシステムスナップショットの
使用を有効にします。
有効にすると、SnapRAIDは `sync` の開始時にデータの読み取り専用スナップショットを作成します。
これにより、ファイルの整合性を保った特定の時点のビューが確保され、ファイルの同時変更によって
発生するエラーを防ぎます。
これにより復元が大幅に向上します。ライブファイルシステムからファイルが削除されても、
スナップショット内に保存され続けます。これにより、そのブロックのパリティが「破損」するのを防ぎ、
別のディスクが故障した場合でもデータを正常に復元できるようになります。
このオプションは、LinuxのBtrfs、Bcachefs、ZFS、およびWindowsのNTFSでフォーマットされた
データディスクにのみ適用されます。
パリティディスク、または他のファイルシステムを使用しているデータディスクは、常にファイルシステムの
ライブバージョンを使用します。
スナップショットの作成と削除には管理者権限が必要です。
このオプションが有効な場合は、SnapRAIDが必要な権限(例:sudo)で実行されていることを確認してください。
スナップショットのライフサイクルの詳細な説明については、SNAPSHOTSのセクションを参照してください。
7.8 nohidden
------------
すべての隠しファイルとディレクトリを除外します。
Unixでは、隠しファイルは `.` で始まるファイルです。
Windowsでは、隠し属性を持つファイルです。
7.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
syncプロセスで除外または含めるファイルまたはディレクトリのパターンを定義します。
@ -1166,8 +1200,8 @@ syncプロセスで除外または含めるファイルまたはディレクト
このオプションは複数回使用できます。
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
パリティの基本ブロックサイズをキビバイト単位で定義します。
1キビバイトは1024バイトです。
@ -1210,7 +1244,7 @@ Linuxでより大きなパリティパーティションを取得するトリッ
これにより、約1.5%の追加スペース、4 TBディスクで約60 GBが得られ、
浪費スペースなしで各データディスクで約460,000ファイルが可能になります。
7.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
保存されたブロックのハッシュサイズをバイト単位で定義します。
@ -1244,14 +1278,14 @@ RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 16) / (512 \cdot 2^{10}) = 0.96 \tex
RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 8) / (512 \cdot 2^{10}) = 0.51 \text{ GiB}$
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
処理された指定されたGB量後に、同期またはスクラビング時に状態を自動的に保存します。
このオプションは、マシンクラッシュやその他のイベントによって中断された場合に、
長い `sync` コマンドを最初から再起動するのを避けるのに役立ちます。
7.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
許容される最大ディスク温度を摂氏で設定します。指定されている場合、
@ -1279,13 +1313,13 @@ SnapRAIDの動作には影響しません。プログラムの動作は、実際
通常、SnapRAIDは最も熱いディスクの温度のみを表示します。
すべてのディスクの温度を表示するには、-A または --stats オプションを使用します。
7.13 temp_sleep TIME_IN_MINUTES
7.14 temp_sleep TIME_IN_MINUTES
-------------------------------
温度制限に達したときのスタンバイ時間(分単位)を設定します。この期間中、ディスクは
スピンダウンしたままです。デフォルトは5分です。
7.14 pool DIR
7.15 pool DIR
-------------
`pool` コマンドを使用してディスクアレイの仮想ビューが作成されるプーリングディレクトリを
@ -1293,7 +1327,7 @@ SnapRAIDの動作には影響しません。プログラムの動作は、実際
ディレクトリは既に存在している必要があります。
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
ディスクにリモートでアクセスするために必要なWindows UNCパスを定義します。
@ -1308,7 +1342,7 @@ SnapRAIDの動作には影響しません。プログラムの動作は、実際
このオプションはWindowsでのみ必要です。
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
各ディスクのSMART属性を取得するためのカスタムsmartctlオプションを定義します。
@ -1333,7 +1367,7 @@ RAIDコントローラーの場合、デバイスは固定されている可能
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
ディスク障害の確率を計算するときに、指定されたSMART属性を無視します。
@ -1353,7 +1387,7 @@ PARITY はパリティ名のいずれかです:`parity`、`2-parity`、`3-pari
smartignore parity 197
7.18 Examples
7.19 Examples
-------------
Unixの一般的な構成の例は次のとおりです。
@ -1388,8 +1422,103 @@ Windowsの一般的な構成の例は次のとおりです。
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 PATTERN
=========
8 SNAPSHOTS(スナップショット)
=====================
設定でスナップショットオプションが有効になっている場合、SnapRAIDは
ファイルシステムのスナップショット機能を利用して、アトミックで一貫性のある操作を保証します。
スナップショットの管理は完全に自動かつ透過的です。
バックグラウンドで完全に処理されるスナップショットによる追加の保護を受けながら、
これまでとまったく同じようにSnapRAIDを使用し続けることができます。
これには主に2つのメリットがあります。
整合性 - 長時間かかるsyncやscrubの実行中にライブファイルシステム上でファイルが変更されても、
SnapRAIDは凍結された時点のイメージを参照するため、パリティの不一致や処理の中断は発生しません。
復元 - ライブファイルシステムからファイルが更新または削除されても、スナップショット内に保存され続けます。
次のsyncが実行される前にディスク故障が発生した場合、SnapRAIDはスナップショットに保存されている
データを使用して、故障したディスクを再構築します。
アクティブなsync処理中にディスクが故障した場合、SnapRAIDは前のパリティ計算の
スナップショットと現在のスナップショットの両方から自動的に読み取ることも可能です。
これにより、同期の間にブロックが変更または削除されていた場合でも、パリティ方程式を解くために
必要な正確なデータブロックへのアクセスが提供され、完全な復元の可能性が最大化されます。
スナップショットがない場合、正常なディスク上の更新または削除されたファイルはデータブロックの欠損を
招き、他の故障したディスクを修復するために必要となるブロックが失われる可能性があります。
スナップショットはデータディスクに対してのみ、かつ基礎となるファイルシステムがその機能をサポートして
いる場合にのみ作成されます。パリティディスクは常にライブファイルシステムを使用します。
現在、これはLinuxのBtrfs、Bcachefs、ZFS、およびWindowsのNTFSでサポートされています。
異なるファイルシステムを持つデータディスクを混在させることができます。スナップショットをサポートして
いるディスクのみがそれを利用し、他のディスクはライブファイルシステム上で直接動作し続けます。
スナップショットの作成と削除には管理者権限が必要です。
スナップショットが有効な場合は、SnapRAIDが必要な権限(例:sudo)で実行されていることを確認してください。
8.1 スナップショット使用時のコマンドの挙動
-----------------------
`sync` と `scrub` コマンドは、すべてのデータ操作が一貫した凍結状態に対して行われることを
保証するために、いずれもスナップショット上でのみ動作します。これらのスナップショットを利用することで、
SnapRAIDはライブファイルシステム上での同時ファイル変更によってトリガーされるパリティの不一致を防ぎます。
`sync` の実行中、コマンドはプロセスの開始時に作成された新しいスナップショットを使用して、パリティ計算の
ための現在の状態をキャプチャします。
対照的に、`scrub` コマンドは、既存のパリティと一致する信頼できる参照ポイントを維持するために、
最も直近の同期中に作成された最後のスナップショットを利用します。
`check` および `fix` コマンドの場合、最後のスナップショットの使用は、
-d, --filter-disk オプションを使用して特定のディスクがターゲットに指定されているかどうかによって異なります。
-d を介して明示的に選択されたディスク(操作の「ターゲット」)は、常にライブファイルシステムを使用します。
`fix` の場合、これによりアクティブな交換ディスクにデータを復元できます。
`check` の場合、同じ条件下で `fix` 操作をシミュレートできます。
他のすべてのデータディスク(「参照」ディスク)は、それぞれのスナップショットを介してアクセスされます。
これにより、復旧の進行中に正常なディスク上のファイルを変更している場合でも、SnapRAIDは
パリティ方程式を解くための安定した凍結された参照を持つことができます。
-d オプションが指定されていない場合、SnapRAIDは操作がアレイ全体に適用されると想定します。
この場合、`check` と `fix` はライブファイルシステムのみを排他的に使用します。
他のすべてのコマンドは、ライブファイルシステム上でのみ動作します。
9 スナップショットのライフサイクル
==================
SnapRAIDは、各データサブボリュームのルートにある隠しディレクトリ内で、
`stable`(安定)と `pending`(保留)という2つの特定のスナップショットを管理します。
Btrfs、Bcachefs、およびNTFSでは `.snapraid/` ディレクトリが使用され、
ZFSでは標準の `.zfs/snapshot/` が使用されます。
`stable` スナップショットは、最後に正常に完了した `sync` の状態を表し、
現在のパリティの計算に使用された正確なデータを含んでいます。これは、
`scrub`、`check`、および `fix` コマンドの主要なデータソースとして機能します。
`pending` スナップショットは、パリティ計算のための凍結された状態を提供するために、
`sync` の開始時に作成される一時的なイメージです。
操作が正常に完了すると、以前の `stable` スナップショットが削除され、
`pending` スナップショットが新しい安定した参照として昇格します。
`sync` が中断された場合、`pending` スナップショットは保持されます。
パリティが部分的にしか同期されていない場合でも、.content ファイルに記録されたファイルシステム状態と
一致するため、その後の `scrub`、`check`、および `fix` コマンドはこの保留中のスナップショットを使用します。
`sync` が中断された場合、`check` および `fix` コマンドは `stable` スナップショットからも
読み取りを行い、同期中に更新または削除されたファイルからデータブロックを取得します。
これは、.content ファイルが同期プロセス全体を通じて、変更または削除されたすべてのファイルの
メタデータを保持しているために可能です。
この履歴情報は、syncが正常に終了し、.content ファイルの最終バージョンが保存されたときにのみクリアされます。
中断後に `sync` が再開されると、既存の保留中(pending)のスナップショットは削除され、
ライブファイルシステムの現在の状態をキャプチャするために新しいスナップショットが作成されます。
10 PATTERN
==========
パターンは、含めるファイルまたは除外するファイルをフィルタリングするための柔軟な方法を
提供します。グロブ文字を使用することで、すべてのパスを手動でリストすることなく、
@ -1501,8 +1630,8 @@ Unixでは、コマンドラインでグロブ文字を使用する場合、シ
防ぐために引用符で囲む必要があります。
9 IGNORE FILE
=============
11 IGNORE FILE
==============
設定ファイルのグローバルルールに加えて、アレイ内の任意のディレクトリに
.snapraidignore ファイルを配置して、分散型の除外ルールを定義できます。
@ -1545,7 +1674,7 @@ Unixでは、コマンドラインでグロブ文字を使用する場合、シ
*.tmp
10 CONTENT
12 CONTENT
==========
SnapRAIDは、ファイルの一覧とチェックサムをコンテンツファイルに保存します。
@ -1557,7 +1686,7 @@ SnapRAIDは、ファイルの一覧とチェックサムをコンテンツファ
`fix`、`check`、および `status` コマンドによって読み取られます。
11 PARITY
13 PARITY
=========
SnapRAIDは、アレイのパリティ情報をパリティファイルに保存します。
@ -1569,7 +1698,7 @@ SnapRAIDは、アレイのパリティ情報をパリティファイルに保存
`scrub` および `check` コマンドによって**読み取られるだけ**です。
12 ENCODING
14 ENCODING
===========
UnixのSnapRAIDは、エンコーディングを無視します。ファイルシステムで使用されている
@ -1584,13 +1713,13 @@ Windowsでは、ファイルシステムから読み取られたすべての名
結果のファイルは常にUTF-8形式になります。
13 COPYRIGHT
15 COPYRIGHT
============
This file is Copyright (C) 2025 Andrea Mazzoleni
14 SEE ALSO
16 SEE ALSO
===========
snapraid_log(1), snapraidd(1)

View file

@ -116,20 +116,33 @@ https://www.snapraid.it/
.PD 0
.PD
.RE
.SH LIMITATIONS
SnapRAID는 RAID와 백업 프로그램의 하이브리드로, 두 가지의 장점을
결합하는 것을 목표로 합니다. 하지만, 사용 전에 고려해야 할 몇 가지
제한 사항이 있습니다.
.SH 제한 사항
SnapRAID는 RAID와 백업 프로그램의 하이브리드로, 두 가지의 장점을 결합하는 것을
목표로 합니다. 그러나 사용하기 전에 고려해야 할 몇 가지 제한 사항이 있습니다.
.PP
주요 제한 사항은 디스크가 실패하고 최근에 동기화(sync)하지 않은 경우,
완전히 복구하지 못할 수 있다는 것입니다.
더 구체적으로, 마지막 동기화 작업 이후 변경되거나 삭제된 파일의
크기만큼 복구가 불가능할 수 있습니다.
이는 변경되거나 삭제된 파일이 실패한 디스크에 있지 않더라도 발생합니다.
이것이 SnapRAID가 **거의 변경되지 않는 데이터**에 더 적합한 이유입니다.
가장 큰 제한 사항은 디스크가 고장 날 경우, 마지막 \`sync\`(동기화) 작업의 상태까지만
데이터를 복구할 수 있다는 점입니다. 마지막 동기화 이후에 추가되거나 수정된 데이터 중
고장 난 디스크에 위치한 데이터는 모두 손실됩니다.
.PP
반면에, 새로 추가된 파일은 이미 존재하는 파일의 복구를 방해하지 않습니다.
새로 추가된 파일이 실패한 디스크에 있는 경우에만 해당 파일을 잃게 됩니다.
따라서 SnapRAID는 주로 데이터 변경이 거의 없는 환경에 적합합니다.
.PP
마지막 동기화 시점에 이미 존재했던 데이터의 경우, 복구 신뢰성은 \`snapshot\`(스냅샷)
옵션의 사용 여부에 따라 달라집니다.
.PD 0
.IP \(bu
스냅샷 지원이 있는 경우 (Btrfs, ZFS, Bcachefs 및 NTFS에서 사용 가능):
SnapRAID는 데이터 디스크의 동결된 참조를 자동으로 유지할 수 있습니다.
이를 통해 동기화 중이나 동기화 후에 라이브 파일시스템의 파일을 수정하거나 삭제하더라도
복구 프로세스가 일관되고 신뢰할 수 있게 유지됩니다.
.PD
.PD 0
.IP \(bu
스냅샷 지원이 없는 경우:
\`sync\` 후에 파일을 삭제하거나 변경하면 다른 고장 난 디스크의 완전한 복구가 방해받을 수
있습니다. 이는 수정된 파일이 고장 난 디스크에 없더라도 파리티가 수정된 파일과
더 이상 일치하지 않기 때문에 발생합니다. 반면에 새로 추가된 파일은 이미 존재하는
파일의 복구를 방해하지 않습니다.
.PD
.PP
기타 SnapRAID 제한 사항은 다음과 같습니다:
.PD 0
@ -636,22 +649,22 @@ snapraid sync
.RE
.PP
모든 것이 복구되면 이 명령은 즉시 완료됩니다.
.SH COMMANDS
SnapRAID는 다음을 허용하는 몇 가지 간단한 명령을 제공합니다:
.SH 명령어
SnapRAID는 다음과 같은 작업을 수행할 수 있는 몇 가지 간단한 명령어를 제공합니다.
.PD 0
.IP \(bu
어레이의 상태 출력 \-> \`status\`
.IP \(bu
디스크 제어 \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
백업/스냅샷 생성 \-> \`sync\`
백업/복구 지점 생성 \-> \`sync\`
.IP \(bu
주기적으로 데이터 확인 \-> \`scrub\`
주기적인 데이터 검사 \-> \`scrub\`
.IP \(bu
마지막 백업/스냅샷 복원 \-> \`fix\`.
마지막 백업/복구 지점 복원 \-> \`fix\`
.PD
.PP
명령은 소문자로 작성해야 합니다.
명령어는 반드시 소문자로 작성해야 합니다.
.SS status
디스크 어레이의 상태 요약을 출력합니다.
.PP
@ -869,14 +882,14 @@ bad 블록만 스크럽하려면 \`scrub \-p bad\` 명령을 사용할 수 있
\`parity\` 파일은 수정되지 않습니다.
어레이의 파일은 수정되지 않습니다.
.SS fix
모든 파일과 패리티 데이터를 수정합니다.
모든 파일과 파리티 데이터를 복구(수정)합니다.
.PP
모든 파일과 패리티 데이터는 마지막 \`sync\`에 저장된 스냅샷
상태와 비교됩니다.
차이가 발견되면 저장된 스냅샷으로 되돌려집니다.
모든 파일과 파리티 데이터는 마지막 \`sync\`에 저장된 상태와 비교됩니다.
차이점이 발견되면 저장된 상태로 되돌립니다.
.PP
**경고!** \`fix\` 명령은 오류와 의도적인 수정 사이를 구별하지
않습니다. 파일 상태를 무조건 마지막 \`sync\`로 되돌립니다.
경고!
\`fix\` 명령어는 오류와 의도적인 수정을 구별하지 않습니다.
파일 상태를 조건 없이 마지막 \`sync\` 상태로 되돌립니다.
.PP
다른 옵션이 지정되지 않으면 전체 어레이가 처리됩니다.
필터 옵션을 사용하여 처리할 파일 또는 디스크의 하위 집합을 선택하십시오.
@ -1385,6 +1398,27 @@ NAME을 고정된 상태로 유지하는 한, 필요에 따라 마운트 지점
.PP
이러한 디스크는 항상 회전할 것으로 예상되므로 \`up\` 및 \`down\` 명령의
영향을 받지 않습니다.
.SS snapshot
\`sync\`, \`scrub\`, \`check\` 및 \`fix\` 명령어에 파일시스템 스냅샷 사용을
활성화합니다.
.PP
활성화되면 SnapRAID는 \`sync\` 시작 시 데이터의 읽기 전용 스냅샷을 생성합니다.
이는 파일의 일관된 특정 시점 뷰를 보장하여 동시 파일 수정으로 인해 발생하는
오류를 방지합니다.
.PP
이는 복구 성능을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도
스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 파리티가 \[dq]깨지는\[dq] 것을 방지하여,
다른 디스크가 고장 나더라도 데이터를 성공적으로 복구할 수 있도록 보장합니다.
.PP
이 옵션은 Linux의 Btrfs, Bcachefs 또는 ZFS 파일시스템과 Windows의 NTFS로 포맷된
데이터 디스크에만 독점적으로 적용됩니다.
파리티 디스크나 다른 파일시스템을 사용하는 데이터 디스크는 항상 파일시스템의
라이브 버전을 사용합니다.
.PP
스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다.
이 옵션이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오.
.PP
스냅샷 수명 주기에 대한 자세한 설명은 SNAPSHOTS 섹션을 참조하십시오.
.SS nohidden
모든 숨겨진 파일 및 디렉토리를 제외합니다.
Unix에서는 숨겨진 파일은 \'.\'으로 시작하는 파일입니다.
@ -1710,6 +1744,104 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS (스냅샷)
구성에서 스냅샷 옵션이 활성화된 경우, SnapRAID는 원자적이고
일관된 작업을 보장하기 위해 파일시스템 스냅샷 기능을 이용합니다.
.PP
스냅샷 관리는 완전히 자동적이고 투명하게 이루어집니다.
백그라운드에서 완전히 처리되는 스냅샷의 추가적인 보호와 함께,
기존과 완전히 동일하게 SnapRAID를 계속 사용할 수 있습니다.
.PP
이것은 두 가지 주요 이점을 제공합니다.
.RS 0
.PD 0
.HP 4
.I 일관성
장시간 실행되는 sync 또는 scrub 중에 라이브 파일시스템에서 수정된 파일은
SnapRAID가 동결된 시점의 이미지를 보기 때문에 파리티 불일치나 작업 중단을
유발하지 않습니다.
.HP 4
.I 복구
라이브 파일시스템에서 파일이 업데이트되거나 삭제되더라도 스냅샷에 보존됩니다.
다음 sync가 실행되기 전에 디스크 고장이 발생하면, SnapRAID는 스냅샷에 보존된
데이터를 사용하여 고장 난 디스크를 재구성합니다.
.PD
.PP
.RS 4
.PD 0
활성 sync 프로세스 중에 디스크 고장이 발생하는 경우,
SnapRAID는 이전 파리티 계산의 스냅샷과 현재 스냅샷 모두에서 자동으로 읽을 수도 있습니다.
이는 동기화 사이에 블록이 수정되거나 삭제되었더라도 파리티 방정식을 푸는 데
필요한 정확한 데이터 블록에 대한 접근을 제공함으로써 완전한 복구 확률을 최대화합니다.
.PD
.PP
.PD 0
스냅샷이 없으면 정상 디스크에서 업데이트되거나 삭제된 파일로 인해 데이터 블록이 누락되며,
이는 다른 고장 난 디스크를 복구하는 데 필요할 수 있습니다.
.PD
.RE
.RE
.PP
스냅샷은 데이터 디스크에 대해서만 생성되며, 기본 파일시스템이 이 기능을 지원하는 경우에만
생성됩니다. 파리티 디스크는 항상 라이브 파일시스템을 사용합니다.
현재 이는 Linux의 Btrfs, Bcachefs, ZFS 및 Windows의 NTFS에서 지원됩니다.
.PP
서로 다른 파일시스템을 가진 데이터 디스크를 혼합할 수 있습니다. 스냅샷을 지원하는 디스크만
이를 활용하고, 다른 디스크는 라이브 파일시스템에서 직접 계속 작동합니다.
.PP
스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다.
스냅샷이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오.
.SS 스냅샷 사용 시 명령어 동작
\`sync\` 와 \`scrub\` 명령어는 모두 일관되고 동결된 상태에 대해 모든 데이터 작업이 수행되도록
보장하기 위해 스냅샷에서만 독점적으로 작동합니다. 이러한 스냅샷을 이용함으로써 SnapRAID는
라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 파리티 불일치를 방지합니다.
\`sync\` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 파리티 계산을 위한
현재 상태를 캡처합니다.
반면에 \`scrub\` 명령어는 기존 파리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해
가장 최근 동기화 중에 생성된 마지막 스냅샷을 이용합니다.
.PP
\`check\` 및 \`fix\` 명령어의 경우, 마지막 스냅샷의 사용 여부는
\-d, \-\-filter\-disk 옵션을 사용하여 특정 디스크를 대상으로 지정하는지 여부에 따라 달라집니다.
.TP
.B \-d를 통해 명시적으로 선택된 디스크(작업의 \[dq]대상\[dq])는 항상 라이브 파일시스템을 사용합니다.
\`fix\` 의 경우 이를 통해 활성 교체 디스크에 데이터를 복원할 수 있습니다.
\`check\` 의 경우 동일한 조건에서 \`fix\` 작업을 시뮬레이션할 수 있습니다.
.PP
다른 모든 데이터 디스크(\[dq]참조\[dq] 디스크)는 해당 스냅샷을 통해 액세스됩니다.
이를 통해 복구가 진행되는 동안 정상 디스크의 파일을 수정하고 있더라도 SnapRAID가
파리티 방정식을 풀기 위한 안정적이고 동결된 참조를 가질 수 있습니다.
.TP
.B \-d 옵션이 제공되지 않으면 SnapRAID는 작업이 전체 어레이에 적용된다고 가정하며, 이 경우
\`check\` 와 \`fix\` 는 라이브 파일시스템만을 독점적으로 사용합니다.
.PP
다른 모든 명령어는 라이브 파일시스템에서만 독점적으로 작동합니다.
.SH 스냅샷 수명 주기
SnapRAID는 각 데이터 하위 볼륨의 루트에 있는 숨겨진 디렉터리 내에서
\`stable\`(안정)과 \`pending\`(보류)이라는 두 가지 특정 스냅샷을 관리합니다.
Btrfs, Bcachefs 및 NTFS에서는 \`.snapraid/\` 디렉터리가 사용되며,
ZFS에서는 표준 \`.zfs/snapshot/\` 이 사용됩니다.
.PP
\`stable\` 스냅샷은 성공적으로 완료된 마지막 \`sync\` 상태를 나타내며,
현재 파리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는
\`scrub\`, \`check\` 및 \`fix\` 명령어의 기본 데이터 소스 역할을 합니다.
.PP
\`pending\` 스냅샷은 파리티 계산을 위한 동결된 상태를 제공하기 위해 \`sync\` 시작 시
생성되는 임시 이미지입니다.
작업이 성공적으로 완료되면 이전의 \`stable\` 스냅샷은 삭제되고, \`pending\` 스냅샷이
새로운 안정적인 참조로 자리를 잡도록 승격됩니다.
.PP
\`sync\` 가 중단되면 \`pending\` 스냅샷은 보존됩니다.
파리티가 부분적으로만 동기화되었더라도 .content 파일에 기록된 파일시스템 상태와 일치하므로
이후의 \`scrub\`, \`check\` 및 \`fix\` 명령어는 이 보류 중인 스냅샷을 사용합니다.
.PP
\`sync\` 가 중단된 경우, \`check\` 및 \`fix\` 명령어는 \`stable\` 스냅샷에서도 읽어와
동기화 중에 업데이트되거나 삭제된 파일에서 데이터 블록을 검색합니다.
이는 동기화 프로세스 전반에 걸쳐 .content 파일이 수정되거나 삭제된 모든 파일의
메타데이터를 유지하기 때문에 가능합니다.
이 기록 정보는 동기화가 성공적으로 완료되고 .content 파일의 최종 버전이 저장되어야만 삭제됩니다.
.PP
중단 후 \`sync\` 가 재시작되면 기존의 보류 중인(pending) 스냅샷은 삭제되고,
라이브 파일시스템의 현재 상태를 캡처하기 위해 새 스냅샷이 생성됩니다.
.SH PATTERN
패턴은 포함하거나 제외할 파일을 필터링하는 유연한 방법을 제공합니다.
글로빙(globbing) 문자를 사용하면 모든 경로를 일일이 나열하지 않고도

View file

@ -50,20 +50,29 @@ Description
:https://www.snapraid.it/
Limitations
SnapRAID는 RAID와 백업 프로그램의 하이브리드로, 두 가지의 장점을
결합하는 것을 목표로 합니다. 하지만, 사용 전에 고려해야 할 몇 가지
제한 사항이 있습니다.
제한 사항
SnapRAID는 RAID와 백업 프로그램의 하이브리드로, 두 가지의 장점을 결합하는 것을
목표로 합니다. 그러나 사용하기 전에 고려해야 할 몇 가지 제한 사항이 있습니다.
주요 제한 사항은 디스크가 실패하고 최근에 동기화(sync)하지 않은 경우,
완전히 복구하지 못할 수 있다는 것입니다.
더 구체적으로, 마지막 동기화 작업 이후 변경되거나 삭제된 파일의
크기만큼 복구가 불가능할 수 있습니다.
이는 변경되거나 삭제된 파일이 실패한 디스크에 있지 않더라도 발생합니다.
이것이 SnapRAID가 **거의 변경되지 않는 데이터**에 더 적합한 이유입니다.
가장 큰 제한 사항은 디스크가 고장 날 경우, 마지막 `sync`(동기화) 작업의 상태까지만
데이터를 복구할 수 있다는 점입니다. 마지막 동기화 이후에 추가되거나 수정된 데이터 중
고장 난 디스크에 위치한 데이터는 모두 손실됩니다.
반면에, 새로 추가된 파일은 이미 존재하는 파일의 복구를 방해하지 않습니다.
새로 추가된 파일이 실패한 디스크에 있는 경우에만 해당 파일을 잃게 됩니다.
따라서 SnapRAID는 주로 데이터 변경이 거의 없는 환경에 적합합니다.
마지막 동기화 시점에 이미 존재했던 데이터의 경우, 복구 신뢰성은 `snapshot`(스냅샷)
옵션의 사용 여부에 따라 달라집니다.
* 스냅샷 지원이 있는 경우 (Btrfs, ZFS, Bcachefs 및 NTFS에서 사용 가능):
SnapRAID는 데이터 디스크의 동결된 참조를 자동으로 유지할 수 있습니다.
이를 통해 동기화 중이나 동기화 후에 라이브 파일시스템의 파일을 수정하거나 삭제하더라도
복구 프로세스가 일관되고 신뢰할 수 있게 유지됩니다.
* 스냅샷 지원이 없는 경우:
`sync` 후에 파일을 삭제하거나 변경하면 다른 고장 난 디스크의 완전한 복구가 방해받을 수
있습니다. 이는 수정된 파일이 고장 난 디스크에 없더라도 파리티가 수정된 파일과
더 이상 일치하지 않기 때문에 발생합니다. 반면에 새로 추가된 파일은 이미 존재하는
파일의 복구를 방해하지 않습니다.
기타 SnapRAID 제한 사항은 다음과 같습니다:
@ -376,16 +385,16 @@ Getting Started
모든 것이 복구되면 이 명령은 즉시 완료됩니다.
Commands
SnapRAID는 다음을 허용하는 몇 가지 간단한 명령을 제공합니다:
명령어
SnapRAID는 다음과 같은 작업을 수행할 수 있는 몇 가지 간단한 명령어를 제공합니다.
* 어레이의 상태 출력 -> `status`
* 디스크 제어 -> `smart`, `probe`, `up`, `down`
* 백업/스냅샷 생성 -> `sync`
* 주기적으로 데이터 확인 -> `scrub`
* 마지막 백업/스냅샷 복원 -> `fix`.
* 백업/복구 지점 생성 -> `sync`
* 주기적인 데이터 검사 -> `scrub`
* 마지막 백업/복구 지점 복원 -> `fix`
명령은 소문자로 작성해야 합니다.
명령어는 반드시 소문자로 작성해야 합니다.
status
디스크 어레이의 상태 요약을 출력합니다.
@ -578,14 +587,14 @@ Commands
어레이의 파일은 수정되지 않습니다.
fix
모든 파일과 패리티 데이터를 수정합니다.
모든 파일과 파리티 데이터를 복구(수정)합니다.
모든 파일과 패리티 데이터는 마지막 `sync`에 저장된 스냅샷
상태와 비교됩니다.
차이가 발견되면 저장된 스냅샷으로 되돌려집니다.
모든 파일과 파리티 데이터는 마지막 `sync`에 저장된 상태와 비교됩니다.
차이점이 발견되면 저장된 상태로 되돌립니다.
**경고!** `fix` 명령은 오류와 의도적인 수정 사이를 구별하지
않습니다. 파일 상태를 무조건 마지막 `sync`로 되돌립니다.
경고!
`fix` 명령어는 오류와 의도적인 수정을 구별하지 않습니다.
파일 상태를 조건 없이 마지막 `sync` 상태로 되돌립니다.
다른 옵션이 지정되지 않으면 전체 어레이가 처리됩니다.
필터 옵션을 사용하여 처리할 파일 또는 디스크의 하위 집합을 선택하십시오.
@ -1105,6 +1114,28 @@ Configuration
이러한 디스크는 항상 회전할 것으로 예상되므로 `up` 및 `down` 명령의
영향을 받지 않습니다.
snapshot
`sync`, `scrub`, `check` 및 `fix` 명령어에 파일시스템 스냅샷 사용을
활성화합니다.
활성화되면 SnapRAID는 `sync` 시작 시 데이터의 읽기 전용 스냅샷을 생성합니다.
이는 파일의 일관된 특정 시점 뷰를 보장하여 동시 파일 수정으로 인해 발생하는
오류를 방지합니다.
이는 복구 성능을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도
스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 파리티가 "깨지는" 것을 방지하여,
다른 디스크가 고장 나더라도 데이터를 성공적으로 복구할 수 있도록 보장합니다.
이 옵션은 Linux의 Btrfs, Bcachefs 또는 ZFS 파일시스템과 Windows의 NTFS로 포맷된
데이터 디스크에만 독점적으로 적용됩니다.
파리티 디스크나 다른 파일시스템을 사용하는 데이터 디스크는 항상 파일시스템의
라이브 버전을 사용합니다.
스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다.
이 옵션이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오.
스냅샷 수명 주기에 대한 자세한 설명은 SNAPSHOTS 섹션을 참조하십시오.
nohidden
모든 숨겨진 파일 및 디렉토리를 제외합니다.
Unix에서는 숨겨진 파일은 '.'으로 시작하는 파일입니다.
@ -1334,6 +1365,94 @@ Configuration
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots (스냅샷)
구성에서 스냅샷 옵션이 활성화된 경우, SnapRAID는 원자적이고
일관된 작업을 보장하기 위해 파일시스템 스냅샷 기능을 이용합니다.
스냅샷 관리는 완전히 자동적이고 투명하게 이루어집니다.
백그라운드에서 완전히 처리되는 스냅샷의 추가적인 보호와 함께,
기존과 완전히 동일하게 SnapRAID를 계속 사용할 수 있습니다.
이것은 두 가지 주요 이점을 제공합니다.
일관성 - 장시간 실행되는 sync 또는 scrub 중에 라이브 파일시스템에서 수정된 파일은
SnapRAID가 동결된 시점의 이미지를 보기 때문에 파리티 불일치나 작업 중단을
유발하지 않습니다.
복구 - 라이브 파일시스템에서 파일이 업데이트되거나 삭제되더라도 스냅샷에 보존됩니다.
다음 sync가 실행되기 전에 디스크 고장이 발생하면, SnapRAID는 스냅샷에 보존된
데이터를 사용하여 고장 난 디스크를 재구성합니다.
활성 sync 프로세스 중에 디스크 고장이 발생하는 경우,
SnapRAID는 이전 파리티 계산의 스냅샷과 현재 스냅샷 모두에서 자동으로 읽을 수도 있습니다.
이는 동기화 사이에 블록이 수정되거나 삭제되었더라도 파리티 방정식을 푸는 데
필요한 정확한 데이터 블록에 대한 접근을 제공함으로써 완전한 복구 확률을 최대화합니다.
스냅샷이 없으면 정상 디스크에서 업데이트되거나 삭제된 파일로 인해 데이터 블록이 누락되며,
이는 다른 고장 난 디스크를 복구하는 데 필요할 수 있습니다.
스냅샷은 데이터 디스크에 대해서만 생성되며, 기본 파일시스템이 이 기능을 지원하는 경우에만
생성됩니다. 파리티 디스크는 항상 라이브 파일시스템을 사용합니다.
현재 이는 Linux의 Btrfs, Bcachefs, ZFS 및 Windows의 NTFS에서 지원됩니다.
서로 다른 파일시스템을 가진 데이터 디스크를 혼합할 수 있습니다. 스냅샷을 지원하는 디스크만
이를 활용하고, 다른 디스크는 라이브 파일시스템에서 직접 계속 작동합니다.
스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다.
스냅샷이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오.
스냅샷 사용 시 명령어 동작
`sync` 와 `scrub` 명령어는 모두 일관되고 동결된 상태에 대해 모든 데이터 작업이 수행되도록
보장하기 위해 스냅샷에서만 독점적으로 작동합니다. 이러한 스냅샷을 이용함으로써 SnapRAID는
라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 파리티 불일치를 방지합니다.
`sync` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 파리티 계산을 위한
현재 상태를 캡처합니다.
반면에 `scrub` 명령어는 기존 파리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해
가장 최근 동기화 중에 생성된 마지막 스냅샷을 이용합니다.
`check` 및 `fix` 명령어의 경우, 마지막 스냅샷의 사용 여부는
-d, --filter-disk 옵션을 사용하여 특정 디스크를 대상으로 지정하는지 여부에 따라 달라집니다.
-d를 통해 명시적으로 선택된 디스크(작업의 "대상")는 항상 라이브 파일시스템을 사용합니다.
`fix` 의 경우 이를 통해 활성 교체 디스크에 데이터를 복원할 수 있습니다.
`check` 의 경우 동일한 조건에서 `fix` 작업을 시뮬레이션할 수 있습니다.
다른 모든 데이터 디스크("참조" 디스크)는 해당 스냅샷을 통해 액세스됩니다.
이를 통해 복구가 진행되는 동안 정상 디스크의 파일을 수정하고 있더라도 SnapRAID가
파리티 방정식을 풀기 위한 안정적이고 동결된 참조를 가질 수 있습니다.
-d 옵션이 제공되지 않으면 SnapRAID는 작업이 전체 어레이에 적용된다고 가정하며, 이 경우
`check` 와 `fix` 는 라이브 파일시스템만을 독점적으로 사용합니다.
다른 모든 명령어는 라이브 파일시스템에서만 독점적으로 작동합니다.
스냅샷 수명 주기
SnapRAID는 각 데이터 하위 볼륨의 루트에 있는 숨겨진 디렉터리 내에서
`stable`(안정)과 `pending`(보류)이라는 두 가지 특정 스냅샷을 관리합니다.
Btrfs, Bcachefs 및 NTFS에서는 `.snapraid/` 디렉터리가 사용되며,
ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다.
`stable` 스냅샷은 성공적으로 완료된 마지막 `sync` 상태를 나타내며,
현재 파리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는
`scrub`, `check` 및 `fix` 명령어의 기본 데이터 소스 역할을 합니다.
`pending` 스냅샷은 파리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시
생성되는 임시 이미지입니다.
작업이 성공적으로 완료되면 이전의 `stable` 스냅샷은 삭제되고, `pending` 스냅샷이
새로운 안정적인 참조로 자리를 잡도록 승격됩니다.
`sync` 가 중단되면 `pending` 스냅샷은 보존됩니다.
파리티가 부분적으로만 동기화되었더라도 .content 파일에 기록된 파일시스템 상태와 일치하므로
이후의 `scrub`, `check` 및 `fix` 명령어는 이 보류 중인 스냅샷을 사용합니다.
`sync` 가 중단된 경우, `check` 및 `fix` 명령어는 `stable` 스냅샷에서도 읽어와
동기화 중에 업데이트되거나 삭제된 파일에서 데이터 블록을 검색합니다.
이는 동기화 프로세스 전반에 걸쳐 .content 파일이 수정되거나 삭제된 모든 파일의
메타데이터를 유지하기 때문에 가능합니다.
이 기록 정보는 동기화가 성공적으로 완료되고 .content 파일의 최종 버전이 저장되어야만 삭제됩니다.
중단 후 `sync` 가 재시작되면 기존의 보류 중인(pending) 스냅샷은 삭제되고,
라이브 파일시스템의 현재 상태를 캡처하기 위해 새 스냅샷이 생성됩니다.
Pattern
패턴은 포함하거나 제외할 파일을 필터링하는 유연한 방법을 제공합니다.
글로빙(globbing) 문자를 사용하면 모든 경로를 일일이 나열하지 않고도

View file

@ -58,22 +58,31 @@ SnapRAID는 디스크 어레이를 위해 설계된 백업 프로그램으로,
https://www.snapraid.it/
3 LIMITATIONS
=============
3 제한 사항
=======
SnapRAID는 RAID와 백업 프로그램의 하이브리드로, 두 가지의 장점을
결합하는 것을 목표로 합니다. 하지만, 사용 전에 고려해야 할 몇 가지
제한 사항이 있습니다.
SnapRAID는 RAID와 백업 프로그램의 하이브리드로, 두 가지의 장점을 결합하는 것을
목표로 합니다. 그러나 사용하기 전에 고려해야 할 몇 가지 제한 사항이 있습니다.
주요 제한 사항은 디스크가 실패하고 최근에 동기화(sync)하지 않은 경우,
완전히 복구하지 못할 수 있다는 것입니다.
더 구체적으로, 마지막 동기화 작업 이후 변경되거나 삭제된 파일의
크기만큼 복구가 불가능할 수 있습니다.
이는 변경되거나 삭제된 파일이 실패한 디스크에 있지 않더라도 발생합니다.
이것이 SnapRAID가 **거의 변경되지 않는 데이터**에 더 적합한 이유입니다.
가장 큰 제한 사항은 디스크가 고장 날 경우, 마지막 `sync`(동기화) 작업의 상태까지만
데이터를 복구할 수 있다는 점입니다. 마지막 동기화 이후에 추가되거나 수정된 데이터 중
고장 난 디스크에 위치한 데이터는 모두 손실됩니다.
반면에, 새로 추가된 파일은 이미 존재하는 파일의 복구를 방해하지 않습니다.
새로 추가된 파일이 실패한 디스크에 있는 경우에만 해당 파일을 잃게 됩니다.
따라서 SnapRAID는 주로 데이터 변경이 거의 없는 환경에 적합합니다.
마지막 동기화 시점에 이미 존재했던 데이터의 경우, 복구 신뢰성은 `snapshot`(스냅샷)
옵션의 사용 여부에 따라 달라집니다.
* 스냅샷 지원이 있는 경우 (Btrfs, ZFS, Bcachefs 및 NTFS에서 사용 가능):
SnapRAID는 데이터 디스크의 동결된 참조를 자동으로 유지할 수 있습니다.
이를 통해 동기화 중이나 동기화 후에 라이브 파일시스템의 파일을 수정하거나 삭제하더라도
복구 프로세스가 일관되고 신뢰할 수 있게 유지됩니다.
* 스냅샷 지원이 없는 경우:
`sync` 후에 파일을 삭제하거나 변경하면 다른 고장 난 디스크의 완전한 복구가 방해받을 수
있습니다. 이는 수정된 파일이 고장 난 디스크에 없더라도 파리티가 수정된 파일과
더 이상 일치하지 않기 때문에 발생합니다. 반면에 새로 추가된 파일은 이미 존재하는
파일의 복구를 방해하지 않습니다.
기타 SnapRAID 제한 사항은 다음과 같습니다:
@ -398,18 +407,18 @@ fix.log 파일을 저장할 몇 기가바이트의 여유 공간이 있는지
모든 것이 복구되면 이 명령은 즉시 완료됩니다.
5 COMMANDS
==========
5 명령어
=====
SnapRAID는 다음을 허용하는 몇 가지 간단한 명령을 제공합니다:
SnapRAID는 다음과 같은 작업을 수행할 수 있는 몇 가지 간단한 명령어를 제공합니다.
* 어레이의 상태 출력 -> `status`
* 디스크 제어 -> `smart`, `probe`, `up`, `down`
* 백업/스냅샷 생성 -> `sync`
* 주기적으로 데이터 확인 -> `scrub`
* 마지막 백업/스냅샷 복원 -> `fix`.
* 백업/복구 지점 생성 -> `sync`
* 주기적인 데이터 검사 -> `scrub`
* 마지막 백업/복구 지점 복원 -> `fix`
명령은 소문자로 작성해야 합니다.
명령어는 반드시 소문자로 작성해야 합니다.
5.1 status
----------
@ -620,14 +629,14 @@ bad 블록만 스크럽하려면 `scrub -p bad` 명령을 사용할 수 있습
5.9 fix
-------
모든 파일과 패리티 데이터를 수정합니다.
모든 파일과 파리티 데이터를 복구(수정)합니다.
모든 파일과 패리티 데이터는 마지막 `sync`에 저장된 스냅샷
상태와 비교됩니다.
차이가 발견되면 저장된 스냅샷으로 되돌려집니다.
모든 파일과 파리티 데이터는 마지막 `sync`에 저장된 상태와 비교됩니다.
차이점이 발견되면 저장된 상태로 되돌립니다.
**경고!** `fix` 명령은 오류와 의도적인 수정 사이를 구별하지
않습니다. 파일 상태를 무조건 마지막 `sync`로 되돌립니다.
경고!
`fix` 명령어는 오류와 의도적인 수정을 구별하지 않습니다.
파일 상태를 조건 없이 마지막 `sync` 상태로 되돌립니다.
다른 옵션이 지정되지 않으면 전체 어레이가 처리됩니다.
필터 옵션을 사용하여 처리할 파일 또는 디스크의 하위 집합을 선택하십시오.
@ -1181,14 +1190,38 @@ NAME을 고정된 상태로 유지하는 한, 필요에 따라 마운트 지점
이러한 디스크는 항상 회전할 것으로 예상되므로 `up` 및 `down` 명령의
영향을 받지 않습니다.
7.7 nohidden
7.7 snapshot
------------
`sync`, `scrub`, `check` 및 `fix` 명령어에 파일시스템 스냅샷 사용을
활성화합니다.
활성화되면 SnapRAID는 `sync` 시작 시 데이터의 읽기 전용 스냅샷을 생성합니다.
이는 파일의 일관된 특정 시점 뷰를 보장하여 동시 파일 수정으로 인해 발생하는
오류를 방지합니다.
이는 복구 성능을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도
스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 파리티가 "깨지는" 것을 방지하여,
다른 디스크가 고장 나더라도 데이터를 성공적으로 복구할 수 있도록 보장합니다.
이 옵션은 Linux의 Btrfs, Bcachefs 또는 ZFS 파일시스템과 Windows의 NTFS로 포맷된
데이터 디스크에만 독점적으로 적용됩니다.
파리티 디스크나 다른 파일시스템을 사용하는 데이터 디스크는 항상 파일시스템의
라이브 버전을 사용합니다.
스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다.
이 옵션이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오.
스냅샷 수명 주기에 대한 자세한 설명은 SNAPSHOTS 섹션을 참조하십시오.
7.8 nohidden
------------
모든 숨겨진 파일 및 디렉토리를 제외합니다.
Unix에서는 숨겨진 파일은 '.'으로 시작하는 파일입니다.
Windows에서는 숨김 속성을 가진 파일입니다.
7.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
sync 프로세스에서 제외하거나 포함할 파일 또는 디렉토리 패턴을
@ -1204,8 +1237,8 @@ sync 프로세스에서 제외하거나 포함할 파일 또는 디렉토리 패
이 옵션은 여러 번 사용될 수 있습니다.
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
패리티의 기본 블록 크기를 키비바이트(kibibyte) 단위로 정의합니다.
1키비바이트는 1024바이트입니다.
@ -1252,7 +1285,7 @@ Linux에서 더 큰 패리티 파티션을 얻는 트릭은 다음 명령으로
낭비되는 공간 없이 각 데이터 디스크에 약 460,000개의 파일을
허용합니다.
7.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
저장된 블록의 해시 크기를 바이트 단위로 정의합니다.
@ -1289,14 +1322,14 @@ RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
지정된 GB 양이 처리된 후 동기화 또는 스크럽 시 상태를 자동으로 저장합니다.
이 옵션은 기계 충돌 또는 기타 이벤트로 인해 중단된 경우 긴 `sync`
명령을 처음부터 다시 시작하는 것을 방지하는 데 유용합니다.
7.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
허용되는 최대 디스크 온도를 섭씨로 설정합니다. 지정되면 SnapRAID는
@ -1324,13 +1357,13 @@ SnapRAID가 작동하는 동안 현재 디스크 온도가 표시됩니다.
일반적으로 SnapRAID는 가장 뜨거운 디스크의 온도만 표시합니다.
모든 디스크의 온도를 표시하려면 -A 또는 --stats 옵션을 사용하십시오.
7.13 temp_sleep TIME_IN_MINUTES
7.14 temp_sleep TIME_IN_MINUTES
-------------------------------
온도 제한에 도달했을 때의 대기 시간(분)을 설정합니다. 이 기간 동안
디스크는 회전 중지 상태를 유지합니다. 기본값은 5분입니다.
7.14 pool DIR
7.15 pool DIR
-------------
`pool` 명령을 사용하여 디스크 어레이의 가상 뷰가 생성되는 풀링
@ -1338,7 +1371,7 @@ SnapRAID가 작동하는 동안 현재 디스크 온도가 표시됩니다.
디렉토리는 이미 존재해야 합니다.
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
디스크에 원격으로 액세스하는 데 필요한 Windows UNC 경로를 정의합니다.
@ -1354,7 +1387,7 @@ SnapRAID가 작동하는 동안 현재 디스크 온도가 표시됩니다.
이 옵션은 Windows에만 필요합니다.
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
각 디스크에 대한 SMART 속성을 얻기 위한 사용자 정의 smartctl 옵션을
@ -1379,7 +1412,7 @@ RAID 컨트롤러의 경우 장치가 고정되어 있을 가능성이 높으므
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
디스크 실패 확률을 계산할 때 지정된 SMART 속성을 무시합니다.
@ -1400,7 +1433,7 @@ PARITY는 `parity`, `2-parity`, `3-parity`, `4-parity`, `5-parity`,
smartignore parity 197
7.18 Examples
7.19 Examples
-------------
Unix의 일반적인 설정 예는 다음과 같습니다:
@ -1435,8 +1468,104 @@ Windows의 일반적인 설정 예는 다음과 같습니다:
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 PATTERN
=========
8 SNAPSHOTS (스냅샷)
=================
구성에서 스냅샷 옵션이 활성화된 경우, SnapRAID는 원자적이고
일관된 작업을 보장하기 위해 파일시스템 스냅샷 기능을 이용합니다.
스냅샷 관리는 완전히 자동적이고 투명하게 이루어집니다.
백그라운드에서 완전히 처리되는 스냅샷의 추가적인 보호와 함께,
기존과 완전히 동일하게 SnapRAID를 계속 사용할 수 있습니다.
이것은 두 가지 주요 이점을 제공합니다.
일관성 - 장시간 실행되는 sync 또는 scrub 중에 라이브 파일시스템에서 수정된 파일은
SnapRAID가 동결된 시점의 이미지를 보기 때문에 파리티 불일치나 작업 중단을
유발하지 않습니다.
복구 - 라이브 파일시스템에서 파일이 업데이트되거나 삭제되더라도 스냅샷에 보존됩니다.
다음 sync가 실행되기 전에 디스크 고장이 발생하면, SnapRAID는 스냅샷에 보존된
데이터를 사용하여 고장 난 디스크를 재구성합니다.
활성 sync 프로세스 중에 디스크 고장이 발생하는 경우,
SnapRAID는 이전 파리티 계산의 스냅샷과 현재 스냅샷 모두에서 자동으로 읽을 수도 있습니다.
이는 동기화 사이에 블록이 수정되거나 삭제되었더라도 파리티 방정식을 푸는 데
필요한 정확한 데이터 블록에 대한 접근을 제공함으로써 완전한 복구 확률을 최대화합니다.
스냅샷이 없으면 정상 디스크에서 업데이트되거나 삭제된 파일로 인해 데이터 블록이 누락되며,
이는 다른 고장 난 디스크를 복구하는 데 필요할 수 있습니다.
스냅샷은 데이터 디스크에 대해서만 생성되며, 기본 파일시스템이 이 기능을 지원하는 경우에만
생성됩니다. 파리티 디스크는 항상 라이브 파일시스템을 사용합니다.
현재 이는 Linux의 Btrfs, Bcachefs, ZFS 및 Windows의 NTFS에서 지원됩니다.
서로 다른 파일시스템을 가진 데이터 디스크를 혼합할 수 있습니다. 스냅샷을 지원하는 디스크만
이를 활용하고, 다른 디스크는 라이브 파일시스템에서 직접 계속 작동합니다.
스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다.
스냅샷이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오.
8.1 스냅샷 사용 시 명령어 동작
-------------------
`sync` 와 `scrub` 명령어는 모두 일관되고 동결된 상태에 대해 모든 데이터 작업이 수행되도록
보장하기 위해 스냅샷에서만 독점적으로 작동합니다. 이러한 스냅샷을 이용함으로써 SnapRAID는
라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 파리티 불일치를 방지합니다.
`sync` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 파리티 계산을 위한
현재 상태를 캡처합니다.
반면에 `scrub` 명령어는 기존 파리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해
가장 최근 동기화 중에 생성된 마지막 스냅샷을 이용합니다.
`check` 및 `fix` 명령어의 경우, 마지막 스냅샷의 사용 여부는
-d, --filter-disk 옵션을 사용하여 특정 디스크를 대상으로 지정하는지 여부에 따라 달라집니다.
-d를 통해 명시적으로 선택된 디스크(작업의 "대상")는 항상 라이브 파일시스템을 사용합니다.
`fix` 의 경우 이를 통해 활성 교체 디스크에 데이터를 복원할 수 있습니다.
`check` 의 경우 동일한 조건에서 `fix` 작업을 시뮬레이션할 수 있습니다.
다른 모든 데이터 디스크("참조" 디스크)는 해당 스냅샷을 통해 액세스됩니다.
이를 통해 복구가 진행되는 동안 정상 디스크의 파일을 수정하고 있더라도 SnapRAID가
파리티 방정식을 풀기 위한 안정적이고 동결된 참조를 가질 수 있습니다.
-d 옵션이 제공되지 않으면 SnapRAID는 작업이 전체 어레이에 적용된다고 가정하며, 이 경우
`check` 와 `fix` 는 라이브 파일시스템만을 독점적으로 사용합니다.
다른 모든 명령어는 라이브 파일시스템에서만 독점적으로 작동합니다.
9 스냅샷 수명 주기
===========
SnapRAID는 각 데이터 하위 볼륨의 루트에 있는 숨겨진 디렉터리 내에서
`stable`(안정)과 `pending`(보류)이라는 두 가지 특정 스냅샷을 관리합니다.
Btrfs, Bcachefs 및 NTFS에서는 `.snapraid/` 디렉터리가 사용되며,
ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다.
`stable` 스냅샷은 성공적으로 완료된 마지막 `sync` 상태를 나타내며,
현재 파리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는
`scrub`, `check` 및 `fix` 명령어의 기본 데이터 소스 역할을 합니다.
`pending` 스냅샷은 파리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시
생성되는 임시 이미지입니다.
작업이 성공적으로 완료되면 이전의 `stable` 스냅샷은 삭제되고, `pending` 스냅샷이
새로운 안정적인 참조로 자리를 잡도록 승격됩니다.
`sync` 가 중단되면 `pending` 스냅샷은 보존됩니다.
파리티가 부분적으로만 동기화되었더라도 .content 파일에 기록된 파일시스템 상태와 일치하므로
이후의 `scrub`, `check` 및 `fix` 명령어는 이 보류 중인 스냅샷을 사용합니다.
`sync` 가 중단된 경우, `check` 및 `fix` 명령어는 `stable` 스냅샷에서도 읽어와
동기화 중에 업데이트되거나 삭제된 파일에서 데이터 블록을 검색합니다.
이는 동기화 프로세스 전반에 걸쳐 .content 파일이 수정되거나 삭제된 모든 파일의
메타데이터를 유지하기 때문에 가능합니다.
이 기록 정보는 동기화가 성공적으로 완료되고 .content 파일의 최종 버전이 저장되어야만 삭제됩니다.
중단 후 `sync` 가 재시작되면 기존의 보류 중인(pending) 스냅샷은 삭제되고,
라이브 파일시스템의 현재 상태를 캡처하기 위해 새 스냅샷이 생성됩니다.
10 PATTERN
==========
패턴은 포함하거나 제외할 파일을 필터링하는 유연한 방법을 제공합니다.
글로빙(globbing) 문자를 사용하면 모든 경로를 일일이 나열하지 않고도
@ -1551,8 +1680,8 @@ Unix에서는 명령줄에서 글로빙 문자를 사용할 때 셸이 확장하
방지하기 위해 따옴표로 묶어야 합니다.
9 IGNORE FILE
=============
11 IGNORE FILE
==============
설정 파일의 전역 규칙 외에도, 배열 내의 모든 디렉토리에 `.snapraidignore`
파일을 배치하여 분산된 제외 규칙을 정의할 수 있습니다.
@ -1594,7 +1723,7 @@ Unix에서는 명령줄에서 글로빙 문자를 사용할 때 셸이 확장하
*.tmp
10 CONTENT
12 CONTENT
==========
SnapRAID는 content 파일에 파일 목록과 체크섬을 저장합니다.
@ -1606,7 +1735,7 @@ SnapRAID는 content 파일에 파일 목록과 체크섬을 저장합니다.
`fix`, `check`, 및 `status` 명령에 의해 읽혀집니다.
11 PARITY
13 PARITY
=========
SnapRAID는 패리티 파일에 어레이의 패리티 정보를 저장합니다.
@ -1618,7 +1747,7 @@ SnapRAID는 패리티 파일에 어레이의 패리티 정보를 저장합니다
`scrub` 및 `check` 명령에 의해서만 읽혀집니다.
12 ENCODING
14 ENCODING
===========
Unix의 SnapRAID는 인코딩을 무시합니다. 파일 시스템에서 사용되는
@ -1634,13 +1763,13 @@ Windows 콘솔을 UTF-8 모드로 설정하고 콘솔 글꼴로 `Lucida Console`
리디렉션하는 경우 결과 파일은 항상 UTF-8 형식입니다.
13 COPYRIGHT
15 COPYRIGHT
============
This file is Copyright (C) 2025 Andrea Mazzoleni
14 SEE ALSO
16 SEE ALSO
===========
snapraid_log(1), snapraidd(1)

View file

@ -116,22 +116,34 @@ https://www.snapraid.it/
.PD 0
.PD
.RE
.SH LIMITATIONS
SnapRAID to hybryda programu RAID i programu do tworzenia kopii zapasowych,
której celem jest połączenie najlepszych zalet obu. Ma jednak pewne
ograniczenia, które należy wziąć pod uwagę przed jego użyciem.
.SH OGRANICZENIA
SnapRAID jest hybrydą pomiędzy RAID a programem do tworzenia kopii zapasowych, mającą na celu połączenie
najlepszych zalet obu tych rozwiązań. Posiada jednak pewne ograniczenia, które należy
wziąć pod uwagę przed jego użyciem.
.PP
Głównym ograniczeniem jest to, że jeśli dysk ulegnie awarii, a Ty nie wykonałeś
niedawno synchronizacji, możesz nie być w stanie w pełni odzyskać danych.
Dokładniej, możesz nie być w stanie odzyskać danych o wielkości
zmienionych lub usuniętych plików od czasu ostatniej operacji synchronizacji.
Dzieje się tak, nawet jeśli zmienione lub usunięte pliki nie znajdują się na
uszkodzonym dysku. Dlatego SnapRAID jest lepiej dostosowany do
danych, które rzadko się zmieniają.
Głównym ograniczeniem jest to, że w przypadku awarii dysku można odzyskać dane tylko do
stanu z momentu ostatniej operacji \`sync\` (synchronizacji). Wszelkie dane dodane lub modyfikacje dokonane
od ostatniej synchronizacji, które znajdują się na uszkodzonym dysku, zostaną utracone.
.PP
Z drugiej strony, nowo dodane pliki nie uniemożliwiają odzyskania już
istniejących plików. Stracisz tylko ostatnio dodane pliki, jeśli
znajdują się one na uszkodzonym dysku.
W związku z tym SnapRAID nadaje się głównie do danych, które rzadko się zmieniają.
.PP
W przypadku danych, które już istniały podczas ostatniej synchronizacji, niezawodność odzyskiwania zależy
od tego, czy użyto opcji \`snapshot\` (migawki):
.PD 0
.IP \(bu
Z obsługą migawek (dostępną w systemach plików Btrfs, ZFS, Bcachefs i NTFS),
SnapRAID może automatycznie utrzymywać zamrożony stan dysków z danymi.
Zapewnia to, że nawet jeśli zmodyfikujesz lub usuniesz pliki w aktywnym systemie plików
w trakcie lub po synchronizacji, proces odzyskiwania pozostanie spójny i niezawodny.
.PD
.PD 0
.IP \(bu
Bez obsługi migawek, usunięcie lub zmiana plików po operacji \`sync\`
może uniemożliwić pełne odzyskanie danych z innych uszkodzonych dysków. Dzieje się tak,
ponieważ parzystość nie odpowiada już zmodyfikowanym plikom, nawet jeśli
pliki te nie znajdują się na uszkodzonym dysku. Z drugiej strony, nowo dodane
pliki nie uniemożliwiają odzyskania już istniejących plików.
.PD
.PP
Inne ograniczenia SnapRAID to:
.PD 0
@ -643,22 +655,22 @@ snapraid sync
.RE
.PP
Jeśli wszystko zostanie odzyskane, to polecenie jest natychmiastowe.
.SH COMMANDS
.SH POLECENIA
SnapRAID udostępnia kilka prostych poleceń, które pozwalają na:
.PD 0
.IP \(bu
Wyświetlenie statusu macierzy \-> \`status\`
Wyświetlenie stanu macierzy \-> \`status\`
.IP \(bu
Kontrolę dysków \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
Wykonanie kopii zapasowej/migawki \-> \`sync\`
Utworzenie punktu kopii zapasowej/przywracania \-> \`sync\`
.IP \(bu
Okresowe sprawdzanie danych \-> \`scrub\`
.IP \(bu
Przywrócenie ostatniej kopii zapasowej/migawki \-> \`fix\`.
Przywrócenie ostatniego punktu kopii zapasowej/przywracania \-> \`fix\`.
.PD
.PP
Polecenia muszą być zapisane małymi literami.
Polecenia muszą być wpisywane małymi literami.
.SS status
Wyświetla podsumowanie stanu macierzy dysków.
.PP
@ -884,15 +896,14 @@ dla każdego bloku i oznaczenia złych bloków.
Pliki \`parity\` NIE są modyfikowane.
Pliki w macierzy NIE są modyfikowane.
.SS fix
Naprawia wszystkie pliki i dane parzystości.
Naprawia wszystkie pliki oraz dane parzystości.
.PP
Wszystkie pliki i dane parzystości są porównywane ze stanem migawki
zapisanym w ostatniej \`sync\`.
Jeśli zostanie znaleziona różnica, jest ona przywracana do zapisanego stanu migawki.
Wszystkie pliki i dane parzystości są porównywane ze stanem zapisanym podczas
ostatniej operacji \`sync\`. W przypadku znalezienia różnicy, następuje przywrócenie stanu zapisanego.
.PP
OSTRZEŻENIE! Polecenie \`fix\` nie rozróżnia błędów od
celowych modyfikacji. Bezwarunkowo przywraca stan pliku
do ostatniej \`sync\`.
UWAGA!
Polecenie \`fix\` nie odróżnia błędów od celowych modyfikacji.
Bezwzględnie przywraca stan plików do momentu ostatniej operacji \`sync\`.
.PP
Jeśli nie określono żadnej innej opcji, przetwarzana jest cała macierz.
Użyj opcji filtra, aby wybrać podzbiór plików lub dysków do operacji.
@ -1426,6 +1437,29 @@ dysk rozruchowy.
.PP
Należy zauważyć, że polecenia \`up\` i \`down\` nie mają wpływu na takie
dyski, ponieważ oczekuje się, że będą one zawsze w ruchu.
.SS snapshot
Włącza używanie migawek systemu plików dla poleceń \`sync\`, \`scrub\`,
\`check\` oraz \`fix\`.
.PP
Po włączeniu, SnapRAID tworzy migawkę danych w trybie tylko do odczytu na
początku operacji \'sync\'. Zapewnia to spójny obraz plików z danego momentu,
zapobiegając błędom wywołanym przez jednoczesne modyfikacje plików.
.PP
To znacznie usprawnia odzyskiwanie danych: jeśli plik zostanie usunięty z aktywnego systemu
plików, pozostaje zachowany w migawce. Zapobiega to sytuacji, w której parzystość staje się \[dq]uszkodzona\[dq]
dla tego bloku, zapewniając możliwość pomyślnego odzyskania danych,
jeśli ulegnie awarii inny dysk.
.PP
Opcja ta dotyczy wyłącznie dysków z danymi sformatowanych w systemach plików
Btrfs, Bcachefs lub ZFS w systemie Linux oraz NTFS w systemie Windows.
Dyski parzystości lub dyski z danymi korzystające z innych systemów plików będą zawsze używać
aktywnej wersji systemu plików.
.PP
Tworzenie i usuwanie migawek wymaga uprawnień administratora.
Upewnij się, że SnapRAID jest uruchamiany z wymaganymi uprawnieniami (np. sudo), gdy
opcja ta jest włączona.
.PP
Szczegółowe wyjaśnienie cyklu życia migawek znajduje się w sekcji SNAPSHOTS.
.SS nohidden
Wyklucza wszystkie ukryte pliki i katalogi.
W systemie Unix ukryte pliki to te zaczynające się od \`.\`.
@ -1757,6 +1791,127 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS (MIGAWKI)
Jeśli opcja snapshot jest włączona w konfiguracji, SnapRAID
wykorzystuje funkcjonalność migawek systemu plików w celu zapewnienia operacji atomowych
i spójnych.
.PP
Zarządzanie migawkami jest całkowicie automatyczne i przejrzyste.
Możesz nadal używać SnapRAID dokładnie tak jak dotychczas, z dodatkową
ochroną zapewnianą przez migawki, która jest realizowana w całości w
tle.
.PP
Zapewnia to dwie główne korzyści:
.RS 0
.PD 0
.HP 4
.I Spójność
Pliki zmodyfikowane w aktywnym systemie plików podczas długotrwałej
operacji sync lub scrub nie spowodują niezgodności parzystości ani przerwania
operacji, ponieważ SnapRAID widzi zamrożony obraz z danego momentu.
.HP 4
.I Odzyskiwanie
Jeśli plik zostanie zaktualizowany lub usunięty z aktywnego systemu plików,
pozostaje zachowany w migawce. Jeśli awaria dysku nastąpi
przed uruchomieniem kolejnej operacji sync, SnapRAID użyje danych zachowanych
w migawce do odbudowania uszkodzonego dysku.
.PD
.PP
.RS 4
.PD 0
W przypadku awarii dysku podczas aktywnego procesu sync,
SnapRAID jest również w stanie automatycznie czytać zarówno z migawki
poprzedniego obliczenia parzystości, jak i z bieżącej.
Maksymalizuje to prawdopodobieństwo pełnego odzyskania danych poprzez
zapewnienie dostępu do dokładnych bloków danych wymaganych do rozwiązania
równań parzystości, nawet jeśli bloki te zostały zmodyfikowane
lub usunięte pomiędzy operacjami sync.
.PD
.PP
.PD 0
Bez migawek, zaktualizowany lub usunięty plik na sprawnym dysku
skutkuje brakiem bloków danych, które mogą być wymagane do
naprawy innych uszkodzonych dysków.
.PD
.RE
.RE
.PP
Migawki są tworzone tylko dla dysków z danymi i tylko wtedy, gdy bazowy
system plików obsługuje tę funkcjonalność. Dyski parzystości zawsze używają
aktywnego systemu plików.
Obecnie jest to obsługiwane w systemach Btrfs, Bcachefs i ZFS w systemie Linux
oraz NTFS w systemie Windows.
.PP
Można mieszać dyski z danymi o różnych systemach plików. Tylko te, które
obsługują migawki, będą z nich korzystać, podczas gdy inne dyski będą nadal
działać bezpośrednio na aktywnym systemie plików.
.PP
Tworzenie i usuwanie migawek wymaga uprawnień administratora.
Upewnij się, że SnapRAID jest uruchamiany z wymaganymi uprawnieniami (np. sudo),
gdy migawki są włączone.
.SS Zachowanie poleceń przy użyciu migawek
Polecenia \`sync\` oraz \`scrub\` działają wyłącznie na migawkach,
aby zapewnić, że wszystkie operacje na danych są wykonywane na spójnym,
zamrożonym stanie. Poprzez wykorzystanie tych migawek, SnapRAID zapobiega niezgodnościom
parzystości, które w przeciwnym razie zostałyby wywołane przez jednoczesne modyfikacje plików w aktywnym systemie plików.
Podczas operacji \`sync\` polecenie używa nowej migawki utworzonej na
początku procesu, aby uchwycić bieżący stan do obliczenia parzystości.
W przeciwieństwie do tego, polecenie \`scrub\` wykorzystuje ostatnią migawkę, tę
utworzoną podczas najnowszej synchronizacji, aby utrzymać wiarygodny punkt odniesienia
odpowiadający istniejącej parzystości.
.PP
W przypadku poleceń \`check\` oraz \`fix\`, użycie ostatniej migawki
zależy od tego, czy konkretne dyski są wskazywane za pomocą opcji
\-d, \-\-filter\-disk.
.PP
Dysk jawnie wybrany za pomocą opcji \-d (\[dq]cel\[dq] operacji)
zawsze używa aktywnego systemu plików. Dla \`fix\` pozwala to na przywrócenie
danych na aktywny dysk zamienny. Dla \`check\` pozwala to na symulację
operacji \`fix\` w tych samych warunkach.
.PP
Wszystkie inne dyski z danymi (dyski \[dq]referencyjne\[dq]) będą dostępne za pośrednictwem
swoich migawek. Zapewnia to, że nawet jeśli modyfikujesz pliki
na sprawnych dyskach podczas trwania odzyskiwania danych, SnapRAID
posiada stabilny, zamrożony punkt odniesienia do rozwiązania równań parzystości.
.PP
Jeśli nie podano opcji \-d, SnapRAID zakłada, że operacja dotyczy
całej macierzy. W takim przypadku \`check\` oraz \`fix\` będą używać wyłącznie
aktywnych systemów plików.
.PP
Wszystkie inne polecenia działają wyłącznie na aktywnym systemie plików.
.SH CYKL żYCIA MIGAWEK
SnapRAID zarządza dwoma określonymi migawkami, \`stable\` (stabilną) oraz \`pending\` (oczekującą),
w ukrytym katalogu w katalogu głównym każdego podwolumenu danych.
W systemach Btrfs, Bcachefs i NTFS używany jest katalog \`.snapraid/\`,
w systemie ZFS standardowy \`.zfs/snapshot/\`.
.PP
Migawka \`stable\` reprezentuje stan ostatniej
pomyślnie zakończonej operacji \`sync\`, zawierając dokładne dane użyte do
obliczenia bieżącej parzystości. Służy ona jako główne źródło danych
dla poleceń \`scrub\`, \`check\` i \`fix\`.
.PP
Migawka \`pending\` to tymczasowy obraz tworzony na początku
operacji \`sync\` w celu zapewnienia zamrożonego stanu do obliczenia parzystości.
Po pomyślnym zakończeniu operacji poprzednia migawka \`stable\`
jest usuwana, a migawka \`pending\` zostaje podniesiona do rangi
nowej stabilnej referencji.
.PP
Jeśli operacja \`sync\` zostanie przerwana, migawka \`pending\` zostaje zachowana.
Kolejne polecenia \`scrub\`, \`check\` i \`fix\` będą używać tej oczekującej migawki,
ponieważ odpowiada ona stanowi systemu plików zapisanemu w pliku .content,
nawet jeśli parzystość jest zsynchronizowana tylko częściowo.
.PP
W przypadku przerwania operacji \`sync\`, polecenia \`check\` i \`fix\`
odczytują dane również z migawki \`stable\`, aby pobrać bloki danych
z plików, które zostały zaktualizowane lub usunięte podczas synchronizacji.
Jest to możliwe, ponieważ plik .content zachowuje metadane dla
wszystkich zmodyfikowanych lub usuniętych plików przez cały proces sync.
Te informacje historyczne są czyszczone dopiero po pomyślnym zakończeniu operacji sync
i zapisaniu ostatecznej wersji pliku .content.
.PP
Jeśli operacja \`sync\` zostanie zrestartowana po przerwaniu, istniejąca
oczekująca (pending) migawka jest usuwana, a tworzona jest nowa, aby
uchwycić bieżący stan aktywnego systemu plików.
.SH PATTERN
Wzorce zapewniają elastyczny sposób filtrowania plików do uwzględnienia lub
wykluczenia. Używając znaków globbingowych, można zdefiniować reguły, które

View file

@ -50,22 +50,30 @@ Description
:https://www.snapraid.it/
Limitations
SnapRAID to hybryda programu RAID i programu do tworzenia kopii zapasowych,
której celem jest połączenie najlepszych zalet obu. Ma jednak pewne
ograniczenia, które należy wziąć pod uwagę przed jego użyciem.
Ograniczenia
SnapRAID jest hybrydą pomiędzy RAID a programem do tworzenia kopii zapasowych, mającą na celu połączenie
najlepszych zalet obu tych rozwiązań. Posiada jednak pewne ograniczenia, które należy
wziąć pod uwagę przed jego użyciem.
Głównym ograniczeniem jest to, że jeśli dysk ulegnie awarii, a Ty nie wykonałeś
niedawno synchronizacji, możesz nie być w stanie w pełni odzyskać danych.
Dokładniej, możesz nie być w stanie odzyskać danych o wielkości
zmienionych lub usuniętych plików od czasu ostatniej operacji synchronizacji.
Dzieje się tak, nawet jeśli zmienione lub usunięte pliki nie znajdują się na
uszkodzonym dysku. Dlatego SnapRAID jest lepiej dostosowany do
danych, które rzadko się zmieniają.
Głównym ograniczeniem jest to, że w przypadku awarii dysku można odzyskać dane tylko do
stanu z momentu ostatniej operacji `sync` (synchronizacji). Wszelkie dane dodane lub modyfikacje dokonane
od ostatniej synchronizacji, które znajdują się na uszkodzonym dysku, zostaną utracone.
Z drugiej strony, nowo dodane pliki nie uniemożliwiają odzyskania już
istniejących plików. Stracisz tylko ostatnio dodane pliki, jeśli
znajdują się one na uszkodzonym dysku.
W związku z tym SnapRAID nadaje się głównie do danych, które rzadko się zmieniają.
W przypadku danych, które już istniały podczas ostatniej synchronizacji, niezawodność odzyskiwania zależy
od tego, czy użyto opcji `snapshot` (migawki):
* Z obsługą migawek (dostępną w systemach plików Btrfs, ZFS, Bcachefs i NTFS),
SnapRAID może automatycznie utrzymywać zamrożony stan dysków z danymi.
Zapewnia to, że nawet jeśli zmodyfikujesz lub usuniesz pliki w aktywnym systemie plików
w trakcie lub po synchronizacji, proces odzyskiwania pozostanie spójny i niezawodny.
* Bez obsługi migawek, usunięcie lub zmiana plików po operacji `sync`
może uniemożliwić pełne odzyskanie danych z innych uszkodzonych dysków. Dzieje się tak,
ponieważ parzystość nie odpowiada już zmodyfikowanym plikom, nawet jeśli
pliki te nie znajdują się na uszkodzonym dysku. Z drugiej strony, nowo dodane
pliki nie uniemożliwiają odzyskania już istniejących plików.
Inne ograniczenia SnapRAID to:
@ -383,16 +391,16 @@ Getting Started
Jeśli wszystko zostanie odzyskane, to polecenie jest natychmiastowe.
Commands
Polecenia
SnapRAID udostępnia kilka prostych poleceń, które pozwalają na:
* Wyświetlenie statusu macierzy -> `status`
* Wyświetlenie stanu macierzy -> `status`
* Kontrolę dysków -> `smart`, `probe`, `up`, `down`
* Wykonanie kopii zapasowej/migawki -> `sync`
* Utworzenie punktu kopii zapasowej/przywracania -> `sync`
* Okresowe sprawdzanie danych -> `scrub`
* Przywrócenie ostatniej kopii zapasowej/migawki -> `fix`.
* Przywrócenie ostatniego punktu kopii zapasowej/przywracania -> `fix`.
Polecenia muszą być zapisane małymi literami.
Polecenia muszą być wpisywane małymi literami.
status
Wyświetla podsumowanie stanu macierzy dysków.
@ -593,15 +601,14 @@ Commands
Pliki w macierzy NIE są modyfikowane.
fix
Naprawia wszystkie pliki i dane parzystości.
Naprawia wszystkie pliki oraz dane parzystości.
Wszystkie pliki i dane parzystości są porównywane ze stanem migawki
zapisanym w ostatniej `sync`.
Jeśli zostanie znaleziona różnica, jest ona przywracana do zapisanego stanu migawki.
Wszystkie pliki i dane parzystości są porównywane ze stanem zapisanym podczas
ostatniej operacji `sync`. W przypadku znalezienia różnicy, następuje przywrócenie stanu zapisanego.
OSTRZEŻENIE! Polecenie `fix` nie rozróżnia błędów od
celowych modyfikacji. Bezwarunkowo przywraca stan pliku
do ostatniej `sync`.
UWAGA!
Polecenie `fix` nie odróżnia błędów od celowych modyfikacji.
Bezwzględnie przywraca stan plików do momentu ostatniej operacji `sync`.
Jeśli nie określono żadnej innej opcji, przetwarzana jest cała macierz.
Użyj opcji filtra, aby wybrać podzbiór plików lub dysków do operacji.
@ -1146,6 +1153,30 @@ Configuration
Należy zauważyć, że polecenia `up` i `down` nie mają wpływu na takie
dyski, ponieważ oczekuje się, że będą one zawsze w ruchu.
snapshot
Włącza używanie migawek systemu plików dla poleceń `sync`, `scrub`,
`check` oraz `fix`.
Po włączeniu, SnapRAID tworzy migawkę danych w trybie tylko do odczytu na
początku operacji 'sync'. Zapewnia to spójny obraz plików z danego momentu,
zapobiegając błędom wywołanym przez jednoczesne modyfikacje plików.
To znacznie usprawnia odzyskiwanie danych: jeśli plik zostanie usunięty z aktywnego systemu
plików, pozostaje zachowany w migawce. Zapobiega to sytuacji, w której parzystość staje się "uszkodzona"
dla tego bloku, zapewniając możliwość pomyślnego odzyskania danych,
jeśli ulegnie awarii inny dysk.
Opcja ta dotyczy wyłącznie dysków z danymi sformatowanych w systemach plików
Btrfs, Bcachefs lub ZFS w systemie Linux oraz NTFS w systemie Windows.
Dyski parzystości lub dyski z danymi korzystające z innych systemów plików będą zawsze używać
aktywnej wersji systemu plików.
Tworzenie i usuwanie migawek wymaga uprawnień administratora.
Upewnij się, że SnapRAID jest uruchamiany z wymaganymi uprawnieniami (np. sudo), gdy
opcja ta jest włączona.
Szczegółowe wyjaśnienie cyklu życia migawek znajduje się w sekcji SNAPSHOTS.
nohidden
Wyklucza wszystkie ukryte pliki i katalogi.
W systemie Unix ukryte pliki to te zaczynające się od `.`.
@ -1381,6 +1412,117 @@ Configuration
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots (Migawki)
Jeśli opcja snapshot jest włączona w konfiguracji, SnapRAID
wykorzystuje funkcjonalność migawek systemu plików w celu zapewnienia operacji atomowych
i spójnych.
Zarządzanie migawkami jest całkowicie automatyczne i przejrzyste.
Możesz nadal używać SnapRAID dokładnie tak jak dotychczas, z dodatkową
ochroną zapewnianą przez migawki, która jest realizowana w całości w
tle.
Zapewnia to dwie główne korzyści:
Spójność - Pliki zmodyfikowane w aktywnym systemie plików podczas długotrwałej
operacji sync lub scrub nie spowodują niezgodności parzystości ani przerwania
operacji, ponieważ SnapRAID widzi zamrożony obraz z danego momentu.
Odzyskiwanie - Jeśli plik zostanie zaktualizowany lub usunięty z aktywnego systemu plików,
pozostaje zachowany w migawce. Jeśli awaria dysku nastąpi
przed uruchomieniem kolejnej operacji sync, SnapRAID użyje danych zachowanych
w migawce do odbudowania uszkodzonego dysku.
W przypadku awarii dysku podczas aktywnego procesu sync,
SnapRAID jest również w stanie automatycznie czytać zarówno z migawki
poprzedniego obliczenia parzystości, jak i z bieżącej.
Maksymalizuje to prawdopodobieństwo pełnego odzyskania danych poprzez
zapewnienie dostępu do dokładnych bloków danych wymaganych do rozwiązania
równań parzystości, nawet jeśli bloki te zostały zmodyfikowane
lub usunięte pomiędzy operacjami sync.
Bez migawek, zaktualizowany lub usunięty plik na sprawnym dysku
skutkuje brakiem bloków danych, które mogą być wymagane do
naprawy innych uszkodzonych dysków.
Migawki są tworzone tylko dla dysków z danymi i tylko wtedy, gdy bazowy
system plików obsługuje tę funkcjonalność. Dyski parzystości zawsze używają
aktywnego systemu plików.
Obecnie jest to obsługiwane w systemach Btrfs, Bcachefs i ZFS w systemie Linux
oraz NTFS w systemie Windows.
Można mieszać dyski z danymi o różnych systemach plików. Tylko te, które
obsługują migawki, będą z nich korzystać, podczas gdy inne dyski będą nadal
działać bezpośrednio na aktywnym systemie plików.
Tworzenie i usuwanie migawek wymaga uprawnień administratora.
Upewnij się, że SnapRAID jest uruchamiany z wymaganymi uprawnieniami (np. sudo),
gdy migawki są włączone.
Zachowanie poleceń przy użyciu migawek
Polecenia `sync` oraz `scrub` działają wyłącznie na migawkach,
aby zapewnić, że wszystkie operacje na danych są wykonywane na spójnym,
zamrożonym stanie. Poprzez wykorzystanie tych migawek, SnapRAID zapobiega niezgodnościom
parzystości, które w przeciwnym razie zostałyby wywołane przez jednoczesne modyfikacje plików w aktywnym systemie plików.
Podczas operacji `sync` polecenie używa nowej migawki utworzonej na
początku procesu, aby uchwycić bieżący stan do obliczenia parzystości.
W przeciwieństwie do tego, polecenie `scrub` wykorzystuje ostatnią migawkę, tę
utworzoną podczas najnowszej synchronizacji, aby utrzymać wiarygodny punkt odniesienia
odpowiadający istniejącej parzystości.
W przypadku poleceń `check` oraz `fix`, użycie ostatniej migawki
zależy od tego, czy konkretne dyski są wskazywane za pomocą opcji
-d, --filter-disk.
Dysk jawnie wybrany za pomocą opcji -d ("cel" operacji)
zawsze używa aktywnego systemu plików. Dla `fix` pozwala to na przywrócenie
danych na aktywny dysk zamienny. Dla `check` pozwala to na symulację
operacji `fix` w tych samych warunkach.
Wszystkie inne dyski z danymi (dyski "referencyjne") będą dostępne za pośrednictwem
swoich migawek. Zapewnia to, że nawet jeśli modyfikujesz pliki
na sprawnych dyskach podczas trwania odzyskiwania danych, SnapRAID
posiada stabilny, zamrożony punkt odniesienia do rozwiązania równań parzystości.
Jeśli nie podano opcji -d, SnapRAID zakłada, że operacja dotyczy
całej macierzy. W takim przypadku `check` oraz `fix` będą używać wyłącznie
aktywnych systemów plików.
Wszystkie inne polecenia działają wyłącznie na aktywnym systemie plików.
Cykl życia migawek
SnapRAID zarządza dwoma określonymi migawkami, `stable` (stabilną) oraz `pending` (oczekującą),
w ukrytym katalogu w katalogu głównym każdego podwolumenu danych.
W systemach Btrfs, Bcachefs i NTFS używany jest katalog `.snapraid/`,
w systemie ZFS standardowy `.zfs/snapshot/`.
Migawka `stable` reprezentuje stan ostatniej
pomyślnie zakończonej operacji `sync`, zawierając dokładne dane użyte do
obliczenia bieżącej parzystości. Służy ona jako główne źródło danych
dla poleceń `scrub`, `check` i `fix`.
Migawka `pending` to tymczasowy obraz tworzony na początku
operacji `sync` w celu zapewnienia zamrożonego stanu do obliczenia parzystości.
Po pomyślnym zakończeniu operacji poprzednia migawka `stable`
jest usuwana, a migawka `pending` zostaje podniesiona do rangi
nowej stabilnej referencji.
Jeśli operacja `sync` zostanie przerwana, migawka `pending` zostaje zachowana.
Kolejne polecenia `scrub`, `check` i `fix` będą używać tej oczekującej migawki,
ponieważ odpowiada ona stanowi systemu plików zapisanemu w pliku .content,
nawet jeśli parzystość jest zsynchronizowana tylko częściowo.
W przypadku przerwania operacji `sync`, polecenia `check` i `fix`
odczytują dane również z migawki `stable`, aby pobrać bloki danych
z plików, które zostały zaktualizowane lub usunięte podczas synchronizacji.
Jest to możliwe, ponieważ plik .content zachowuje metadane dla
wszystkich zmodyfikowanych lub usuniętych plików przez cały proces sync.
Te informacje historyczne są czyszczone dopiero po pomyślnym zakończeniu operacji sync
i zapisaniu ostatecznej wersji pliku .content.
Jeśli operacja `sync` zostanie zrestartowana po przerwaniu, istniejąca
oczekująca (pending) migawka jest usuwana, a tworzona jest nowa, aby
uchwycić bieżący stan aktywnego systemu plików.
Pattern
Wzorce zapewniają elastyczny sposób filtrowania plików do uwzględnienia lub
wykluczenia. Używając znaków globbingowych, można zdefiniować reguły, które

View file

@ -58,24 +58,32 @@ Więcej informacji można znaleźć na oficjalnej stronie SnapRAID:
https://www.snapraid.it/
3 LIMITATIONS
=============
3 OGRANICZENIA
==============
SnapRAID to hybryda programu RAID i programu do tworzenia kopii zapasowych,
której celem jest połączenie najlepszych zalet obu. Ma jednak pewne
ograniczenia, które należy wziąć pod uwagę przed jego użyciem.
SnapRAID jest hybrydą pomiędzy RAID a programem do tworzenia kopii zapasowych, mającą na celu połączenie
najlepszych zalet obu tych rozwiązań. Posiada jednak pewne ograniczenia, które należy
wziąć pod uwagę przed jego użyciem.
Głównym ograniczeniem jest to, że jeśli dysk ulegnie awarii, a Ty nie wykonałeś
niedawno synchronizacji, możesz nie być w stanie w pełni odzyskać danych.
Dokładniej, możesz nie być w stanie odzyskać danych o wielkości
zmienionych lub usuniętych plików od czasu ostatniej operacji synchronizacji.
Dzieje się tak, nawet jeśli zmienione lub usunięte pliki nie znajdują się na
uszkodzonym dysku. Dlatego SnapRAID jest lepiej dostosowany do
danych, które rzadko się zmieniają.
Głównym ograniczeniem jest to, że w przypadku awarii dysku można odzyskać dane tylko do
stanu z momentu ostatniej operacji `sync` (synchronizacji). Wszelkie dane dodane lub modyfikacje dokonane
od ostatniej synchronizacji, które znajdują się na uszkodzonym dysku, zostaną utracone.
Z drugiej strony, nowo dodane pliki nie uniemożliwiają odzyskania już
istniejących plików. Stracisz tylko ostatnio dodane pliki, jeśli
znajdują się one na uszkodzonym dysku.
W związku z tym SnapRAID nadaje się głównie do danych, które rzadko się zmieniają.
W przypadku danych, które już istniały podczas ostatniej synchronizacji, niezawodność odzyskiwania zależy
od tego, czy użyto opcji `snapshot` (migawki):
* Z obsługą migawek (dostępną w systemach plików Btrfs, ZFS, Bcachefs i NTFS),
SnapRAID może automatycznie utrzymywać zamrożony stan dysków z danymi.
Zapewnia to, że nawet jeśli zmodyfikujesz lub usuniesz pliki w aktywnym systemie plików
w trakcie lub po synchronizacji, proces odzyskiwania pozostanie spójny i niezawodny.
* Bez obsługi migawek, usunięcie lub zmiana plików po operacji `sync`
może uniemożliwić pełne odzyskanie danych z innych uszkodzonych dysków. Dzieje się tak,
ponieważ parzystość nie odpowiada już zmodyfikowanym plikom, nawet jeśli
pliki te nie znajdują się na uszkodzonym dysku. Z drugiej strony, nowo dodane
pliki nie uniemożliwiają odzyskania już istniejących plików.
Inne ograniczenia SnapRAID to:
@ -405,18 +413,18 @@ Uruchom polecenie `sync`, aby ponownie zsynchronizować macierz z nowym dyskiem.
Jeśli wszystko zostanie odzyskane, to polecenie jest natychmiastowe.
5 COMMANDS
==========
5 POLECENIA
===========
SnapRAID udostępnia kilka prostych poleceń, które pozwalają na:
* Wyświetlenie statusu macierzy -> `status`
* Wyświetlenie stanu macierzy -> `status`
* Kontrolę dysków -> `smart`, `probe`, `up`, `down`
* Wykonanie kopii zapasowej/migawki -> `sync`
* Utworzenie punktu kopii zapasowej/przywracania -> `sync`
* Okresowe sprawdzanie danych -> `scrub`
* Przywrócenie ostatniej kopii zapasowej/migawki -> `fix`.
* Przywrócenie ostatniego punktu kopii zapasowej/przywracania -> `fix`.
Polecenia muszą być zapisane małymi literami.
Polecenia muszą być wpisywane małymi literami.
5.1 status
----------
@ -635,15 +643,14 @@ Pliki w macierzy NIE są modyfikowane.
5.9 fix
-------
Naprawia wszystkie pliki i dane parzystości.
Naprawia wszystkie pliki oraz dane parzystości.
Wszystkie pliki i dane parzystości są porównywane ze stanem migawki
zapisanym w ostatniej `sync`.
Jeśli zostanie znaleziona różnica, jest ona przywracana do zapisanego stanu migawki.
Wszystkie pliki i dane parzystości są porównywane ze stanem zapisanym podczas
ostatniej operacji `sync`. W przypadku znalezienia różnicy, następuje przywrócenie stanu zapisanego.
OSTRZEŻENIE! Polecenie `fix` nie rozróżnia błędów od
celowych modyfikacji. Bezwarunkowo przywraca stan pliku
do ostatniej `sync`.
UWAGA!
Polecenie `fix` nie odróżnia błędów od celowych modyfikacji.
Bezwzględnie przywraca stan plików do momentu ostatniej operacji `sync`.
Jeśli nie określono żadnej innej opcji, przetwarzana jest cała macierz.
Użyj opcji filtra, aby wybrać podzbiór plików lub dysków do operacji.
@ -1222,14 +1229,40 @@ dysk rozruchowy.
Należy zauważyć, że polecenia `up` i `down` nie mają wpływu na takie
dyski, ponieważ oczekuje się, że będą one zawsze w ruchu.
7.7 nohidden
7.7 snapshot
------------
Włącza używanie migawek systemu plików dla poleceń `sync`, `scrub`,
`check` oraz `fix`.
Po włączeniu, SnapRAID tworzy migawkę danych w trybie tylko do odczytu na
początku operacji 'sync'. Zapewnia to spójny obraz plików z danego momentu,
zapobiegając błędom wywołanym przez jednoczesne modyfikacje plików.
To znacznie usprawnia odzyskiwanie danych: jeśli plik zostanie usunięty z aktywnego systemu
plików, pozostaje zachowany w migawce. Zapobiega to sytuacji, w której parzystość staje się "uszkodzona"
dla tego bloku, zapewniając możliwość pomyślnego odzyskania danych,
jeśli ulegnie awarii inny dysk.
Opcja ta dotyczy wyłącznie dysków z danymi sformatowanych w systemach plików
Btrfs, Bcachefs lub ZFS w systemie Linux oraz NTFS w systemie Windows.
Dyski parzystości lub dyski z danymi korzystające z innych systemów plików będą zawsze używać
aktywnej wersji systemu plików.
Tworzenie i usuwanie migawek wymaga uprawnień administratora.
Upewnij się, że SnapRAID jest uruchamiany z wymaganymi uprawnieniami (np. sudo), gdy
opcja ta jest włączona.
Szczegółowe wyjaśnienie cyklu życia migawek znajduje się w sekcji SNAPSHOTS.
7.8 nohidden
------------
Wyklucza wszystkie ukryte pliki i katalogi.
W systemie Unix ukryte pliki to te zaczynające się od `.`.
W systemie Windows są to te z atrybutem ukrycia.
7.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
Definiuje wzorce plików lub katalogów do wykluczenia lub włączenia
@ -1246,8 +1279,8 @@ wzorców.
Ta opcja może być używana wielokrotnie.
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
Definiuje podstawowy rozmiar bloku w kibibajtach dla parzystości.
Jeden kibibajt to 1024 bajty.
@ -1294,7 +1327,7 @@ Daje to około 1,5% dodatkowego miejsca, około 60 GB dla
dysku 4 TB, co pozwala na około 460 000 plików na każdym dysku danych bez
marnowania miejsca.
7.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
Definiuje rozmiar hasza w bajtach dla zapisanych bloków.
@ -1332,7 +1365,7 @@ Przełączając się zarówno na rozmiar hasza 8, jak i rozmiar bloku 512, otrzy
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
Automatycznie zapisuje stan podczas synchronizacji lub sprawdzania po przetworzeniu
@ -1340,7 +1373,7 @@ określonej ilości GB.
Ta opcja jest przydatna, aby uniknąć ponownego uruchamiania długich poleceń `sync`
od zera, jeśli zostaną przerwane przez awarię maszyny lub inne zdarzenie.
7.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
Ustawia maksymalną dozwoloną temperaturę dysku w stopniach Celsjusza. Po określeniu,
@ -1371,13 +1404,13 @@ wykorzystuje najniższą temperaturę dysku zmierzoną na początku uruchomienia
Normalnie SnapRAID pokazuje tylko temperaturę najgorętszego dysku.
Aby wyświetlić temperaturę wszystkich dysków, użyj opcji -A lub --stats.
7.13 temp_sleep TIME_IN_MINUTES
7.14 temp_sleep TIME_IN_MINUTES
-------------------------------
Ustawia czas gotowości, w minutach, po osiągnięciu limitu temperatury.
W tym okresie dyski pozostają zatrzymane. Domyślnie jest to 5 minut.
7.14 pool DIR
7.15 pool DIR
-------------
Definiuje katalog puli, w którym tworzony jest wirtualny widok macierzy
@ -1385,7 +1418,7 @@ dysków za pomocą polecenia `pool`.
Katalog musi już istnieć.
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
Definiuje ścieżkę UNC Windows wymaganą do zdalnego dostępu do dysków.
@ -1401,7 +1434,7 @@ katalog i nazwę pliku.
Ta opcja jest wymagana tylko dla systemu Windows.
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
Definiuje niestandardowe opcje smartctl do uzyskania atrybutów SMART dla
@ -1426,7 +1459,7 @@ Na przykład:
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
Ignoruje określony atrybut SMART podczas obliczania prawdopodobieństwa
@ -1447,7 +1480,7 @@ Aby zignorować go tylko na pierwszym dysku parzystości:
smartignore parity 197
7.18 Examples
7.19 Examples
-------------
Przykład typowej konfiguracji dla systemu Unix:
@ -1482,8 +1515,127 @@ Przykład typowej konfiguracji dla systemu Windows:
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 PATTERN
=========
8 SNAPSHOTS (MIGAWKI)
=====================
Jeśli opcja snapshot jest włączona w konfiguracji, SnapRAID
wykorzystuje funkcjonalność migawek systemu plików w celu zapewnienia operacji atomowych
i spójnych.
Zarządzanie migawkami jest całkowicie automatyczne i przejrzyste.
Możesz nadal używać SnapRAID dokładnie tak jak dotychczas, z dodatkową
ochroną zapewnianą przez migawki, która jest realizowana w całości w
tle.
Zapewnia to dwie główne korzyści:
Spójność - Pliki zmodyfikowane w aktywnym systemie plików podczas długotrwałej
operacji sync lub scrub nie spowodują niezgodności parzystości ani przerwania
operacji, ponieważ SnapRAID widzi zamrożony obraz z danego momentu.
Odzyskiwanie - Jeśli plik zostanie zaktualizowany lub usunięty z aktywnego systemu plików,
pozostaje zachowany w migawce. Jeśli awaria dysku nastąpi
przed uruchomieniem kolejnej operacji sync, SnapRAID użyje danych zachowanych
w migawce do odbudowania uszkodzonego dysku.
W przypadku awarii dysku podczas aktywnego procesu sync,
SnapRAID jest również w stanie automatycznie czytać zarówno z migawki
poprzedniego obliczenia parzystości, jak i z bieżącej.
Maksymalizuje to prawdopodobieństwo pełnego odzyskania danych poprzez
zapewnienie dostępu do dokładnych bloków danych wymaganych do rozwiązania
równań parzystości, nawet jeśli bloki te zostały zmodyfikowane
lub usunięte pomiędzy operacjami sync.
Bez migawek, zaktualizowany lub usunięty plik na sprawnym dysku
skutkuje brakiem bloków danych, które mogą być wymagane do
naprawy innych uszkodzonych dysków.
Migawki są tworzone tylko dla dysków z danymi i tylko wtedy, gdy bazowy
system plików obsługuje tę funkcjonalność. Dyski parzystości zawsze używają
aktywnego systemu plików.
Obecnie jest to obsługiwane w systemach Btrfs, Bcachefs i ZFS w systemie Linux
oraz NTFS w systemie Windows.
Można mieszać dyski z danymi o różnych systemach plików. Tylko te, które
obsługują migawki, będą z nich korzystać, podczas gdy inne dyski będą nadal
działać bezpośrednio na aktywnym systemie plików.
Tworzenie i usuwanie migawek wymaga uprawnień administratora.
Upewnij się, że SnapRAID jest uruchamiany z wymaganymi uprawnieniami (np. sudo),
gdy migawki są włączone.
8.1 Zachowanie poleceń przy użyciu migawek
------------------------------------------
Polecenia `sync` oraz `scrub` działają wyłącznie na migawkach,
aby zapewnić, że wszystkie operacje na danych są wykonywane na spójnym,
zamrożonym stanie. Poprzez wykorzystanie tych migawek, SnapRAID zapobiega niezgodnościom
parzystości, które w przeciwnym razie zostałyby wywołane przez jednoczesne modyfikacje plików w aktywnym systemie plików.
Podczas operacji `sync` polecenie używa nowej migawki utworzonej na
początku procesu, aby uchwycić bieżący stan do obliczenia parzystości.
W przeciwieństwie do tego, polecenie `scrub` wykorzystuje ostatnią migawkę, tę
utworzoną podczas najnowszej synchronizacji, aby utrzymać wiarygodny punkt odniesienia
odpowiadający istniejącej parzystości.
W przypadku poleceń `check` oraz `fix`, użycie ostatniej migawki
zależy od tego, czy konkretne dyski są wskazywane za pomocą opcji
-d, --filter-disk.
Dysk jawnie wybrany za pomocą opcji -d ("cel" operacji)
zawsze używa aktywnego systemu plików. Dla `fix` pozwala to na przywrócenie
danych na aktywny dysk zamienny. Dla `check` pozwala to na symulację
operacji `fix` w tych samych warunkach.
Wszystkie inne dyski z danymi (dyski "referencyjne") będą dostępne za pośrednictwem
swoich migawek. Zapewnia to, że nawet jeśli modyfikujesz pliki
na sprawnych dyskach podczas trwania odzyskiwania danych, SnapRAID
posiada stabilny, zamrożony punkt odniesienia do rozwiązania równań parzystości.
Jeśli nie podano opcji -d, SnapRAID zakłada, że operacja dotyczy
całej macierzy. W takim przypadku `check` oraz `fix` będą używać wyłącznie
aktywnych systemów plików.
Wszystkie inne polecenia działają wyłącznie na aktywnym systemie plików.
9 CYKL żYCIA MIGAWEK
====================
SnapRAID zarządza dwoma określonymi migawkami, `stable` (stabilną) oraz `pending` (oczekującą),
w ukrytym katalogu w katalogu głównym każdego podwolumenu danych.
W systemach Btrfs, Bcachefs i NTFS używany jest katalog `.snapraid/`,
w systemie ZFS standardowy `.zfs/snapshot/`.
Migawka `stable` reprezentuje stan ostatniej
pomyślnie zakończonej operacji `sync`, zawierając dokładne dane użyte do
obliczenia bieżącej parzystości. Służy ona jako główne źródło danych
dla poleceń `scrub`, `check` i `fix`.
Migawka `pending` to tymczasowy obraz tworzony na początku
operacji `sync` w celu zapewnienia zamrożonego stanu do obliczenia parzystości.
Po pomyślnym zakończeniu operacji poprzednia migawka `stable`
jest usuwana, a migawka `pending` zostaje podniesiona do rangi
nowej stabilnej referencji.
Jeśli operacja `sync` zostanie przerwana, migawka `pending` zostaje zachowana.
Kolejne polecenia `scrub`, `check` i `fix` będą używać tej oczekującej migawki,
ponieważ odpowiada ona stanowi systemu plików zapisanemu w pliku .content,
nawet jeśli parzystość jest zsynchronizowana tylko częściowo.
W przypadku przerwania operacji `sync`, polecenia `check` i `fix`
odczytują dane również z migawki `stable`, aby pobrać bloki danych
z plików, które zostały zaktualizowane lub usunięte podczas synchronizacji.
Jest to możliwe, ponieważ plik .content zachowuje metadane dla
wszystkich zmodyfikowanych lub usuniętych plików przez cały proces sync.
Te informacje historyczne są czyszczone dopiero po pomyślnym zakończeniu operacji sync
i zapisaniu ostatecznej wersji pliku .content.
Jeśli operacja `sync` zostanie zrestartowana po przerwaniu, istniejąca
oczekująca (pending) migawka jest usuwana, a tworzona jest nowa, aby
uchwycić bieżący stan aktywnego systemu plików.
10 PATTERN
==========
Wzorce zapewniają elastyczny sposób filtrowania plików do uwzględnienia lub
wykluczenia. Używając znaków globbingowych, można zdefiniować reguły, które
@ -1601,8 +1753,8 @@ W systemie Unix, używając znaków globbing w wierszu poleceń, musisz
je cytować, aby zapobiec ich rozszerzeniu przez powłokę.
9 IGNORE FILE
=============
11 IGNORE FILE
==============
Oprócz reguł globalnych w pliku konfiguracyjnym, możesz umieścić pliki
`.snapraidignore` w dowolnym katalogu w macierzy, aby zdefiniować
@ -1646,7 +1798,7 @@ Na przykład, jeśli masz `.snapraidignore` w `/mnt/disk1/projects/`:
*.tmp
10 CONTENT
12 CONTENT
==========
SnapRAID przechowuje listę i sumy kontrolne Twoich plików w pliku zawartości.
@ -1658,7 +1810,7 @@ Ten plik jest odczytywany i zapisywany przez polecenia `sync` i `scrub`
oraz odczytywany przez polecenia `fix`, `check` i `status`.
11 PARITY
13 PARITY
=========
SnapRAID przechowuje informacje o parzystości Twojej macierzy w plikach
@ -1671,7 +1823,7 @@ Pliki te są odczytywane i zapisywane przez polecenia `sync` i `fix`
oraz tylko odczytywane przez polecenia `scrub` i `check`.
12 ENCODING
14 ENCODING
===========
SnapRAID w systemie Unix ignoruje wszelkie kodowanie. Odczytuje i przechowuje
@ -1688,13 +1840,13 @@ przekierujesz wyjście konsoli do pliku, wynikowy plik jest zawsze
w formacie UTF-8.
13 COPYRIGHT
15 COPYRIGHT
============
Ten plik jest chroniony prawem autorskim (C) 2025 Andrea Mazzoleni
14 SEE ALSO
16 SEE ALSO
===========
snapraid_log(1), snapraidd(1)

View file

@ -118,21 +118,33 @@ https://www.snapraid.it/
.PD
.RE
.SH LIMITAçõES
SnapRAID é um híbrido entre um programa RAID e um programa de backup,
visando combinar os melhores benefícios de ambos. No entanto, ele tem
algumas limitações que você deve considerar antes de usá\-lo.
O SnapRAID é um híbrido entre um RAID e un programa de backup, com o objetivo de combinar
os melhores benefícios de ambos. No entanto, possui algumas limitações que deve
considerar antes de o utilizar.
.PP
A principal limitação é que, se um disco falhar e você não tiver
sincronizado recentemente, talvez não consiga recuperar totalmente.
Mais especificamente, você pode não conseguir recuperar até o tamanho dos
arquivos alterados ou excluídos desde a última operação de sincronização.
Isso ocorre mesmo que os arquivos alterados ou excluídos não estejam no
disco com falha. É por isso que o SnapRAID é mais adequado para
dados que raramente mudam.
A principal limitação é que, se um disco falhar, apenas poderá recuperar dados até ao
estado da última operação de sincronização (\`sync\`). Quaisquer dados adicionados ou modificações feitas
desde a última sincronização que estejam localizados no disco com falha serão perdidos.
.PP
Por outro lado, arquivos recém\-adicionados não impedem a recuperação de
arquivos já existentes. Você perderá apenas os arquivos adicionados
recentemente se estiverem no disco com falha.
Consequentemente, o SnapRAID é adequado principalmente para dados que raramente mudam.
.PP
Para dados que já existiam na última sincronização, a fiabilidade da recuperação depende
de a opção \`snapshot\` ser ou não utilizada:
.PD 0
.IP \(bu
Com suporte a instantâneos (disponível em Btrfs, ZFS, Bcachefs e NTFS),
o SnapRAID pode manter automaticamente uma referência congelada dos seus discos de dados.
Isto garante que, mesmo que modifique ou elimine ficheiros no seu sistema de ficheiros ativo
durante ou após uma sincronização, o processo de recuperação permanece consistente e fiável.
.PD
.PD 0
.IP \(bu
Sem suporte a instantâneos, eliminar ou alterar ficheiros após um \`sync\`
pode impedir a recuperação total de outros discos com falha. Isto ocorre
porque a paridade já não corresponde aos ficheiros modificados, mesmo que
esses ficheiros não estejam no disco com falha. Por outro lado, ficheiros adicionados recentemente
não impedem a recuperação de ficheiros já existentes.
.PD
.PP
Outras limitações do SnapRAID são:
.PD 0
@ -651,18 +663,18 @@ snapraid sync
.PP
Se tudo for recuperado, este comando é imediato.
.SH COMANDOS
SnapRAID fornece alguns comandos simples que permitem a você:
O SnapRAID fornece alguns comandos simples que lhe permitem:
.PD 0
.IP \(bu
Imprimir o status do array \-> \`status\`
Imprimir o estado da matriz \-> \`status\`
.IP \(bu
Controlar os discos \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
Fazer um backup/snapshot \-> \`sync\`
Criar um ponto de backup/recuperação \-> \`sync\`
.IP \(bu
Verificar periodicamente os dados \-> \`scrub\`
.IP \(bu
Restaurar o último backup/snapshot \-> \`fix\`.
Restaurar o último ponto de backup/recuperação \-> \`fix\`.
.PD
.PP
Os comandos devem ser escritos em letras minúsculas.
@ -899,15 +911,14 @@ para cada bloco e para marcar blocos ruins.
Os arquivos \`parity\` NÃO são modificados.
Os arquivos no array NÃO são modificados.
.SS fix
Corrige todos os arquivos e os dados de paridade.
Corrige todos os ficheiros e os dados de paridade.
.PP
Todos os arquivos e dados de paridade são comparados com o estado de
snapshot salvo na última \`sync\`.
Se uma diferença for encontrada, ela é revertida para o snapshot armazenado.
Todos os ficheiros e dados de paridade são comparados com o estado guardado no
último \`sync\`. Se for encontrada uma diferença, esta é revertida para o estado armazenado.
.PP
ATENÇÃO! O comando \`fix\` não diferencia entre erros e modificações
intencionais. Ele reverte incondicionalmente o estado do arquivo
para a última \`sync\`.
AVISO!
O comando \`fix\` não diferencia erros de modificações intencionais.
Reverte incondicionalmente o estado do ficheiro para o do último \`sync\`.
.PP
Se nenhuma outra opção for especificada, todo o array é processado.
Use as opções de filtro para selecionar um subconjunto de arquivos ou
@ -1456,6 +1467,30 @@ disco de inicialização.
.PP
Observe que tais discos não são afetados pelos comandos \`up\` e \`down\`
porque se espera que estejam sempre girando.
.SS snapshot
Ativa o uso de instantâneos (snapshots) do sistema de ficheiros para os comandos \`sync\`, \`scrub\`,
\`check\` e \`fix\`.
.PP
Quando ativado, o SnapRAID cria um instantâneo de leitura exclusiva dos seus dados no
início de um \'sync\'. Isto garante uma visão consistente e num ponto específico no tempo dos seus
ficheiros, prevenindo erros causados por modificações concorrentes de ficheiros.
.PP
Isto melhora significativamente a recuperação: se um ficheiro for eliminado do sistema de ficheiros ativo,
ele permanece preservado no instantâneo. Isto evita que a paridade fique \[dq]corrompida\[dq]
para esse bloco, garantindo que ainda pode recuperar os dados com sucesso
se outro disco falhar.
.PP
Esta opção aplica\-se exclusivamente a discos de dados formatados com os sistemas de
ficheiros Btrfs, Bcachefs ou ZFS em Linux e NTFS em Windows.
Discos de paridade, ou discos de dados que utilizem outros sistemas de ficheiros, usarão sempre
a versão ativa do sistema de ficheiros.
.PP
A criação e eliminação de instantâneos requerem privilégios administrativos.
Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo) quando
esta opção estiver ativada.
.PP
Consulte a secção SNAPSHOTS para uma explicação detalhada do ciclo de vida
dos instantâneos.
.SS nohidden
Exclui todos os arquivos e diretórios ocultos.
No Unix, arquivos ocultos são aqueles que começam com \`.\`.
@ -1794,6 +1829,127 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS (INSTANTâNEOS)
Se a opção de instantâneo estiver ativada na configuração, o SnapRAID
utiliza a funcionalidade de instantâneos do sistema de ficheiros para garantir operações atómicas
e consistentes.
.PP
A gestão de instantâneos é completamente automática e transparente.
Pode continuar a utilizar o SnapRAID exatamente como antes, com a
proteção adicional fornecida por instantâneos geridos inteiramente em
segundo plano.
.PP
Isto proporciona dois benefícios principais:
.RS 0
.PD 0
.HP 4
.I Consistência
Ficheiros modificados no sistema de ficheiros ativo durante um sync ou scrub de
longa duração não causarão divergências de paridade ou operações abortadas,
pois o SnapRAID vê uma imagem congelada no tempo.
.HP 4
.I Recuperação
Se um ficheiro for atualizado ou eliminado do sistema de ficheiros ativo,
ele permanece preservado no instantâneo. Se ocorrer uma falha de disco
antes de o próximo sync ser executado, o SnapRAID utiliza os dados preservados
no instantâneo para reconstruir o disco com falha.
.PD
.PP
.RS 4
.PD 0
Em caso de falha de um disco durante um processo de sync ativo,
o SnapRAID também é capaz de ler automaticamente tanto do instantâneo
da computação de paridade anterior quanto da atual.
Isto maximiza a probabilidade de uma recuperação completa ao
fornecer acesso aos blocos de dados exatos necessários para resolver
as equações de paridade, mesmo que esses blocos tenham sido modificados
ou eliminados entre os syncs.
.PD
.PP
.PD 0
Sem instantâneos, um ficheiro atualizado ou eliminado num disco saudável
resulta na falta de blocos de dados que podem ser necessários para
reparar outros discos com falha.
.PD
.RE
.RE
.PP
Os instantâneos são criados apenas para discos de dados e apenas se o sistema de ficheiros
subjacente suportar esta funcionalidade. Os discos de paridade usam sempre
o sistema de ficheiros ativo.
Atualmente, isto é suportado em Btrfs, Bcachefs e ZFS em Linux
e em NTFS em Windows.
.PP
Pode misturar discos de dados com sistemas de ficheiros diferentes. Apenas aqueles que
suportam instantâneos os utilizarão, enquanto os outros discos continuarão
a operar diretamente no sistema de ficheiros ativo.
.PP
A criação e eliminação de instantâneos requerem privilégios administrativos.
Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo)
quando os instantâneos estão ativados.
.SS Comportamento dos Comandos com Instantâneos
Os comandos \`sync\` e \`scrub\` operam ambos exclusivamente em instantâneos
para garantir que todas as operações de dados sejam realizadas contra um estado consistente
e congelado. Ao utilizar estes instantâneos, o SnapRAID previne divergências de paridade
que, de outra forma, seriam despoletadas por modificações concorrentes de ficheiros no sistema de ficheiros ativo.
Durante um \`sync\`, o comando usa um novo instantâneo criado no
início do processo para capturar o estado atual para a computação da paridade.
Em contraste, o comando \`scrub\` utiliza o último instantâneo, aquele
criado durante o sync mais recente, para manter um ponto de referência confiável
que corresponda à paridade existente.
.PP
Para os comandos \`check\` e \`fix\`, o uso do último instantâneo
depende de discos específicos serem ou não alvo da operação utilizando a opção
\-d, \-\-filter\-disk.
.PP
Um disco explicitamente selecionado via \-d (o \[dq]alvo\[dq] da operação)
usa sempre o sistema de ficheiros ativo. Para \`fix\`, isto permite restaurar
dados para a substituição do disco ativo. Para \`check\`, permite simular
a operação \`fix\` sob as mesmas condições.
.PP
Todos os outros discos de dados (os discos de \[dq]referência\[dq]) serão acedidos através dos
seus instantâneos. Isto garante que, mesmo que esteja a modificar ficheiros
nos seus discos saudáveis enquanto uma recuperação está em curso, o SnapRAID
tem uma referência estável e congelada para resolver as equações de paridade.
.PP
Se nenhuma opção \-d for fornecida, o SnapRAID assume que a operação se aplica
a toda a matriz, neste caso, \`check\` e \`fix\` usarão os sistemas
de ficheiros ativos exclusivamente.
.PP
Todos os outros comandos operam exclusivamente no sistema de ficheiros ativo.
.SH CICLO DE VIDA DOS INSTANTâNEOS
O SnapRAID gere dois instantâneos específicos, \`stable\` (estável) e \`pending\` (pendente),
dentro de um diretório oculto na raiz de cada subvolume de dados.
Em Btrfs, Bcachefs e NTFS é utilizado o diretório \`.snapraid/\`,
em ZFS o padrão \`.zfs/snapshot/\`.
.PP
O instantâneo \`stable\` representa o estado do último
\`sync\` concluído com sucesso, contendo os dados exatos utilizados para
computar a paridade atual. Serve como a principal fonte de dados
para os comandos \`scrub\`, \`check\` e \`fix\`.
.PP
O instantâneo \`pending\` é uma imagem temporária criada ao início
de um \`sync\` para fornecer um estado congelado para a computação da paridade.
Após a conclusão bem\-sucedida da operação, o instantâneo \`stable\` anterior
é eliminado, e o instantâneo \`pending\` é promovido para
tomar o seu lugar como a nova referência estável.
.PP
Se um \`sync\` for interrompido, o instantâneo \`pending\` é preservado.
Os comandos subsequentes \`scrub\`, \`check\` e \`fix\` utilizarão este
instantâneo pendente, pois ele corresponde ao estado do sistema de ficheiros registado no
ficheiro .content, mesmo que a paridade esteja apenas parcialmente sincronizada.
.PP
No caso de uma interrupção do \`sync\`, os comandos \`check\` e \`fix\`
também leem do instantâneo \`stable\` para recuperar blocos de dados
de ficheiros que foram atualizados ou eliminados durante o sync.
Isto é possível porque o ficheiro .content retém metadados para
todos os ficheiros modificados ou eliminados ao longo do processo de sync.
Esta informação histórica só é limpa quando um sync termina
com sucesso e a versão final do ficheiro .content é guardada.
.PP
Se um \`sync\` for reiniciado após uma interrupção, o instantâneo pending existente
é eliminado e um novo é criado para
capturar o estado atual do sistema de ficheiros ativo.
.SH PADRãO (PATTERN)
Os padrões fornecem uma maneira flexível de filtrar arquivos para inclusão ou
exclusão. Ao usar caracteres de globbing, você pode definir regras que

View file

@ -52,21 +52,29 @@ Descrição
:https://www.snapraid.it/
Limitações
SnapRAID é um híbrido entre um programa RAID e um programa de backup,
visando combinar os melhores benefícios de ambos. No entanto, ele tem
algumas limitações que você deve considerar antes de usá-lo.
O SnapRAID é um híbrido entre um RAID e un programa de backup, com o objetivo de combinar
os melhores benefícios de ambos. No entanto, possui algumas limitações que deve
considerar antes de o utilizar.
A principal limitação é que, se um disco falhar e você não tiver
sincronizado recentemente, talvez não consiga recuperar totalmente.
Mais especificamente, você pode não conseguir recuperar até o tamanho dos
arquivos alterados ou excluídos desde a última operação de sincronização.
Isso ocorre mesmo que os arquivos alterados ou excluídos não estejam no
disco com falha. É por isso que o SnapRAID é mais adequado para
dados que raramente mudam.
A principal limitação é que, se um disco falhar, apenas poderá recuperar dados até ao
estado da última operação de sincronização (`sync`). Quaisquer dados adicionados ou modificações feitas
desde a última sincronização que estejam localizados no disco com falha serão perdidos.
Por outro lado, arquivos recém-adicionados não impedem a recuperação de
arquivos já existentes. Você perderá apenas os arquivos adicionados
recentemente se estiverem no disco com falha.
Consequentemente, o SnapRAID é adequado principalmente para dados que raramente mudam.
Para dados que já existiam na última sincronização, a fiabilidade da recuperação depende
de a opção `snapshot` ser ou não utilizada:
* Com suporte a instantâneos (disponível em Btrfs, ZFS, Bcachefs e NTFS),
o SnapRAID pode manter automaticamente uma referência congelada dos seus discos de dados.
Isto garante que, mesmo que modifique ou elimine ficheiros no seu sistema de ficheiros ativo
durante ou após uma sincronização, o processo de recuperação permanece consistente e fiável.
* Sem suporte a instantâneos, eliminar ou alterar ficheiros após um `sync`
pode impedir a recuperação total de outros discos com falha. Isto ocorre
porque a paridade já não corresponde aos ficheiros modificados, mesmo que
esses ficheiros não estejam no disco com falha. Por outro lado, ficheiros adicionados recentemente
não impedem a recuperação de ficheiros já existentes.
Outras limitações do SnapRAID são:
@ -391,13 +399,13 @@ Primeiros Passos
Se tudo for recuperado, este comando é imediato.
Comandos
SnapRAID fornece alguns comandos simples que permitem a você:
O SnapRAID fornece alguns comandos simples que lhe permitem:
* Imprimir o status do array -> `status`
* Imprimir o estado da matriz -> `status`
* Controlar os discos -> `smart`, `probe`, `up`, `down`
* Fazer um backup/snapshot -> `sync`
* Criar um ponto de backup/recuperação -> `sync`
* Verificar periodicamente os dados -> `scrub`
* Restaurar o último backup/snapshot -> `fix`.
* Restaurar o último ponto de backup/recuperação -> `fix`.
Os comandos devem ser escritos em letras minúsculas.
@ -608,15 +616,14 @@ Comandos
Os arquivos no array NÃO são modificados.
fix
Corrige todos os arquivos e os dados de paridade.
Corrige todos os ficheiros e os dados de paridade.
Todos os arquivos e dados de paridade são comparados com o estado de
snapshot salvo na última `sync`.
Se uma diferença for encontrada, ela é revertida para o snapshot armazenado.
Todos os ficheiros e dados de paridade são comparados com o estado guardado no
último `sync`. Se for encontrada uma diferença, esta é revertida para o estado armazenado.
ATENÇÃO! O comando `fix` não diferencia entre erros e modificações
intencionais. Ele reverte incondicionalmente o estado do arquivo
para a última `sync`.
AVISO!
O comando `fix` não diferencia erros de modificações intencionais.
Reverte incondicionalmente o estado do ficheiro para o do último `sync`.
Se nenhuma outra opção for especificada, todo o array é processado.
Use as opções de filtro para selecionar um subconjunto de arquivos ou
@ -1176,6 +1183,31 @@ Configuração
Observe que tais discos não são afetados pelos comandos `up` e `down`
porque se espera que estejam sempre girando.
snapshot
Ativa o uso de instantâneos (snapshots) do sistema de ficheiros para os comandos `sync`, `scrub`,
`check` e `fix`.
Quando ativado, o SnapRAID cria um instantâneo de leitura exclusiva dos seus dados no
início de um 'sync'. Isto garante uma visão consistente e num ponto específico no tempo dos seus
ficheiros, prevenindo erros causados por modificações concorrentes de ficheiros.
Isto melhora significativamente a recuperação: se um ficheiro for eliminado do sistema de ficheiros ativo,
ele permanece preservado no instantâneo. Isto evita que a paridade fique "corrompida"
para esse bloco, garantindo que ainda pode recuperar os dados com sucesso
se outro disco falhar.
Esta opção aplica-se exclusivamente a discos de dados formatados com os sistemas de
ficheiros Btrfs, Bcachefs ou ZFS em Linux e NTFS em Windows.
Discos de paridade, ou discos de dados que utilizem outros sistemas de ficheiros, usarão sempre
a versão ativa do sistema de ficheiros.
A criação e eliminação de instantâneos requerem privilégios administrativos.
Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo) quando
esta opção estiver ativada.
Consulte a secção SNAPSHOTS para uma explicação detalhada do ciclo de vida
dos instantâneos.
nohidden
Exclui todos os arquivos e diretórios ocultos.
No Unix, arquivos ocultos são aqueles que começam com `.`.
@ -1418,6 +1450,117 @@ Configuração
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots (Instantâneos)
Se a opção de instantâneo estiver ativada na configuração, o SnapRAID
utiliza a funcionalidade de instantâneos do sistema de ficheiros para garantir operações atómicas
e consistentes.
A gestão de instantâneos é completamente automática e transparente.
Pode continuar a utilizar o SnapRAID exatamente como antes, com a
proteção adicional fornecida por instantâneos geridos inteiramente em
segundo plano.
Isto proporciona dois benefícios principais:
Consistência - Ficheiros modificados no sistema de ficheiros ativo durante um sync ou scrub de
longa duração não causarão divergências de paridade ou operações abortadas,
pois o SnapRAID vê uma imagem congelada no tempo.
Recuperação - Se um ficheiro for atualizado ou eliminado do sistema de ficheiros ativo,
ele permanece preservado no instantâneo. Se ocorrer uma falha de disco
antes de o próximo sync ser executado, o SnapRAID utiliza os dados preservados
no instantâneo para reconstruir o disco com falha.
Em caso de falha de um disco durante um processo de sync ativo,
o SnapRAID também é capaz de ler automaticamente tanto do instantâneo
da computação de paridade anterior quanto da atual.
Isto maximiza a probabilidade de uma recuperação completa ao
fornecer acesso aos blocos de dados exatos necessários para resolver
as equações de paridade, mesmo que esses blocos tenham sido modificados
ou eliminados entre os syncs.
Sem instantâneos, um ficheiro atualizado ou eliminado num disco saudável
resulta na falta de blocos de dados que podem ser necessários para
reparar outros discos com falha.
Os instantâneos são criados apenas para discos de dados e apenas se o sistema de ficheiros
subjacente suportar esta funcionalidade. Os discos de paridade usam sempre
o sistema de ficheiros ativo.
Atualmente, isto é suportado em Btrfs, Bcachefs e ZFS em Linux
e em NTFS em Windows.
Pode misturar discos de dados com sistemas de ficheiros diferentes. Apenas aqueles que
suportam instantâneos os utilizarão, enquanto os outros discos continuarão
a operar diretamente no sistema de ficheiros ativo.
A criação e eliminação de instantâneos requerem privilégios administrativos.
Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo)
quando os instantâneos estão ativados.
Comportamento dos Comandos com Instantâneos
Os comandos `sync` e `scrub` operam ambos exclusivamente em instantâneos
para garantir que todas as operações de dados sejam realizadas contra um estado consistente
e congelado. Ao utilizar estes instantâneos, o SnapRAID previne divergências de paridade
que, de outra forma, seriam despoletadas por modificações concorrentes de ficheiros no sistema de ficheiros ativo.
Durante um `sync`, o comando usa um novo instantâneo criado no
início do processo para capturar o estado atual para a computação da paridade.
Em contraste, o comando `scrub` utiliza o último instantâneo, aquele
criado durante o sync mais recente, para manter um ponto de referência confiável
que corresponda à paridade existente.
Para os comandos `check` e `fix`, o uso do último instantâneo
depende de discos específicos serem ou não alvo da operação utilizando a opção
-d, --filter-disk.
Um disco explicitamente selecionado via -d (o "alvo" da operação)
usa sempre o sistema de ficheiros ativo. Para `fix`, isto permite restaurar
dados para a substituição do disco ativo. Para `check`, permite simular
a operação `fix` sob as mesmas condições.
Todos os outros discos de dados (os discos de "referência") serão acedidos através dos
seus instantâneos. Isto garante que, mesmo que esteja a modificar ficheiros
nos seus discos saudáveis enquanto uma recuperação está em curso, o SnapRAID
tem uma referência estável e congelada para resolver as equações de paridade.
Se nenhuma opção -d for fornecida, o SnapRAID assume que a operação se aplica
a toda a matriz, neste caso, `check` e `fix` usarão os sistemas
de ficheiros ativos exclusivamente.
Todos os outros comandos operam exclusivamente no sistema de ficheiros ativo.
Ciclo de Vida dos Instantâneos
O SnapRAID gere dois instantâneos específicos, `stable` (estável) e `pending` (pendente),
dentro de um diretório oculto na raiz de cada subvolume de dados.
Em Btrfs, Bcachefs e NTFS é utilizado o diretório `.snapraid/`,
em ZFS o padrão `.zfs/snapshot/`.
O instantâneo `stable` representa o estado do último
`sync` concluído com sucesso, contendo os dados exatos utilizados para
computar a paridade atual. Serve como a principal fonte de dados
para os comandos `scrub`, `check` e `fix`.
O instantâneo `pending` é uma imagem temporária criada ao início
de um `sync` para fornecer um estado congelado para a computação da paridade.
Após a conclusão bem-sucedida da operação, o instantâneo `stable` anterior
é eliminado, e o instantâneo `pending` é promovido para
tomar o seu lugar como a nova referência estável.
Se um `sync` for interrompido, o instantâneo `pending` é preservado.
Os comandos subsequentes `scrub`, `check` e `fix` utilizarão este
instantâneo pendente, pois ele corresponde ao estado do sistema de ficheiros registado no
ficheiro .content, mesmo que a paridade esteja apenas parcialmente sincronizada.
No caso de uma interrupção do `sync`, os comandos `check` e `fix`
também leem do instantâneo `stable` para recuperar blocos de dados
de ficheiros que foram atualizados ou eliminados durante o sync.
Isto é possível porque o ficheiro .content retém metadados para
todos os ficheiros modificados ou eliminados ao longo do processo de sync.
Esta informação histórica só é limpa quando um sync termina
com sucesso e a versão final do ficheiro .content é guardada.
Se um `sync` for reiniciado após uma interrupção, o instantâneo pending existente
é eliminado e um novo é criado para
capturar o estado atual do sistema de ficheiros ativo.
Padrão (Pattern)
Os padrões fornecem uma maneira flexível de filtrar arquivos para inclusão ou
exclusão. Ao usar caracteres de globbing, você pode definir regras que

View file

@ -62,21 +62,29 @@ Para mais informações, visite o site oficial do SnapRAID:
3 LIMITAçõES
============
SnapRAID é um híbrido entre um programa RAID e um programa de backup,
visando combinar os melhores benefícios de ambos. No entanto, ele tem
algumas limitações que você deve considerar antes de usá-lo.
O SnapRAID é um híbrido entre um RAID e un programa de backup, com o objetivo de combinar
os melhores benefícios de ambos. No entanto, possui algumas limitações que deve
considerar antes de o utilizar.
A principal limitação é que, se um disco falhar e você não tiver
sincronizado recentemente, talvez não consiga recuperar totalmente.
Mais especificamente, você pode não conseguir recuperar até o tamanho dos
arquivos alterados ou excluídos desde a última operação de sincronização.
Isso ocorre mesmo que os arquivos alterados ou excluídos não estejam no
disco com falha. É por isso que o SnapRAID é mais adequado para
dados que raramente mudam.
A principal limitação é que, se um disco falhar, apenas poderá recuperar dados até ao
estado da última operação de sincronização (`sync`). Quaisquer dados adicionados ou modificações feitas
desde a última sincronização que estejam localizados no disco com falha serão perdidos.
Por outro lado, arquivos recém-adicionados não impedem a recuperação de
arquivos já existentes. Você perderá apenas os arquivos adicionados
recentemente se estiverem no disco com falha.
Consequentemente, o SnapRAID é adequado principalmente para dados que raramente mudam.
Para dados que já existiam na última sincronização, a fiabilidade da recuperação depende
de a opção `snapshot` ser ou não utilizada:
* Com suporte a instantâneos (disponível em Btrfs, ZFS, Bcachefs e NTFS),
o SnapRAID pode manter automaticamente uma referência congelada dos seus discos de dados.
Isto garante que, mesmo que modifique ou elimine ficheiros no seu sistema de ficheiros ativo
durante ou após uma sincronização, o processo de recuperação permanece consistente e fiável.
* Sem suporte a instantâneos, eliminar ou alterar ficheiros após um `sync`
pode impedir a recuperação total de outros discos com falha. Isto ocorre
porque a paridade já não corresponde aos ficheiros modificados, mesmo que
esses ficheiros não estejam no disco com falha. Por outro lado, ficheiros adicionados recentemente
não impedem a recuperação de ficheiros já existentes.
Outras limitações do SnapRAID são:
@ -415,13 +423,13 @@ Se tudo for recuperado, este comando é imediato.
5 COMANDOS
==========
SnapRAID fornece alguns comandos simples que permitem a você:
O SnapRAID fornece alguns comandos simples que lhe permitem:
* Imprimir o status do array -> `status`
* Imprimir o estado da matriz -> `status`
* Controlar os discos -> `smart`, `probe`, `up`, `down`
* Fazer um backup/snapshot -> `sync`
* Criar um ponto de backup/recuperação -> `sync`
* Verificar periodicamente os dados -> `scrub`
* Restaurar o último backup/snapshot -> `fix`.
* Restaurar o último ponto de backup/recuperação -> `fix`.
Os comandos devem ser escritos em letras minúsculas.
@ -650,15 +658,14 @@ Os arquivos no array NÃO são modificados.
5.9 fix
-------
Corrige todos os arquivos e os dados de paridade.
Corrige todos os ficheiros e os dados de paridade.
Todos os arquivos e dados de paridade são comparados com o estado de
snapshot salvo na última `sync`.
Se uma diferença for encontrada, ela é revertida para o snapshot armazenado.
Todos os ficheiros e dados de paridade são comparados com o estado guardado no
último `sync`. Se for encontrada uma diferença, esta é revertida para o estado armazenado.
ATENÇÃO! O comando `fix` não diferencia entre erros e modificações
intencionais. Ele reverte incondicionalmente o estado do arquivo
para a última `sync`.
AVISO!
O comando `fix` não diferencia erros de modificações intencionais.
Reverte incondicionalmente o estado do ficheiro para o do último `sync`.
Se nenhuma outra opção for especificada, todo o array é processado.
Use as opções de filtro para selecionar um subconjunto de arquivos ou
@ -1252,14 +1259,41 @@ disco de inicialização.
Observe que tais discos não são afetados pelos comandos `up` e `down`
porque se espera que estejam sempre girando.
7.7 nohidden
7.7 snapshot
------------
Ativa o uso de instantâneos (snapshots) do sistema de ficheiros para os comandos `sync`, `scrub`,
`check` e `fix`.
Quando ativado, o SnapRAID cria um instantâneo de leitura exclusiva dos seus dados no
início de um 'sync'. Isto garante uma visão consistente e num ponto específico no tempo dos seus
ficheiros, prevenindo erros causados por modificações concorrentes de ficheiros.
Isto melhora significativamente a recuperação: se um ficheiro for eliminado do sistema de ficheiros ativo,
ele permanece preservado no instantâneo. Isto evita que a paridade fique "corrompida"
para esse bloco, garantindo que ainda pode recuperar os dados com sucesso
se outro disco falhar.
Esta opção aplica-se exclusivamente a discos de dados formatados com os sistemas de
ficheiros Btrfs, Bcachefs ou ZFS em Linux e NTFS em Windows.
Discos de paridade, ou discos de dados que utilizem outros sistemas de ficheiros, usarão sempre
a versão ativa do sistema de ficheiros.
A criação e eliminação de instantâneos requerem privilégios administrativos.
Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo) quando
esta opção estiver ativada.
Consulte a secção SNAPSHOTS para uma explicação detalhada do ciclo de vida
dos instantâneos.
7.8 nohidden
------------
Exclui todos os arquivos e diretórios ocultos.
No Unix, arquivos ocultos são aqueles que começam com `.`.
No Windows, são aqueles com o atributo oculto.
7.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
Define os padrões de arquivo ou diretório a serem excluídos ou incluídos
@ -1277,8 +1311,8 @@ especificações de padrão.
Esta opção pode ser usada várias vezes.
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
Define o tamanho básico do bloco em kibibytes para a paridade.
Um kibibyte é 1024 bytes.
@ -1327,7 +1361,7 @@ Isso resulta em cerca de 1,5% de espaço extra, aproximadamente 60 GB para
um disco de 4 TB, o que permite cerca de 460.000 arquivos em cada disco
de dados sem qualquer espaço desperdiçado.
7.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
Define o tamanho do hash em bytes para os blocos salvos.
@ -1365,7 +1399,7 @@ Mudando para um tamanho de hash de 8 e um tamanho de bloco de 512, você obtém:
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
Salva automaticamente o estado ao sincronizar ou examinar após a
@ -1373,7 +1407,7 @@ quantidade especificada de GB processados.
Esta opção é útil para evitar reiniciar longos comandos `sync`
do zero se interrompidos por uma falha de máquina ou qualquer outro evento.
7.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
Define a temperatura máxima permitida do disco em Celsius. Quando especificado,
@ -1406,14 +1440,14 @@ referência de fallback.
Normalmente, o SnapRAID mostra apenas a temperatura do disco mais quente.
Para exibir a temperatura de todos os discos, use a opção -A ou --stats.
7.13 temp_sleep TIME_IN_MINUTES
7.14 temp_sleep TIME_IN_MINUTES
-------------------------------
Define o tempo de espera (standby time), em minutos, quando o limite de
temperatura é atingido. Durante este período, os discos permanecem
desligados. O padrão é 5 minutos.
7.14 pool DIR
7.15 pool DIR
-------------
Define o diretório de pooling onde a visualização virtual do array
@ -1421,7 +1455,7 @@ de discos é criada usando o comando `pool`.
O diretório já deve existir.
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
Define o caminho UNC do Windows necessário para acessar os discos remotamente.
@ -1437,7 +1471,7 @@ e finalmente adicionando o diretório e nome do arquivo.
Esta opção é necessária apenas para Windows.
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
Define opções smartctl personalizadas para obter os atributos SMART para
@ -1463,7 +1497,7 @@ Por exemplo:
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
Ignora o atributo SMART especificado ao calcular a probabilidade
@ -1484,7 +1518,7 @@ Para ignorá-lo apenas no primeiro disco de paridade:
smartignore parity 197
7.18 Exemplos
7.19 Exemplos
-------------
Um exemplo de uma configuração típica para Unix é:
@ -1519,8 +1553,127 @@ Um exemplo de uma configuração típica para Windows é:
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 PADRãO (PATTERN)
==================
8 SNAPSHOTS (INSTANTâNEOS)
==========================
Se a opção de instantâneo estiver ativada na configuração, o SnapRAID
utiliza a funcionalidade de instantâneos do sistema de ficheiros para garantir operações atómicas
e consistentes.
A gestão de instantâneos é completamente automática e transparente.
Pode continuar a utilizar o SnapRAID exatamente como antes, com a
proteção adicional fornecida por instantâneos geridos inteiramente em
segundo plano.
Isto proporciona dois benefícios principais:
Consistência - Ficheiros modificados no sistema de ficheiros ativo durante um sync ou scrub de
longa duração não causarão divergências de paridade ou operações abortadas,
pois o SnapRAID vê uma imagem congelada no tempo.
Recuperação - Se um ficheiro for atualizado ou eliminado do sistema de ficheiros ativo,
ele permanece preservado no instantâneo. Se ocorrer uma falha de disco
antes de o próximo sync ser executado, o SnapRAID utiliza os dados preservados
no instantâneo para reconstruir o disco com falha.
Em caso de falha de um disco durante um processo de sync ativo,
o SnapRAID também é capaz de ler automaticamente tanto do instantâneo
da computação de paridade anterior quanto da atual.
Isto maximiza a probabilidade de uma recuperação completa ao
fornecer acesso aos blocos de dados exatos necessários para resolver
as equações de paridade, mesmo que esses blocos tenham sido modificados
ou eliminados entre os syncs.
Sem instantâneos, um ficheiro atualizado ou eliminado num disco saudável
resulta na falta de blocos de dados que podem ser necessários para
reparar outros discos com falha.
Os instantâneos são criados apenas para discos de dados e apenas se o sistema de ficheiros
subjacente suportar esta funcionalidade. Os discos de paridade usam sempre
o sistema de ficheiros ativo.
Atualmente, isto é suportado em Btrfs, Bcachefs e ZFS em Linux
e em NTFS em Windows.
Pode misturar discos de dados com sistemas de ficheiros diferentes. Apenas aqueles que
suportam instantâneos os utilizarão, enquanto os outros discos continuarão
a operar diretamente no sistema de ficheiros ativo.
A criação e eliminação de instantâneos requerem privilégios administrativos.
Garanta que o SnapRAID é executado com as permissões necessárias (ex: sudo)
quando os instantâneos estão ativados.
8.1 Comportamento dos Comandos com Instantâneos
-----------------------------------------------
Os comandos `sync` e `scrub` operam ambos exclusivamente em instantâneos
para garantir que todas as operações de dados sejam realizadas contra um estado consistente
e congelado. Ao utilizar estes instantâneos, o SnapRAID previne divergências de paridade
que, de outra forma, seriam despoletadas por modificações concorrentes de ficheiros no sistema de ficheiros ativo.
Durante um `sync`, o comando usa um novo instantâneo criado no
início do processo para capturar o estado atual para a computação da paridade.
Em contraste, o comando `scrub` utiliza o último instantâneo, aquele
criado durante o sync mais recente, para manter um ponto de referência confiável
que corresponda à paridade existente.
Para os comandos `check` e `fix`, o uso do último instantâneo
depende de discos específicos serem ou não alvo da operação utilizando a opção
-d, --filter-disk.
Um disco explicitamente selecionado via -d (o "alvo" da operação)
usa sempre o sistema de ficheiros ativo. Para `fix`, isto permite restaurar
dados para a substituição do disco ativo. Para `check`, permite simular
a operação `fix` sob as mesmas condições.
Todos os outros discos de dados (os discos de "referência") serão acedidos através dos
seus instantâneos. Isto garante que, mesmo que esteja a modificar ficheiros
nos seus discos saudáveis enquanto uma recuperação está em curso, o SnapRAID
tem uma referência estável e congelada para resolver as equações de paridade.
Se nenhuma opção -d for fornecida, o SnapRAID assume que a operação se aplica
a toda a matriz, neste caso, `check` e `fix` usarão os sistemas
de ficheiros ativos exclusivamente.
Todos os outros comandos operam exclusivamente no sistema de ficheiros ativo.
9 CICLO DE VIDA DOS INSTANTâNEOS
================================
O SnapRAID gere dois instantâneos específicos, `stable` (estável) e `pending` (pendente),
dentro de um diretório oculto na raiz de cada subvolume de dados.
Em Btrfs, Bcachefs e NTFS é utilizado o diretório `.snapraid/`,
em ZFS o padrão `.zfs/snapshot/`.
O instantâneo `stable` representa o estado do último
`sync` concluído com sucesso, contendo os dados exatos utilizados para
computar a paridade atual. Serve como a principal fonte de dados
para os comandos `scrub`, `check` e `fix`.
O instantâneo `pending` é uma imagem temporária criada ao início
de um `sync` para fornecer um estado congelado para a computação da paridade.
Após a conclusão bem-sucedida da operação, o instantâneo `stable` anterior
é eliminado, e o instantâneo `pending` é promovido para
tomar o seu lugar como a nova referência estável.
Se um `sync` for interrompido, o instantâneo `pending` é preservado.
Os comandos subsequentes `scrub`, `check` e `fix` utilizarão este
instantâneo pendente, pois ele corresponde ao estado do sistema de ficheiros registado no
ficheiro .content, mesmo que a paridade esteja apenas parcialmente sincronizada.
No caso de uma interrupção do `sync`, os comandos `check` e `fix`
também leem do instantâneo `stable` para recuperar blocos de dados
de ficheiros que foram atualizados ou eliminados durante o sync.
Isto é possível porque o ficheiro .content retém metadados para
todos os ficheiros modificados ou eliminados ao longo do processo de sync.
Esta informação histórica só é limpa quando um sync termina
com sucesso e a versão final do ficheiro .content é guardada.
Se um `sync` for reiniciado após uma interrupção, o instantâneo pending existente
é eliminado e um novo é criado para
capturar o estado atual do sistema de ficheiros ativo.
10 PADRãO (PATTERN)
===================
Os padrões fornecem uma maneira flexível de filtrar arquivos para inclusão ou
exclusão. Ao usar caracteres de globbing, você pode definir regras que
@ -1638,8 +1791,8 @@ No Unix, ao usar caracteres globbing na linha de comando, você deve
citá-los para evitar que o shell os expanda.
9 IGNORAR ARQUIVOS (IGNORE FILE)
================================
11 IGNORAR ARQUIVOS (IGNORE FILE)
=================================
Além das regras globais no arquivo de configuração, você pode colocar
arquivos `.snapraidignore` em qualquer diretório dentro do array para definir
@ -1683,7 +1836,7 @@ Por exemplo, se você tiver um `.snapraidignore` em `/mnt/disk1/projects/`:
*.tmp
10 CONTEúDO (CONTENT)
12 CONTEúDO (CONTENT)
=====================
SnapRAID armazena a lista e os checksums de seus arquivos no arquivo content.
@ -1695,7 +1848,7 @@ Este arquivo é lido e escrito pelos comandos `sync` e `scrub` e
lido pelos comandos `fix`, `check` e `status`.
11 PARIDADE (PARITY)
13 PARIDADE (PARITY)
====================
SnapRAID armazena as informações de paridade do seu array nos arquivos parity.
@ -1707,7 +1860,7 @@ Estes arquivos são lidos e escritos pelos comandos `sync` e `fix` e
apenas lidos pelos comandos `scrub` e `check`.
12 CODIFICAçãO (ENCODING)
14 CODIFICAçãO (ENCODING)
=========================
SnapRAID no Unix ignora qualquer codificação. Ele lê e armazena os
@ -1724,13 +1877,13 @@ redirecionar a saída do console para um arquivo, o arquivo resultante
estará sempre no formato UTF-8.
13 DIREITOS AUTORAIS (COPYRIGHT)
15 DIREITOS AUTORAIS (COPYRIGHT)
================================
Este arquivo é Copyright (C) 2025 Andrea Mazzoleni
14 VEJA TAMBéM (SEE ALSO)
16 VEJA TAMBéM (SEE ALSO)
=========================
snapraid_log(1), snapraidd(1)

View file

@ -118,21 +118,33 @@ https://www.snapraid.it/
.PD
.RE
.SH LIMITăRI
SnapRAID este un hibrid între un program RAID și unul de backup, care urmărește să combine
cele mai bune beneficii ale ambelor. Cu toate acestea, are unele limitări pe care ar trebui
SnapRAID este un hibrid între un RAID și un program de backup, având ca scop combinarea
celor mai bune avantaje ale ambelor. Cu toate acestea, are unele limitări pe care ar trebui
să le luați în considerare înainte de a\-l utiliza.
.PP
Principala limitare este că, dacă un disc se defectează și nu ați făcut recent o sincronizare,
este posibil să nu puteți recupera complet.
Mai exact, este posibil să nu puteți recupera până la dimensiunea
fișierelor modificate sau șterse de la ultima operațiune de sincronizare.
Acest lucru se întâmplă chiar dacă fișierele modificate sau șterse nu sunt pe
discul defect. Acesta este motivul pentru care SnapRAID este mai potrivit pentru
date care se schimbă rar.
Principala limitare este că, dacă un disc se defectează, puteți recupera datele doar până la
starea ultimei operațiuni de \`sync\`. Orice date adăugate sau modificări efectuate
de la ultima sincronizare care se află pe discul defect vor fi pierdute.
.PP
Pe de altă parte, fișierele nou adăugate nu împiedică recuperarea fișierelor
deja existente. Veți pierde doar fișierele adăugate recent dacă acestea
se află pe discul defect.
Prin urmare, SnapRAID este potrivit în principal pentru date care se modifică rar.
.PP
Pentru datele care existau deja la ultima sincronizare, fiabilitatea recuperării depinde
de utilizarea sau nu a opțiunii \`snapshot\`:
.PD 0
.IP \(bu
Cu suport pentru snapshot (disponibil pe Btrfs, ZFS, Bcachefs și NTFS),
SnapRAID poate menține automat o referință înghețată a discurilor de date.
Acest lucru asigură că, chiar dacă modificați sau ștergeți fișiere pe sistemul de fișiere live
în timpul sau după un sync, procesul de recuperare rămâne consistent și de încredere.
.PD
.PD 0
.IP \(bu
Fără suport pentru snapshot, ștergerea sau modificarea fișierelor după un \`sync\`
poate împiedica recuperarea completă a altor discuri defecte. Acest lucru se întâmplă
deoarece paritatea nu mai corespunde cu fișierele modificate, chiar dacă
acele fișiere nu se află pe discul defect. Pe de altă parte, fișierele nou adăugate
nu împiedică recuperarea fișierelor deja existente.
.PD
.PP
Alte limitări ale SnapRAID sunt:
.PD 0
@ -643,15 +655,15 @@ Dacă totul este recuperat, această comandă este imediată.
SnapRAID oferă câteva comenzi simple care vă permit să:
.PD 0
.IP \(bu
Tipăriți starea matricei \-> \`status\`
Afișați starea matricei \-> \`status\`
.IP \(bu
Controlați discurile \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
Faceți un backup/snapshot \-> \`sync\`
Creați un punct de backup/recuperare \-> \`sync\`
.IP \(bu
Verificați periodic datele \-> \`scrub\`
.IP \(bu
Restaurați ultimul backup/snapshot \-> \`fix\`.
Restaurați ultimul punct de backup/recuperare \-> \`fix\`.
.PD
.PP
Comenzile trebuie scrise cu litere mici.
@ -882,13 +894,12 @@ Fișierele din matrice NU sunt modificate.
.SS fix
Repară toate fișierele și datele de paritate.
.PP
Toate fișierele și datele de paritate sunt comparate cu starea snapshot\-ului
salvată la ultima \`sync\`.
Dacă se găsește o diferență, este readusă la snapshot\-ul stocat.
Toate fișierele și datele de paritate sunt comparate cu starea salvată în
ultimul \`sync\`. Dacă se găsește o diferență, aceasta este readusă la starea stocată.
.PP
ATENȚIE! Comanda \`fix\` nu face diferența între erori și
modificări intenționate. Ea revine necondiționat la starea fișierului
de la ultima \`sync\`.
AVERTISMENT!
Comanda \`fix\` nu face diferența între erori și modificări intenționate.
Ea revine necondiționat la starea fișierelor de la ultimul \`sync\`.
.PP
Dacă nu este specificată nicio altă opțiune, întreaga matrice este procesată.
Utilizați opțiunile de filtrare pentru a selecta un subset de fișiere sau discuri de operat.
@ -1426,6 +1437,30 @@ sistemului, cum ar fi discul de pornire.
.PP
Rețineți că astfel de discuri nu sunt afectate de comenzile \`up\` și
\`down\` deoarece se așteaptă ca acestea să se rotească mereu.
.SS snapshot
Activează utilizarea snapshot\-urilor sistemului de fișiere pentru comenzile \`sync\`, \`scrub\`,
\`check\` și \`fix\`.
.PP
Când este activată, SnapRAID creează un snapshot read\-only al datelor dvs. la
începutul unui \'sync\'. Acest lucru asigură o vizualizare consistentă, la un anumit moment în timp, a
fișierelor dvs., prevenind erorile cauzate de modificările concurente ale fișierelor.
.PP
Acest lucru îmbunătățește semnificativ recuperarea: dacă un fișier este șters din sistemul de fișiere live,
el rămâne păstrat în snapshot. Acest lucru previne ca paritatea să devină „ruptă”
pentru acel bloc, asigurându\-vă că puteți recupera cu succes datele
dacă un alt disc se defectează.
.PP
Această opțiune se aplică exclusiv discurilor de date formatate cu sistemele de
fișiere Btrfs, Bcachefs sau ZFS în Linux și NTFS în Windows.
Discurile de paritate, sau discurile de date care utilizează alte sisteme de fișiere, vor folosi întotdeauna
versiunea live a sistemului de fișiere.
.PP
Crearea și ștergerea snapshot\-urilor necesită privilegii administrative.
Asigurați\-vă că SnapRAID este rulat cu permisiunile necesare (de exemplu, sudo) când
această opțiune este activată.
.PP
Consultați secțiunea SNAPSHOTS pentru o explicație detaliată a ciclului de viață
al snapshot\-urilor.
.SS nohidden
Exclude toate fișierele și directoarele ascunse.
În Unix, fișierele ascunse sunt cele care încep cu \`.\`.
@ -1759,6 +1794,127 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS
Dacă opțiunea snapshot este activată în configurație, SnapRAID
utilizează funcționalitatea de snapshot a sistemului de fișiere pentru a asigura operațiuni atomice
și consistente.
.PP
Gestionarea snapshot\-urilor este complet automată și transparentă.
Puteți continua să utilizați SnapRAID exact ca înainte, cu protecția
suplimentară oferită de snapshot\-uri gestionate în întregime în
background.
.PP
Acest lucru oferă două avantaje principale:
.RS 0
.PD 0
.HP 4
.I Consistență
Fișierele modificate pe sistemul de fișiere live în timpul unui sync sau scrub
de lungă durată nu vor cauza nepotriviri de paritate sau operațiuni abandonate,
deoarece SnapRAID vede o imagine înghețată la un anumit moment în timp.
.HP 4
.I Recuperare
Dacă un fișier este actualizat sau șters din sistemul de fișiere live,
el rămâne păstrat în snapshot. Dacă se produce o defecțiune a discului
înainte de rularea următorului sync, SnapRAID utilizează datele păstrate
în snapshot pentru a reconstrui discul defect.
.PD
.PP
.RS 4
.PD 0
În cazul unei defecțiuni a discului în timpul unui proces de sync activ,
SnapRAID este, de asemenea, capabil să citească automat atât din snapshot\-ul
calculului anterior de paritate, cât și din cel curent.
Acest lucru maximizează probabilitatea unei recuperări complete prin
oferirea accesului la blocurile exacte de date necesare pentru a rezolva
ecuațiile de paritate, chiar dacă acele blocuri au fost modificate
sau șterse între sync\-uri.
.PD
.PP
.PD 0
Fără snapshot\-uri, un fișier actualizat sau șters pe un disc sănătos
are ca rezultat lipsa unor blocuri de date care pot fi necesare pentru
a repara alte discuri defecte.
.PD
.RE
.RE
.PP
Snapshot\-urile sunt create doar pentru discurile de date și numai dacă sistemul de fișiere
subiacent acceptă această funcționalitate. Discurile de paritate folosesc întotdeauna
sistemul de fișiere live.
În prezent, acest lucru este acceptat pe Btrfs, Bcachefs și ZFS în Linux
și pe NTFS în Windows.
.PP
Puteți amesteca discuri de date cu sisteme de fișiere diferite. Doar cele care
acceptă snapshot\-uri le vor utiliza, în timp ce celelalte discuri vor continua
să funcționeze direct pe sistemul de fișiere live.
.PP
Crearea și ștergerea snapshot\-urilor necesită privilegii administrative.
Asigurați\-vă că SnapRAID este rulat cu permisiunile necesare (de exemplu, sudo)
atunci când snapshot\-urile sunt activate.
.SS Comportamentul comenzilor cu snapshot\-uri
Comenzile \`sync\` și \`scrub\` operează ambele exclusiv pe snapshot\-uri
pentru a se asigura că toate operațiunile de date sunt efectuate în raport cu o stare consistentă
și înghețată. Prin utilizarea acestor snapshot\-uri, SnapRAID previne neconcordanțele de paritate
care altfel ar fi declanșate de modificările concurente ale fișierelor pe sistemul de fișiere live.
În timpul unui \`sync\`, comanda folosește un snapshot nou creat la
începutul procesului pentru a captura starea curentă pentru calculul parității.
În schimb, comanda \`scrub\` utilizează ultimul snapshot, cel
creat în timpul celui mai recent sync, pentru a menține un punct de referință de încredere
care se potrivește cu paritatea existentă.
.PP
Pentru comenzile \`check\` și \`fix\`, utilizarea ultimului snapshot
depinde dacă anumite discuri sunt vizate folosind opțiunea
\-d, \-\-filter\-disk.
.PP
Un disc selectat în mod explicit prin \-d („ținta” operațiunii)
folosește întotdeauna sistemul de fișiere live. Pentru \`fix\`, acest lucru permite restaurarea
datelor pe discul de înlocuire activ. Pentru \`check\`, permite simularea
operațiunii \`fix\` în aceleași condiții.
.PP
Toate celelalte discuri de date (discurile de „referință”) vor fi accesate prin intermediul
snapshot\-urilor lor. Acest lucru asigură că, chiar dacă modificați fișiere
pe discurile sănătoase în timp ce o recuperare este în curs, SnapRAID
are o referință stabilă, înghețată pentru a rezolva ecuațiile de paritate.
.PP
Dacă nu este furnizată nicio opțiune \-d, SnapRAID presupune că operațiunea se aplică
întregii matrice, caz în care \`check\` și \`fix\` vor folosi exclusiv
sistemele de fișiere live.
.PP
Toate celelalte comenzi operează exclusiv pe sistemul de fișiere live.
.SH CICLUL DE VIAță AL SNAPSHOT\-URILOR
SnapRAID gestionează două snapshot\-uri specifice, \`stable\` și \`pending\`,
într\-un director ascuns la rădăcina fiecărui subvolum de date.
În Btrfs, Bcachefs și NTFS se folosește directorul \`.snapraid/\`,
în ZFS cel standard \`.zfs/snapshot/\`.
.PP
Snapshot\-ul \`stable\` reprezintă starea ultimului
\`sync\` finalizat cu succes, conținând datele exacte utilizate pentru
a calcula paritatea curentă. Acesta servește ca sursă principală de date
pentru comenzile \`scrub\`, \`check\` și \`fix\`.
.PP
Snapshot\-ul \`pending\` este o imagine temporară creată la începutul
unui \`sync\` pentru a oferi o stare înghețată pentru calculul parității.
După finalizarea cu succes a operațiunii, snapshot\-ul \`stable\` anterior
este șters, iar snapshot\-ul \`pending\` este promovat pentru
a\-i lua locul ca nouă referință stabilă.
.PP
Dacă un \`sync\` este întrerupt, snapshot\-ul \`pending\` este păstrat.
Comenzile ulterioare \`scrub\`, \`check\` și \`fix\` vor folosi acest
snapshot în așteptare, deoarece se potrivește cu starea sistemului de fișiere înregistrată în
fișierul .content, chiar dacă paritatea este sincronizată doar parțial.
.PP
În cazul unei întreruperi a \`sync\`, comenzile \`check\` și \`fix\`
citesc, de asemenea, din snapshot\-ul \`stable\` pentru a recupera blocurile de date
din fișierele care au fost actualizate sau șterse în timpul sync\-ului.
Acest lucru este posibil deoarece fișierul .content păstrează metadatele pentru
toate fișierele modificate sau șterse pe parcursul procesului de sync.
Aceste informații istorice sunt șterse numai după ce un sync se termină
cu succes și versiunea finală a fișierului .content este salvată.
.PP
Dacă un \`sync\` este repornit după o întrerupere, snapshot\-ul pending existent
este șters și se creează unul nou pentru
a captura starea curentă a sistemului de fișiere live.
.SH MODEL (PATTERN)
Modelele oferă o modalitate flexibilă de a filtra fișierele pentru includere sau
excludere. Folosind caractere de tip globbing, puteți defini reguli care să

View file

@ -52,21 +52,29 @@ Descriere
:https://www.snapraid.it/
Limitări
SnapRAID este un hibrid între un program RAID și unul de backup, care urmărește să combine
cele mai bune beneficii ale ambelor. Cu toate acestea, are unele limitări pe care ar trebui
SnapRAID este un hibrid între un RAID și un program de backup, având ca scop combinarea
celor mai bune avantaje ale ambelor. Cu toate acestea, are unele limitări pe care ar trebui
să le luați în considerare înainte de a-l utiliza.
Principala limitare este că, dacă un disc se defectează și nu ați făcut recent o sincronizare,
este posibil să nu puteți recupera complet.
Mai exact, este posibil să nu puteți recupera până la dimensiunea
fișierelor modificate sau șterse de la ultima operațiune de sincronizare.
Acest lucru se întâmplă chiar dacă fișierele modificate sau șterse nu sunt pe
discul defect. Acesta este motivul pentru care SnapRAID este mai potrivit pentru
date care se schimbă rar.
Principala limitare este că, dacă un disc se defectează, puteți recupera datele doar până la
starea ultimei operațiuni de `sync`. Orice date adăugate sau modificări efectuate
de la ultima sincronizare care se află pe discul defect vor fi pierdute.
Pe de altă parte, fișierele nou adăugate nu împiedică recuperarea fișierelor
deja existente. Veți pierde doar fișierele adăugate recent dacă acestea
se află pe discul defect.
Prin urmare, SnapRAID este potrivit în principal pentru date care se modifică rar.
Pentru datele care existau deja la ultima sincronizare, fiabilitatea recuperării depinde
de utilizarea sau nu a opțiunii `snapshot`:
* Cu suport pentru snapshot (disponibil pe Btrfs, ZFS, Bcachefs și NTFS),
SnapRAID poate menține automat o referință înghețată a discurilor de date.
Acest lucru asigură că, chiar dacă modificați sau ștergeți fișiere pe sistemul de fișiere live
în timpul sau după un sync, procesul de recuperare rămâne consistent și de încredere.
* Fără suport pentru snapshot, ștergerea sau modificarea fișierelor după un `sync`
poate împiedica recuperarea completă a altor discuri defecte. Acest lucru se întâmplă
deoarece paritatea nu mai corespunde cu fișierele modificate, chiar dacă
acele fișiere nu se află pe discul defect. Pe de altă parte, fișierele nou adăugate
nu împiedică recuperarea fișierelor deja existente.
Alte limitări ale SnapRAID sunt:
@ -382,11 +390,11 @@ Noțiuni de Bază
Comenzi
SnapRAID oferă câteva comenzi simple care vă permit să:
* Tipăriți starea matricei -> `status`
* Afișați starea matricei -> `status`
* Controlați discurile -> `smart`, `probe`, `up`, `down`
* Faceți un backup/snapshot -> `sync`
* Creați un punct de backup/recuperare -> `sync`
* Verificați periodic datele -> `scrub`
* Restaurați ultimul backup/snapshot -> `fix`.
* Restaurați ultimul punct de backup/recuperare -> `fix`.
Comenzile trebuie scrise cu litere mici.
@ -591,13 +599,12 @@ Comenzi
fix
Repară toate fișierele și datele de paritate.
Toate fișierele și datele de paritate sunt comparate cu starea snapshot-ului
salvată la ultima `sync`.
Dacă se găsește o diferență, este readusă la snapshot-ul stocat.
Toate fișierele și datele de paritate sunt comparate cu starea salvată în
ultimul `sync`. Dacă se găsește o diferență, aceasta este readusă la starea stocată.
ATENȚIE! Comanda `fix` nu face diferența între erori și
modificări intenționate. Ea revine necondiționat la starea fișierului
de la ultima `sync`.
AVERTISMENT!
Comanda `fix` nu face diferența între erori și modificări intenționate.
Ea revine necondiționat la starea fișierelor de la ultimul `sync`.
Dacă nu este specificată nicio altă opțiune, întreaga matrice este procesată.
Utilizați opțiunile de filtrare pentru a selecta un subset de fișiere sau discuri de operat.
@ -1146,6 +1153,31 @@ Configurare
Rețineți că astfel de discuri nu sunt afectate de comenzile `up` și
`down` deoarece se așteaptă ca acestea să se rotească mereu.
snapshot
Activează utilizarea snapshot-urilor sistemului de fișiere pentru comenzile `sync`, `scrub`,
`check` și `fix`.
Când este activată, SnapRAID creează un snapshot read-only al datelor dvs. la
începutul unui 'sync'. Acest lucru asigură o vizualizare consistentă, la un anumit moment în timp, a
fișierelor dvs., prevenind erorile cauzate de modificările concurente ale fișierelor.
Acest lucru îmbunătățește semnificativ recuperarea: dacă un fișier este șters din sistemul de fișiere live,
el rămâne păstrat în snapshot. Acest lucru previne ca paritatea să devină „ruptă”
pentru acel bloc, asigurându-vă că puteți recupera cu succes datele
dacă un alt disc se defectează.
Această opțiune se aplică exclusiv discurilor de date formatate cu sistemele de
fișiere Btrfs, Bcachefs sau ZFS în Linux și NTFS în Windows.
Discurile de paritate, sau discurile de date care utilizează alte sisteme de fișiere, vor folosi întotdeauna
versiunea live a sistemului de fișiere.
Crearea și ștergerea snapshot-urilor necesită privilegii administrative.
Asigurați-vă că SnapRAID este rulat cu permisiunile necesare (de exemplu, sudo) când
această opțiune este activată.
Consultați secțiunea SNAPSHOTS pentru o explicație detaliată a ciclului de viață
al snapshot-urilor.
nohidden
Exclude toate fișierele și directoarele ascunse.
În Unix, fișierele ascunse sunt cele care încep cu `.`.
@ -1383,6 +1415,117 @@ Configurare
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots
Dacă opțiunea snapshot este activată în configurație, SnapRAID
utilizează funcționalitatea de snapshot a sistemului de fișiere pentru a asigura operațiuni atomice
și consistente.
Gestionarea snapshot-urilor este complet automată și transparentă.
Puteți continua să utilizați SnapRAID exact ca înainte, cu protecția
suplimentară oferită de snapshot-uri gestionate în întregime în
background.
Acest lucru oferă două avantaje principale:
Consistență - Fișierele modificate pe sistemul de fișiere live în timpul unui sync sau scrub
de lungă durată nu vor cauza nepotriviri de paritate sau operațiuni abandonate,
deoarece SnapRAID vede o imagine înghețată la un anumit moment în timp.
Recuperare - Dacă un fișier este actualizat sau șters din sistemul de fișiere live,
el rămâne păstrat în snapshot. Dacă se produce o defecțiune a discului
înainte de rularea următorului sync, SnapRAID utilizează datele păstrate
în snapshot pentru a reconstrui discul defect.
În cazul unei defecțiuni a discului în timpul unui proces de sync activ,
SnapRAID este, de asemenea, capabil să citească automat atât din snapshot-ul
calculului anterior de paritate, cât și din cel curent.
Acest lucru maximizează probabilitatea unei recuperări complete prin
oferirea accesului la blocurile exacte de date necesare pentru a rezolva
ecuațiile de paritate, chiar dacă acele blocuri au fost modificate
sau șterse între sync-uri.
Fără snapshot-uri, un fișier actualizat sau șters pe un disc sănătos
are ca rezultat lipsa unor blocuri de date care pot fi necesare pentru
a repara alte discuri defecte.
Snapshot-urile sunt create doar pentru discurile de date și numai dacă sistemul de fișiere
subiacent acceptă această funcționalitate. Discurile de paritate folosesc întotdeauna
sistemul de fișiere live.
În prezent, acest lucru este acceptat pe Btrfs, Bcachefs și ZFS în Linux
și pe NTFS în Windows.
Puteți amesteca discuri de date cu sisteme de fișiere diferite. Doar cele care
acceptă snapshot-uri le vor utiliza, în timp ce celelalte discuri vor continua
să funcționeze direct pe sistemul de fișiere live.
Crearea și ștergerea snapshot-urilor necesită privilegii administrative.
Asigurați-vă că SnapRAID este rulat cu permisiunile necesare (de exemplu, sudo)
atunci când snapshot-urile sunt activate.
Comportamentul comenzilor cu snapshot-uri
Comenzile `sync` și `scrub` operează ambele exclusiv pe snapshot-uri
pentru a se asigura că toate operațiunile de date sunt efectuate în raport cu o stare consistentă
și înghețată. Prin utilizarea acestor snapshot-uri, SnapRAID previne neconcordanțele de paritate
care altfel ar fi declanșate de modificările concurente ale fișierelor pe sistemul de fișiere live.
În timpul unui `sync`, comanda folosește un snapshot nou creat la
începutul procesului pentru a captura starea curentă pentru calculul parității.
În schimb, comanda `scrub` utilizează ultimul snapshot, cel
creat în timpul celui mai recent sync, pentru a menține un punct de referință de încredere
care se potrivește cu paritatea existentă.
Pentru comenzile `check` și `fix`, utilizarea ultimului snapshot
depinde dacă anumite discuri sunt vizate folosind opțiunea
-d, --filter-disk.
Un disc selectat în mod explicit prin -d („ținta” operațiunii)
folosește întotdeauna sistemul de fișiere live. Pentru `fix`, acest lucru permite restaurarea
datelor pe discul de înlocuire activ. Pentru `check`, permite simularea
operațiunii `fix` în aceleași condiții.
Toate celelalte discuri de date (discurile de „referință”) vor fi accesate prin intermediul
snapshot-urilor lor. Acest lucru asigură că, chiar dacă modificați fișiere
pe discurile sănătoase în timp ce o recuperare este în curs, SnapRAID
are o referință stabilă, înghețată pentru a rezolva ecuațiile de paritate.
Dacă nu este furnizată nicio opțiune -d, SnapRAID presupune că operațiunea se aplică
întregii matrice, caz în care `check` și `fix` vor folosi exclusiv
sistemele de fișiere live.
Toate celelalte comenzi operează exclusiv pe sistemul de fișiere live.
Ciclul de viață al snapshot-urilor
SnapRAID gestionează două snapshot-uri specifice, `stable` și `pending`,
într-un director ascuns la rădăcina fiecărui subvolum de date.
În Btrfs, Bcachefs și NTFS se folosește directorul `.snapraid/`,
în ZFS cel standard `.zfs/snapshot/`.
Snapshot-ul `stable` reprezintă starea ultimului
`sync` finalizat cu succes, conținând datele exacte utilizate pentru
a calcula paritatea curentă. Acesta servește ca sursă principală de date
pentru comenzile `scrub`, `check` și `fix`.
Snapshot-ul `pending` este o imagine temporară creată la începutul
unui `sync` pentru a oferi o stare înghețată pentru calculul parității.
După finalizarea cu succes a operațiunii, snapshot-ul `stable` anterior
este șters, iar snapshot-ul `pending` este promovat pentru
a-i lua locul ca nouă referință stabilă.
Dacă un `sync` este întrerupt, snapshot-ul `pending` este păstrat.
Comenzile ulterioare `scrub`, `check` și `fix` vor folosi acest
snapshot în așteptare, deoarece se potrivește cu starea sistemului de fișiere înregistrată în
fișierul .content, chiar dacă paritatea este sincronizată doar parțial.
În cazul unei întreruperi a `sync`, comenzile `check` și `fix`
citesc, de asemenea, din snapshot-ul `stable` pentru a recupera blocurile de date
din fișierele care au fost actualizate sau șterse în timpul sync-ului.
Acest lucru este posibil deoarece fișierul .content păstrează metadatele pentru
toate fișierele modificate sau șterse pe parcursul procesului de sync.
Aceste informații istorice sunt șterse numai după ce un sync se termină
cu succes și versiunea finală a fișierului .content este salvată.
Dacă un `sync` este repornit după o întrerupere, snapshot-ul pending existent
este șters și se creează unul nou pentru
a captura starea curentă a sistemului de fișiere live.
Model (Pattern)
Modelele oferă o modalitate flexibilă de a filtra fișierele pentru includere sau
excludere. Folosind caractere de tip globbing, puteți defini reguli care să

View file

@ -62,21 +62,29 @@ Pentru mai multe informații, vă rugăm să vizitați site-ul oficial SnapRAID:
3 LIMITăRI
==========
SnapRAID este un hibrid între un program RAID și unul de backup, care urmărește să combine
cele mai bune beneficii ale ambelor. Cu toate acestea, are unele limitări pe care ar trebui
SnapRAID este un hibrid între un RAID și un program de backup, având ca scop combinarea
celor mai bune avantaje ale ambelor. Cu toate acestea, are unele limitări pe care ar trebui
să le luați în considerare înainte de a-l utiliza.
Principala limitare este că, dacă un disc se defectează și nu ați făcut recent o sincronizare,
este posibil să nu puteți recupera complet.
Mai exact, este posibil să nu puteți recupera până la dimensiunea
fișierelor modificate sau șterse de la ultima operațiune de sincronizare.
Acest lucru se întâmplă chiar dacă fișierele modificate sau șterse nu sunt pe
discul defect. Acesta este motivul pentru care SnapRAID este mai potrivit pentru
date care se schimbă rar.
Principala limitare este că, dacă un disc se defectează, puteți recupera datele doar până la
starea ultimei operațiuni de `sync`. Orice date adăugate sau modificări efectuate
de la ultima sincronizare care se află pe discul defect vor fi pierdute.
Pe de altă parte, fișierele nou adăugate nu împiedică recuperarea fișierelor
deja existente. Veți pierde doar fișierele adăugate recent dacă acestea
se află pe discul defect.
Prin urmare, SnapRAID este potrivit în principal pentru date care se modifică rar.
Pentru datele care existau deja la ultima sincronizare, fiabilitatea recuperării depinde
de utilizarea sau nu a opțiunii `snapshot`:
* Cu suport pentru snapshot (disponibil pe Btrfs, ZFS, Bcachefs și NTFS),
SnapRAID poate menține automat o referință înghețată a discurilor de date.
Acest lucru asigură că, chiar dacă modificați sau ștergeți fișiere pe sistemul de fișiere live
în timpul sau după un sync, procesul de recuperare rămâne consistent și de încredere.
* Fără suport pentru snapshot, ștergerea sau modificarea fișierelor după un `sync`
poate împiedica recuperarea completă a altor discuri defecte. Acest lucru se întâmplă
deoarece paritatea nu mai corespunde cu fișierele modificate, chiar dacă
acele fișiere nu se află pe discul defect. Pe de altă parte, fișierele nou adăugate
nu împiedică recuperarea fișierelor deja existente.
Alte limitări ale SnapRAID sunt:
@ -406,11 +414,11 @@ Dacă totul este recuperat, această comandă este imediată.
SnapRAID oferă câteva comenzi simple care vă permit să:
* Tipăriți starea matricei -> `status`
* Afișați starea matricei -> `status`
* Controlați discurile -> `smart`, `probe`, `up`, `down`
* Faceți un backup/snapshot -> `sync`
* Creați un punct de backup/recuperare -> `sync`
* Verificați periodic datele -> `scrub`
* Restaurați ultimul backup/snapshot -> `fix`.
* Restaurați ultimul punct de backup/recuperare -> `fix`.
Comenzile trebuie scrise cu litere mici.
@ -633,13 +641,12 @@ Fișierele din matrice NU sunt modificate.
Repară toate fișierele și datele de paritate.
Toate fișierele și datele de paritate sunt comparate cu starea snapshot-ului
salvată la ultima `sync`.
Dacă se găsește o diferență, este readusă la snapshot-ul stocat.
Toate fișierele și datele de paritate sunt comparate cu starea salvată în
ultimul `sync`. Dacă se găsește o diferență, aceasta este readusă la starea stocată.
ATENȚIE! Comanda `fix` nu face diferența între erori și
modificări intenționate. Ea revine necondiționat la starea fișierului
de la ultima `sync`.
AVERTISMENT!
Comanda `fix` nu face diferența între erori și modificări intenționate.
Ea revine necondiționat la starea fișierelor de la ultimul `sync`.
Dacă nu este specificată nicio altă opțiune, întreaga matrice este procesată.
Utilizați opțiunile de filtrare pentru a selecta un subset de fișiere sau discuri de operat.
@ -1222,14 +1229,41 @@ sistemului, cum ar fi discul de pornire.
Rețineți că astfel de discuri nu sunt afectate de comenzile `up` și
`down` deoarece se așteaptă ca acestea să se rotească mereu.
7.7 nohidden
7.7 snapshot
------------
Activează utilizarea snapshot-urilor sistemului de fișiere pentru comenzile `sync`, `scrub`,
`check` și `fix`.
Când este activată, SnapRAID creează un snapshot read-only al datelor dvs. la
începutul unui 'sync'. Acest lucru asigură o vizualizare consistentă, la un anumit moment în timp, a
fișierelor dvs., prevenind erorile cauzate de modificările concurente ale fișierelor.
Acest lucru îmbunătățește semnificativ recuperarea: dacă un fișier este șters din sistemul de fișiere live,
el rămâne păstrat în snapshot. Acest lucru previne ca paritatea să devină „ruptă”
pentru acel bloc, asigurându-vă că puteți recupera cu succes datele
dacă un alt disc se defectează.
Această opțiune se aplică exclusiv discurilor de date formatate cu sistemele de
fișiere Btrfs, Bcachefs sau ZFS în Linux și NTFS în Windows.
Discurile de paritate, sau discurile de date care utilizează alte sisteme de fișiere, vor folosi întotdeauna
versiunea live a sistemului de fișiere.
Crearea și ștergerea snapshot-urilor necesită privilegii administrative.
Asigurați-vă că SnapRAID este rulat cu permisiunile necesare (de exemplu, sudo) când
această opțiune este activată.
Consultați secțiunea SNAPSHOTS pentru o explicație detaliată a ciclului de viață
al snapshot-urilor.
7.8 nohidden
------------
Exclude toate fișierele și directoarele ascunse.
În Unix, fișierele ascunse sunt cele care încep cu `.`.
În Windows, sunt cele cu atributul ascuns.
7.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
Definește modelele de fișiere sau directoare de exclus sau inclus
@ -1247,8 +1281,8 @@ specificațiile modelului.
Această opțiune poate fi utilizată de mai multe ori.
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
Definește dimensiunea de bază a blocului în kibibytes pentru paritate.
Un kibibyte este 1024 de octeți.
@ -1295,7 +1329,7 @@ Acest lucru duce la aproximativ 1,5% spațiu suplimentar, aproximativ 60 GB pent
un disc de 4 TB, ceea ce permite aproximativ 460.000 de fișiere pe fiecare disc de date fără
niciun spațiu irosit.
7.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
Definește dimensiunea hash-ului în octeți pentru blocurile salvate.
@ -1333,7 +1367,7 @@ Trecând la ambele, o dimensiune de hash de 8 și o dimensiune de bloc de 512, o
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
Salvează automat starea la sincronizare sau verificare după
@ -1341,7 +1375,7 @@ cantitatea specificată de GB procesați.
Această opțiune este utilă pentru a evita repornirea comenzilor `sync` lungi
de la zero dacă sunt întrerupte de o cădere a mașinii sau de orice alt eveniment.
7.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
Setează temperatura maximă permisă a discului în Celsius. Când este specificată,
@ -1372,14 +1406,14 @@ cea mai scăzută temperatură a discului măsurată la începutul rulării ca r
În mod normal, SnapRAID arată doar temperatura celui mai fierbinte disc.
Pentru a afișa temperatura tuturor discurilor, utilizați opțiunea -A sau --stats.
7.13 temp_sleep TIME_IN_MINUTES
7.14 temp_sleep TIME_IN_MINUTES
-------------------------------
Setează timpul de așteptare (standby), în minute, când limita de temperatură este
atinsă. În această perioadă, discurile rămân oprite. Valoarea implicită
este 5 minute.
7.14 pool DIR
7.15 pool DIR
-------------
Definește directorul de pooling unde este creată vizualizarea virtuală a matricei
@ -1387,7 +1421,7 @@ de discuri utilizând comanda `pool`.
Directorul trebuie să existe deja.
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
Definește calea UNC Windows necesară pentru a accesa discurile de la distanță.
@ -1403,7 +1437,7 @@ directorul și numele fișierului.
Această opțiune este necesară doar pentru Windows.
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
Definește opțiuni smartctl personalizate pentru a obține atributele SMART pentru
@ -1428,7 +1462,7 @@ De exemplu:
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
Ignoră atributul SMART specificat la calcularea probabilității
@ -1449,7 +1483,7 @@ Pentru a-l ignora doar pe primul disc de paritate:
smartignore parity 197
7.18 Exemple
7.19 Exemple
------------
Un exemplu de configurare tipică pentru Unix este:
@ -1484,8 +1518,127 @@ Un exemplu de configurare tipică pentru Windows este:
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 MODEL (PATTERN)
=================
8 SNAPSHOTS
===========
Dacă opțiunea snapshot este activată în configurație, SnapRAID
utilizează funcționalitatea de snapshot a sistemului de fișiere pentru a asigura operațiuni atomice
și consistente.
Gestionarea snapshot-urilor este complet automată și transparentă.
Puteți continua să utilizați SnapRAID exact ca înainte, cu protecția
suplimentară oferită de snapshot-uri gestionate în întregime în
background.
Acest lucru oferă două avantaje principale:
Consistență - Fișierele modificate pe sistemul de fișiere live în timpul unui sync sau scrub
de lungă durată nu vor cauza nepotriviri de paritate sau operațiuni abandonate,
deoarece SnapRAID vede o imagine înghețată la un anumit moment în timp.
Recuperare - Dacă un fișier este actualizat sau șters din sistemul de fișiere live,
el rămâne păstrat în snapshot. Dacă se produce o defecțiune a discului
înainte de rularea următorului sync, SnapRAID utilizează datele păstrate
în snapshot pentru a reconstrui discul defect.
În cazul unei defecțiuni a discului în timpul unui proces de sync activ,
SnapRAID este, de asemenea, capabil să citească automat atât din snapshot-ul
calculului anterior de paritate, cât și din cel curent.
Acest lucru maximizează probabilitatea unei recuperări complete prin
oferirea accesului la blocurile exacte de date necesare pentru a rezolva
ecuațiile de paritate, chiar dacă acele blocuri au fost modificate
sau șterse între sync-uri.
Fără snapshot-uri, un fișier actualizat sau șters pe un disc sănătos
are ca rezultat lipsa unor blocuri de date care pot fi necesare pentru
a repara alte discuri defecte.
Snapshot-urile sunt create doar pentru discurile de date și numai dacă sistemul de fișiere
subiacent acceptă această funcționalitate. Discurile de paritate folosesc întotdeauna
sistemul de fișiere live.
În prezent, acest lucru este acceptat pe Btrfs, Bcachefs și ZFS în Linux
și pe NTFS în Windows.
Puteți amesteca discuri de date cu sisteme de fișiere diferite. Doar cele care
acceptă snapshot-uri le vor utiliza, în timp ce celelalte discuri vor continua
să funcționeze direct pe sistemul de fișiere live.
Crearea și ștergerea snapshot-urilor necesită privilegii administrative.
Asigurați-vă că SnapRAID este rulat cu permisiunile necesare (de exemplu, sudo)
atunci când snapshot-urile sunt activate.
8.1 Comportamentul comenzilor cu snapshot-uri
---------------------------------------------
Comenzile `sync` și `scrub` operează ambele exclusiv pe snapshot-uri
pentru a se asigura că toate operațiunile de date sunt efectuate în raport cu o stare consistentă
și înghețată. Prin utilizarea acestor snapshot-uri, SnapRAID previne neconcordanțele de paritate
care altfel ar fi declanșate de modificările concurente ale fișierelor pe sistemul de fișiere live.
În timpul unui `sync`, comanda folosește un snapshot nou creat la
începutul procesului pentru a captura starea curentă pentru calculul parității.
În schimb, comanda `scrub` utilizează ultimul snapshot, cel
creat în timpul celui mai recent sync, pentru a menține un punct de referință de încredere
care se potrivește cu paritatea existentă.
Pentru comenzile `check` și `fix`, utilizarea ultimului snapshot
depinde dacă anumite discuri sunt vizate folosind opțiunea
-d, --filter-disk.
Un disc selectat în mod explicit prin -d („ținta” operațiunii)
folosește întotdeauna sistemul de fișiere live. Pentru `fix`, acest lucru permite restaurarea
datelor pe discul de înlocuire activ. Pentru `check`, permite simularea
operațiunii `fix` în aceleași condiții.
Toate celelalte discuri de date (discurile de „referință”) vor fi accesate prin intermediul
snapshot-urilor lor. Acest lucru asigură că, chiar dacă modificați fișiere
pe discurile sănătoase în timp ce o recuperare este în curs, SnapRAID
are o referință stabilă, înghețată pentru a rezolva ecuațiile de paritate.
Dacă nu este furnizată nicio opțiune -d, SnapRAID presupune că operațiunea se aplică
întregii matrice, caz în care `check` și `fix` vor folosi exclusiv
sistemele de fișiere live.
Toate celelalte comenzi operează exclusiv pe sistemul de fișiere live.
9 CICLUL DE VIAță AL SNAPSHOT-URILOR
====================================
SnapRAID gestionează două snapshot-uri specifice, `stable` și `pending`,
într-un director ascuns la rădăcina fiecărui subvolum de date.
În Btrfs, Bcachefs și NTFS se folosește directorul `.snapraid/`,
în ZFS cel standard `.zfs/snapshot/`.
Snapshot-ul `stable` reprezintă starea ultimului
`sync` finalizat cu succes, conținând datele exacte utilizate pentru
a calcula paritatea curentă. Acesta servește ca sursă principală de date
pentru comenzile `scrub`, `check` și `fix`.
Snapshot-ul `pending` este o imagine temporară creată la începutul
unui `sync` pentru a oferi o stare înghețată pentru calculul parității.
După finalizarea cu succes a operațiunii, snapshot-ul `stable` anterior
este șters, iar snapshot-ul `pending` este promovat pentru
a-i lua locul ca nouă referință stabilă.
Dacă un `sync` este întrerupt, snapshot-ul `pending` este păstrat.
Comenzile ulterioare `scrub`, `check` și `fix` vor folosi acest
snapshot în așteptare, deoarece se potrivește cu starea sistemului de fișiere înregistrată în
fișierul .content, chiar dacă paritatea este sincronizată doar parțial.
În cazul unei întreruperi a `sync`, comenzile `check` și `fix`
citesc, de asemenea, din snapshot-ul `stable` pentru a recupera blocurile de date
din fișierele care au fost actualizate sau șterse în timpul sync-ului.
Acest lucru este posibil deoarece fișierul .content păstrează metadatele pentru
toate fișierele modificate sau șterse pe parcursul procesului de sync.
Aceste informații istorice sunt șterse numai după ce un sync se termină
cu succes și versiunea finală a fișierului .content este salvată.
Dacă un `sync` este repornit după o întrerupere, snapshot-ul pending existent
este șters și se creează unul nou pentru
a captura starea curentă a sistemului de fișiere live.
10 MODEL (PATTERN)
==================
Modelele oferă o modalitate flexibilă de a filtra fișierele pentru includere sau
excludere. Folosind caractere de tip globbing, puteți defini reguli care să
@ -1603,8 +1756,8 @@ De exemplu:
să le citați pentru a împiedica shell-ul să le extindă.
9 FIșIERE DE IGNORAT (IGNORE FILE)
==================================
11 FIșIERE DE IGNORAT (IGNORE FILE)
===================================
Pe lângă regulile globale din fișierul de configurare, puteți plasa fișiere
`.snapraidignore` în orice director din array pentru a defini reguli de excludere
@ -1648,7 +1801,7 @@ De exemplu, dacă aveți un `.snapraidignore` în `/mnt/disk1/projects/`:
*.tmp
10 CONțINUT (CONTENT)
12 CONțINUT (CONTENT)
=====================
SnapRAID stochează lista și sumele de control (checksums) ale fișierelor dvs. în fișierul de conținut.
@ -1660,7 +1813,7 @@ Acest fișier este citit și scris de comenzile `sync` și `scrub` și
citit de comenzile `fix`, `check` și `status`.
11 PARITATE (PARITY)
13 PARITATE (PARITY)
====================
SnapRAID stochează informațiile de paritate ale matricei dvs. în fișierele de paritate.
@ -1672,7 +1825,7 @@ Aceste fișiere sunt citite și scrise de comenzile `sync` și `fix` și
doar citite de comenzile `scrub` și `check`.
12 CODARE (ENCODING)
14 CODARE (ENCODING)
====================
SnapRAID în Unix ignoră orice codare. Citește și stochează
@ -1689,13 +1842,13 @@ redirecționați ieșirea consolei către un fișier, fișierul rezultat este î
în format UTF-8.
13 DREPT DE AUTOR (COPYRIGHT)
15 DREPT DE AUTOR (COPYRIGHT)
=============================
Acest fișier este Copyright (C) 2025 Andrea Mazzoleni
14 VEZI șI (SEE ALSO)
16 VEZI șI (SEE ALSO)
=====================
snapraid_log(1), snapraidd(1)

View file

@ -116,22 +116,34 @@ https://www.snapraid.it/
.PD 0
.PD
.RE
.SH LIMITATIONS
SnapRAID — это гибрид программы RAID и программы резервного копирования,
стремящийся объединить лучшие преимущества обеих. Однако у него есть
некоторые ограничения, которые следует учитывать перед использованием.
.SH Ограничения
SnapRAID — это гибрид между RAID и программой резервного копирования, стремящийся сочетать
в себе лучшие преимущества обоих подходов. Однако у него есть некоторые ограничения, которые вам
следует учесть перед использованием.
.PP
Основное ограничение заключается в том, что если диск выходит из строя, а вы
недавно не выполняли синхронизацию, вы можете не восстановить данные полностью.
В частности, вы можете не восстановить данные в объеме, равном размеру
измененных или удаленных файлов с момента последней операции синхронизации.
Это происходит, даже если измененные или удаленные файлы не находятся
на отказавшем диске. Вот почему SnapRAID лучше подходит для
данных, которые редко меняются.
Основное ограничение заключается в том, что в случае сбоя диска вы можете восстановить данные только до
состояния последней операции синхронизации (\`sync\`). Любые данные, добавленные или измененные
с момента последней синхронизации и находящиеся на давшем сбой диске, будут потеряны.
.PP
С другой стороны, недавно добавленные файлы не препятствуют восстановлению уже
существующих файлов. Вы потеряете только недавно добавленные файлы,
если они находятся на отказавшем диске.
Следовательно, SnapRAID в первую очередь подходит для данных, которые редко меняются.
.PP
Для данных, которые уже существовали на момент последней синхронизации, надежность восстановления зависит
от того, используется ли опция снимка (\`snapshot\`):
.PD 0
.IP \(bu
При наличии поддержки снимков (доступно на Btrfs, ZFS, Bcachefs и NTFS),
SnapRAID может автоматически поддерживать замороженную копию ваших дисков с данными.
Это гарантирует, что даже если вы измените или удалите файлы в вашей живой файловой системе
во время или после синхронизации, процесс восстановления останется согласованным и надежным.
.PD
.PD 0
.IP \(bu
Без поддержки снимков удаление или изменение файлов после \`sync\`
может предотвратить полное восстановление других дисков, давших сбой. Это происходит
потому, что четность больше не соответствует измененным файлам, даже если
эти файлы находятся не на давшем сбой диске. С другой стороны, недавно добавленные
файлы не препятствуют восстановлению уже существующих файлов.
.PD
.PP
Другие ограничения SnapRAID:
.PD 0
@ -641,22 +653,22 @@ snapraid sync
.RE
.PP
Если все восстановлено, эта команда выполняется немедленно.
.SH COMMANDS
.SH Команды
SnapRAID предоставляет несколько простых команд, которые позволяют:
.PD 0
.IP \(bu
Печатать статус массива \-> \`status\`
Вывести статус массива \-> \`status\`
.IP \(bu
Управлять дисками \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
Сделать резервную копию/снимок \-> \`sync\`
Создать точку резервного копирования/восстановления \-> \`sync\`
.IP \(bu
Периодически проверять данные \-> \`scrub\`
.IP \(bu
Восстановить последнюю резервную копию/снимок \-> \`fix\`.
Восстановить последнюю точку резервного копирования/восстановления \-> \`fix\`.
.PD
.PP
Команды должны быть написаны строчными буквами.
Команды должны быть написаны строчными (маленькими) буквами.
.SS status
Печатает сводку состояния дискового массива.
.PP
@ -884,15 +896,14 @@ full \- Проверить все.
Файлы \`parity\` НЕ изменяются.
Файлы в массиве НЕ изменяются.
.SS fix
Исправляет все файлы и данные четности.
Восстанавливает все файлы и данные четности.
.PP
Все файлы и данные четности сравниваются с состоянием снимка,
сохраненным при последнем \`sync\`.
Если обнаружено различие, оно возвращается к сохраненному снимку.
Все файлы и данные четности сравниваются с состоянием, сохраненным во время
последней синхронизации \`sync\`. Если обнаружено отличие, оно возвращается к сохраненному состоянию.
.PP
ВНИМАНИЕ! Команда \`fix\` не различает ошибки и
преднамеренные изменения. Она безусловно возвращает состояние файла
к последнему \`sync\`.
ВНИМАНИЕ!
Команда \`fix\` не делает различий между ошибками и преднамеренными изменениями.
Она безоговорочно возвращает состояние файлов к моменту последней \`sync\`.
.PP
Если не указана другая опция, обрабатывается весь массив.
Используйте опции фильтрации, чтобы выбрать подмножество файлов или дисков для работы.
@ -1427,6 +1438,29 @@ UUID дисков.
.PP
Обратите внимание, что такие диски не затрагиваются командами \`up\` и
\`down\`, так как предполагается, что они всегда вращаются.
.SS snapshot
Включает использование снимков файловой системы для команд \`sync\`, \`scrub\`,
\`check\` и \`fix\`.
.PP
Если опция включена, SnapRAID создает снимок ваших данных только для чтения в
начале операции \'sync\'. Это обеспечивает согласованный срез ваших файлов на определенный
момент времени, предотвращая ошибки, вызванные одновременным изменением файлов.
.PP
Это значительно улучшает восстановление: если файл удаляется из живой файловой системы,
он остается сохраненным в снимке. Это предотвращает «нарушение» четности
для этого блока, гарантируя, что вы все еще сможете успешно восстановить данные
в случае сбоя другого диска.
.PP
Эта опция применяется исключительно к дискам с данными, отформатированным в файловых
системах Btrfs, Bcachefs или ZFS в Linux и NTFS в Windows.
Диски четности или диски с данными, использующие другие файловые системы, всегда будут использовать
живую версию файловой системы.
.PP
Создание и удаление снимков требуют прав администратора.
Убедитесь, что SnapRAID запущен с необходимыми привилегиями (например, sudo), когда
включена эта опция.
.PP
Подробное объяснение жизненного цикла снимков см. в разделе SNAPSHOTS.
.SS nohidden
Исключает все скрытые файлы и каталоги.
В Unix скрытые файлы — это те, которые начинаются с \`.\`.
@ -1762,6 +1796,124 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS (Снимки)
Если в конфигурации включена опция снимков, SnapRAID использует
функциональность снимков файловой системы для обеспечения атомарности и
согласованности операций.
.PP
Управление снимками происходит полностью автоматически и прозрачно.
Вы можете продолжать использовать SnapRAID точно так же, как и раньше, получая
дополнительную защиту, обеспечиваемую снимками, которые полностью обрабатываются в
фоновом режиме.
.PP
Это дает два основных преимущества:
.PP
Согласованность — Файлы, измененные в живой файловой системе во время длительного
.PP
.RS 4
процесса sync или scrub, не вызовут несоответствия четности или прерывания
операций, поскольку SnapRAID видит замороженный снимок на момент времени.
.RE
.PP
Восстановление — Если файл обновляется или удаляется из живой файловой системы,
.PP
.RS 4
он остается сохраненным в снимке. Если сбой диска произойдет
до запуска следующей синхронизации sync, SnapRAID использует данные, сохраненные
в снимке, для реконструкции давшего сбой диска.
.RE
.PP
.RS 4
В случае сбоя диска во время активного процесса sync,
SnapRAID также может автоматически читать как из снимка предыдущего
вычисления четности, так и из текущего.
Это максимизирует вероятность полного восстановления, предоставляя
доступ к точным блокам данных, необходимым для решения уравнений четности,
даже если эти блоки были изменены или удалены между синхронизациями.
.RE
.PP
.RS 4
Без снимков обновленный или удаленный файл на исправном диске
приводит к отсутствию блоков данных, которые могут потребоваться для
восстановления других дисков, давших сбой.
.RE
.PP
Снимки создаются только для дисков с данными и только в том случае, если базовая
файловая система поддерживает эту функциональность. Диски четности всегда используют
живую файловую систему.
В настоящее время это поддерживается на Btrfs, Bcachefs и ZFS в Linux
и на NTFS в Windows.
.PP
Вы можете комбинировать диски с данными с различными файловыми системами. Только те из них,
которые поддерживают снимки, будут использовать их, в то время как другие диски продолжат
работать напрямую с живой файловой системой.
.PP
Создание и удаление снимков требуют прав администратора.
Убедитесь, что SnapRAID запущен с необходимыми привилегиями (например, sudo),
когда снимки включены.
.SS Поведение команд при использовании снимков
Команды \`sync\` и \`scrub\` работают исключительно со снимками,
чтобы гарантировать, что все операции с данными выполняются на согласованном,
замороженном состоянии. Используя эти снимки, SnapRAID предотвращает несоответствия
четности, которые в противном случае были бы вызваны одновременными изменениями файлов в живой файловой системе.
Во время \`sync\` команда использует новый снимок, созданный в начале
процесса, для фиксации текущего состояния для вычисления четности.
Напротив, команда \`scrub\` использует последний снимок, созданный во время
самой последней синхронизации, чтобы поддерживать надежную точку отсчета,
соответствующую существующей четности.
.PP
Для команд \`check\` и \`fix\` использование последнего снимка
зависит от того, нацелены ли конкретные диски с помощью опции
\-d, \-\-filter\-disk.
.PP
Диск, явно выбранный с помощью \-d («цель» операции),
всегда использует живую файловую систему. Для \`fix\` это позволяет восстановить
данные на активную замену диска. Для \`check\` это позволяет симулировать
операцию \`fix\` при тех же условиях.
.PP
Доступ ко всем остальным дискам с данными («справочным» дискам) будет осуществляться через
их снимки. Это гарантирует, что даже если вы изменяете файлы
на своих исправных дисках во время восстановления, SnapRAID
имеет стабильную, замороженную точку отсчета для решения уравнений четности.
.PP
Если опция \-d не предоставлена, SnapRAID предполагает, что операция применяется
ко всему массиву; в этом случае \`check\` и \`fix\` будут использовать исключительно
живые файловые системы.
.PP
Все остальные команды работают исключительно с живой файловой системой.
.SH Жизненный цикл снимков
SnapRAID управляет двумя конкретными снимками, \`stable\` и \`pending\`,
внутри скрытого каталога в корне каждого подтома данных.
В Btrfs, Bcachefs и NTFS используется каталог \`.snapraid/\`,
в ZFS — стандартный \`.zfs/snapshot/\`.
.PP
Снимок \`stable\` представляет собой состояние последней успешно
завершенной синхронизации \`sync\`, содержащей точные данные, использованные для
вычисления текущей четности. Он служит основным источником данных
для команд \`scrub\`, \`check\` и \`fix\`.
.PP
Снимок \`pending\` — это временный образ, создаваемый в начале
\`sync\` для обеспечения замороженного состояния для вычисления четности.
После успешного завершения операции предыдущий снимок \`stable\`
удаляется, а снимок \`pending\` повышается в статусе, чтобы
занять его место в качестве нового стабильного ориентира.
.PP
Если процесс \`sync\` прерывается, снимок \`pending\` сохраняется.
Последующие команды \`scrub\`, \`check\` и \`fix\` будут использовать этот
ожидающий снимок, так как он соответствует состоянию файловой системы, записанному в
файле .content, даже если четность синхронизирована лишь частично.
.PP
В случае прерывания \`sync\` команды \`check\` и \`fix\`
также читают данные из снимка \`stable\` для извлечения блоков данных
из файлов, которые были обновлены или удалены во время синхронизации.
Это возможно потому, что файл .content сохраняет метаданные для
всех измененных или удаленных файлов на протяжении всего процесса sync.
Эта историческая информация очищается только после успешного завершения sync
и сохранения финальной версии файла .content.
.PP
Если \`sync\` перезапускается после прерывания, существующий
ожидающий (pending) снимок удаляется, и создается новый для
фиксации текущего состояния живой файловой системы.
.SH PATTERN
Шаблоны обеспечивают гибкий способ фильтрации файлов для включения или
исключения. Используя символы подстановки (globbing), вы можете определить правила,

View file

@ -50,22 +50,30 @@ Description
:https://www.snapraid.it/
Limitations
SnapRAID — это гибрид программы RAID и программы резервного копирования,
стремящийся объединить лучшие преимущества обеих. Однако у него есть
некоторые ограничения, которые следует учитывать перед использованием.
Ограничения
SnapRAID — это гибрид между RAID и программой резервного копирования, стремящийся сочетать
в себе лучшие преимущества обоих подходов. Однако у него есть некоторые ограничения, которые вам
следует учесть перед использованием.
Основное ограничение заключается в том, что если диск выходит из строя, а вы
недавно не выполняли синхронизацию, вы можете не восстановить данные полностью.
В частности, вы можете не восстановить данные в объеме, равном размеру
измененных или удаленных файлов с момента последней операции синхронизации.
Это происходит, даже если измененные или удаленные файлы не находятся
на отказавшем диске. Вот почему SnapRAID лучше подходит для
данных, которые редко меняются.
Основное ограничение заключается в том, что в случае сбоя диска вы можете восстановить данные только до
состояния последней операции синхронизации (`sync`). Любые данные, добавленные или измененные
с момента последней синхронизации и находящиеся на давшем сбой диске, будут потеряны.
С другой стороны, недавно добавленные файлы не препятствуют восстановлению уже
существующих файлов. Вы потеряете только недавно добавленные файлы,
если они находятся на отказавшем диске.
Следовательно, SnapRAID в первую очередь подходит для данных, которые редко меняются.
Для данных, которые уже существовали на момент последней синхронизации, надежность восстановления зависит
от того, используется ли опция снимка (`snapshot`):
* При наличии поддержки снимков (доступно на Btrfs, ZFS, Bcachefs и NTFS),
SnapRAID может автоматически поддерживать замороженную копию ваших дисков с данными.
Это гарантирует, что даже если вы измените или удалите файлы в вашей живой файловой системе
во время или после синхронизации, процесс восстановления останется согласованным и надежным.
* Без поддержки снимков удаление или изменение файлов после `sync`
может предотвратить полное восстановление других дисков, давших сбой. Это происходит
потому, что четность больше не соответствует измененным файлам, даже если
эти файлы находятся не на давшем сбой диске. С другой стороны, недавно добавленные
файлы не препятствуют восстановлению уже существующих файлов.
Другие ограничения SnapRAID:
@ -381,16 +389,16 @@ Getting Started
Если все восстановлено, эта команда выполняется немедленно.
Commands
Команды
SnapRAID предоставляет несколько простых команд, которые позволяют:
* Печатать статус массива -> `status`
* Вывести статус массива -> `status`
* Управлять дисками -> `smart`, `probe`, `up`, `down`
* Сделать резервную копию/снимок -> `sync`
* Создать точку резервного копирования/восстановления -> `sync`
* Периодически проверять данные -> `scrub`
* Восстановить последнюю резервную копию/снимок -> `fix`.
* Восстановить последнюю точку резервного копирования/восстановления -> `fix`.
Команды должны быть написаны строчными буквами.
Команды должны быть написаны строчными (маленькими) буквами.
status
Печатает сводку состояния дискового массива.
@ -593,15 +601,14 @@ Commands
Файлы в массиве НЕ изменяются.
fix
Исправляет все файлы и данные четности.
Восстанавливает все файлы и данные четности.
Все файлы и данные четности сравниваются с состоянием снимка,
сохраненным при последнем `sync`.
Если обнаружено различие, оно возвращается к сохраненному снимку.
Все файлы и данные четности сравниваются с состоянием, сохраненным во время
последней синхронизации `sync`. Если обнаружено отличие, оно возвращается к сохраненному состоянию.
ВНИМАНИЕ! Команда `fix` не различает ошибки и
преднамеренные изменения. Она безусловно возвращает состояние файла
к последнему `sync`.
ВНИМАНИЕ!
Команда `fix` не делает различий между ошибками и преднамеренными изменениями.
Она безоговорочно возвращает состояние файлов к моменту последней `sync`.
Если не указана другая опция, обрабатывается весь массив.
Используйте опции фильтрации, чтобы выбрать подмножество файлов или дисков для работы.
@ -1147,6 +1154,30 @@ Configuration
Обратите внимание, что такие диски не затрагиваются командами `up` и
`down`, так как предполагается, что они всегда вращаются.
snapshot
Включает использование снимков файловой системы для команд `sync`, `scrub`,
`check` и `fix`.
Если опция включена, SnapRAID создает снимок ваших данных только для чтения в
начале операции 'sync'. Это обеспечивает согласованный срез ваших файлов на определенный
момент времени, предотвращая ошибки, вызванные одновременным изменением файлов.
Это значительно улучшает восстановление: если файл удаляется из живой файловой системы,
он остается сохраненным в снимке. Это предотвращает «нарушение» четности
для этого блока, гарантируя, что вы все еще сможете успешно восстановить данные
в случае сбоя другого диска.
Эта опция применяется исключительно к дискам с данными, отформатированным в файловых
системах Btrfs, Bcachefs или ZFS в Linux и NTFS в Windows.
Диски четности или диски с данными, использующие другие файловые системы, всегда будут использовать
живую версию файловой системы.
Создание и удаление снимков требуют прав администратора.
Убедитесь, что SnapRAID запущен с необходимыми привилегиями (например, sudo), когда
включена эта опция.
Подробное объяснение жизненного цикла снимков см. в разделе SNAPSHOTS.
nohidden
Исключает все скрытые файлы и каталоги.
В Unix скрытые файлы — это те, которые начинаются с `.`.
@ -1386,6 +1417,116 @@ Configuration
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots (Снимки)
Если в конфигурации включена опция снимков, SnapRAID использует
функциональность снимков файловой системы для обеспечения атомарности и
согласованности операций.
Управление снимками происходит полностью автоматически и прозрачно.
Вы можете продолжать использовать SnapRAID точно так же, как и раньше, получая
дополнительную защиту, обеспечиваемую снимками, которые полностью обрабатываются в
фоновом режиме.
Это дает два основных преимущества:
Согласованность — Файлы, измененные в живой файловой системе во время длительного
процесса sync или scrub, не вызовут несоответствия четности или прерывания
операций, поскольку SnapRAID видит замороженный снимок на момент времени.
Восстановление — Если файл обновляется или удаляется из живой файловой системы,
он остается сохраненным в снимке. Если сбой диска произойдет
до запуска следующей синхронизации sync, SnapRAID использует данные, сохраненные
в снимке, для реконструкции давшего сбой диска.
В случае сбоя диска во время активного процесса sync,
SnapRAID также может автоматически читать как из снимка предыдущего
вычисления четности, так и из текущего.
Это максимизирует вероятность полного восстановления, предоставляя
доступ к точным блокам данных, необходимым для решения уравнений четности,
даже если эти блоки были изменены или удалены между синхронизациями.
Без снимков обновленный или удаленный файл на исправном диске
приводит к отсутствию блоков данных, которые могут потребоваться для
восстановления других дисков, давших сбой.
Снимки создаются только для дисков с данными и только в том случае, если базовая
файловая система поддерживает эту функциональность. Диски четности всегда используют
живую файловую систему.
В настоящее время это поддерживается на Btrfs, Bcachefs и ZFS в Linux
и на NTFS в Windows.
Вы можете комбинировать диски с данными с различными файловыми системами. Только те из них,
которые поддерживают снимки, будут использовать их, в то время как другие диски продолжат
работать напрямую с живой файловой системой.
Создание и удаление снимков требуют прав администратора.
Убедитесь, что SnapRAID запущен с необходимыми привилегиями (например, sudo),
когда снимки включены.
Поведение команд при использовании снимков
Команды `sync` и `scrub` работают исключительно со снимками,
чтобы гарантировать, что все операции с данными выполняются на согласованном,
замороженном состоянии. Используя эти снимки, SnapRAID предотвращает несоответствия
четности, которые в противном случае были бы вызваны одновременными изменениями файлов в живой файловой системе.
Во время `sync` команда использует новый снимок, созданный в начале
процесса, для фиксации текущего состояния для вычисления четности.
Напротив, команда `scrub` использует последний снимок, созданный во время
самой последней синхронизации, чтобы поддерживать надежную точку отсчета,
соответствующую существующей четности.
Для команд `check` и `fix` использование последнего снимка
зависит от того, нацелены ли конкретные диски с помощью опции
-d, --filter-disk.
Диск, явно выбранный с помощью -d («цель» операции),
всегда использует живую файловую систему. Для `fix` это позволяет восстановить
данные на активную замену диска. Для `check` это позволяет симулировать
операцию `fix` при тех же условиях.
Доступ ко всем остальным дискам с данными («справочным» дискам) будет осуществляться через
их снимки. Это гарантирует, что даже если вы изменяете файлы
на своих исправных дисках во время восстановления, SnapRAID
имеет стабильную, замороженную точку отсчета для решения уравнений четности.
Если опция -d не предоставлена, SnapRAID предполагает, что операция применяется
ко всему массиву; в этом случае `check` и `fix` будут использовать исключительно
живые файловые системы.
Все остальные команды работают исключительно с живой файловой системой.
Жизненный цикл снимков
SnapRAID управляет двумя конкретными снимками, `stable` и `pending`,
внутри скрытого каталога в корне каждого подтома данных.
В Btrfs, Bcachefs и NTFS используется каталог `.snapraid/`,
в ZFS — стандартный `.zfs/snapshot/`.
Снимок `stable` представляет собой состояние последней успешно
завершенной синхронизации `sync`, содержащей точные данные, использованные для
вычисления текущей четности. Он служит основным источником данных
для команд `scrub`, `check` и `fix`.
Снимок `pending` — это временный образ, создаваемый в начале
`sync` для обеспечения замороженного состояния для вычисления четности.
После успешного завершения операции предыдущий снимок `stable`
удаляется, а снимок `pending` повышается в статусе, чтобы
занять его место в качестве нового стабильного ориентира.
Если процесс `sync` прерывается, снимок `pending` сохраняется.
Последующие команды `scrub`, `check` и `fix` будут использовать этот
ожидающий снимок, так как он соответствует состоянию файловой системы, записанному в
файле .content, даже если четность синхронизирована лишь частично.
В случае прерывания `sync` команды `check` и `fix`
также читают данные из снимка `stable` для извлечения блоков данных
из файлов, которые были обновлены или удалены во время синхронизации.
Это возможно потому, что файл .content сохраняет метаданные для
всех измененных или удаленных файлов на протяжении всего процесса sync.
Эта историческая информация очищается только после успешного завершения sync
и сохранения финальной версии файла .content.
Если `sync` перезапускается после прерывания, существующий
ожидающий (pending) снимок удаляется, и создается новый для
фиксации текущего состояния живой файловой системы.
Pattern
Шаблоны обеспечивают гибкий способ фильтрации файлов для включения или
исключения. Используя символы подстановки (globbing), вы можете определить правила,

View file

@ -58,24 +58,32 @@ SnapRAID — это программа резервного копировани
https://www.snapraid.it/
3 LIMITATIONS
3 Ограничения
=============
SnapRAID — это гибрид программы RAID и программы резервного копирования,
стремящийся объединить лучшие преимущества обеих. Однако у него есть
некоторые ограничения, которые следует учитывать перед использованием.
SnapRAID — это гибрид между RAID и программой резервного копирования, стремящийся сочетать
в себе лучшие преимущества обоих подходов. Однако у него есть некоторые ограничения, которые вам
следует учесть перед использованием.
Основное ограничение заключается в том, что если диск выходит из строя, а вы
недавно не выполняли синхронизацию, вы можете не восстановить данные полностью.
В частности, вы можете не восстановить данные в объеме, равном размеру
измененных или удаленных файлов с момента последней операции синхронизации.
Это происходит, даже если измененные или удаленные файлы не находятся
на отказавшем диске. Вот почему SnapRAID лучше подходит для
данных, которые редко меняются.
Основное ограничение заключается в том, что в случае сбоя диска вы можете восстановить данные только до
состояния последней операции синхронизации (`sync`). Любые данные, добавленные или измененные
с момента последней синхронизации и находящиеся на давшем сбой диске, будут потеряны.
С другой стороны, недавно добавленные файлы не препятствуют восстановлению уже
существующих файлов. Вы потеряете только недавно добавленные файлы,
если они находятся на отказавшем диске.
Следовательно, SnapRAID в первую очередь подходит для данных, которые редко меняются.
Для данных, которые уже существовали на момент последней синхронизации, надежность восстановления зависит
от того, используется ли опция снимка (`snapshot`):
* При наличии поддержки снимков (доступно на Btrfs, ZFS, Bcachefs и NTFS),
SnapRAID может автоматически поддерживать замороженную копию ваших дисков с данными.
Это гарантирует, что даже если вы измените или удалите файлы в вашей живой файловой системе
во время или после синхронизации, процесс восстановления останется согласованным и надежным.
* Без поддержки снимков удаление или изменение файлов после `sync`
может предотвратить полное восстановление других дисков, давших сбой. Это происходит
потому, что четность больше не соответствует измененным файлам, даже если
эти файлы находятся не на давшем сбой диске. С другой стороны, недавно добавленные
файлы не препятствуют восстановлению уже существующих файлов.
Другие ограничения SnapRAID:
@ -403,18 +411,18 @@ SnapRAID функционирует скорее как программа ре
Если все восстановлено, эта команда выполняется немедленно.
5 COMMANDS
==========
5 Команды
=========
SnapRAID предоставляет несколько простых команд, которые позволяют:
* Печатать статус массива -> `status`
* Вывести статус массива -> `status`
* Управлять дисками -> `smart`, `probe`, `up`, `down`
* Сделать резервную копию/снимок -> `sync`
* Создать точку резервного копирования/восстановления -> `sync`
* Периодически проверять данные -> `scrub`
* Восстановить последнюю резервную копию/снимок -> `fix`.
* Восстановить последнюю точку резервного копирования/восстановления -> `fix`.
Команды должны быть написаны строчными буквами.
Команды должны быть написаны строчными (маленькими) буквами.
5.1 status
----------
@ -635,15 +643,14 @@ full - Проверить все.
5.9 fix
-------
Исправляет все файлы и данные четности.
Восстанавливает все файлы и данные четности.
Все файлы и данные четности сравниваются с состоянием снимка,
сохраненным при последнем `sync`.
Если обнаружено различие, оно возвращается к сохраненному снимку.
Все файлы и данные четности сравниваются с состоянием, сохраненным во время
последней синхронизации `sync`. Если обнаружено отличие, оно возвращается к сохраненному состоянию.
ВНИМАНИЕ! Команда `fix` не различает ошибки и
преднамеренные изменения. Она безусловно возвращает состояние файла
к последнему `sync`.
ВНИМАНИЕ!
Команда `fix` не делает различий между ошибками и преднамеренными изменениями.
Она безоговорочно возвращает состояние файлов к моменту последней `sync`.
Если не указана другая опция, обрабатывается весь массив.
Используйте опции фильтрации, чтобы выбрать подмножество файлов или дисков для работы.
@ -1223,14 +1230,40 @@ UUID дисков.
Обратите внимание, что такие диски не затрагиваются командами `up` и
`down`, так как предполагается, что они всегда вращаются.
7.7 nohidden
7.7 snapshot
------------
Включает использование снимков файловой системы для команд `sync`, `scrub`,
`check` и `fix`.
Если опция включена, SnapRAID создает снимок ваших данных только для чтения в
начале операции 'sync'. Это обеспечивает согласованный срез ваших файлов на определенный
момент времени, предотвращая ошибки, вызванные одновременным изменением файлов.
Это значительно улучшает восстановление: если файл удаляется из живой файловой системы,
он остается сохраненным в снимке. Это предотвращает «нарушение» четности
для этого блока, гарантируя, что вы все еще сможете успешно восстановить данные
в случае сбоя другого диска.
Эта опция применяется исключительно к дискам с данными, отформатированным в файловых
системах Btrfs, Bcachefs или ZFS в Linux и NTFS в Windows.
Диски четности или диски с данными, использующие другие файловые системы, всегда будут использовать
живую версию файловой системы.
Создание и удаление снимков требуют прав администратора.
Убедитесь, что SnapRAID запущен с необходимыми привилегиями (например, sudo), когда
включена эта опция.
Подробное объяснение жизненного цикла снимков см. в разделе SNAPSHOTS.
7.8 nohidden
------------
Исключает все скрытые файлы и каталоги.
В Unix скрытые файлы — это те, которые начинаются с `.`.
В Windows — это те, у которых есть скрытый атрибут.
7.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
Определяет шаблоны файлов или каталогов для исключения или включения
@ -1247,8 +1280,8 @@ UUID дисков.
Эту опцию можно использовать несколько раз.
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
Определяет базовый размер блока в кибибайтах для четности.
Один кибибайт — это 1024 байта.
@ -1296,7 +1329,7 @@ UUID дисков.
диска 4 ТБ, что позволяет разместить около 460 000 файлов на каждом диске данных без
каких-либо потерь пространства.
7.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
Определяет размер хэша в байтах для сохраненных блоков.
@ -1334,7 +1367,7 @@ RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
Автоматически сохраняет состояние при синхронизации или проверке после
@ -1342,7 +1375,7 @@ RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
Эта опция полезна, чтобы избежать перезапуска длительных команд `sync`
с нуля, если они были прерваны сбоем машины или любым другим событием.
7.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
Устанавливает максимально допустимую температуру диска в Цельсиях. Если указано,
@ -1375,13 +1408,13 @@ SnapRAID периодически проверяет температуру вс
Обычно SnapRAID показывает только температуру самого горячего диска.
Чтобы отобразить температуру всех дисков, используйте опцию -A или --stats.
7.13 temp_sleep TIME_IN_MINUTES
7.14 temp_sleep TIME_IN_MINUTES
-------------------------------
Устанавливает время ожидания, в минутах, когда достигается предел температуры.
В течение этого периода диски остаются остановленными. По умолчанию — 5 минут.
7.14 pool DIR
7.15 pool DIR
-------------
Определяет каталог объединения (pooling), где создается виртуальное представление
@ -1389,7 +1422,7 @@ SnapRAID периодически проверяет температуру вс
Каталог должен уже существовать.
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
Определяет путь UNC Windows, необходимый для удаленного доступа к дискам.
@ -1405,7 +1438,7 @@ SnapRAID периодически проверяет температуру вс
Эта опция требуется только для Windows.
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
Определяет пользовательские опции smartctl для получения атрибутов SMART для
@ -1431,7 +1464,7 @@ PARITY — это одно из имен четности: `parity`, `2-parity`,
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
Игнорирует указанный атрибут SMART при вычислении вероятности
@ -1452,7 +1485,7 @@ PARITY — это одно из имен четности: `parity`, `2-parity`,
smartignore parity 197
7.18 Examples
7.19 Examples
-------------
Пример типичной конфигурации для Unix:
@ -1487,8 +1520,126 @@ PARITY — это одно из имен четности: `parity`, `2-parity`,
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 PATTERN
=========
8 SNAPSHOTS (Снимки)
====================
Если в конфигурации включена опция снимков, SnapRAID использует
функциональность снимков файловой системы для обеспечения атомарности и
согласованности операций.
Управление снимками происходит полностью автоматически и прозрачно.
Вы можете продолжать использовать SnapRAID точно так же, как и раньше, получая
дополнительную защиту, обеспечиваемую снимками, которые полностью обрабатываются в
фоновом режиме.
Это дает два основных преимущества:
Согласованность — Файлы, измененные в живой файловой системе во время длительного
процесса sync или scrub, не вызовут несоответствия четности или прерывания
операций, поскольку SnapRAID видит замороженный снимок на момент времени.
Восстановление — Если файл обновляется или удаляется из живой файловой системы,
он остается сохраненным в снимке. Если сбой диска произойдет
до запуска следующей синхронизации sync, SnapRAID использует данные, сохраненные
в снимке, для реконструкции давшего сбой диска.
В случае сбоя диска во время активного процесса sync,
SnapRAID также может автоматически читать как из снимка предыдущего
вычисления четности, так и из текущего.
Это максимизирует вероятность полного восстановления, предоставляя
доступ к точным блокам данных, необходимым для решения уравнений четности,
даже если эти блоки были изменены или удалены между синхронизациями.
Без снимков обновленный или удаленный файл на исправном диске
приводит к отсутствию блоков данных, которые могут потребоваться для
восстановления других дисков, давших сбой.
Снимки создаются только для дисков с данными и только в том случае, если базовая
файловая система поддерживает эту функциональность. Диски четности всегда используют
живую файловую систему.
В настоящее время это поддерживается на Btrfs, Bcachefs и ZFS в Linux
и на NTFS в Windows.
Вы можете комбинировать диски с данными с различными файловыми системами. Только те из них,
которые поддерживают снимки, будут использовать их, в то время как другие диски продолжат
работать напрямую с живой файловой системой.
Создание и удаление снимков требуют прав администратора.
Убедитесь, что SnapRAID запущен с необходимыми привилегиями (например, sudo),
когда снимки включены.
8.1 Поведение команд при использовании снимков
----------------------------------------------
Команды `sync` и `scrub` работают исключительно со снимками,
чтобы гарантировать, что все операции с данными выполняются на согласованном,
замороженном состоянии. Используя эти снимки, SnapRAID предотвращает несоответствия
четности, которые в противном случае были бы вызваны одновременными изменениями файлов в живой файловой системе.
Во время `sync` команда использует новый снимок, созданный в начале
процесса, для фиксации текущего состояния для вычисления четности.
Напротив, команда `scrub` использует последний снимок, созданный во время
самой последней синхронизации, чтобы поддерживать надежную точку отсчета,
соответствующую существующей четности.
Для команд `check` и `fix` использование последнего снимка
зависит от того, нацелены ли конкретные диски с помощью опции
-d, --filter-disk.
Диск, явно выбранный с помощью -d («цель» операции),
всегда использует живую файловую систему. Для `fix` это позволяет восстановить
данные на активную замену диска. Для `check` это позволяет симулировать
операцию `fix` при тех же условиях.
Доступ ко всем остальным дискам с данными («справочным» дискам) будет осуществляться через
их снимки. Это гарантирует, что даже если вы изменяете файлы
на своих исправных дисках во время восстановления, SnapRAID
имеет стабильную, замороженную точку отсчета для решения уравнений четности.
Если опция -d не предоставлена, SnapRAID предполагает, что операция применяется
ко всему массиву; в этом случае `check` и `fix` будут использовать исключительно
живые файловые системы.
Все остальные команды работают исключительно с живой файловой системой.
9 Жизненный цикл снимков
========================
SnapRAID управляет двумя конкретными снимками, `stable` и `pending`,
внутри скрытого каталога в корне каждого подтома данных.
В Btrfs, Bcachefs и NTFS используется каталог `.snapraid/`,
в ZFS — стандартный `.zfs/snapshot/`.
Снимок `stable` представляет собой состояние последней успешно
завершенной синхронизации `sync`, содержащей точные данные, использованные для
вычисления текущей четности. Он служит основным источником данных
для команд `scrub`, `check` и `fix`.
Снимок `pending` — это временный образ, создаваемый в начале
`sync` для обеспечения замороженного состояния для вычисления четности.
После успешного завершения операции предыдущий снимок `stable`
удаляется, а снимок `pending` повышается в статусе, чтобы
занять его место в качестве нового стабильного ориентира.
Если процесс `sync` прерывается, снимок `pending` сохраняется.
Последующие команды `scrub`, `check` и `fix` будут использовать этот
ожидающий снимок, так как он соответствует состоянию файловой системы, записанному в
файле .content, даже если четность синхронизирована лишь частично.
В случае прерывания `sync` команды `check` и `fix`
также читают данные из снимка `stable` для извлечения блоков данных
из файлов, которые были обновлены или удалены во время синхронизации.
Это возможно потому, что файл .content сохраняет метаданные для
всех измененных или удаленных файлов на протяжении всего процесса sync.
Эта историческая информация очищается только после успешного завершения sync
и сохранения финальной версии файла .content.
Если `sync` перезапускается после прерывания, существующий
ожидающий (pending) снимок удаляется, и создается новый для
фиксации текущего состояния живой файловой системы.
10 PATTERN
==========
Шаблоны обеспечивают гибкий способ фильтрации файлов для включения или
исключения. Используя символы подстановки (globbing), вы можете определить правила,
@ -1606,8 +1757,8 @@ PARITY — это одно из имен четности: `parity`, `2-parity`,
заключить их в кавычки, чтобы предотвратить их расширение оболочкой.
9 IGNORE FILE
=============
11 IGNORE FILE
==============
В дополнение к глобальным правилам в файле конфигурации, вы можете
размещать файлы `.snapraidignore` в любом каталоге внутри массива для
@ -1651,7 +1802,7 @@ PARITY — это одно из имен четности: `parity`, `2-parity`,
*.tmp
10 CONTENT
12 CONTENT
==========
SnapRAID хранит список и контрольные суммы ваших файлов в файле content.
@ -1663,7 +1814,7 @@ SnapRAID хранит список и контрольные суммы ваши
считывается командами `fix`, `check` и `status`.
11 PARITY
13 PARITY
=========
SnapRAID хранит информацию четности вашего массива в файлах parity.
@ -1675,7 +1826,7 @@ SnapRAID хранит информацию четности вашего мас
только считываются командами `scrub` и `check`.
12 ENCODING
14 ENCODING
===========
SnapRAID в Unix игнорирует любое кодирование. Он считывает и хранит
@ -1692,13 +1843,13 @@ SnapRAID в Unix игнорирует любое кодирование. Он с
в формате UTF-8.
13 COPYRIGHT
15 COPYRIGHT
============
Этот файл защищен авторским правом (C) 2025 Andrea Mazzoleni
14 SEE ALSO
16 SEE ALSO
===========
snapraid_log(1), snapraidd(1)

View file

@ -118,21 +118,33 @@ https://www.snapraid.it/
.PD
.RE
.SH BEGRäNSNINGAR
SnapRAID är en hybrid mellan ett RAID\- och ett säkerhetskopieringsprogram,
som syftar till att kombinera de bästa fördelarna med båda. Den har dock
vissa begränsningar som du bör överväga innan du använder den.
SnapRAID är en hybrid mellan en RAID och ett backupprogram, med målet att kombinera
de bästa fördelarna med båda. Det har dock vissa begränsningar som du bör
överväga innan du använder det.
.PP
Huvudbegränsningen är att om en disk misslyckas och du inte nyligen har
synkat, kanske du inte kan återställa fullständigt.
Mer specifikt, kanske du inte kan återställa upp till storleken på
de ändrade eller raderade filerna sedan den senaste synkroniseringsoperationen.
Detta inträffar även om de ändrade eller raderade filerna inte finns på
den felaktiga disken. Det är därför SnapRAID passar bättre för
data som sällan ändras.
Den huvudsakliga begränsningen är att om en disk havererar kan du endast återställa data fram till
tillståndet för den senaste \`sync\`\-iseringen. Data som lagts till eller modifieringar som gjorts
sedan den senaste synkroniseringen och som är placerade på den felaktiga disken kommer att gå förlorade.
.PP
Å andra sidan förhindrar nyligen tillagda filer inte återställning av redan
befintliga filer. Du kommer bara att förlora de nyligen tillagda filerna om de
finns på den felaktiga disken.
Följaktligen är SnapRAID främst lämpat för data som sällan ändras.
.PP
För data som redan existerade vid den senaste synkroniseringen beror återställningens tillförlitlighet
på om alternativet \`snapshot\` (ögonblicksbild) används:
.PD 0
.IP \(bu
Med stöd för ögonblicksbilder (tillgängligt på Btrfs, ZFS, Bcachefs och NTFS)
kan SnapRAID automatiskt upprätthålla en frusen referens av dina datadiskar.
Detta säkerställer att även om du ändrar eller tar bort filer på ditt aktiva filsystem
under eller efter en synkronisering, förblir återställningsprocessen konsekvent och tillförlitlig.
.PD
.PD 0
.IP \(bu
Utan stöd för ögonblicksbilder kan borttagning eller ändring av filer efter en \`sync\`
förhindra fullständig återställning av andra felaktiga diskar. Detta inträffar
eftersom pariteten inte längre matchar de modifierade filerna, även om
dessa filer inte finns på den havererade disken. Å andra sidan förhindrar inte nyinkomna
filer återställning av redan existerande filer.
.PD
.PP
Andra SnapRAID\-begränsningar är:
.PD 0
@ -644,21 +656,21 @@ snapraid sync
.PP
Om allt är återställt är detta kommando omedelbart.
.SH KOMMANDON
SnapRAID tillhandahåller några enkla kommandon som låter dig:
SnapRAID tillhandahåller några enkla kommandon som gör att du kan:
.PD 0
.IP \(bu
Skriva ut statusen för arrayen \-> \`status\`
Skriva ut arrayens status \-> \`status\`
.IP \(bu
Kontrollera diskarna \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
Göra en säkerhetskopia/ögonblicksbild \-> \`sync\`
Skapa en backup\-/återställningspunkt \-> \`sync\`
.IP \(bu
Periodiskt kontrollera data \-> \`scrub\`
.IP \(bu
Återställa den senaste säkerhetskopian/ögonblicksbilden \-> \`fix\`.
Återställa den senaste backup\-/återställningspunkten \-> \`fix\`.
.PD
.PP
Kommandon måste skrivas med gemener.
Kommandon måste skrivas med gemener (små bokstäver).
.SS status
Skriver ut en sammanfattning av tillståndet för disk\-arrayen.
.PP
@ -886,15 +898,14 @@ för varje block och för att markera dåliga block.
\`parity\`\-filerna modifieras INTE.
Filerna i arrayen modifieras INTE.
.SS fix
Fixar alla filer och paritetsdata.
Lagar alla filer och paritetsdata.
.PP
Alla filer och paritetsdata jämförs med ögonblicksbilds\-
tillståndet som sparades i den senaste \`sync\`.
Om en skillnad hittas, återställs den till det lagrade ögonblicksbildstillståndet.
Alla filer och paritetsdata jämförs med det tillstånd som sparades i
den senaste \`sync\`\-iseringen. Om en skillnad hittas återställs den till det sparade tillståndet.
.PP
VARNING! Kommandot \`fix\` skiljer inte mellan fel och
avsiktliga modifieringar. Det återställer ovillkorligen filtillståndet
till den senaste \`sync\`.
VARNING!
Kommandot \`fix\` skiljer inte mellan fel och avsiktliga modifieringar.
Det återställer villkorslöst filtillståndet till den senaste \`sync\`\-iseringen.
.PP
Om inget annat alternativ specificeras, behandlas hela arrayen.
Använd filteralternativen för att välja en delmängd av filer eller diskar att arbeta med.
@ -1428,6 +1439,29 @@ startdisken.
.PP
Observera att sådana diskar inte påverkas av kommandona \`up\` och
\`down\` eftersom de förväntas alltid snurra.
.SS snapshot
Aktiverar användningen av filsystemets ögonblicksbilder för kommandona \`sync\`, \`scrub\`,
\`check\` och \`fix\`.
.PP
När det är aktiverat skapar SnapRAID en skrivskyddad ögonblicksbild av dina data vid
början av en \'sync\'. Detta säkerställer en konsekvent tidpunktsvy av dina
filer, vilket förhindrar fel som orsakas av samtidiga filändringar.
.PP
Detta förbättrar återställningen avsevärt: om en fil tas bort från det aktiva filsystemet
förblir den bevarad i ögonblicksbilden. Detta förhindrar att pariteten blir \[dq]trasig\[dq]
för det blocket, vilket säkerställer att du fortfarande kan återställa data framgångsrikt
om en annan disk havererar.
.PP
Detta alternativ gäller uteslutande datadiskar formaterade med filsystemen
Btrfs, Bcachefs eller ZFS i Linux och NTFS i Windows.
Paritetsdiskar, eller datadiskar som använder andra filsystem, kommer alltid att använda
den aktiva versionen av filsystemet.
.PP
Att skapa och ta bort ögonblicksbilder kräver administratörsbehörighet.
Se till att SnapRAID körs med nödvändiga rättigheter (t.ex. sudo) när
detta alternativ är aktiverat.
.PP
Se avsnittet SNAPSHOTS för en detaljerad förklaring av ögonblicksbildens livscykel.
.SS nohidden
Exkluderar alla dolda filer och kataloger.
I Unix är dolda filer de som börjar med \`.\`.
@ -1761,6 +1795,125 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS (ÖGONBLICKSBILDER)
Om alternativet för ögonblicksbilder är aktiverat i konfigurationen använder SnapRAID
filsystemets funktionalitet för ögonblicksbilder för att säkerställa atomära och
konsekventa operationer.
.PP
Hanteringen av ögonblicksbilder är helt automatisk och transparent.
Du kan fortsätta att använda SnapRAID exakt som tidigare, med det
ytterligare skydd som ögonblicksbilder ger, helt hanterat i
bakgrunden.
.PP
Detta ger två huvudsakliga fördelar:
.RS 0
.PD 0
.HP 4
.I Konsistens
Filer som ändras på det aktiva filsystemet under en långvarig
sync eller scrub kommer inte att orsaka paritetsfel eller avbrutna
operationer, eftersom SnapRAID ser en frusen tidpunktsbild.
.HP 4
.I Återställning
Om en fil uppdateras eller tas bort från det aktiva filsystemet
förblir den bevarad i ögonblicksbilden. Om ett diskhaveri inträffar
innan nästa sync körs, använder SnapRAID den data som bevarats
i ögonblicksbilden för att rekonstruera den felaktiga disken.
.PD
.PP
.RS 4
.PD 0
I händelse av ett diskhaveri under en aktiv synkroniseringsprocess
kan SnapRAID också läsa automatiskt från både ögonblicksbilden
av den föregående paritetsberäkningen och den aktuella.
Detta maximerar sannolikheten för en fullständig återställning genom att
ge tillgång till de exakta datablock som krävs för att lösa paritetsekvationerna,
även om dessa block modifierades eller togs bort mellan synkroniseringar.
.PD
.PP
.PD 0
Utan ögonblicksbilder leder en uppdaterad eller borttagen fil på en frisk disk
till saknade datablock som kan krävas för att laga andra felaktiga diskar.
.PD
.RE
.RE
.PP
Ögonblicksbilder skapas endast för datadiskar och endast om det underliggande
filsystemet stöder denna funktionalitet. Paritetsdiskar använder alltid
det aktiva filsystemet.
För närvarande stöds detta på Btrfs, Bcachefs och ZFS i Linux
och på NTFS i Windows.
.PP
Du kan blanda datadiskar med olika filsystem. Endast de som
stöder ögonblicksbilder kommer att använda dem, medan andra diskar kommer att fortsätta
att fungera direkt på det aktiva filsystemet.
.PP
Att skapa och ta bort ögonblicksbilder kräver administratörsbehörighet.
Se till att SnapRAID körs med nödvändiga rättigheter (t.ex. sudo)
när ögonblicksbilder är aktiverade.
.SS Kommandobeteende med ögonblicksbilder
Kommandona \`sync\` och \`scrub\` arbetar båda uteslutande på ögonblicksbilder
för att säkerställa att alla dataoperationer utförs mot ett konsekvent,
fruset tillstånd. Genom att använda dessa ögonblicksbilder förhindrar SnapRAID paritetsfel
som annars skulle utlösas av samtidiga filändringar på det aktiva filsystemet.
Under en \`sync\` använder kommandot en ny ögonblicksbild som skapas vid
början av processen för att fånga det aktuella tillståndet för paritetsberäkning.
I motsats till detta använder kommandot \`scrub\` den senaste ögonblicksbilden, den som
skapades under den senaste synkroniseringen, för att upprätthålla en tillförlitlig referenspunkt
som matchar den befintliga pariteten.
.PP
För kommandona \`check\` och \`fix\` beror användningen av den senaste ögonblicksbilden
på om specifika diskar är måltavla med alternativet
\-d, \-\-filter\-disk.
.PP
En disk som uttryckligen valts via \-d (operationens \[dq]mål\[dq])
använder alltid det aktiva filsystemet. För \`fix\` tillåter detta återställning
av data till den aktiva ersättningsdisken. För \`check\` tillåter det att simulera
\`fix\`\-operationen under samma förhållanden.
.PP
Alla andra datadiskar (\[dq]referensdiskarna\[dq]) kommer att nås via
sina ögonblicksbilder. Detta säkerställer att även om du ändrar filer
på dina friska diskar medan en återställning pågår, har SnapRAID
en stabil, frusen referens för att lösa paritetsekvationerna.
.PP
Om inget \-d\-alternativ anges antar SnapRAID kraschat att operationen gäller
hela arrayen, i detta fall kommer \`check\` och \`fix\` att använda de
aktiva filsystemen uteslutande.
.PP
Alla andra kommandon fungerar uteslutande på det aktiva filsystemet.
.SH LIVSCYKEL FöR öGONBLICKSBILDER
SnapRAID hanterar två specifika ögonblicksbilder, \`stable\` och \`pending\`,
inom en dold katalog i roten av varje datavolym.
I Btrfs, Bcachefs och NTFS används katalogen \`.snapraid/\`,
i ZFS standardkatalogen \`.zfs/snapshot/\`.
.PP
Ögonblicksbilden \`stable\` representerar tillståndet för den senaste
framgångsrikt slutförda \`sync\`\-iseringen, och innehåller exakt den data som användes för
att beräkna den aktuella pariteten. Den fungerar som den primära datakällan
för kommandona \`scrub\`, \`check\` och \`fix\`.
.PP
Ögonblicksbilden \`pending\` är en tillfällig bild som skapas i början
av en \`sync\` för att tillhandahålla ett fruset tillstånd för paritetsberäkning.
Efter framgångsrik slutförande av operationen raderas den föregående \`stable\`
ögonblicksbilden, och \`pending\`\-ögonblicksbilden upphöjs till
att ta dess plats som den nya stabila referensen.
.PP
Om en \`sync\` avbryts bevaras ögonblicksbilden \`pending\`.
Efterföljande \`scrub\`\-, \`check\`\- och \`fix\`\-kommandon kommer att använda denna
vilande ögonblicksbild eftersom den matchar filsystemets tillstånd som registrerats i
.content\-filen, även om pariteten endast är delvis synkroniserad.
.PP
I händelse av ett avbrott i en \`sync\` läser kommandona \`check\` och \`fix\`
också från ögonblicksbilden \`stable\` för att hämta datablock
från filer som uppdaterades eller togs bort under synkroniseringen.
Detta är möjligt eftersom .content\-filen behåller metadata för
alla modifierade eller borttagna filer under hela synkroniseringsprocessen.
Denna historiska information rensas först när en sync slutförts
framgångsrikt och den slutliga versionen av .content\-filen sparats.
.PP
Om en \`sync\` startas om efter ett avbrott raderas den befintliga
vilande (pending) ögonblicksbilden och en ny skapas för att
fånga det aktuella tillståndet för det aktiva filsystemet.
.SH MöNSTER (PATTERN)
Mönster ger ett flexibelt sätt att filtrera filer för inkludering eller
exkludering. Genom att använda jokertecken kan du definiera regler som

View file

@ -52,21 +52,29 @@ Beskrivning
:https://www.snapraid.it/
Begränsningar
SnapRAID är en hybrid mellan ett RAID- och ett säkerhetskopieringsprogram,
som syftar till att kombinera de bästa fördelarna med båda. Den har dock
vissa begränsningar som du bör överväga innan du använder den.
SnapRAID är en hybrid mellan en RAID och ett backupprogram, med målet att kombinera
de bästa fördelarna med båda. Det har dock vissa begränsningar som du bör
överväga innan du använder det.
Huvudbegränsningen är att om en disk misslyckas och du inte nyligen har
synkat, kanske du inte kan återställa fullständigt.
Mer specifikt, kanske du inte kan återställa upp till storleken på
de ändrade eller raderade filerna sedan den senaste synkroniseringsoperationen.
Detta inträffar även om de ändrade eller raderade filerna inte finns på
den felaktiga disken. Det är därför SnapRAID passar bättre för
data som sällan ändras.
Den huvudsakliga begränsningen är att om en disk havererar kan du endast återställa data fram till
tillståndet för den senaste `sync`-iseringen. Data som lagts till eller modifieringar som gjorts
sedan den senaste synkroniseringen och som är placerade på den felaktiga disken kommer att gå förlorade.
Å andra sidan förhindrar nyligen tillagda filer inte återställning av redan
befintliga filer. Du kommer bara att förlora de nyligen tillagda filerna om de
finns på den felaktiga disken.
Följaktligen är SnapRAID främst lämpat för data som sällan ändras.
För data som redan existerade vid den senaste synkroniseringen beror återställningens tillförlitlighet
på om alternativet `snapshot` (ögonblicksbild) används:
* Med stöd för ögonblicksbilder (tillgängligt på Btrfs, ZFS, Bcachefs och NTFS)
kan SnapRAID automatiskt upprätthålla en frusen referens av dina datadiskar.
Detta säkerställer att även om du ändrar eller tar bort filer på ditt aktiva filsystem
under eller efter en synkronisering, förblir återställningsprocessen konsekvent och tillförlitlig.
* Utan stöd för ögonblicksbilder kan borttagning eller ändring av filer efter en `sync`
förhindra fullständig återställning av andra felaktiga diskar. Detta inträffar
eftersom pariteten inte längre matchar de modifierade filerna, även om
dessa filer inte finns på den havererade disken. Å andra sidan förhindrar inte nyinkomna
filer återställning av redan existerande filer.
Andra SnapRAID-begränsningar är:
@ -384,15 +392,15 @@ Kom igång
Om allt är återställt är detta kommando omedelbart.
Kommandon
SnapRAID tillhandahåller några enkla kommandon som låter dig:
SnapRAID tillhandahåller några enkla kommandon som gör att du kan:
* Skriva ut statusen för arrayen -> `status`
* Skriva ut arrayens status -> `status`
* Kontrollera diskarna -> `smart`, `probe`, `up`, `down`
* Göra en säkerhetskopia/ögonblicksbild -> `sync`
* Skapa en backup-/återställningspunkt -> `sync`
* Periodiskt kontrollera data -> `scrub`
* Återställa den senaste säkerhetskopian/ögonblicksbilden -> `fix`.
* Återställa den senaste backup-/återställningspunkten -> `fix`.
Kommandon måste skrivas med gemener.
Kommandon måste skrivas med gemener (små bokstäver).
status
Skriver ut en sammanfattning av tillståndet för disk-arrayen.
@ -595,15 +603,14 @@ Kommandon
Filerna i arrayen modifieras INTE.
fix
Fixar alla filer och paritetsdata.
Lagar alla filer och paritetsdata.
Alla filer och paritetsdata jämförs med ögonblicksbilds-
tillståndet som sparades i den senaste `sync`.
Om en skillnad hittas, återställs den till det lagrade ögonblicksbildstillståndet.
Alla filer och paritetsdata jämförs med det tillstånd som sparades i
den senaste `sync`-iseringen. Om en skillnad hittas återställs den till det sparade tillståndet.
VARNING! Kommandot `fix` skiljer inte mellan fel och
avsiktliga modifieringar. Det återställer ovillkorligen filtillståndet
till den senaste `sync`.
VARNING!
Kommandot `fix` skiljer inte mellan fel och avsiktliga modifieringar.
Det återställer villkorslöst filtillståndet till den senaste `sync`-iseringen.
Om inget annat alternativ specificeras, behandlas hela arrayen.
Använd filteralternativen för att välja en delmängd av filer eller diskar att arbeta med.
@ -1148,6 +1155,30 @@ Konfiguration
Observera att sådana diskar inte påverkas av kommandona `up` och
`down` eftersom de förväntas alltid snurra.
snapshot
Aktiverar användningen av filsystemets ögonblicksbilder för kommandona `sync`, `scrub`,
`check` och `fix`.
När det är aktiverat skapar SnapRAID en skrivskyddad ögonblicksbild av dina data vid
början av en 'sync'. Detta säkerställer en konsekvent tidpunktsvy av dina
filer, vilket förhindrar fel som orsakas av samtidiga filändringar.
Detta förbättrar återställningen avsevärt: om en fil tas bort från det aktiva filsystemet
förblir den bevarad i ögonblicksbilden. Detta förhindrar att pariteten blir "trasig"
för det blocket, vilket säkerställer att du fortfarande kan återställa data framgångsrikt
om en annan disk havererar.
Detta alternativ gäller uteslutande datadiskar formaterade med filsystemen
Btrfs, Bcachefs eller ZFS i Linux och NTFS i Windows.
Paritetsdiskar, eller datadiskar som använder andra filsystem, kommer alltid att använda
den aktiva versionen av filsystemet.
Att skapa och ta bort ögonblicksbilder kräver administratörsbehörighet.
Se till att SnapRAID körs med nödvändiga rättigheter (t.ex. sudo) när
detta alternativ är aktiverat.
Se avsnittet SNAPSHOTS för en detaljerad förklaring av ögonblicksbildens livscykel.
nohidden
Exkluderar alla dolda filer och kataloger.
I Unix är dolda filer de som börjar med `.`.
@ -1385,6 +1416,115 @@ Konfiguration
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots (Ögonblicksbilder)
Om alternativet för ögonblicksbilder är aktiverat i konfigurationen använder SnapRAID
filsystemets funktionalitet för ögonblicksbilder för att säkerställa atomära och
konsekventa operationer.
Hanteringen av ögonblicksbilder är helt automatisk och transparent.
Du kan fortsätta att använda SnapRAID exakt som tidigare, med det
ytterligare skydd som ögonblicksbilder ger, helt hanterat i
bakgrunden.
Detta ger två huvudsakliga fördelar:
Konsistens - Filer som ändras på det aktiva filsystemet under en långvarig
sync eller scrub kommer inte att orsaka paritetsfel eller avbrutna
operationer, eftersom SnapRAID ser en frusen tidpunktsbild.
Återställning - Om en fil uppdateras eller tas bort från det aktiva filsystemet
förblir den bevarad i ögonblicksbilden. Om ett diskhaveri inträffar
innan nästa sync körs, använder SnapRAID den data som bevarats
i ögonblicksbilden för att rekonstruera den felaktiga disken.
I händelse av ett diskhaveri under en aktiv synkroniseringsprocess
kan SnapRAID också läsa automatiskt från både ögonblicksbilden
av den föregående paritetsberäkningen och den aktuella.
Detta maximerar sannolikheten för en fullständig återställning genom att
ge tillgång till de exakta datablock som krävs för att lösa paritetsekvationerna,
även om dessa block modifierades eller togs bort mellan synkroniseringar.
Utan ögonblicksbilder leder en uppdaterad eller borttagen fil på en frisk disk
till saknade datablock som kan krävas för att laga andra felaktiga diskar.
Ögonblicksbilder skapas endast för datadiskar och endast om det underliggande
filsystemet stöder denna funktionalitet. Paritetsdiskar använder alltid
det aktiva filsystemet.
För närvarande stöds detta på Btrfs, Bcachefs och ZFS i Linux
och på NTFS i Windows.
Du kan blanda datadiskar med olika filsystem. Endast de som
stöder ögonblicksbilder kommer att använda dem, medan andra diskar kommer att fortsätta
att fungera direkt på det aktiva filsystemet.
Att skapa och ta bort ögonblicksbilder kräver administratörsbehörighet.
Se till att SnapRAID körs med nödvändiga rättigheter (t.ex. sudo)
när ögonblicksbilder är aktiverade.
Kommandobeteende med ögonblicksbilder
Kommandona `sync` och `scrub` arbetar båda uteslutande på ögonblicksbilder
för att säkerställa att alla dataoperationer utförs mot ett konsekvent,
fruset tillstånd. Genom att använda dessa ögonblicksbilder förhindrar SnapRAID paritetsfel
som annars skulle utlösas av samtidiga filändringar på det aktiva filsystemet.
Under en `sync` använder kommandot en ny ögonblicksbild som skapas vid
början av processen för att fånga det aktuella tillståndet för paritetsberäkning.
I motsats till detta använder kommandot `scrub` den senaste ögonblicksbilden, den som
skapades under den senaste synkroniseringen, för att upprätthålla en tillförlitlig referenspunkt
som matchar den befintliga pariteten.
För kommandona `check` och `fix` beror användningen av den senaste ögonblicksbilden
på om specifika diskar är måltavla med alternativet
-d, --filter-disk.
En disk som uttryckligen valts via -d (operationens "mål")
använder alltid det aktiva filsystemet. För `fix` tillåter detta återställning
av data till den aktiva ersättningsdisken. För `check` tillåter det att simulera
`fix`-operationen under samma förhållanden.
Alla andra datadiskar ("referensdiskarna") kommer att nås via
sina ögonblicksbilder. Detta säkerställer att även om du ändrar filer
på dina friska diskar medan en återställning pågår, har SnapRAID
en stabil, frusen referens för att lösa paritetsekvationerna.
Om inget -d-alternativ anges antar SnapRAID kraschat att operationen gäller
hela arrayen, i detta fall kommer `check` och `fix` att använda de
aktiva filsystemen uteslutande.
Alla andra kommandon fungerar uteslutande på det aktiva filsystemet.
Livscykel för ögonblicksbilder
SnapRAID hanterar två specifika ögonblicksbilder, `stable` och `pending`,
inom en dold katalog i roten av varje datavolym.
I Btrfs, Bcachefs och NTFS används katalogen `.snapraid/`,
i ZFS standardkatalogen `.zfs/snapshot/`.
Ögonblicksbilden `stable` representerar tillståndet för den senaste
framgångsrikt slutförda `sync`-iseringen, och innehåller exakt den data som användes för
att beräkna den aktuella pariteten. Den fungerar som den primära datakällan
för kommandona `scrub`, `check` och `fix`.
Ögonblicksbilden `pending` är en tillfällig bild som skapas i början
av en `sync` för att tillhandahålla ett fruset tillstånd för paritetsberäkning.
Efter framgångsrik slutförande av operationen raderas den föregående `stable`
ögonblicksbilden, och `pending`-ögonblicksbilden upphöjs till
att ta dess plats som den nya stabila referensen.
Om en `sync` avbryts bevaras ögonblicksbilden `pending`.
Efterföljande `scrub`-, `check`- och `fix`-kommandon kommer att använda denna
vilande ögonblicksbild eftersom den matchar filsystemets tillstånd som registrerats i
.content-filen, även om pariteten endast är delvis synkroniserad.
I händelse av ett avbrott i en `sync` läser kommandona `check` och `fix`
också från ögonblicksbilden `stable` för att hämta datablock
från filer som uppdaterades eller togs bort under synkroniseringen.
Detta är möjligt eftersom .content-filen behåller metadata för
alla modifierade eller borttagna filer under hela synkroniseringsprocessen.
Denna historiska information rensas först när en sync slutförts
framgångsrikt och den slutliga versionen av .content-filen sparats.
Om en `sync` startas om efter ett avbrott raderas den befintliga
vilande (pending) ögonblicksbilden och en ny skapas för att
fånga det aktuella tillståndet för det aktiva filsystemet.
Mönster (Pattern)
Mönster ger ett flexibelt sätt att filtrera filer för inkludering eller
exkludering. Genom att använda jokertecken kan du definiera regler som

View file

@ -62,21 +62,29 @@ För mer information, besök den officiella SnapRAID-webbplatsen:
3 BEGRäNSNINGAR
===============
SnapRAID är en hybrid mellan ett RAID- och ett säkerhetskopieringsprogram,
som syftar till att kombinera de bästa fördelarna med båda. Den har dock
vissa begränsningar som du bör överväga innan du använder den.
SnapRAID är en hybrid mellan en RAID och ett backupprogram, med målet att kombinera
de bästa fördelarna med båda. Det har dock vissa begränsningar som du bör
överväga innan du använder det.
Huvudbegränsningen är att om en disk misslyckas och du inte nyligen har
synkat, kanske du inte kan återställa fullständigt.
Mer specifikt, kanske du inte kan återställa upp till storleken på
de ändrade eller raderade filerna sedan den senaste synkroniseringsoperationen.
Detta inträffar även om de ändrade eller raderade filerna inte finns på
den felaktiga disken. Det är därför SnapRAID passar bättre för
data som sällan ändras.
Den huvudsakliga begränsningen är att om en disk havererar kan du endast återställa data fram till
tillståndet för den senaste `sync`-iseringen. Data som lagts till eller modifieringar som gjorts
sedan den senaste synkroniseringen och som är placerade på den felaktiga disken kommer att gå förlorade.
Å andra sidan förhindrar nyligen tillagda filer inte återställning av redan
befintliga filer. Du kommer bara att förlora de nyligen tillagda filerna om de
finns på den felaktiga disken.
Följaktligen är SnapRAID främst lämpat för data som sällan ändras.
För data som redan existerade vid den senaste synkroniseringen beror återställningens tillförlitlighet
på om alternativet `snapshot` (ögonblicksbild) används:
* Med stöd för ögonblicksbilder (tillgängligt på Btrfs, ZFS, Bcachefs och NTFS)
kan SnapRAID automatiskt upprätthålla en frusen referens av dina datadiskar.
Detta säkerställer att även om du ändrar eller tar bort filer på ditt aktiva filsystem
under eller efter en synkronisering, förblir återställningsprocessen konsekvent och tillförlitlig.
* Utan stöd för ögonblicksbilder kan borttagning eller ändring av filer efter en `sync`
förhindra fullständig återställning av andra felaktiga diskar. Detta inträffar
eftersom pariteten inte längre matchar de modifierade filerna, även om
dessa filer inte finns på den havererade disken. Å andra sidan förhindrar inte nyinkomna
filer återställning av redan existerande filer.
Andra SnapRAID-begränsningar är:
@ -408,15 +416,15 @@ Om allt är återställt är detta kommando omedelbart.
5 KOMMANDON
===========
SnapRAID tillhandahåller några enkla kommandon som låter dig:
SnapRAID tillhandahåller några enkla kommandon som gör att du kan:
* Skriva ut statusen för arrayen -> `status`
* Skriva ut arrayens status -> `status`
* Kontrollera diskarna -> `smart`, `probe`, `up`, `down`
* Göra en säkerhetskopia/ögonblicksbild -> `sync`
* Skapa en backup-/återställningspunkt -> `sync`
* Periodiskt kontrollera data -> `scrub`
* Återställa den senaste säkerhetskopian/ögonblicksbilden -> `fix`.
* Återställa den senaste backup-/återställningspunkten -> `fix`.
Kommandon måste skrivas med gemener.
Kommandon måste skrivas med gemener (små bokstäver).
5.1 status
----------
@ -637,15 +645,14 @@ Filerna i arrayen modifieras INTE.
5.9 fix
-------
Fixar alla filer och paritetsdata.
Lagar alla filer och paritetsdata.
Alla filer och paritetsdata jämförs med ögonblicksbilds-
tillståndet som sparades i den senaste `sync`.
Om en skillnad hittas, återställs den till det lagrade ögonblicksbildstillståndet.
Alla filer och paritetsdata jämförs med det tillstånd som sparades i
den senaste `sync`-iseringen. Om en skillnad hittas återställs den till det sparade tillståndet.
VARNING! Kommandot `fix` skiljer inte mellan fel och
avsiktliga modifieringar. Det återställer ovillkorligen filtillståndet
till den senaste `sync`.
VARNING!
Kommandot `fix` skiljer inte mellan fel och avsiktliga modifieringar.
Det återställer villkorslöst filtillståndet till den senaste `sync`-iseringen.
Om inget annat alternativ specificeras, behandlas hela arrayen.
Använd filteralternativen för att välja en delmängd av filer eller diskar att arbeta med.
@ -1224,14 +1231,40 @@ startdisken.
Observera att sådana diskar inte påverkas av kommandona `up` och
`down` eftersom de förväntas alltid snurra.
7.7 nohidden
7.7 snapshot
------------
Aktiverar användningen av filsystemets ögonblicksbilder för kommandona `sync`, `scrub`,
`check` och `fix`.
När det är aktiverat skapar SnapRAID en skrivskyddad ögonblicksbild av dina data vid
början av en 'sync'. Detta säkerställer en konsekvent tidpunktsvy av dina
filer, vilket förhindrar fel som orsakas av samtidiga filändringar.
Detta förbättrar återställningen avsevärt: om en fil tas bort från det aktiva filsystemet
förblir den bevarad i ögonblicksbilden. Detta förhindrar att pariteten blir "trasig"
för det blocket, vilket säkerställer att du fortfarande kan återställa data framgångsrikt
om en annan disk havererar.
Detta alternativ gäller uteslutande datadiskar formaterade med filsystemen
Btrfs, Bcachefs eller ZFS i Linux och NTFS i Windows.
Paritetsdiskar, eller datadiskar som använder andra filsystem, kommer alltid att använda
den aktiva versionen av filsystemet.
Att skapa och ta bort ögonblicksbilder kräver administratörsbehörighet.
Se till att SnapRAID körs med nödvändiga rättigheter (t.ex. sudo) när
detta alternativ är aktiverat.
Se avsnittet SNAPSHOTS för en detaljerad förklaring av ögonblicksbildens livscykel.
7.8 nohidden
------------
Exkluderar alla dolda filer och kataloger.
I Unix är dolda filer de som börjar med `.`.
I Windows är de de med det dolda attributet.
7.8 exclude/include MÖNSTER
7.9 exclude/include MÖNSTER
---------------------------
Definierar fil- eller katalogmönstren att exkludera eller inkludera
@ -1249,8 +1282,8 @@ specifikationer.
Detta alternativ kan användas flera gånger.
7.9 blocksize STORLEK_I_KIBIBYTES
---------------------------------
7.10 blocksize STORLEK_I_KIBIBYTES
----------------------------------
Definierar den grundläggande blockstorleken i kibibytes för pariteten.
En kibibyte är 1024 byte.
@ -1297,7 +1330,7 @@ Detta resulterar i cirka 1,5% extra utrymme, ungefär 60 GB för
en 4 TB-disk, vilket möjliggör cirka 460 000 filer på varje datadisk utan
något bortkastat utrymme.
7.10 hashsize STORLEK_I_BYTE
7.11 hashsize STORLEK_I_BYTE
----------------------------
Definierar hash-storleken i byte för de sparade blocken.
@ -1335,7 +1368,7 @@ Om du byter till både en hash-storlek på 8 och en blockstorlek på 512 får du
RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB
7.11 autosave STORLEK_I_GIGABYTES
7.12 autosave STORLEK_I_GIGABYTES
---------------------------------
Sparar automatiskt tillståndet vid synkronisering eller skrubbning efter att den
@ -1343,7 +1376,7 @@ specificerade mängden GB har behandlats.
Detta alternativ är användbart för att undvika att starta om långa `sync`-
kommandon från början om de avbryts av en maskinkrasch eller någon annan händelse.
7.12 temp_limit TEMPERATUR_CELSIUS
7.13 temp_limit TEMPERATUR_CELSIUS
----------------------------------
Anger den maximalt tillåtna disk-temperaturen i Celsius. När den specificeras,
@ -1374,14 +1407,14 @@ temperaturen som mättes vid start av körningen som en reservreferens.
Normalt visar SnapRAID endast temperaturen på den hetaste disken.
För att visa temperaturen på alla diskar, använd alternativet -A eller --stats.
7.13 temp_sleep TID_I_MINUTER
7.14 temp_sleep TID_I_MINUTER
-----------------------------
Anger standby-tiden, i minuter, när temperaturgränsen har
nåtts. Under denna period förblir diskarna nedsnurrade. Standard
är 5 minuter.
7.14 pool KATALOG
7.15 pool KATALOG
-----------------
Definierar poolningskatalogen där den virtuella vyn av disk-
@ -1389,7 +1422,7 @@ arrayen skapas med hjälp av kommandot `pool`.
Katalogen måste redan existera.
7.15 share UNC_KATALOG
7.16 share UNC_KATALOG
----------------------
Definierar Windows UNC-sökvägen som krävs för att få åtkomst till diskarna på distans.
@ -1405,7 +1438,7 @@ katalog och namn.
Detta alternativ krävs endast för Windows.
7.16 smartctl DISK/PARITY ALTERNATIV...
7.17 smartctl DISK/PARITY ALTERNATIV...
---------------------------------------
Definierar anpassade smartctl-alternativ för att få SMART-attributen för
@ -1430,7 +1463,7 @@ Till exempel:
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
Ignorerar det specificerade SMART-attributet vid beräkning av sannolikheten
@ -1451,7 +1484,7 @@ För att ignorera det endast på den första paritetsdisken:
smartignore parity 197
7.18 Exempel
7.19 Exempel
------------
Ett exempel på en typisk konfiguration för Unix är:
@ -1486,8 +1519,125 @@ Ett exempel på en typisk konfiguration för Windows är:
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 MöNSTER (PATTERN)
===================
8 SNAPSHOTS (ÖGONBLICKSBILDER)
==============================
Om alternativet för ögonblicksbilder är aktiverat i konfigurationen använder SnapRAID
filsystemets funktionalitet för ögonblicksbilder för att säkerställa atomära och
konsekventa operationer.
Hanteringen av ögonblicksbilder är helt automatisk och transparent.
Du kan fortsätta att använda SnapRAID exakt som tidigare, med det
ytterligare skydd som ögonblicksbilder ger, helt hanterat i
bakgrunden.
Detta ger två huvudsakliga fördelar:
Konsistens - Filer som ändras på det aktiva filsystemet under en långvarig
sync eller scrub kommer inte att orsaka paritetsfel eller avbrutna
operationer, eftersom SnapRAID ser en frusen tidpunktsbild.
Återställning - Om en fil uppdateras eller tas bort från det aktiva filsystemet
förblir den bevarad i ögonblicksbilden. Om ett diskhaveri inträffar
innan nästa sync körs, använder SnapRAID den data som bevarats
i ögonblicksbilden för att rekonstruera den felaktiga disken.
I händelse av ett diskhaveri under en aktiv synkroniseringsprocess
kan SnapRAID också läsa automatiskt från både ögonblicksbilden
av den föregående paritetsberäkningen och den aktuella.
Detta maximerar sannolikheten för en fullständig återställning genom att
ge tillgång till de exakta datablock som krävs för att lösa paritetsekvationerna,
även om dessa block modifierades eller togs bort mellan synkroniseringar.
Utan ögonblicksbilder leder en uppdaterad eller borttagen fil på en frisk disk
till saknade datablock som kan krävas för att laga andra felaktiga diskar.
Ögonblicksbilder skapas endast för datadiskar och endast om det underliggande
filsystemet stöder denna funktionalitet. Paritetsdiskar använder alltid
det aktiva filsystemet.
För närvarande stöds detta på Btrfs, Bcachefs och ZFS i Linux
och på NTFS i Windows.
Du kan blanda datadiskar med olika filsystem. Endast de som
stöder ögonblicksbilder kommer att använda dem, medan andra diskar kommer att fortsätta
att fungera direkt på det aktiva filsystemet.
Att skapa och ta bort ögonblicksbilder kräver administratörsbehörighet.
Se till att SnapRAID körs med nödvändiga rättigheter (t.ex. sudo)
när ögonblicksbilder är aktiverade.
8.1 Kommandobeteende med ögonblicksbilder
-----------------------------------------
Kommandona `sync` och `scrub` arbetar båda uteslutande på ögonblicksbilder
för att säkerställa att alla dataoperationer utförs mot ett konsekvent,
fruset tillstånd. Genom att använda dessa ögonblicksbilder förhindrar SnapRAID paritetsfel
som annars skulle utlösas av samtidiga filändringar på det aktiva filsystemet.
Under en `sync` använder kommandot en ny ögonblicksbild som skapas vid
början av processen för att fånga det aktuella tillståndet för paritetsberäkning.
I motsats till detta använder kommandot `scrub` den senaste ögonblicksbilden, den som
skapades under den senaste synkroniseringen, för att upprätthålla en tillförlitlig referenspunkt
som matchar den befintliga pariteten.
För kommandona `check` och `fix` beror användningen av den senaste ögonblicksbilden
på om specifika diskar är måltavla med alternativet
-d, --filter-disk.
En disk som uttryckligen valts via -d (operationens "mål")
använder alltid det aktiva filsystemet. För `fix` tillåter detta återställning
av data till den aktiva ersättningsdisken. För `check` tillåter det att simulera
`fix`-operationen under samma förhållanden.
Alla andra datadiskar ("referensdiskarna") kommer att nås via
sina ögonblicksbilder. Detta säkerställer att även om du ändrar filer
på dina friska diskar medan en återställning pågår, har SnapRAID
en stabil, frusen referens för att lösa paritetsekvationerna.
Om inget -d-alternativ anges antar SnapRAID kraschat att operationen gäller
hela arrayen, i detta fall kommer `check` och `fix` att använda de
aktiva filsystemen uteslutande.
Alla andra kommandon fungerar uteslutande på det aktiva filsystemet.
9 LIVSCYKEL FöR öGONBLICKSBILDER
================================
SnapRAID hanterar två specifika ögonblicksbilder, `stable` och `pending`,
inom en dold katalog i roten av varje datavolym.
I Btrfs, Bcachefs och NTFS används katalogen `.snapraid/`,
i ZFS standardkatalogen `.zfs/snapshot/`.
Ögonblicksbilden `stable` representerar tillståndet för den senaste
framgångsrikt slutförda `sync`-iseringen, och innehåller exakt den data som användes för
att beräkna den aktuella pariteten. Den fungerar som den primära datakällan
för kommandona `scrub`, `check` och `fix`.
Ögonblicksbilden `pending` är en tillfällig bild som skapas i början
av en `sync` för att tillhandahålla ett fruset tillstånd för paritetsberäkning.
Efter framgångsrik slutförande av operationen raderas den föregående `stable`
ögonblicksbilden, och `pending`-ögonblicksbilden upphöjs till
att ta dess plats som den nya stabila referensen.
Om en `sync` avbryts bevaras ögonblicksbilden `pending`.
Efterföljande `scrub`-, `check`- och `fix`-kommandon kommer att använda denna
vilande ögonblicksbild eftersom den matchar filsystemets tillstånd som registrerats i
.content-filen, även om pariteten endast är delvis synkroniserad.
I händelse av ett avbrott i en `sync` läser kommandona `check` och `fix`
också från ögonblicksbilden `stable` för att hämta datablock
från filer som uppdaterades eller togs bort under synkroniseringen.
Detta är möjligt eftersom .content-filen behåller metadata för
alla modifierade eller borttagna filer under hela synkroniseringsprocessen.
Denna historiska information rensas först när en sync slutförts
framgångsrikt och den slutliga versionen av .content-filen sparats.
Om en `sync` startas om efter ett avbrott raderas den befintliga
vilande (pending) ögonblicksbilden och en ny skapas för att
fånga det aktuella tillståndet för det aktiva filsystemet.
10 MöNSTER (PATTERN)
====================
Mönster ger ett flexibelt sätt att filtrera filer för inkludering eller
exkludering. Genom att använda jokertecken kan du definiera regler som
@ -1605,8 +1755,8 @@ I Unix, när du använder globbing-tecken på kommandoraden, måste du
citattecken dem för att förhindra att skalet expanderar dem.
9 IGNORERA FILER (IGNORE FILE)
==============================
11 IGNORERA FILER (IGNORE FILE)
===============================
Utöver de globala reglerna i konfigurationsfilen kan du placera
`.snapraidignore`-filer i vilken katalog som helst i arrayen för att definiera
@ -1650,7 +1800,7 @@ Till exempel, om du har en `.snapraidignore` i `/mnt/disk1/projects/`:
*.tmp
10 INNEHåLL (CONTENT)
12 INNEHåLL (CONTENT)
=====================
SnapRAID lagrar listan och checksummorna för dina filer i content-filen.
@ -1662,7 +1812,7 @@ Denna fil läses och skrivs av kommandona `sync` och `scrub` och
läses av kommandona `fix`, `check` och `status`.
11 PARITET (PARITY)
13 PARITET (PARITY)
===================
SnapRAID lagrar paritetsinformationen för din array i parity-
@ -1675,7 +1825,7 @@ Dessa filer läses och skrivs av kommandona `sync` och `fix` och
läses endast av kommandona `scrub` och `check`.
12 KODNING
14 KODNING
==========
SnapRAID i Unix ignorerar all kodning. Det läser och lagrar
@ -1692,13 +1842,13 @@ omdirigerar konsolutdata till en fil, är den resulterande filen alltid
i UTF-8-format.
13 UPPHOVSRäTT (COPYRIGHT)
15 UPPHOVSRäTT (COPYRIGHT)
==========================
Denna fil är Copyright (C) 2025 Andrea Mazzoleni
14 SE ÄVEN (SEE ALSO)
16 SE ÄVEN (SEE ALSO)
=====================
snapraid_log(1), snapraidd(1)

View file

@ -121,23 +121,33 @@ https://www.snapraid.it/
.PD
.RE
.SH Обмеження
SnapRAID є гібридом між RAID та програмою резервного копіювання,
прагнучи поєднати найкращі переваги обох. Однак, він має деякі
обмеження, які слід врахувати перед його використанням.
SnapRAID є гібридом між RAID і програмою резервного копіювання, що має на меті поєднати
найкращі переваги обох рішень. Однак у нього є деякі обмеження, які вам слід
врахувати перед використанням.
.PP
Основне обмеження полягає в тому, що якщо диск виходить з ладу,
а ви нещодавно не виконували синхронізацію, ви можете не
змогти повністю відновити дані.
Конкретніше, ви можете втратити можливість відновлення даних
обсягом до розміру змінених або видалених файлів з моменту
останньої операції синхронізації.
Це відбувається, навіть якщо змінені або видалені файли не
знаходяться на диску, що вийшов з ладу. Ось чому SnapRAID
краще підходить для даних, які рідко змінюються.
Головне обмеження полягає в тому, що у разі збою диска ви можете відновити дані лише до
стану останньої операції синхронізації (\`sync\`). Будь\-які дані, додані або змінені
з моменту останньої синхронізації, які розташовані на пошкодженому диску, будуть втрачені.
.PP
З іншого боку, щойно додані файли не перешкоджають відновленню
вже існуючих файлів. Ви втратите лише нещодавно додані файли,
якщо вони знаходяться на диску, що вийшов з ладу.
Відповідно, SnapRAID насамперед підходить для даних, які рідко змінюються.
.PP
Для даних, які вже існували на момент останньої синхронізації, надійність відновлення залежить
від того, чи використовується опція знімка (\`snapshot\`):
.PD 0
.IP \(bu
За наявності підтримки знімків (доступно на Btrfs, ZFS, Bcachefs та NTFS),
SnapRAID може автоматично підтримувати заморожену копію ваших дисків із даними.
Це гарантує, що навіть якщо ви зміните або видалите файли у вашій живій файловій системі
під час або після синхронізації, процес відновлення залишиться узгодженим і надійним.
.PD
.PD 0
.IP \(bu
Без підтримки знімків видалення або зміна файлів після \`sync\`
може запобігти повному відновленню інших дисків, що зазнали збою. Це відбувається
тому, що парність більше не відповідає зміненим файлам, навіть якщо
ці файли знаходяться не на пошкодженому диску. З іншого боку, щойно додані
файли не перешкоджають відновленню вже існуючих файлів.
.PD
.PP
Інші обмеження SnapRAID:
.PD 0
@ -692,14 +702,14 @@ SnapRAID надає кілька простих команд, які дозво
.IP \(bu
Керувати дисками \-> \`smart\`, \`probe\`, \`up\`, \`down\`
.IP \(bu
Створити резервну копію/знімок \-> \`sync\`
Створити точку резервного копіювання/відновлення \-> \`sync\`
.IP \(bu
Періодично перевіряти дані \-> \`scrub\`
.IP \(bu
Відновити останню резервну копію/знімок \-> \`fix\`.
Відновити останню точку резервного копіювання/відновлення \-> \`fix\`.
.PD
.PP
Команди повинні бути написані малими літерами.
Команди обов\'язково повинні бути написані малими літерами.
.SS status
Виводить зведення стану дискового масиву.
.PP
@ -952,15 +962,14 @@ new \- Скрабувати щойно синхронізовані блоки,
Файли \`parity\` НЕ змінюються.
Файли в масиві НЕ змінюються.
.SS fix
Виправляє всі файли та дані парності.
Відновлює всі файли та дані парності.
.PP
Усі файли та дані парності порівнюються зі станом знімка,
збереженим під час останньої \`sync\`.
Якщо знайдено різницю, вона повертається до збереженого знімка.
Усі файли та дані парності порівнюються зі станом, збереженим під час
останньої синхронізації \`sync\`. Якщо виявлено відмінність, стан повертається до збереженого.
.PP
УВАГА! Команда \`fix\` не розрізняє помилки та навмисні
модифікації. Вона безумовно повертає стан файлу до останньої
\`sync\`.
УВАГА!
Команда \`fix\` не робить різниці між помилками та навмисними змінами.
Вона безумовно повертає стан файлів до моменту останньої синхронізації \`sync\`.
.PP
Якщо не вказано жодної іншої опції, обробляється весь масив.
Використовуйте опції фільтра, щоб вибрати підмножину файлів
@ -1557,6 +1566,29 @@ UUID дисків.
.PP
Зверніть увагу, що на такі диски не впливають команди \`up\` та \`down\`,
оскільки очікується, що вони завжди обертаються.
.SS snapshot
Включає використання знімків файлової системи для команд \`sync\`, \`scrub\`,
\`check\` та \`fix\`.
.PP
Якщо увімкнено, SnapRAID створює знімок ваших даних лише для читання на
початку операції \'sync\'. Це забезпечує узгоджений зріз ваших файлів на певний момент часу,
запобігаючи помилкам, викликаним одночасним зміненням файлів.
.PP
Це значно покращує відновлення: якщо файл видаляється з живої файлової системи,
він залишається збереженим у знімку. Це запобігає «порушенню» парності
для цього блоку, гарантуючи, що ви все одно зможете успішно відновити дані,
якщо інший диск зазнає збою.
.PP
Ця опція застосовується виключно до дисків із даними, відформатованих у файлових
системах Btrfs, Bcachefs або ZFS у Linux та NTFS у Windows.
Диски парності або диски з даними, що використовують інші файлові системи, завжди використовуватимуть
живу версію файлової системи.
.PP
Створення та видалення знімків вимагають прав адміністратора.
Переконайтеся, що SnapRAID запущено з необхідними привілеями (наприклад, sudo), коли
включено цю опцію.
.PP
Детальне пояснення життєвого циклу знімків див. у розділі SNAPSHOTS.
.SS nohidden
Виключає всі приховані файли та каталоги.
В Unix приховані файли — це ті, що починаються з \`.\`.
@ -1936,6 +1968,124 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS (Знімки)
Якщо в конфігурації увімкнено опцію знімків, SnapRAID використовує
функціональність знімків файлової системи для забезпечення атомарності та
узгодженості операцій.
.PP
Керування знімками відбувається повністю автоматично та прозоро.
Ви можете продовжувати використовувати SnapRAID точно так само, як і раніше, отримуючи
додатковий захист, що забезпечується знімками, які повністю обробляються у
фоновому режимі.
.PP
Це дає дві основні переваги:
.PP
Узгодженість — Файли, змінені в живій файловій системі під час тривалого
.PP
.RS 4
процесу sync або scrub, не викликатимуть невідповідності парності або переривання
операцій, оскільки SnapRAID бачить заморожений знімок на момент часу.
.RE
.PP
Відновлення — Якщо файл оновлюється або видаляється з живої файлової системи,
.PP
.RS 4
він залишається збереженим у знімку. Якщо збій диска станеться
до запуску наступної синхронізації sync, SnapRAID використає дані, збережені
в знімку, для реконструкції диска, що зазнав збою.
.RE
.PP
.RS 4
У разі збою диска під час активного процесу sync,
SnapRAID також може автоматично читати як зі знімка попереднього
обчислення парності, так і з поточного.
Це максимізує ймовірність повного відновлення, надаючи
доступ до точних блоків даних, необхідних для вирішення рівнянь парності,
навіть якщо ці блоки були змінені або видалені між синхронізаціями.
.RE
.PP
.RS 4
Без знімків оновлений або видалений файл на справному диску
призводить до відсутності блоків даних, які можуть знадобитися для
відновлення інших дисків, що зазнали збою.
.RE
.PP
Знімки створюються лише для дисків із даними і лише в тому випадку, якщо базова
файлова система підтримує цю функціональність. Диски парності завжди використовують
живу файлову систему.
Наразі це підтримується на Btrfs, Bcachefs та ZFS в Linux
і на NTFS у Windows.
.PP
Ви можете комбінувати диски з даними з різними файловими системами. Тільки ті з них,
які підтримують знімки, використовуватимуть їх, тоді як інші диски продовжуватимуть
працювати безпосередньо з живою файловою системою.
.PP
Створення та видалення знімків вимагають прав адміністратора.
Переконайтеся, що SnapRAID запущено з необхідними привілеями (наприклад, sudo),
коли знімки увімкнено.
.SS Поведінка команд із знімками
Команди \`sync\` та \`scrub\` працюють виключно зі знімками,
щоб гарантувати, що всі операції з даними виконуються на узгодженому,
замороженому стані. Використовуючи ці знімки, SnapRAID запобігає невідповідності
парності, яка в іншому випадку була б викликана одночасними змінами файлів у живій файловій системі.
Під час \`sync\` команда використовує новий знімок, створений на початку
процесу, для фіксації поточного стану для обчислення парності.
Навпаки, команда \`scrub\` використовує останній знімок, створений під час
найостаннішої синхронізації, щоб підтримувати надійну точку відліку,
яка відповідає існуючій парності.
.PP
Для команд \`check\` та \`fix\` використання останнього знімка
залежить від того, чи націлені конкретні диски за допомогою опції
\-d, \-\-filter\-disk.
.PP
Диск, явно вибраний за допомогою \-d («ціль» операції),
завжди використовує живу файлову систему. Для \`fix\` це дозволяє відновити
дані на активну заміну диска. Для \`check\` це дозволяє симулювати
операцію \`fix\` за тих самих умов.
.PP
Доступ до всіх інших дисків із даними («довідкових» дисків) здійснюватиметься через
їхні знімки. Це гарантує, що навіть якщо ви змінюєте файли
на своїх справних дисках під час відновлення, SnapRAID
має стабільну, замороженну точку відліку для вирішення рівнянь парності.
.PP
Якщо опція \-d не надана, SnapRAID припускає, що операція застосовується
до всього масиву; у цьому випадку \`check\` та \`fix\` використовуватимуть виключно
живі файлові системи.
.PP
Усі інші команди працюють виключно з живою файловою системою.
.SH Життєвий цикл знімків
SnapRAID керує двома конкретними знімками, \`stable\` та \`pending\`,
всередині прихованого каталогу в корінному каталозі кожного підтому даних.
У Btrfs, Bcachefs та NTFS використовується каталог \`.snapraid/\`,
у ZFS — стандартний \`.zfs/snapshot/\`.
.PP
Знімок \`stable\` представляє стан останньої успішно
завершеної синхронізації \`sync\`, що містить точні дані, використані для
обчислення поточної парності. Він служить основним джерелом даних
для команд \`scrub\`, \`check\` та \`fix\`.
.PP
Знімок \`pending\` — це тимчасовий образ, що створюється на початку
\`sync\` для забезпечення замороженого стану для обчислення парності.
Після успішного завершення операції попередній знімок \`stable\`
видаляється, а знімок \`pending\` підвищується в статусі, щоб
зайняти його місце в якості нового стабільного орієнтира.
.PP
Якщо процес \`sync\` переривається, знімок \`pending\` зберігається.
Наступні команди \`scrub\`, \`check\` та \`fix\` використовуватимуть цей
очікуваний знімок, оскільки він відповідає стану файлової системи, записаному в
файлі .content, навіть якщо парність синхронізована лише частково.
.PP
У разі переривання \`sync\` команди \`check\` та \`fix\`
також читають дані зі знімка \`stable\` для вилучення блоків даних
із файлів, які були оновлені або видалені під час синхронізації.
Це можливо тому, що файл .content зберігає метадані для
усіх змінених або видалених файлів протягом усього процесу sync.
Ця історична інформація очищається лише після успішного завершення sync
і збереження фінальної версії файлу .content.
.PP
Якщо \`sync\` перезапускається після переривання, існуючий
очікуваний (pending) знімок видаляється, і створюється новий для
фіксації поточного стану живої файлової системи.
.SH Шаблон (PATTERN)
Шаблони забезпечують гнучкий спосіб фільтрації файлів для включення або
виключення. Використовуючи символи підстановки (globbing), ви можете визначити правила, які

View file

@ -55,23 +55,29 @@ Name{number}
:https://www.snapraid.it/
Обмеження
SnapRAID є гібридом між RAID та програмою резервного копіювання,
прагнучи поєднати найкращі переваги обох. Однак, він має деякі
обмеження, які слід врахувати перед його використанням.
SnapRAID є гібридом між RAID і програмою резервного копіювання, що має на меті поєднати
найкращі переваги обох рішень. Однак у нього є деякі обмеження, які вам слід
врахувати перед використанням.
Основне обмеження полягає в тому, що якщо диск виходить з ладу,
а ви нещодавно не виконували синхронізацію, ви можете не
змогти повністю відновити дані.
Конкретніше, ви можете втратити можливість відновлення даних
обсягом до розміру змінених або видалених файлів з моменту
останньої операції синхронізації.
Це відбувається, навіть якщо змінені або видалені файли не
знаходяться на диску, що вийшов з ладу. Ось чому SnapRAID
краще підходить для даних, які рідко змінюються.
Головне обмеження полягає в тому, що у разі збою диска ви можете відновити дані лише до
стану останньої операції синхронізації (`sync`). Будь-які дані, додані або змінені
з моменту останньої синхронізації, які розташовані на пошкодженому диску, будуть втрачені.
З іншого боку, щойно додані файли не перешкоджають відновленню
вже існуючих файлів. Ви втратите лише нещодавно додані файли,
якщо вони знаходяться на диску, що вийшов з ладу.
Відповідно, SnapRAID насамперед підходить для даних, які рідко змінюються.
Для даних, які вже існували на момент останньої синхронізації, надійність відновлення залежить
від того, чи використовується опція знімка (`snapshot`):
* За наявності підтримки знімків (доступно на Btrfs, ZFS, Bcachefs та NTFS),
SnapRAID може автоматично підтримувати заморожену копію ваших дисків із даними.
Це гарантує, що навіть якщо ви зміните або видалите файли у вашій живій файловій системі
під час або після синхронізації, процес відновлення залишиться узгодженим і надійним.
* Без підтримки знімків видалення або зміна файлів після `sync`
може запобігти повному відновленню інших дисків, що зазнали збою. Це відбувається
тому, що парність більше не відповідає зміненим файлам, навіть якщо
ці файли знаходяться не на пошкодженому диску. З іншого боку, щойно додані
файли не перешкоджають відновленню вже існуючих файлів.
Інші обмеження SnapRAID:
@ -429,11 +435,11 @@ Name{number}
* Вивести статус масиву -> `status`
* Керувати дисками -> `smart`, `probe`, `up`, `down`
* Створити резервну копію/знімок -> `sync`
* Створити точку резервного копіювання/відновлення -> `sync`
* Періодично перевіряти дані -> `scrub`
* Відновити останню резервну копію/знімок -> `fix`.
* Відновити останню точку резервного копіювання/відновлення -> `fix`.
Команди повинні бути написані малими літерами.
Команди обов'язково повинні бути написані малими літерами.
status
Виводить зведення стану дискового масиву.
@ -650,15 +656,14 @@ Name{number}
Файли в масиві НЕ змінюються.
fix
Виправляє всі файли та дані парності.
Відновлює всі файли та дані парності.
Усі файли та дані парності порівнюються зі станом знімка,
збереженим під час останньої `sync`.
Якщо знайдено різницю, вона повертається до збереженого знімка.
Усі файли та дані парності порівнюються зі станом, збереженим під час
останньої синхронізації `sync`. Якщо виявлено відмінність, стан повертається до збереженого.
УВАГА! Команда `fix` не розрізняє помилки та навмисні
модифікації. Вона безумовно повертає стан файлу до останньої
`sync`.
УВАГА!
Команда `fix` не робить різниці між помилками та навмисними змінами.
Вона безумовно повертає стан файлів до моменту останньої синхронізації `sync`.
Якщо не вказано жодної іншої опції, обробляється весь масив.
Використовуйте опції фільтра, щоб вибрати підмножину файлів
@ -1266,6 +1271,30 @@ Name{number}
Зверніть увагу, що на такі диски не впливають команди `up` та `down`,
оскільки очікується, що вони завжди обертаються.
snapshot
Включає використання знімків файлової системи для команд `sync`, `scrub`,
`check` та `fix`.
Якщо увімкнено, SnapRAID створює знімок ваших даних лише для читання на
початку операції 'sync'. Це забезпечує узгоджений зріз ваших файлів на певний момент часу,
запобігаючи помилкам, викликаним одночасним зміненням файлів.
Це значно покращує відновлення: якщо файл видаляється з живої файлової системи,
він залишається збереженим у знімку. Це запобігає «порушенню» парності
для цього блоку, гарантуючи, що ви все одно зможете успішно відновити дані,
якщо інший диск зазнає збою.
Ця опція застосовується виключно до дисків із даними, відформатованих у файлових
системах Btrfs, Bcachefs або ZFS у Linux та NTFS у Windows.
Диски парності або диски з даними, що використовують інші файлові системи, завжди використовуватимуть
живу версію файлової системи.
Створення та видалення знімків вимагають прав адміністратора.
Переконайтеся, що SnapRAID запущено з необхідними привілеями (наприклад, sudo), коли
включено цю опцію.
Детальне пояснення життєвого циклу знімків див. у розділі SNAPSHOTS.
nohidden
Виключає всі приховані файли та каталоги.
В Unix приховані файли — це ті, що починаються з `.`.
@ -1549,6 +1578,116 @@ Name{number}
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots (Знімки)
Якщо в конфігурації увімкнено опцію знімків, SnapRAID використовує
функціональність знімків файлової системи для забезпечення атомарності та
узгодженості операцій.
Керування знімками відбувається повністю автоматично та прозоро.
Ви можете продовжувати використовувати SnapRAID точно так само, як і раніше, отримуючи
додатковий захист, що забезпечується знімками, які повністю обробляються у
фоновому режимі.
Це дає дві основні переваги:
Узгодженість — Файли, змінені в живій файловій системі під час тривалого
процесу sync або scrub, не викликатимуть невідповідності парності або переривання
операцій, оскільки SnapRAID бачить заморожений знімок на момент часу.
Відновлення — Якщо файл оновлюється або видаляється з живої файлової системи,
він залишається збереженим у знімку. Якщо збій диска станеться
до запуску наступної синхронізації sync, SnapRAID використає дані, збережені
в знімку, для реконструкції диска, що зазнав збою.
У разі збою диска під час активного процесу sync,
SnapRAID також може автоматично читати як зі знімка попереднього
обчислення парності, так і з поточного.
Це максимізує ймовірність повного відновлення, надаючи
доступ до точних блоків даних, необхідних для вирішення рівнянь парності,
навіть якщо ці блоки були змінені або видалені між синхронізаціями.
Без знімків оновлений або видалений файл на справному диску
призводить до відсутності блоків даних, які можуть знадобитися для
відновлення інших дисків, що зазнали збою.
Знімки створюються лише для дисків із даними і лише в тому випадку, якщо базова
файлова система підтримує цю функціональність. Диски парності завжди використовують
живу файлову систему.
Наразі це підтримується на Btrfs, Bcachefs та ZFS в Linux
і на NTFS у Windows.
Ви можете комбінувати диски з даними з різними файловими системами. Тільки ті з них,
які підтримують знімки, використовуватимуть їх, тоді як інші диски продовжуватимуть
працювати безпосередньо з живою файловою системою.
Створення та видалення знімків вимагають прав адміністратора.
Переконайтеся, що SnapRAID запущено з необхідними привілеями (наприклад, sudo),
коли знімки увімкнено.
Поведінка команд із знімками
Команди `sync` та `scrub` працюють виключно зі знімками,
щоб гарантувати, що всі операції з даними виконуються на узгодженому,
замороженому стані. Використовуючи ці знімки, SnapRAID запобігає невідповідності
парності, яка в іншому випадку була б викликана одночасними змінами файлів у живій файловій системі.
Під час `sync` команда використовує новий знімок, створений на початку
процесу, для фіксації поточного стану для обчислення парності.
Навпаки, команда `scrub` використовує останній знімок, створений під час
найостаннішої синхронізації, щоб підтримувати надійну точку відліку,
яка відповідає існуючій парності.
Для команд `check` та `fix` використання останнього знімка
залежить від того, чи націлені конкретні диски за допомогою опції
-d, --filter-disk.
Диск, явно вибраний за допомогою -d («ціль» операції),
завжди використовує живу файлову систему. Для `fix` це дозволяє відновити
дані на активну заміну диска. Для `check` це дозволяє симулювати
операцію `fix` за тих самих умов.
Доступ до всіх інших дисків із даними («довідкових» дисків) здійснюватиметься через
їхні знімки. Це гарантує, що навіть якщо ви змінюєте файли
на своїх справних дисках під час відновлення, SnapRAID
має стабільну, замороженну точку відліку для вирішення рівнянь парності.
Якщо опція -d не надана, SnapRAID припускає, що операція застосовується
до всього масиву; у цьому випадку `check` та `fix` використовуватимуть виключно
живі файлові системи.
Усі інші команди працюють виключно з живою файловою системою.
Життєвий цикл знімків
SnapRAID керує двома конкретними знімками, `stable` та `pending`,
всередині прихованого каталогу в корінному каталозі кожного підтому даних.
У Btrfs, Bcachefs та NTFS використовується каталог `.snapraid/`,
у ZFS — стандартний `.zfs/snapshot/`.
Знімок `stable` представляє стан останньої успішно
завершеної синхронізації `sync`, що містить точні дані, використані для
обчислення поточної парності. Він служить основним джерелом даних
для команд `scrub`, `check` та `fix`.
Знімок `pending` — це тимчасовий образ, що створюється на початку
`sync` для забезпечення замороженого стану для обчислення парності.
Після успішного завершення операції попередній знімок `stable`
видаляється, а знімок `pending` підвищується в статусі, щоб
зайняти його місце в якості нового стабільного орієнтира.
Якщо процес `sync` переривається, знімок `pending` зберігається.
Наступні команди `scrub`, `check` та `fix` використовуватимуть цей
очікуваний знімок, оскільки він відповідає стану файлової системи, записаному в
файлі .content, навіть якщо парність синхронізована лише частково.
У разі переривання `sync` команди `check` та `fix`
також читають дані зі знімка `stable` для вилучення блоків даних
із файлів, які були оновлені або видалені під час синхронізації.
Це можливо тому, що файл .content зберігає метадані для
усіх змінених або видалених файлів протягом усього процесу sync.
Ця історична інформація очищається лише після успішного завершення sync
і збереження фінальної версії файлу .content.
Якщо `sync` перезапускається після переривання, існуючий
очікуваний (pending) знімок видаляється, і створюється новий для
фіксації поточного стану живої файлової системи.
Шаблон (Pattern)
Шаблони забезпечують гнучкий спосіб фільтрації файлів для включення або
виключення. Використовуючи символи підстановки (globbing), ви можете визначити правила, які

View file

@ -65,23 +65,29 @@ SnapRAID:
3 Обмеження
===========
SnapRAID є гібридом між RAID та програмою резервного копіювання,
прагнучи поєднати найкращі переваги обох. Однак, він має деякі
обмеження, які слід врахувати перед його використанням.
SnapRAID є гібридом між RAID і програмою резервного копіювання, що має на меті поєднати
найкращі переваги обох рішень. Однак у нього є деякі обмеження, які вам слід
врахувати перед використанням.
Основне обмеження полягає в тому, що якщо диск виходить з ладу,
а ви нещодавно не виконували синхронізацію, ви можете не
змогти повністю відновити дані.
Конкретніше, ви можете втратити можливість відновлення даних
обсягом до розміру змінених або видалених файлів з моменту
останньої операції синхронізації.
Це відбувається, навіть якщо змінені або видалені файли не
знаходяться на диску, що вийшов з ладу. Ось чому SnapRAID
краще підходить для даних, які рідко змінюються.
Головне обмеження полягає в тому, що у разі збою диска ви можете відновити дані лише до
стану останньої операції синхронізації (`sync`). Будь-які дані, додані або змінені
з моменту останньої синхронізації, які розташовані на пошкодженому диску, будуть втрачені.
З іншого боку, щойно додані файли не перешкоджають відновленню
вже існуючих файлів. Ви втратите лише нещодавно додані файли,
якщо вони знаходяться на диску, що вийшов з ладу.
Відповідно, SnapRAID насамперед підходить для даних, які рідко змінюються.
Для даних, які вже існували на момент останньої синхронізації, надійність відновлення залежить
від того, чи використовується опція знімка (`snapshot`):
* За наявності підтримки знімків (доступно на Btrfs, ZFS, Bcachefs та NTFS),
SnapRAID може автоматично підтримувати заморожену копію ваших дисків із даними.
Це гарантує, що навіть якщо ви зміните або видалите файли у вашій живій файловій системі
під час або після синхронізації, процес відновлення залишиться узгодженим і надійним.
* Без підтримки знімків видалення або зміна файлів після `sync`
може запобігти повному відновленню інших дисків, що зазнали збою. Це відбувається
тому, що парність більше не відповідає зміненим файлам, навіть якщо
ці файли знаходяться не на пошкодженому диску. З іншого боку, щойно додані
файли не перешкоджають відновленню вже існуючих файлів.
Інші обмеження SnapRAID:
@ -453,11 +459,11 @@ SnapRAID надає кілька простих команд, які дозво
* Вивести статус масиву -> `status`
* Керувати дисками -> `smart`, `probe`, `up`, `down`
* Створити резервну копію/знімок -> `sync`
* Створити точку резервного копіювання/відновлення -> `sync`
* Періодично перевіряти дані -> `scrub`
* Відновити останню резервну копію/знімок -> `fix`.
* Відновити останню точку резервного копіювання/відновлення -> `fix`.
Команди повинні бути написані малими літерами.
Команди обов'язково повинні бути написані малими літерами.
5.1 status
----------
@ -692,15 +698,14 @@ full - Скрабувати все.
5.9 fix
-------
Виправляє всі файли та дані парності.
Відновлює всі файли та дані парності.
Усі файли та дані парності порівнюються зі станом знімка,
збереженим під час останньої `sync`.
Якщо знайдено різницю, вона повертається до збереженого знімка.
Усі файли та дані парності порівнюються зі станом, збереженим під час
останньої синхронізації `sync`. Якщо виявлено відмінність, стан повертається до збереженого.
УВАГА! Команда `fix` не розрізняє помилки та навмисні
модифікації. Вона безумовно повертає стан файлу до останньої
`sync`.
УВАГА!
Команда `fix` не робить різниці між помилками та навмисними змінами.
Вона безумовно повертає стан файлів до моменту останньої синхронізації `sync`.
Якщо не вказано жодної іншої опції, обробляється весь масив.
Використовуйте опції фільтра, щоб вибрати підмножину файлів
@ -1342,14 +1347,40 @@ UUID дисків.
Зверніть увагу, що на такі диски не впливають команди `up` та `down`,
оскільки очікується, що вони завжди обертаються.
7.7 nohidden
7.7 snapshot
------------
Включає використання знімків файлової системи для команд `sync`, `scrub`,
`check` та `fix`.
Якщо увімкнено, SnapRAID створює знімок ваших даних лише для читання на
початку операції 'sync'. Це забезпечує узгоджений зріз ваших файлів на певний момент часу,
запобігаючи помилкам, викликаним одночасним зміненням файлів.
Це значно покращує відновлення: якщо файл видаляється з живої файлової системи,
він залишається збереженим у знімку. Це запобігає «порушенню» парності
для цього блоку, гарантуючи, що ви все одно зможете успішно відновити дані,
якщо інший диск зазнає збою.
Ця опція застосовується виключно до дисків із даними, відформатованих у файлових
системах Btrfs, Bcachefs або ZFS у Linux та NTFS у Windows.
Диски парності або диски з даними, що використовують інші файлові системи, завжди використовуватимуть
живу версію файлової системи.
Створення та видалення знімків вимагають прав адміністратора.
Переконайтеся, що SnapRAID запущено з необхідними привілеями (наприклад, sudo), коли
включено цю опцію.
Детальне пояснення життєвого циклу знімків див. у розділі SNAPSHOTS.
7.8 nohidden
------------
Виключає всі приховані файли та каталоги.
В Unix приховані файли — це ті, що починаються з `.`.
У Windows це ті, що мають прихований атрибут.
7.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
Визначає шаблони файлів або каталогів для виключення
@ -1368,8 +1399,8 @@ UUID дисків.
Цю опцію можна використовувати кілька разів.
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
Визначає основний розмір блоку в кібібайтах для парності.
Один кібібайт дорівнює 1024 байтам.
@ -1428,7 +1459,7 @@ Linux, полягає в тому, щоб відформатувати його
приблизно 460 000 файлів на кожному диску даних
без будь-якого витраченого місця.
7.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
Визначає розмір хешу в байтах для збережених блоків.
@ -1469,7 +1500,7 @@ RAM = $(8 \times 4 \times 10^{12}) \times (1+16) / (512 \times 2^{10}) = 0.96$
RAM = $(8 \times 4 \times 10^{12}) \times (1+8) / (512 \times 2^{10}) = 0.51$ ГіБ
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
Автоматично зберігає стан під час синхронізації або
@ -1478,7 +1509,7 @@ RAM = $(8 \times 4 \times 10^{12}) \times (1+8) / (512 \times 2^{10}) = 0.51$ Г
команд `sync` з нуля, якщо вони були перервані
збоєм машини або будь-якою іншою подією.
7.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
Встановлює максимальну дозволену температуру диска
@ -1521,7 +1552,7 @@ smartctl. Поточні температури дисків відобража
найгарячішого диска. Щоб відобразити температуру
всіх дисків, використовуйте опцію -A або --stats.
7.13 temp_sleep TIME_IN_MINUTES
7.14 temp_sleep TIME_IN_MINUTES
-------------------------------
Встановлює час очікування, у хвилинах, коли
@ -1529,7 +1560,7 @@ smartctl. Поточні температури дисків відобража
періоду диски залишаються зупиненими.
За замовчуванням 5 хвилин.
7.14 pool DIR
7.15 pool DIR
-------------
Визначає каталог об'єднання, де створюється
@ -1538,7 +1569,7 @@ smartctl. Поточні температури дисків відобража
Каталог повинен вже існувати.
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
Визначає шлях Windows UNC, необхідний для
@ -1559,7 +1590,7 @@ smartctl. Поточні температури дисків відобража
Ця опція потрібна лише для Windows.
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
Визначає користувацькі опції smartctl для
@ -1591,7 +1622,7 @@ PARITY — це одне з імен парності: `parity`,
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
Ігнорує вказаний атрибут SMART при обчисленні
@ -1615,7 +1646,7 @@ PARITY — це одне з імен парності: `parity`,
smartignore parity 197
7.18 Приклади
7.19 Приклади
-------------
Приклад типової конфігурації для Unix:
@ -1650,8 +1681,126 @@ PARITY — це одне з імен парності: `parity`,
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 Шаблон (PATTERN)
==================
8 SNAPSHOTS (Знімки)
====================
Якщо в конфігурації увімкнено опцію знімків, SnapRAID використовує
функціональність знімків файлової системи для забезпечення атомарності та
узгодженості операцій.
Керування знімками відбувається повністю автоматично та прозоро.
Ви можете продовжувати використовувати SnapRAID точно так само, як і раніше, отримуючи
додатковий захист, що забезпечується знімками, які повністю обробляються у
фоновому режимі.
Це дає дві основні переваги:
Узгодженість — Файли, змінені в живій файловій системі під час тривалого
процесу sync або scrub, не викликатимуть невідповідності парності або переривання
операцій, оскільки SnapRAID бачить заморожений знімок на момент часу.
Відновлення — Якщо файл оновлюється або видаляється з живої файлової системи,
він залишається збереженим у знімку. Якщо збій диска станеться
до запуску наступної синхронізації sync, SnapRAID використає дані, збережені
в знімку, для реконструкції диска, що зазнав збою.
У разі збою диска під час активного процесу sync,
SnapRAID також може автоматично читати як зі знімка попереднього
обчислення парності, так і з поточного.
Це максимізує ймовірність повного відновлення, надаючи
доступ до точних блоків даних, необхідних для вирішення рівнянь парності,
навіть якщо ці блоки були змінені або видалені між синхронізаціями.
Без знімків оновлений або видалений файл на справному диску
призводить до відсутності блоків даних, які можуть знадобитися для
відновлення інших дисків, що зазнали збою.
Знімки створюються лише для дисків із даними і лише в тому випадку, якщо базова
файлова система підтримує цю функціональність. Диски парності завжди використовують
живу файлову систему.
Наразі це підтримується на Btrfs, Bcachefs та ZFS в Linux
і на NTFS у Windows.
Ви можете комбінувати диски з даними з різними файловими системами. Тільки ті з них,
які підтримують знімки, використовуватимуть їх, тоді як інші диски продовжуватимуть
працювати безпосередньо з живою файловою системою.
Створення та видалення знімків вимагають прав адміністратора.
Переконайтеся, що SnapRAID запущено з необхідними привілеями (наприклад, sudo),
коли знімки увімкнено.
8.1 Поведінка команд із знімками
--------------------------------
Команди `sync` та `scrub` працюють виключно зі знімками,
щоб гарантувати, що всі операції з даними виконуються на узгодженому,
замороженому стані. Використовуючи ці знімки, SnapRAID запобігає невідповідності
парності, яка в іншому випадку була б викликана одночасними змінами файлів у живій файловій системі.
Під час `sync` команда використовує новий знімок, створений на початку
процесу, для фіксації поточного стану для обчислення парності.
Навпаки, команда `scrub` використовує останній знімок, створений під час
найостаннішої синхронізації, щоб підтримувати надійну точку відліку,
яка відповідає існуючій парності.
Для команд `check` та `fix` використання останнього знімка
залежить від того, чи націлені конкретні диски за допомогою опції
-d, --filter-disk.
Диск, явно вибраний за допомогою -d («ціль» операції),
завжди використовує живу файлову систему. Для `fix` це дозволяє відновити
дані на активну заміну диска. Для `check` це дозволяє симулювати
операцію `fix` за тих самих умов.
Доступ до всіх інших дисків із даними («довідкових» дисків) здійснюватиметься через
їхні знімки. Це гарантує, що навіть якщо ви змінюєте файли
на своїх справних дисках під час відновлення, SnapRAID
має стабільну, замороженну точку відліку для вирішення рівнянь парності.
Якщо опція -d не надана, SnapRAID припускає, що операція застосовується
до всього масиву; у цьому випадку `check` та `fix` використовуватимуть виключно
живі файлові системи.
Усі інші команди працюють виключно з живою файловою системою.
9 Життєвий цикл знімків
=======================
SnapRAID керує двома конкретними знімками, `stable` та `pending`,
всередині прихованого каталогу в корінному каталозі кожного підтому даних.
У Btrfs, Bcachefs та NTFS використовується каталог `.snapraid/`,
у ZFS — стандартний `.zfs/snapshot/`.
Знімок `stable` представляє стан останньої успішно
завершеної синхронізації `sync`, що містить точні дані, використані для
обчислення поточної парності. Він служить основним джерелом даних
для команд `scrub`, `check` та `fix`.
Знімок `pending` — це тимчасовий образ, що створюється на початку
`sync` для забезпечення замороженого стану для обчислення парності.
Після успішного завершення операції попередній знімок `stable`
видаляється, а знімок `pending` підвищується в статусі, щоб
зайняти його місце в якості нового стабільного орієнтира.
Якщо процес `sync` переривається, знімок `pending` зберігається.
Наступні команди `scrub`, `check` та `fix` використовуватимуть цей
очікуваний знімок, оскільки він відповідає стану файлової системи, записаному в
файлі .content, навіть якщо парність синхронізована лише частково.
У разі переривання `sync` команди `check` та `fix`
також читають дані зі знімка `stable` для вилучення блоків даних
із файлів, які були оновлені або видалені під час синхронізації.
Це можливо тому, що файл .content зберігає метадані для
усіх змінених або видалених файлів протягом усього процесу sync.
Ця історична інформація очищається лише після успішного завершення sync
і збереження фінальної версії файлу .content.
Якщо `sync` перезапускається після переривання, існуючий
очікуваний (pending) знімок видаляється, і створюється новий для
фіксації поточного стану живої файлової системи.
10 Шаблон (PATTERN)
===================
Шаблони забезпечують гнучкий спосіб фільтрації файлів для включення або
виключення. Використовуючи символи підстановки (globbing), ви можете визначити правила, які
@ -1785,8 +1934,8 @@ PARITY — це одне з імен парності: `parity`,
щоб запобігти їх розширенню оболонкою.
9 Ігнорування файлів (IGNORE FILE)
==================================
11 Ігнорування файлів (IGNORE FILE)
===================================
На додаток до глобальних правил у файлі конфігурації, ви можете розміщувати
файли `.snapraidignore` в будь-якому каталозі всередині масиву для визначення
@ -1830,7 +1979,7 @@ PARITY — це одне з імен парності: `parity`,
*.tmp
10 Вміст (CONTENT)
12 Вміст (CONTENT)
==================
SnapRAID зберігає список та контрольні суми
@ -1846,7 +1995,7 @@ SnapRAID зберігає список та контрольні суми
`check` та `status`.
11 Парність (PARITY)
13 Парність (PARITY)
====================
SnapRAID зберігає інформацію парності вашого
@ -1861,7 +2010,7 @@ SnapRAID зберігає інформацію парності вашого
`scrub` та `check`.
12 Кодування (ENCODING)
14 Кодування (ENCODING)
=======================
SnapRAID в Unix ігнорує будь-яке кодування.
@ -1885,13 +2034,13 @@ TrueType, такий як `Lucida Console`, як
буде у форматі UTF-8.
13 Авторське право (COPYRIGHT)
15 Авторське право (COPYRIGHT)
==============================
Цей файл захищений авторським правом (C) 2025 Andrea Mazzoleni
14 Див. також (SEE ALSO)
16 Див. також (SEE ALSO)
========================
snapraid_log(1), snapraidd(1)

View file

@ -109,19 +109,31 @@ https://www.snapraid.it/
.PD 0
.PD
.RE
.SH LIMITATIONS
SnapRAID 是 RAID 和备份程序之间的混合体,旨在结合两者的优点。
然而,在使用它之前,您应该考虑一些限制。
.SH 限制
SnapRAID 是 RAID 和备份程序之间的混合体,旨在结合两者的最佳优势。
但是,在使用它之前,您应该考虑它的一些限制。
.PP
主要的限制是,如果一个磁盘发生故障而您最近没有进行同步(sync),
您可能无法完全恢复。
更具体地说,您可能无法恢复自上次同步操作以来已更改或已删除文件的
大小所对应的部分。
即使更改或删除的文件不在发生故障的磁盘上,也会发生这种情况。
这就是为什么 SnapRAID 更适用于很少更改的数据。
主要的限制是,如果磁盘发生故障,您只能将数据恢复到上一次 \`sync\`(同步)操作的状态。
自上次同步以来添加的任何数据或进行的任何修改(如果位于发生故障的磁盘上)都将丢失。
.PP
另一方面,新添加的文件不会阻止对已有文件的恢复。
您只会丢失位于发生故障磁盘上的最近添加的文件。
因此,SnapRAID 主要适用于很少更改的数据。
.PP
对于上次同步时已经存在的数据,恢复的可靠性取决于是否使用了 \`snapshot\`(快照)选项:
.PD 0
.IP \(bu
具有快照支持(在 Btrfs、ZFS、Bcachefs 和 NTFS 上可用),
SnapRAID 可以自动维护数据磁盘的冻结引用。
这确保了即使您在同步期间或之后在活动文件系统上修改或删除文件,
恢复过程仍保持一致且可靠。
.PD
.PD 0
.IP \(bu
在没有快照支持的情况下,在 \`sync\` 之后删除或更改文件
可能会阻止其他损坏磁盘 food 完全恢复。发生这种情况
是因为校验数据不再与修改后的文件匹配,即使
这些文件不在损坏的磁盘上。另一方面,新添加的文件
不会阻止已存在文件的恢复。
.PD
.PP
SnapRAID 的其他限制包括:
.PD 0
@ -596,22 +608,22 @@ snapraid sync
.RE
.PP
如果所有内容都已恢复,此命令是即时的。
.SH COMMANDS
SnapRAID 提供了一些简单的命令,允许您:
.SH 命令
SnapRAID 提供了几个简单的命令,允许您:
.PD 0
.IP \(bu
打印阵列的状态 \-> \`status\`
.IP \(bu
控制磁盘 \-> \`smart\`、\`probe\`、\`up\`、\`down\`
.IP \(bu
进行备份/快照 \-> \`sync\`
创建备份/恢复点 \-> \`sync\`
.IP \(bu
定期检查数据 \-> \`scrub\`
.IP \(bu
恢复上次备份/快照 \-> \`fix\`。
恢复上一个备份/恢复点 \-> \`fix\`。
.PD
.PP
命令必须用小写字母书写。
命令必须用小写字母编写。
.SS status
打印磁盘阵列状态的摘要。
.PP
@ -809,14 +821,14 @@ full \- Scrub 所有内容。
\`parity\` 文件**不会**被修改。
阵列中的文件**不会**被修改。
.SS fix
修复所有文件和奇偶校验数据。
修复所有文件和校验数据。
.PP
所有文件和奇偶校验数据都与上次 \`sync\` 中保存的快照
状态进行比较。
如果发现差异,则将其恢复到存储的快照。
将所有文件和校验数据与上一次 \`sync\` 中保存的状态进行比较。
如果发现差异,则将其恢复到存储的状态。
.PP
**警告!** \`fix\` 命令不区分错误和
故意修改。它**无条件地**将文件状态恢复到上次 \`sync\`。
警告!
\`fix\` 命令不区分错误和故意修改。
它会无条件地将文件状态恢复到上一次 \`sync\` 的状态。
.PP
如果未指定其他选项,则处理整个阵列。
使用过滤选项选择要操作的文件或磁盘的子集。
@ -1282,6 +1294,24 @@ DIR 是磁盘在文件系统中的挂载点。
.PP
请注意,此类磁盘不受 \`up\` 和 \`down\` 命令的影响,因为它们被预期始终处于
旋转状态。
.SS snapshot
为 \`sync\`、\`scrub\`、\`check\` 和 \`fix\` 命令启用文件系统快照的使用。
.PP
启用后,SnapRAID 会在“sync”开始时创建数据的只读快照。
这确保 historical 了文件在特定时间点的一致视图,从而防止由并发文件修改引起的错误。
.PP
这显著提高了恢复能力:如果从实时文件系统中删除了一个文件,
它仍会保留在快照中。这可以防止该数据块的校验数据变得“损坏”,
从而确保在另一个磁盘发生故障时您仍能成功恢复数据。
.PP
此选项仅适用于在 Linux 中格式化为 Btrfs、Bcachefs 或 ZFS 文件系统,
以及在 Windows 中格式化为 NTFS 的数据磁盘。
校验磁盘或使用其他文件系统的数据磁盘将始终使用文件系统的活动版本。
.PP
快照的创建和删除需要管理权限。
启用此选项时,请确保以必要的权限(例如 sudo)运行 SnapRAID。
.PP
有关快照生命周期的详细说明,请参阅 SNAPSHOTS(快照)部分。
.SS nohidden
排除所有隐藏文件和目录。
在 Unix 中,隐藏文件是以 \`.\` 开头的文件。
@ -1597,6 +1627,102 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS (快照)
如果配置中启用了快照选项,SnapRAID 将
利用文件系统快照功能来确保原子操作和一致操作。
.PP
快照的管理是完全自动且透明的。
您可以完全像以前一样继续使用 SnapRAID,而快照提供的
额外保护完全在后台处理。
.PP
这提供了两个主要好处:
.RS 0
.PD 0
.HP 4
.I 一致性
在运行时间较长的 sync 或 scrub 期间在活动文件系统上修改的文件
不会导致校验不匹配或操作中止,因为 SnapRAID 看到的是一个冻结的时间点图像。
.HP 4
.I 恢复
如果从实时文件系统中更新或删除了一个文件,
它仍会保留在快照中。如果下次 sync 运行之前发生磁盘故障,
SnapRAID 会使用快照中保留的数据来重建发生故障的磁盘。
.PD
.PP
.RS 4
.PD 0
在活动同步过程中发生磁盘故障的情况下,
SnapRAID 还能自动从上一次校验计算的快照和当前的快照中读取数据。
这通过提供解校验方程所需的精确数据块访问,
最大程度地提高了完全恢复的概率,即使这些数据块在同步之间被修改或删除。
.PD
.PP
.PD 0
如果没有快照,健康磁盘上更新或删除的文件会导致缺少数据块,
而这些数据块可能是修复其他损坏磁盘所必需的。
.PD
.RE
.RE
.PP
快照仅为数据磁盘创建,并且仅在底层文件系统支持此功能时创建。
校验磁盘始终使用实时文件系统。
目前,Linux 上的 Btrfs、Bcachefs 和 ZFS 以及 Windows 上的 NTFS 支持此功能。
.PP
您可以混合使用具有不同文件系统的数据磁盘。只有那些
支持快照的磁盘才会利用它们,而其他磁盘将继续直接在实时文件系统上运行。
.PP
快照的创建和删除需要管理权限。
启用快照时,请确保以必要的权限(例如 sudo)运行 SnapRAID。
.SS 快照的命令行为
\`sync\` 和 \`scrub\` 命令都完全在快照上运行,
以确保所有数据操作都是针对一致的、冻结的状态进行的。通过利用这些快照,
SnapRAID 阻止了本由实时文件系统上的并发文件修改所触发的校验不匹配。
在 \`sync\` 期间,该命令使用在过程开始时创建的新快照来捕获用于校验计算的当前状态。
相比之下,\`scrub\` 命令利用上一个快照(即在最近一次同步期间创建的快照)
来维持与现有校验匹配的可靠参考点。
.PP
对于 \`check\` 和 \`fix\` 命令,上一个快照的使用
取决于是否使用 \-d, \-\-filter\-disk 选项指定了特定磁盘。
.PP
通过 \-d 明确选择的磁盘(操作的“目标”)始终使用实时文件系统。
对于 \`fix\`,这允许将数据恢复到活动的替代磁盘。对于 \`check\`,
它允许在相同条件下模拟 \`fix\` 操作。
.PP
所有其他数据磁盘(“参考”磁盘)都将通过其快照进行访问。
这确保 historical 了即使您在恢复进行时修改健康磁盘上的文件,
SnapRAID 也有一个稳定、冻结的参考来求解校验方程。
.PP
如果没有提供 \-d 选项,SnapRAID 会假设该操作适用于整个阵列,
在这种情况下,\`check\` 和 \`fix\` 将排他性地使用实时文件系统。
.PP
所有其他命令完全在实时文件系统上运行。
.SH 快照生命周期
SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定的快照:
\`stable\`(稳定)和 \`pending\`(待定)。
在 Btrfs、Bcachefs 和 NTFS 中使用 \`.snapraid/\` 目录,
在 ZFS 中使用标准的 \`.zfs/snapshot/\`。
.PP
\`stable\` 快照代表上一次成功完成的 \`sync\` 的状态,
包含用于计算当前校验的准确数据。它作为 \`scrub\`、\`check\`
和 \`fix\` 命令的主要数据源。
.PP
\`pending\` 快照是在 \`sync\` 开始时创建 interim 的临时图像,
用于为校验计算提供冻结状态。在操作成功完成后,
以前的 \`stable\` 快照将被删除,并且 \`pending\` 快照将被提升
以接替其作为新的稳定参考。
.PP
如果 \`sync\` 中断,\`pending\` 快照将被保留。
随后的 \`scrub\`、\`check\` 和 \`fix\` 命令将使用此待定快照,
因为它与 .content 文件中记录的文件系统状态相匹配,即使校验仅部分同步。
.PP
在 \`sync\` 中断的情况下,\`check\` 和 \`fix\` 命令
还会从 \`stable\` 快照中读取数据,以检索在同步期间更新或删除的文件的
数据块。这是可能的,因为 .content 文件在整个同步过程中保留了
所有修改或删除的文件的元数据。此历史信息仅在同步
成功完成并保存 .content 文件的最终版本后才会清除。
.PP
如果 \`sync\` 在中断后重新启动,现有的 pending 快照将被删除,
并创建一个新快照以捕获实时文件系统的当前状态。
.SH PATTERN
模式提供了一种灵活的方法来过滤要包含或排除的文件。通过使用通配符(globbing),
您可以定义匹配特定文件名或整个目录结构的规则,而无需手动列出每个路径。

View file

@ -43,19 +43,27 @@ Description
:https://www.snapraid.it/
Limitations
SnapRAID 是 RAID 和备份程序之间的混合体,旨在结合两者的优点。
然而,在使用它之前,您应该考虑一些限制。
限制
SnapRAID 是 RAID 和备份程序之间的混合体,旨在结合两者的最佳优势。
但是,在使用它之前,您应该考虑它的一些限制。
主要的限制是,如果一个磁盘发生故障而您最近没有进行同步(sync),
您可能无法完全恢复。
更具体地说,您可能无法恢复自上次同步操作以来已更改或已删除文件的
大小所对应的部分。
即使更改或删除的文件不在发生故障的磁盘上,也会发生这种情况。
这就是为什么 SnapRAID 更适用于很少更改的数据。
主要的限制是,如果磁盘发生故障,您只能将数据恢复到上一次 `sync`(同步)操作的状态。
自上次同步以来添加的任何数据或进行的任何修改(如果位于发生故障的磁盘上)都将丢失。
另一方面,新添加的文件不会阻止对已有文件的恢复。
您只会丢失位于发生故障磁盘上的最近添加的文件。
因此,SnapRAID 主要适用于很少更改的数据。
对于上次同步时已经存在的数据,恢复的可靠性取决于是否使用了 `snapshot`(快照)选项:
* 具有快照支持(在 Btrfs、ZFS、Bcachefs 和 NTFS 上可用),
SnapRAID 可以自动维护数据磁盘的冻结引用。
这确保了即使您在同步期间或之后在活动文件系统上修改或删除文件,
恢复过程仍保持一致且可靠。
* 在没有快照支持的情况下,在 `sync` 之后删除或更改文件
可能会阻止其他损坏磁盘 food 完全恢复。发生这种情况
是因为校验数据不再与修改后的文件匹配,即使
这些文件不在损坏的磁盘上。另一方面,新添加的文件
不会阻止已存在文件的恢复。
SnapRAID 的其他限制包括:
@ -336,16 +344,16 @@ Getting Started
如果所有内容都已恢复,此命令是即时的。
Commands
SnapRAID 提供了一些简单的命令,允许您:
命令
SnapRAID 提供了几个简单的命令,允许您:
* 打印阵列的状态 -> `status`
* 控制磁盘 -> `smart`、`probe`、`up`、`down`
* 进行备份/快照 -> `sync`
* 创建备份/恢复点 -> `sync`
* 定期检查数据 -> `scrub`
* 恢复上次备份/快照 -> `fix`。
* 恢复上一个备份/恢复点 -> `fix`。
命令必须用小写字母书写。
命令必须用小写字母编写。
status
打印磁盘阵列状态的摘要。
@ -518,14 +526,14 @@ Commands
阵列中的文件**不会**被修改。
fix
修复所有文件和奇偶校验数据。
修复所有文件和校验数据。
所有文件和奇偶校验数据都与上次 `sync` 中保存的快照
状态进行比较。
如果发现差异,则将其恢复到存储的快照。
将所有文件和校验数据与上一次 `sync` 中保存的状态进行比较。
如果发现差异,则将其恢复到存储的状态。
**警告!** `fix` 命令不区分错误和
故意修改。它**无条件地**将文件状态恢复到上次 `sync`。
警告!
`fix` 命令不区分错误和故意修改。
它会无条件地将文件状态恢复到上一次 `sync` 的状态。
如果未指定其他选项,则处理整个阵列。
使用过滤选项选择要操作的文件或磁盘的子集。
@ -1002,6 +1010,25 @@ Configuration
请注意,此类磁盘不受 `up` 和 `down` 命令的影响,因为它们被预期始终处于
旋转状态。
snapshot
为 `sync`、`scrub`、`check` 和 `fix` 命令启用文件系统快照的使用。
启用后,SnapRAID 会在“sync”开始时创建数据的只读快照。
这确保 historical 了文件在特定时间点的一致视图,从而防止由并发文件修改引起的错误。
这显著提高了恢复能力:如果从实时文件系统中删除了一个文件,
它仍会保留在快照中。这可以防止该数据块的校验数据变得“损坏”,
从而确保在另一个磁盘发生故障时您仍能成功恢复数据。
此选项仅适用于在 Linux 中格式化为 Btrfs、Bcachefs 或 ZFS 文件系统,
以及在 Windows 中格式化为 NTFS 的数据磁盘。
校验磁盘或使用其他文件系统的数据磁盘将始终使用文件系统的活动版本。
快照的创建和删除需要管理权限。
启用此选项时,请确保以必要的权限(例如 sudo)运行 SnapRAID。
有关快照生命周期的详细说明,请参阅 SNAPSHOTS(快照)部分。
nohidden
排除所有隐藏文件和目录。
在 Unix 中,隐藏文件是以 `.` 开头的文件。
@ -1221,6 +1248,92 @@ Configuration
:smartctl parity -d areca,1/1 /dev/arcmsr0
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Snapshots (快照)
如果配置中启用了快照选项,SnapRAID 将
利用文件系统快照功能来确保原子操作和一致操作。
快照的管理是完全自动且透明的。
您可以完全像以前一样继续使用 SnapRAID,而快照提供的
额外保护完全在后台处理。
这提供了两个主要好处:
一致性 - 在运行时间较长的 sync 或 scrub 期间在活动文件系统上修改的文件
不会导致校验不匹配或操作中止,因为 SnapRAID 看到的是一个冻结的时间点图像。
恢复 - 如果从实时文件系统中更新或删除了一个文件,
它仍会保留在快照中。如果下次 sync 运行之前发生磁盘故障,
SnapRAID 会使用快照中保留的数据来重建发生故障的磁盘。
在活动同步过程中发生磁盘故障的情况下,
SnapRAID 还能自动从上一次校验计算的快照和当前的快照中读取数据。
这通过提供解校验方程所需的精确数据块访问,
最大程度地提高了完全恢复的概率,即使这些数据块在同步之间被修改或删除。
如果没有快照,健康磁盘上更新或删除的文件会导致缺少数据块,
而这些数据块可能是修复其他损坏磁盘所必需的。
快照仅为数据磁盘创建,并且仅在底层文件系统支持此功能时创建。
校验磁盘始终使用实时文件系统。
目前,Linux 上的 Btrfs、Bcachefs 和 ZFS 以及 Windows 上的 NTFS 支持此功能。
您可以混合使用具有不同文件系统的数据磁盘。只有那些
支持快照的磁盘才会利用它们,而其他磁盘将继续直接在实时文件系统上运行。
快照的创建和删除需要管理权限。
启用快照时,请确保以必要的权限(例如 sudo)运行 SnapRAID。
快照的命令行为
`sync` 和 `scrub` 命令都完全在快照上运行,
以确保所有数据操作都是针对一致的、冻结的状态进行的。通过利用这些快照,
SnapRAID 阻止了本由实时文件系统上的并发文件修改所触发的校验不匹配。
在 `sync` 期间,该命令使用在过程开始时创建的新快照来捕获用于校验计算的当前状态。
相比之下,`scrub` 命令利用上一个快照(即在最近一次同步期间创建的快照)
来维持与现有校验匹配的可靠参考点。
对于 `check` 和 `fix` 命令,上一个快照的使用
取决于是否使用 -d, --filter-disk 选项指定了特定磁盘。
通过 -d 明确选择的磁盘(操作的“目标”)始终使用实时文件系统。
对于 `fix`,这允许将数据恢复到活动的替代磁盘。对于 `check`,
它允许在相同条件下模拟 `fix` 操作。
所有其他数据磁盘(“参考”磁盘)都将通过其快照进行访问。
这确保 historical 了即使您在恢复进行时修改健康磁盘上的文件,
SnapRAID 也有一个稳定、冻结的参考来求解校验方程。
如果没有提供 -d 选项,SnapRAID 会假设该操作适用于整个阵列,
在这种情况下,`check` 和 `fix` 将排他性地使用实时文件系统。
所有其他命令完全在实时文件系统上运行。
快照生命周期
SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定的快照:
`stable`(稳定)和 `pending`(待定)。
在 Btrfs、Bcachefs 和 NTFS 中使用 `.snapraid/` 目录,
在 ZFS 中使用标准的 `.zfs/snapshot/`。
`stable` 快照代表上一次成功完成的 `sync` 的状态,
包含用于计算当前校验的准确数据。它作为 `scrub`、`check`
和 `fix` 命令的主要数据源。
`pending` 快照是在 `sync` 开始时创建 interim 的临时图像,
用于为校验计算提供冻结状态。在操作成功完成后,
以前的 `stable` 快照将被删除,并且 `pending` 快照将被提升
以接替其作为新的稳定参考。
如果 `sync` 中断,`pending` 快照将被保留。
随后的 `scrub`、`check` 和 `fix` 命令将使用此待定快照,
因为它与 .content 文件中记录的文件系统状态相匹配,即使校验仅部分同步。
在 `sync` 中断的情况下,`check` 和 `fix` 命令
还会从 `stable` 快照中读取数据,以检索在同步期间更新或删除的文件的
数据块。这是可能的,因为 .content 文件在整个同步过程中保留了
所有修改或删除的文件的元数据。此历史信息仅在同步
成功完成并保存 .content 文件的最终版本后才会清除。
如果 `sync` 在中断后重新启动,现有的 pending 快照将被删除,
并创建一个新快照以捕获实时文件系统的当前状态。
Pattern
模式提供了一种灵活的方法来过滤要包含或排除的文件。通过使用通配符(globbing),
您可以定义匹配特定文件名或整个目录结构的规则,而无需手动列出每个路径。

View file

@ -51,21 +51,29 @@ SnapRAID 主要面向拥有大型、不常更改文件的家庭媒体中心,
https://www.snapraid.it/
3 LIMITATIONS
=============
3 限制
====
SnapRAID 是 RAID 和备份程序之间的混合体,旨在结合两者的优点。
然而,在使用它之前,您应该考虑一些限制。
SnapRAID 是 RAID 和备份程序之间的混合体,旨在结合两者的最佳优势。
但是,在使用它之前,您应该考虑它的一些限制。
主要的限制是,如果一个磁盘发生故障而您最近没有进行同步(sync),
您可能无法完全恢复。
更具体地说,您可能无法恢复自上次同步操作以来已更改或已删除文件的
大小所对应的部分。
即使更改或删除的文件不在发生故障的磁盘上,也会发生这种情况。
这就是为什么 SnapRAID 更适用于很少更改的数据。
主要的限制是,如果磁盘发生故障,您只能将数据恢复到上一次 `sync`(同步)操作的状态。
自上次同步以来添加的任何数据或进行的任何修改(如果位于发生故障的磁盘上)都将丢失。
另一方面,新添加的文件不会阻止对已有文件的恢复。
您只会丢失位于发生故障磁盘上的最近添加的文件。
因此,SnapRAID 主要适用于很少更改的数据。
对于上次同步时已经存在的数据,恢复的可靠性取决于是否使用了 `snapshot`(快照)选项:
* 具有快照支持(在 Btrfs、ZFS、Bcachefs 和 NTFS 上可用),
SnapRAID 可以自动维护数据磁盘的冻结引用。
这确保了即使您在同步期间或之后在活动文件系统上修改或删除文件,
恢复过程仍保持一致且可靠。
* 在没有快照支持的情况下,在 `sync` 之后删除或更改文件
可能会阻止其他损坏磁盘 food 完全恢复。发生这种情况
是因为校验数据不再与修改后的文件匹配,即使
这些文件不在损坏的磁盘上。另一方面,新添加的文件
不会阻止已存在文件的恢复。
SnapRAID 的其他限制包括:
@ -358,18 +366,18 @@ SnapRAID 的功能更像一个备份程序而不是 RAID 系统,
如果所有内容都已恢复,此命令是即时的。
5 COMMANDS
==========
5 命令
====
SnapRAID 提供了一些简单的命令,允许您:
SnapRAID 提供了几个简单的命令,允许您:
* 打印阵列的状态 -> `status`
* 控制磁盘 -> `smart`、`probe`、`up`、`down`
* 进行备份/快照 -> `sync`
* 创建备份/恢复点 -> `sync`
* 定期检查数据 -> `scrub`
* 恢复上次备份/快照 -> `fix`。
* 恢复上一个备份/恢复点 -> `fix`。
命令必须用小写字母书写。
命令必须用小写字母编写。
5.1 status
----------
@ -560,14 +568,14 @@ full - Scrub 所有内容。
5.9 fix
-------
修复所有文件和奇偶校验数据。
修复所有文件和校验数据。
所有文件和奇偶校验数据都与上次 `sync` 中保存的快照
状态进行比较。
如果发现差异,则将其恢复到存储的快照。
将所有文件和校验数据与上一次 `sync` 中保存的状态进行比较。
如果发现差异,则将其恢复到存储的状态。
**警告!** `fix` 命令不区分错误和
故意修改。它**无条件地**将文件状态恢复到上次 `sync`。
警告!
`fix` 命令不区分错误和故意修改。
它会无条件地将文件状态恢复到上一次 `sync` 的状态。
如果未指定其他选项,则处理整个阵列。
使用过滤选项选择要操作的文件或磁盘的子集。
@ -1078,14 +1086,35 @@ DIR 是磁盘在文件系统中的挂载点。
请注意,此类磁盘不受 `up` 和 `down` 命令的影响,因为它们被预期始终处于
旋转状态。
7.7 nohidden
7.7 snapshot
------------
为 `sync`、`scrub`、`check` 和 `fix` 命令启用文件系统快照的使用。
启用后,SnapRAID 会在“sync”开始时创建数据的只读快照。
这确保 historical 了文件在特定时间点的一致视图,从而防止由并发文件修改引起的错误。
这显著提高了恢复能力:如果从实时文件系统中删除了一个文件,
它仍会保留在快照中。这可以防止该数据块的校验数据变得“损坏”,
从而确保在另一个磁盘发生故障时您仍能成功恢复数据。
此选项仅适用于在 Linux 中格式化为 Btrfs、Bcachefs 或 ZFS 文件系统,
以及在 Windows 中格式化为 NTFS 的数据磁盘。
校验磁盘或使用其他文件系统的数据磁盘将始终使用文件系统的活动版本。
快照的创建和删除需要管理权限。
启用此选项时,请确保以必要的权限(例如 sudo)运行 SnapRAID。
有关快照生命周期的详细说明,请参阅 SNAPSHOTS(快照)部分。
7.8 nohidden
------------
排除所有隐藏文件和目录。
在 Unix 中,隐藏文件是以 `.` 开头的文件。
在 Windows 中,它们是具有隐藏属性的文件。
7.8 exclude/include PATTERN
7.9 exclude/include PATTERN
---------------------------
定义要从同步过程中排除或包含的文件或目录模式。
@ -1100,8 +1129,8 @@ DIR 是磁盘在文件系统中的挂载点。
此选项可以多次使用。
7.9 blocksize SIZE_IN_KIBIBYTES
-------------------------------
7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------
定义奇偶校验的基本块大小(以 KiB 为单位)。
一 KiB 是 1024 字节。
@ -1144,7 +1173,7 @@ DIR 是磁盘在文件系统中的挂载点。
这会导致大约 1.5% 的额外空间,对于 4 TB 磁盘约为 60 GB,
这允许每个数据磁盘上大约 460,000 个文件而不会浪费任何空间。
7.10 hashsize SIZE_IN_BYTES
7.11 hashsize SIZE_IN_BYTES
---------------------------
定义保存块的散列大小(以字节为单位)。
@ -1179,14 +1208,14 @@ RAM = $(8 * 4 * 10^{12}) * (1+16) / (512 * 2^{10}) = 0.96$ GiB
RAM = $(8 * 4 * 10^{12}) * (1+8) / (512 * 2^{10}) = 0.51$ GiB
7.11 autosave SIZE_IN_GIGABYTES
7.12 autosave SIZE_IN_GIGABYTES
-------------------------------
在同步或 scrub 之后,处理指定数量的 GB 后,自动保存状态。
此选项有助于避免在机器崩溃或任何其他事件中断时,
从头开始重新启动长时间的 `sync` 命令。
7.12 temp_limit TEMPERATURE_CELSIUS
7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------
设置允许的最高磁盘温度(摄氏度)。指定后,
@ -1214,13 +1243,13 @@ SnapRAID 运行时会显示当前磁盘温度。
通常,SnapRAID 只显示最热磁盘的温度。
要显示所有磁盘的温度,请使用 -A 或 --stats 选项。
7.13 temp_sleep TIME_IN_MINUTES
7.14 temp_sleep TIME_IN_MINUTES
-------------------------------
设置达到温度限制时的待机时间(以分钟为单位)。
在此期间,磁盘保持停转状态。默认值为 5 分钟。
7.14 pool DIR
7.15 pool DIR
-------------
定义 `pooling` 目录,其中使用 `pool` 命令创建磁盘
@ -1228,7 +1257,7 @@ SnapRAID 运行时会显示当前磁盘温度。
目录必须已经存在。
7.15 share UNC_DIR
7.16 share UNC_DIR
------------------
定义远程访问磁盘所需的 Windows UNC 路径。
@ -1243,7 +1272,7 @@ SnapRAID 运行时会显示当前磁盘温度。
此选项仅在 Windows 中需要。
7.16 smartctl DISK/PARITY OPTIONS...
7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------
定义自定义 smartctl 选项以获取每个磁盘的 SMART 属性。
@ -1268,7 +1297,7 @@ PARITY 是奇偶校验名称之一:`parity`、`2-parity`、`3-parity`、
smartctl parity -d sat %s
7.17 smartignore DISK/PARITY ATTR [ATTR...]
7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------
在计算磁盘故障概率时忽略指定的 SMART 属性。
@ -1287,7 +1316,7 @@ PARITY 是奇偶校验名称之一:`parity`、`2-parity`、`3-parity`、
smartignore parity 197
7.18 Examples
7.19 Examples
-------------
Unix 的典型配置示例如下:
@ -1322,8 +1351,102 @@ Windows 的典型配置示例如下:
smartctl 2-parity -d areca,2/1 /dev/arcmsr0
8 PATTERN
=========
8 SNAPSHOTS (快照)
================
如果配置中启用了快照选项,SnapRAID 将
利用文件系统快照功能来确保原子操作和一致操作。
快照的管理是完全自动且透明的。
您可以完全像以前一样继续使用 SnapRAID,而快照提供的
额外保护完全在后台处理。
这提供了两个主要好处:
一致性 - 在运行时间较长的 sync 或 scrub 期间在活动文件系统上修改的文件
不会导致校验不匹配或操作中止,因为 SnapRAID 看到的是一个冻结的时间点图像。
恢复 - 如果从实时文件系统中更新或删除了一个文件,
它仍会保留在快照中。如果下次 sync 运行之前发生磁盘故障,
SnapRAID 会使用快照中保留的数据来重建发生故障的磁盘。
在活动同步过程中发生磁盘故障的情况下,
SnapRAID 还能自动从上一次校验计算的快照和当前的快照中读取数据。
这通过提供解校验方程所需的精确数据块访问,
最大程度地提高了完全恢复的概率,即使这些数据块在同步之间被修改或删除。
如果没有快照,健康磁盘上更新或删除的文件会导致缺少数据块,
而这些数据块可能是修复其他损坏磁盘所必需的。
快照仅为数据磁盘创建,并且仅在底层文件系统支持此功能时创建。
校验磁盘始终使用实时文件系统。
目前,Linux 上的 Btrfs、Bcachefs 和 ZFS 以及 Windows 上的 NTFS 支持此功能。
您可以混合使用具有不同文件系统的数据磁盘。只有那些
支持快照的磁盘才会利用它们,而其他磁盘将继续直接在实时文件系统上运行。
快照的创建和删除需要管理权限。
启用快照时,请确保以必要的权限(例如 sudo)运行 SnapRAID。
8.1 快照的命令行为
-----------
`sync` 和 `scrub` 命令都完全在快照上运行,
以确保所有数据操作都是针对一致的、冻结的状态进行的。通过利用这些快照,
SnapRAID 阻止了本由实时文件系统上的并发文件修改所触发的校验不匹配。
在 `sync` 期间,该命令使用在过程开始时创建的新快照来捕获用于校验计算的当前状态。
相比之下,`scrub` 命令利用上一个快照(即在最近一次同步期间创建的快照)
来维持与现有校验匹配的可靠参考点。
对于 `check` 和 `fix` 命令,上一个快照的使用
取决于是否使用 -d, --filter-disk 选项指定了特定磁盘。
通过 -d 明确选择的磁盘(操作的“目标”)始终使用实时文件系统。
对于 `fix`,这允许将数据恢复到活动的替代磁盘。对于 `check`,
它允许在相同条件下模拟 `fix` 操作。
所有其他数据磁盘(“参考”磁盘)都将通过其快照进行访问。
这确保 historical 了即使您在恢复进行时修改健康磁盘上的文件,
SnapRAID 也有一个稳定、冻结的参考来求解校验方程。
如果没有提供 -d 选项,SnapRAID 会假设该操作适用于整个阵列,
在这种情况下,`check` 和 `fix` 将排他性地使用实时文件系统。
所有其他命令完全在实时文件系统上运行。
9 快照生命周期
========
SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定的快照:
`stable`(稳定)和 `pending`(待定)。
在 Btrfs、Bcachefs 和 NTFS 中使用 `.snapraid/` 目录,
在 ZFS 中使用标准的 `.zfs/snapshot/`。
`stable` 快照代表上一次成功完成的 `sync` 的状态,
包含用于计算当前校验的准确数据。它作为 `scrub`、`check`
和 `fix` 命令的主要数据源。
`pending` 快照是在 `sync` 开始时创建 interim 的临时图像,
用于为校验计算提供冻结状态。在操作成功完成后,
以前的 `stable` 快照将被删除,并且 `pending` 快照将被提升
以接替其作为新的稳定参考。
如果 `sync` 中断,`pending` 快照将被保留。
随后的 `scrub`、`check` 和 `fix` 命令将使用此待定快照,
因为它与 .content 文件中记录的文件系统状态相匹配,即使校验仅部分同步。
在 `sync` 中断的情况下,`check` 和 `fix` 命令
还会从 `stable` 快照中读取数据,以检索在同步期间更新或删除的文件的
数据块。这是可能的,因为 .content 文件在整个同步过程中保留了
所有修改或删除的文件的元数据。此历史信息仅在同步
成功完成并保存 .content 文件的最终版本后才会清除。
如果 `sync` 在中断后重新启动,现有的 pending 快照将被删除,
并创建一个新快照以捕获实时文件系统的当前状态。
10 PATTERN
==========
模式提供了一种灵活的方法来过滤要包含或排除的文件。通过使用通配符(globbing),
您可以定义匹配特定文件名或整个目录结构的规则,而无需手动列出每个路径。
@ -1427,8 +1550,8 @@ globbing 字符。在 Unix 中,转义字符是 `\`;在 Windows 中,它是
引用它们以防止 shell 扩展它们。
9 IGNORE FILE
=============
11 IGNORE FILE
==============
除了配置文件中的全局规则外,您还可以在阵列内的任何目录中放置
`.snapraidignore` 文件,以定义分散的排除规则。
@ -1468,7 +1591,7 @@ globbing 字符。在 Unix 中,转义字符是 `\`;在 Windows 中,它是
*.tmp
10 CONTENT
12 CONTENT
==========
SnapRAID 将文件列表和校验和存储在 content 文件中。
@ -1480,7 +1603,7 @@ SnapRAID 将文件列表和校验和存储在 content 文件中。
`fix`、`check` 和 `status` 命令读取。
11 PARITY
13 PARITY
=========
SnapRAID 将阵列的奇偶校验信息存储在 parity 文件中。
@ -1492,7 +1615,7 @@ SnapRAID 将阵列的奇偶校验信息存储在 parity 文件中。
并且仅由 `scrub` 和 `check` 命令读取。
12 ENCODING
14 ENCODING
===========
SnapRAID 在 Unix 中忽略任何编码。它读取并存储
@ -1508,13 +1631,13 @@ SnapRAID 在 Unix 中忽略任何编码。它读取并存储
采用 UTF-8 格式。
13 COPYRIGHT
15 COPYRIGHT
============
此文件版权所有 (C) 2025 Andrea Mazzoleni
14 SEE ALSO
16 SEE ALSO
===========
snapraid_log(1), snapraidd(1)

View file

@ -125,6 +125,7 @@ consider before using it.
The main limitation is that if a disk fails, you can only recover data up to
the state of the last \`sync\` operation. Any data added or modifications made
since the last sync that are located on the failed disk will be lost.
.PP
Consequently, SnapRAID is primarily suited for data that rarely changes.
.PP
For data that already existed at the last sync, recovery reliability depends

View file

@ -59,6 +59,7 @@ Limitations
The main limitation is that if a disk fails, you can only recover data up to
the state of the last `sync` operation. Any data added or modifications made
since the last sync that are located on the failed disk will be lost.
Consequently, SnapRAID is primarily suited for data that rarely changes.
For data that already existed at the last sync, recovery reliability depends

View file

@ -69,6 +69,7 @@ consider before using it.
The main limitation is that if a disk fails, you can only recover data up to
the state of the last `sync` operation. Any data added or modifications made
since the last sync that are located on the failed disk will be lost.
Consequently, SnapRAID is primarily suited for data that rarely changes.
For data that already existed at the last sync, recovery reliability depends