From 1929b0b6b0b9ecff2453718a35c5908916fc3396 Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Mon, 8 Jun 2026 18:26:17 +0200 Subject: [PATCH] Update translations --- doc/snapraid-de.1 | 202 ++++++++++++++++++++++++++++++----- doc/snapraid-de.d | 189 ++++++++++++++++++++++++++++----- doc/snapraid-de.txt | 247 ++++++++++++++++++++++++++++++++++--------- doc/snapraid-es.1 | 207 +++++++++++++++++++++++++++++++----- doc/snapraid-es.d | 194 +++++++++++++++++++++++++++++----- doc/snapraid-es.txt | 250 ++++++++++++++++++++++++++++++++++--------- doc/snapraid-fr.1 | 205 ++++++++++++++++++++++++++++++----- doc/snapraid-fr.d | 192 ++++++++++++++++++++++++++++----- doc/snapraid-fr.txt | 246 +++++++++++++++++++++++++++++++++--------- doc/snapraid-it.1 | 204 ++++++++++++++++++++++++++++++----- doc/snapraid-it.d | 191 ++++++++++++++++++++++++++++----- doc/snapraid-it.txt | 245 +++++++++++++++++++++++++++++++++--------- doc/snapraid-ja.1 | 180 ++++++++++++++++++++++++++----- doc/snapraid-ja.d | 167 ++++++++++++++++++++++++----- doc/snapraid-ja.txt | 225 ++++++++++++++++++++++++++++++--------- doc/snapraid-ko.1 | 180 ++++++++++++++++++++++++++----- doc/snapraid-ko.d | 167 ++++++++++++++++++++++++----- doc/snapraid-ko.txt | 225 ++++++++++++++++++++++++++++++--------- doc/snapraid-pl.1 | 207 +++++++++++++++++++++++++++++++----- doc/snapraid-pl.d | 194 +++++++++++++++++++++++++++++----- doc/snapraid-pl.txt | 252 +++++++++++++++++++++++++++++++++++--------- doc/snapraid-pt.1 | 204 ++++++++++++++++++++++++++++++----- doc/snapraid-pt.d | 191 ++++++++++++++++++++++++++++----- doc/snapraid-pt.txt | 245 ++++++++++++++++++++++++++++++++++-------- doc/snapraid-ro.1 | 198 ++++++++++++++++++++++++++++++---- doc/snapraid-ro.d | 185 ++++++++++++++++++++++++++++---- doc/snapraid-ro.txt | 239 +++++++++++++++++++++++++++++++++-------- doc/snapraid-ru.1 | 204 ++++++++++++++++++++++++++++++----- doc/snapraid-ru.d | 193 ++++++++++++++++++++++++++++----- doc/snapraid-ru.txt | 249 ++++++++++++++++++++++++++++++++++--------- doc/snapraid-sv.1 | 203 ++++++++++++++++++++++++++++++----- doc/snapraid-sv.d | 190 ++++++++++++++++++++++++++++----- doc/snapraid-sv.txt | 244 +++++++++++++++++++++++++++++++++--------- doc/snapraid-uk.1 | 200 ++++++++++++++++++++++++++++++----- doc/snapraid-uk.d | 189 ++++++++++++++++++++++++++++----- doc/snapraid-uk.txt | 243 +++++++++++++++++++++++++++++++++--------- doc/snapraid-zh.1 | 170 ++++++++++++++++++++++++++---- doc/snapraid-zh.d | 157 +++++++++++++++++++++++---- doc/snapraid-zh.txt | 215 +++++++++++++++++++++++++++++-------- doc/snapraid.1 | 1 + doc/snapraid.d | 1 + doc/snapraid.txt | 1 + 42 files changed, 6830 insertions(+), 1261 deletions(-) diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1 index 172c8e7f..fb2b2613 100644 --- a/doc/snapraid-de.1 +++ b/doc/snapraid-de.1 @@ -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, diff --git a/doc/snapraid-de.d b/doc/snapraid-de.d index 14b08e76..4fac8c96 100644 --- a/doc/snapraid-de.d +++ b/doc/snapraid-de.d @@ -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, diff --git a/doc/snapraid-de.txt b/doc/snapraid-de.txt index 25760f43..fcb1e557 100644 --- a/doc/snapraid-de.txt +++ b/doc/snapraid-de.txt @@ -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) diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1 index 624906fb..e7f4347d 100644 --- a/doc/snapraid-es.1 +++ b/doc/snapraid-es.1 @@ -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 diff --git a/doc/snapraid-es.d b/doc/snapraid-es.d index 4163909f..b791952e 100644 --- a/doc/snapraid-es.d +++ b/doc/snapraid-es.d @@ -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 diff --git a/doc/snapraid-es.txt b/doc/snapraid-es.txt index 96c192e5..f6fa555b 100644 --- a/doc/snapraid-es.txt +++ b/doc/snapraid-es.txt @@ -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) diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1 index d678bc86..23ee4d4f 100644 --- a/doc/snapraid-fr.1 +++ b/doc/snapraid-fr.1 @@ -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 diff --git a/doc/snapraid-fr.d b/doc/snapraid-fr.d index 6fd2def6..d7165e8e 100644 --- a/doc/snapraid-fr.d +++ b/doc/snapraid-fr.d @@ -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 diff --git a/doc/snapraid-fr.txt b/doc/snapraid-fr.txt index 28b6589a..d8b4a67d 100644 --- a/doc/snapraid-fr.txt +++ b/doc/snapraid-fr.txt @@ -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) diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1 index 6f5d55e5..88e8262c 100644 --- a/doc/snapraid-it.1 +++ b/doc/snapraid-it.1 @@ -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 diff --git a/doc/snapraid-it.d b/doc/snapraid-it.d index 3f9c3a6b..553f69c3 100644 --- a/doc/snapraid-it.d +++ b/doc/snapraid-it.d @@ -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 diff --git a/doc/snapraid-it.txt b/doc/snapraid-it.txt index 65ff4607..efd76cab 100644 --- a/doc/snapraid-it.txt +++ b/doc/snapraid-it.txt @@ -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) diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1 index cbc02b92..9bfc81dd 100644 --- a/doc/snapraid-ja.1 +++ b/doc/snapraid-ja.1 @@ -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 パターンは、含めるファイルまたは除外するファイルをフィルタリングするための柔軟な方法を 提供します。グロブ文字を使用することで、すべてのパスを手動でリストすることなく、 diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d index 8ff14b09..87ae0674 100644 --- a/doc/snapraid-ja.d +++ b/doc/snapraid-ja.d @@ -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 パターンは、含めるファイルまたは除外するファイルをフィルタリングするための柔軟な方法を 提供します。グロブ文字を使用することで、すべてのパスを手動でリストすることなく、 diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt index 9a241079..8bf6eeb9 100644 --- a/doc/snapraid-ja.txt +++ b/doc/snapraid-ja.txt @@ -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) diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1 index 2270a094..ba02c4f8 100644 --- a/doc/snapraid-ko.1 +++ b/doc/snapraid-ko.1 @@ -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) 문자를 사용하면 모든 경로를 일일이 나열하지 않고도 diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d index ecf1fe4b..77975251 100644 --- a/doc/snapraid-ko.d +++ b/doc/snapraid-ko.d @@ -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) 문자를 사용하면 모든 경로를 일일이 나열하지 않고도 diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt index fa9782ff..489bc7fb 100644 --- a/doc/snapraid-ko.txt +++ b/doc/snapraid-ko.txt @@ -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) diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1 index ecee2dbf..f064534c 100644 --- a/doc/snapraid-pl.1 +++ b/doc/snapraid-pl.1 @@ -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 diff --git a/doc/snapraid-pl.d b/doc/snapraid-pl.d index 9869d803..e2b9a57e 100644 --- a/doc/snapraid-pl.d +++ b/doc/snapraid-pl.d @@ -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 diff --git a/doc/snapraid-pl.txt b/doc/snapraid-pl.txt index a603ea0e..4e7a18c3 100644 --- a/doc/snapraid-pl.txt +++ b/doc/snapraid-pl.txt @@ -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) diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1 index 2a3e8c3c..0a877236 100644 --- a/doc/snapraid-pt.1 +++ b/doc/snapraid-pt.1 @@ -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 diff --git a/doc/snapraid-pt.d b/doc/snapraid-pt.d index 913bbd11..7f5e0a98 100644 --- a/doc/snapraid-pt.d +++ b/doc/snapraid-pt.d @@ -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 diff --git a/doc/snapraid-pt.txt b/doc/snapraid-pt.txt index 67c4c6b6..1dc6efa5 100644 --- a/doc/snapraid-pt.txt +++ b/doc/snapraid-pt.txt @@ -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) diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1 index 35f5ce9d..3145a3fa 100644 --- a/doc/snapraid-ro.1 +++ b/doc/snapraid-ro.1 @@ -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ă diff --git a/doc/snapraid-ro.d b/doc/snapraid-ro.d index 66181ed0..7ed90352 100644 --- a/doc/snapraid-ro.d +++ b/doc/snapraid-ro.d @@ -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ă diff --git a/doc/snapraid-ro.txt b/doc/snapraid-ro.txt index b1650c33..8d514d79 100644 --- a/doc/snapraid-ro.txt +++ b/doc/snapraid-ro.txt @@ -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) diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1 index bcec7a3f..9165cbb8 100644 --- a/doc/snapraid-ru.1 +++ b/doc/snapraid-ru.1 @@ -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), вы можете определить правила, diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d index 36bcb6d3..08fd21b4 100644 --- a/doc/snapraid-ru.d +++ b/doc/snapraid-ru.d @@ -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), вы можете определить правила, diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt index d1b236ec..7277d9fd 100644 --- a/doc/snapraid-ru.txt +++ b/doc/snapraid-ru.txt @@ -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) diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1 index ce48cf07..5b8cabc7 100644 --- a/doc/snapraid-sv.1 +++ b/doc/snapraid-sv.1 @@ -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 diff --git a/doc/snapraid-sv.d b/doc/snapraid-sv.d index c6ca38f2..676d0da6 100644 --- a/doc/snapraid-sv.d +++ b/doc/snapraid-sv.d @@ -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 diff --git a/doc/snapraid-sv.txt b/doc/snapraid-sv.txt index 8ade596a..c9e06ef8 100644 --- a/doc/snapraid-sv.txt +++ b/doc/snapraid-sv.txt @@ -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) diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1 index 5512b055..c9f073b1 100644 --- a/doc/snapraid-uk.1 +++ b/doc/snapraid-uk.1 @@ -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), ви можете визначити правила, які diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d index 1ebd044e..01030749 100644 --- a/doc/snapraid-uk.d +++ b/doc/snapraid-uk.d @@ -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), ви можете визначити правила, які diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt index 6f5c535d..82b990d9 100644 --- a/doc/snapraid-uk.txt +++ b/doc/snapraid-uk.txt @@ -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) diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1 index 5eb5f050..54c74d9a 100644 --- a/doc/snapraid-zh.1 +++ b/doc/snapraid-zh.1 @@ -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）， 您可以定义匹配特定文件名或整个目录结构的规则，而无需手动列出每个路径。 diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d index 3fcda570..8ccd3100 100644 --- a/doc/snapraid-zh.d +++ b/doc/snapraid-zh.d @@ -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）， 您可以定义匹配特定文件名或整个目录结构的规则，而无需手动列出每个路径。 diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt index ddaab8e0..654d202d 100644 --- a/doc/snapraid-zh.txt +++ b/doc/snapraid-zh.txt @@ -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) diff --git a/doc/snapraid.1 b/doc/snapraid.1 index b48162df..41d4ede7 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -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 diff --git a/doc/snapraid.d b/doc/snapraid.d index b02b3d3b..8e962458 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -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 diff --git a/doc/snapraid.txt b/doc/snapraid.txt index d46e89da..49f59a96 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -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