From 661e539f457968be46066357010dd3dd4d9c74b0 Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Wed, 12 Aug 2026 14:53:58 +0200 Subject: [PATCH] Defer pending snapshot promotion until parity sync --- cmdline/app.h | 1 + cmdline/mingwapp.c | 18 +++++++++++++--- cmdline/snapraid.c | 2 +- cmdline/state.c | 50 ++++++++++++++++++++++++++++++++++++++++----- cmdline/state.h | 9 ++++++-- cmdline/sync.c | 13 +++++++----- doc/snapraid-de.1 | 38 ++++++++++++++++++++-------------- doc/snapraid-de.d | 38 ++++++++++++++++++++-------------- doc/snapraid-de.txt | 38 ++++++++++++++++++++-------------- doc/snapraid-es.1 | 41 ++++++++++++++++++++++--------------- doc/snapraid-es.d | 41 ++++++++++++++++++++++--------------- doc/snapraid-es.txt | 41 ++++++++++++++++++++++--------------- doc/snapraid-fr.1 | 41 ++++++++++++++++++++++--------------- doc/snapraid-fr.d | 41 ++++++++++++++++++++++--------------- doc/snapraid-fr.txt | 41 ++++++++++++++++++++++--------------- doc/snapraid-it.1 | 41 ++++++++++++++++++++++--------------- doc/snapraid-it.d | 41 ++++++++++++++++++++++--------------- doc/snapraid-it.txt | 41 ++++++++++++++++++++++--------------- doc/snapraid-ja.1 | 32 +++++++++++++++++------------ doc/snapraid-ja.d | 32 +++++++++++++++++------------ doc/snapraid-ja.txt | 32 +++++++++++++++++------------ doc/snapraid-ko.1 | 35 +++++++++++++++++-------------- doc/snapraid-ko.d | 35 +++++++++++++++++-------------- doc/snapraid-ko.txt | 35 +++++++++++++++++-------------- doc/snapraid-pl.1 | 41 ++++++++++++++++++++++--------------- doc/snapraid-pl.d | 41 ++++++++++++++++++++++--------------- doc/snapraid-pl.txt | 41 ++++++++++++++++++++++--------------- doc/snapraid-pt.1 | 41 ++++++++++++++++++++++--------------- doc/snapraid-pt.d | 41 ++++++++++++++++++++++--------------- doc/snapraid-pt.txt | 41 ++++++++++++++++++++++--------------- doc/snapraid-ro.1 | 40 +++++++++++++++++++++--------------- doc/snapraid-ro.d | 40 +++++++++++++++++++++--------------- doc/snapraid-ro.txt | 40 +++++++++++++++++++++--------------- doc/snapraid-ru.1 | 43 +++++++++++++++++++++++--------------- doc/snapraid-ru.d | 43 +++++++++++++++++++++++--------------- doc/snapraid-ru.txt | 43 +++++++++++++++++++++++--------------- doc/snapraid-sv.1 | 39 ++++++++++++++++++++--------------- doc/snapraid-sv.d | 39 ++++++++++++++++++++--------------- doc/snapraid-sv.txt | 39 ++++++++++++++++++++--------------- doc/snapraid-uk.1 | 43 +++++++++++++++++++++++--------------- doc/snapraid-uk.d | 43 +++++++++++++++++++++++--------------- doc/snapraid-uk.txt | 43 +++++++++++++++++++++++--------------- doc/snapraid-zh.1 | 38 +++++++++++++++++++--------------- doc/snapraid-zh.d | 38 +++++++++++++++++++--------------- doc/snapraid-zh.txt | 38 +++++++++++++++++++--------------- doc/snapraid.1 | 42 ++++++++++++++++++++++--------------- doc/snapraid.d | 42 ++++++++++++++++++++++--------------- doc/snapraid.txt | 42 ++++++++++++++++++++++--------------- 48 files changed, 1076 insertions(+), 682 deletions(-) diff --git a/cmdline/app.h b/cmdline/app.h index c0e8cc25..28584a06 100644 --- a/cmdline/app.h +++ b/cmdline/app.h @@ -61,6 +61,7 @@ int fsinfo(const char* path, int* has_persistent_inode, int* has_syncronized_har */ #define SNAPSHOT_PENDING "pending" #define SNAPSHOT_STABLE "stable" +#define SNAPSHOT_SCAN "scan" /* * Snapshots context diff --git a/cmdline/mingwapp.c b/cmdline/mingwapp.c index 01e9e543..43b1a6f6 100644 --- a/cmdline/mingwapp.c +++ b/cmdline/mingwapp.c @@ -487,6 +487,10 @@ int fssnapshot_mount(const char* dir, struct fssnapshot_struct* fss) return -1; } + if (windows_rebuild_link(fss, SNAPSHOT_SCAN) != 0) { + return -1; + } + fss->magic = magic; return 0; @@ -645,6 +649,8 @@ int fssnapshot_rename(const struct fssnapshot_struct* fss, const char* old_name, { char old_guid[PATH_MAX]; char new_guid[PATH_MAX]; + char old_link[PATH_MAX]; + char new_link[PATH_MAX]; pathcpy(old_guid, sizeof(old_guid), fss->snapshot_dir); pathcat(old_guid, sizeof(old_guid), old_name); @@ -652,15 +658,20 @@ int fssnapshot_rename(const struct fssnapshot_struct* fss, const char* old_name, pathcpy(new_guid, sizeof(new_guid), fss->snapshot_dir); pathcat(new_guid, sizeof(new_guid), new_name); pathcat(new_guid, sizeof(new_guid), SNAPSHOT_GUID); + pathcpy(old_link, sizeof(old_link), fss->snapshot_dir); + pathcat(old_link, sizeof(old_link), old_name); + pathcpy(new_link, sizeof(new_link), fss->snapshot_dir); + pathcat(new_link, sizeof(new_link), new_name); if (windows_rename(old_guid, new_guid) != 0) { log_error(errno, "Error renaming '%s' to '%s'. %s.\n", old_guid, new_guid, strerror(errno)); return -1; } - /* the rename is the latest operation, and then we don't care about the links, we just remove both */ - windows_delete_link(fss, old_name); - windows_delete_link(fss, new_name); + if (windows_rename(old_link, new_link) != 0) { + log_error(errno, "Error renaming '%s' to '%s'. %s.\n", old_link, new_link, strerror(errno)); + return -1; + } return 0; } @@ -678,6 +689,7 @@ void fssnapshot_unmount(const struct fssnapshot_struct* fss) */ windows_delete_link(fss, SNAPSHOT_PENDING); windows_delete_link(fss, SNAPSHOT_STABLE); + windows_delete_link(fss, SNAPSHOT_SCAN); } /****************************************************************************/ diff --git a/cmdline/snapraid.c b/cmdline/snapraid.c index d4b4e5f6..4b37a723 100644 --- a/cmdline/snapraid.c +++ b/cmdline/snapraid.c @@ -1806,7 +1806,7 @@ int snapraid_main(int argc, char* argv[]) state_write(&state); } - ret = state_snapshot_new(&state); + ret = state_snapshot_scan(&state); if (ret != 0) { exit(EXIT_FAILURE); } diff --git a/cmdline/state.c b/cmdline/state.c index 6a54318c..84867764 100644 --- a/cmdline/state.c +++ b/cmdline/state.c @@ -5956,7 +5956,7 @@ static int state_snapshot_dir(struct fssnapshot_struct* fss, const char* name, c return 0; } -int state_snapshot_new(struct snapraid_state* state) +int state_snapshot_scan(struct snapraid_state* state) { if (!state->snapshot) return 0; @@ -5970,7 +5970,47 @@ int state_snapshot_new(struct snapraid_state* state) size_t root_len = strlen(disk->fss.root_dir); - /* delete a potential previous pending snapshot */ + /* delete a potential previous scan snapshot */ + if (state_snapshot_dir(&disk->fss, SNAPSHOT_SCAN, 0, 0) == 0) { + if (fssnapshot_delete(&disk->fss, SNAPSHOT_SCAN) != 0) { + log_fatal(errno, "Failed to delete scan snapshot in '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); + return -1; + } + } + + /* create a new snapshot for scanning */ + if (fssnapshot_create(&disk->fss, SNAPSHOT_SCAN) != 0) { + log_fatal(errno, "Failed to create scan snapshot '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); + return -1; + } + + msg_progress("Created disk %s scan snapshot...\n", disk->name); + + /* setup the snapshot in use */ + if (state_snapshot_dir(&disk->fss, SNAPSHOT_SCAN, disk->mount_point + root_len, disk) != 0) { + log_error(errno, "Error stating scan snapshot '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); + return -1; + } + } + + return 0; +} + +int state_snapshot_pending(struct snapraid_state* state) +{ + if (!state->snapshot) + return 0; + + for (tommy_node* i = state->disklist; i != 0; i = i->next) { + struct snapraid_disk* disk = i->data; + + /* check if it supports snapshot */ + if (disk->fss.magic == 0) + continue; + + size_t root_len = strlen(disk->fss.root_dir); + + /* delete the pending snapshot only after the content state was saved */ if (state_snapshot_dir(&disk->fss, SNAPSHOT_PENDING, 0, 0) == 0) { if (fssnapshot_delete(&disk->fss, SNAPSHOT_PENDING) != 0) { log_fatal(errno, "Failed to delete pending snapshot in '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); @@ -5978,9 +6018,9 @@ int state_snapshot_new(struct snapraid_state* state) } } - /* create a new snapshot */ - if (fssnapshot_create(&disk->fss, SNAPSHOT_PENDING) != 0) { - log_fatal(errno, "Failed to create pending snapshot '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); + /* make the scan snapshot available for recovery */ + if (fssnapshot_rename(&disk->fss, SNAPSHOT_SCAN, SNAPSHOT_PENDING) != 0) { + log_fatal(errno, "Failed to rename scan snapshot in '%s'. %s.\n", disk->fss.snapshot_dir, strerror(errno)); return -1; } diff --git a/cmdline/state.h b/cmdline/state.h index 5a2d4f9e..5801c339 100644 --- a/cmdline/state.h +++ b/cmdline/state.h @@ -426,9 +426,14 @@ void state_load_ignore_file(tommy_list* filter_list, const char* path, const cha void state_attr(struct snapraid_state* state, tommy_list* low); /** - * Create (or reuse existing) pending snapshots + * Create (or reuse existing) scan snapshots */ -int state_snapshot_new(struct snapraid_state* state); +int state_snapshot_scan(struct snapraid_state* state); + +/** + * Promote scan snapshots to pending before starting parity processing. + */ +int state_snapshot_pending(struct snapraid_state* state); /** * Make the pending snapshots as stable diff --git a/cmdline/sync.c b/cmdline/sync.c index 59a379e3..e1b00fe5 100644 --- a/cmdline/sync.c +++ b/cmdline/sync.c @@ -1686,13 +1686,16 @@ int state_sync(struct snapraid_state* state, block_off_t blockstart, block_off_t log_fatal(EUSER, "WARNING! Skipped state write for --test-skip-content-write option.\n"); } - if (state->opt.kill_before_sync) { + /* make the scanned state available for recovery before changing parity */ + if (state_snapshot_pending(state) != 0) { + /* LCOV_EXCL_START */ + ++process_error; + /* continue, as we are already exiting */ + /* LCOV_EXCL_STOP */ + } else if (state->opt.kill_before_sync) { log_fatal(EUSER, "WARNING! Killing due --test-kill-before-sync option.\n"); exit(EXIT_SUCCESS); - } - - /* skip degenerated cases of empty parity, or skipping all */ - if (blockstart < blockmax) { + } else if (blockstart < blockmax) { ret = state_sync_process(state, parity_handle, blockstart, blockmax); if (ret == -1) { /* LCOV_EXCL_START */ diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1 index e034b2ea..becb66d2 100644 --- a/doc/snapraid-de.1 +++ b/doc/snapraid-de.1 @@ -133,7 +133,8 @@ 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. +kann SnapRAID automatisch eine unabhängige eingefrorene Referenz +jedes unterstützten Daten\-Dateisystems 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 @@ -1544,8 +1545,9 @@ Aktiviert die Verwendung von Dateisystem\-Snapshots für die Befehle \`sync\`, \ \`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. +Snapshot jedes unterstützten Daten\-Dateisystems. Dies bietet eine stabile Ansicht +jedes Dateisystems und verhindert, dass spätere Änderungen die für die Paritätsberechnung +verwendeten Daten verändern. .PP Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem Live\-Dateisystem gelöscht wird, bleibt sie im Snapshot erhalten. Dies verhindert, @@ -1932,8 +1934,9 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .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. +Wenn die Snapshot\-Option in der Konfiguration aktiviert ist, verwendet SnapRAID +Dateisystem\-Snapshots, um die während einer Operation gelesenen Daten stabil zu halten, +selbst wenn Dateien auf den Live\-Dateisystemen nachträglich geändert oder gelöscht werden. .PP Die Verwaltung von Snapshots erfolgt vollständig automatisch und transparent. Sie können SnapRAID genau wie bisher verwenden, wobei der zusätzliche Schutz @@ -1946,7 +1949,7 @@ Dies bietet zwei wesentliche Vorteile: .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. +weil jedes Dateisystem mit Snapshot für die Dauer der Operation unverändert bleibt. .HP 4 .I Wiederherstellung Wenn eine Datei im Live\-Dateisystem aktualisiert oder gelöscht wird, @@ -1988,12 +1991,13 @@ 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 (Command Behavior with 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. +Die Befehle \`sync\` und \`scrub\` verwenden Snapshots für Datenträger, deren +Dateisysteme diese unterstützen. Auf einer Festplatte mit Snapshot sieht der Befehl +ein stabiles Dateisystemabbild, das von gleichzeitigen Änderungen am Live\-Dateisystem +unbeeinflusst bleibt. +Während eines \`sync\` wird unabhängig für jedes unterstützte Daten\-Dateisystem ein +neuer Snapshot erstellt. Diese Snapshots liefern gemeinsam die für die Paritätsberechnung +verwendeten Daten. 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. @@ -2016,7 +2020,7 @@ In diesem Fall verwenden \`check\` und \`fix\` ausschließlich die Live\-Dateisy .PP Alle anderen Befehle arbeiten ausschließlich auf dem Live\-Dateisystem. .SH LEBENSZYKLUS VON SNAPSHOTS (SNAPSHOTS LIFECYCLE) -SnapRAID verwaltet zwei spezifische Snapshots, \`stable\` und \`pending\`, +SnapRAID verwaltet drei spezifische Snapshots, \`stable\`, \`pending\` und \`scan\`, 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/\`. @@ -2026,8 +2030,12 @@ 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. +Der \`scan\`\-Snapshot ist ein temporäres Abbild, das zu Beginn eines \`sync\` +erstellt wird, um einen eingefrorenen Zustand für das Scannen und die Paritätsberechnung bereitzustellen. +Nach dem Scannen und Speichern des neuen Inhaltszustands ersetzt er den vorherigen +\`pending\`\-Snapshot. +.PP +Der \`pending\`\-Snapshot ist das Abbild, das von einem unterbrochenen \`sync\` verwendet wird. 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 diff --git a/doc/snapraid-de.d b/doc/snapraid-de.d index 24a5416f..3a0c2b4c 100644 --- a/doc/snapraid-de.d +++ b/doc/snapraid-de.d @@ -66,7 +66,8 @@ Einschränkungen (Limitations) 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. + kann SnapRAID automatisch eine unabhängige eingefrorene Referenz + jedes unterstützten Daten-Dateisystems 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. @@ -1249,8 +1250,9 @@ Konfiguration (Configuration) `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. + Snapshot jedes unterstützten Daten-Dateisystems. Dies bietet eine stabile Ansicht + jedes Dateisystems und verhindert, dass spätere Änderungen die für die Paritätsberechnung + verwendeten Daten verändern. Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem Live-Dateisystem gelöscht wird, bleibt sie im Snapshot erhalten. Dies verhindert, @@ -1536,8 +1538,9 @@ Konfiguration (Configuration) :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. + Wenn die Snapshot-Option in der Konfiguration aktiviert ist, verwendet SnapRAID + Dateisystem-Snapshots, um die während einer Operation gelesenen Daten stabil zu halten, + selbst wenn Dateien auf den Live-Dateisystemen nachträglich geändert oder gelöscht werden. Die Verwaltung von Snapshots erfolgt vollständig automatisch und transparent. Sie können SnapRAID genau wie bisher verwenden, wobei der zusätzliche Schutz @@ -1547,7 +1550,7 @@ Snapshots 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. + weil jedes Dateisystem mit Snapshot für die Dauer der Operation unverändert bleibt. 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, @@ -1580,12 +1583,13 @@ Snapshots ausgeführt wird, wenn Snapshots aktiviert sind. Befehlsverhalten mit Snapshots (Command Behavior with 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. + Die Befehle `sync` und `scrub` verwenden Snapshots für Datenträger, deren + Dateisysteme diese unterstützen. Auf einer Festplatte mit Snapshot sieht der Befehl + ein stabiles Dateisystemabbild, das von gleichzeitigen Änderungen am Live-Dateisystem + unbeeinflusst bleibt. + Während eines `sync` wird unabhängig für jedes unterstützte Daten-Dateisystem ein + neuer Snapshot erstellt. Diese Snapshots liefern gemeinsam die für die Paritätsberechnung + verwendeten Daten. 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. @@ -1609,7 +1613,7 @@ Snapshots Alle anderen Befehle arbeiten ausschließlich auf dem Live-Dateisystem. Lebenszyklus von Snapshots (Snapshots Lifecycle) - SnapRAID verwaltet zwei spezifische Snapshots, `stable` und `pending`, + SnapRAID verwaltet drei spezifische Snapshots, `stable`, `pending` und `scan`, 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/`. @@ -1619,8 +1623,12 @@ Lebenszyklus von Snapshots (Snapshots Lifecycle) 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. + Der `scan`-Snapshot ist ein temporäres Abbild, das zu Beginn eines `sync` + erstellt wird, um einen eingefrorenen Zustand für das Scannen und die Paritätsberechnung bereitzustellen. + Nach dem Scannen und Speichern des neuen Inhaltszustands ersetzt er den vorherigen + `pending`-Snapshot. + + Der `pending`-Snapshot ist das Abbild, das von einem unterbrochenen `sync` verwendet wird. 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. diff --git a/doc/snapraid-de.txt b/doc/snapraid-de.txt index 930490d4..be45a6a4 100644 --- a/doc/snapraid-de.txt +++ b/doc/snapraid-de.txt @@ -76,7 +76,8 @@ Für Daten, die beim letzten Sync bereits existierten, hängt die Wiederherstell 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. + kann SnapRAID automatisch eine unabhängige eingefrorene Referenz + jedes unterstützten Daten-Dateisystems 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. @@ -1327,8 +1328,9 @@ Aktiviert die Verwendung von Dateisystem-Snapshots für die Befehle `sync`, `scr `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. +Snapshot jedes unterstützten Daten-Dateisystems. Dies bietet eine stabile Ansicht +jedes Dateisystems und verhindert, dass spätere Änderungen die für die Paritätsberechnung +verwendeten Daten verändern. Dies verbessert die Wiederherstellung erheblich: Wenn eine Datei aus dem Live-Dateisystem gelöscht wird, bleibt sie im Snapshot erhalten. Dies verhindert, @@ -1641,8 +1643,9 @@ Ein Beispiel für eine typische Konfiguration für Windows ist: 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. +Wenn die Snapshot-Option in der Konfiguration aktiviert ist, verwendet SnapRAID +Dateisystem-Snapshots, um die während einer Operation gelesenen Daten stabil zu halten, +selbst wenn Dateien auf den Live-Dateisystemen nachträglich geändert oder gelöscht werden. Die Verwaltung von Snapshots erfolgt vollständig automatisch und transparent. Sie können SnapRAID genau wie bisher verwenden, wobei der zusätzliche Schutz @@ -1652,7 +1655,7 @@ 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. + weil jedes Dateisystem mit Snapshot für die Dauer der Operation unverändert bleibt. 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, @@ -1687,12 +1690,13 @@ ausgeführt wird, wenn Snapshots aktiviert sind. 8.1 Befehlsverhalten mit Snapshots (Command Behavior with 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. +Die Befehle `sync` und `scrub` verwenden Snapshots für Datenträger, deren +Dateisysteme diese unterstützen. Auf einer Festplatte mit Snapshot sieht der Befehl +ein stabiles Dateisystemabbild, das von gleichzeitigen Änderungen am Live-Dateisystem +unbeeinflusst bleibt. +Während eines `sync` wird unabhängig für jedes unterstützte Daten-Dateisystem ein +neuer Snapshot erstellt. Diese Snapshots liefern gemeinsam die für die Paritätsberechnung +verwendeten Daten. 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. @@ -1719,7 +1723,7 @@ Alle anderen Befehle arbeiten ausschließlich auf dem Live-Dateisystem. 9 LEBENSZYKLUS VON SNAPSHOTS (SNAPSHOTS LIFECYCLE) ================================================== -SnapRAID verwaltet zwei spezifische Snapshots, `stable` und `pending`, +SnapRAID verwaltet drei spezifische Snapshots, `stable`, `pending` und `scan`, 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/`. @@ -1729,8 +1733,12 @@ 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. +Der `scan`-Snapshot ist ein temporäres Abbild, das zu Beginn eines `sync` +erstellt wird, um einen eingefrorenen Zustand für das Scannen und die Paritätsberechnung bereitzustellen. +Nach dem Scannen und Speichern des neuen Inhaltszustands ersetzt er den vorherigen +`pending`-Snapshot. + +Der `pending`-Snapshot ist das Abbild, das von einem unterbrochenen `sync` verwendet wird. 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. diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1 index a72b4e33..82461f5f 100644 --- a/doc/snapraid-es.1 +++ b/doc/snapraid-es.1 @@ -134,7 +134,8 @@ 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. +SnapRAID puede mantener automáticamente una referencia congelada +independiente de cada sistema de archivos de datos compatible. 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 @@ -1497,9 +1498,10 @@ porque se espera que estén siempre girando. 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. +Cuando está habilitado, SnapRAID crea una instantánea de solo lectura de cada +sistema de archivos de datos compatible al comienzo de un \'sync\'. Esto proporciona una +vista estable de cada sistema de archivos, evitando que modificaciones posteriores cambien +los datos utilizados para el cómputo de paridad. .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] @@ -1887,8 +1889,9 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .RE .SH INSTANTáNEAS (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. +utiliza instantáneas del sistema de archivos para mantener estables los datos leídos +durante una operación, incluso cuando los archivos en los sistemas de archivos activos +se modifican o eliminan posteriormente. .PP La gestión de las instantáneas es completamente automática y transparente. Puede continuar usando SnapRAID exactamente como antes, con la @@ -1902,7 +1905,8 @@ Esto proporciona dos beneficios primordiales: .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. +porque cada sistema de archivos con instantánea permanece sin cambios durante +toda la operación. .HP 4 .I Recuperación Si un archivo se actualiza o elimina del sistema de archivos activo, @@ -1945,12 +1949,13 @@ La creación y eliminación de instantáneas requieren privilegios administrativ 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. +Los comandos \`sync\` y \`scrub\` utilizan instantáneas para los discos de datos cuyos +sistemas de archivos las admiten. En un disco con instantánea, el comando ve +una imagen estable del sistema de archivos no afectada por cambios concurrentes en +el sistema de archivos activo. +Durante un \`sync\`, se crea una nueva instantánea de forma independiente para cada +sistema de archivos de datos compatible. Estas instantáneas proporcionan colectivamente +los datos utilizados 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. @@ -1975,7 +1980,7 @@ 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 (SNAPSHOTS LIFECYCLE) -SnapRAID gestiona dos instantáneas específicas, \`stable\` y \`pending\`, +SnapRAID gestiona tres instantáneas específicas, \`stable\`, \`pending\` y \`scan\`, 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/\`. @@ -1985,8 +1990,12 @@ La instantánea \`stable\` representa el estado del último 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. +La instantánea \`scan\` es una imagen temporal creada al inicio +de un \`sync\` para proporcionar un estado congelado para el escaneo y el cómputo de paridad. +Después de escanear y guardar el nuevo estado de contenido, reemplaza la instantánea +\`pending\` anterior. +.PP +La instantánea \`pending\` es la imagen utilizada por un \`sync\` interrumpido. 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. diff --git a/doc/snapraid-es.d b/doc/snapraid-es.d index eaf7a167..50c3fca9 100644 --- a/doc/snapraid-es.d +++ b/doc/snapraid-es.d @@ -67,7 +67,8 @@ Limitaciones (Limitations) 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. + SnapRAID puede mantener automáticamente una referencia congelada + independiente de cada sistema de archivos de datos compatible. 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. @@ -1213,9 +1214,10 @@ Configuración (Configuration) 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. + Cuando está habilitado, SnapRAID crea una instantánea de solo lectura de cada + sistema de archivos de datos compatible al comienzo de un 'sync'. Esto proporciona una + vista estable de cada sistema de archivos, evitando que modificaciones posteriores cambien + los datos utilizados para el cómputo de paridad. 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" @@ -1502,8 +1504,9 @@ Configuración (Configuration) Instantáneas (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. + utiliza instantáneas del sistema de archivos para mantener estables los datos leídos + durante una operación, incluso cuando los archivos en los sistemas de archivos activos + se modifican o eliminan posteriormente. La gestión de las instantáneas es completamente automática y transparente. Puede continuar usando SnapRAID exactamente como antes, con la @@ -1514,7 +1517,8 @@ Instantáneas (Snapshots) 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. + porque cada sistema de archivos con instantánea permanece sin cambios durante + toda la operación. 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 @@ -1548,12 +1552,13 @@ Instantáneas (Snapshots) 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. + Los comandos `sync` y `scrub` utilizan instantáneas para los discos de datos cuyos + sistemas de archivos las admiten. En un disco con instantánea, el comando ve + una imagen estable del sistema de archivos no afectada por cambios concurrentes en + el sistema de archivos activo. + Durante un `sync`, se crea una nueva instantánea de forma independiente para cada + sistema de archivos de datos compatible. Estas instantáneas proporcionan colectivamente + los datos utilizados 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. @@ -1579,7 +1584,7 @@ Instantáneas (Snapshots) Todos los demás comandos funcionan exclusivamente en el sistema de archivos activo. Ciclo de vida de las instantáneas (Snapshots Lifecycle) - SnapRAID gestiona dos instantáneas específicas, `stable` y `pending`, + SnapRAID gestiona tres instantáneas específicas, `stable`, `pending` y `scan`, 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/`. @@ -1589,8 +1594,12 @@ Ciclo de vida de las instantáneas (Snapshots Lifecycle) 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. + La instantánea `scan` es una imagen temporal creada al inicio + de un `sync` para proporcionar un estado congelado para el escaneo y el cómputo de paridad. + Después de escanear y guardar el nuevo estado de contenido, reemplaza la instantánea + `pending` anterior. + + La instantánea `pending` es la imagen utilizada por un `sync` interrumpido. 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. diff --git a/doc/snapraid-es.txt b/doc/snapraid-es.txt index 0f06e902..e4941cdf 100644 --- a/doc/snapraid-es.txt +++ b/doc/snapraid-es.txt @@ -77,7 +77,8 @@ Para los datos que ya existían en la última sincronización, la fiabilidad de 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. + SnapRAID puede mantener automáticamente una referencia congelada + independiente de cada sistema de archivos de datos compatible. 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. @@ -1291,9 +1292,10 @@ porque se espera que estén siempre girando. 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. +Cuando está habilitado, SnapRAID crea una instantánea de solo lectura de cada +sistema de archivos de datos compatible al comienzo de un 'sync'. Esto proporciona una +vista estable de cada sistema de archivos, evitando que modificaciones posteriores cambien +los datos utilizados para el cómputo de paridad. 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" @@ -1607,8 +1609,9 @@ Un ejemplo de una configuración típica para Windows es: ========================== 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. +utiliza instantáneas del sistema de archivos para mantener estables los datos leídos +durante una operación, incluso cuando los archivos en los sistemas de archivos activos +se modifican o eliminan posteriormente. La gestión de las instantáneas es completamente automática y transparente. Puede continuar usando SnapRAID exactamente como antes, con la @@ -1619,7 +1622,8 @@ 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. + porque cada sistema de archivos con instantánea permanece sin cambios durante + toda la operación. 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 @@ -1655,12 +1659,13 @@ 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. +Los comandos `sync` y `scrub` utilizan instantáneas para los discos de datos cuyos +sistemas de archivos las admiten. En un disco con instantánea, el comando ve +una imagen estable del sistema de archivos no afectada por cambios concurrentes en +el sistema de archivos activo. +Durante un `sync`, se crea una nueva instantánea de forma independiente para cada +sistema de archivos de datos compatible. Estas instantáneas proporcionan colectivamente +los datos utilizados 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. @@ -1689,7 +1694,7 @@ Todos los demás comandos funcionan exclusivamente en el sistema de archivos act 9 CICLO DE VIDA DE LAS INSTANTáNEAS (SNAPSHOTS LIFECYCLE) ========================================================= -SnapRAID gestiona dos instantáneas específicas, `stable` y `pending`, +SnapRAID gestiona tres instantáneas específicas, `stable`, `pending` y `scan`, 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/`. @@ -1699,8 +1704,12 @@ La instantánea `stable` representa el estado del último 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. +La instantánea `scan` es una imagen temporal creada al inicio +de un `sync` para proporcionar un estado congelado para el escaneo y el cómputo de paridad. +Después de escanear y guardar el nuevo estado de contenido, reemplaza la instantánea +`pending` anterior. + +La instantánea `pending` es la imagen utilizada por un `sync` interrumpido. 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. diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1 index 8d91a8c4..12ff47a5 100644 --- a/doc/snapraid-fr.1 +++ b/doc/snapraid-fr.1 @@ -133,7 +133,8 @@ 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. +SnapRAID peut maintenir automatiquement une référence figée +indépendante de chaque système de fichiers de données pris en charge. 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 @@ -1534,9 +1535,10 @@ Notez que ces disques ne sont pas affectés par les commandes \`up\` et 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. +Lorsqu\'elle est activée, SnapRAID crée un instantané en lecture seule de chaque +système de fichiers de données pris en charge au début d\'un \'sync\'. Cela fournit une +vue stable de chaque système de fichiers, empêchant les modifications ultérieures +de modifier les données utilisées pour le calcul de la parité. .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] @@ -1923,8 +1925,9 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .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. +utilise les instantanés du système de fichiers pour maintenir stables les données +lues pendant une opération, même si des fichiers sur les systèmes de fichiers actifs +sont ultérieurement modifiés ou supprimés. .PP La gestion des instantanés est entièrement automatique et transparente. Vous pouvez continuer à utiliser SnapRAID exactement comme avant, avec la @@ -1938,7 +1941,8 @@ Cela offre deux avantages principaux : .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. +car chaque système de fichiers avec instantané reste inchangé pendant toute +la durée de l\'opération. .HP 4 .I Récupération Si un fichier est mis à jour ou supprimé du système de fichiers actif, @@ -1981,12 +1985,13 @@ La création et la suppression d\'instantanés nécessitent des privilèges d\'a 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 (Command Behavior with Snapshots) -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é. +Les commandes \`sync\` et \`scrub\` utilisent des instantanés pour les disques de données dont +les systèmes de fichiers les prennent en charge. Sur un disque avec instantané, la commande +voit une image stable du système de fichiers non affectée par les modifications simultanées +sur le système de fichiers actif. +Pendant un \`sync\`, un nouvel instantané est créé indépendamment pour chaque système +de fichiers de données pris en charge. Ces instantanés fournissent collectivement les +données utilisées 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. @@ -2011,7 +2016,7 @@ 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 (SNAPSHOTS LIFECYCLE) -SnapRAID gère deux instantanés spécifiques, \`stable\` et \`pending\`, +SnapRAID gère trois instantanés spécifiques, \`stable\`, \`pending\` et \`scan\`, 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/\`. @@ -2021,8 +2026,12 @@ L\'instantané \`stable\` représente l\'état du dernier 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é. +L\'instantané \`scan\` est une image temporaire créée au début +d\'un \`sync\` pour fournir un état figé pour le balayage et le calcul de la parité. +Après le balayage et l\'enregistrement du nouvel état du contenu, il remplace l\'instantané +\`pending\` précédent. +.PP +L\'instantané \`pending\` est l\'image utilisée par un \`sync\` interrompu. 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. diff --git a/doc/snapraid-fr.d b/doc/snapraid-fr.d index 25fcf135..d3586f60 100644 --- a/doc/snapraid-fr.d +++ b/doc/snapraid-fr.d @@ -66,7 +66,8 @@ Limitations 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. + SnapRAID peut maintenir automatiquement une référence figée + indépendante de chaque système de fichiers de données pris en charge. 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. @@ -1250,9 +1251,10 @@ Configuration 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. + Lorsqu'elle est activée, SnapRAID crée un instantané en lecture seule de chaque + système de fichiers de données pris en charge au début d'un 'sync'. Cela fournit une + vue stable de chaque système de fichiers, empêchant les modifications ultérieures + de modifier les données utilisées pour le calcul de la parité. 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" @@ -1538,8 +1540,9 @@ Configuration 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. + utilise les instantanés du système de fichiers pour maintenir stables les données + lues pendant une opération, même si des fichiers sur les systèmes de fichiers actifs + sont ultérieurement modifiés ou supprimés. La gestion des instantanés est entièrement automatique et transparente. Vous pouvez continuer à utiliser SnapRAID exactement comme avant, avec la @@ -1550,7 +1553,8 @@ Snapshots 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. + car chaque système de fichiers avec instantané reste inchangé pendant toute + la durée de l'opération. 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 @@ -1584,12 +1588,13 @@ Snapshots lorsque les instantanés sont activés. Comportement des commandes avec les instantanés (Command Behavior with Snapshots) - 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é. + Les commandes `sync` et `scrub` utilisent des instantanés pour les disques de données dont + les systèmes de fichiers les prennent en charge. Sur un disque avec instantané, la commande + voit une image stable du système de fichiers non affectée par les modifications simultanées + sur le système de fichiers actif. + Pendant un `sync`, un nouvel instantané est créé indépendamment pour chaque système + de fichiers de données pris en charge. Ces instantanés fournissent collectivement les + données utilisées 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. @@ -1615,7 +1620,7 @@ Snapshots Toutes les autres commandes fonctionnent exclusivement sur le système de fichiers actif. Cycle de vie des instantanés (Snapshots Lifecycle) - SnapRAID gère deux instantanés spécifiques, `stable` et `pending`, + SnapRAID gère trois instantanés spécifiques, `stable`, `pending` et `scan`, 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/`. @@ -1625,8 +1630,12 @@ Cycle de vie des instantanés (Snapshots Lifecycle) 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é. + L'instantané `scan` est une image temporaire créée au début + d'un `sync` pour fournir un état figé pour le balayage et le calcul de la parité. + Après le balayage et l'enregistrement du nouvel état du contenu, il remplace l'instantané + `pending` précédent. + + L'instantané `pending` est l'image utilisée par un `sync` interrompu. 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. diff --git a/doc/snapraid-fr.txt b/doc/snapraid-fr.txt index 5232cc98..649b27d8 100644 --- a/doc/snapraid-fr.txt +++ b/doc/snapraid-fr.txt @@ -76,7 +76,8 @@ Pour les données qui existaient déjà lors de la dernière synchronisation, la 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. + SnapRAID peut maintenir automatiquement une référence figée + indépendante de chaque système de fichiers de données pris en charge. 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. @@ -1328,9 +1329,10 @@ Notez que ces disques ne sont pas affectés par les commandes `up` et 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. +Lorsqu'elle est activée, SnapRAID crée un instantané en lecture seule de chaque +système de fichiers de données pris en charge au début d'un 'sync'. Cela fournit une +vue stable de chaque système de fichiers, empêchant les modifications ultérieures +de modifier les données utilisées pour le calcul de la parité. 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" @@ -1643,8 +1645,9 @@ Un exemple de configuration typique pour Windows est : =========== 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. +utilise les instantanés du système de fichiers pour maintenir stables les données +lues pendant une opération, même si des fichiers sur les systèmes de fichiers actifs +sont ultérieurement modifiés ou supprimés. La gestion des instantanés est entièrement automatique et transparente. Vous pouvez continuer à utiliser SnapRAID exactement comme avant, avec la @@ -1655,7 +1658,8 @@ 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. + car chaque système de fichiers avec instantané reste inchangé pendant toute + la durée de l'opération. 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 @@ -1691,12 +1695,13 @@ lorsque les instantanés sont activés. 8.1 Comportement des commandes avec les instantanés (Command Behavior with Snapshots) ------------------------------------------------------------------------------------- -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é. +Les commandes `sync` et `scrub` utilisent des instantanés pour les disques de données dont +les systèmes de fichiers les prennent en charge. Sur un disque avec instantané, la commande +voit une image stable du système de fichiers non affectée par les modifications simultanées +sur le système de fichiers actif. +Pendant un `sync`, un nouvel instantané est créé indépendamment pour chaque système +de fichiers de données pris en charge. Ces instantanés fournissent collectivement les +données utilisées 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. @@ -1725,7 +1730,7 @@ Toutes les autres commandes fonctionnent exclusivement sur le système de fichie 9 CYCLE DE VIE DES INSTANTANéS (SNAPSHOTS LIFECYCLE) ==================================================== -SnapRAID gère deux instantanés spécifiques, `stable` et `pending`, +SnapRAID gère trois instantanés spécifiques, `stable`, `pending` et `scan`, 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/`. @@ -1735,8 +1740,12 @@ L'instantané `stable` représente l'état du dernier 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é. +L'instantané `scan` est une image temporaire créée au début +d'un `sync` pour fournir un état figé pour le balayage et le calcul de la parité. +Après le balayage et l'enregistrement du nouvel état du contenu, il remplace l'instantané +`pending` précédent. + +L'instantané `pending` est l'image utilisée par un `sync` interrompu. 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. diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1 index a134763b..07fd17ce 100644 --- a/doc/snapraid-it.1 +++ b/doc/snapraid-it.1 @@ -133,7 +133,8 @@ 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\'immagine congelata dei dischi dati. +SnapRAID può mantenere automaticamente un riferimento congelato +indipendente di ogni file system dati supportato. Ciò garantisce che anche se si modificano o si eliminano file sul file system live durante o dopo un sync, il processo di recupero rimane coerente e affidabile. .PD @@ -1520,9 +1521,10 @@ perché si prevede che siano sempre in rotazione. 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. +Quando abilitato, SnapRAID crea uno snapshot in sola lettura di ogni +file system dati supportato all\'inizio di un \'sync\'. Ciò fornisce una +vista stabile di ciascun file system, impedendo che modifiche successive +cambino i dati utilizzati per il calcolo della parità. .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] @@ -1909,8 +1911,9 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .RE .SH SNAPSHOT (SNAPSHOTS) Se l\'opzione snapshot è abilitata nella configurazione, SnapRAID -utilizza le funzionalità di snapshot del file system per garantire operazioni atomiche -e coerenti. +utilizza gli snapshot del file system per mantenere stabili i dati letti +durante un\'operazione, anche quando i file sui file system live vengono +successivamente modificati o eliminati. .PP La gestione degli snapshot è completamente automatica e trasparente. È possibile continuare a utilizzare SnapRAID esattamente come prima, con la @@ -1924,7 +1927,8 @@ Ciò fornisce due vantaggi primari: .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. +perché ogni file system con snapshot rimane invariato per l\'intera durata +dell\'operazione. .HP 4 .I Recupero Se un file viene aggiornato o eliminato dal file system live, @@ -1967,12 +1971,13 @@ La creazione e l\'eliminazione degli snapshot richiedono privilegi amministrativ Assicurati che SnapRAID sia eseguito con i permessi necessari (es. sudo) quando gli snapshot sono abilitati. .SS Comportamento dei comandi con gli snapshot (Command Behavior with Snapshots) -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à. +I comandi \`sync\` e \`scrub\` utilizzano snapshot per i dischi dati i cui +file system li supportano. Su un disco con snapshot, il comando vede +un\'immagine del file system stabile e non influenzata da modifiche +simultanee sul file system live. +Durante un \`sync\`, viene creato un nuovo snapshot in modo indipendente +per ciascun file system dati supportato. Questi snapshot forniscono +collettivamente i dati utilizzati per il calcolo della parità. Al contrario, il comando \`scrub\` utilizza l\'ultimo snapshot, quello creato durante il sync più recente, per mantenere un punto di riferimento affidabile che corrisponda alla parità esistente. @@ -1997,7 +2002,7 @@ i file system live. .PP Tutti gli altri comandi operano esclusivamente sul file system live. .SH CICLO DI VITA DEGLI SNAPSHOT (SNAPSHOTS LIFECYCLE) -SnapRAID gestisce due snapshot specifici, \`stable\` e \`pending\`, +SnapRAID gestisce tre snapshot specifici, \`stable\`, \`pending\` e \`scan\`, all\'interno di una directory nascosta alla radice di ogni sottovolume dati. In Btrfs, Bcachefs e NTFS viene utilizzata la directory \`.snapraid/\`, in ZFS quella standard \`.zfs/snapshot/\`. @@ -2007,8 +2012,12 @@ Lo snapshot \`stable\` rappresenta lo stato dell\'ultimo 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à. +Lo snapshot \`scan\` è un\'immagine temporanea creata all\'inizio +di un \`sync\` per fornire uno stato congelato per la scansione e il calcolo della parità. +Dopo la scansione e il salvataggio del nuovo stato del contenuto, sostituisce il precedente +snapshot \`pending\`. +.PP +Lo snapshot \`pending\` è l\'immagine utilizzata da un \`sync\` interrotto. Al completamento con successo dell\'operazione, il precedente snapshot \`stable\` viene eliminato e lo snapshot \`pending\` viene promosso per prendere il suo posto come nuovo riferimento stabile. diff --git a/doc/snapraid-it.d b/doc/snapraid-it.d index 859e4cbb..4b7f5228 100644 --- a/doc/snapraid-it.d +++ b/doc/snapraid-it.d @@ -66,7 +66,8 @@ Limitazioni (Limitations) dall'uso o meno dell'opzione `snapshot`: * Con il supporto snapshot (disponibile su Btrfs, ZFS, Bcachefs e NTFS), - SnapRAID può mantenere automaticamente un'immagine congelata dei dischi dati. + SnapRAID può mantenere automaticamente un riferimento congelato + indipendente di ogni file system dati supportato. Ciò garantisce che anche se si modificano o si eliminano file sul file system live durante o dopo un sync, il processo di recupero rimane coerente e affidabile. @@ -1225,9 +1226,10 @@ Configurazione (Configuration) 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. + Quando abilitato, SnapRAID crea uno snapshot in sola lettura di ogni + file system dati supportato all'inizio di un 'sync'. Ciò fornisce una + vista stabile di ciascun file system, impedendo che modifiche successive + cambino i dati utilizzati per il calcolo della parità. Questo migliora significativamente il recupero: se un file viene eliminato dal file system live, rimane preservato nello snapshot. Ciò impedisce alla parità di diventare "corrotta" @@ -1513,8 +1515,9 @@ Configurazione (Configuration) Snapshot (Snapshots) Se l'opzione snapshot è abilitata nella configurazione, SnapRAID - utilizza le funzionalità di snapshot del file system per garantire operazioni atomiche - e coerenti. + utilizza gli snapshot del file system per mantenere stabili i dati letti + durante un'operazione, anche quando i file sui file system live vengono + successivamente modificati o eliminati. La gestione degli snapshot è completamente automatica e trasparente. È possibile continuare a utilizzare SnapRAID esattamente come prima, con la @@ -1525,7 +1528,8 @@ Snapshot (Snapshots) 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. + perché ogni file system con snapshot rimane invariato per l'intera durata + dell'operazione. Recupero - Se un file viene aggiornato o eliminato dal file system live, rimane preservato nello snapshot. Se si verifica un guasto al disco prima dell'esecuzione del sync successivo, SnapRAID utilizza i dati preservati @@ -1559,12 +1563,13 @@ Snapshot (Snapshots) quando gli snapshot sono abilitati. Comportamento dei comandi con gli snapshot (Command Behavior with Snapshots) - 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à. + I comandi `sync` e `scrub` utilizzano snapshot per i dischi dati i cui + file system li supportano. Su un disco con snapshot, il comando vede + un'immagine del file system stabile e non influenzata da modifiche + simultanee sul file system live. + Durante un `sync`, viene creato un nuovo snapshot in modo indipendente + per ciascun file system dati supportato. Questi snapshot forniscono + collettivamente i dati utilizzati per il calcolo della parità. Al contrario, il comando `scrub` utilizza l'ultimo snapshot, quello creato durante il sync più recente, per mantenere un punto di riferimento affidabile che corrisponda alla parità esistente. @@ -1590,7 +1595,7 @@ Snapshot (Snapshots) Tutti gli altri comandi operano esclusivamente sul file system live. Ciclo di vita degli snapshot (Snapshots Lifecycle) - SnapRAID gestisce due snapshot specifici, `stable` e `pending`, + SnapRAID gestisce tre snapshot specifici, `stable`, `pending` e `scan`, all'interno di una directory nascosta alla radice di ogni sottovolume dati. In Btrfs, Bcachefs e NTFS viene utilizzata la directory `.snapraid/`, in ZFS quella standard `.zfs/snapshot/`. @@ -1600,8 +1605,12 @@ Ciclo di vita degli snapshot (Snapshots Lifecycle) 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à. + Lo snapshot `scan` è un'immagine temporanea creata all'inizio + di un `sync` per fornire uno stato congelato per la scansione e il calcolo della parità. + Dopo la scansione e il salvataggio del nuovo stato del contenuto, sostituisce il precedente + snapshot `pending`. + + Lo snapshot `pending` è l'immagine utilizzata da un `sync` interrotto. Al completamento con successo dell'operazione, il precedente snapshot `stable` viene eliminato e lo snapshot `pending` viene promosso per prendere il suo posto come nuovo riferimento stabile. diff --git a/doc/snapraid-it.txt b/doc/snapraid-it.txt index ec59da23..e7ee3b0a 100644 --- a/doc/snapraid-it.txt +++ b/doc/snapraid-it.txt @@ -76,7 +76,8 @@ Per i dati che esistevano già all'ultimo sync, l'affidabilità del recupero dip dall'uso o meno dell'opzione `snapshot`: * Con il supporto snapshot (disponibile su Btrfs, ZFS, Bcachefs e NTFS), - SnapRAID può mantenere automaticamente un'immagine congelata dei dischi dati. + SnapRAID può mantenere automaticamente un riferimento congelato + indipendente di ogni file system dati supportato. Ciò garantisce che anche se si modificano o si eliminano file sul file system live durante o dopo un sync, il processo di recupero rimane coerente e affidabile. @@ -1303,9 +1304,10 @@ perché si prevede che siano sempre in rotazione. 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. +Quando abilitato, SnapRAID crea uno snapshot in sola lettura di ogni +file system dati supportato all'inizio di un 'sync'. Ciò fornisce una +vista stabile di ciascun file system, impedendo che modifiche successive +cambino i dati utilizzati per il calcolo della parità. Questo migliora significativamente il recupero: se un file viene eliminato dal file system live, rimane preservato nello snapshot. Ciò impedisce alla parità di diventare "corrotta" @@ -1618,8 +1620,9 @@ Un esempio di configurazione tipica per Windows è: ====================== Se l'opzione snapshot è abilitata nella configurazione, SnapRAID -utilizza le funzionalità di snapshot del file system per garantire operazioni atomiche -e coerenti. +utilizza gli snapshot del file system per mantenere stabili i dati letti +durante un'operazione, anche quando i file sui file system live vengono +successivamente modificati o eliminati. La gestione degli snapshot è completamente automatica e trasparente. È possibile continuare a utilizzare SnapRAID esattamente come prima, con la @@ -1630,7 +1633,8 @@ 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. + perché ogni file system con snapshot rimane invariato per l'intera durata + dell'operazione. Recupero - Se un file viene aggiornato o eliminato dal file system live, rimane preservato nello snapshot. Se si verifica un guasto al disco prima dell'esecuzione del sync successivo, SnapRAID utilizza i dati preservati @@ -1666,12 +1670,13 @@ quando gli snapshot sono abilitati. 8.1 Comportamento dei comandi con gli snapshot (Command Behavior with Snapshots) -------------------------------------------------------------------------------- -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à. +I comandi `sync` e `scrub` utilizzano snapshot per i dischi dati i cui +file system li supportano. Su un disco con snapshot, il comando vede +un'immagine del file system stabile e non influenzata da modifiche +simultanee sul file system live. +Durante un `sync`, viene creato un nuovo snapshot in modo indipendente +per ciascun file system dati supportato. Questi snapshot forniscono +collettivamente i dati utilizzati per il calcolo della parità. Al contrario, il comando `scrub` utilizza l'ultimo snapshot, quello creato durante il sync più recente, per mantenere un punto di riferimento affidabile che corrisponda alla parità esistente. @@ -1700,7 +1705,7 @@ Tutti gli altri comandi operano esclusivamente sul file system live. 9 CICLO DI VITA DEGLI SNAPSHOT (SNAPSHOTS LIFECYCLE) ==================================================== -SnapRAID gestisce due snapshot specifici, `stable` e `pending`, +SnapRAID gestisce tre snapshot specifici, `stable`, `pending` e `scan`, all'interno di una directory nascosta alla radice di ogni sottovolume dati. In Btrfs, Bcachefs e NTFS viene utilizzata la directory `.snapraid/`, in ZFS quella standard `.zfs/snapshot/`. @@ -1710,8 +1715,12 @@ Lo snapshot `stable` rappresenta lo stato dell'ultimo 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à. +Lo snapshot `scan` è un'immagine temporanea creata all'inizio +di un `sync` per fornire uno stato congelato per la scansione e il calcolo della parità. +Dopo la scansione e il salvataggio del nuovo stato del contenuto, sostituisce il precedente +snapshot `pending`. + +Lo snapshot `pending` è l'immagine utilizzata da un `sync` interrotto. Al completamento con successo dell'operazione, il precedente snapshot `stable` viene eliminato e lo snapshot `pending` viene promosso per prendere il suo posto come nuovo riferimento stabile. diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1 index af893ffd..a8a42e90 100644 --- a/doc/snapraid-ja.1 +++ b/doc/snapraid-ja.1 @@ -128,7 +128,8 @@ SnapRAIDはRAIDとバックアッププログラムのハイブリッドであ .PD 0 .IP \(bu スナップショットサポートがある場合（Btrfs、ZFS、Bcachefs、およびNTFSで利用可能）： -SnapRAIDはデータディスクの凍結されたリファレンスを自動的に維持できます。 +SnapRAIDはサポートされている各データファイルシステムの独立した凍結されたリファレンスを +自動的に維持できます。 これにより、同期中または同期後にライブファイルシステム上のファイルを変更または削除した場合でも、 復元プロセスの整合性と信頼性が保たれます。 .PD @@ -1366,9 +1367,9 @@ NAME を固定したままにしておけば、必要に応じてマウントポ \`sync\`、\`scrub\`、\`check\`、および \`fix\` コマンドでファイルシステムスナップショットの 使用を有効にします。 .PP -有効にすると、SnapRAIDは \`sync\` の開始時にデータの読み取り専用スナップショットを作成します。 -これにより、ファイルの整合性を保った特定の時点のビューが確保され、ファイルの同時変更によって -発生するエラーを防ぎます。 +有効にすると、SnapRAIDは \`sync\` の開始時にサポートされている各データファイルシステムの +読み取り専用スナップショットを作成します。これにより各ファイルシステムの安定したビューが +提供され、後からの変更によってパリティ計算に使用されるデータが変わるのを防ぎます。 .PP これにより復元が大幅に向上します。ライブファイルシステムからファイルが削除されても、 スナップショット内に保存され続けます。これにより、そのブロックのパリティが「破損」するのを防ぎ、 @@ -1716,7 +1717,8 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .RE .SH スナップショット (SNAPSHOTS) 設定でスナップショットオプションが有効になっている場合、SnapRAIDは -ファイルシステムのスナップショット機能を利用して、アトミックで一貫性のある操作を保証します。 +ファイルシステムのスナップショットを使用して、操作中に読み取られるデータを安定に保ちます。 +これは、ライブファイルシステム上のファイルが後から変更または削除された場合でも同様です。 .PP スナップショットの管理は完全に自動かつ透過的です。 バックグラウンドで完全に処理されるスナップショットによる追加の保護を受けながら、 @@ -1728,7 +1730,8 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .HP 4 .I 整合性 長時間かかるsyncやscrubの実行中にライブファイルシステム上でファイルが変更されても、 -SnapRAIDは凍結された時点のイメージを参照するため、パリティの不一致や処理の中断は発生しません。 +スナップショットされた各ファイルシステムは操作中変更されないため、 +パリティの不一致や処理の中断は発生しません。 .HP 4 .I 復元 ライブファイルシステムからファイルが更新または削除されても、スナップショット内に保存され続けます。 @@ -1762,11 +1765,11 @@ SnapRAIDは凍結された時点のイメージを参照するため、パリテ スナップショットの作成と削除には管理者権限が必要です。 スナップショットが有効な場合は、SnapRAIDが必要な権限（例：sudo）で実行されていることを確認してください。 .SS スナップショット使用時のコマンドの挙動 (Command Behavior with Snapshots) -\`sync\` と \`scrub\` コマンドは、すべてのデータ操作が一貫した凍結状態に対して行われることを -保証するために、いずれもスナップショット上でのみ動作します。これらのスナップショットを利用することで、 -SnapRAIDはライブファイルシステム上での同時ファイル変更によってトリガーされるパリティの不一致を防ぎます。 -\`sync\` の実行中、コマンドはプロセスの開始時に作成された新しいスナップショットを使用して、パリティ計算の -ための現在の状態をキャプチャします。 +\`sync\` および \`scrub\` コマンドは、ファイルシステムがサポートしているデータディスクに対して +スナップショットを使用します。スナップショットされたディスクでは、コマンドはライブファイルシステムへの +同時変更の影響を受けない安定したファイルシステムイメージを参照します。 +\`sync\` の実行中、サポートされている各データファイルシステムに対して独立して新しいスナップショットが +作成されます。これらのスナップショットは全体としてパリティ計算に使用されるデータを提供します。 対照的に、\`scrub\` コマンドは、既存のパリティと一致する信頼できる参照ポイントを維持するために、 最も直近の同期中に作成された最後のスナップショットを利用します。 .PP @@ -1787,7 +1790,7 @@ SnapRAIDはライブファイルシステム上での同時ファイル変更に 他のすべてのコマンドは、ライブファイルシステム上でのみ動作します。 .SH スナップショットのライフサイクル (SNAPSHOTS LIFECYCLE) SnapRAIDは、各データサブボリュームのルートにある隠しディレクトリ内で、 -\`stable\`（安定）と \`pending\`（保留）という2つの特定のスナップショットを管理します。 +\`stable\`（安定）、\`pending\`（保留）、および \`scan\`（スキャン）という3つの特定のスナップショットを管理します。 Btrfs、Bcachefs、およびNTFSでは \`.snapraid/\` ディレクトリが使用され、 ZFSでは標準の \`.zfs/snapshot/\` が使用されます。 .PP @@ -1795,8 +1798,11 @@ ZFSでは標準の \`.zfs/snapshot/\` が使用されます。 現在のパリティの計算に使用された正確なデータを含んでいます。これは、 \`scrub\`、\`check\`、および \`fix\` コマンドの主要なデータソースとして機能します。 .PP -\`pending\` スナップショットは、パリティ計算のための凍結された状態を提供するために、 +\`scan\` スナップショットは、スキャンとパリティ計算のための凍結された状態を提供するために、 \`sync\` の開始時に作成される一時的なイメージです。 +スキャンを実行し、新しいコンテンツ状態を保存した後、以前の \`pending\` スナップショットを置き換えます。 +.PP +\`pending\` スナップショットは、中断された \`sync\` によって使用されるイメージです。 操作が正常に完了すると、以前の \`stable\` スナップショットが削除され、 \`pending\` スナップショットが新しい安定した参照として昇格します。 .PP diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d index 30289db9..888c96ed 100644 --- a/doc/snapraid-ja.d +++ b/doc/snapraid-ja.d @@ -61,7 +61,8 @@ Name{number} オプションが使用されているかどうかによって異なります。 * スナップショットサポートがある場合（Btrfs、ZFS、Bcachefs、およびNTFSで利用可能）： - SnapRAIDはデータディスクの凍結されたリファレンスを自動的に維持できます。 + SnapRAIDはサポートされている各データファイルシステムの独立した凍結されたリファレンスを + 自動的に維持できます。 これにより、同期中または同期後にライブファイルシステム上のファイルを変更または削除した場合でも、 復元プロセスの整合性と信頼性が保たれます。 @@ -1082,9 +1083,9 @@ Name{number} `sync`、`scrub`、`check`、および `fix` コマンドでファイルシステムスナップショットの 使用を有効にします。 - 有効にすると、SnapRAIDは `sync` の開始時にデータの読み取り専用スナップショットを作成します。 - これにより、ファイルの整合性を保った特定の時点のビューが確保され、ファイルの同時変更によって - 発生するエラーを防ぎます。 + 有効にすると、SnapRAIDは `sync` の開始時にサポートされている各データファイルシステムの + 読み取り専用スナップショットを作成します。これにより各ファイルシステムの安定したビューが + 提供され、後からの変更によってパリティ計算に使用されるデータが変わるのを防ぎます。 これにより復元が大幅に向上します。ライブファイルシステムからファイルが削除されても、 スナップショット内に保存され続けます。これにより、そのブロックのパリティが「破損」するのを防ぎ、 @@ -1331,7 +1332,8 @@ Name{number} スナップショット (Snapshots) 設定でスナップショットオプションが有効になっている場合、SnapRAIDは - ファイルシステムのスナップショット機能を利用して、アトミックで一貫性のある操作を保証します。 + ファイルシステムのスナップショットを使用して、操作中に読み取られるデータを安定に保ちます。 + これは、ライブファイルシステム上のファイルが後から変更または削除された場合でも同様です。 スナップショットの管理は完全に自動かつ透過的です。 バックグラウンドで完全に処理されるスナップショットによる追加の保護を受けながら、 @@ -1340,7 +1342,8 @@ Name{number} これには主に2つのメリットがあります。 整合性 - 長時間かかるsyncやscrubの実行中にライブファイルシステム上でファイルが変更されても、 - SnapRAIDは凍結された時点のイメージを参照するため、パリティの不一致や処理の中断は発生しません。 + スナップショットされた各ファイルシステムは操作中変更されないため、 + パリティの不一致や処理の中断は発生しません。 復元 - ライブファイルシステムからファイルが更新または削除されても、スナップショット内に保存され続けます。 次のsyncが実行される前にディスク故障が発生した場合、SnapRAIDはスナップショットに保存されている データを使用して、故障したディスクを再構築します。 @@ -1365,11 +1368,11 @@ Name{number} スナップショットが有効な場合は、SnapRAIDが必要な権限（例：sudo）で実行されていることを確認してください。 スナップショット使用時のコマンドの挙動 (Command Behavior with Snapshots) - `sync` と `scrub` コマンドは、すべてのデータ操作が一貫した凍結状態に対して行われることを - 保証するために、いずれもスナップショット上でのみ動作します。これらのスナップショットを利用することで、 - SnapRAIDはライブファイルシステム上での同時ファイル変更によってトリガーされるパリティの不一致を防ぎます。 - `sync` の実行中、コマンドはプロセスの開始時に作成された新しいスナップショットを使用して、パリティ計算の - ための現在の状態をキャプチャします。 + `sync` および `scrub` コマンドは、ファイルシステムがサポートしているデータディスクに対して + スナップショットを使用します。スナップショットされたディスクでは、コマンドはライブファイルシステムへの + 同時変更の影響を受けない安定したファイルシステムイメージを参照します。 + `sync` の実行中、サポートされている各データファイルシステムに対して独立して新しいスナップショットが + 作成されます。これらのスナップショットは全体としてパリティ計算に使用されるデータを提供します。 対照的に、`scrub` コマンドは、既存のパリティと一致する信頼できる参照ポイントを維持するために、 最も直近の同期中に作成された最後のスナップショットを利用します。 @@ -1391,7 +1394,7 @@ Name{number} スナップショットのライフサイクル (Snapshots Lifecycle) SnapRAIDは、各データサブボリュームのルートにある隠しディレクトリ内で、 - `stable`（安定）と `pending`（保留）という2つの特定のスナップショットを管理します。 + `stable`（安定）、`pending`（保留）、および `scan`（スキャン）という3つの特定のスナップショットを管理します。 Btrfs、Bcachefs、およびNTFSでは `.snapraid/` ディレクトリが使用され、 ZFSでは標準の `.zfs/snapshot/` が使用されます。 @@ -1399,8 +1402,11 @@ Name{number} 現在のパリティの計算に使用された正確なデータを含んでいます。これは、 `scrub`、`check`、および `fix` コマンドの主要なデータソースとして機能します。 - `pending` スナップショットは、パリティ計算のための凍結された状態を提供するために、 + `scan` スナップショットは、スキャンとパリティ計算のための凍結された状態を提供するために、 `sync` の開始時に作成される一時的なイメージです。 + スキャンを実行し、新しいコンテンツ状態を保存した後、以前の `pending` スナップショットを置き換えます。 + + `pending` スナップショットは、中断された `sync` によって使用されるイメージです。 操作が正常に完了すると、以前の `stable` スナップショットが削除され、 `pending` スナップショットが新しい安定した参照として昇格します。 diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt index 0390845d..71df989e 100644 --- a/doc/snapraid-ja.txt +++ b/doc/snapraid-ja.txt @@ -71,7 +71,8 @@ SnapRAIDはRAIDとバックアッププログラムのハイブリッドであ オプションが使用されているかどうかによって異なります。 * スナップショットサポートがある場合（Btrfs、ZFS、Bcachefs、およびNTFSで利用可能）： - SnapRAIDはデータディスクの凍結されたリファレンスを自動的に維持できます。 + SnapRAIDはサポートされている各データファイルシステムの独立した凍結されたリファレンスを + 自動的に維持できます。 これにより、同期中または同期後にライブファイルシステム上のファイルを変更または削除した場合でも、 復元プロセスの整合性と信頼性が保たれます。 @@ -1160,9 +1161,9 @@ NAME を固定したままにしておけば、必要に応じてマウントポ `sync`、`scrub`、`check`、および `fix` コマンドでファイルシステムスナップショットの 使用を有効にします。 -有効にすると、SnapRAIDは `sync` の開始時にデータの読み取り専用スナップショットを作成します。 -これにより、ファイルの整合性を保った特定の時点のビューが確保され、ファイルの同時変更によって -発生するエラーを防ぎます。 +有効にすると、SnapRAIDは `sync` の開始時にサポートされている各データファイルシステムの +読み取り専用スナップショットを作成します。これにより各ファイルシステムの安定したビューが +提供され、後からの変更によってパリティ計算に使用されるデータが変わるのを防ぎます。 これにより復元が大幅に向上します。ライブファイルシステムからファイルが削除されても、 スナップショット内に保存され続けます。これにより、そのブロックのパリティが「破損」するのを防ぎ、 @@ -1436,7 +1437,8 @@ Windowsの一般的な構成の例は次のとおりです。 ====================== 設定でスナップショットオプションが有効になっている場合、SnapRAIDは -ファイルシステムのスナップショット機能を利用して、アトミックで一貫性のある操作を保証します。 +ファイルシステムのスナップショットを使用して、操作中に読み取られるデータを安定に保ちます。 +これは、ライブファイルシステム上のファイルが後から変更または削除された場合でも同様です。 スナップショットの管理は完全に自動かつ透過的です。 バックグラウンドで完全に処理されるスナップショットによる追加の保護を受けながら、 @@ -1445,7 +1447,8 @@ Windowsの一般的な構成の例は次のとおりです。 これには主に2つのメリットがあります。 整合性 - 長時間かかるsyncやscrubの実行中にライブファイルシステム上でファイルが変更されても、 - SnapRAIDは凍結された時点のイメージを参照するため、パリティの不一致や処理の中断は発生しません。 + スナップショットされた各ファイルシステムは操作中変更されないため、 + パリティの不一致や処理の中断は発生しません。 復元 - ライブファイルシステムからファイルが更新または削除されても、スナップショット内に保存され続けます。 次のsyncが実行される前にディスク故障が発生した場合、SnapRAIDはスナップショットに保存されている データを使用して、故障したディスクを再構築します。 @@ -1472,11 +1475,11 @@ Windowsの一般的な構成の例は次のとおりです。 8.1 スナップショット使用時のコマンドの挙動 (Command Behavior with Snapshots) --------------------------------------------------------- -`sync` と `scrub` コマンドは、すべてのデータ操作が一貫した凍結状態に対して行われることを -保証するために、いずれもスナップショット上でのみ動作します。これらのスナップショットを利用することで、 -SnapRAIDはライブファイルシステム上での同時ファイル変更によってトリガーされるパリティの不一致を防ぎます。 -`sync` の実行中、コマンドはプロセスの開始時に作成された新しいスナップショットを使用して、パリティ計算の -ための現在の状態をキャプチャします。 +`sync` および `scrub` コマンドは、ファイルシステムがサポートしているデータディスクに対して +スナップショットを使用します。スナップショットされたディスクでは、コマンドはライブファイルシステムへの +同時変更の影響を受けない安定したファイルシステムイメージを参照します。 +`sync` の実行中、サポートされている各データファイルシステムに対して独立して新しいスナップショットが +作成されます。これらのスナップショットは全体としてパリティ計算に使用されるデータを提供します。 対照的に、`scrub` コマンドは、既存のパリティと一致する信頼できる参照ポイントを維持するために、 最も直近の同期中に作成された最後のスナップショットを利用します。 @@ -1501,7 +1504,7 @@ SnapRAIDはライブファイルシステム上での同時ファイル変更に ======================================== SnapRAIDは、各データサブボリュームのルートにある隠しディレクトリ内で、 -`stable`（安定）と `pending`（保留）という2つの特定のスナップショットを管理します。 +`stable`（安定）、`pending`（保留）、および `scan`（スキャン）という3つの特定のスナップショットを管理します。 Btrfs、Bcachefs、およびNTFSでは `.snapraid/` ディレクトリが使用され、 ZFSでは標準の `.zfs/snapshot/` が使用されます。 @@ -1509,8 +1512,11 @@ ZFSでは標準の `.zfs/snapshot/` が使用されます。 現在のパリティの計算に使用された正確なデータを含んでいます。これは、 `scrub`、`check`、および `fix` コマンドの主要なデータソースとして機能します。 -`pending` スナップショットは、パリティ計算のための凍結された状態を提供するために、 +`scan` スナップショットは、スキャンとパリティ計算のための凍結された状態を提供するために、 `sync` の開始時に作成される一時的なイメージです。 +スキャンを実行し、新しいコンテンツ状態を保存した後、以前の `pending` スナップショットを置き換えます。 + +`pending` スナップショットは、中断された `sync` によって使用されるイメージです。 操作が正常に完了すると、以前の `stable` スナップショットが削除され、 `pending` スナップショットが新しい安定した参照として昇格します。 diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1 index 56425914..35ea8839 100644 --- a/doc/snapraid-ko.1 +++ b/doc/snapraid-ko.1 @@ -131,7 +131,8 @@ SnapRAID는 RAID와 백업 프로그램의 하이브리드로, 두 가지의 장 .PD 0 .IP \(bu 스냅샷 지원이 있는 경우 (Btrfs, ZFS, Bcachefs 및 NTFS에서 사용 가능): -SnapRAID는 데이터 디스크의 동결된 참조를 자동으로 유지할 수 있습니다. +SnapRAID는 지원되는 각 데이터 파일시스템의 독립적인 동결된 참조를 +자동으로 유지할 수 있습니다. 이를 통해 동기화 중이나 동기화 후에 라이브 파일시스템의 파일을 수정하거나 삭제하더라도 복구 프로세스가 일관되고 신뢰할 수 있게 유지됩니다. .PD @@ -1402,9 +1403,9 @@ NAME을 고정된 상태로 유지하는 한, 필요에 따라 마운트 지점 \`sync\`, \`scrub\`, \`check\` 및 \`fix\` 명령어에 파일시스템 스냅샷 사용을 활성화합니다. .PP -활성화되면 SnapRAID는 \`sync\` 시작 시 데이터의 읽기 전용 스냅샷을 생성합니다. -이는 파일의 일관된 특정 시점 뷰를 보장하여 동시 파일 수정으로 인해 발생하는 -오류를 방지합니다. +활성화되면 SnapRAID는 \`sync\` 시작 시 지원되는 각 데이터 파일시스템의 +읽기 전용 스냅샷을 생성합니다. 이는 각 파일시스템의 안정적인 뷰를 제공하여, +이후의 수정으로 인해 패리티 계산에 사용되는 데이터가 변경되는 것을 방지합니다. .PP 이는 복구 가능성을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도 스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 패리티가 \[dq]깨지는\[dq] 것을 방지하여, @@ -1760,8 +1761,9 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .PD .RE .SH 스냅샷 (SNAPSHOTS) -구성에서 스냅샷 옵션이 활성화된 경우, SnapRAID는 원자적이고 -일관된 작업을 보장하기 위해 파일시스템 스냅샷 기능을 이용합니다. +구성에서 스냅샷 옵션이 활성화된 경우, SnapRAID는 작업 중에 읽은 데이터를 +안정적으로 유지하기 위해 파일시스템 스냅샷을 사용하며, 이는 라이브 파일시스템의 +파일이 이후에 수정되거나 삭제되는 경우에도 마찬가지입니다. .PP 스냅샷 관리는 완전히 자동적이고 투명하게 이루어집니다. 백그라운드에서 완전히 처리되는 스냅샷의 추가적인 보호와 함께, @@ -1773,8 +1775,8 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .HP 4 .I 일관성 장시간 실행되는 sync 또는 scrub 중에 라이브 파일시스템에서 수정된 파일은 -SnapRAID가 동결된 시점의 이미지를 보기 때문에 패리티 불일치나 작업 중단을 -유발하지 않습니다. +스냅샷이 생성된 각 파일시스템이 작업 기간 동안 변경되지 않고 유지되므로 +패리티 불일치나 작업 중단을 유발하지 않습니다. .HP 4 .I 복구 라이브 파일시스템에서 파일이 업데이트되거나 삭제되더라도 스냅샷에 보존됩니다. @@ -1808,11 +1810,11 @@ SnapRAID는 이전 패리티 계산의 스냅샷과 현재 스냅샷 모두에 스냅샷 생성 및 삭제에는 관리자 권한이 필요합니다. 스냅샷이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오. .SS 스냅샷 사용 시 명령어 동작 (Command Behavior with Snapshots) -\`sync\` 와 \`scrub\` 명령어는 모두 일관되고 동결된 상태에 대해 모든 데이터 작업이 수행되도록 -보장하기 위해 스냅샷에서만 독점적으로 작동합니다. 이러한 스냅샷을 이용함으로써 SnapRAID는 -라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 패리티 불일치를 방지합니다. -\`sync\` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 패리티 계산을 위한 -현재 상태를 캡처합니다. +\`sync\` 및 \`scrub\` 명령어는 파일시스템이 스냅샷을 지원하는 데이터 디스크에 대해 +스냅샷을 사용합니다. 스냅샷이 생성된 디스크에서 명령어는 라이브 파일시스템의 +동시 변경에 영향을 받지 않는 안정적인 파일시스템 이미지를 봅니다. +\`sync\` 중에 지원되는 각 데이터 파일시스템에 대해 독립적으로 새 스냅샷이 생성됩니다. +이러한 스냅샷은 집합적으로 패리티 계산에 사용되는 데이터를 제공합니다. 반면에 \`scrub\` 명령어는 기존 패리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해 가장 최근 동기화 중에 생성된 마지막 스냅샷을 이용합니다. .PP @@ -1833,7 +1835,7 @@ SnapRAID는 이전 패리티 계산의 스냅샷과 현재 스냅샷 모두에 다른 모든 명령어는 라이브 파일시스템에서만 독점적으로 작동합니다. .SH 스냅샷 수명 주기 (SNAPSHOTS LIFECYCLE) SnapRAID는 각 데이터 하위 볼륨의 루트에 있는 숨겨진 디렉터리 내에서 -\`stable\`(안정)과 \`pending\`(보류)이라는 두 가지 특정 스냅샷을 관리합니다. +\`stable\`(안정), \`pending\`(보류) 및 \`scan\`(스캔)이라는 세 가지 특정 스냅샷을 관리합니다. Btrfs, Bcachefs 및 NTFS에서는 \`.snapraid/\` 디렉터리가 사용되며, ZFS에서는 표준 \`.zfs/snapshot/\` 이 사용됩니다. .PP @@ -1841,8 +1843,11 @@ ZFS에서는 표준 \`.zfs/snapshot/\` 이 사용됩니다. 현재 패리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 \`scrub\`, \`check\` 및 \`fix\` 명령어의 기본 데이터 소스 역할을 합니다. .PP -\`pending\` 스냅샷은 패리티 계산을 위한 동결된 상태를 제공하기 위해 \`sync\` 시작 시 +\`scan\` 스냅샷은 검사 및 패리티 계산을 위한 동결된 상태를 제공하기 위해 \`sync\` 시작 시 생성되는 임시 이미지입니다. +검사를 수행하고 새 콘텐츠 상태를 저장한 후 이전 \`pending\` 스냅샷을 대체합니다. +.PP +\`pending\` 스냅샷은 중단된 \`sync\` 에서 사용하는 이미지입니다. 작업이 성공적으로 완료되면 이전의 \`stable\` 스냅샷은 삭제되고, \`pending\` 스냅샷이 새로운 안정적인 참조로 자리를 잡도록 승격됩니다. .PP diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d index 21e5ab25..3c88e897 100644 --- a/doc/snapraid-ko.d +++ b/doc/snapraid-ko.d @@ -64,7 +64,8 @@ Name{number} 옵션의 사용 여부에 따라 달라집니다. * 스냅샷 지원이 있는 경우 (Btrfs, ZFS, Bcachefs 및 NTFS에서 사용 가능): - SnapRAID는 데이터 디스크의 동결된 참조를 자동으로 유지할 수 있습니다. + SnapRAID는 지원되는 각 데이터 파일시스템의 독립적인 동결된 참조를 + 자동으로 유지할 수 있습니다. 이를 통해 동기화 중이나 동기화 후에 라이브 파일시스템의 파일을 수정하거나 삭제하더라도 복구 프로세스가 일관되고 신뢰할 수 있게 유지됩니다. @@ -1118,9 +1119,9 @@ Name{number} `sync`, `scrub`, `check` 및 `fix` 명령어에 파일시스템 스냅샷 사용을 활성화합니다. - 활성화되면 SnapRAID는 `sync` 시작 시 데이터의 읽기 전용 스냅샷을 생성합니다. - 이는 파일의 일관된 특정 시점 뷰를 보장하여 동시 파일 수정으로 인해 발생하는 - 오류를 방지합니다. + 활성화되면 SnapRAID는 `sync` 시작 시 지원되는 각 데이터 파일시스템의 + 읽기 전용 스냅샷을 생성합니다. 이는 각 파일시스템의 안정적인 뷰를 제공하여, + 이후의 수정으로 인해 패리티 계산에 사용되는 데이터가 변경되는 것을 방지합니다. 이는 복구 가능성을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도 스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 패리티가 "깨지는" 것을 방지하여, @@ -1375,8 +1376,9 @@ Name{number} :smartctl 2-parity -d areca,2/1 /dev/arcmsr0 스냅샷 (Snapshots) - 구성에서 스냅샷 옵션이 활성화된 경우, SnapRAID는 원자적이고 - 일관된 작업을 보장하기 위해 파일시스템 스냅샷 기능을 이용합니다. + 구성에서 스냅샷 옵션이 활성화된 경우, SnapRAID는 작업 중에 읽은 데이터를 + 안정적으로 유지하기 위해 파일시스템 스냅샷을 사용하며, 이는 라이브 파일시스템의 + 파일이 이후에 수정되거나 삭제되는 경우에도 마찬가지입니다. 스냅샷 관리는 완전히 자동적이고 투명하게 이루어집니다. 백그라운드에서 완전히 처리되는 스냅샷의 추가적인 보호와 함께, @@ -1385,8 +1387,8 @@ Name{number} 이것은 두 가지 주요 이점을 제공합니다. 일관성 - 장시간 실행되는 sync 또는 scrub 중에 라이브 파일시스템에서 수정된 파일은 - SnapRAID가 동결된 시점의 이미지를 보기 때문에 패리티 불일치나 작업 중단을 - 유발하지 않습니다. + 스냅샷이 생성된 각 파일시스템이 작업 기간 동안 변경되지 않고 유지되므로 + 패리티 불일치나 작업 중단을 유발하지 않습니다. 복구 - 라이브 파일시스템에서 파일이 업데이트되거나 삭제되더라도 스냅샷에 보존됩니다. 다음 sync가 실행되기 전에 디스크 고장이 발생하면, SnapRAID는 스냅샷에 보존된 데이터를 사용하여 고장 난 디스크를 재구성합니다. @@ -1411,11 +1413,11 @@ Name{number} 스냅샷이 활성화된 경우 SnapRAID가 필요한 권한(예: sudo)으로 실행되는지 확인하십시오. 스냅샷 사용 시 명령어 동작 (Command Behavior with Snapshots) - `sync` 와 `scrub` 명령어는 모두 일관되고 동결된 상태에 대해 모든 데이터 작업이 수행되도록 - 보장하기 위해 스냅샷에서만 독점적으로 작동합니다. 이러한 스냅샷을 이용함으로써 SnapRAID는 - 라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 패리티 불일치를 방지합니다. - `sync` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 패리티 계산을 위한 - 현재 상태를 캡처합니다. + `sync` 및 `scrub` 명령어는 파일시스템이 스냅샷을 지원하는 데이터 디스크에 대해 + 스냅샷을 사용합니다. 스냅샷이 생성된 디스크에서 명령어는 라이브 파일시스템의 + 동시 변경에 영향을 받지 않는 안정적인 파일시스템 이미지를 봅니다. + `sync` 중에 지원되는 각 데이터 파일시스템에 대해 독립적으로 새 스냅샷이 생성됩니다. + 이러한 스냅샷은 집합적으로 패리티 계산에 사용되는 데이터를 제공합니다. 반면에 `scrub` 명령어는 기존 패리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해 가장 최근 동기화 중에 생성된 마지막 스냅샷을 이용합니다. @@ -1437,7 +1439,7 @@ Name{number} 스냅샷 수명 주기 (Snapshots Lifecycle) SnapRAID는 각 데이터 하위 볼륨의 루트에 있는 숨겨진 디렉터리 내에서 - `stable`(안정)과 `pending`(보류)이라는 두 가지 특정 스냅샷을 관리합니다. + `stable`(안정), `pending`(보류) 및 `scan`(스캔)이라는 세 가지 특정 스냅샷을 관리합니다. Btrfs, Bcachefs 및 NTFS에서는 `.snapraid/` 디렉터리가 사용되며, ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다. @@ -1445,8 +1447,11 @@ Name{number} 현재 패리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 `scrub`, `check` 및 `fix` 명령어의 기본 데이터 소스 역할을 합니다. - `pending` 스냅샷은 패리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 + `scan` 스냅샷은 검사 및 패리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 생성되는 임시 이미지입니다. + 검사를 수행하고 새 콘텐츠 상태를 저장한 후 이전 `pending` 스냅샷을 대체합니다. + + `pending` 스냅샷은 중단된 `sync` 에서 사용하는 이미지입니다. 작업이 성공적으로 완료되면 이전의 `stable` 스냅샷은 삭제되고, `pending` 스냅샷이 새로운 안정적인 참조로 자리를 잡도록 승격됩니다. diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt index 81c375b6..ea003165 100644 --- a/doc/snapraid-ko.txt +++ b/doc/snapraid-ko.txt @@ -74,7 +74,8 @@ SnapRAID는 RAID와 백업 프로그램의 하이브리드로, 두 가지의 장 옵션의 사용 여부에 따라 달라집니다. * 스냅샷 지원이 있는 경우 (Btrfs, ZFS, Bcachefs 및 NTFS에서 사용 가능): - SnapRAID는 데이터 디스크의 동결된 참조를 자동으로 유지할 수 있습니다. + SnapRAID는 지원되는 각 데이터 파일시스템의 독립적인 동결된 참조를 + 자동으로 유지할 수 있습니다. 이를 통해 동기화 중이나 동기화 후에 라이브 파일시스템의 파일을 수정하거나 삭제하더라도 복구 프로세스가 일관되고 신뢰할 수 있게 유지됩니다. @@ -1196,9 +1197,9 @@ NAME을 고정된 상태로 유지하는 한, 필요에 따라 마운트 지점 `sync`, `scrub`, `check` 및 `fix` 명령어에 파일시스템 스냅샷 사용을 활성화합니다. -활성화되면 SnapRAID는 `sync` 시작 시 데이터의 읽기 전용 스냅샷을 생성합니다. -이는 파일의 일관된 특정 시점 뷰를 보장하여 동시 파일 수정으로 인해 발생하는 -오류를 방지합니다. +활성화되면 SnapRAID는 `sync` 시작 시 지원되는 각 데이터 파일시스템의 +읽기 전용 스냅샷을 생성합니다. 이는 각 파일시스템의 안정적인 뷰를 제공하여, +이후의 수정으로 인해 패리티 계산에 사용되는 데이터가 변경되는 것을 방지합니다. 이는 복구 가능성을 크게 향상시킵니다. 라이브 파일시스템에서 파일이 삭제되더라도 스냅샷에 그대로 보존됩니다. 이를 통해 해당 블록의 패리티가 "깨지는" 것을 방지하여, @@ -1480,8 +1481,9 @@ Windows의 일반적인 설정 예는 다음과 같습니다: 8 스냅샷 (SNAPSHOTS) ================= -구성에서 스냅샷 옵션이 활성화된 경우, SnapRAID는 원자적이고 -일관된 작업을 보장하기 위해 파일시스템 스냅샷 기능을 이용합니다. +구성에서 스냅샷 옵션이 활성화된 경우, SnapRAID는 작업 중에 읽은 데이터를 +안정적으로 유지하기 위해 파일시스템 스냅샷을 사용하며, 이는 라이브 파일시스템의 +파일이 이후에 수정되거나 삭제되는 경우에도 마찬가지입니다. 스냅샷 관리는 완전히 자동적이고 투명하게 이루어집니다. 백그라운드에서 완전히 처리되는 스냅샷의 추가적인 보호와 함께, @@ -1490,8 +1492,8 @@ Windows의 일반적인 설정 예는 다음과 같습니다: 이것은 두 가지 주요 이점을 제공합니다. 일관성 - 장시간 실행되는 sync 또는 scrub 중에 라이브 파일시스템에서 수정된 파일은 - SnapRAID가 동결된 시점의 이미지를 보기 때문에 패리티 불일치나 작업 중단을 - 유발하지 않습니다. + 스냅샷이 생성된 각 파일시스템이 작업 기간 동안 변경되지 않고 유지되므로 + 패리티 불일치나 작업 중단을 유발하지 않습니다. 복구 - 라이브 파일시스템에서 파일이 업데이트되거나 삭제되더라도 스냅샷에 보존됩니다. 다음 sync가 실행되기 전에 디스크 고장이 발생하면, SnapRAID는 스냅샷에 보존된 데이터를 사용하여 고장 난 디스크를 재구성합니다. @@ -1518,11 +1520,11 @@ Windows의 일반적인 설정 예는 다음과 같습니다: 8.1 스냅샷 사용 시 명령어 동작 (Command Behavior with Snapshots) ----------------------------------------------------- -`sync` 와 `scrub` 명령어는 모두 일관되고 동결된 상태에 대해 모든 데이터 작업이 수행되도록 -보장하기 위해 스냅샷에서만 독점적으로 작동합니다. 이러한 스냅샷을 이용함으로써 SnapRAID는 -라이브 파일시스템의 동시 파일 수정으로 인해 발생할 수 있는 패리티 불일치를 방지합니다. -`sync` 중에 명령어는 프로세스 시작 시 생성된 새 스냅샷을 사용하여 패리티 계산을 위한 -현재 상태를 캡처합니다. +`sync` 및 `scrub` 명령어는 파일시스템이 스냅샷을 지원하는 데이터 디스크에 대해 +스냅샷을 사용합니다. 스냅샷이 생성된 디스크에서 명령어는 라이브 파일시스템의 +동시 변경에 영향을 받지 않는 안정적인 파일시스템 이미지를 봅니다. +`sync` 중에 지원되는 각 데이터 파일시스템에 대해 독립적으로 새 스냅샷이 생성됩니다. +이러한 스냅샷은 집합적으로 패리티 계산에 사용되는 데이터를 제공합니다. 반면에 `scrub` 명령어는 기존 패리티와 일치하는 신뢰할 수 있는 참조 지점을 유지하기 위해 가장 최근 동기화 중에 생성된 마지막 스냅샷을 이용합니다. @@ -1547,7 +1549,7 @@ Windows의 일반적인 설정 예는 다음과 같습니다: ================================= SnapRAID는 각 데이터 하위 볼륨의 루트에 있는 숨겨진 디렉터리 내에서 -`stable`(안정)과 `pending`(보류)이라는 두 가지 특정 스냅샷을 관리합니다. +`stable`(안정), `pending`(보류) 및 `scan`(스캔)이라는 세 가지 특정 스냅샷을 관리합니다. Btrfs, Bcachefs 및 NTFS에서는 `.snapraid/` 디렉터리가 사용되며, ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다. @@ -1555,8 +1557,11 @@ ZFS에서는 표준 `.zfs/snapshot/` 이 사용됩니다. 현재 패리티를 계산하는 데 사용된 정확한 데이터를 포함합니다. 이는 `scrub`, `check` 및 `fix` 명령어의 기본 데이터 소스 역할을 합니다. -`pending` 스냅샷은 패리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 +`scan` 스냅샷은 검사 및 패리티 계산을 위한 동결된 상태를 제공하기 위해 `sync` 시작 시 생성되는 임시 이미지입니다. +검사를 수행하고 새 콘텐츠 상태를 저장한 후 이전 `pending` 스냅샷을 대체합니다. + +`pending` 스냅샷은 중단된 `sync` 에서 사용하는 이미지입니다. 작업이 성공적으로 완료되면 이전의 `stable` 스냅샷은 삭제되고, `pending` 스냅샷이 새로운 안정적인 참조로 자리를 잡도록 승격됩니다. diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1 index 1afcfda4..5c0f5683 100644 --- a/doc/snapraid-pl.1 +++ b/doc/snapraid-pl.1 @@ -132,7 +132,8 @@ 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. +SnapRAID może automatycznie utrzymywać niezależny, zamrożony punkt +odniesienia dla każdego obsługiwanego systemu plikó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 @@ -1441,9 +1442,10 @@ dyski, ponieważ oczekuje się, że będą one zawsze w ruchu. 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. +Po włączeniu, SnapRAID tworzy migawkę w trybie tylko do odczytu dla każdego +obsługiwanego systemu plików z danymi na początku operacji \'sync\'. Zapewnia to +stabilny obraz każdego systemu plików, zapobiegając sytuacji, w której późniejsze +modyfikacje zmieniłyby dane użyte do obliczenia parzystości. .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] @@ -1808,8 +1810,9 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .RE .SH MIGAWKI (SNAPSHOTS) Jeśli opcja snapshot jest włączona w konfiguracji, SnapRAID -wykorzystuje funkcjonalność migawek systemu plików w celu zapewnienia operacji atomowych -i spójnych. +używa migawek systemu plików, aby utrzymać stabilność danych odczytywanych +podczas operacji, nawet jeśli pliki w aktywnych systemach plików zostaną +później zmodyfikowane lub usunięte. .PP Zarządzanie migawkami jest całkowicie automatyczne i przejrzyste. Możesz nadal używać SnapRAID dokładnie tak jak dotychczas, z dodatkową @@ -1823,7 +1826,8 @@ Zapewnia to dwie główne korzyści: .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. +operacji, ponieważ każdy objęty migawką system plików pozostaje niezmieniony +przez cały czas trwania operacji. .HP 4 .I Odzyskiwanie Jeśli plik zostanie zaktualizowany lub usunięty z aktywnego systemu plików, @@ -1866,12 +1870,13 @@ 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. +Polecenia \`sync\` oraz \`scrub\` używają migawek dla dysków z danymi, których +systemy plików je obsługują. Na dysku objętym migawką polecenie widzi stabilny +obraz systemu plików, na który nie mają wpływu równoczesne zmiany w aktywnym +systemie plików. +Podczas operacji \`sync\` nowa migawka jest tworzona niezależnie dla każdego +obsługiwanego systemu plików z danymi. Migawki te łącznie dostarczają dane +używane 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. @@ -1896,7 +1901,7 @@ aktywnych systemów plików. .PP Wszystkie inne polecenia działają wyłącznie na aktywnym systemie plików. .SH CYKL żYCIA MIGAWEK (SNAPSHOTS LIFECYCLE) -SnapRAID zarządza dwoma określonymi migawkami, \`stable\` (stabilną) oraz \`pending\` (oczekującą), +SnapRAID zarządza trzema określonymi migawkami, \`stable\` (stabilną), \`pending\` (oczekującą) oraz \`scan\` (skanowania), 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/\`. @@ -1906,8 +1911,12 @@ 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. +Migawka \`scan\` to tymczasowy obraz tworzony na początku +operacji \`sync\` w celu zapewnienia zamrożonego stanu do skanowania i obliczenia parzystości. +Po zeskanowaniu i zapisaniu nowego stanu zawartości zastępuje ona poprzednią +migawkę \`pending\`. +.PP +Migawka \`pending\` to obraz używany przez przerwaną operację \`sync\`. Po pomyślnym zakończeniu operacji poprzednia migawka \`stable\` jest usuwana, a migawka \`pending\` zostaje podniesiona do rangi nowej stabilnej referencji. diff --git a/doc/snapraid-pl.d b/doc/snapraid-pl.d index 94185e0f..cec0af05 100644 --- a/doc/snapraid-pl.d +++ b/doc/snapraid-pl.d @@ -65,7 +65,8 @@ Ograniczenia (Limitations) 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. + SnapRAID może automatycznie utrzymywać niezależny, zamrożony punkt + odniesienia dla każdego obsługiwanego systemu plikó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. @@ -1157,9 +1158,10 @@ Konfiguracja (Configuration) 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. + Po włączeniu, SnapRAID tworzy migawkę w trybie tylko do odczytu dla każdego + obsługiwanego systemu plików z danymi na początku operacji 'sync'. Zapewnia to + stabilny obraz każdego systemu plików, zapobiegając sytuacji, w której późniejsze + modyfikacje zmieniłyby dane użyte do obliczenia parzystości. 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" @@ -1423,8 +1425,9 @@ Konfiguracja (Configuration) Migawki (Snapshots) Jeśli opcja snapshot jest włączona w konfiguracji, SnapRAID - wykorzystuje funkcjonalność migawek systemu plików w celu zapewnienia operacji atomowych - i spójnych. + używa migawek systemu plików, aby utrzymać stabilność danych odczytywanych + podczas operacji, nawet jeśli pliki w aktywnych systemach plików zostaną + później zmodyfikowane lub usunięte. Zarządzanie migawkami jest całkowicie automatyczne i przejrzyste. Możesz nadal używać SnapRAID dokładnie tak jak dotychczas, z dodatkową @@ -1435,7 +1438,8 @@ Migawki (Snapshots) 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. + operacji, ponieważ każdy objęty migawką system plików pozostaje niezmieniony + przez cały czas trwania operacji. 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 @@ -1469,12 +1473,13 @@ Migawki (Snapshots) 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. + Polecenia `sync` oraz `scrub` używają migawek dla dysków z danymi, których + systemy plików je obsługują. Na dysku objętym migawką polecenie widzi stabilny + obraz systemu plików, na który nie mają wpływu równoczesne zmiany w aktywnym + systemie plików. + Podczas operacji `sync` nowa migawka jest tworzona niezależnie dla każdego + obsługiwanego systemu plików z danymi. Migawki te łącznie dostarczają dane + używane 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. @@ -1500,7 +1505,7 @@ Migawki (Snapshots) Wszystkie inne polecenia działają wyłącznie na aktywnym systemie plików. Cykl życia migawek (Snapshots Lifecycle) - SnapRAID zarządza dwoma określonymi migawkami, `stable` (stabilną) oraz `pending` (oczekującą), + SnapRAID zarządza trzema określonymi migawkami, `stable` (stabilną), `pending` (oczekującą) oraz `scan` (skanowania), 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/`. @@ -1510,8 +1515,12 @@ Cykl życia migawek (Snapshots Lifecycle) 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. + Migawka `scan` to tymczasowy obraz tworzony na początku + operacji `sync` w celu zapewnienia zamrożonego stanu do skanowania i obliczenia parzystości. + Po zeskanowaniu i zapisaniu nowego stanu zawartości zastępuje ona poprzednią + migawkę `pending`. + + Migawka `pending` to obraz używany przez przerwaną operację `sync`. Po pomyślnym zakończeniu operacji poprzednia migawka `stable` jest usuwana, a migawka `pending` zostaje podniesiona do rangi nowej stabilnej referencji. diff --git a/doc/snapraid-pl.txt b/doc/snapraid-pl.txt index 6b705df4..9b520ae7 100644 --- a/doc/snapraid-pl.txt +++ b/doc/snapraid-pl.txt @@ -75,7 +75,8 @@ W przypadku danych, które już istniały podczas ostatniej synchronizacji, niez 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. + SnapRAID może automatycznie utrzymywać niezależny, zamrożony punkt + odniesienia dla każdego obsługiwanego systemu plikó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. @@ -1235,9 +1236,10 @@ dyski, ponieważ oczekuje się, że będą one zawsze w ruchu. 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. +Po włączeniu, SnapRAID tworzy migawkę w trybie tylko do odczytu dla każdego +obsługiwanego systemu plików z danymi na początku operacji 'sync'. Zapewnia to +stabilny obraz każdego systemu plików, zapobiegając sytuacji, w której późniejsze +modyfikacje zmieniłyby dane użyte do obliczenia parzystości. 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" @@ -1528,8 +1530,9 @@ Przykład typowej konfiguracji dla systemu Windows: ===================== Jeśli opcja snapshot jest włączona w konfiguracji, SnapRAID -wykorzystuje funkcjonalność migawek systemu plików w celu zapewnienia operacji atomowych -i spójnych. +używa migawek systemu plików, aby utrzymać stabilność danych odczytywanych +podczas operacji, nawet jeśli pliki w aktywnych systemach plików zostaną +później zmodyfikowane lub usunięte. Zarządzanie migawkami jest całkowicie automatyczne i przejrzyste. Możesz nadal używać SnapRAID dokładnie tak jak dotychczas, z dodatkową @@ -1540,7 +1543,8 @@ 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. + operacji, ponieważ każdy objęty migawką system plików pozostaje niezmieniony + przez cały czas trwania operacji. 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 @@ -1576,12 +1580,13 @@ 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. +Polecenia `sync` oraz `scrub` używają migawek dla dysków z danymi, których +systemy plików je obsługują. Na dysku objętym migawką polecenie widzi stabilny +obraz systemu plików, na który nie mają wpływu równoczesne zmiany w aktywnym +systemie plików. +Podczas operacji `sync` nowa migawka jest tworzona niezależnie dla każdego +obsługiwanego systemu plików z danymi. Migawki te łącznie dostarczają dane +używane 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. @@ -1610,7 +1615,7 @@ Wszystkie inne polecenia działają wyłącznie na aktywnym systemie plików. 9 CYKL żYCIA MIGAWEK (SNAPSHOTS LIFECYCLE) ========================================== -SnapRAID zarządza dwoma określonymi migawkami, `stable` (stabilną) oraz `pending` (oczekującą), +SnapRAID zarządza trzema określonymi migawkami, `stable` (stabilną), `pending` (oczekującą) oraz `scan` (skanowania), 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/`. @@ -1620,8 +1625,12 @@ 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. +Migawka `scan` to tymczasowy obraz tworzony na początku +operacji `sync` w celu zapewnienia zamrożonego stanu do skanowania i obliczenia parzystości. +Po zeskanowaniu i zapisaniu nowego stanu zawartości zastępuje ona poprzednią +migawkę `pending`. + +Migawka `pending` to obraz używany przez przerwaną operację `sync`. Po pomyślnym zakończeniu operacji poprzednia migawka `stable` jest usuwana, a migawka `pending` zostaje podniesiona do rangi nowej stabilnej referencji. diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1 index a86d2c26..df59566a 100644 --- a/doc/snapraid-pt.1 +++ b/doc/snapraid-pt.1 @@ -133,7 +133,8 @@ 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. +o SnapRAID pode manter automaticamente uma referência congelada +independente de cada sistema de arquivos de dados suportado. Isso garante que, mesmo que modifique ou exclua arquivos no seu sistema de arquivos ativo durante ou após uma sincronização, o processo de recuperação permanece consistente e confiável. .PD @@ -1470,9 +1471,10 @@ porque se espera que estejam sempre girando. Ativa o uso de instantâneos (snapshots) do sistema de arquivos para os comandos \`sync\`, \`scrub\`, \`check\` e \`fix\`. .PP -Quando ativado, o SnapRAID cria um instantâneo de somente leitura dos seus dados no -início de um \'sync\'. Isso garante uma visão consistente e num ponto específico no tempo dos seus -arquivos, prevenindo erros causados por modificações concorrentes de arquivos. +Quando ativado, o SnapRAID cria um instantâneo de somente leitura de cada +sistema de arquivos de dados suportado no início de um \'sync\'. Isso fornece uma visão +estável de cada sistema de arquivos, evitando que modificações posteriores alterem os +dados utilizados para o cálculo da paridade. .PP Isso melhora significativamente a recuperação: se um arquivo for excluído do sistema de arquivos ativo, ele permanece preservado no instantâneo. Isso evita que a paridade fique \[dq]corrompida\[dq] @@ -1845,8 +1847,9 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .RE .SH INSTANTâNEOS (SNAPSHOTS) Se a opção de instantâneo estiver ativada na configuração, o SnapRAID -utiliza a funcionalidade de instantâneos do sistema de arquivos para garantir operações atômicas -e consistentes. +utiliza instantâneos do sistema de arquivos para manter estáveis os dados lidos +durante uma operação, mesmo quando arquivos nos sistemas de arquivos ativos +são posteriormente modificados ou excluídos. .PP A gestão de instantâneos é completamente automática e transparente. Pode continuar a utilizar o SnapRAID exatamente como antes, com a @@ -1860,7 +1863,8 @@ Isso proporciona dois benefícios principais: .I Consistência Arquivos modificados no sistema de arquivos 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. +porque cada sistema de arquivos com instantâneo permanece inalterado durante +toda a operação. .HP 4 .I Recuperação Se um arquivo for atualizado ou excluído do sistema de arquivos ativo, @@ -1903,12 +1907,13 @@ A criação e exclusã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 esses instantâneos, o SnapRAID previne divergências de paridade -que, de outra forma, seriam despoletadas por modificações concorrentes de arquivos no sistema de arquivos 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. +Os comandos \`sync\` e \`scrub\` utilizam instantâneos para discos de dados cujos +sistemas de arquivos os suportam. Num disco com instantâneo, o comando vê +uma imagem estável do sistema de arquivos não afetada por alterações simultâneas no +sistema de arquivos ativo. +Durante um \`sync\`, um novo instantâneo é criado independentemente para cada +sistema de arquivos de dados suportado. Esses instantâneos fornecem coletivamente os +dados utilizados para o cálculo 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. @@ -1933,7 +1938,7 @@ de arquivos ativos exclusivamente. .PP Todos os outros comandos operam exclusivamente no sistema de arquivos ativo. .SH CICLO DE VIDA DOS INSTANTâNEOS (SNAPSHOTS LIFECYCLE) -O SnapRAID gerencia dois instantâneos específicos, \`stable\` (estável) e \`pending\` (pendente), +O SnapRAID gerencia três instantâneos específicos, \`stable\` (estável), \`pending\` (pendente) e \`scan\` (verificação), 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/\`. @@ -1943,8 +1948,12 @@ O instantâneo \`stable\` representa o estado do último 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. +O instantâneo \`scan\` é uma imagem temporária criada ao início +de um \`sync\` para fornecer um estado congelado para a verificação e a computação da paridade. +Após a verificação e salvamento do novo estado de conteúdo, ele substitui o instantâneo +\`pending\` anterior. +.PP +O instantâneo \`pending\` é a imagem usada por um \`sync\` interrompido. Após a conclusão bem\-sucedida da operação, o instantâneo \`stable\` anterior é excluído, e o instantâneo \`pending\` é promovido para tomar o seu lugar como a nova referência estável. diff --git a/doc/snapraid-pt.d b/doc/snapraid-pt.d index 1714badc..2177f7df 100644 --- a/doc/snapraid-pt.d +++ b/doc/snapraid-pt.d @@ -66,7 +66,8 @@ Limitações (Limitations) 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. + o SnapRAID pode manter automaticamente uma referência congelada + independente de cada sistema de arquivos de dados suportado. Isso garante que, mesmo que modifique ou exclua arquivos no seu sistema de arquivos ativo durante ou após uma sincronização, o processo de recuperação permanece consistente e confiável. @@ -1186,9 +1187,10 @@ Configuração (Configuration) Ativa o uso de instantâneos (snapshots) do sistema de arquivos para os comandos `sync`, `scrub`, `check` e `fix`. - Quando ativado, o SnapRAID cria um instantâneo de somente leitura dos seus dados no - início de um 'sync'. Isso garante uma visão consistente e num ponto específico no tempo dos seus - arquivos, prevenindo erros causados por modificações concorrentes de arquivos. + Quando ativado, o SnapRAID cria um instantâneo de somente leitura de cada + sistema de arquivos de dados suportado no início de um 'sync'. Isso fornece uma visão + estável de cada sistema de arquivos, evitando que modificações posteriores alterem os + dados utilizados para o cálculo da paridade. Isso melhora significativamente a recuperação: se um arquivo for excluído do sistema de arquivos ativo, ele permanece preservado no instantâneo. Isso evita que a paridade fique "corrompida" @@ -1460,8 +1462,9 @@ Configuração (Configuration) Instantâneos (Snapshots) Se a opção de instantâneo estiver ativada na configuração, o SnapRAID - utiliza a funcionalidade de instantâneos do sistema de arquivos para garantir operações atômicas - e consistentes. + utiliza instantâneos do sistema de arquivos para manter estáveis os dados lidos + durante uma operação, mesmo quando arquivos nos sistemas de arquivos ativos + são posteriormente modificados ou excluídos. A gestão de instantâneos é completamente automática e transparente. Pode continuar a utilizar o SnapRAID exatamente como antes, com a @@ -1472,7 +1475,8 @@ Instantâneos (Snapshots) Consistência - Arquivos modificados no sistema de arquivos 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. + porque cada sistema de arquivos com instantâneo permanece inalterado durante + toda a operação. Recuperação - Se um arquivo for atualizado ou excluído do sistema de arquivos 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 @@ -1506,12 +1510,13 @@ Instantâneos (Snapshots) 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 esses instantâneos, o SnapRAID previne divergências de paridade - que, de outra forma, seriam despoletadas por modificações concorrentes de arquivos no sistema de arquivos 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. + Os comandos `sync` e `scrub` utilizam instantâneos para discos de dados cujos + sistemas de arquivos os suportam. Num disco com instantâneo, o comando vê + uma imagem estável do sistema de arquivos não afetada por alterações simultâneas no + sistema de arquivos ativo. + Durante um `sync`, um novo instantâneo é criado independentemente para cada + sistema de arquivos de dados suportado. Esses instantâneos fornecem coletivamente os + dados utilizados para o cálculo 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. @@ -1537,7 +1542,7 @@ Instantâneos (Snapshots) Todos os outros comandos operam exclusivamente no sistema de arquivos ativo. Ciclo de Vida dos Instantâneos (Snapshots Lifecycle) - O SnapRAID gerencia dois instantâneos específicos, `stable` (estável) e `pending` (pendente), + O SnapRAID gerencia três instantâneos específicos, `stable` (estável), `pending` (pendente) e `scan` (verificação), 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/`. @@ -1547,8 +1552,12 @@ Ciclo de Vida dos Instantâneos (Snapshots Lifecycle) 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. + O instantâneo `scan` é uma imagem temporária criada ao início + de um `sync` para fornecer um estado congelado para a verificação e a computação da paridade. + Após a verificação e salvamento do novo estado de conteúdo, ele substitui o instantâneo + `pending` anterior. + + O instantâneo `pending` é a imagem usada por um `sync` interrompido. Após a conclusão bem-sucedida da operação, o instantâneo `stable` anterior é excluído, e o instantâneo `pending` é promovido para tomar o seu lugar como a nova referência estável. diff --git a/doc/snapraid-pt.txt b/doc/snapraid-pt.txt index eaf8a557..07a2231e 100644 --- a/doc/snapraid-pt.txt +++ b/doc/snapraid-pt.txt @@ -76,7 +76,8 @@ Para dados que já existiam na última sincronização, a fiabilidade da recuper 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. + o SnapRAID pode manter automaticamente uma referência congelada + independente de cada sistema de arquivos de dados suportado. Isso garante que, mesmo que modifique ou exclua arquivos no seu sistema de arquivos ativo durante ou após uma sincronização, o processo de recuperação permanece consistente e confiável. @@ -1264,9 +1265,10 @@ porque se espera que estejam sempre girando. Ativa o uso de instantâneos (snapshots) do sistema de arquivos para os comandos `sync`, `scrub`, `check` e `fix`. -Quando ativado, o SnapRAID cria um instantâneo de somente leitura dos seus dados no -início de um 'sync'. Isso garante uma visão consistente e num ponto específico no tempo dos seus -arquivos, prevenindo erros causados por modificações concorrentes de arquivos. +Quando ativado, o SnapRAID cria um instantâneo de somente leitura de cada +sistema de arquivos de dados suportado no início de um 'sync'. Isso fornece uma visão +estável de cada sistema de arquivos, evitando que modificações posteriores alterem os +dados utilizados para o cálculo da paridade. Isso melhora significativamente a recuperação: se um arquivo for excluído do sistema de arquivos ativo, ele permanece preservado no instantâneo. Isso evita que a paridade fique "corrompida" @@ -1565,8 +1567,9 @@ Um exemplo de uma configuração típica para Windows é: ========================== Se a opção de instantâneo estiver ativada na configuração, o SnapRAID -utiliza a funcionalidade de instantâneos do sistema de arquivos para garantir operações atômicas -e consistentes. +utiliza instantâneos do sistema de arquivos para manter estáveis os dados lidos +durante uma operação, mesmo quando arquivos nos sistemas de arquivos ativos +são posteriormente modificados ou excluídos. A gestão de instantâneos é completamente automática e transparente. Pode continuar a utilizar o SnapRAID exatamente como antes, com a @@ -1577,7 +1580,8 @@ Isso proporciona dois benefícios principais: Consistência - Arquivos modificados no sistema de arquivos 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. + porque cada sistema de arquivos com instantâneo permanece inalterado durante + toda a operação. Recuperação - Se um arquivo for atualizado ou excluído do sistema de arquivos 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 @@ -1613,12 +1617,13 @@ 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 esses instantâneos, o SnapRAID previne divergências de paridade -que, de outra forma, seriam despoletadas por modificações concorrentes de arquivos no sistema de arquivos 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. +Os comandos `sync` e `scrub` utilizam instantâneos para discos de dados cujos +sistemas de arquivos os suportam. Num disco com instantâneo, o comando vê +uma imagem estável do sistema de arquivos não afetada por alterações simultâneas no +sistema de arquivos ativo. +Durante um `sync`, um novo instantâneo é criado independentemente para cada +sistema de arquivos de dados suportado. Esses instantâneos fornecem coletivamente os +dados utilizados para o cálculo 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. @@ -1647,7 +1652,7 @@ Todos os outros comandos operam exclusivamente no sistema de arquivos ativo. 9 CICLO DE VIDA DOS INSTANTâNEOS (SNAPSHOTS LIFECYCLE) ====================================================== -O SnapRAID gerencia dois instantâneos específicos, `stable` (estável) e `pending` (pendente), +O SnapRAID gerencia três instantâneos específicos, `stable` (estável), `pending` (pendente) e `scan` (verificação), 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/`. @@ -1657,8 +1662,12 @@ O instantâneo `stable` representa o estado do último 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. +O instantâneo `scan` é uma imagem temporária criada ao início +de um `sync` para fornecer um estado congelado para a verificação e a computação da paridade. +Após a verificação e salvamento do novo estado de conteúdo, ele substitui o instantâneo +`pending` anterior. + +O instantâneo `pending` é a imagem usada por um `sync` interrompido. Após a conclusão bem-sucedida da operação, o instantâneo `stable` anterior é excluído, e o instantâneo `pending` é promovido para tomar o seu lugar como a nova referência estável. diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1 index f7d6e61a..2dce0a0d 100644 --- a/doc/snapraid-ro.1 +++ b/doc/snapraid-ro.1 @@ -133,7 +133,8 @@ 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. +SnapRAID poate menține automat o referință înghețată independentă +a fiecărui sistem de fișiere de date acceptat. 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 @@ -1436,9 +1437,10 @@ Rețineți că astfel de discuri nu sunt afectate de comenzile \`up\` și 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. +Când este activată, SnapRAID creează un snapshot read\-only al fiecărui sistem +de fișiere de date acceptat la începutul unui \'sync\'. Acest lucru oferă o vizualizare +stabilă a fiecărui sistem de fișiere, împiedicând modificările ulterioare să modifice +datele utilizate pentru calculul parității. .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ă” @@ -1806,8 +1808,9 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .RE .SH SNAPSHOT\-URI (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. +utilizează snapshot\-urile sistemului de fișiere pentru a menține stabile datele citite +în timpul unei operațiuni, chiar și atunci când fișierele de pe sistemele de fișiere live +sunt modificate sau șterse ulterior. .PP Gestionarea snapshot\-urilor este complet automată și transparentă. Puteți continua să utilizați SnapRAID exact ca înainte, cu protecția @@ -1821,7 +1824,7 @@ Acest lucru oferă două avantaje principale: .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. +deoarece fiecare sistem de fișiere cu snapshot rămâne neschimbat pe durata operațiunii. .HP 4 .I Recuperare Dacă un fișier este actualizat sau șters din sistemul de fișiere live, @@ -1864,12 +1867,13 @@ 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. +Comenzile \`sync\` și \`scrub\` folosesc snapshot\-uri pentru discurile de date ale căror +sisteme de fișiere le acceptă. Pe un disc cu snapshot, comanda vede o imagine +stabilă a sistemului de fișiere, neafectată de modificările concurente de pe sistemul +de fișiere live. +În timpul unui \`sync\`, un nou snapshot este creat în mod independent pentru fiecare +sistem de fișiere de date acceptat. Aceste snapshot\-uri oferă colectiv datele +utilizate 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ă. @@ -1894,7 +1898,7 @@ sistemele de fișiere live. .PP Toate celelalte comenzi operează exclusiv pe sistemul de fișiere live. .SH CICLUL DE VIAță AL SNAPSHOT\-URILOR (SNAPSHOTS LIFECYCLE) -SnapRAID gestionează două snapshot\-uri specifice, \`stable\` și \`pending\`, +SnapRAID gestionează trei snapshot\-uri specifice, \`stable\`, \`pending\` și \`scan\`, î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/\`. @@ -1904,8 +1908,12 @@ Snapshot\-ul \`stable\` reprezintă starea ultimului 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. +Snapshot\-ul \`scan\` este o imagine temporară creată la începutul +unui \`sync\` pentru a oferi o stare înghețată pentru scanare și calculul parității. +După scanarea și salvarea stării noi de conținut, acesta înlocuiește snapshot\-ul +\`pending\` anterior. +.PP +Snapshot\-ul \`pending\` este imaginea utilizată de un \`sync\` întrerupt. 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ă. diff --git a/doc/snapraid-ro.d b/doc/snapraid-ro.d index a9247729..dabc90e7 100644 --- a/doc/snapraid-ro.d +++ b/doc/snapraid-ro.d @@ -66,7 +66,8 @@ Limitări (Limitations) 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. + SnapRAID poate menține automat o referință înghețată independentă + a fiecărui sistem de fișiere de date acceptat. 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. @@ -1152,9 +1153,10 @@ Configurare (Configuration) 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. + Când este activată, SnapRAID creează un snapshot read-only al fiecărui sistem + de fișiere de date acceptat la începutul unui 'sync'. Acest lucru oferă o vizualizare + stabilă a fiecărui sistem de fișiere, împiedicând modificările ulterioare să modifice + datele utilizate pentru calculul parității. 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ă” @@ -1421,8 +1423,9 @@ Configurare (Configuration) Snapshot-uri (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. + utilizează snapshot-urile sistemului de fișiere pentru a menține stabile datele citite + în timpul unei operațiuni, chiar și atunci când fișierele de pe sistemele de fișiere live + sunt modificate sau șterse ulterior. Gestionarea snapshot-urilor este complet automată și transparentă. Puteți continua să utilizați SnapRAID exact ca înainte, cu protecția @@ -1433,7 +1436,7 @@ Snapshot-uri (Snapshots) 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. + deoarece fiecare sistem de fișiere cu snapshot rămâne neschimbat pe durata operațiunii. 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 @@ -1467,12 +1470,13 @@ Snapshot-uri (Snapshots) 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. + Comenzile `sync` și `scrub` folosesc snapshot-uri pentru discurile de date ale căror + sisteme de fișiere le acceptă. Pe un disc cu snapshot, comanda vede o imagine + stabilă a sistemului de fișiere, neafectată de modificările concurente de pe sistemul + de fișiere live. + În timpul unui `sync`, un nou snapshot este creat în mod independent pentru fiecare + sistem de fișiere de date acceptat. Aceste snapshot-uri oferă colectiv datele + utilizate 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ă. @@ -1498,7 +1502,7 @@ Snapshot-uri (Snapshots) Toate celelalte comenzi operează exclusiv pe sistemul de fișiere live. Ciclul de viață al snapshot-urilor (Snapshots Lifecycle) - SnapRAID gestionează două snapshot-uri specifice, `stable` și `pending`, + SnapRAID gestionează trei snapshot-uri specifice, `stable`, `pending` și `scan`, î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/`. @@ -1508,8 +1512,12 @@ Ciclul de viață al snapshot-urilor (Snapshots Lifecycle) 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. + Snapshot-ul `scan` este o imagine temporară creată la începutul + unui `sync` pentru a oferi o stare înghețată pentru scanare și calculul parității. + După scanarea și salvarea stării noi de conținut, acesta înlocuiește snapshot-ul + `pending` anterior. + + Snapshot-ul `pending` este imaginea utilizată de un `sync` întrerupt. 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ă. diff --git a/doc/snapraid-ro.txt b/doc/snapraid-ro.txt index 8ea6f639..9c2420e1 100644 --- a/doc/snapraid-ro.txt +++ b/doc/snapraid-ro.txt @@ -76,7 +76,8 @@ Pentru datele care existau deja la ultima sincronizare, fiabilitatea recuperări 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. + SnapRAID poate menține automat o referință înghețată independentă + a fiecărui sistem de fișiere de date acceptat. 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. @@ -1230,9 +1231,10 @@ Rețineți că astfel de discuri nu sunt afectate de comenzile `up` și 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. +Când este activată, SnapRAID creează un snapshot read-only al fiecărui sistem +de fișiere de date acceptat la începutul unui 'sync'. Acest lucru oferă o vizualizare +stabilă a fiecărui sistem de fișiere, împiedicând modificările ulterioare să modifice +datele utilizate pentru calculul parității. 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ă” @@ -1526,8 +1528,9 @@ Un exemplu de configurare tipică pentru Windows este: ========================== 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. +utilizează snapshot-urile sistemului de fișiere pentru a menține stabile datele citite +în timpul unei operațiuni, chiar și atunci când fișierele de pe sistemele de fișiere live +sunt modificate sau șterse ulterior. Gestionarea snapshot-urilor este complet automată și transparentă. Puteți continua să utilizați SnapRAID exact ca înainte, cu protecția @@ -1538,7 +1541,7 @@ 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. + deoarece fiecare sistem de fișiere cu snapshot rămâne neschimbat pe durata operațiunii. 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 @@ -1574,12 +1577,13 @@ 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. +Comenzile `sync` și `scrub` folosesc snapshot-uri pentru discurile de date ale căror +sisteme de fișiere le acceptă. Pe un disc cu snapshot, comanda vede o imagine +stabilă a sistemului de fișiere, neafectată de modificările concurente de pe sistemul +de fișiere live. +În timpul unui `sync`, un nou snapshot este creat în mod independent pentru fiecare +sistem de fișiere de date acceptat. Aceste snapshot-uri oferă colectiv datele +utilizate 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ă. @@ -1608,7 +1612,7 @@ Toate celelalte comenzi operează exclusiv pe sistemul de fișiere live. 9 CICLUL DE VIAță AL SNAPSHOT-URILOR (SNAPSHOTS LIFECYCLE) ========================================================== -SnapRAID gestionează două snapshot-uri specifice, `stable` și `pending`, +SnapRAID gestionează trei snapshot-uri specifice, `stable`, `pending` și `scan`, î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/`. @@ -1618,8 +1622,12 @@ Snapshot-ul `stable` reprezintă starea ultimului 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. +Snapshot-ul `scan` este o imagine temporară creată la începutul +unui `sync` pentru a oferi o stare înghețată pentru scanare și calculul parității. +După scanarea și salvarea stării noi de conținut, acesta înlocuiește snapshot-ul +`pending` anterior. + +Snapshot-ul `pending` este imaginea utilizată de un `sync` întrerupt. 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ă. diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1 index 8eec30ff..d2e95a69 100644 --- a/doc/snapraid-ru.1 +++ b/doc/snapraid-ru.1 @@ -132,7 +132,8 @@ SnapRAID — это гибрид между RAID и программой рез .PD 0 .IP \(bu При наличии поддержки снимков (доступно на Btrfs, ZFS, Bcachefs и NTFS), -SnapRAID может автоматически поддерживать замороженную копию ваших дисков с данными. +SnapRAID может автоматически поддерживать независимую замороженную копию +каждой поддерживаемой файловой системы данных. Это гарантирует, что даже если вы измените или удалите файлы в вашей живой файловой системе во время или после синхронизации, процесс восстановления останется согласованным и надежным. .PD @@ -1442,9 +1443,10 @@ UUID дисков. Включает использование снимков файловой системы для команд \`sync\`, \`scrub\`, \`check\` и \`fix\`. .PP -Если опция включена, SnapRAID создает снимок ваших данных только для чтения в -начале операции \'sync\'. Это обеспечивает согласованный срез ваших файлов на определенный -момент времени, предотвращая ошибки, вызванные одновременным изменением файлов. +Если опция включена, SnapRAID создает снимок только для чтения каждой поддерживаемой +файловой системы данных в начале операции \'sync\'. Это обеспечивает стабильный срез +каждой файловой системы, предотвращая изменение данных, используемых для вычисления +четности, последующими модификациями. .PP Это значительно улучшает восстановление: если файл удаляется из живой файловой системы, он остается сохраненным в снимке. Это предотвращает «нарушение» четности @@ -1812,9 +1814,10 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .PD .RE .SH Снимки (SNAPSHOTS) -Если в конфигурации включена опция снимков, SnapRAID использует -функциональность снимков файловой системы для обеспечения атомарности и -согласованности операций. +Если в конфигурации включена опция снимков, SnapRAID использует снимки +файловой системы для сохранения стабильности данных, считываемых во время +операции, даже если файлы в живых файловых системах впоследствии изменяются +или удаляются. .PP Управление снимками происходит полностью автоматически и прозрачно. Вы можете продолжать использовать SnapRAID точно так же, как и раньше, получая @@ -1827,7 +1830,8 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .PP .RS 4 процесса sync или scrub, не вызовут несоответствия четности или прерывания -операций, поскольку SnapRAID видит замороженный снимок на момент времени. +операций, поскольку каждая файловая система со снимком остается неизменной +на протяжении всей операции. .RE .PP Восстановление — Если файл обновляется или удаляется из живой файловой системы, @@ -1868,12 +1872,13 @@ SnapRAID также может автоматически читать как и Убедитесь, что SnapRAID запущен с необходимыми привилегиями (например, sudo), когда снимки включены. .SS Поведение команд при использовании снимков -Команды \`sync\` и \`scrub\` работают исключительно со снимками, -чтобы гарантировать, что все операции с данными выполняются на согласованном, -замороженном состоянии. Используя эти снимки, SnapRAID предотвращает несоответствия -четности, которые в противном случае были бы вызваны одновременными изменениями файлов в живой файловой системе. -Во время \`sync\` команда использует новый снимок, созданный в начале -процесса, для фиксации текущего состояния для вычисления четности. +Команды \`sync\` и \`scrub\` используют снимки для дисков с данными, чьи +файловые системы их поддерживают. На диске со снимком команда видит +стабильный образ файловой системы, не затронутый одновременными изменениями +в живой файловой системе. +Во время \`sync\` новый снимок создается независимо для каждой поддерживаемой +файловой системы данных. Эти снимки в совокупности предоставляют данные, +используемые для вычисления четности. Напротив, команда \`scrub\` использует последний снимок, созданный во время самой последней синхронизации, чтобы поддерживать надежную точку отсчета, соответствующую существующей четности. @@ -1898,7 +1903,7 @@ SnapRAID также может автоматически читать как и .PP Все остальные команды работают исключительно с живой файловой системой. .SH Жизненный цикл снимков (SNAPSHOTS LIFECYCLE) -SnapRAID управляет двумя конкретными снимками, \`stable\` и \`pending\`, +SnapRAID управляет тремя конкретными снимками, \`stable\`, \`pending\` и \`scan\`, внутри скрытого каталога в корне каждого подтома данных. В Btrfs, Bcachefs и NTFS используется каталог \`.snapraid/\`, в ZFS — стандартный \`.zfs/snapshot/\`. @@ -1908,8 +1913,12 @@ SnapRAID управляет двумя конкретными снимками, вычисления текущей четности. Он служит основным источником данных для команд \`scrub\`, \`check\` и \`fix\`. .PP -Снимок \`pending\` — это временный образ, создаваемый в начале -\`sync\` для обеспечения замороженного состояния для вычисления четности. +Снимок \`scan\` — это временный образ, создаваемый в начале +\`sync\` для обеспечения замороженного состояния для сканирования и вычисления четности. +После сканирования и сохранения нового состояния содержимого он заменяет предыдущий +снимок \`pending\`. +.PP +Снимок \`pending\` — это образ, используемый прерванной синхронизацией \`sync\`. После успешного завершения операции предыдущий снимок \`stable\` удаляется, а снимок \`pending\` повышается в статусе, чтобы занять его место в качестве нового стабильного ориентира. diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d index e08681a4..eeb241e8 100644 --- a/doc/snapraid-ru.d +++ b/doc/snapraid-ru.d @@ -65,7 +65,8 @@ Name{number} от того, используется ли опция снимка (`snapshot`): * При наличии поддержки снимков (доступно на Btrfs, ZFS, Bcachefs и NTFS), - SnapRAID может автоматически поддерживать замороженную копию ваших дисков с данными. + SnapRAID может автоматически поддерживать независимую замороженную копию + каждой поддерживаемой файловой системы данных. Это гарантирует, что даже если вы измените или удалите файлы в вашей живой файловой системе во время или после синхронизации, процесс восстановления останется согласованным и надежным. @@ -1158,9 +1159,10 @@ Name{number} Включает использование снимков файловой системы для команд `sync`, `scrub`, `check` и `fix`. - Если опция включена, SnapRAID создает снимок ваших данных только для чтения в - начале операции 'sync'. Это обеспечивает согласованный срез ваших файлов на определенный - момент времени, предотвращая ошибки, вызванные одновременным изменением файлов. + Если опция включена, SnapRAID создает снимок только для чтения каждой поддерживаемой + файловой системы данных в начале операции 'sync'. Это обеспечивает стабильный срез + каждой файловой системы, предотвращая изменение данных, используемых для вычисления + четности, последующими модификациями. Это значительно улучшает восстановление: если файл удаляется из живой файловой системы, он остается сохраненным в снимке. Это предотвращает «нарушение» четности @@ -1427,9 +1429,10 @@ Name{number} :smartctl 2-parity -d areca,2/1 /dev/arcmsr0 Снимки (Snapshots) - Если в конфигурации включена опция снимков, SnapRAID использует - функциональность снимков файловой системы для обеспечения атомарности и - согласованности операций. + Если в конфигурации включена опция снимков, SnapRAID использует снимки + файловой системы для сохранения стабильности данных, считываемых во время + операции, даже если файлы в живых файловых системах впоследствии изменяются + или удаляются. Управление снимками происходит полностью автоматически и прозрачно. Вы можете продолжать использовать SnapRAID точно так же, как и раньше, получая @@ -1440,7 +1443,8 @@ Name{number} Согласованность — Файлы, измененные в живой файловой системе во время длительного процесса sync или scrub, не вызовут несоответствия четности или прерывания - операций, поскольку SnapRAID видит замороженный снимок на момент времени. + операций, поскольку каждая файловая система со снимком остается неизменной + на протяжении всей операции. Восстановление — Если файл обновляется или удаляется из живой файловой системы, он остается сохраненным в снимке. Если сбой диска произойдет до запуска следующей синхронизации sync, SnapRAID использует данные, сохраненные @@ -1473,12 +1477,13 @@ Name{number} когда снимки включены. Поведение команд при использовании снимков - Команды `sync` и `scrub` работают исключительно со снимками, - чтобы гарантировать, что все операции с данными выполняются на согласованном, - замороженном состоянии. Используя эти снимки, SnapRAID предотвращает несоответствия - четности, которые в противном случае были бы вызваны одновременными изменениями файлов в живой файловой системе. - Во время `sync` команда использует новый снимок, созданный в начале - процесса, для фиксации текущего состояния для вычисления четности. + Команды `sync` и `scrub` используют снимки для дисков с данными, чьи + файловые системы их поддерживают. На диске со снимком команда видит + стабильный образ файловой системы, не затронутый одновременными изменениями + в живой файловой системе. + Во время `sync` новый снимок создается независимо для каждой поддерживаемой + файловой системы данных. Эти снимки в совокупности предоставляют данные, + используемые для вычисления четности. Напротив, команда `scrub` использует последний снимок, созданный во время самой последней синхронизации, чтобы поддерживать надежную точку отсчета, соответствующую существующей четности. @@ -1504,7 +1509,7 @@ Name{number} Все остальные команды работают исключительно с живой файловой системой. Жизненный цикл снимков (Snapshots Lifecycle) - SnapRAID управляет двумя конкретными снимками, `stable` и `pending`, + SnapRAID управляет тремя конкретными снимками, `stable`, `pending` и `scan`, внутри скрытого каталога в корне каждого подтома данных. В Btrfs, Bcachefs и NTFS используется каталог `.snapraid/`, в ZFS — стандартный `.zfs/snapshot/`. @@ -1514,8 +1519,12 @@ Name{number} вычисления текущей четности. Он служит основным источником данных для команд `scrub`, `check` и `fix`. - Снимок `pending` — это временный образ, создаваемый в начале - `sync` для обеспечения замороженного состояния для вычисления четности. + Снимок `scan` — это временный образ, создаваемый в начале + `sync` для обеспечения замороженного состояния для сканирования и вычисления четности. + После сканирования и сохранения нового состояния содержимого он заменяет предыдущий + снимок `pending`. + + Снимок `pending` — это образ, используемый прерванной синхронизацией `sync`. После успешного завершения операции предыдущий снимок `stable` удаляется, а снимок `pending` повышается в статусе, чтобы занять его место в качестве нового стабильного ориентира. diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt index c08f7f63..87e22466 100644 --- a/doc/snapraid-ru.txt +++ b/doc/snapraid-ru.txt @@ -75,7 +75,8 @@ SnapRAID — это гибрид между RAID и программой рез от того, используется ли опция снимка (`snapshot`): * При наличии поддержки снимков (доступно на Btrfs, ZFS, Bcachefs и NTFS), - SnapRAID может автоматически поддерживать замороженную копию ваших дисков с данными. + SnapRAID может автоматически поддерживать независимую замороженную копию + каждой поддерживаемой файловой системы данных. Это гарантирует, что даже если вы измените или удалите файлы в вашей живой файловой системе во время или после синхронизации, процесс восстановления останется согласованным и надежным. @@ -1236,9 +1237,10 @@ UUID дисков. Включает использование снимков файловой системы для команд `sync`, `scrub`, `check` и `fix`. -Если опция включена, SnapRAID создает снимок ваших данных только для чтения в -начале операции 'sync'. Это обеспечивает согласованный срез ваших файлов на определенный -момент времени, предотвращая ошибки, вызванные одновременным изменением файлов. +Если опция включена, SnapRAID создает снимок только для чтения каждой поддерживаемой +файловой системы данных в начале операции 'sync'. Это обеспечивает стабильный срез +каждой файловой системы, предотвращая изменение данных, используемых для вычисления +четности, последующими модификациями. Это значительно улучшает восстановление: если файл удаляется из живой файловой системы, он остается сохраненным в снимке. Это предотвращает «нарушение» четности @@ -1532,9 +1534,10 @@ PARITY — это одно из имен четности: `parity`, `2-parity`, 8 Снимки (SNAPSHOTS) ==================== -Если в конфигурации включена опция снимков, SnapRAID использует -функциональность снимков файловой системы для обеспечения атомарности и -согласованности операций. +Если в конфигурации включена опция снимков, SnapRAID использует снимки +файловой системы для сохранения стабильности данных, считываемых во время +операции, даже если файлы в живых файловых системах впоследствии изменяются +или удаляются. Управление снимками происходит полностью автоматически и прозрачно. Вы можете продолжать использовать SnapRAID точно так же, как и раньше, получая @@ -1545,7 +1548,8 @@ PARITY — это одно из имен четности: `parity`, `2-parity`, Согласованность — Файлы, измененные в живой файловой системе во время длительного процесса sync или scrub, не вызовут несоответствия четности или прерывания - операций, поскольку SnapRAID видит замороженный снимок на момент времени. + операций, поскольку каждая файловая система со снимком остается неизменной + на протяжении всей операции. Восстановление — Если файл обновляется или удаляется из живой файловой системы, он остается сохраненным в снимке. Если сбой диска произойдет до запуска следующей синхронизации sync, SnapRAID использует данные, сохраненные @@ -1580,12 +1584,13 @@ PARITY — это одно из имен четности: `parity`, `2-parity`, 8.1 Поведение команд при использовании снимков ---------------------------------------------- -Команды `sync` и `scrub` работают исключительно со снимками, -чтобы гарантировать, что все операции с данными выполняются на согласованном, -замороженном состоянии. Используя эти снимки, SnapRAID предотвращает несоответствия -четности, которые в противном случае были бы вызваны одновременными изменениями файлов в живой файловой системе. -Во время `sync` команда использует новый снимок, созданный в начале -процесса, для фиксации текущего состояния для вычисления четности. +Команды `sync` и `scrub` используют снимки для дисков с данными, чьи +файловые системы их поддерживают. На диске со снимком команда видит +стабильный образ файловой системы, не затронутый одновременными изменениями +в живой файловой системе. +Во время `sync` новый снимок создается независимо для каждой поддерживаемой +файловой системы данных. Эти снимки в совокупности предоставляют данные, +используемые для вычисления четности. Напротив, команда `scrub` использует последний снимок, созданный во время самой последней синхронизации, чтобы поддерживать надежную точку отсчета, соответствующую существующей четности. @@ -1614,7 +1619,7 @@ PARITY — это одно из имен четности: `parity`, `2-parity`, 9 Жизненный цикл снимков (SNAPSHOTS LIFECYCLE) ============================================== -SnapRAID управляет двумя конкретными снимками, `stable` и `pending`, +SnapRAID управляет тремя конкретными снимками, `stable`, `pending` и `scan`, внутри скрытого каталога в корне каждого подтома данных. В Btrfs, Bcachefs и NTFS используется каталог `.snapraid/`, в ZFS — стандартный `.zfs/snapshot/`. @@ -1624,8 +1629,12 @@ SnapRAID управляет двумя конкретными снимками, вычисления текущей четности. Он служит основным источником данных для команд `scrub`, `check` и `fix`. -Снимок `pending` — это временный образ, создаваемый в начале -`sync` для обеспечения замороженного состояния для вычисления четности. +Снимок `scan` — это временный образ, создаваемый в начале +`sync` для обеспечения замороженного состояния для сканирования и вычисления четности. +После сканирования и сохранения нового состояния содержимого он заменяет предыдущий +снимок `pending`. + +Снимок `pending` — это образ, используемый прерванной синхронизацией `sync`. После успешного завершения операции предыдущий снимок `stable` удаляется, а снимок `pending` повышается в статусе, чтобы занять его место в качестве нового стабильного ориентира. diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1 index 640bc7d1..ea935512 100644 --- a/doc/snapraid-sv.1 +++ b/doc/snapraid-sv.1 @@ -133,7 +133,8 @@ 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. +kan SnapRAID automatiskt upprätthålla en oberoende frusen referens +för varje datafilsystem som stöds. 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 @@ -1443,9 +1444,10 @@ Observera att sådana diskar inte påverkas av kommandona \`up\` och 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. +När det är aktiverat skapar SnapRAID en skrivskyddad ögonblicksbild av varje +datafilsystem som stöds vid början av en \'sync\'. Detta ger en stabil vy av varje +filsystem och förhindrar att senare ändringar ändrar den data som används för +paritetsberäkningen. .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] @@ -1812,8 +1814,8 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .RE .SH ÖGONBLICKSBILDER (SNAPSHOTS) 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. +filsystemets ögonblicksbilder för att hålla data som läses under en operation stabil, +även om filer på de aktiva filsystemen senare ändras eller tas bort. .PP Hanteringen av ögonblicksbilder är helt automatisk och transparent. Du kan fortsätta att använda SnapRAID exakt som tidigare, med det @@ -1827,7 +1829,8 @@ Detta ger två huvudsakliga fördelar: .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. +operationer, eftersom varje filsystem med ögonblicksbild förblir oförändrat +under hela operationen. .HP 4 .I Återställning Om en fil uppdateras eller tas bort från det aktiva filsystemet @@ -1868,12 +1871,12 @@ 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. +Kommandona \`sync\` och \`scrub\` använder ögonblicksbilder för datadiskar vars +filsystem stöder dem. På en disk med ögonblicksbild ser kommandot en stabil +filsystembild som inte påverkas av samtidiga ändringar på det aktiva filsystemet. +Under en \`sync\` skapas en ny ögonblicksbild oberoende för varje datafilsystem +som stöds. Dessa ögonblicksbilder tillhandahåller gemensamt den data som används +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. @@ -1898,7 +1901,7 @@ aktiva filsystemen uteslutande. .PP Alla andra kommandon fungerar uteslutande på det aktiva filsystemet. .SH LIVSCYKEL FöR öGONBLICKSBILDER (SNAPSHOTS LIFECYCLE) -SnapRAID hanterar två specifika ögonblicksbilder, \`stable\` och \`pending\`, +SnapRAID hanterar tre specifika ögonblicksbilder, \`stable\`, \`pending\` och \`scan\`, inom en dold katalog i roten av varje datavolym. I Btrfs, Bcachefs och NTFS används katalogen \`.snapraid/\`, i ZFS standardkatalogen \`.zfs/snapshot/\`. @@ -1908,8 +1911,12 @@ framgångsrikt slutförda \`sync\`\-iseringen, och innehåller exakt den data so 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. +Ögonblicksbilden \`scan\` är en tillfällig bild som skapas i början +av en \`sync\` för att tillhandahålla ett fruset tillstånd för skanning och paritetsberäkning. +Efter skanning och sparning av det nya innehållstillståndet ersätter den den föregående +\`pending\`\-ögonblicksbilden. +.PP +Ögonblicksbilden \`pending\` är bilden som används av en avbruten \`sync\`. 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. diff --git a/doc/snapraid-sv.d b/doc/snapraid-sv.d index cd74c84e..2dd0e28b 100644 --- a/doc/snapraid-sv.d +++ b/doc/snapraid-sv.d @@ -66,7 +66,8 @@ Begränsningar (Limitations) 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. + kan SnapRAID automatiskt upprätthålla en oberoende frusen referens + för varje datafilsystem som stöds. 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. @@ -1159,9 +1160,10 @@ Konfiguration (Configuration) 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. + När det är aktiverat skapar SnapRAID en skrivskyddad ögonblicksbild av varje + datafilsystem som stöds vid början av en 'sync'. Detta ger en stabil vy av varje + filsystem och förhindrar att senare ändringar ändrar den data som används för + paritetsberäkningen. 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" @@ -1427,8 +1429,8 @@ Konfiguration (Configuration) Ögonblicksbilder (Snapshots) 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. + filsystemets ögonblicksbilder för att hålla data som läses under en operation stabil, + även om filer på de aktiva filsystemen senare ändras eller tas bort. Hanteringen av ögonblicksbilder är helt automatisk och transparent. Du kan fortsätta att använda SnapRAID exakt som tidigare, med det @@ -1439,7 +1441,8 @@ Konfiguration (Configuration) 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. + operationer, eftersom varje filsystem med ögonblicksbild förblir oförändrat + under hela operationen. Å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 @@ -1471,12 +1474,12 @@ Konfiguration (Configuration) 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. + Kommandona `sync` och `scrub` använder ögonblicksbilder för datadiskar vars + filsystem stöder dem. På en disk med ögonblicksbild ser kommandot en stabil + filsystembild som inte påverkas av samtidiga ändringar på det aktiva filsystemet. + Under en `sync` skapas en ny ögonblicksbild oberoende för varje datafilsystem + som stöds. Dessa ögonblicksbilder tillhandahåller gemensamt den data som används + 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. @@ -1502,7 +1505,7 @@ Konfiguration (Configuration) Alla andra kommandon fungerar uteslutande på det aktiva filsystemet. Livscykel för ögonblicksbilder (Snapshots Lifecycle) - SnapRAID hanterar två specifika ögonblicksbilder, `stable` och `pending`, + SnapRAID hanterar tre specifika ögonblicksbilder, `stable`, `pending` och `scan`, inom en dold katalog i roten av varje datavolym. I Btrfs, Bcachefs och NTFS används katalogen `.snapraid/`, i ZFS standardkatalogen `.zfs/snapshot/`. @@ -1512,8 +1515,12 @@ Livscykel för ögonblicksbilder (Snapshots Lifecycle) 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. + Ögonblicksbilden `scan` är en tillfällig bild som skapas i början + av en `sync` för att tillhandahålla ett fruset tillstånd för skanning och paritetsberäkning. + Efter skanning och sparning av det nya innehållstillståndet ersätter den den föregående + `pending`-ögonblicksbilden. + + Ögonblicksbilden `pending` är bilden som används av en avbruten `sync`. 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. diff --git a/doc/snapraid-sv.txt b/doc/snapraid-sv.txt index 010151d5..702a7a7b 100644 --- a/doc/snapraid-sv.txt +++ b/doc/snapraid-sv.txt @@ -76,7 +76,8 @@ För data som redan existerade vid den senaste synkroniseringen beror återstäl 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. + kan SnapRAID automatiskt upprätthålla en oberoende frusen referens + för varje datafilsystem som stöds. 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. @@ -1237,9 +1238,10 @@ Observera att sådana diskar inte påverkas av kommandona `up` och 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. +När det är aktiverat skapar SnapRAID en skrivskyddad ögonblicksbild av varje +datafilsystem som stöds vid början av en 'sync'. Detta ger en stabil vy av varje +filsystem och förhindrar att senare ändringar ändrar den data som används för +paritetsberäkningen. 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" @@ -1532,8 +1534,8 @@ Ett exempel på en typisk konfiguration för Windows är: ============================== 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. +filsystemets ögonblicksbilder för att hålla data som läses under en operation stabil, +även om filer på de aktiva filsystemen senare ändras eller tas bort. Hanteringen av ögonblicksbilder är helt automatisk och transparent. Du kan fortsätta att använda SnapRAID exakt som tidigare, med det @@ -1544,7 +1546,8 @@ 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. + operationer, eftersom varje filsystem med ögonblicksbild förblir oförändrat + under hela operationen. Å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 @@ -1578,12 +1581,12 @@ 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. +Kommandona `sync` och `scrub` använder ögonblicksbilder för datadiskar vars +filsystem stöder dem. På en disk med ögonblicksbild ser kommandot en stabil +filsystembild som inte påverkas av samtidiga ändringar på det aktiva filsystemet. +Under en `sync` skapas en ny ögonblicksbild oberoende för varje datafilsystem +som stöds. Dessa ögonblicksbilder tillhandahåller gemensamt den data som används +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. @@ -1612,7 +1615,7 @@ Alla andra kommandon fungerar uteslutande på det aktiva filsystemet. 9 LIVSCYKEL FöR öGONBLICKSBILDER (SNAPSHOTS LIFECYCLE) ====================================================== -SnapRAID hanterar två specifika ögonblicksbilder, `stable` och `pending`, +SnapRAID hanterar tre specifika ögonblicksbilder, `stable`, `pending` och `scan`, inom en dold katalog i roten av varje datavolym. I Btrfs, Bcachefs och NTFS används katalogen `.snapraid/`, i ZFS standardkatalogen `.zfs/snapshot/`. @@ -1622,8 +1625,12 @@ framgångsrikt slutförda `sync`-iseringen, och innehåller exakt den data som a 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. +Ögonblicksbilden `scan` är en tillfällig bild som skapas i början +av en `sync` för att tillhandahålla ett fruset tillstånd för skanning och paritetsberäkning. +Efter skanning och sparning av det nya innehållstillståndet ersätter den den föregående +`pending`-ögonblicksbilden. + +Ögonblicksbilden `pending` är bilden som används av en avbruten `sync`. 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. diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1 index 5ea6921b..d40456df 100644 --- a/doc/snapraid-uk.1 +++ b/doc/snapraid-uk.1 @@ -136,7 +136,8 @@ SnapRAID є гібридом між RAID і програмою резервно .PD 0 .IP \(bu За наявності підтримки знімків (доступно на Btrfs, ZFS, Bcachefs та NTFS), -SnapRAID може автоматично підтримувати заморожену копію ваших дисків із даними. +SnapRAID може автоматично підтримувати незалежну заморожену копію +кожної підтримуваної файлової системи даних. Це гарантує, що навіть якщо ви зміните або видалите файли у вашій живій файловій системі під час або після синхронізації, процес відновлення залишиться узгодженим і надійним. .PD @@ -1570,9 +1571,10 @@ UUID дисків. Включає використання знімків файлової системи для команд \`sync\`, \`scrub\`, \`check\` та \`fix\`. .PP -Якщо увімкнено, SnapRAID створює знімок ваших даних лише для читання на -початку операції \'sync\'. Це забезпечує узгоджений зріз ваших файлів на певний момент часу, -запобігаючи помилкам, викликаним одночасним зміненням файлів. +Якщо увімкнено, SnapRAID створює знімок лише для читання кожної підтримуваної +файлової системи даних на початку операції \'sync\'. Це забезпечує стабільний зріз +кожної файлової системи, запобігаючи зміні даних, що використовуються для обчислення +парності, подальшими модифікаціями. .PP Це значно покращує відновлення: якщо файл видаляється з живої файлової системи, він залишається збереженим у знімку. Це запобігає «порушенню» парності @@ -1984,9 +1986,10 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .PD .RE .SH Знімки (SNAPSHOTS) -Якщо в конфігурації увімкнено опцію знімків, SnapRAID використовує -функціональність знімків файлової системи для забезпечення атомарності та -узгодженості операцій. +Якщо в конфігурації увімкнено опцію знімків, SnapRAID використовує знімки +файлової системи для збереження стабільності даних, що зчитуються під час +операції, навіть якщо файли в живих файлових системах згодом змінюються +або видаляються. .PP Керування знімками відбувається повністю автоматично та прозоро. Ви можете продовжувати використовувати SnapRAID точно так само, як і раніше, отримуючи @@ -1999,7 +2002,8 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .PP .RS 4 процесу sync або scrub, не викликатимуть невідповідності парності або переривання -операцій, оскільки SnapRAID бачить заморожений знімок на момент часу. +операцій, оскільки кожна файлова система зі знімком залишається незмінною +протягом усієї операції. .RE .PP Відновлення — Якщо файл оновлюється або видаляється з живої файлової системи, @@ -2040,12 +2044,13 @@ SnapRAID також може автоматично читати як зі зн Переконайтеся, що SnapRAID запущено з необхідними привілеями (наприклад, sudo), коли знімки увімкнено. .SS Поведінка команд із знімками -Команди \`sync\` та \`scrub\` працюють виключно зі знімками, -щоб гарантувати, що всі операції з даними виконуються на узгодженому, -замороженому стані. Використовуючи ці знімки, SnapRAID запобігає невідповідності -парності, яка в іншому випадку була б викликана одночасними змінами файлів у живій файловій системі. -Під час \`sync\` команда використовує новий знімок, створений на початку -процесу, для фіксації поточного стану для обчислення парності. +Команди \`sync\` та \`scrub\` використовують знімки для дисків із даними, чиї +файлові системи їх підтримують. На диску зі знімком команда бачить стабільний +образ файлової системи, не зачеплений одночасними змінами в живій файловій +системі. +Під час \`sync\` новий знімок створюється незалежно для кожної підтримуваної +файлової системи даних. Ці знімки сукупно надають дані, що використовуються +для обчислення парності. Навпаки, команда \`scrub\` використовує останній знімок, створений під час найостаннішої синхронізації, щоб підтримувати надійну точку відліку, яка відповідає існуючій парності. @@ -2070,7 +2075,7 @@ SnapRAID також може автоматично читати як зі зн .PP Усі інші команди працюють виключно з живою файловою системою. .SH Життєвий цикл знімків (SNAPSHOTS LIFECYCLE) -SnapRAID керує двома конкретними знімками, \`stable\` та \`pending\`, +SnapRAID керує трьома конкретними знімками, \`stable\`, \`pending\` та \`scan\`, всередині прихованого каталогу в корінному каталозі кожного підтому даних. У Btrfs, Bcachefs та NTFS використовується каталог \`.snapraid/\`, у ZFS — стандартний \`.zfs/snapshot/\`. @@ -2080,8 +2085,12 @@ SnapRAID керує двома конкретними знімками, \`stable обчислення поточної парності. Він служить основним джерелом даних для команд \`scrub\`, \`check\` та \`fix\`. .PP -Знімок \`pending\` — це тимчасовий образ, що створюється на початку -\`sync\` для забезпечення замороженого стану для обчислення парності. +Знімок \`scan\` — це тимчасовий образ, що створюється на початку +\`sync\` для забезпечення замороженого стану для сканування та обчислення парності. +Після сканування та збереження нового стану вмісту він замінює попередній +знімок \`pending\`. +.PP +Знімок \`pending\` — це образ, використовуваний перерваною синхронізацією \`sync\`. Після успішного завершення операції попередній знімок \`stable\` видаляється, а знімок \`pending\` підвищується в статусі, щоб зайняти його місце в якості нового стабільного орієнтира. diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d index ac0f5a71..3be59a7e 100644 --- a/doc/snapraid-uk.d +++ b/doc/snapraid-uk.d @@ -69,7 +69,8 @@ Name{number} від того, чи використовується опція знімка (`snapshot`): * За наявності підтримки знімків (доступно на Btrfs, ZFS, Bcachefs та NTFS), - SnapRAID може автоматично підтримувати заморожену копію ваших дисків із даними. + SnapRAID може автоматично підтримувати незалежну заморожену копію + кожної підтримуваної файлової системи даних. Це гарантує, що навіть якщо ви зміните або видалите файли у вашій живій файловій системі під час або після синхронізації, процес відновлення залишиться узгодженим і надійним. @@ -1275,9 +1276,10 @@ Name{number} Включає використання знімків файлової системи для команд `sync`, `scrub`, `check` та `fix`. - Якщо увімкнено, SnapRAID створює знімок ваших даних лише для читання на - початку операції 'sync'. Це забезпечує узгоджений зріз ваших файлів на певний момент часу, - запобігаючи помилкам, викликаним одночасним зміненням файлів. + Якщо увімкнено, SnapRAID створює знімок лише для читання кожної підтримуваної + файлової системи даних на початку операції 'sync'. Це забезпечує стабільний зріз + кожної файлової системи, запобігаючи зміні даних, що використовуються для обчислення + парності, подальшими модифікаціями. Це значно покращує відновлення: якщо файл видаляється з живої файлової системи, він залишається збереженим у знімку. Це запобігає «порушенню» парності @@ -1588,9 +1590,10 @@ Name{number} :smartctl 2-parity -d areca,2/1 /dev/arcmsr0 Знімки (Snapshots) - Якщо в конфігурації увімкнено опцію знімків, SnapRAID використовує - функціональність знімків файлової системи для забезпечення атомарності та - узгодженості операцій. + Якщо в конфігурації увімкнено опцію знімків, SnapRAID використовує знімки + файлової системи для збереження стабільності даних, що зчитуються під час + операції, навіть якщо файли в живих файлових системах згодом змінюються + або видаляються. Керування знімками відбувається повністю автоматично та прозоро. Ви можете продовжувати використовувати SnapRAID точно так само, як і раніше, отримуючи @@ -1601,7 +1604,8 @@ Name{number} Узгодженість — Файли, змінені в живій файловій системі під час тривалого процесу sync або scrub, не викликатимуть невідповідності парності або переривання - операцій, оскільки SnapRAID бачить заморожений знімок на момент часу. + операцій, оскільки кожна файлова система зі знімком залишається незмінною + протягом усієї операції. Відновлення — Якщо файл оновлюється або видаляється з живої файлової системи, він залишається збереженим у знімку. Якщо збій диска станеться до запуску наступної синхронізації sync, SnapRAID використає дані, збережені @@ -1634,12 +1638,13 @@ Name{number} коли знімки увімкнено. Поведінка команд із знімками - Команди `sync` та `scrub` працюють виключно зі знімками, - щоб гарантувати, що всі операції з даними виконуються на узгодженому, - замороженому стані. Використовуючи ці знімки, SnapRAID запобігає невідповідності - парності, яка в іншому випадку була б викликана одночасними змінами файлів у живій файловій системі. - Під час `sync` команда використовує новий знімок, створений на початку - процесу, для фіксації поточного стану для обчислення парності. + Команди `sync` та `scrub` використовують знімки для дисків із даними, чиї + файлові системи їх підтримують. На диску зі знімком команда бачить стабільний + образ файлової системи, не зачеплений одночасними змінами в живій файловій + системі. + Під час `sync` новий знімок створюється незалежно для кожної підтримуваної + файлової системи даних. Ці знімки сукупно надають дані, що використовуються + для обчислення парності. Навпаки, команда `scrub` використовує останній знімок, створений під час найостаннішої синхронізації, щоб підтримувати надійну точку відліку, яка відповідає існуючій парності. @@ -1665,7 +1670,7 @@ Name{number} Усі інші команди працюють виключно з живою файловою системою. Життєвий цикл знімків (Snapshots Lifecycle) - SnapRAID керує двома конкретними знімками, `stable` та `pending`, + SnapRAID керує трьома конкретними знімками, `stable`, `pending` та `scan`, всередині прихованого каталогу в корінному каталозі кожного підтому даних. У Btrfs, Bcachefs та NTFS використовується каталог `.snapraid/`, у ZFS — стандартний `.zfs/snapshot/`. @@ -1675,8 +1680,12 @@ Name{number} обчислення поточної парності. Він служить основним джерелом даних для команд `scrub`, `check` та `fix`. - Знімок `pending` — це тимчасовий образ, що створюється на початку - `sync` для забезпечення замороженого стану для обчислення парності. + Знімок `scan` — це тимчасовий образ, що створюється на початку + `sync` для забезпечення замороженого стану для сканування та обчислення парності. + Після сканування та збереження нового стану вмісту він замінює попередній + знімок `pending`. + + Знімок `pending` — це образ, використовуваний перерваною синхронізацією `sync`. Після успішного завершення операції попередній знімок `stable` видаляється, а знімок `pending` підвищується в статусі, щоб зайняти його місце в якості нового стабільного орієнтира. diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt index 605aab47..b1191277 100644 --- a/doc/snapraid-uk.txt +++ b/doc/snapraid-uk.txt @@ -79,7 +79,8 @@ SnapRAID є гібридом між RAID і програмою резервно від того, чи використовується опція знімка (`snapshot`): * За наявності підтримки знімків (доступно на Btrfs, ZFS, Bcachefs та NTFS), - SnapRAID може автоматично підтримувати заморожену копію ваших дисків із даними. + SnapRAID може автоматично підтримувати незалежну заморожену копію + кожної підтримуваної файлової системи даних. Це гарантує, що навіть якщо ви зміните або видалите файли у вашій живій файловій системі під час або після синхронізації, процес відновлення залишиться узгодженим і надійним. @@ -1353,9 +1354,10 @@ UUID дисків. Включає використання знімків файлової системи для команд `sync`, `scrub`, `check` та `fix`. -Якщо увімкнено, SnapRAID створює знімок ваших даних лише для читання на -початку операції 'sync'. Це забезпечує узгоджений зріз ваших файлів на певний момент часу, -запобігаючи помилкам, викликаним одночасним зміненням файлів. +Якщо увімкнено, SnapRAID створює знімок лише для читання кожної підтримуваної +файлової системи даних на початку операції 'sync'. Це забезпечує стабільний зріз +кожної файлової системи, запобігаючи зміні даних, що використовуються для обчислення +парності, подальшими модифікаціями. Це значно покращує відновлення: якщо файл видаляється з живої файлової системи, він залишається збереженим у знімку. Це запобігає «порушенню» парності @@ -1693,9 +1695,10 @@ PARITY — це одне з імен парності: `parity`, 8 Знімки (SNAPSHOTS) ==================== -Якщо в конфігурації увімкнено опцію знімків, SnapRAID використовує -функціональність знімків файлової системи для забезпечення атомарності та -узгодженості операцій. +Якщо в конфігурації увімкнено опцію знімків, SnapRAID використовує знімки +файлової системи для збереження стабільності даних, що зчитуються під час +операції, навіть якщо файли в живих файлових системах згодом змінюються +або видаляються. Керування знімками відбувається повністю автоматично та прозоро. Ви можете продовжувати використовувати SnapRAID точно так само, як і раніше, отримуючи @@ -1706,7 +1709,8 @@ PARITY — це одне з імен парності: `parity`, Узгодженість — Файли, змінені в живій файловій системі під час тривалого процесу sync або scrub, не викликатимуть невідповідності парності або переривання - операцій, оскільки SnapRAID бачить заморожений знімок на момент часу. + операцій, оскільки кожна файлова система зі знімком залишається незмінною + протягом усієї операції. Відновлення — Якщо файл оновлюється або видаляється з живої файлової системи, він залишається збереженим у знімку. Якщо збій диска станеться до запуску наступної синхронізації sync, SnapRAID використає дані, збережені @@ -1741,12 +1745,13 @@ PARITY — це одне з імен парності: `parity`, 8.1 Поведінка команд із знімками -------------------------------- -Команди `sync` та `scrub` працюють виключно зі знімками, -щоб гарантувати, що всі операції з даними виконуються на узгодженому, -замороженому стані. Використовуючи ці знімки, SnapRAID запобігає невідповідності -парності, яка в іншому випадку була б викликана одночасними змінами файлів у живій файловій системі. -Під час `sync` команда використовує новий знімок, створений на початку -процесу, для фіксації поточного стану для обчислення парності. +Команди `sync` та `scrub` використовують знімки для дисків із даними, чиї +файлові системи їх підтримують. На диску зі знімком команда бачить стабільний +образ файлової системи, не зачеплений одночасними змінами в живій файловій +системі. +Під час `sync` новий знімок створюється незалежно для кожної підтримуваної +файлової системи даних. Ці знімки сукупно надають дані, що використовуються +для обчислення парності. Навпаки, команда `scrub` використовує останній знімок, створений під час найостаннішої синхронізації, щоб підтримувати надійну точку відліку, яка відповідає існуючій парності. @@ -1775,7 +1780,7 @@ PARITY — це одне з імен парності: `parity`, 9 Життєвий цикл знімків (SNAPSHOTS LIFECYCLE) ============================================= -SnapRAID керує двома конкретними знімками, `stable` та `pending`, +SnapRAID керує трьома конкретними знімками, `stable`, `pending` та `scan`, всередині прихованого каталогу в корінному каталозі кожного підтому даних. У Btrfs, Bcachefs та NTFS використовується каталог `.snapraid/`, у ZFS — стандартний `.zfs/snapshot/`. @@ -1785,8 +1790,12 @@ SnapRAID керує двома конкретними знімками, `stable` обчислення поточної парності. Він служить основним джерелом даних для команд `scrub`, `check` та `fix`. -Знімок `pending` — це тимчасовий образ, що створюється на початку -`sync` для забезпечення замороженого стану для обчислення парності. +Знімок `scan` — це тимчасовий образ, що створюється на початку +`sync` для забезпечення замороженого стану для сканування та обчислення парності. +Після сканування та збереження нового стану вмісту він замінює попередній +знімок `pending`. + +Знімок `pending` — це образ, використовуваний перерваною синхронізацією `sync`. Після успішного завершення операції попередній знімок `stable` видаляється, а знімок `pending` підвищується в статусі, щоб зайняти його місце в якості нового стабільного орієнтира. diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1 index aee9cd07..909405af 100644 --- a/doc/snapraid-zh.1 +++ b/doc/snapraid-zh.1 @@ -122,7 +122,7 @@ SnapRAID 是 RAID 和备份程序之间的混合体，旨在结合两者的最 .PD 0 .IP \(bu 具有快照支持（在 Btrfs、ZFS、Bcachefs 和 NTFS 上可用）， -SnapRAID 可以自动维护数据磁盘的冻结引用。 +SnapRAID 可以自动维护每个受支持的数据文件系统的独立冻结引用。 这确保了即使您在同步期间或之后在活动文件系统上修改或删除文件， 恢复过程仍保持一致且可靠。 .PD @@ -1297,8 +1297,9 @@ DIR 是磁盘在文件系统中的挂载点。 .SS snapshot 为 \`sync\`、\`scrub\`、\`check\` 和 \`fix\` 命令启用文件系统快照的使用。 .PP -启用后，SnapRAID 会在“sync”开始时创建数据的只读快照。 -这确保了文件在特定时间点的一致视图，从而防止由并发文件修改引起的错误。 +启用后，SnapRAID 会在“sync”开始时为每个受支持的数据文件系统创建 +只读快照。这提供了每个文件系统的稳定视图，防止后续修改改变用于 +计算校验的数据。 .PP 这显著提高了恢复能力：如果从实时文件系统中删除了一个文件， 它仍会保留在快照中。这可以防止该数据块的校验数据变得“损坏”， @@ -1643,8 +1644,8 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .PD .RE .SH 快照 (SNAPSHOTS) -如果配置中启用了快照选项，SnapRAID 将 -利用文件系统快照功能来确保原子操作和一致操作。 +如果配置中启用了快照选项，SnapRAID 将使用文件系统快照来保持操作期间 +读取的数据稳定，即使实时文件系统上的文件随后被修改或删除也是如此。 .PP 快照的管理是完全自动且透明的。 您可以完全像以前一样继续使用 SnapRAID，而快照提供的 @@ -1656,7 +1657,8 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .HP 4 .I 一致性 在运行时间较长的 sync 或 scrub 期间在活动文件系统上修改的文件 -不会导致校验不匹配或操作中止，因为 SnapRAID 看到的是一个冻结的时间点镜像。 +不会导致校验不匹配或操作中止，因为每个创建了快照的文件系统在操作期间 +都保持不变。 .HP 4 .I 恢复 如果从实时文件系统中更新或删除了一个文件， @@ -1690,10 +1692,11 @@ SnapRAID 还能自动从上一次校验计算的快照和当前的快照中读 快照的创建和删除需要管理权限。 启用快照时，请确保以必要的权限（例如 sudo）运行 SnapRAID。 .SS 快照的命令行为 -\`sync\` 和 \`scrub\` 命令都完全在快照上运行， -以确保所有数据操作都是针对一致的、冻结的状态进行的。通过利用这些快照， -SnapRAID 阻止了本由实时文件系统上的并发文件修改所触发的校验不匹配。 -在 \`sync\` 期间，该命令使用在过程开始时创建的新快照来捕获用于校验计算的当前状态。 +\`sync\` 和 \`scrub\` 命令对支持快照的文件系统的数据磁盘使用快照。 +在启用了快照的磁盘上，该命令看到的是一个不受实时文件系统并发更改影响的 +稳定文件系统镜像。 +在 \`sync\` 期间，会为每个受支持的数据文件系统独立创建新的快照。 +这些快照共同提供用于校验计算的数据。 相比之下，\`scrub\` 命令利用上一个快照（即在最近一次同步期间创建的快照） 来维持与现有校验匹配的可靠参考点。 .PP @@ -1713,8 +1716,8 @@ SnapRAID 也有一个稳定、冻结的参考来求解校验方程。 .PP 所有其他命令完全在实时文件系统上运行。 .SH 快照生命周期 (SNAPSHOTS LIFECYCLE) -SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定的快照： -\`stable\`（稳定）和 \`pending\`（待定）。 +SnapRAID 在每个数据子卷根目录下的隐藏目录中管理三个特定的快照： +\`stable\`（稳定）、\`pending\`（待定）和 \`scan\`（扫描）。 在 Btrfs、Bcachefs 和 NTFS 中使用 \`.snapraid/\` 目录， 在 ZFS 中使用标准的 \`.zfs/snapshot/\`。 .PP @@ -1722,10 +1725,13 @@ SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定 包含用于计算当前校验的准确数据。它作为 \`scrub\`、\`check\` 和 \`fix\` 命令的主要数据源。 .PP -\`pending\` 快照是在 \`sync\` 开始时创建的临时镜像， -用于为校验计算提供冻结状态。在操作成功完成后， -以前的 \`stable\` 快照将被删除，并且 \`pending\` 快照将被提升 -以接替其作为新的稳定参考。 +\`scan\` 快照是在 \`sync\` 开始时创建的临时镜像， +用于为扫描和校验计算提供冻结状态。在扫描并保存新的内容状态后， +它将替换以前的 \`pending\` 快照。 +.PP +\`pending\` 快照是中断的 \`sync\` 所使用的镜像。 +在操作成功完成后，以前的 \`stable\` 快照将被删除， +并且 \`pending\` 快照将被提升以接替其作为新的稳定参考。 .PP 如果 \`sync\` 中断，\`pending\` 快照将被保留。 随后的 \`scrub\`、\`check\` 和 \`fix\` 命令将使用此待定快照， diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d index b072f983..c10e45a5 100644 --- a/doc/snapraid-zh.d +++ b/doc/snapraid-zh.d @@ -55,7 +55,7 @@ Name{number} 对于上次同步时已经存在的数据，恢复的可靠性取决于是否使用了 `snapshot`（快照）选项： * 具有快照支持（在 Btrfs、ZFS、Bcachefs 和 NTFS 上可用）， - SnapRAID 可以自动维护数据磁盘的冻结引用。 + SnapRAID 可以自动维护每个受支持的数据文件系统的独立冻结引用。 这确保了即使您在同步期间或之后在活动文件系统上修改或删除文件， 恢复过程仍保持一致且可靠。 @@ -1013,8 +1013,9 @@ Name{number} snapshot 为 `sync`、`scrub`、`check` 和 `fix` 命令启用文件系统快照的使用。 - 启用后，SnapRAID 会在“sync”开始时创建数据的只读快照。 - 这确保了文件在特定时间点的一致视图，从而防止由并发文件修改引起的错误。 + 启用后，SnapRAID 会在“sync”开始时为每个受支持的数据文件系统创建 + 只读快照。这提供了每个文件系统的稳定视图，防止后续修改改变用于 + 计算校验的数据。 这显著提高了恢复能力：如果从实时文件系统中删除了一个文件， 它仍会保留在快照中。这可以防止该数据块的校验数据变得“损坏”， @@ -1258,8 +1259,8 @@ Name{number} :smartctl 2-parity -d areca,2/1 /dev/arcmsr0 快照 (Snapshots) - 如果配置中启用了快照选项，SnapRAID 将 - 利用文件系统快照功能来确保原子操作和一致操作。 + 如果配置中启用了快照选项，SnapRAID 将使用文件系统快照来保持操作期间 + 读取的数据稳定，即使实时文件系统上的文件随后被修改或删除也是如此。 快照的管理是完全自动且透明的。 您可以完全像以前一样继续使用 SnapRAID，而快照提供的 @@ -1268,7 +1269,8 @@ Name{number} 这提供了两个主要好处： 一致性 - 在运行时间较长的 sync 或 scrub 期间在活动文件系统上修改的文件 - 不会导致校验不匹配或操作中止，因为 SnapRAID 看到的是一个冻结的时间点镜像。 + 不会导致校验不匹配或操作中止，因为每个创建了快照的文件系统在操作期间 + 都保持不变。 恢复 - 如果从实时文件系统中更新或删除了一个文件， 它仍会保留在快照中。如果下次 sync 运行之前发生磁盘故障， SnapRAID 会使用快照中保留的数据来重建发生故障的磁盘。 @@ -1293,10 +1295,11 @@ Name{number} 启用快照时，请确保以必要的权限（例如 sudo）运行 SnapRAID。 快照的命令行为 - `sync` 和 `scrub` 命令都完全在快照上运行， - 以确保所有数据操作都是针对一致的、冻结的状态进行的。通过利用这些快照， - SnapRAID 阻止了本由实时文件系统上的并发文件修改所触发的校验不匹配。 - 在 `sync` 期间，该命令使用在过程开始时创建的新快照来捕获用于校验计算的当前状态。 + `sync` 和 `scrub` 命令对支持快照的文件系统的数据磁盘使用快照。 + 在启用了快照的磁盘上，该命令看到的是一个不受实时文件系统并发更改影响的 + 稳定文件系统镜像。 + 在 `sync` 期间，会为每个受支持的数据文件系统独立创建新的快照。 + 这些快照共同提供用于校验计算的数据。 相比之下，`scrub` 命令利用上一个快照（即在最近一次同步期间创建的快照） 来维持与现有校验匹配的可靠参考点。 @@ -1317,8 +1320,8 @@ Name{number} 所有其他命令完全在实时文件系统上运行。 快照生命周期 (Snapshots Lifecycle) - SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定的快照： - `stable`（稳定）和 `pending`（待定）。 + SnapRAID 在每个数据子卷根目录下的隐藏目录中管理三个特定的快照： + `stable`（稳定）、`pending`（待定）和 `scan`（扫描）。 在 Btrfs、Bcachefs 和 NTFS 中使用 `.snapraid/` 目录， 在 ZFS 中使用标准的 `.zfs/snapshot/`。 @@ -1326,10 +1329,13 @@ Name{number} 包含用于计算当前校验的准确数据。它作为 `scrub`、`check` 和 `fix` 命令的主要数据源。 - `pending` 快照是在 `sync` 开始时创建的临时镜像， - 用于为校验计算提供冻结状态。在操作成功完成后， - 以前的 `stable` 快照将被删除，并且 `pending` 快照将被提升 - 以接替其作为新的稳定参考。 + `scan` 快照是在 `sync` 开始时创建的临时镜像， + 用于为扫描和校验计算提供冻结状态。在扫描并保存新的内容状态后， + 它将替换以前的 `pending` 快照。 + + `pending` 快照是中断的 `sync` 所使用的镜像。 + 在操作成功完成后，以前的 `stable` 快照将被删除， + 并且 `pending` 快照将被提升以接替其作为新的稳定参考。 如果 `sync` 中断，`pending` 快照将被保留。 随后的 `scrub`、`check` 和 `fix` 命令将使用此待定快照， diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt index b90ef351..6276f279 100644 --- a/doc/snapraid-zh.txt +++ b/doc/snapraid-zh.txt @@ -65,7 +65,7 @@ SnapRAID 是 RAID 和备份程序之间的混合体，旨在结合两者的最 对于上次同步时已经存在的数据，恢复的可靠性取决于是否使用了 `snapshot`（快照）选项： * 具有快照支持（在 Btrfs、ZFS、Bcachefs 和 NTFS 上可用）， - SnapRAID 可以自动维护数据磁盘的冻结引用。 + SnapRAID 可以自动维护每个受支持的数据文件系统的独立冻结引用。 这确保了即使您在同步期间或之后在活动文件系统上修改或删除文件， 恢复过程仍保持一致且可靠。 @@ -1091,8 +1091,9 @@ DIR 是磁盘在文件系统中的挂载点。 为 `sync`、`scrub`、`check` 和 `fix` 命令启用文件系统快照的使用。 -启用后，SnapRAID 会在“sync”开始时创建数据的只读快照。 -这确保了文件在特定时间点的一致视图，从而防止由并发文件修改引起的错误。 +启用后，SnapRAID 会在“sync”开始时为每个受支持的数据文件系统创建 +只读快照。这提供了每个文件系统的稳定视图，防止后续修改改变用于 +计算校验的数据。 这显著提高了恢复能力：如果从实时文件系统中删除了一个文件， 它仍会保留在快照中。这可以防止该数据块的校验数据变得“损坏”， @@ -1363,8 +1364,8 @@ Windows 的典型配置示例如下： 8 快照 (SNAPSHOTS) ================ -如果配置中启用了快照选项，SnapRAID 将 -利用文件系统快照功能来确保原子操作和一致操作。 +如果配置中启用了快照选项，SnapRAID 将使用文件系统快照来保持操作期间 +读取的数据稳定，即使实时文件系统上的文件随后被修改或删除也是如此。 快照的管理是完全自动且透明的。 您可以完全像以前一样继续使用 SnapRAID，而快照提供的 @@ -1373,7 +1374,8 @@ Windows 的典型配置示例如下： 这提供了两个主要好处： 一致性 - 在运行时间较长的 sync 或 scrub 期间在活动文件系统上修改的文件 - 不会导致校验不匹配或操作中止，因为 SnapRAID 看到的是一个冻结的时间点镜像。 + 不会导致校验不匹配或操作中止，因为每个创建了快照的文件系统在操作期间 + 都保持不变。 恢复 - 如果从实时文件系统中更新或删除了一个文件， 它仍会保留在快照中。如果下次 sync 运行之前发生磁盘故障， SnapRAID 会使用快照中保留的数据来重建发生故障的磁盘。 @@ -1400,10 +1402,11 @@ Windows 的典型配置示例如下： 8.1 快照的命令行为 ----------- -`sync` 和 `scrub` 命令都完全在快照上运行， -以确保所有数据操作都是针对一致的、冻结的状态进行的。通过利用这些快照， -SnapRAID 阻止了本由实时文件系统上的并发文件修改所触发的校验不匹配。 -在 `sync` 期间，该命令使用在过程开始时创建的新快照来捕获用于校验计算的当前状态。 +`sync` 和 `scrub` 命令对支持快照的文件系统的数据磁盘使用快照。 +在启用了快照的磁盘上，该命令看到的是一个不受实时文件系统并发更改影响的 +稳定文件系统镜像。 +在 `sync` 期间，会为每个受支持的数据文件系统独立创建新的快照。 +这些快照共同提供用于校验计算的数据。 相比之下，`scrub` 命令利用上一个快照（即在最近一次同步期间创建的快照） 来维持与现有校验匹配的可靠参考点。 @@ -1427,8 +1430,8 @@ SnapRAID 也有一个稳定、冻结的参考来求解校验方程。 9 快照生命周期 (SNAPSHOTS LIFECYCLE) ============================== -SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定的快照： -`stable`（稳定）和 `pending`（待定）。 +SnapRAID 在每个数据子卷根目录下的隐藏目录中管理三个特定的快照： +`stable`（稳定）、`pending`（待定）和 `scan`（扫描）。 在 Btrfs、Bcachefs 和 NTFS 中使用 `.snapraid/` 目录， 在 ZFS 中使用标准的 `.zfs/snapshot/`。 @@ -1436,10 +1439,13 @@ SnapRAID 在每个数据子卷根目录下的隐藏目录中管理两个特定 包含用于计算当前校验的准确数据。它作为 `scrub`、`check` 和 `fix` 命令的主要数据源。 -`pending` 快照是在 `sync` 开始时创建的临时镜像， -用于为校验计算提供冻结状态。在操作成功完成后， -以前的 `stable` 快照将被删除，并且 `pending` 快照将被提升 -以接替其作为新的稳定参考。 +`scan` 快照是在 `sync` 开始时创建的临时镜像， +用于为扫描和校验计算提供冻结状态。在扫描并保存新的内容状态后， +它将替换以前的 `pending` 快照。 + +`pending` 快照是中断的 `sync` 所使用的镜像。 +在操作成功完成后，以前的 `stable` 快照将被删除， +并且 `pending` 快照将被提升以接替其作为新的稳定参考。 如果 `sync` 中断，`pending` 快照将被保留。 随后的 `scrub`、`check` 和 `fix` 命令将使用此待定快照， diff --git a/doc/snapraid.1 b/doc/snapraid.1 index a306f52b..50389953 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -133,7 +133,8 @@ on whether the \`snapshot\` option is used: .PD 0 .IP \(bu With snapshot support (available on Btrfs, ZFS, Bcachefs, and NTFS), -SnapRAID can automatically maintain a frozen reference of your data disks. +SnapRAID can automatically maintain an independent frozen reference +of each supported data filesystem. This ensures that even if you modify or delete files on your live filesystem during or after a sync, the recovery process remains consistent and reliable. @@ -1443,9 +1444,10 @@ because they are expected to be always spinning. Enable the use of filesystem snapshots for the \`sync\`, \`scrub\`, \`check\`, and \`fix\` commands. .PP -When enabled, SnapRAID creates a read\-only snapshot of your data at the -start of a \'sync\'. This ensures a consistent, point\-in\-time view of your -files, preventing errors caused by concurrent file modifications. +When enabled, SnapRAID creates a read\-only snapshot of each supported +data filesystem at the start of a \'sync\'. This provides a stable view of +each filesystem, preventing later modifications from changing the data +used for parity computation. .PP This significantly improves recovery: if a file is deleted from the live filesystem, it remains preserved in the snapshot. This prevents the parity @@ -1814,8 +1816,9 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 .RE .SH SNAPSHOTS If the snapshot option is enabled in the configuration, SnapRAID -utilizes filesystem snapshot functionality to ensure atomic and -consistent operations. +uses filesystem snapshots to keep the data read during an operation +stable, even when files on the live filesystems are subsequently +modified or deleted. .PP The management of snapshots is completely automatic and transparent. You can continue to use SnapRAID exactly as before, with the @@ -1829,7 +1832,8 @@ This provides two primary benefits: .I Consistency Files modified on the live filesystem during a long\-running sync or scrub will not cause parity mismatches or aborted -operations, as SnapRAID sees a frozen point\-in\-time image. +operations, because each snapshotted filesystem remains unchanged +for the duration of the operation. .HP 4 .I Recovery If a file is updated or deleted from the live filesystem, @@ -1872,13 +1876,13 @@ Snapshot creation and deletion require administrative privileges. Ensure SnapRAID is run with the necessary permissions (e.g., sudo) when snapshots are enabled. .SS Command Behavior with Snapshots -The \`sync\` and \`scrub\` commands both operate exclusively on snapshots -to ensure that all data operations are performed against a consistent, -frozen state. By utilizing these snapshots, SnapRAID prevents parity -mismatches that would otherwise be triggered by concurrent file -modifications on the live filesystem. -During a \`sync\`, the command uses a new snapshot created at the -start of the process to capture the current state for parity computation. +The \`sync\` and \`scrub\` commands use snapshots for data disks whose +filesystems support them. On a snapshotted disk, the command sees +a stable filesystem image unaffected by concurrent changes to the +live filesystem. +During a \`sync\`, a new snapshot is created independently for each +supported data filesystem. These snapshots collectively provide the +data used for parity computation. In contrast, the \`scrub\` command utilizes the last snapshot, the one created during the most recent sync, to maintain a reliable reference point that matches the existing parity. @@ -1903,7 +1907,7 @@ live filesystems exclusively. .PP All other commands operate exclusively on the live filesystem. .SH SNAPSHOTS LIFECYCLE -SnapRAID manages two specific snapshots, \`stable\` and \`pending\`, +SnapRAID manages three specific snapshots, \`stable\`, \`pending\`, and \`scan\`, within a hidden directory at the root of each data subvolume. In Btrfs, Bcachefs, and NTFS it\'s used the \`.snapraid/\` directory, in ZFS the standard \`.zfs/snapshot/\`. @@ -1913,8 +1917,12 @@ successfully completed \`sync\`, containing the exact data used to compute the current parity. It serves as the primary data source for \`scrub\`, \`check\`, and \`fix\` commands. .PP -The \`pending\` snapshot is a temporary image created at the start -of a \`sync\` to provide a frozen state for parity computation. +The \`scan\` snapshot is a temporary image created at the start +of a \`sync\` to provide a frozen state for scanning and parity computation. +After scanning and saving the new content state, it replaces the previous +\`pending\` snapshot. +.PP +The \`pending\` snapshot is the image used by an interrupted sync. Upon successful completion of the operation, the previous \`stable\` snapshot is deleted, and the \`pending\` snapshot is promoted to take its place as the new stable reference. diff --git a/doc/snapraid.d b/doc/snapraid.d index 3970ddd5..f041ff17 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -66,7 +66,8 @@ Limitations on whether the `snapshot` option is used: * With snapshot support (available on Btrfs, ZFS, Bcachefs, and NTFS), - SnapRAID can automatically maintain a frozen reference of your data disks. + SnapRAID can automatically maintain an independent frozen reference + of each supported data filesystem. This ensures that even if you modify or delete files on your live filesystem during or after a sync, the recovery process remains consistent and reliable. @@ -1159,9 +1160,10 @@ Configuration Enable the use of filesystem snapshots for the `sync`, `scrub`, `check`, and `fix` commands. - When enabled, SnapRAID creates a read-only snapshot of your data at the - start of a 'sync'. This ensures a consistent, point-in-time view of your - files, preventing errors caused by concurrent file modifications. + When enabled, SnapRAID creates a read-only snapshot of each supported + data filesystem at the start of a 'sync'. This provides a stable view of + each filesystem, preventing later modifications from changing the data + used for parity computation. This significantly improves recovery: if a file is deleted from the live filesystem, it remains preserved in the snapshot. This prevents the parity @@ -1429,8 +1431,9 @@ Configuration Snapshots If the snapshot option is enabled in the configuration, SnapRAID - utilizes filesystem snapshot functionality to ensure atomic and - consistent operations. + uses filesystem snapshots to keep the data read during an operation + stable, even when files on the live filesystems are subsequently + modified or deleted. The management of snapshots is completely automatic and transparent. You can continue to use SnapRAID exactly as before, with the @@ -1441,7 +1444,8 @@ Snapshots Consistency - Files modified on the live filesystem during a long-running sync or scrub will not cause parity mismatches or aborted - operations, as SnapRAID sees a frozen point-in-time image. + operations, because each snapshotted filesystem remains unchanged + for the duration of the operation. Recovery - If a file is updated or deleted from the live filesystem, it remains preserved in the snapshot. If a disk failure occurs before the next sync is run, SnapRAID uses the data preserved @@ -1475,13 +1479,13 @@ Snapshots when snapshots are enabled. Command Behavior with Snapshots - The `sync` and `scrub` commands both operate exclusively on snapshots - to ensure that all data operations are performed against a consistent, - frozen state. By utilizing these snapshots, SnapRAID prevents parity - mismatches that would otherwise be triggered by concurrent file - modifications on the live filesystem. - During a `sync`, the command uses a new snapshot created at the - start of the process to capture the current state for parity computation. + The `sync` and `scrub` commands use snapshots for data disks whose + filesystems support them. On a snapshotted disk, the command sees + a stable filesystem image unaffected by concurrent changes to the + live filesystem. + During a `sync`, a new snapshot is created independently for each + supported data filesystem. These snapshots collectively provide the + data used for parity computation. In contrast, the `scrub` command utilizes the last snapshot, the one created during the most recent sync, to maintain a reliable reference point that matches the existing parity. @@ -1507,7 +1511,7 @@ Snapshots All other commands operate exclusively on the live filesystem. Snapshots Lifecycle - SnapRAID manages two specific snapshots, `stable` and `pending`, + SnapRAID manages three specific snapshots, `stable`, `pending`, and `scan`, within a hidden directory at the root of each data subvolume. In Btrfs, Bcachefs, and NTFS it's used the `.snapraid/` directory, in ZFS the standard `.zfs/snapshot/`. @@ -1517,8 +1521,12 @@ Snapshots Lifecycle compute the current parity. It serves as the primary data source for `scrub`, `check`, and `fix` commands. - The `pending` snapshot is a temporary image created at the start - of a `sync` to provide a frozen state for parity computation. + The `scan` snapshot is a temporary image created at the start + of a `sync` to provide a frozen state for scanning and parity computation. + After scanning and saving the new content state, it replaces the previous + `pending` snapshot. + + The `pending` snapshot is the image used by an interrupted sync. Upon successful completion of the operation, the previous `stable` snapshot is deleted, and the `pending` snapshot is promoted to take its place as the new stable reference. diff --git a/doc/snapraid.txt b/doc/snapraid.txt index 72646941..eff229eb 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -76,7 +76,8 @@ For data that already existed at the last sync, recovery reliability depends on whether the `snapshot` option is used: * With snapshot support (available on Btrfs, ZFS, Bcachefs, and NTFS), - SnapRAID can automatically maintain a frozen reference of your data disks. + SnapRAID can automatically maintain an independent frozen reference + of each supported data filesystem. This ensures that even if you modify or delete files on your live filesystem during or after a sync, the recovery process remains consistent and reliable. @@ -1237,9 +1238,10 @@ because they are expected to be always spinning. Enable the use of filesystem snapshots for the `sync`, `scrub`, `check`, and `fix` commands. -When enabled, SnapRAID creates a read-only snapshot of your data at the -start of a 'sync'. This ensures a consistent, point-in-time view of your -files, preventing errors caused by concurrent file modifications. +When enabled, SnapRAID creates a read-only snapshot of each supported +data filesystem at the start of a 'sync'. This provides a stable view of +each filesystem, preventing later modifications from changing the data +used for parity computation. This significantly improves recovery: if a file is deleted from the live filesystem, it remains preserved in the snapshot. This prevents the parity @@ -1534,8 +1536,9 @@ An example of a typical configuration for Windows is: =========== If the snapshot option is enabled in the configuration, SnapRAID -utilizes filesystem snapshot functionality to ensure atomic and -consistent operations. +uses filesystem snapshots to keep the data read during an operation +stable, even when files on the live filesystems are subsequently +modified or deleted. The management of snapshots is completely automatic and transparent. You can continue to use SnapRAID exactly as before, with the @@ -1546,7 +1549,8 @@ This provides two primary benefits: Consistency - Files modified on the live filesystem during a long-running sync or scrub will not cause parity mismatches or aborted - operations, as SnapRAID sees a frozen point-in-time image. + operations, because each snapshotted filesystem remains unchanged + for the duration of the operation. Recovery - If a file is updated or deleted from the live filesystem, it remains preserved in the snapshot. If a disk failure occurs before the next sync is run, SnapRAID uses the data preserved @@ -1582,13 +1586,13 @@ when snapshots are enabled. 8.1 Command Behavior with Snapshots ----------------------------------- -The `sync` and `scrub` commands both operate exclusively on snapshots -to ensure that all data operations are performed against a consistent, -frozen state. By utilizing these snapshots, SnapRAID prevents parity -mismatches that would otherwise be triggered by concurrent file -modifications on the live filesystem. -During a `sync`, the command uses a new snapshot created at the -start of the process to capture the current state for parity computation. +The `sync` and `scrub` commands use snapshots for data disks whose +filesystems support them. On a snapshotted disk, the command sees +a stable filesystem image unaffected by concurrent changes to the +live filesystem. +During a `sync`, a new snapshot is created independently for each +supported data filesystem. These snapshots collectively provide the +data used for parity computation. In contrast, the `scrub` command utilizes the last snapshot, the one created during the most recent sync, to maintain a reliable reference point that matches the existing parity. @@ -1617,7 +1621,7 @@ All other commands operate exclusively on the live filesystem. 9 SNAPSHOTS LIFECYCLE ===================== -SnapRAID manages two specific snapshots, `stable` and `pending`, +SnapRAID manages three specific snapshots, `stable`, `pending`, and `scan`, within a hidden directory at the root of each data subvolume. In Btrfs, Bcachefs, and NTFS it's used the `.snapraid/` directory, in ZFS the standard `.zfs/snapshot/`. @@ -1627,8 +1631,12 @@ successfully completed `sync`, containing the exact data used to compute the current parity. It serves as the primary data source for `scrub`, `check`, and `fix` commands. -The `pending` snapshot is a temporary image created at the start -of a `sync` to provide a frozen state for parity computation. +The `scan` snapshot is a temporary image created at the start +of a `sync` to provide a frozen state for scanning and parity computation. +After scanning and saving the new content state, it replaces the previous +`pending` snapshot. + +The `pending` snapshot is the image used by an interrupted sync. Upon successful completion of the operation, the previous `stable` snapshot is deleted, and the `pending` snapshot is promoted to take its place as the new stable reference.