From c640a98b7144530db03e0ae26dad9e02076869f1 Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Fri, 12 Dec 2025 11:57:38 +0100 Subject: [PATCH] Auto update --- manual-de.html | 2120 ++++++++++++++++++++++++++++++++++++++++++++++++ manual-es.html | 2067 ++++++++++++++++++++++++++++++++++++++++++++++ manual-fr.html | 2119 +++++++++++++++++++++++++++++++++++++++++++++++ manual-it.html | 2097 +++++++++++++++++++++++++++++++++++++++++++++++ manual-pl.html | 1980 ++++++++++++++++++++++++++++++++++++++++++++ manual-ro.html | 1989 +++++++++++++++++++++++++++++++++++++++++++++ manual.html | 351 ++++---- 7 files changed, 12550 insertions(+), 173 deletions(-) create mode 100644 manual-de.html create mode 100644 manual-es.html create mode 100644 manual-fr.html create mode 100644 manual-it.html create mode 100644 manual-pl.html create mode 100644 manual-ro.html diff --git a/manual-de.html b/manual-de.html new file mode 100644 index 00000000..13db6db8 --- /dev/null +++ b/manual-de.html @@ -0,0 +1,2120 @@ + + + + + + + + + + + + + +SnapRAID + + + + + + + + + + + + +
+ + + +

+German manual for SnapRAID. +

+ +

1 +Synopsis +

+
+snapraid [-c, --conf CONFIG]
+    [-f, --filter PATTERN] [-d, --filter-disk NAME]
+    [-m, --filter-missing] [-e, --filter-error]
+    [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
+    [-p, --plan PERC|bad|new|full]
+    [-o, --older-than DAYS] [-l, --log FILE]
+    [-s, --spin-down-on-error] [-w, --bw-limit RATE]
+    [-Z, --force-zero] [-E, --force-empty]
+    [-U, --force-uuid] [-D, --force-device]
+    [-N, --force-nocopy] [-F, --force-full]
+    [-R, --force-realloc]
+    [-S, --start BLKSTART] [-B, --count BLKCOUNT]
+    [-L, --error-limit NUMBER]
+    [-A, --stats]
+    [-v, --verbose] [-q, --quiet]
+    status|smart|probe|up|down|diff|sync|scrub|fix|check
+    |list|dup|pool|devices|touch|rehash
+
+

+

+snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]
+
+

2 +Description +

+SnapRAID ist ein Sicherungsprogramm, das für Festplatten-Arrays +entwickelt wurde und Paritätsinformationen zur Datenwiederherstellung +bei Ausfall von bis zu sechs Festplatten speichert. +

+SnapRAID ist hauptsächlich für Home-Media-Center mit großen, +selten geänderten Dateien konzipiert und bietet folgende Funktionen: +

+

+Für weitere Informationen besuchen Sie bitte die offizielle SnapRAID-Website: +

+
+
+https://www.snapraid.it/
+
+
+

3 +Limitations +

+SnapRAID ist ein Hybrid aus einem RAID- und einem Sicherungsprogramm, +das darauf abzielt, die besten Vorteile beider zu kombinieren. +Es hat jedoch einige Einschränkungen, die Sie vor der Verwendung +berücksichtigen sollten. +

+Die Haupteinschränkung besteht darin, dass wenn eine Festplatte +ausfällt und Sie in letzter Zeit keine Synchronisierung durchgeführt haben, +Sie möglicherweise nicht vollständig wiederherstellen können. +Genauer gesagt können Sie möglicherweise nicht bis zur Größe der +geänderten oder gelöschten Dateien seit der letzten `sync`-Operation +wiederherstellen. Dies tritt auch dann auf, wenn die geänderten oder +gelöschten Dateien sich nicht auf der ausgefallenen Festplatte befinden. +Aus diesem Grund ist SnapRAID besser für Daten geeignet, die sich +selten ändern. +

+Andererseits verhindern neu hinzugefügte Dateien die Wiederherstellung +von bereits vorhandenen Dateien nicht. Sie verlieren nur die +kürzlich hinzugefügten Dateien, wenn diese sich auf der ausgefallenen +Festplatte befinden. +

+Weitere Einschränkungen von SnapRAID sind: +

+

4 +Getting Started +

+Um SnapRAID zu verwenden, müssen Sie zuerst eine Festplatte in Ihrem +Festplatten-Array auswählen, die für `parity`-Informationen +reserviert wird. Mit einer Festplatte für Parität können Sie von +einem einzelnen Festplattenausfall wiederherstellen, ähnlich wie bei RAID5. +

+Wenn Sie von mehr Festplattenausfällen wiederherstellen möchten, +ähnlich wie bei RAID6, müssen Sie zusätzliche Festplatten für Parität +reservieren. Jede zusätzliche Paritätsfestplatte ermöglicht die +Wiederherstellung von einem weiteren Festplattenausfall. +

+Als Paritätsfestplatten müssen Sie die größten Festplatten im Array +auswählen, da die Paritätsinformationen auf die Größe der größten +Datenfestplatte im Array anwachsen können. +

+Diese Festplatten werden zum Speichern der `parity`-Dateien +reserviert. Sie sollten Ihre Daten nicht darauf speichern. +

+Anschließend müssen Sie die `data`-Festplatten definieren, die Sie +mit SnapRAID schützen möchten. Der Schutz ist effektiver, wenn diese +Festplatten Daten enthalten, die sich selten ändern. Aus diesem Grund +ist es besser, die Windows C:\-Festplatte oder die Unix-Verzeichnisse +/home, /var und /tmp NICHT einzuschließen. +

+Die Liste der Dateien wird in den `content`-Dateien gespeichert, +die normalerweise auf den Daten-, Paritäts- oder Boot-Festplatten +gespeichert werden. Diese Datei enthält die Details Ihrer Sicherung, +einschließlich aller Prüfsummen zur Überprüfung ihrer Integrität. +Die `content`-Datei wird in mehreren Kopien gespeichert, und jede Kopie +muss sich auf einer anderen Festplatte befinden, um sicherzustellen, +dass selbst bei mehreren Festplattenausfällen mindestens eine Kopie +verfügbar ist. +

+Angenommen, Sie sind nur an einer Paritätsstufe des Schutzes interessiert +und Ihre Festplatten befinden sich unter: +

+
+
+/mnt/diskp <- ausgewählte Festplatte für Parität
+/mnt/disk1 <- erste zu schützende Festplatte
+/mnt/disk2 <- zweite zu schützende Festplatte
+/mnt/disk3 <- dritte zu schützende Festplatte
+
+
+

+Sie müssen die Konfigurationsdatei /etc/snapraid.conf mit den +folgenden Optionen erstellen: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /var/snapraid/snapraid.content
+content /mnt/disk1/snapraid.content
+content /mnt/disk2/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+
+
+

+Wenn Sie Windows verwenden, sollten Sie das Windows-Pfadformat mit +Laufwerksbuchstaben und Backslashes anstelle von Slashes verwenden. +

+
+
+parity E:\snapraid.parity
+content C:\snapraid\snapraid.content
+content F:\array\snapraid.content
+content G:\array\snapraid.content
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+
+
+

+Wenn Sie viele Festplatten haben und keine Laufwerksbuchstaben mehr +verfügbar sind, können Sie Festplatten direkt in Unterordnern +einhängen (mounten). Siehe: +

+
+
+https://www.google.com/search?q=Windows+mount+point
+
+
+

+Zu diesem Zeitpunkt sind Sie bereit, den Befehl `sync` auszuführen, +um die Paritätsinformationen zu erstellen. +

+
+
+snapraid sync
+
+
+

+Dieser Vorgang kann beim ersten Mal mehrere Stunden dauern, abhängig +von der Größe der bereits auf den Festplatten vorhandenen Daten. +Wenn die Festplatten leer sind, ist der Vorgang sofort abgeschlossen. +

+Sie können ihn jederzeit durch Drücken von Strg+C anhalten, und beim +nächsten Lauf wird er dort fortgesetzt, wo er unterbrochen wurde. +

+Wenn dieser Befehl abgeschlossen ist, sind Ihre Daten SICHER. +

+Jetzt können Sie Ihr Array nach Belieben verwenden und die Paritätsinformationen +regelmäßig durch Ausführen des `sync`-Befehls aktualisieren. +

4.1 +Scrubbing +

+Um die Daten und die Parität regelmäßig auf Fehler zu überprüfen, +können Sie den Befehl `scrub` ausführen. +

+
+
+snapraid scrub
+
+
+

+Dieser Befehl vergleicht die Daten in Ihrem Array mit dem Hash, +der während des `sync`-Befehls berechnet wurde, um die Integrität +zu überprüfen. +

+Jeder Lauf des Befehls überprüft ungefähr 8% des Arrays, +ausgenommen Daten, die bereits in den letzten 10 Tagen gescrubbed wurden. +Sie können die Option -p, --plan verwenden, um eine andere Menge +anzugeben, und die Option -o, --older-than, um ein anderes Alter +in Tagen anzugeben. Zum Beispiel, um 5% des Arrays auf Blöcke zu +überprüfen, die älter als 20 Tage sind, verwenden Sie: +

+
+
+snapraid -p 5 -o 20 scrub
+
+
+

+Wenn während des Vorgangs stille oder Eingabe-/Ausgabefehler +gefunden werden, werden die entsprechenden Blöcke in der +`content`-Datei als fehlerhaft (bad) markiert und im Befehl +`status` aufgelistet. +

+
+
+snapraid status
+
+
+

+Um sie zu beheben, können Sie den Befehl `fix` verwenden und dabei +nach fehlerhaften Blöcken mit der Option -e, --filter-error +filtern: +

+
+
+snapraid -e fix
+
+
+

+Beim nächsten `scrub` verschwinden die Fehler aus dem `status`-Bericht, +wenn sie tatsächlich behoben sind. Um es schneller zu machen, +können Sie -p bad verwenden, um nur als fehlerhaft markierte Blöcke +zu scrubben. +

+
+
+snapraid -p bad scrub
+
+
+

+Das Ausführen von `scrub` auf einem nicht synchronisierten Array +kann Fehler melden, die durch entfernte oder geänderte Dateien +verursacht wurden. Diese Fehler werden in der `scrub`-Ausgabe +gemeldet, aber die zugehörigen Blöcke werden nicht als fehlerhaft +markiert. +

4.2 +Pooling +

+Hinweis: Die unten beschriebene Pooling-Funktion wurde durch das +Tool mergefs ersetzt, das jetzt die empfohlene Option für Linux-Benutzer +in der SnapRAID-Community ist. Mergefs bietet eine flexiblere +und effizientere Möglichkeit, mehrere Laufwerke zu einem einzigen, +vereinheitlichten Einhängepunkt (Mount Point) zusammenzufassen, +was einen nahtlosen Zugriff auf Dateien über Ihr gesamtes Array +hinweg ermöglicht, ohne auf symbolische Links angewiesen zu sein. +Es lässt sich gut mit SnapRAID zum Paritätsschutz integrieren und +wird häufig in Setups wie OpenMediaVault (OMV) oder benutzerdefinierten +NAS-Konfigurationen verwendet. +

+Um alle Dateien in Ihrem Array im selben Verzeichnisbaum anzuzeigen, +können Sie die `pooling`-Funktion aktivieren. Sie erstellt eine +schreibgeschützte virtuelle Ansicht aller Dateien in Ihrem Array +mithilfe symbolischer Links. +

+Sie können das `pooling`-Verzeichnis in der Konfigurationsdatei +mit folgender Option konfigurieren: +

+
+
+pool /pool
+
+
+

+oder, wenn Sie Windows verwenden, mit: +

+
+
+pool C:\pool
+
+
+

+und anschließend den Befehl `pool` ausführen, um die virtuelle +Ansicht zu erstellen oder zu aktualisieren. +

+
+
+snapraid pool
+
+
+

+Wenn Sie eine Unix-Plattform verwenden und dieses Verzeichnis über +das Netzwerk für Windows- oder Unix-Maschinen freigeben möchten, +sollten Sie die folgenden Optionen zu Ihrer /etc/samba/smb.conf +hinzufügen: +

+
+
+# Im globalen Abschnitt von smb.conf
+unix extensions = no
+
+
+

+
+
+# Im Freigabe-Abschnitt von smb.conf
+[pool]
+comment = Pool
+path = /pool
+read only = yes
+guest ok = yes
+wide links = yes
+follow symlinks = yes
+
+
+

+In Windows erfordert die Freigabe symbolischer Links über ein Netzwerk, +dass Clients diese remote auflösen. Um dies zu ermöglichen, +müssen Sie neben der Freigabe des Pool-Verzeichnisses auch alle +Festplatten unabhängig freigeben, indem Sie die in der Konfigurationsdatei +definierten Festplattennamen als Freigabepunkte verwenden. +Sie müssen auch in der Option `share` der Konfigurationsdatei +den Windows UNC-Pfad angeben, den Remote-Clients benötigen, um +auf diese freigegebenen Festplatten zuzugreifen. +

+Zum Beispiel, wenn Sie von einem Server namens `darkstar` aus +arbeiten, können Sie die Optionen verwenden: +

+
+
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+pool C:\pool
+share \\darkstar
+
+
+

+und die folgenden Verzeichnisse über das Netzwerk freigeben: +

+
+
+\\darkstar\pool -> C:\pool
+\\darkstar\d1 -> F:\array
+\\darkstar\d2 -> G:\array
+\\darkstar\d3 -> H:\array
+
+
+

+um Remote-Clients den Zugriff auf alle Dateien unter \\darkstar\pool +zu ermöglichen. +

+Möglicherweise müssen Sie auch Remote-Clients konfigurieren, um +den Zugriff auf Remote-Symlinks mit dem Befehl zu aktivieren: +

+
+
+fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
+
+
+

4.3 +Undeleting +

+SnapRAID funktioniert eher wie ein Sicherungsprogramm als ein RAID-System +und kann verwendet werden, um Dateien in ihren vorherigen Zustand +wiederherzustellen oder das Löschen rückgängig zu machen, indem die +Option -f, --filter verwendet wird: +

+
+
+snapraid fix -f DATEI
+
+
+

+oder für ein Verzeichnis: +

+
+
+snapraid fix -f VERZEICHNIS/
+
+
+

+Sie können es auch verwenden, um nur versehentlich gelöschte Dateien +innerhalb eines Verzeichnisses wiederherzustellen, indem Sie die +Option -m, --filter-missing verwenden, die nur fehlende Dateien +wiederherstellt und alle anderen unberührt lässt. +

+
+
+snapraid fix -m -f VERZEICHNIS/
+
+
+

+Oder um alle gelöschten Dateien auf allen Laufwerken wiederherzustellen mit: +

+
+
+snapraid fix -m
+
+
+

4.4 +Recovering +

+Das Schlimmste ist passiert, und Sie haben eine oder mehrere Festplatten +verloren! +

+KEINE PANIK! Sie werden in der Lage sein, sie wiederherzustellen! +

+Das erste, was Sie tun müssen, ist, weitere Änderungen an Ihrem +Festplatten-Array zu vermeiden. Deaktivieren Sie alle Remote-Verbindungen +dazu und alle geplanten Prozesse, einschließlich geplanter SnapRAID-nächtlicher +`sync`- oder `scrub`-Läufe. +

+Fahren Sie dann mit den folgenden Schritten fort. +

4.4.1 +STEP 1 -> Reconfigure +

+Sie benötigen etwas Platz zur Wiederherstellung, idealerweise auf +zusätzlichen Ersatzfestplatten, aber eine externe USB-Festplatte oder +eine Remote-Festplatte ist ausreichend. +

+Ändern Sie die SnapRAID-Konfigurationsdatei so, dass die `data`- +oder `parity`-Option der ausgefallenen Festplatte auf einen Ort mit +genügend leerem Speicherplatz zur Wiederherstellung der Dateien zeigt. +

+Wenn zum Beispiel die Festplatte `d1` ausgefallen ist, ändern Sie von: +

+
+
+data d1 /mnt/disk1/
+
+
+

+zu: +

+
+
+data d1 /mnt/new_spare_disk/
+
+
+

+Wenn die wiederherzustellende Festplatte eine Paritätsfestplatte ist, +aktualisieren Sie die entsprechende `parity`-Option. +Wenn Sie mehrere ausgefallene Festplatten haben, aktualisieren Sie +alle ihre Konfigurationsoptionen. +

4.4.2 +STEP 2 -> Fix +

+Führen Sie den `fix`-Befehl aus und speichern Sie das Protokoll +in einer externen Datei mit: +

+
+
+snapraid -d NAME -l fix.log fix
+
+
+

+Wobei NAME der Name der Festplatte ist, wie z.B. `d1` in unserem +vorherigen Beispiel. Wenn die wiederherzustellende Festplatte eine +Paritätsfestplatte ist, verwenden Sie die Namen `parity`, `2-parity`, +usw. Wenn Sie mehrere ausgefallene Festplatten haben, verwenden Sie +mehrere -d-Optionen, um alle anzugeben. +

+Dieser Befehl wird lange dauern. +

+Stellen Sie sicher, dass Sie einige Gigabyte frei haben, um die +Datei fix.log zu speichern. Führen Sie ihn von einer Festplatte +mit ausreichend freiem Speicherplatz aus. +

+Jetzt haben Sie alles wiederhergestellt, was wiederherstellbar ist. +Wenn einige Dateien teilweise oder vollständig nicht wiederherstellbar +sind, werden sie umbenannt, indem die Erweiterung `.unrecoverable` +hinzugefügt wird. +

+Sie finden eine detaillierte Liste aller nicht wiederherstellbaren +Blöcke in der Datei fix.log, indem Sie alle Zeilen überprüfen, +die mit `unrecoverable:` beginnen. +

+Wenn Sie mit der Wiederherstellung nicht zufrieden sind, können Sie +sie so oft wie gewünscht wiederholen. +

+Wenn Sie zum Beispiel Dateien nach dem letzten `sync` aus dem Array +entfernt haben, kann dies dazu führen, dass einige Dateien nicht +wiederhergestellt werden. In diesem Fall können Sie den `fix` +mithilfe der Option -i, --import wiederholen, wobei Sie angeben, +wo sich diese Dateien jetzt befinden, um sie erneut in den +Wiederherstellungsprozess einzubeziehen. +

+Wenn Sie mit der Wiederherstellung zufrieden sind, können Sie +fortfahren, aber beachten Sie, dass Sie nach der Synchronisierung +den `fix`-Befehl nicht mehr wiederholen können! +

4.4.3 +STEP 3 -> Check +

+Als vorsichtige Überprüfung können Sie jetzt einen `check`-Befehl +ausführen, um sicherzustellen, dass auf der wiederhergestellten +Festplatte alles korrekt ist. +

+
+
+snapraid -d NAME -a check
+
+
+

+Wobei NAME der Name der Festplatte ist, wie z.B. `d1` in unserem +vorherigen Beispiel. +

+Die Optionen -d und -a weisen SnapRAID an, nur die angegebene +Festplatte zu überprüfen und alle Paritätsdaten zu ignorieren. +

+Dieser Befehl wird lange dauern, aber wenn Sie nicht übermäßig +vorsichtig sind, können Sie ihn überspringen. +

4.4.4 +STEP 4 -> Sync +

+Führen Sie den `sync`-Befehl aus, um das Array mit der neuen +Festplatte zu resynchronisieren. +

+
+
+snapraid sync
+
+
+

+Wenn alles wiederhergestellt ist, ist dieser Befehl sofort. +

5 +Commands +

+SnapRAID bietet einige einfache Befehle, mit denen Sie: + +

+Befehle müssen in Kleinbuchstaben geschrieben werden. +

5.1 +status +

+Gibt eine Zusammenfassung des Zustands des Festplatten-Arrays aus. +

+Es enthält Informationen zur Paritätsfragmentierung, wie alt +die Blöcke sind, ohne Überprüfung, und alle aufgezeichneten +stillen Fehler, die beim Scrubbing aufgetreten sind. +

+Die präsentierten Informationen beziehen sich auf den letzten Zeitpunkt, +zu dem Sie `sync` ausgeführt haben. Spätere Änderungen werden +nicht berücksichtigt. +

+Wenn fehlerhafte Blöcke erkannt wurden, werden deren Blocknummern +aufgelistet. Um sie zu beheben, können Sie den Befehl `fix -e` +verwenden. +

+Es zeigt auch ein Diagramm an, das den letzten Zeitpunkt darstellt, +zu dem jeder Block gescrubbed oder synchronisiert wurde. Gescrubbed +Blöcke werden mit '*', Blöcke, die synchronisiert, aber noch nicht +gescrubbed wurden, mit 'o' angezeigt. +

+Es wird nichts geändert. +

5.2 +smart +

+Gibt einen SMART-Bericht aller Festplatten im System aus. +

+Es enthält eine Schätzung der Ausfallwahrscheinlichkeit im nächsten +Jahr, sodass Sie die Wartungsersetzung von Festplatten planen können, +die verdächtige Attribute aufweisen. +

+Diese Wahrscheinlichkeitsschätzung wird durch Korrelation der SMART-Attribute +der Festplatten mit den Backblaze-Daten erhalten, die unter +folgender Adresse verfügbar sind: +

+
+
+https://www.backblaze.com/hard-drive-test-data.html
+
+
+

+Wenn SMART meldet, dass eine Festplatte ausfällt, wird `FAIL` +oder `PREFAIL` für diese Festplatte gedruckt, und SnapRAID +endet mit einem Fehler. In diesem Fall wird ein sofortiger +Austausch der Festplatte dringend empfohlen. +

+Weitere mögliche Statuszeichenfolgen sind: + + + + +
+logfail + +In der Vergangenheit lagen einige Attribute unter +dem Schwellenwert. +
+logerr + +Das Gerätefehlerprotokoll enthält Fehler. +
+selferr + +Das Geräte-Selbsttestprotokoll enthält Fehler. +
+

+Wenn die Option -v, --verbose angegeben ist, wird eine tiefere +statistische Analyse bereitgestellt. Diese Analyse kann Ihnen bei +der Entscheidung helfen, ob Sie mehr oder weniger Parität benötigen. +

+Dieser Befehl verwendet das `smartctl`-Tool und entspricht dem +Ausführen von `smartctl -a` auf allen Geräten. +

+Wenn Ihre Geräte nicht korrekt automatisch erkannt werden, können Sie +einen benutzerdefinierten Befehl mithilfe der `smartctl`-Option +in der Konfigurationsdatei angeben. +

+Es wird nichts geändert. +

5.3 +probe +

+Gibt den POWER-Zustand aller Festplatten im System aus. +

+`Standby` bedeutet, dass die Festplatte nicht dreht. `Active` +bedeutet, dass die Festplatte dreht. +

+Dieser Befehl verwendet das `smartctl`-Tool und entspricht dem +Ausführen von `smartctl -n standby -i` auf allen Geräten. +

+Wenn Ihre Geräte nicht korrekt automatisch erkannt werden, können Sie +einen benutzerdefinierten Befehl mithilfe der `smartctl`-Option +in der Konfigurationsdatei angeben. +

+Es wird nichts geändert. +

5.4 +up +

+Dreht alle Festplatten des Arrays hoch (spins up). +

+Sie können nur bestimmte Festplatten mithilfe der Option -d, --filter-disk +hochdrehen. +

+Das gleichzeitige Hochdrehen aller Festplatten erfordert viel Strom. +Stellen Sie sicher, dass Ihr Netzteil dies aushalten kann. +

+Es wird nichts geändert. +

5.5 +down +

+Dreht alle Festplatten des Arrays herunter (spins down). +

+Dieser Befehl verwendet das `smartctl`-Tool und entspricht dem +Ausführen von `smartctl -s standby,now` auf allen Geräten. +

+Sie können nur bestimmte Festplatten mithilfe der Option -d, --filter-disk +herunterdrehen. +

+Um automatisch bei einem Fehler herunterzufahren, können Sie die Option +-s, --spin-down-on-error mit jedem anderen Befehl verwenden, was dem +manuellen Ausführen von `down` bei Auftreten eines Fehlers +entspricht. +

+Es wird nichts geändert. +

5.6 +diff +

+Listet alle Dateien auf, die seit dem letzten `sync` geändert wurden +und deren Paritätsdaten neu berechnet werden müssen. +

+Dieser Befehl überprüft nicht die Dateidaten, sondern nur den +Dateizeitstempel, die Größe und die Inode. +

+Nach dem Auflisten aller geänderten Dateien wird eine Zusammenfassung +der Änderungen präsentiert, gruppiert nach: + + + + + + + + +
+equal + +Dateien, die sich seitdem nicht geändert haben. +
+added + +Neu hinzugefügte Dateien, die vorher nicht vorhanden waren. +
+removed + +Entfernte Dateien. +
+updated + +Dateien mit einer anderen Größe oder einem anderen +Zeitstempel, was bedeutet, dass sie geändert wurden. +
+moved + +Auf derselben Festplatte in ein anderes Verzeichnis +verschobene Dateien. Sie werden durch denselben Namen, +dieselbe Größe, denselben Zeitstempel und dieselbe Inode, +aber ein anderes Verzeichnis identifiziert. +
+copied + +Auf dieselbe oder eine andere Festplatte kopierte +Dateien. Beachten Sie, dass wenn sie tatsächlich auf eine +andere Festplatte verschoben werden, sie auch unter `removed` +gezählt werden. Sie werden durch denselben Namen, dieselbe +Größe und denselben Zeitstempel identifiziert. Wenn der +Untersekunden-Zeitstempel Null ist, muss der vollständige +Pfad übereinstimmen, nicht nur der Name. +
+restored + +Dateien mit einer anderen Inode, aber übereinstimmendem +Namen, Größe und Zeitstempel. Dies sind normalerweise +Dateien, die nach dem Löschen wiederhergestellt wurden. +
+

+Wenn ein `sync` erforderlich ist, ist der Rückgabecode des Prozesses 2 +anstelle des Standardwerts 0. Der Rückgabecode 1 wird für eine +allgemeine Fehlerbedingung verwendet. +

+Es wird nichts geändert. +

5.7 +sync +

+Aktualisiert die Paritätsinformationen. Alle geänderten Dateien +im Festplatten-Array werden gelesen, und die entsprechenden +Paritätsdaten werden aktualisiert. +

+Sie können diesen Vorgang jederzeit durch Drücken von Strg+C +anhalten, ohne die bereits geleistete Arbeit zu verlieren. +Beim nächsten Lauf wird der `sync`-Vorgang dort fortgesetzt, +wo er unterbrochen wurde. +

+Wenn während des Vorgangs stille oder Eingabe-/Ausgabefehler +gefunden werden, werden die entsprechenden Blöcke als fehlerhaft +markiert. +

+Dateien werden durch Pfad und/oder Inode identifiziert und anhand +von Größe und Zeitstempel überprüft. +Wenn die Dateigröße oder der Zeitstempel abweicht, werden die Paritätsdaten +für die gesamte Datei neu berechnet. +Wenn die Datei auf derselben Festplatte verschoben oder umbenannt +wird und dieselbe Inode beibehält, wird die Parität nicht neu +berechnet. +Wenn die Datei auf eine andere Festplatte verschoben wird, wird die +Parität neu berechnet, aber die zuvor berechneten Hash-Informationen +werden beibehalten. +

+Die `content`- und `parity`-Dateien werden bei Bedarf geändert. +Die Dateien im Array werden NICHT geändert. +

5.8 +scrub +

+Scrubbt das Array und überprüft auf stille oder Eingabe-/Ausgabefehler +auf Daten- und Paritätsfestplatten. +

+Jede Ausführung überprüft ungefähr 8% des Arrays, ausgenommen Daten, +die bereits in den letzten 10 Tagen gescrubbed wurden. +Dies bedeutet, dass Scrubbing einmal pro Woche sicherstellt, dass +jedes Bit an Daten mindestens einmal alle drei Monate überprüft wird. +

+Sie können einen anderen Scrub-Plan oder eine andere Menge mithilfe +der Option -p, --plan definieren, die Folgendes akzeptiert: +bad - Scrubbt als fehlerhaft markierte Blöcke. +new - Scrubbt gerade synchronisierte Blöcke, die noch nicht gescrubbed +
+wurden. +
+ + + +
+full + +Scrubbt alles. +
+0-100 + +Scrubbt den angegebenen Prozentsatz der Blöcke. +
+

+Wenn Sie einen Prozentsatz angeben, können Sie auch die Option +-o, --older-than verwenden, um festzulegen, wie alt der Block sein +soll. Die ältesten Blöcke werden zuerst gescrubbed, um eine optimale +Überprüfung zu gewährleisten. Wenn Sie nur die gerade synchronisierten +Blöcke scrubben möchten, die noch nicht gescrubbed wurden, +verwenden Sie die Option `-p new`. +

+Um Details zum Scrub-Status zu erhalten, verwenden Sie den Befehl +`status`. +

+Für jeden gefundenen stillen oder Eingabe-/Ausgabefehler werden die +entsprechenden Blöcke in der `content`-Datei als fehlerhaft (bad) +markiert. Diese fehlerhaften Blöcke werden in `status` aufgelistet +und können mit `fix -e` behoben werden. Nach der Behebung werden +sie beim nächsten Scrub erneut überprüft, und wenn sie als korrigiert +befunden werden, wird die fehlerhafte Markierung entfernt. +Um nur die fehlerhaften Blöcke zu scrubben, können Sie den Befehl +`scrub -p bad` verwenden. +

+Es wird empfohlen, `scrub` nur auf einem synchronisierten Array +auszuführen, um gemeldete Fehler zu vermeiden, die durch nicht +synchronisierte Daten verursacht werden. Diese Fehler werden als +keine stillen Fehler erkannt, und die Blöcke werden nicht als fehlerhaft +markiert, aber solche Fehler werden in der Ausgabe des Befehls +gemeldet. +

+Die `content`-Datei wird geändert, um die Zeit der letzten +Überprüfung für jeden Block zu aktualisieren und fehlerhafte +Blöcke zu markieren. +Die `parity`-Dateien werden NICHT geändert. +Die Dateien im Array werden NICHT geändert. +

5.9 +fix +

+Behebt alle Dateien und die Paritätsdaten. +

+Alle Dateien und Paritätsdaten werden mit dem Snapshot-Zustand +verglichen, der beim letzten `sync` gespeichert wurde. +Wenn eine Abweichung gefunden wird, wird sie auf den gespeicherten +Snapshot zurückgesetzt. +

+WARNUNG! Der Befehl `fix` unterscheidet nicht zwischen Fehlern und +beabsichtigten Änderungen. Er setzt den Dateizustand bedingungslos +auf den letzten `sync` zurück. +

+Wenn keine andere Option angegeben ist, wird das gesamte Array verarbeitet. +Verwenden Sie die Filteroptionen, um eine Teilmenge von Dateien +oder Festplatten für die Operation auszuwählen. +

+Um nur die Blöcke zu beheben, die während `sync` und `scrub` als +fehlerhaft markiert wurden, verwenden Sie die Option -e, --filter-error. +Im Gegensatz zu anderen Filteroptionen wendet diese Behebungen nur +auf Dateien an, die seit dem letzten `sync` unverändert sind. +

+SnapRAID benennt alle Dateien, die nicht behoben werden können, +durch Hinzufügen der Erweiterung `.unrecoverable` um. +

+Vor dem Beheben wird das gesamte Array gescannt, um alle Dateien +zu finden, die seit der letzten `sync`-Operation verschoben wurden. +Diese Dateien werden anhand ihres Zeitstempels identifiziert, wobei +Name und Verzeichnis ignoriert werden, und werden bei Bedarf im +Wiederherstellungsprozess verwendet. Wenn Sie einige davon außerhalb +des Arrays verschoben haben, können Sie die Option -i, --import +verwenden, um zusätzliche Verzeichnisse zum Scannen anzugeben. +

+Dateien werden nur anhand des Pfads identifiziert, nicht anhand +der Inode. +

+Die `content`-Datei wird NICHT geändert. +Die `parity`-Dateien werden bei Bedarf geändert. +Die Dateien im Array werden bei Bedarf geändert. +

5.10 +check +

+Überprüft alle Dateien und die Paritätsdaten. +

+Es funktioniert wie `fix`, simuliert jedoch nur eine Wiederherstellung, +und es werden keine Änderungen in das Array geschrieben. +

+Dieser Befehl ist primär für manuelle Überprüfung gedacht, wie z.B. +nach einem Wiederherstellungsprozess oder unter anderen speziellen +Bedingungen. Für regelmäßige und geplante Überprüfungen verwenden +Sie `scrub`. +

+Wenn Sie die Option -a, --audit-only verwenden, wird nur der Hash +der Dateien überprüft, und die Paritätsdaten werden für einen +schnelleren Lauf ignoriert. +

+Dateien werden nur anhand des Pfads identifiziert, nicht anhand +der Inode. +

+Es wird nichts geändert. +

5.11 +list +

+Listet alle Dateien auf, die sich zum Zeitpunkt des letzten `sync` +im Array befanden. +

+Mit -v oder --verbose wird auch die Untersekundenzeit angezeigt. +

+Es wird nichts geändert. +

5.12 +dup +

+Listet alle doppelten Dateien auf. Zwei Dateien gelten als gleich, +wenn ihre Hashes übereinstimmen. Die Dateidaten werden nicht gelesen; +es werden nur die vorab berechneten Hashes verwendet. +

+Es wird nichts geändert. +

5.13 +pool +

+Erstellt oder aktualisiert eine virtuelle Ansicht aller +Dateien in Ihrem Festplatten-Array im `pooling`-Verzeichnis. +

+Die Dateien werden nicht kopiert, sondern mithilfe symbolischer +Links verknüpft. +

+Beim Aktualisieren werden alle vorhandenen symbolischen Links und +leeren Unterverzeichnisse gelöscht und durch die neue Ansicht des +Arrays ersetzt. Alle anderen regulären Dateien bleiben erhalten. +

+Außerhalb des Pool-Verzeichnisses wird nichts geändert. +

5.14 +devices +

+Gibt die Low-Level-Geräte aus, die vom Array verwendet werden. +

+Dieser Befehl zeigt die Gerätezuordnungen im Array an und ist +hauptsächlich als Skriptschnittstelle gedacht. +

+Die ersten beiden Spalten sind die Low-Level-Geräte-ID und der Pfad. +Die nächsten beiden Spalten sind die High-Level-Geräte-ID und der Pfad. +Die letzte Spalte ist der Festplattenname im Array. +

+In den meisten Fällen haben Sie ein Low-Level-Gerät für jede +Festplatte im Array, aber in einigen komplexeren Konfigurationen +können mehrere Low-Level-Geräte von einer einzigen Festplatte +im Array verwendet werden. +

+Es wird nichts geändert. +

5.15 +touch +

+Setzt einen beliebigen Untersekunden-Zeitstempel für alle Dateien, +deren Untersekunden-Zeitstempel auf Null gesetzt ist. +

+Dies verbessert die Fähigkeit von SnapRAID, verschobene und +kopierte Dateien zu erkennen, da es den Zeitstempel fast +eindeutig macht und mögliche Duplikate reduziert. +

+Genauer gesagt, wenn der Untersekunden-Zeitstempel nicht Null ist, +wird eine verschobene oder kopierte Datei als solche identifiziert, +wenn sie mit Name, Größe und Zeitstempel übereinstimmt. Wenn der +Untersekunden-Zeitstempel Null ist, wird sie nur als Kopie betrachtet, +wenn der vollständige Pfad, die Größe und der Zeitstempel alle +übereinstimmen. +

+Der Zeitstempel mit Sekundenpräzision wird nicht geändert, +sodass alle Daten und Zeiten Ihrer Dateien erhalten bleiben. +

5.16 +rehash +

+Plant eine Neu-Hash-Berechnung (rehash) des gesamten Arrays. +

+Dieser Befehl ändert die verwendete Hash-Art, typischerweise beim +Upgrade von einem 32-Bit-System auf ein 64-Bit-System, um von +MurmurHash3 auf den schnelleren SpookyHash umzuschalten. +

+Wenn Sie bereits den optimalen Hash verwenden, tut dieser Befehl +nichts und informiert Sie darüber, dass keine Aktion erforderlich ist. +

+Die Neu-Hash-Berechnung wird nicht sofort durchgeführt, sondern +findet schrittweise während `sync` und `scrub` statt. +

+Sie können den Neu-Hash-Zustand mithilfe von `status` überprüfen. +

+Während der Neu-Hash-Berechnung behält SnapRAID die volle +Funktionalität bei, mit der einzigen Ausnahme, dass `dup` keine +doppelten Dateien mit einem anderen Hash erkennen kann. +

6 +Options +

+SnapRAID bietet die folgenden Optionen: + + +
+-c, --conf CONFIG +
+Wählt die zu verwendende Konfigurationsdatei aus. Wenn nicht +angegeben, wird unter Unix die Datei `/usr/local/etc/snapraid.conf` +verwendet, falls sie existiert, andernfalls `/etc/snapraid.conf`. +Unter Windows wird die Datei `snapraid.conf` im selben +Verzeichnis wie `snapraid.exe` verwendet. +
+ + +
+-f, --filter PATTERN +
+Filtert die zu verarbeitenden Dateien in `check` und `fix`. +Nur die Dateien, die dem angegebenen Muster entsprechen, werden +verarbeitet. Diese Option kann mehrmals verwendet werden. +Weitere Details zu Musterspezifikationen finden Sie im +Abschnitt PATTERN. Unter Unix stellen Sie sicher, dass Globbing-Zeichen +in Anführungszeichen gesetzt werden, wenn sie verwendet werden. +Diese Option kann nur mit `check` und `fix` verwendet werden. +Sie kann nicht mit `sync` und `scrub` verwendet werden, da +diese immer das gesamte Array verarbeiten. +
+ + +
+-d, --filter-disk NAME +
+Filtert die zu verarbeitenden Festplatten in `check`, `fix`, `up` +und `down`. Sie müssen einen Festplattennamen angeben, wie +in der Konfigurationsdatei definiert. Sie können auch Paritätsfestplatten +mit den Namen `parity`, `2-parity`, `3-parity`, usw. angeben, +um Vorgänge auf eine bestimmte Paritätsfestplatte zu beschränken. +Wenn Sie mehrere --filter, --filter-disk und --filter-missing +Optionen kombinieren, werden nur Dateien ausgewählt, die allen +Filtern entsprechen. Diese Option kann mehrmals verwendet werden. +Diese Option kann nur mit `check`, `fix`, `up` und `down` verwendet +werden. Sie kann nicht mit `sync` und `scrub` verwendet werden, +da diese immer das gesamte Array verarbeiten. +
+ + +
+-m, --filter-missing +
+Filtert die zu verarbeitenden Dateien in `check` und `fix`. +Nur die Dateien, die im Array fehlen oder gelöscht wurden, werden +verarbeitet. Bei Verwendung mit `fix` fungiert dies als +`undelete`-Befehl (Wiederherstellung von Gelöschtem). +Wenn Sie mehrere --filter, --filter-disk und --filter-missing +Optionen kombinieren, werden nur Dateien ausgewählt, die allen +Filtern entsprechen. Diese Option kann nur mit `check` und `fix` +verwendet werden. Sie kann nicht mit `sync` und `scrub` +verwendet werden, da diese immer das gesamte Array verarbeiten. +
+ + +
+-e, --filter-error +
+Verarbeitet die Dateien mit Fehlern in `check` und `fix`. +Es verarbeitet nur Dateien, deren Blöcke während `sync` +und `scrub` als mit stillen oder Eingabe-/Ausgabefehlern +markiert wurden, wie in `status` aufgelistet. +Diese Option kann nur mit `check` und `fix` verwendet werden. +
+ + +
+-p, --plan PERC|bad|new|full +
+Wählt den Scrub-Plan aus. Wenn PERC ein numerischer Wert +von 0 bis 100 ist, wird er als Prozentsatz der zu scrubbenden +Blöcke interpretiert. Anstelle eines Prozentsatzes können Sie +einen Plan angeben: `bad` scrubbt fehlerhafte Blöcke, +`new` scrubbt Blöcke, die noch nicht gescrubbed wurden, +und `full` scrubbt alles. +Diese Option kann nur mit `scrub` verwendet werden. +
+ + +
+-o, --older-than DAYS +
+Wählt den ältesten Teil des Arrays aus, der in `scrub` +verarbeitet werden soll. DAYS ist das Mindestalter in Tagen, +damit ein Block gescrubbed werden kann; der Standardwert +ist 10. Blöcke, die als fehlerhaft markiert sind, werden +immer gescrubbed, unabhängig von dieser Option. +Diese Option kann nur mit `scrub` verwendet werden. +
+ + +
+-a, --audit-only +
+Überprüft in `check` den Hash der Dateien, ohne die Paritätsdaten +zu überprüfen. Wenn Sie nur an der Überprüfung der Dateidaten +interessiert sind, kann diese Option den Überprüfungsprozess +erheblich beschleunigen. +Diese Option kann nur mit `check` verwendet werden. +
+ + +
+-h, --pre-hash +
+Führt in `sync` eine vorläufige Hash-Phase aller neuen Daten +zur zusätzlichen Überprüfung vor der Paritätsberechnung durch. +Normalerweise wird in `sync` keine vorläufige Hash-Berechnung +durchgeführt, und die neuen Daten werden unmittelbar vor der +Paritätsberechnung gehasht, wenn sie zum ersten Mal gelesen werden. +Dieser Vorgang tritt auf, wenn das System unter starker Last +steht, wobei alle Festplatten drehen und eine ausgelastete CPU +vorliegt. Dies ist ein Extremzustand für die Maschine, und wenn +sie ein latentes Hardwareproblem hat, können stille Fehler +unentdeckt bleiben, da die Daten noch nicht gehasht sind. +Um dieses Risiko zu vermeiden, können Sie den `pre-hash`-Modus +aktivieren, um alle Daten zweimal lesen zu lassen und so ihre +Integrität sicherzustellen. Diese Option überprüft auch im Array +verschobene Dateien, um sicherzustellen, dass die Verschiebeoperation +erfolgreich war, und ermöglicht es Ihnen, bei Bedarf eine +`fix`-Operation durchzuführen, bevor Sie fortfahren. +Diese Option kann nur mit `sync` verwendet werden. +
+ + +
+-i, --import DIR +
+Importiert aus dem angegebenen Verzeichnis alle Dateien, die +nach dem letzten `sync` aus dem Array gelöscht wurden. +Wenn Sie solche Dateien noch haben, können sie von `check` und +`fix` verwendet werden, um den Wiederherstellungsprozess zu +verbessern. Die Dateien werden gelesen, auch in Unterverzeichnissen, +und unabhängig von ihrem Namen identifiziert. +Diese Option kann nur mit `check` und `fix` verwendet werden. +
+ + +
+-s, --spin-down-on-error +
+Dreht bei jedem Fehler alle verwalteten Festplatten herunter, +bevor mit einem von Null verschiedenen Statuscode beendet wird. +Dies verhindert, dass die Laufwerke nach einem abgebrochenen +Vorgang aktiv bleiben und drehen, was unnötige Hitzeentwicklung +und Stromverbrauch vermeiden hilft. Verwenden Sie diese Option, +um sicherzustellen, dass die Festplatten auch bei einem +Befehlsfehler sicher gestoppt werden. +
+ + +
+-w, --bw-limit RATE +
+Wendet eine globale Bandbreitenbegrenzung für alle Festplatten +an. RATE ist die Anzahl der Bytes pro Sekunde. Sie können +einen Multiplikator wie K, M oder G angeben (z.B. --bw-limit 1G). +
+ + +
+-A, --stats +
+Aktiviert eine erweiterte Statusansicht, die zusätzliche +Informationen anzeigt. Der Bildschirm zeigt zwei Diagramme an: +Das erste Diagramm zeigt die Anzahl der gepufferten Stripes für jede +Festplatte sowie den Dateipfad der Datei, auf die derzeit auf dieser +Festplatte zugegriffen wird. Typischerweise hat die langsamste Festplatte +keinen verfügbaren Puffer, was die maximal erreichbare Bandbreite bestimmt. +Das zweite Diagramm zeigt den Prozentsatz der Wartezeit über die +letzten 100 Sekunden. Es wird erwartet, dass die langsamste Festplatte +die meiste Wartezeit verursacht, während andere Festplatten wenig +oder keine Wartezeit haben sollten, da sie ihre gepufferten Stripes +verwenden können. Dieses Diagramm zeigt auch die Zeit an, die +mit Warten auf Hash-Berechnungen und RAID-Berechnungen verbracht +wurde. Alle Berechnungen laufen parallel zu den Festplattenoperationen. +Solange für mindestens eine Festplatte eine messbare Wartezeit +vorhanden ist, deutet dies daher darauf hin, dass die CPU schnell +genug ist, um mit der Arbeitslast Schritt zu halten. +
+ + +
+-Z, --force-zero +
+Erzwingt den unsicheren Vorgang der Synchronisierung einer Datei +mit Nullgröße, die zuvor nicht Null war. Wenn SnapRAID eine +solche Bedingung erkennt, stoppt es den Vorgang, es sei denn, +Sie geben diese Option an. Dies ermöglicht es Ihnen, leicht zu +erkennen, wann nach einem Systemabsturz einige zugegriffene Dateien +abgeschnitten (truncated) wurden. Dies ist eine mögliche Bedingung +unter Linux mit den ext3/ext4-Dateisystemen. +Diese Option kann nur mit `sync` verwendet werden. +
+ + +
+-E, --force-empty +
+Erzwingt den unsicheren Vorgang der Synchronisierung einer +Festplatte, bei der alle ursprünglichen Dateien fehlen. +Wenn SnapRAID erkennt, dass alle ursprünglich auf der Festplatte +vorhandenen Dateien fehlen oder überschrieben wurden, stoppt es +den Vorgang, es sei denn, Sie geben diese Option an. +Dies ermöglicht es Ihnen, leicht zu erkennen, wann ein Daten-Dateisystem +nicht gemountet (eingehängt) ist. +Diese Option kann nur mit `sync` verwendet werden. +
+ + +
+-U, --force-uuid +
+Erzwingt den unsicheren Vorgang der Synchronisierung, Überprüfung +und Behebung mit Festplatten, deren UUID geändert wurde. +Wenn SnapRAID erkennt, dass einige Festplatten ihre UUID +geändert haben, stoppt es den Vorgang, es sei denn, Sie geben +diese Option an. Dies ermöglicht es Ihnen, zu erkennen, wann +Ihre Festplatten an den falschen Einhängepunkten gemountet sind. +Es ist jedoch erlaubt, eine einzelne UUID-Änderung mit einfacher +Parität zu haben und mehr mit mehrfacher Parität, da dies +der normale Fall beim Austausch von Festplatten nach einer +Wiederherstellung ist. +Diese Option kann nur mit `sync`, `check` oder `fix` verwendet +werden. +
+ + +
+-D, --force-device +
+Erzwingt den unsicheren Vorgang der Behebung mit unzugänglichen +Festplatten oder mit Festplatten auf demselben physischen Gerät. +Wenn Sie beispielsweise zwei Datenfestplatten verloren haben und +eine Ersatzfestplatte haben, um nur die erste wiederherzustellen, +können Sie die zweite unzugängliche Festplatte ignorieren. +Oder wenn Sie eine Festplatte in dem auf einer bereits +verwendeten Festplatte verbleibenden freien Speicherplatz +wiederherstellen möchten, wobei sie dasselbe physische Gerät +gemeinsam nutzen. +Diese Option kann nur mit `fix` verwendet werden. +
+ + +
+-N, --force-nocopy +
+Deaktiviert in `sync`, `check` und `fix` die Kopiererkennungsheuristik. +Ohne diese Option geht SnapRAID davon aus, dass Dateien mit den +gleichen Attributen, wie Name, Größe und Zeitstempel, Kopien mit +denselben Daten sind. Dies ermöglicht die Identifizierung von +kopierten oder von einer Festplatte auf eine andere verschobenen +Dateien und die Wiederverwendung der bereits berechneten Hash-Informationen, +um stille Fehler zu erkennen oder fehlende Dateien wiederherzustellen. +In einigen seltenen Fällen kann dieses Verhalten zu falsch positiven +Ergebnissen oder einem langsamen Vorgang aufgrund vieler Hash-Überprüfungen +führen, und diese Option ermöglicht es Ihnen, solche Probleme +zu beheben. +Diese Option kann nur mit `sync`, `check` und `fix` verwendet +werden. +
+ + +
+-F, --force-full +
+Erzwingt in `sync` eine vollständige Neuberechnung der Parität. +Diese Option kann verwendet werden, wenn Sie eine neue Paritätsstufe +hinzufügen oder wenn Sie zu einer alten Content-Datei mit +neueren Paritätsdaten zurückgekehrt sind. Anstatt die Parität +von Grund auf neu zu erstellen, ermöglicht dies die Wiederverwendung +der in der Content-Datei vorhandenen Hashes zur Validierung +von Daten und zur Aufrechterhaltung des Datenschutzes während +des `sync`-Vorgangs unter Verwendung der vorhandenen Paritätsdaten. +Diese Option kann nur mit `sync` verwendet werden. +
+ + +
+-R, --force-realloc +
+Erzwingt in `sync` eine vollständige Neuallokation von Dateien +und eine Wiederherstellung der Parität. +Diese Option kann verwendet werden, um alle Dateien vollständig +neu zuzuweisen und die Fragmentierung zu entfernen, während +die in der Content-Datei vorhandenen Hashes zur Validierung +von Daten wiederverwendet werden. +Diese Option kann nur mit `sync` verwendet werden. +WARNUNG! Diese Option ist nur für Experten gedacht, und es wird +dringend empfohlen, sie nicht zu verwenden. +Sie haben während der `sync`-Operation KEINEN Datenschutz. +
+ + +
+-l, --log FILE +
+Schreibt ein detailliertes Protokoll in die angegebene Datei. +Wenn diese Option nicht angegeben ist, werden unerwartete Fehler +auf dem Bildschirm ausgegeben, was bei vielen Fehlern möglicherweise +zu einer übermäßigen Ausgabe führt. Wenn -l, --log angegeben +ist, werden nur schwerwiegende Fehler, die SnapRAID zum Stoppen +bringen, auf dem Bildschirm ausgegeben. +Wenn der Pfad mit '>>' beginnt, wird die Datei im Anhängemodus +(append mode) geöffnet. Vorkommen von '%D' und '%T' im Namen +werden durch Datum und Uhrzeit im Format YYYYMMDD bzw. HHMMSS +ersetzt. In Windows-Batch-Dateien müssen Sie das '%'-Zeichen +verdoppeln, z.B. result-%%D.log. Um '>>' zu verwenden, müssen +Sie den Namen in Anführungszeichen setzen, z.B. `">>result.log"`. +Um das Protokoll an die Standardausgabe oder den Standardfehler +auszugeben, können Sie `">&1"` bzw. `">&2"` verwenden. +Beschreibungen der Protokoll-Tags finden Sie in der Datei +snapraid_log.txt oder in der Manpage. +
+ + +
+-L, --error-limit NUMBER +
+Legt ein neues Fehlerlimit fest, bevor die Ausführung gestoppt +wird. Standardmäßig stoppt SnapRAID, wenn es mehr als 100 +Eingabe-/Ausgabefehler feststellt, was darauf hindeutet, dass +eine Festplatte wahrscheinlich ausfällt. Diese Option wirkt sich +auf `sync` und `scrub` aus, denen es gestattet ist, nach dem +ersten Satz von Festplattenfehlern fortzufahren, um ihre Vorgänge +abzuschließen. `check` und `fix` stoppen jedoch immer beim +ersten Fehler. +
+ + +
+-S, --start BLKSTART +
+Startet die Verarbeitung ab der angegebenen Blocknummer. +Dies kann nützlich sein, um die Überprüfung oder Behebung +spezifischer Blöcke im Falle einer beschädigten Festplatte +zu wiederholen. Diese Option ist hauptsächlich für die erweiterte +manuelle Wiederherstellung gedacht. +
+ + +
+-B, --count BLKCOUNT +
+Verarbeitet nur die angegebene Anzahl von Blöcken. +Diese Option ist hauptsächlich für die erweiterte manuelle +Wiederherstellung gedacht. +
+ + +
+-C, --gen-conf CONTENT +
+Generiert eine Dummy-Konfigurationsdatei aus einer vorhandenen +Content-Datei. Die Konfigurationsdatei wird in die Standardausgabe +geschrieben und überschreibt keine vorhandene. +Diese Konfigurationsdatei enthält auch die Informationen, +die zur Rekonstruktion der Festplatten-Einhängepunkte erforderlich +sind, falls Sie das gesamte System verlieren. +
+ + +
+-v, --verbose +
+Gibt mehr Informationen auf dem Bildschirm aus. +Wenn einmal angegeben, werden ausgeschlossene Dateien +und zusätzliche Statistiken gedruckt. +Diese Option hat keine Auswirkung auf die Protokolldateien. +
+ + +
+-q, --quiet +
+Gibt weniger Informationen auf dem Bildschirm aus. +Wenn einmal angegeben, wird die Fortschrittsleiste entfernt; +zweimal, die laufenden Operationen; dreimal, die Info-Meldungen; +viermal, die Statusmeldungen. +Schwerwiegende Fehler werden immer auf dem Bildschirm ausgegeben. +Diese Option hat keine Auswirkung auf die Protokolldateien. +
+ + +
+-H, --help +
+Gibt eine kurze Hilfeanzeige aus. +
+ + +
+-V, --version +
+Gibt die Programmversion aus. +
+

7 +Configuration +

+SnapRAID benötigt eine Konfigurationsdatei, um zu wissen, wo sich +Ihr Festplatten-Array befindet und wo die Paritätsinformationen +gespeichert werden sollen. +

+Unter Unix wird die Datei `/usr/local/etc/snapraid.conf` verwendet, +falls sie existiert, andernfalls `/etc/snapraid.conf`. +Unter Windows wird die Datei `snapraid.conf` im selben +Verzeichnis wie `snapraid.exe` verwendet. +

+Sie muss die folgenden Optionen (Groß- und Kleinschreibung beachten) +enthalten: +

7.1 +parity FILE [,FILE] ... +

+Definiert die Dateien, die zum Speichern der Paritätsinformationen +verwendet werden sollen. Die Parität ermöglicht den Schutz +vor einem einzelnen Festplattenausfall, ähnlich wie bei RAID5. +

+Sie können mehrere Dateien angeben, die sich auf unterschiedlichen +Festplatten befinden müssen. Wenn eine Datei nicht mehr wachsen +kann, wird die nächste verwendet. Der gesamte verfügbare Platz +muss mindestens so groß sein wie die größte Datenfestplatte im +Array. +

+Sie können später zusätzliche Paritätsdateien hinzufügen, aber Sie +können sie nicht neu anordnen oder entfernen. +

+Das Reservieren der Paritätsfestplatten für Parität stellt sicher, +dass sie nicht fragmentiert werden, was die Leistung verbessert. +

+Unter Windows werden 256 MB auf jeder Festplatte ungenutzt gelassen, +um die Warnung vor vollen Festplatten zu vermeiden. +

+Diese Option ist obligatorisch und kann nur einmal verwendet werden. +

7.2 +(2,3,4,5,6)-parity FILE [,FILE] ... +

+Definiert die Dateien, die zum Speichern zusätzlicher Paritätsinformationen +verwendet werden sollen. +

+Für jede angegebene Paritätsstufe wird eine zusätzliche Schutzstufe +aktiviert: +

+

+Jede Paritätsstufe erfordert die Anwesenheit aller vorherigen +Paritätsstufen. +

+Die gleichen Überlegungen wie bei der Option 'parity' gelten. +

+Diese Optionen sind optional und können nur einmal verwendet werden. +

7.3 +z-parity FILE [,FILE] ... +

+Definiert eine alternative Datei und ein alternatives Format zum +Speichern von Triple-Parität. +

+Diese Option ist eine Alternative zu '3-parity', die primär für +Low-End-CPUs wie ARM oder AMD Phenom, Athlon und Opteron gedacht +ist, die den SSSE3-Befehlssatz nicht unterstützen. In solchen Fällen +bietet sie eine bessere Leistung. +

+Dieses Format ähnelt dem von ZFS RAIDZ3, ist aber schneller. +Wie ZFS funktioniert es nicht jenseits der Triple-Parität. +

+Bei Verwendung von '3-parity' werden Sie gewarnt, wenn das +'z-parity'-Format zur Leistungsverbesserung empfohlen wird. +

+Es ist möglich, von einem Format in ein anderes zu konvertieren, +indem die Konfigurationsdatei mit der gewünschten z-parity- oder +3-parity-Datei angepasst und `fix` zur Neuerstellung verwendet wird. +

7.4 +content FILE +

+Definiert die Datei, die zum Speichern der Liste und Prüfsummen +aller im Festplatten-Array vorhandenen Dateien verwendet werden soll. +

+Sie kann auf einer für Daten, Parität oder einer anderen +verfügbaren Festplatte platziert werden. +Wenn Sie eine Datenfestplatte verwenden, wird diese Datei automatisch +vom `sync`-Vorgang ausgeschlossen. +

+Diese Option ist obligatorisch und kann mehrmals verwendet werden, +um mehrere Kopien derselben Datei zu speichern. +

+Sie müssen mindestens eine Kopie für jede verwendete Paritätsfestplatte +plus eine speichern. Die Verwendung zusätzlicher Kopien schadet nicht. +

7.5 +data NAME DIR +

+Definiert den Namen und den Einhängepunkt (Mount Point) der +Datenfestplatten im Array. NAME wird zur Identifizierung der +Festplatte verwendet und muss eindeutig sein. DIR ist der +Einhängepunkt der Festplatte im Dateisystem. +

+Sie können den Einhängepunkt nach Bedarf ändern, solange Sie +den NAME unverändert lassen. +

+Sie sollten eine Option für jede Datenfestplatte im Array verwenden. +

+Sie können eine Festplatte später umbenennen, indem Sie den NAME +direkt in der Konfigurationsdatei ändern und dann einen `sync`-Befehl +ausführen. Im Falle einer Umbenennung erfolgt die Zuordnung +mithilfe der gespeicherten UUID der Festplatten. +

7.6 +nohidden +

+Schließt alle versteckten Dateien und Verzeichnisse aus. +Unter Unix sind versteckte Dateien solche, die mit `.` beginnen. +Unter Windows sind es solche mit dem versteckten Attribut. +

7.7 +exclude/include PATTERN +

+Definiert die Datei- oder Verzeichnismuster, die im `sync`-Vorgang +ausgeschlossen oder eingeschlossen werden sollen. +Alle Muster werden in der angegebenen Reihenfolge verarbeitet. +

+Wenn das erste übereinstimmende Muster ein `exclude`-Muster ist, +wird die Datei ausgeschlossen. Wenn es ein `include`-Muster ist, +wird die Datei eingeschlossen. Wenn kein Muster übereinstimmt, +wird die Datei ausgeschlossen, wenn das zuletzt angegebene Muster +ein `include` ist, oder eingeschlossen, wenn das zuletzt angegebene +Muster ein `exclude` ist. +

+Weitere Details zu Musterspezifikationen finden Sie im Abschnitt +PATTERN. +

+Diese Option kann mehrmals verwendet werden. +

7.8 +blocksize SIZE_IN_KIBIBYTES +

+Definiert die grundlegende Blockgröße in Kibibytes für die Parität. +Ein Kibibyte entspricht 1024 Bytes. +

+Die Standard-Blockgröße ist 256, was für die meisten Fälle +ausreichen sollte. +

+WARNUNG! Diese Option ist nur für Experten gedacht, und es wird +dringend empfohlen, diesen Wert nicht zu ändern. Um diesen Wert +zukünftig zu ändern, müssen Sie die gesamte Parität neu erstellen! +

+Ein Grund für die Verwendung einer anderen Blockgröße ist, wenn Sie +viele kleine Dateien in der Größenordnung von Millionen haben. +

+Für jede Datei, auch wenn sie nur wenige Bytes groß ist, wird ein +ganzer Block Parität zugewiesen, und bei vielen Dateien kann dies +zu erheblichem ungenutztem Paritätsplatz führen. Wenn Sie die +Paritätsfestplatte vollständig füllen, dürfen Sie keine weiteren +Dateien zu den Datenfestplatten hinzufügen. +Der verschwendete Paritätsplatz akkumuliert sich jedoch nicht über +die Datenfestplatten hinweg. Verschwendeter Platz, der durch eine +hohe Anzahl von Dateien auf einer Datenfestplatte entsteht, begrenzt +nur die Datenmenge auf dieser Datenfestplatte, nicht auf anderen. +

+Als Annäherung können Sie davon ausgehen, dass die Hälfte der +Blockgröße für jede Datei verschwendet wird. Mit beispielsweise +100.000 Dateien und einer Blockgröße von 256 KiB verschwenden +Sie 12,8 GB Parität, was zu 12,8 GB weniger verfügbarem Speicherplatz +auf der Datenfestplatte führen kann. +

+Sie können die Menge des verschwendeten Platzes auf jeder Festplatte +mithilfe von `status` überprüfen. Dies ist die Menge an Platz, die Sie +auf den Datenfestplatten freilassen oder für Dateien verwenden müssen, +die nicht im Array enthalten sind. Wenn dieser Wert negativ ist, +bedeutet dies, dass Sie kurz davor sind, die Parität zu füllen, +und er stellt den Platz dar, den Sie noch verschwenden können. +

+Um dieses Problem zu vermeiden, können Sie eine größere Partition +für die Parität verwenden. Wenn die Paritätspartition beispielsweise +12,8 GB größer ist als die Datenfestplatten, haben Sie genügend +zusätzlichen Platz, um bis zu 100.000 Dateien auf jeder Datenfestplatte +ohne verschwendeten Platz zu verarbeiten. +

+Ein Trick, um eine größere Paritätspartition unter Linux zu erhalten, +ist die Formatierung mit dem Befehl: +

+
+
+mkfs.ext4 -m 0 -T largefile4 DEVICE
+
+
+

+Dies führt zu etwa 1,5% zusätzlichem Speicherplatz, ungefähr 60 GB +für eine 4 TB Festplatte, was etwa 460.000 Dateien auf jeder +Datenfestplatte ohne verschwendeten Platz ermöglicht. +

7.9 +hashsize SIZE_IN_BYTES +

+Definiert die Hash-Größe in Bytes für die gespeicherten Blöcke. +

+Die Standard-Hash-Größe beträgt 16 Bytes (128 Bit), was für die +meisten Fälle ausreichen sollte. +

+WARNUNG! Diese Option ist nur für Experten gedacht, und es wird +dringend empfohlen, diesen Wert nicht zu ändern. Um diesen Wert +zukünftig zu ändern, müssen Sie die gesamte Parität neu erstellen! +

+Ein Grund für die Verwendung einer anderen Hash-Größe ist, wenn Ihr +System über begrenzten Speicher verfügt. Als Faustregel benötigt +SnapRAID typischerweise 1 GiB RAM für jede 16 TB Daten im Array. +

+Genauer gesagt benötigt SnapRAID zum Speichern der Hashes der Daten +ungefähr TS*(1+HS)/BS Bytes RAM, +wobei TS die Gesamtgröße in Bytes Ihres Festplatten-Arrays ist, +BS die Blockgröße in Bytes und HS die Hash-Größe in Bytes. +

+Mit beispielsweise 8 Festplatten à 4 TB, einer Blockgröße von 256 KiB +(1 KiB = 1024 Bytes) und einer Hash-Größe von 16 erhalten Sie: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB
+
+

+Bei einem Wechsel zu einer Hash-Größe von 8 erhalten Sie: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB
+
+

+Bei einem Wechsel zu einer Blockgröße von 512 erhalten Sie: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB
+
+

+Bei einem Wechsel zu einer Hash-Größe von 8 und einer Blockgröße +von 512 erhalten Sie: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
+
+

7.10 +autosave SIZE_IN_GIGABYTES +

+Speichert den Zustand beim Synchronisieren oder Scrubben automatisch +nach der angegebenen Menge an verarbeiteten GB. +Diese Option ist nützlich, um zu vermeiden, dass lange `sync`-Befehle +von vorne gestartet werden müssen, wenn sie durch einen Maschinenabsturz +oder ein anderes Ereignis unterbrochen werden. +

7.11 +temp_limit TEMPERATURE_CELSIUS +

+Legt die maximal zulässige Festplattentemperatur in Celsius fest. +Wenn angegeben, überprüft SnapRAID regelmäßig die Temperatur aller +Festplatten mithilfe des smartctl-Tools. Die aktuellen Festplattentemperaturen +werden während des Betriebs von SnapRAID angezeigt. Wenn eine Festplatte +diesen Grenzwert überschreitet, werden alle Vorgänge gestoppt, und +die Festplatten werden für die durch die Option `temp_sleep` definierte +Dauer heruntergefahren (in den Standby-Modus versetzt). Nach der +Schlafperiode werden die Vorgänge fortgesetzt und möglicherweise +erneut pausiert, wenn der Temperaturgrenzwert erneut erreicht wird. +

+Während des Betriebs analysiert SnapRAID auch die Heizkurve jeder +Festplatte und schätzt die langfristige stationäre Temperatur, die +erwartet wird, wenn die Aktivität fortgesetzt wird. Die Schätzung +wird nur durchgeführt, nachdem die Festplattentemperatur viermal +angestiegen ist, um sicherzustellen, dass genügend Datenpunkte +zur Verfügung stehen, um einen zuverlässigen Trend festzustellen. +Diese vorhergesagte stationäre Temperatur wird in Klammern neben +dem aktuellen Wert angezeigt und hilft bei der Beurteilung, ob die +Kühlung des Systems ausreichend ist. Diese geschätzte Temperatur +dient nur zu Informationszwecken und hat keine Auswirkung auf das +Verhalten von SnapRAID. Die Aktionen des Programms basieren +ausschließlich auf den tatsächlich gemessenen Festplattentemperaturen. +

+Um diese Analyse durchzuführen, benötigt SnapRAID eine Referenz für +die Systemtemperatur. Es versucht zunächst, diese von verfügbaren +Hardwaresensoren zu lesen. Wenn kein Systemsensor zugänglich ist, +wird die niedrigste zu Beginn des Laufs gemessene Festplattentemperatur +als Fallback-Referenz verwendet. +

+Normalerweise zeigt SnapRAID nur die Temperatur der heißesten +Festplatte an. Um die Temperatur aller Festplatten anzuzeigen, +verwenden Sie die Option -A oder --stats. +

7.12 +temp_sleep TIME_IN_MINUTES +

+Legt die Standby-Zeit in Minuten fest, wenn der Temperaturgrenzwert +erreicht wird. Während dieser Zeit bleiben die Festplatten heruntergefahren. +Der Standardwert ist 5 Minuten. +

7.13 +pool DIR +

+Definiert das Pooling-Verzeichnis, in dem die virtuelle Ansicht des +Festplatten-Arrays mithilfe des Befehls `pool` erstellt wird. +

+Das Verzeichnis muss bereits existieren. +

7.14 +share UNC_DIR +

+Definiert den Windows UNC-Pfad, der für den Remote-Zugriff auf die +Festplatten erforderlich ist. +

+Wenn diese Option angegeben ist, verwenden die im Pool-Verzeichnis +erstellten symbolischen Links diesen UNC-Pfad, um auf die Festplatten +zuzugreifen. Ohne diese Option verwenden die generierten symbolischen +Links nur lokale Pfade, was die Freigabe des Pool-Verzeichnisses +über das Netzwerk nicht ermöglicht. +

+Die symbolischen Links werden unter Verwendung des angegebenen UNC-Pfads +gebildet, wobei der in der `data`-Option angegebene Festplattenname +und schließlich das Dateiverzeichnis und der Name hinzugefügt werden. +

+Diese Option ist nur für Windows erforderlich. +

7.15 +smartctl DISK/PARITY OPTIONS... +

+Definiert benutzerdefinierte smartctl-Optionen, um die SMART-Attribute +für jede Festplatte abzurufen. Dies kann für RAID-Controller und einige +USB-Festplatten erforderlich sein, die nicht automatisch erkannt +werden können. Der Platzhalter %s wird durch den Gerätenamen ersetzt, +ist aber für feste Geräte wie RAID-Controller optional. +

+DISK ist derselbe Festplattenname, der in der `data`-Option angegeben +ist. PARITY ist einer der Paritätsnamen: `parity`, `2-parity`, +`3-parity`, `4-parity`, `5-parity`, `6-parity` oder `z-parity`. +

+In den angegebenen OPTIONS wird die Zeichenfolge `%s` durch den +Gerätenamen ersetzt. Bei RAID-Controllern ist das Gerät +wahrscheinlich fest, und Sie müssen `%s` möglicherweise nicht verwenden. +

+Weitere mögliche Optionen finden Sie in der smartmontools-Dokumentation: +

+
+
+https://www.smartmontools.org/wiki/Supported_RAID-Controllers
+https://www.smartmontools.org/wiki/Supported_USB-Devices
+
+
+

+Zum Beispiel: +

+
+
+smartctl parity -d sat %s
+
+
+

7.16 +smartignore DISK/PARITY ATTR [ATTR...] +

+Ignoriert das angegebene SMART-Attribut bei der Berechnung der +Wahrscheinlichkeit eines Festplattenausfalls. Diese Option ist +nützlich, wenn eine Festplatte ungewöhnliche oder irreführende +Werte für ein bestimmtes Attribut meldet. +

+DISK ist derselbe Festplattenname, der in der `data`-Option angegeben +ist. PARITY ist einer der Paritätsnamen: `parity`, `2-parity`, +`3-parity`, `4-parity`, `5-parity`, `6-parity` oder `z-parity`. +Der Sonderwert * kann verwendet werden, um das Attribut auf allen +Festplatten zu ignorieren. +

+Um beispielsweise das Attribut `Current Pending Sector Count` auf allen +Festplatten zu ignorieren: +

+
+
+smartignore * 197
+
+
+

+Um es nur auf der ersten Paritätsfestplatte zu ignorieren: +

+
+
+smartignore parity 197
+
+
+

7.17 +Examples +

+Ein Beispiel für eine typische Konfiguration für Unix ist: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /mnt/diskp/snapraid.content
+content /var/snapraid/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+exclude /lost+found/
+exclude /tmp/
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/sg0
+smartctl 2-parity -d areca,2/1 /dev/sg0
+
+
+

+Ein Beispiel für eine typische Konfiguration für Windows ist: +

+
+
+parity E:\snapraid.parity
+content E:\snapraid.content
+content C:\snapraid\snapraid.content
+data d1 G:\array\
+data d2 H:\array\
+data d3 I:\array\
+exclude Thumbs.db
+exclude \$RECYCLE.BIN
+exclude \System Volume Information
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/arcmsr0
+smartctl 2-parity -d areca,2/1 /dev/arcmsr0
+
+
+

8 +Pattern +

+Muster werden verwendet, um eine Teilmenge von Dateien zum +Ausschließen oder Einschließen in den Prozess auszuwählen. +

+Es gibt vier verschiedene Arten von Mustern: + + +
+FILE +
+Wählt jede Datei namens DATEI aus. Sie können beliebige +Globbing-Zeichen wie * und ? sowie Zeichenklassen wie [a-z] +verwenden. Dieses Muster gilt nur für Dateien, nicht für +Verzeichnisse. +
+ + +
+DIR/ +
+Wählt jedes Verzeichnis namens VERZ und alles darin aus. +Sie können beliebige Globbing-Zeichen wie * und ? verwenden. +Dieses Muster gilt nur für Verzeichnisse, nicht für Dateien. +
+ + +
+/PATH/FILE +
+Wählt den exakt angegebenen Dateipfad aus. Sie können beliebige +Globbing-Zeichen wie * und ? verwenden, aber sie stimmen niemals +mit einem Verzeichnis-Slash überein. +Dieses Muster gilt nur für Dateien, nicht für Verzeichnisse. +
+ + +
+/PATH/DIR/ +
+Wählt den exakt angegebenen Verzeichnispfad und alles darin +aus. Sie können beliebige Globbing-Zeichen wie * und ? verwenden, +aber sie stimmen niemals mit einem Verzeichnis-Slash überein. +Dieses Muster gilt nur für Verzeichnisse, nicht für Dateien. +
+

+Wenn Sie einen absoluten Pfad angeben, der mit / beginnt, wird er +auf das Array-Stammverzeichnis angewendet, nicht auf das lokale +Dateisystem-Stammverzeichnis. +

+Unter Windows können Sie den Backslash \ anstelle des Forward-Slash / +verwenden. Windows-Systemverzeichnisse, Junctions, Einhängepunkte +(Mount Points) und andere spezielle Windows-Verzeichnisse werden +als Dateien behandelt, was bedeutet, dass Sie zum Ausschließen +eine Dateiregel verwenden müssen, nicht eine Verzeichnisregel. +

+Wenn der Dateiname ein Zeichen '*', '?', '[', oder ']' enthält, +müssen Sie es escapen, um zu vermeiden, dass es als Globbing-Zeichen +interpretiert wird. Unter Unix ist das Escape-Zeichen '\'; unter +Windows ist es '^'. Wenn sich das Muster in der Befehlszeile befindet, +müssen Sie das Escape-Zeichen verdoppeln, um zu vermeiden, dass es +von der Befehlsshell interpretiert wird. +

+In der Konfigurationsdatei können Sie verschiedene Strategien zum +Filtern der zu verarbeitenden Dateien verwenden. +Der einfachste Ansatz besteht darin, nur `exclude`-Regeln zu verwenden, +um alle Dateien und Verzeichnisse zu entfernen, die Sie nicht +verarbeiten möchten. Zum Beispiel: +

+
+
+# Schließt jede Datei namens `*.unrecoverable` aus
+exclude *.unrecoverable
+# Schließt das Stammverzeichnis `/lost+found` aus
+exclude /lost+found/
+# Schließt jedes Unterverzeichnis namens `tmp` aus
+exclude tmp/
+
+
+

+Der gegenteilige Ansatz besteht darin, nur die Dateien zu definieren, +die Sie verarbeiten möchten, indem Sie nur `include`-Regeln verwenden. +Zum Beispiel: +

+
+
+# Schließt nur einige Verzeichnisse ein
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+Der letzte Ansatz besteht darin, `exclude`- und `include`-Regeln +zu mischen. In diesem Fall ist die Reihenfolge der Regeln wichtig. +Frühere Regeln haben Vorrang vor späteren. +Zur Vereinfachung können Sie zuerst alle `exclude`-Regeln und +dann alle `include`-Regeln auflisten. Zum Beispiel: +

+
+
+# Schließt jede Datei namens `*.unrecoverable` aus
+exclude *.unrecoverable
+# Schließt jedes Unterverzeichnis namens `tmp` aus
+exclude tmp/
+# Schließt nur einige Verzeichnisse ein
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+In der Befehlszeile können Sie mit der Option -f nur `include`-Muster +verwenden. Zum Beispiel: +

+
+
+# Überprüft nur die .mp3-Dateien.
+# Unter Unix Anführungszeichen verwenden, um die Globbing-Erweiterung durch die Shell zu vermeiden.
+snapraid -f "*.mp3" check
+
+
+

+Unter Unix müssen Sie Globbing-Zeichen in der Befehlszeile in +Anführungszeichen setzen, um zu verhindern, dass die Shell sie erweitert. +

9 +Content +

+SnapRAID speichert die Liste und Prüfsummen Ihrer Dateien in der +Content-Datei. +

+Es ist eine Binärdatei, die alle im Festplatten-Array vorhandenen +Dateien auflistet, zusammen mit allen Prüfsummen zur Überprüfung +ihrer Integrität. +

+Diese Datei wird von den Befehlen `sync` und `scrub` gelesen und +geschrieben und von den Befehlen `fix`, `check` und `status` gelesen. +

10 +Parity +

+SnapRAID speichert die Paritätsinformationen Ihres Arrays in den +Paritätsdateien. +

+Dies sind Binärdateien, die die berechnete Parität aller in der +`content`-Datei definierten Blöcke enthalten. +

+Diese Dateien werden von den Befehlen `sync` und `fix` gelesen +und geschrieben und nur von den Befehlen `scrub` und `check` gelesen. +

11 +Encoding +

+SnapRAID ignoriert unter Unix jede Kodierung. Es liest und speichert +die Dateinamen mit derselben Kodierung, die vom Dateisystem +verwendet wird. +

+Unter Windows werden alle vom Dateisystem gelesenen Namen konvertiert +und im UTF-8-Format verarbeitet. +

+Um Dateinamen korrekt auszugeben, müssen Sie die Windows-Konsole +mit dem Befehl `chcp 65001` auf den UTF-8-Modus einstellen und +eine TrueType-Schriftart wie `Lucida Console` als Konsolenschriftart +verwenden. Dies betrifft nur die gedruckten Dateinamen; wenn Sie +die Konsolenausgabe in eine Datei umleiten, ist die resultierende +Datei immer im UTF-8-Format. + + + +

+ + + + + + diff --git a/manual-es.html b/manual-es.html new file mode 100644 index 00000000..8f505bde --- /dev/null +++ b/manual-es.html @@ -0,0 +1,2067 @@ + + + + + + + + + + + + + +SnapRAID + + + + + + + + + + + + +
+ + + +

+Spanish manual for SnapRAID. +

+ +

1 +Synopsis +

+
+snapraid [-c, --conf CONFIG]
+    [-f, --filter PATTERN] [-d, --filter-disk NAME]
+    [-m, --filter-missing] [-e, --filter-error]
+    [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
+    [-p, --plan PERC|bad|new|full]
+    [-o, --older-than DAYS] [-l, --log FILE]
+    [-s, --spin-down-on-error] [-w, --bw-limit RATE]
+    [-Z, --force-zero] [-E, --force-empty]
+    [-U, --force-uuid] [-D, --force-device]
+    [-N, --force-nocopy] [-F, --force-full]
+    [-R, --force-realloc]
+    [-S, --start BLKSTART] [-B, --count BLKCOUNT]
+    [-L, --error-limit NUMBER]
+    [-A, --stats]
+    [-v, --verbose] [-q, --quiet]
+    status|smart|probe|up|down|diff|sync|scrub|fix|check
+    |list|dup|pool|devices|touch|rehash
+
+

+

+snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]
+
+

2 +Description +

+SnapRAID es un programa de copia de seguridad diseñado para arrays +de discos, que almacena información de paridad para la recuperación +de datos en caso de hasta seis fallos de disco. +

+Destinado principalmente a centros de medios domésticos con archivos +grandes y que cambian con poca frecuencia, SnapRAID ofrece varias +características: +

+

+Para más información, visite el sitio oficial de SnapRAID: +

+
+
+https://www.snapraid.it/
+
+
+

3 +Limitations +

+SnapRAID es un híbrido entre un programa RAID y un programa de copia +de seguridad, con el objetivo de combinar los mejores beneficios de +ambos. Sin embargo, tiene algunas limitaciones que debe considerar +antes de usarlo. +

+La principal limitación es que si un disco falla y no ha sincronizado +recientemente, es posible que no pueda recuperarse por completo. +Más específicamente, es posible que no pueda recuperar hasta el tamaño +de los archivos cambiados o eliminados desde la última operación de +sincronización. Esto ocurre incluso si los archivos cambiados o +eliminados no están en el disco fallido. Esta es la razón por la que +SnapRAID es más adecuado para datos que rara vez cambian. +

+Por otro lado, los archivos recién agregados no impiden la recuperación +de los archivos ya existentes. Solo perderá los archivos recién +agregados si están en el disco fallido. +

+Otras limitaciones de SnapRAID son: +

+

4 +Getting Started +

+Para usar SnapRAID, primero debe seleccionar un disco en su array de +discos para dedicarlo a la información de `parity` (paridad). Con un +disco para paridad, podrá recuperarse de un solo fallo de disco, +similar a RAID5. +

+Si desea recuperarse de más fallos de disco, similar a RAID6, +debe reservar discos adicionales para la paridad. Cada disco de +paridad adicional permite la recuperación de un fallo de disco más. +

+Como discos de paridad, debe elegir los discos más grandes del array, +ya que la información de paridad puede crecer hasta el tamaño del +disco de datos más grande del array. +

+Estos discos estarán dedicados a almacenar los archivos de `parity`. +No debe almacenar sus datos en ellos. +

+Luego, debe definir los discos de `data` (datos) que desea proteger +con SnapRAID. La protección es más efectiva si estos discos +contienen datos que rara vez cambian. Por esta razón, es mejor +NO incluir el disco C:\ de Windows o los directorios /home, /var y +/tmp de Unix. +

+La lista de archivos se guarda en los archivos de `content` (contenido), +generalmente almacenados en los discos de datos, paridad o de arranque. +Este archivo contiene los detalles de su copia de seguridad, +incluyendo todas las sumas de comprobación para verificar su integridad. +El archivo de `content` se almacena en múltiples copias, y cada copia +debe estar en un disco diferente para asegurar que, incluso en caso +de múltiples fallos de disco, al menos una copia esté disponible. +

+Por ejemplo, suponga que solo está interesado en un nivel de paridad +de protección, y sus discos están ubicados en: +

+
+
+/mnt/diskp <- disco seleccionado para paridad
+/mnt/disk1 <- primer disco a proteger
+/mnt/disk2 <- segundo disco a proteger
+/mnt/disk3 <- tercer disco a proteger
+
+
+

+Debe crear el archivo de configuración /etc/snapraid.conf con +las siguientes opciones: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /var/snapraid/snapraid.content
+content /mnt/disk1/snapraid.content
+content /mnt/disk2/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+
+
+

+Si está en Windows, debe usar el formato de ruta de Windows, con +letras de unidad y barras invertidas en lugar de barras. +

+
+
+parity E:\snapraid.parity
+content C:\snapraid\snapraid.content
+content F:\array\snapraid.content
+content G:\array\snapraid.content
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+
+
+

+Si tiene muchos discos y se queda sin letras de unidad, puede montar +discos directamente en subcarpetas. Consulte: +

+
+
+https://www.google.com/search?q=Windows+mount+point
+
+
+

+En este punto, está listo para ejecutar el comando `sync` (sincronizar) +para construir la información de paridad. +

+
+
+snapraid sync
+
+
+

+Este proceso puede llevar varias horas la primera vez, dependiendo +del tamaño de los datos ya presentes en los discos. Si los discos +están vacíos, el proceso es inmediato. +

+Puede detenerlo en cualquier momento presionando Ctrl+C, y en la +siguiente ejecución, se reanudará donde se interrumpió. +

+Cuando este comando se complete, sus datos estarán SEGUROS. +

+Ahora puede comenzar a usar su array como desee y periódicamente +actualizar la información de paridad ejecutando el comando `sync`. +

4.1 +Scrubbing +

+Para verificar periódicamente los datos y la paridad en busca de +errores, puede ejecutar el comando `scrub` (fregar/limpiar). +

+
+
+snapraid scrub
+
+
+

+Este comando compara los datos de su array con el hash calculado +durante el comando `sync` para verificar la integridad. +

+Cada ejecución del comando verifica aproximadamente el 8% del array, +excluyendo los datos ya fregados en los 10 días anteriores. +Puede usar la opción -p, --plan para especificar una cantidad +diferente y la opción -o, --older-than para especificar una edad +diferente en días. Por ejemplo, para verificar el 5% del array en +busca de bloques con más de 20 días, use: +

+
+
+snapraid -p 5 -o 20 scrub
+
+
+

+Si se encuentran errores silenciosos o de entrada/salida durante el +proceso, los bloques correspondientes se marcan como defectuosos en +el archivo de `content` y se listan en el comando `status`. +

+
+
+snapraid status
+
+
+

+Para corregirlos, puede usar el comando `fix` (arreglar), filtrando +por bloques defectuosos con la opción -e, --filter-error: +

+
+
+snapraid -e fix
+
+
+

+En el siguiente `scrub`, los errores desaparecerán del informe de +`status` si realmente se han corregido. Para hacerlo más rápido, +puede usar -p bad para fregar solo los bloques marcados como defectuosos. +

+
+
+snapraid -p bad scrub
+
+
+

+Ejecutar `scrub` en un array no sincronizado puede reportar errores +causados por archivos eliminados o modificados. Estos errores se +informan en la salida de `scrub`, pero los bloques relacionados no +se marcan como defectuosos. +

4.2 +Pooling +

+Nota: La función de pooling descrita a continuación ha sido +sustituida por la herramienta mergefs, que ahora es la opción +recomendada para los usuarios de Linux en la comunidad SnapRAID. +Mergefs proporciona una forma más flexible y eficiente de agrupar +múltiples unidades en un único punto de montaje unificado, +permitiendo un acceso sin problemas a los archivos en todo su array +sin depender de enlaces simbólicos. Se integra bien con SnapRAID +para la protección de paridad y se usa comúnmente en configuraciones +como OpenMediaVault (OMV) o configuraciones NAS personalizadas. +

+Para que todos los archivos de su array se muestren en el mismo árbol +de directorios, puede habilitar la función de `pooling` (agrupación). +Crea una vista virtual de solo lectura de todos los archivos de su +array utilizando enlaces simbólicos. +

+Puede configurar el directorio de `pooling` en el archivo de +configuración con: +

+
+
+pool /pool
+
+
+

+o, si está en Windows, con: +

+
+
+pool C:\pool
+
+
+

+y luego ejecute el comando `pool` para crear o actualizar la vista virtual. +

+
+
+snapraid pool
+
+
+

+Si está utilizando una plataforma Unix y desea compartir este +directorio a través de la red con máquinas Windows o Unix, debe +agregar las siguientes opciones a su /etc/samba/smb.conf: +

+
+
+# En la sección global de smb.conf
+unix extensions = no
+
+
+

+
+
+# En la sección de compartir de smb.conf
+[pool]
+comment = Pool
+path = /pool
+read only = yes
+guest ok = yes
+wide links = yes
+follow symlinks = yes
+
+
+

+En Windows, compartir enlaces simbólicos a través de una red requiere +que los clientes los resuelvan de forma remota. Para habilitar esto, +además de compartir el directorio pool, también debe compartir todos +los discos de forma independiente, utilizando los nombres de disco +definidos en el archivo de configuración como puntos de recurso +compartido. También debe especificar en la opción `share` del archivo +de configuración la ruta UNC de Windows que los clientes remotos +necesitan usar para acceder a estos discos compartidos. +

+Por ejemplo, operando desde un servidor llamado `darkstar`, puede usar +las opciones: +

+
+
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+pool C:\pool
+share \\darkstar
+
+
+

+y compartir los siguientes directorios a través de la red: +

+
+
+\\darkstar\pool -> C:\pool
+\\darkstar\d1 -> F:\array
+\\darkstar\d2 -> G:\array
+\\darkstar\d3 -> H:\array
+
+
+

+para permitir que los clientes remotos accedan a todos los archivos +en \\darkstar\pool. +

+También puede que deba configurar los clientes remotos para habilitar +el acceso a enlaces simbólicos remotos con el comando: +

+
+
+fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
+
+
+

4.3 +Undeleting +

+SnapRAID funciona más como un programa de copia de seguridad que como +un sistema RAID, y se puede usar para restaurar o recuperar archivos +a su estado anterior usando la opción -f, --filter: +

+
+
+snapraid fix -f FILE
+
+
+

+o para un directorio: +

+
+
+snapraid fix -f DIR/
+
+
+

+También puede usarlo para recuperar solo archivos eliminados +accidentalmente dentro de un directorio usando la opción -m, +--filter-missing, que restaura solo archivos faltantes, dejando +todos los demás intactos. +

+
+
+snapraid fix -m -f DIR/
+
+
+

+O para recuperar todos los archivos eliminados en todas las unidades con: +

+
+
+snapraid fix -m
+
+
+

4.4 +Recovering +

+Ha sucedido lo peor, ¡y ha perdido uno o más discos! +

+¡NO ENTRE EN PÁNICO! ¡Podrá recuperarlos! +

+Lo primero que debe hacer es evitar más cambios en su array de discos. +Deshabilite cualquier conexión remota a él y cualquier proceso +programado, incluida cualquier sincronización o fregado nocturno +programado de SnapRAID. +

+Luego, proceda con los siguientes pasos. +

4.4.1 +STEP 1 -> Reconfigure +

+Necesita algo de espacio para recuperarse, idealmente en discos de +repuesto adicionales, pero un disco USB externo o un disco remoto +serán suficientes. +

+Modifique el archivo de configuración de SnapRAID para hacer que la +opción `data` o `parity` del disco fallido apunte a una ubicación +con suficiente espacio vacío para recuperar los archivos. +

+Por ejemplo, si el disco `d1` ha fallado, cambie de: +

+
+
+data d1 /mnt/disk1/
+
+
+

+a: +

+
+
+data d1 /mnt/new_spare_disk/
+
+
+

+Si el disco a recuperar es un disco de paridad, actualice la opción +`parity` apropiada. +Si tiene varios discos fallidos, actualice todas sus opciones de +configuración. +

4.4.2 +STEP 2 -> Fix +

+Ejecute el comando fix, almacenando el registro en un archivo externo con: +

+
+
+snapraid -d NAME -l fix.log fix
+
+
+

+Donde NAME es el nombre del disco, como `d1` en nuestro ejemplo anterior. +Si el disco a recuperar es un disco de paridad, use los nombres `parity`, +`2-parity`, etc. +Si tiene varios discos fallidos, use varias opciones -d para +especificarlos todos. +

+Este comando tardará mucho tiempo. +

+Asegúrese de tener unos pocos gigabytes libres para almacenar el archivo +fix.log. Ejecútelo desde un disco con suficiente espacio libre. +

+Ahora ha recuperado todo lo que es recuperable. Si algunos archivos son +parcial o totalmente irrecuperables, se les cambiará el nombre agregando +la extensión `.unrecoverable`. +

+Puede encontrar una lista detallada de todos los bloques irrecuperables +en el archivo fix.log buscando todas las líneas que comienzan con `unrecoverable:`. +

+Si no está satisfecho con la recuperación, puede volver a intentarlo +tantas veces como desee. +

+Por ejemplo, si ha eliminado archivos del array después de la última +`sync`, esto puede resultar en que algunos archivos no se recuperen. +En este caso, puede volver a intentar el `fix` usando la opción -i, +--import, especificando dónde están esos archivos ahora para incluirlos +nuevamente en el proceso de recuperación. +

+Si está satisfecho con la recuperación, puede continuar, +¡pero tenga en cuenta que después de sincronizar, no puede volver +a intentar el comando `fix`! +

4.4.3 +STEP 3 -> Check +

+Como verificación cautelosa, ahora puede ejecutar un comando `check` +(comprobar) para asegurarse de que todo esté correcto en el disco +recuperado. +

+
+
+snapraid -d NAME -a check
+
+
+

+Donde NAME es el nombre del disco, como `d1` en nuestro ejemplo anterior. +

+Las opciones -d y -a le dicen a SnapRAID que compruebe solo el disco +especificado e ignore todos los datos de paridad. +

+Este comando tardará mucho tiempo, pero si no es demasiado cauteloso, +puede omitirlo. +

4.4.4 +STEP 4 -> Sync +

+Ejecute el comando `sync` para resincronizar el array con el nuevo disco. +

+
+
+snapraid sync
+
+
+

+Si todo se recupera, este comando es inmediato. +

5 +Commands +

+SnapRAID proporciona algunos comandos simples que le permiten: + +

+Los comandos deben escribirse en minúsculas. +

5.1 +status +

+Imprime un resumen del estado del array de discos. +

+Incluye información sobre la fragmentación de la paridad, la antigüedad +de los bloques sin verificar y todos los errores silenciosos +registrados encontrados durante el fregado. +

+La información presentada se refiere a la última vez que ejecutó +`sync`. Las modificaciones posteriores no se tienen en cuenta. +

+Si se detectaron bloques defectuosos, se enumeran sus números de bloque. +Para corregirlos, puede usar el comando `fix -e`. +

+También muestra un gráfico que representa la última vez que cada +bloque fue fregado o sincronizado. Los bloques fregados se muestran +con '*', los bloques sincronizados pero aún no fregados con 'o'. +

+Nada se modifica. +

5.2 +smart +

+Imprime un informe SMART de todos los discos del sistema. +

+Incluye una estimación de la probabilidad de fallo en el próximo +año, lo que le permite planificar reemplazos de mantenimiento de +discos que muestren atributos sospechosos. +

+Esta estimación de probabilidad se obtiene correlacionando los +atributos SMART de los discos con los datos de Backblaze disponibles en: +

+
+
+https://www.backblaze.com/hard-drive-test-data.html
+
+
+

+Si SMART informa que un disco está fallando, se imprime `FAIL` o +`PREFAIL` para ese disco, y SnapRAID regresa con un error. +En este caso, se recomienda encarecidamente el reemplazo inmediato +del disco. +

+Otras posibles cadenas de estado son: + + + + +
+logfail + +En el pasado, algunos atributos estaban por debajo del +umbral. +
+logerr + +El registro de errores del dispositivo contiene errores. +
+selferr + +El registro de autoprueba del dispositivo contiene errores. +
+

+Si se especifica la opción -v, --verbose, se proporciona un análisis +estadístico más profundo. Este análisis puede ayudarle a decidir si +necesita más o menos paridad. +

+Este comando utiliza la herramienta `smartctl` y es equivalente a +ejecutar `smartctl -a` en todos los dispositivos. +

+Si sus dispositivos no se detectan automáticamente correctamente, puede +especificar un comando personalizado utilizando la opción `smartctl` +en el archivo de configuración. +

+Nada se modifica. +

5.3 +probe +

+Imprime el estado de ENERGÍA de todos los discos del sistema. +

+`Standby` significa que el disco no está girando. `Active` significa +que el disco está girando. +

+Este comando utiliza la herramienta `smartctl` y es equivalente a +ejecutar `smartctl -n standby -i` en todos los dispositivos. +

+Si sus dispositivos no se detectan automáticamente correctamente, puede +especificar un comando personalizado utilizando la opción `smartctl` +en el archivo de configuración. +

+Nada se modifica. +

5.4 +up +

+Pone en marcha (gira) todos los discos del array. +

+Puede poner en marcha solo discos específicos usando la opción -d, +--filter-disk. +

+Poner en marcha todos los discos al mismo tiempo requiere mucha energía. +Asegúrese de que su fuente de alimentación pueda soportarlo. +

+Nada se modifica. +

5.5 +down +

+Detiene (deja de girar) todos los discos del array. +

+Este comando utiliza la herramienta `smartctl` y es equivalente a +ejecutar `smartctl -s standby,now` en todos los dispositivos. +

+Puede detener solo discos específicos usando la opción -d, +--filter-disk. +

+Para detener automáticamente en caso de error, puede usar la opción -s, +--spin-down-on-error con cualquier otro comando, lo cual es +equivalente a ejecutar `down` manualmente cuando ocurre un error. +

+Nada se modifica. +

5.6 +diff +

+Enumera todos los archivos modificados desde el último `sync` que +necesitan que se vuelva a calcular su información de paridad. +

+Este comando no verifica los datos del archivo, sino solo la marca +de tiempo, el tamaño y el inodo del archivo. +

+Después de enumerar todos los archivos cambiados, se presenta un +resumen de los cambios, agrupados por: + + + + + + + + +
+equal + +Archivos sin cambios desde antes. +
+added + +Archivos agregados que no estaban presentes antes. +
+removed + +Archivos eliminados. +
+updated + +Archivos con un tamaño o marca de tiempo diferente, +lo que significa que fueron modificados. +
+moved + +Archivos movidos a un directorio diferente en el mismo +disco. Se identifican por tener el mismo nombre, tamaño, +marca de tiempo e inodo, pero un directorio diferente. +
+copied + +Archivos copiados en el mismo o un disco diferente. +Tenga en cuenta que si realmente se mueven a un disco +diferente, también se contarán en `removed`. +Se identifican por tener el mismo nombre, tamaño y +marca de tiempo. Si la marca de tiempo de subsegundo es +cero, la ruta completa debe coincidir, no solo el nombre. +
+restored + +Archivos con un inodo diferente pero que coinciden +en nombre, tamaño y marca de tiempo. +Estos suelen ser archivos restaurados después de ser +eliminados. +
+

+Si se requiere un `sync`, el código de retorno del proceso es 2, en +lugar del valor predeterminado 0. El código de retorno 1 se utiliza +para una condición de error genérico. +

+Nada se modifica. +

5.7 +sync +

+Actualiza la información de paridad. Todos los archivos modificados +en el array de discos se leen y la información de paridad +correspondiente se actualiza. +

+Puede detener este proceso en cualquier momento presionando Ctrl+C, +sin perder el trabajo ya realizado. +En la siguiente ejecución, el proceso `sync` se reanudará donde +se interrumpió. +

+Si se encuentran errores silenciosos o de entrada/salida durante el +proceso, los bloques correspondientes se marcan como defectuosos. +

+Los archivos se identifican por ruta y/o inodo y se verifican por +tamaño y marca de tiempo. +Si el tamaño o la marca de tiempo del archivo difieren, la información +de paridad se vuelve a calcular para todo el archivo. +Si el archivo se mueve o se renombra en el mismo disco, manteniendo el +mismo inodo, la paridad no se vuelve a calcular. +Si el archivo se mueve a otro disco, la paridad se vuelve a calcular, +pero la información de hash calculada previamente se mantiene. +

+Los archivos `content` y `parity` se modifican si es necesario. +Los archivos en el array NO se modifican. +

5.8 +scrub +

+Frota (scrubs) el array, buscando errores silenciosos o de +entrada/salida en los discos de datos y paridad. +

+Cada invocación verifica aproximadamente el 8% del array, excluyendo +los datos ya fregados en los últimos 10 días. +Esto significa que fregar una vez a la semana asegura que cada bit de +datos se verifique al menos una vez cada tres meses. +

+Puede definir un plan de fregado o una cantidad diferente utilizando +la opción -p, --plan, que acepta: +bad - Fregar bloques marcados como defectuosos. +new - Fregar bloques recién sincronizados que aún no han sido fregados. +full - Fregar todo. +0-100 - Fregar el porcentaje especificado de bloques. +

+Si especifica un valor de porcentaje, también puede usar la opción -o, +--older-than para definir la antigüedad del bloque. +Los bloques más antiguos se friegan primero, asegurando una verificación +óptima. +Si desea fregar solo los bloques recién sincronizados que aún no han +sido fregados, use la opción `-p new`. +

+Para obtener detalles del estado del fregado, use el comando `status`. +

+Para cualquier error silencioso o de entrada/salida encontrado, los +bloques correspondientes se marcan como defectuosos en el archivo +`content`. +Estos bloques defectuosos se enumeran en `status` y se pueden +corregir con `fix -e`. +Después de la corrección, en el siguiente fregado, se volverán a +verificar y, si se encuentran corregidos, se eliminará la marca de defectuoso. +Para fregar solo los bloques defectuosos, puede usar el comando +`scrub -p bad`. +

+Se recomienda ejecutar `scrub` solo en un array sincronizado para evitar +errores reportados causados por datos no sincronizados. Estos errores +se reconocen como no siendo errores silenciosos y los bloques no se +marcan como defectuosos, pero tales errores se informan en la salida +del comando. +

+El archivo `content` se modifica para actualizar el tiempo de la última +verificación de cada bloque y para marcar bloques defectuosos. +Los archivos `parity` NO se modifican. +Los archivos en el array NO se modifican. +

5.9 +fix +

+Corrige todos los archivos y la información de paridad. +

+Todos los archivos y la información de paridad se comparan con el +estado de instantánea guardado en el último `sync`. +Si se encuentra una diferencia, se revierte a la instantánea almacenada. +

+¡ADVERTENCIA! El comando `fix` no diferencia entre errores y +modificaciones intencionales. Revierte incondicionalmente el estado +del archivo al último `sync`. +

+Si no se especifica otra opción, se procesa todo el array. +Utilice las opciones de filtro para seleccionar un subconjunto de +archivos o discos para operar. +

+Para corregir solo los bloques marcados como defectuosos durante `sync` +y `scrub`, use la opción -e, --filter-error. +A diferencia de otras opciones de filtro, esta aplica correcciones solo +a archivos que no han cambiado desde el último `sync`. +

+SnapRAID cambia el nombre de todos los archivos que no se pueden corregir +agregando la extensión `.unrecoverable`. +

+Antes de corregir, se escanea todo el array para encontrar cualquier +archivo movido desde la última operación de `sync`. +Estos archivos se identifican por su marca de tiempo, ignorando su +nombre y directorio, y se utilizan en el proceso de recuperación si +es necesario. +Si movió algunos de ellos fuera del array, puede usar la opción -i, +--import para especificar directorios adicionales para escanear. +

+Los archivos se identifican solo por ruta, no por inodo. +

+El archivo `content` NO se modifica. +Los archivos `parity` se modifican si es necesario. +Los archivos en el array se modifican si es necesario. +

5.10 +check +

+Verifica todos los archivos y la información de paridad. +

+Funciona como `fix`, pero solo simula una recuperación y no se +escriben cambios en el array. +

+Este comando está destinado principalmente a la verificación manual, +como después de un proceso de recuperación o en otras condiciones +especiales. Para comprobaciones periódicas y programadas, use `scrub`. +

+Si usa la opción -a, --audit-only, solo se verifican los datos del +archivo y se ignora la información de paridad para una ejecución más +rápida. +

+Los archivos se identifican solo por ruta, no por inodo. +

+Nada se modifica. +

5.11 +list +

+Enumera todos los archivos contenidos en el array en el momento del +último `sync`. +

+Con -v o --verbose, también se muestra el tiempo de subsegundo. +

+Nada se modifica. +

5.12 +dup +

+Enumera todos los archivos duplicados. Se supone que dos archivos son +iguales si sus hashes coinciden. Los datos del archivo no se leen; +solo se utilizan los hashes precalculados. +

+Nada se modifica. +

5.13 +pool +

+Crea o actualiza una vista virtual de todos +los archivos de su array de discos en el directorio de `pooling`. +

+Los archivos no se copian sino que se enlazan usando +enlaces simbólicos. +

+Al actualizar, todos los enlaces simbólicos existentes y los +subdirectorios vacíos se eliminan y se reemplazan con la nueva +vista del array. Cualquier otro archivo regular se deja en su lugar. +

+Nada se modifica fuera del directorio pool. +

5.14 +devices +

+Imprime los dispositivos de bajo nivel utilizados por el array. +

+Este comando muestra las asociaciones de dispositivos en el array +y está destinado principalmente como una interfaz de script. +

+Las primeras dos columnas son el ID y la ruta del dispositivo de bajo +nivel. Las siguientes dos columnas son el ID y la ruta del dispositivo +de alto nivel. La última columna es el nombre del disco en el array. +

+En la mayoría de los casos, tiene un dispositivo de bajo nivel para +cada disco en el array, pero en algunas configuraciones más complejas, +puede tener múltiples dispositivos de bajo nivel utilizados por un +solo disco en el array. +

+Nada se modifica. +

5.15 +touch +

+Establece una marca de tiempo de subsegundo arbitraria para todos los +archivos que la tienen establecida en cero. +

+Esto mejora la capacidad de SnapRAID para reconocer archivos movidos +y copiados, ya que hace que la marca de tiempo sea casi única, +reduciendo posibles duplicados. +

+Más específicamente, si la marca de tiempo de subsegundo no es cero, +un archivo movido o copiado se identifica como tal si coincide con +el nombre, el tamaño y la marca de tiempo. Si la marca de tiempo de +subsegundo es cero, se considera una copia solo si la ruta completa, +el tamaño y la marca de tiempo coinciden. +

+La marca de tiempo de precisión de segundo no se modifica, +por lo que se conservarán todas las fechas y horas de sus archivos. +

5.16 +rehash +

+Programa un nuevo cálculo de hash (rehash) de todo el array. +

+Este comando cambia el tipo de hash utilizado, típicamente al +actualizar de un sistema de 32 bits a uno de 64 bits, para cambiar +de MurmurHash3 al más rápido SpookyHash. +

+Si ya está utilizando el hash óptimo, este comando +no hace nada y le informa que no se necesita ninguna acción. +

+El nuevo cálculo de hash no se realiza inmediatamente, sino que +tiene lugar progresivamente durante `sync` y `scrub`. +

+Puede verificar el estado del nuevo cálculo de hash usando `status`. +

+Durante el nuevo cálculo de hash, SnapRAID mantiene la funcionalidad +completa, con la única excepción de que `dup` no puede detectar +archivos duplicados utilizando un hash diferente. +

6 +Options +

+SnapRAID proporciona las siguientes opciones: + + +
+-c, --conf CONFIG +
+Selecciona el archivo de configuración a usar. Si no se +especifica, en Unix utiliza el archivo `/usr/local/etc/snapraid.conf` +si existe, de lo contrario `/etc/snapraid.conf`. +En Windows, utiliza el archivo `snapraid.conf` en el mismo +directorio que `snapraid.exe`. +
+ + +
+-f, --filter PATTERN +
+Filtra los archivos a procesar en `check` y `fix`. +Solo se procesan los archivos que coinciden con el patrón +especificado. Esta opción se puede usar varias veces. +Consulte la sección PATTERN para obtener más detalles sobre +las especificaciones de patrones. +En Unix, asegúrese de que los caracteres globbing estén +entre comillas si se usan. +Esta opción solo se puede usar con `check` y `fix`. +No se puede usar con `sync` y `scrub`, ya que siempre +procesan todo el array. +
+ + +
+-d, --filter-disk NAME +
+Filtra los discos a procesar en `check`, `fix`, `up` y `down`. +Debe especificar un nombre de disco como se define en el archivo +de configuración. +También puede especificar discos de paridad con los nombres: +`parity`, `2-parity`, `3-parity`, etc., para limitar las +operaciones a un disco de paridad específico. +Si combina múltiples opciones --filter, --filter-disk y +--filter-missing, solo se seleccionan los archivos que +coinciden con todos los filtros. +Esta opción se puede usar varias veces. +Esta opción solo se puede usar con `check`, `fix`, `up` y `down`. +No se puede usar con `sync` y `scrub`, ya que siempre +procesan todo el array. +
+ + +
+-m, --filter-missing +
+Filtra los archivos a procesar en `check` y `fix`. +Solo se procesan los archivos faltantes o eliminados del array. +Cuando se usa con `fix`, esto actúa como un comando de `undelete` +(recuperación). +Si combina múltiples opciones --filter, --filter-disk y +--filter-missing, solo se seleccionan los archivos que +coinciden con todos los filtros. +Esta opción solo se puede usar con `check` y `fix`. +No se puede usar con `sync` y `scrub`, ya que siempre +procesan todo el array. +
+ + +
+-e, --filter-error +
+Procesa los archivos con errores en `check` y `fix`. +Solo procesa archivos que tienen bloques marcados con errores +silenciosos o de entrada/salida durante `sync` y `scrub`, +según se enumeran en `status`. +Esta opción solo se puede usar con `check` y `fix`. +
+ + +
+-p, --plan PERC|bad|new|full +
+Selecciona el plan de fregado (scrub). Si PERC es un valor +numérico de 0 a 100, se interpreta como el porcentaje de +bloques a fregar. +En lugar de un porcentaje, puede especificar un plan: +`bad` friega bloques defectuosos, `new` friega bloques aún +no fregados, y `full` friega todo. +Esta opción solo se puede usar con `scrub`. +
+ + +
+-o, --older-than DAYS +
+Selecciona la parte más antigua del array para procesar en `scrub`. +DAYS es la edad mínima en días para que un bloque sea fregado; +el valor predeterminado es 10. +Los bloques marcados como defectuosos siempre se friegan +independientemente de esta opción. +Esta opción solo se puede usar con `scrub`. +
+ + +
+-a, --audit-only +
+En `check`, verifica el hash de los archivos sin +verificar la información de paridad. +Si solo está interesado en verificar los datos del archivo, +esta opción puede acelerar significativamente el proceso de +verificación. +Esta opción solo se puede usar con `check`. +
+ + +
+-h, --pre-hash +
+En `sync`, ejecuta una fase de hash preliminar de todos los +datos nuevos para una verificación adicional antes del +cálculo de paridad. +Normalmente, en `sync`, no se realiza un hash preliminar, +y los nuevos datos se hashean justo antes del cálculo de +paridad cuando se leen por primera vez. +Este proceso ocurre cuando el sistema está bajo +una gran carga, con todos los discos girando y una CPU ocupada. +Esta es una condición extrema para la máquina, y si tiene un +problema de hardware latente, los errores silenciosos pueden +pasar desapercibidos porque los datos aún no están hasheados. +Para evitar este riesgo, puede habilitar el modo `pre-hash` +para que todos los datos se lean dos veces para garantizar +su integridad. +Esta opción también verifica los archivos movidos dentro del +array para asegurar que la operación de movimiento fue exitosa +y, si es necesario, le permite ejecutar una operación de corrección +antes de continuar. +Esta opción solo se puede usar con `sync`. +
+ + +
+-i, --import DIR +
+Importa desde el directorio especificado cualquier archivo +eliminado del array después del último `sync`. +Si aún tiene dichos archivos, `check` y `fix` pueden usarlos +para mejorar el proceso de recuperación. +Los archivos se leen, incluso en subdirectorios, y se +identifican independientemente de su nombre. +Esta opción solo se puede usar con `check` y `fix`. +
+ + +
+-s, --spin-down-on-error +
+En cualquier error, detiene todos los discos gestionados antes +de salir con un código de estado distinto de cero. Esto evita +que las unidades permanezcan activas y girando después de una +operación abortada, lo que ayuda a evitar la acumulación de calor +innecesaria y el consumo de energía. Use esta opción para +asegurarse de que los discos se detengan de forma segura incluso +cuando un comando falla. +
+ + +
+-w, --bw-limit RATE +
+Aplica un límite de ancho de banda global para todos los discos. +RATE es el número de bytes por segundo. Puede especificar un +multiplicador como K, M o G (por ejemplo, --bw-limit 1G). +
+ + +
+-A, --stats +
+Habilita una vista de estado extendida que muestra información +adicional. La pantalla muestra dos gráficos: +El primer gráfico muestra el número de franjas (stripes) +almacenadas en búfer para cada disco, junto con la ruta del +archivo al que se está accediendo actualmente en ese disco. +Normalmente, el disco más lento no tendrá búfer disponible, +lo que determina el ancho de banda máximo alcanzable. +El segundo gráfico muestra el porcentaje de tiempo +dedicado a esperar durante los últimos 100 segundos. Se espera +que el disco más lento cause la mayor parte del tiempo de +espera, mientras que otros discos deberían tener poco o ningún +tiempo de espera porque pueden usar sus franjas almacenadas +en búfer. Este gráfico también muestra el tiempo dedicado a +esperar los cálculos de hash y los cálculos RAID. +Todos los cálculos se ejecutan en paralelo con las +operaciones de disco. Por lo tanto, mientras haya un tiempo +de espera medible para al menos un disco, indica que la CPU +es lo suficientemente rápida para mantenerse al día con la +carga de trabajo. +
+ + +
+-Z, --force-zero +
+Fuerza la operación insegura de sincronizar un archivo con +tamaño cero que antes no era cero. +Si SnapRAID detecta tal condición, detiene el procedimiento +a menos que especifique esta opción. +Esto le permite detectar fácilmente cuando, después de un +fallo del sistema, algunos archivos accedidos fueron truncados. +Esta es una posible condición en Linux con los sistemas de +archivos ext3/ext4. +Esta opción solo se puede usar con `sync`. +
+ + +
+-E, --force-empty +
+Fuerza la operación insegura de sincronizar un disco con todos +los archivos originales faltantes. +Si SnapRAID detecta que todos los archivos originalmente +presentes en el disco faltan o han sido reescritos, detiene +el procedimiento a menos que especifique esta opción. +Esto le permite detectar fácilmente cuando un sistema de archivos +de datos no está montado. +Sin embargo, se permite tener un solo cambio de UUID con +paridad simple, y más con paridad múltiple, porque este es +el caso normal al reemplazar discos después de una recuperación. +Esta opción solo se puede usar con `sync`. +
+ + +
+-U, --force-uuid +
+Fuerza la operación insegura de sincronizar, verificar y +corregir con discos que han cambiado su UUID. +Si SnapRAID detecta que algunos discos han cambiado el UUID, +detiene el procedimiento a menos que especifique esta opción. +Esto le permite detectar cuando sus discos están montados en +los puntos de montaje incorrectos. +Esta opción solo se puede usar con `sync`, `check` o `fix`. +
+ + +
+-D, --force-device +
+Fuerza la operación insegura de corregir con discos inaccesibles +o con discos en el mismo dispositivo físico. +Por ejemplo, si perdió dos discos de datos y tiene un disco de +repuesto para recuperar solo el primero, puede ignorar el +segundo disco inaccesible. +O, si desea recuperar un disco en el espacio libre que queda +en un disco ya usado, compartiendo el mismo dispositivo físico. +Esta opción solo se puede usar con `fix`. +
+ + +
+-N, --force-nocopy +
+En `sync`, `check` y `fix`, deshabilita la heurística de +detección de copias. Sin esta opción, SnapRAID asume que +los archivos con los mismos atributos, como nombre, tamaño y +marca de tiempo, son copias con los mismos datos. +Esto permite la identificación de archivos copiados o movidos +de un disco a otro y reutiliza la información de hash ya +calculada para detectar errores silenciosos o recuperar archivos +faltantes. +En algunos casos raros, este comportamiento puede dar lugar a +falsos positivos o a un proceso lento debido a muchas +verificaciones de hash, y esta opción le permite resolver +tales problemas. +Esta opción solo se puede usar con `sync`, `check` y `fix`. +
+ + +
+-F, --force-full +
+En `sync`, fuerza un recálculo completo de la paridad. +Esta opción se puede usar cuando agrega un nuevo nivel de +paridad o si revirtió a un archivo de contenido antiguo +utilizando datos de paridad más recientes. +En lugar de recrear la paridad desde cero, esto le permite +reutilizar los hashes presentes en el archivo de contenido +para validar los datos y mantener la protección de datos durante +el proceso `sync` utilizando los datos de paridad existentes. +Esta opción solo se puede usar con `sync`. +
+ + +
+-R, --force-realloc +
+En `sync`, fuerza una reasignación completa de archivos y +la reconstrucción de la paridad. +Esta opción se puede usar para reasignar completamente todos +los archivos, eliminando la fragmentación, mientras se reutilizan +los hashes presentes en el archivo de contenido para validar los datos. +Esta opción solo se puede usar con `sync`. +¡ADVERTENCIA! Esta opción es solo para expertos y se +recomienda encarecidamente no usarla. +NO tiene protección de datos durante la operación `sync`. +
+ + +
+-l, --log FILE +
+Escribe un registro detallado en el archivo especificado. +Si no se especifica esta opción, los errores inesperados se +imprimen en la pantalla, lo que puede resultar en una salida +excesiva en caso de muchos errores. Cuando se especifica -l, +--log, solo los errores fatales que hacen que SnapRAID se +detenga se imprimen en la pantalla. +Si la ruta comienza con '>>', el archivo se abre +en modo de anexar. Las ocurrencias de '%D' y '%T' en el nombre +se reemplazan con la fecha y hora en el formato AAAA MM DD y HH MM SS. +En archivos por lotes de Windows, debe duplicar el +carácter '%', por ejemplo, resultado-%%D.log. Para usar '>>', +debe encerrar el nombre entre comillas, por ejemplo, `">>resultado.log"`. +Para enviar el registro a la salida estándar o al error +estándar, puede usar `">&1"` y `">&2"`, respectivamente. +Consulte el archivo snapraid_log.txt o la página del manual +para obtener descripciones de las etiquetas de registro. +
+ + +
+-L, --error-limit NUMBER +
+Establece un nuevo límite de error antes de detener la ejecución. +De forma predeterminada, SnapRAID se detiene si encuentra más +de 100 errores de entrada/salida, lo que indica que es probable +que un disco esté fallando. +Esta opción afecta a `sync` y `scrub`, a los que se les +permite continuar después del primer conjunto de errores de +disco para intentar completar sus operaciones. +Sin embargo, `check` y `fix` siempre se detienen en el primer error. +
+ + +
+-S, --start BLKSTART +
+Comienza a procesar desde el número de bloque especificado. +Esto puede ser útil para reintentar verificar o corregir +bloques específicos en caso de un disco dañado. +Esta opción es principalmente para recuperación manual avanzada. +
+ + +
+-B, --count BLKCOUNT +
+Procesa solo el número de bloques especificado. +Esta opción es principalmente para recuperación manual avanzada. +
+ + +
+-C, --gen-conf CONTENT +
+Genera un archivo de configuración ficticio a partir de un +archivo de contenido existente. +El archivo de configuración se escribe en la salida estándar +y no sobrescribe uno existente. +Este archivo de configuración también contiene la información +necesaria para reconstruir los puntos de montaje del disco en +caso de que pierda todo el sistema. +
+ + +
+-v, --verbose +
+Imprime más información en la pantalla. +Si se especifica una vez, imprime archivos excluidos +y estadísticas adicionales. +Esta opción no tiene efecto en los archivos de registro. +
+ + +
+-q, --quiet +
+Imprime menos información en la pantalla. +Si se especifica una vez, elimina la barra de progreso; +dos veces, las operaciones en ejecución; tres veces, los +mensajes de información; cuatro veces, los mensajes de estado. +Los errores fatales siempre se imprimen en la pantalla. +Esta opción no tiene efecto en los archivos de registro. +
+ + +
+-H, --help +
+Imprime una pantalla de ayuda corta. +
+ + +
+-V, --version +
+Imprime la versión del programa. +
+

7 +Configuration +

+SnapRAID requiere un archivo de configuración para saber dónde se +encuentra su array de discos y dónde almacenar la información de paridad. +

+En Unix, utiliza el archivo `/usr/local/etc/snapraid.conf` si existe, +de lo contrario `/etc/snapraid.conf`. +En Windows, utiliza el archivo `snapraid.conf` en el mismo +directorio que `snapraid.exe`. +

+Debe contener las siguientes opciones (distingue entre mayúsculas y minúsculas): +

7.1 +parity FILE [,FILE] ... +

+Define los archivos a usar para almacenar la información de paridad. +La paridad permite la protección contra un solo fallo de disco, +similar a RAID5. +

+Puede especificar varios archivos, que deben estar en discos diferentes. +Cuando un archivo no puede crecer más, se utiliza el siguiente. +El espacio total disponible debe ser al menos tan grande como el +disco de datos más grande del array. +

+Puede agregar archivos de paridad adicionales más tarde, pero no +puede reordenarlos ni eliminarlos. +

+Mantener los discos de paridad reservados para la paridad asegura +que no se fragmenten, mejorando el rendimiento. +

+En Windows, se dejan 256 MB sin usar en cada disco para evitar la +advertencia sobre discos llenos. +

+Esta opción es obligatoria y solo se puede usar una vez. +

7.2 +(2,3,4,5,6)-parity FILE [,FILE] ... +

+Define los archivos a usar para almacenar información de paridad +adicional. +

+Para cada nivel de paridad especificado, se habilita un nivel +adicional de protección: +

+

+Cada nivel de paridad requiere la presencia de todos los niveles +de paridad anteriores. +

+Se aplican las mismas consideraciones que para la opción 'parity'. +

+Estas opciones son opcionales y solo se pueden usar una vez. +

7.3 +z-parity FILE [,FILE] ... +

+Define un archivo y un formato alternativos para almacenar paridad triple. +

+Esta opción es una alternativa a '3-parity', destinada principalmente +a CPU de gama baja como ARM o AMD Phenom, Athlon y Opteron que no +admiten el conjunto de instrucciones SSSE3. En tales casos, +proporciona un mejor rendimiento. +

+Este formato es similar pero más rápido que el utilizado por ZFS RAIDZ3. +Al igual que ZFS, no funciona más allá de la paridad triple. +

+Al usar '3-parity', se le advertirá si se recomienda usar +el formato 'z-parity' para mejorar el rendimiento. +

+Es posible convertir de un formato a otro ajustando +el archivo de configuración con el archivo z-parity o 3-parity +deseado y usando 'fix' para recrearlo. +

7.4 +content FILE +

+Define el archivo a usar para almacenar la lista y las sumas de +comprobación de todos los archivos presentes en su array de discos. +

+Se puede colocar en un disco utilizado para datos, paridad o +cualquier otro disco disponible. +Si usa un disco de datos, este archivo se excluye automáticamente +del proceso `sync`. +

+Esta opción es obligatoria y se puede usar varias veces para guardar +múltiples copias del mismo archivo. +

+Debe almacenar al menos una copia por cada disco de paridad utilizado +más uno. Usar copias adicionales no perjudica. +

7.5 +data NAME DIR +

+Define el nombre y el punto de montaje de los discos de datos en +el array. NAME se usa para identificar el disco y debe +ser único. DIR es el punto de montaje del disco en el +sistema de archivos. +

+Puede cambiar el punto de montaje según sea necesario, siempre que +mantenga el NAME fijo. +

+Debe usar una opción para cada disco de datos en el array. +

+Puede cambiar el nombre de un disco más tarde cambiando el NAME +directamente en el archivo de configuración y luego ejecutando un +comando 'sync'. En el caso de cambiar el nombre, la asociación se +realiza utilizando el UUID almacenado de los discos. +

7.6 +nohidden +

+Excluye todos los archivos y directorios ocultos. +En Unix, los archivos ocultos son los que comienzan con `.`. +En Windows, son los que tienen el atributo oculto. +

7.7 +exclude/include PATTERN +

+Define los patrones de archivo o directorio a excluir o incluir +en el proceso de sincronización. +Todos los patrones se procesan en el orden especificado. +

+Si el primer patrón que coincide es un `exclude`, el archivo +se excluye. Si es un `include`, el archivo se incluye. +Si ningún patrón coincide, el archivo se excluye si el último +patrón especificado es un `include`, o se incluye si el último +patrón especificado es un `exclude`. +

+Consulte la sección PATTERN para obtener más detalles sobre +las especificaciones de patrones. +

+Esta opción se puede usar varias veces. +

7.8 +blocksize SIZE_IN_KIBIBYTES +

+Define el tamaño de bloque básico en kibibytes para la paridad. +Un kibibyte es 1024 bytes. +

+El tamaño de bloque predeterminado es 256, que debería funcionar +para la mayoría de los casos. +

+¡ADVERTENCIA! Esta opción es solo para expertos y se +recomienda encarecidamente no cambiar este valor. Para cambiar +este valor en el futuro, ¡tendrá que recrear toda la paridad! +

+Una razón para usar un tamaño de bloque diferente es si tiene +muchos archivos pequeños, del orden de millones. +

+Para cada archivo, incluso si solo son unos pocos bytes, se asigna +un bloque completo de paridad, y con muchos archivos, esto puede +resultar en un espacio de paridad no utilizado significativo. +Cuando llena completamente el disco de paridad, no se le permite +agregar más archivos a los discos de datos. +Sin embargo, la paridad desperdiciada no se acumula en los discos +de datos. El espacio desperdiciado resultante de un alto número de +archivos en un disco de datos limita solo la cantidad de datos en +ese disco de datos, no en otros. +

+Como aproximación, puede suponer que se desperdicia la mitad del +tamaño del bloque para cada archivo. Por ejemplo, con 100,000 archivos +y un tamaño de bloque de 256 KiB, desperdiciará 12.8 GB de paridad, +lo que puede resultar en 12.8 GB menos de espacio disponible en el +disco de datos. +

+Puede verificar la cantidad de espacio desperdiciado en cada disco +usando `status`. Este es el espacio que debe dejar libre en los +discos de datos o usar para archivos no incluidos en el array. +Si este valor es negativo, significa que está cerca de llenar +la paridad, y representa el espacio que aún puede desperdiciar. +

+Para evitar este problema, puede usar una partición más grande para +la paridad. Por ejemplo, si la partición de paridad es 12.8 GB +más grande que los discos de datos, tiene suficiente espacio extra +para manejar hasta 100,000 archivos en cada disco de datos sin +ningún espacio desperdiciado. +

+Un truco para obtener una partición de paridad más grande en Linux +es formatearla con el comando: +

+
+
+mkfs.ext4 -m 0 -T largefile4 DEVICE
+
+
+

+Esto resulta en aproximadamente un 1.5% de espacio extra, +aproximadamente 60 GB para un disco de 4 TB, lo que permite +alrededor de 460,000 archivos en cada disco de datos sin ningún +espacio desperdiciado. +

7.9 +hashsize SIZE_IN_BYTES +

+Define el tamaño del hash en bytes para los bloques guardados. +

+El tamaño de hash predeterminado es de 16 bytes (128 bits), +que debería funcionar para la mayoría de los casos. +

+¡ADVERTENCIA! Esta opción es solo para expertos y se +recomienda encarecidamente no cambiar este valor. Para cambiar +este valor en el futuro, ¡tendrá que recrear toda la paridad! +

+Una razón para usar un tamaño de hash diferente es si su sistema +tiene memoria limitada. Como regla general, SnapRAID +típicamente requiere 1 GiB de RAM por cada 16 TB de datos en el array. +

+Específicamente, para almacenar los hashes de los datos, SnapRAID +requiere aproximadamente TS*(1+HS)/BS bytes de RAM, +donde TS es el tamaño total en bytes de su array de discos, BS es el +tamaño de bloque en bytes, y HS es el tamaño de hash en bytes. +

+Por ejemplo, con 8 discos de 4 TB, un tamaño de bloque de 256 KiB +(1 KiB = 1024 bytes) y un tamaño de hash de 16, obtiene: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB
+
+

+Cambiando a un tamaño de hash de 8, obtiene: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB
+
+

+Cambiando a un tamaño de bloque de 512, obtiene: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB
+
+

+Cambiando tanto a un tamaño de hash de 8 como a un tamaño de bloque de 512, +obtiene: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB
+
+

7.10 +autosave SIZE_IN_GIGABYTES +

+Guarda automáticamente el estado al sincronizar o fregar después de +la cantidad especificada de GB procesados. +Esta opción es útil para evitar reiniciar comandos `sync` largos +desde cero si son interrumpidos por un fallo de la máquina o +cualquier otro evento. +

7.11 +temp_limit TEMPERATURE_CELSIUS +

+Establece la temperatura máxima permitida del disco en Celsius. +Cuando se especifica, SnapRAID verifica periódicamente la temperatura +de todos los discos utilizando la herramienta smartctl. Las +temperaturas actuales del disco se muestran mientras SnapRAID está +operando. Si algún disco excede este límite, todas las operaciones +se detienen y los discos se detienen (se ponen en espera) durante +la duración definida por la opción `temp_sleep`. Después del +período de espera, las operaciones se reanudan, pausándose +potencialmente de nuevo si se alcanza el límite de temperatura +una vez más. +

+Durante la operación, SnapRAID también analiza la curva de +calentamiento de cada disco y estima la temperatura constante a +largo plazo que se espera que alcancen si la actividad continúa. +La estimación se realiza solo después de que la temperatura del +disco haya aumentado cuatro veces, asegurando que haya suficientes +puntos de datos disponibles para establecer una tendencia confiable. +Esta temperatura constante predicha se muestra entre paréntesis junto +al valor actual y ayuda a evaluar si la refrigeración del sistema es +adecuada. Esta temperatura estimada es solo para fines informativos +y no tiene ningún efecto en el comportamiento de SnapRAID. Las +acciones del programa se basan únicamente en las temperaturas reales +medidas del disco. +

+Para realizar este análisis, SnapRAID necesita una referencia para la +temperatura del sistema. Primero intenta leerla de los sensores de +hardware disponibles. Si no se puede acceder a ningún sensor del +sistema, utiliza la temperatura del disco más baja medida al +comienzo de la ejecución como referencia de respaldo. +

+Normalmente, SnapRAID solo muestra la temperatura del disco más +caliente. Para mostrar la temperatura de todos los discos, use +la opción -A o --stats. +

7.12 +temp_sleep TIME_IN_MINUTES +

+Establece el tiempo de espera, en minutos, cuando se alcanza el +límite de temperatura. Durante este período, los discos permanecen +detenidos. El valor predeterminado es de 5 minutos. +

7.13 +pool DIR +

+Define el directorio de agrupación (pooling) donde se crea la vista +virtual del array de discos utilizando el comando `pool`. +

+El directorio ya debe existir. +

7.14 +share UNC_DIR +

+Define la ruta UNC de Windows requerida para acceder a los discos +de forma remota. +

+Si se especifica esta opción, los enlaces simbólicos creados en el +directorio pool utilizan esta ruta UNC para acceder a los discos. +Sin esta opción, los enlaces simbólicos generados utilizan solo +rutas locales, lo que no permite compartir el directorio pool a +través de la red. +

+Los enlaces simbólicos se forman utilizando la ruta UNC especificada, +agregando el nombre del disco como se especifica en la opción `data`, +y finalmente agregando el directorio y el nombre del archivo. +

+Esta opción solo es necesaria para Windows. +

7.15 +smartctl DISK/PARITY OPTIONS... +

+Define opciones personalizadas de smartctl para obtener los atributos +SMART de cada disco. Esto puede ser necesario para controladores +RAID y algunos discos USB que no se pueden detectar automáticamente. +El marcador de posición %s se reemplaza por el nombre del dispositivo, +pero es opcional para dispositivos fijos como controladores RAID. +

+DISK es el mismo nombre de disco especificado en la opción `data`. +PARITY es uno de los nombres de paridad: `parity`, `2-parity`, +`3-parity`, `4-parity`, `5-parity`, `6-parity` o `z-parity`. +

+En las OPCIONES especificadas, la cadena `%s` se reemplaza por +el nombre del dispositivo. Para los controladores RAID, el dispositivo +es probable que sea fijo y es posible que no necesite usar `%s`. +

+Consulte la documentación de smartmontools para conocer las posibles +opciones: +

+
+
+https://www.smartmontools.org/wiki/Supported_RAID-Controllers
+https://www.smartmontools.org/wiki/Supported_USB-Devices
+
+
+

+Por ejemplo: +

+
+
+smartctl parity -d sat %s
+
+
+

7.16 +smartignore DISK/PARITY ATTR [ATTR...] +

+Ignora el atributo SMART especificado al calcular la probabilidad +de fallo del disco. Esta opción es útil si un disco informa valores +inusuales o engañosos para un atributo en particular. +

+DISK es el mismo nombre de disco especificado en la opción `data`. +PARITY es uno de los nombres de paridad: `parity`, `2-parity`, +`3-parity`, `4-parity`, `5-parity`, `6-parity` o `z-parity`. +El valor especial * se puede usar para ignorar el atributo en todos +los discos. +

+Por ejemplo, para ignorar el atributo `Current Pending Sector Count` +en todos los discos: +

+
+
+smartignore * 197
+
+
+

+Para ignorarlo solo en el primer disco de paridad: +

+
+
+smartignore parity 197
+
+
+

7.17 +Examples +

+Un ejemplo de una configuración típica para Unix es: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /mnt/diskp/snapraid.content
+content /var/snapraid/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+exclude /lost+found/
+exclude /tmp/
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/sg0
+smartctl 2-parity -d areca,2/1 /dev/sg0
+
+
+

+Un ejemplo de una configuración típica para Windows es: +

+
+
+parity E:\snapraid.parity
+content E:\snapraid.content
+content C:\snapraid\snapraid.content
+data d1 G:\array\
+data d2 H:\array\
+data d3 I:\array\
+exclude Thumbs.db
+exclude \$RECYCLE.BIN
+exclude \System Volume Information
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/arcmsr0
+smartctl 2-parity -d areca,2/1 /dev/arcmsr0
+
+
+

8 +Pattern +

+Los patrones se utilizan para seleccionar un subconjunto de archivos +para excluir o incluir en el proceso. +

+Hay cuatro tipos diferentes de patrones: + + +
+FILE +
+Selecciona cualquier archivo llamado FILE. Puede usar +cualquier carácter globbing como * y ?, y clases de caracteres +como [a-z]. Este patrón se aplica solo a archivos, no a directorios. +
+ + +
+DIR/ +
+Selecciona cualquier directorio llamado DIR y todo lo que +contiene. Puede usar cualquier carácter globbing como * y ?. +Este patrón se aplica solo a directorios, no a archivos. +
+ + +
+/PATH/FILE +
+Selecciona la ruta de archivo exacta especificada. Puede usar +cualquier carácter globbing como * y ?, pero nunca coinciden +con una barra de directorio. +Este patrón se aplica solo a archivos, no a directorios. +
+ + +
+/PATH/DIR/ +
+Selecciona la ruta de directorio exacta especificada y todo +lo que contiene. Puede usar cualquier carácter globbing como * y ?, +pero nunca coinciden con una barra de directorio. +Este patrón se aplica solo a directorios, no a archivos. +
+

+Cuando especifica una ruta absoluta que comienza con /, se aplica +en el directorio raíz del array, no en el directorio raíz del +sistema de archivos local. +

+En Windows, puede usar la barra invertida \ en lugar de la barra /. +Los directorios del sistema de Windows, las uniones, los puntos de +montaje y otros directorios especiales de Windows se tratan como +archivos, lo que significa que para excluirlos, debe usar una regla +de archivo, no una de directorio. +

+Si el nombre del archivo contiene un carácter '*', '?', '[', +o ']', debe escaparlo para evitar que se interprete como un +carácter globbing. En Unix, el carácter de escape es '\'; +en Windows, es '^'. Cuando el patrón está en la línea de comandos, +debe duplicar el carácter de escape para evitar que sea +interpretado por el shell de comandos. +

+En el archivo de configuración, puede usar diferentes estrategias +para filtrar los archivos a procesar. +El enfoque más simple es usar solo reglas `exclude` para +eliminar todos los archivos y directorios que no desea procesar. +Por ejemplo: +

+
+
+# Excluye cualquier archivo llamado `*.unrecoverable`
+exclude *.unrecoverable
+# Excluye el directorio raíz `/lost+found`
+exclude /lost+found/
+# Excluye cualquier subdirectorio llamado `tmp`
+exclude tmp/
+
+
+

+El enfoque opuesto es definir solo los archivos que desea procesar, +utilizando solo reglas `include`. Por ejemplo: +

+
+
+# Incluye solo algunos directorios
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+El enfoque final es mezclar reglas `exclude` e `include`. En este +caso, el orden de las reglas es importante. Las reglas anteriores +tienen precedencia sobre las posteriores. +Para simplificar, puede enumerar todas las reglas `exclude` primero +y luego todas las reglas `include`. Por ejemplo: +

+
+
+# Excluye cualquier archivo llamado `*.unrecoverable`
+exclude *.unrecoverable
+# Excluye cualquier subdirectorio llamado `tmp`
+exclude tmp/
+# Incluye solo algunos directorios
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+En la línea de comandos, usando la opción -f, solo puede usar +patrones `include`. Por ejemplo: +

+
+
+# Verifica solo los archivos .mp3.
+# En Unix, use comillas para evitar la expansión globbing por el shell.
+snapraid -f "*.mp3" check
+
+
+

+En Unix, al usar caracteres globbing en la línea de comandos, debe +ponerlos entre comillas para evitar que el shell los expanda. +

9 +Content +

+SnapRAID almacena la lista y las sumas de comprobación de sus +archivos en el archivo de contenido. +

+Es un archivo binario que enumera todos los archivos presentes en +su array de discos, junto con todas las sumas de comprobación para +verificar su integridad. +

+Este archivo es leído y escrito por los comandos `sync` y `scrub` +y leído por los comandos `fix`, `check` y `status`. +

10 +Parity +

+SnapRAID almacena la información de paridad de su array en los +archivos de paridad. +

+Estos son archivos binarios que contienen la paridad calculada +de todos los bloques definidos en el archivo `content`. +

+Estos archivos son leídos y escritos por los comandos `sync` y `fix` +y solo leídos por los comandos `scrub` y `check`. +

11 +Encoding +

+SnapRAID en Unix ignora cualquier codificación. Lee y almacena los +nombres de archivo con la misma codificación utilizada por el sistema +de archivos. +

+En Windows, todos los nombres leídos del sistema de archivos se +convierten y procesan en formato UTF-8. +

+Para que los nombres de archivo se impriman correctamente, debe +configurar la consola de Windows en modo UTF-8 con el comando +`chcp 65001` y usar una fuente TrueType como `Lucida Console` +como fuente de la consola. Esto afecta solo a los nombres de +archivo impresos; si redirige la salida de la consola a un archivo, +el archivo resultante siempre está en formato UTF-8. + + + +

+ + + + + + diff --git a/manual-fr.html b/manual-fr.html new file mode 100644 index 00000000..dda60f38 --- /dev/null +++ b/manual-fr.html @@ -0,0 +1,2119 @@ + + + + + + + + + + + + + +SnapRAID + + + + + + + + + + + + +
+ + + +

+French manual for SnapRAID. +

+ +

1 +Synopsis +

+
+snapraid [-c, --conf CONFIG]
+    [-f, --filter MOTIF] [-d, --filter-disk NOM]
+    [-m, --filter-missing] [-e, --filter-error]
+    [-a, --audit-only] [-h, --pre-hash] [-i, --import DOSSIER]
+    [-p, --plan PERC|mauvais|nouveau|complet]
+    [-o, --older-than JOURS] [-l, --log FICHIER]
+    [-s, --spin-down-on-error] [-w, --bw-limit DÉBIT]
+    [-Z, --force-zero] [-E, --force-empty]
+    [-U, --force-uuid] [-D, --force-device]
+    [-N, --force-nocopy] [-F, --force-full]
+    [-R, --force-realloc]
+    [-S, --start BLKSTART] [-B, --count BLKCOUNT]
+    [-L, --error-limit NOMBRE]
+    [-A, --stats]
+    [-v, --verbose] [-q, --quiet]
+    status|smart|probe|up|down|diff|sync|scrub|fix|check
+    |list|dup|pool|devices|touch|rehash
+
+

+

+snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENU]
+
+

2 +Description +

+SnapRAID est un programme de sauvegarde conçu pour les baies de disques, +stockant les informations de parité pour la récupération des données en cas +de défaillance de six disques maximum. +

+Principalement destiné aux centres multimédia domestiques avec des fichiers +volumineux et peu souvent modifiés, SnapRAID offre plusieurs fonctionnalités : +

+

+Pour plus d'informations, veuillez visiter le site officiel de SnapRAID : +

+
+
+https://www.snapraid.it/
+
+
+

3 +Limitations +

+SnapRAID est un hybride entre un programme RAID et un programme de sauvegarde, +visant à combiner les meilleurs avantages des deux. Cependant, il a quelques +limitations que vous devriez considérer avant de l'utiliser. +

+La principale limitation est que si un disque tombe en panne et que vous +n'avez pas synchronisé récemment, vous pourriez ne pas être en mesure de +récupérer complètement. +Plus précisément, vous pourriez ne pas être en mesure de récupérer jusqu'à +la taille des fichiers modifiés ou supprimés depuis la dernière opération +de synchronisation. +Cela se produit même si les fichiers modifiés ou supprimés ne se trouvent +pas sur le disque défaillant. C'est pourquoi SnapRAID est mieux adapté +aux données qui changent rarement. +

+D'un autre côté, les fichiers nouvellement ajoutés n'empêchent pas +la récupération des fichiers déjà existants. Vous ne perdrez que les +fichiers récemment ajoutés s'ils se trouvent sur le disque défaillant. +

+Les autres limitations de SnapRAID sont : +

+

4 +Démarrer +

+Pour utiliser SnapRAID, vous devez d'abord sélectionner un disque +dans votre baie de disques pour le dédier aux informations de `parité`. +Avec un disque pour la parité, vous pourrez récupérer d'une +seule défaillance de disque, similaire au RAID5. +

+Si vous souhaitez récupérer de plus de défaillances de disques, +similaire au RAID6, vous devez réserver des disques supplémentaires +pour la parité. Chaque disque de parité supplémentaire permet la +récupération d'une défaillance de disque de plus. +

+Comme disques de parité, vous devez choisir les plus grands disques +de la baie, car les informations de parité peuvent atteindre la +taille du plus grand disque de données de la baie. +

+Ces disques seront dédiés au stockage des fichiers de `parité`. +Vous ne devriez pas y stocker vos données. +

+Ensuite, vous devez définir les disques de `données` que vous souhaitez +protéger avec SnapRAID. La protection est plus efficace si ces disques +contiennent des données qui changent rarement. Pour cette raison, il est +préférable de NE PAS inclure le disque C:\ de Windows ou les répertoires +/home, /var et /tmp d'Unix. +

+La liste des fichiers est enregistrée dans les fichiers `content` (contenu), +généralement stockés sur les disques de données, de parité ou de démarrage. +Ce fichier contient les détails de votre sauvegarde, y compris toutes les +sommes de contrôle pour vérifier son intégrité. +Le fichier `content` est stocké en plusieurs copies, et chaque copie +doit se trouver sur un disque différent pour garantir qu'au moins une +copie soit disponible, même en cas de défaillances de disques multiples. +

+Par exemple, supposons que vous ne soyez intéressé que par un seul +niveau de protection de parité, et que vos disques se trouvent à : +

+
+
+/mnt/diskp <- disque sélectionné pour la parité
+/mnt/disk1 <- premier disque à protéger
+/mnt/disk2 <- deuxième disque à protéger
+/mnt/disk3 <- troisième disque à protéger
+
+
+

+Vous devez créer le fichier de configuration /etc/snapraid.conf +avec les options suivantes : +

+
+
+parity /mnt/diskp/snapraid.parity
+content /var/snapraid/snapraid.content
+content /mnt/disk1/snapraid.content
+content /mnt/disk2/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+
+
+

+Si vous êtes sous Windows, vous devez utiliser le format de chemin +Windows, avec des lettres de lecteur et des barres obliques inverses +au lieu de barres obliques. +

+
+
+parity E:\snapraid.parity
+content C:\snapraid\snapraid.content
+content F:\array\snapraid.content
+content G:\array\snapraid.content
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+
+
+

+Si vous avez de nombreux disques et manquez de lettres de lecteur, +vous pouvez monter les disques directement dans des sous-dossiers. Voir : +

+
+
+https://www.google.com/search?q=Windows+mount+point
+
+
+

+À ce stade, vous êtes prêt à exécuter la commande `sync` (synchroniser) +pour construire les informations de parité. +

+
+
+snapraid sync
+
+
+

+Ce processus peut prendre plusieurs heures la première fois, en fonction +de la taille des données déjà présentes sur les disques. Si les disques +sont vides, le processus est immédiat. +

+Vous pouvez l'arrêter à tout moment en appuyant sur Ctrl+C, et lors de +la prochaine exécution, il reprendra là où il a été interrompu. +

+Lorsque cette commande est terminée, vos données sont EN SÉCURITÉ. +

+Vous pouvez maintenant commencer à utiliser votre baie comme vous le souhaitez +et mettre à jour périodiquement les informations de parité en exécutant +la commande `sync`. +

4.1 +Nettoyage (Scrubbing) +

+Pour vérifier périodiquement les données et la parité à la recherche +d'erreurs, vous pouvez exécuter la commande `scrub`. +

+
+
+snapraid scrub
+
+
+

+Cette commande compare les données de votre baie avec le hachage calculé +lors de la commande `sync` pour vérifier l'intégrité. +

+Chaque exécution de la commande vérifie environ 8 % de la baie, en +excluant les données déjà nettoyées au cours des 10 jours précédents. +Vous pouvez utiliser l'option -p, --plan pour spécifier une quantité +différente et l'option -o, --older-than pour spécifier un âge +différent en jours. Par exemple, pour vérifier 5 % de la baie +pour les blocs de plus de 20 jours, utilisez : +

+
+
+snapraid -p 5 -o 20 scrub
+
+
+

+Si des erreurs silencieuses ou d'entrée/sortie sont trouvées pendant +le processus, les blocs correspondants sont marqués comme mauvais +dans le fichier `content` et listés dans la commande `status`. +

+
+
+snapraid status
+
+
+

+Pour les corriger, vous pouvez utiliser la commande `fix`, en filtrant +les mauvais blocs avec l'option -e, --filter-error : +

+
+
+snapraid -e fix
+
+
+

+Lors du prochain `scrub`, les erreurs disparaîtront du rapport +`status` si elles sont réellement corrigées. Pour accélérer, +vous pouvez utiliser -p mauvais pour nettoyer uniquement les blocs +marqués comme mauvais. +

+
+
+snapraid -p bad scrub
+
+
+

+L'exécution de `scrub` sur une baie non synchronisée peut signaler +des erreurs causées par des fichiers supprimés ou modifiés. Ces erreurs +sont signalées dans la sortie de `scrub`, mais les blocs associés +ne sont pas marqués comme mauvais. +

4.2 +Mise en commun (Pooling) +

+Note : La fonctionnalité de mise en commun décrite ci-dessous a été +remplacée par l'outil mergefs, qui est désormais l'option recommandée +pour les utilisateurs Linux de la communauté SnapRAID. Mergefs offre +un moyen plus flexible et efficace de regrouper plusieurs disques +dans un seul point de montage unifié, permettant un accès transparent +aux fichiers sur toute votre baie sans dépendre de liens symboliques. +Il s'intègre bien avec SnapRAID pour la protection par parité et est +couramment utilisé dans des configurations comme OpenMediaVault (OMV) +ou des configurations NAS personnalisées. +

+Pour que tous les fichiers de votre baie apparaissent dans la même +arborescence de répertoires, vous pouvez activer la fonctionnalité +de `pooling`. Elle crée une vue virtuelle en lecture seule de tous +les fichiers de votre baie à l'aide de liens symboliques. +

+Vous pouvez configurer le répertoire de `pooling` dans le fichier +de configuration avec : +

+
+
+pool /pool
+
+
+

+ou, si vous êtes sous Windows, avec : +

+
+
+pool C:\pool
+
+
+

+puis exécutez la commande `pool` pour créer ou mettre à jour +la vue virtuelle. +

+
+
+snapraid pool
+
+
+

+Si vous utilisez une plateforme Unix et souhaitez partager ce +répertoire sur le réseau avec des machines Windows ou Unix, +vous devez ajouter les options suivantes à votre +/etc/samba/smb.conf : +

+
+
+# Dans la section globale de smb.conf
+unix extensions = no
+
+
+

+
+
+# Dans la section de partage de smb.conf
+[pool]
+comment = Pool
+path = /pool
+read only = yes
+guest ok = yes
+wide links = yes
+follow symlinks = yes
+
+
+

+Sous Windows, le partage de liens symboliques sur un réseau +nécessite que les clients les résolvent à distance. Pour +activer cela, en plus de partager le répertoire du pool, +vous devez également partager tous les disques indépendamment, +en utilisant les noms de disques définis dans le fichier de +configuration comme points de partage. Vous devez également +spécifier dans l'option `share` du fichier de configuration +le chemin UNC Windows que les clients distants doivent +utiliser pour accéder à ces disques partagés. +

+Par exemple, en opérant à partir d'un serveur nommé `darkstar`, +vous pouvez utiliser les options : +

+
+
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+pool C:\pool
+share \\darkstar
+
+
+

+et partager les répertoires suivants sur le réseau : +

+
+
+\\darkstar\pool -> C:\pool
+\\darkstar\d1 -> F:\array
+\\darkstar\d2 -> G:\array
+\\darkstar\d3 -> H:\array
+
+
+

+pour permettre aux clients distants d'accéder à tous les fichiers +à \\darkstar\pool. +

+Vous pourriez également avoir besoin de configurer les clients +distants pour activer l'accès aux liens symboliques distants avec +la commande : +

+
+
+fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
+
+
+

4.3 +Restauration (Undeleting) +

+SnapRAID fonctionne davantage comme un programme de sauvegarde +qu'un système RAID, et il peut être utilisé pour restaurer +ou récupérer des fichiers dans leur état précédent à l'aide +de l'option -f, --filter : +

+
+
+snapraid fix -f FICHIER
+
+
+

+ou pour un répertoire : +

+
+
+snapraid fix -f DOSSIER/
+
+
+

+Vous pouvez également l'utiliser pour récupérer uniquement les +fichiers accidentellement supprimés à l'intérieur d'un +répertoire en utilisant l'option -m, --filter-missing, +qui ne restaure que les fichiers manquants, laissant tous +les autres intacts. +

+
+
+snapraid fix -m -f DOSSIER/
+
+
+

+Ou pour récupérer tous les fichiers supprimés sur tous les +lecteurs avec : +

+
+
+snapraid fix -m
+
+
+

4.4 +Récupération +

+Le pire est arrivé, et vous avez perdu un ou plusieurs disques ! +

+NE PANIQUEZ PAS ! Vous pourrez les récupérer ! +

+La première chose à faire est d'éviter d'autres modifications +sur votre baie de disques. Désactivez toute connexion à distance +et tout processus planifié, y compris toute synchronisation ou +nettoyage SnapRAID nocturne planifié. +

+Procédez ensuite aux étapes suivantes. +

4.4.1 +ÉTAPE 1 -> Reconfigurer +

+Vous avez besoin d'espace pour récupérer, idéalement sur des disques +de rechange supplémentaires, mais un disque USB externe ou un disque +distant suffira. +

+Modifiez le fichier de configuration SnapRAID pour que l'option +`data` ou `parity` du disque défaillant pointe vers un emplacement +avec suffisamment d'espace vide pour récupérer les fichiers. +

+Par exemple, si le disque `d1` a échoué, passez de : +

+
+
+data d1 /mnt/disk1/
+
+
+

+à : +

+
+
+data d1 /mnt/new_spare_disk/
+
+
+

+Si le disque à récupérer est un disque de parité, mettez à jour +l'option `parity` appropriée. +Si vous avez plusieurs disques défaillants, mettez à jour toutes +leurs options de configuration. +

4.4.2 +ÉTAPE 2 -> Corriger (Fix) +

+Exécutez la commande fix, en stockant le journal dans un fichier +externe avec : +

+
+
+snapraid -d NOM -l fix.log fix
+
+
+

+Où NOM est le nom du disque, tel que `d1` dans notre exemple précédent. +Si le disque à récupérer est un disque de parité, utilisez les noms +`parity`, `2-parity`, etc. +Si vous avez plusieurs disques défaillants, utilisez plusieurs +options -d pour les spécifier tous. +

+Cette commande prendra beaucoup de temps. +

+Assurez-vous d'avoir quelques gigaoctets libres pour stocker le fichier fix.log. +Exécutez-la à partir d'un disque avec suffisamment d'espace libre. +

+Vous avez maintenant récupéré tout ce qui est récupérable. Si certains +fichiers sont partiellement ou totalement irrécupérables, ils seront +renommés en ajoutant l'extension `.unrecoverable`. +

+Vous pouvez trouver une liste détaillée de tous les blocs irrécupérables +dans le fichier fix.log en vérifiant toutes les lignes commençant par +`unrecoverable:`. +

+Si la récupération ne vous satisfait pas, vous pouvez réessayer autant +de fois que vous le souhaitez. +

+Par exemple, si vous avez supprimé des fichiers de la baie après le dernier +`sync`, cela peut entraîner la non-récupération de certains fichiers. +Dans ce cas, vous pouvez réessayer le `fix` en utilisant l'option +-i, --import, en spécifiant où se trouvent maintenant ces fichiers +pour les inclure à nouveau dans le processus de récupération. +

+Si vous êtes satisfait de la récupération, vous pouvez continuer, +mais notez qu'après la synchronisation, vous ne pouvez plus réessayer +la commande `fix` ! +

4.4.3 +ÉTAPE 3 -> Vérifier (Check) +

+Par précaution, vous pouvez maintenant exécuter une commande `check` +pour vous assurer que tout est correct sur le disque récupéré. +

+
+
+snapraid -d NOM -a check
+
+
+

+Où NOM est le nom du disque, tel que `d1` dans notre exemple précédent. +

+Les options -d et -a indiquent à SnapRAID de vérifier uniquement le +disque spécifié et d'ignorer toutes les données de parité. +

+Cette commande prendra beaucoup de temps, mais si vous n'êtes pas +trop prudent, vous pouvez la sauter. +

4.4.4 +ÉTAPE 4 -> Synchroniser (Sync) +

+Exécutez la commande `sync` pour resynchroniser la baie avec le nouveau +disque. +

+
+
+snapraid sync
+
+
+

+Si tout est récupéré, cette commande est immédiate. +

5 +Commandes +

+SnapRAID fournit quelques commandes simples qui vous permettent de : + +

+Les commandes doivent être écrites en minuscules. +

5.1 +status +

+Affiche un résumé de l'état de la baie de disques. +

+Il comprend des informations sur la fragmentation de la parité, l'âge +des blocs sans vérification, et toutes les erreurs silencieuses +enregistrées rencontrées lors du nettoyage. +

+Les informations présentées se réfèrent au dernier moment où vous avez +exécuté `sync`. Les modifications ultérieures ne sont pas prises en compte. +

+Si des mauvais blocs ont été détectés, leurs numéros de blocs sont listés. +Pour les corriger, vous pouvez utiliser la commande `fix -e`. +

+Il montre également un graphique représentant la dernière fois que chaque +bloc a été nettoyé ou synchronisé. Les blocs nettoyés sont affichés +avec '*', les blocs synchronisés mais pas encore nettoyés avec 'o'. +

+Rien n'est modifié. +

5.2 +smart +

+Affiche un rapport SMART de tous les disques du système. +

+Il comprend une estimation de la probabilité de défaillance au cours +de la prochaine année, vous permettant de planifier les remplacements +de maintenance des disques qui présentent des attributs suspects. +

+Cette estimation de probabilité est obtenue en corrélant les attributs +SMART des disques avec les données Backblaze disponibles à : +

+
+
+https://www.backblaze.com/hard-drive-test-data.html
+
+
+

+Si SMART signale qu'un disque est en panne, `FAIL` ou `PREFAIL` est +affiché pour ce disque, et SnapRAID retourne une erreur. +Dans ce cas, le remplacement immédiat du disque est fortement +recommandé. +

+Les autres chaînes d'état possibles sont : + + + + +
+logfail + +Dans le passé, certains attributs étaient inférieurs +au seuil. +
+logerr + +Le journal d'erreurs du périphérique contient des erreurs. +
+selferr + +Le journal d'auto-test du périphérique contient des erreurs. +
+

+Si l'option -v, --verbose est spécifiée, une analyse statistique +plus approfondie est fournie. Cette analyse peut vous aider à +décider si vous avez besoin de plus ou moins de parité. +

+Cette commande utilise l'outil `smartctl` et équivaut à exécuter +`smartctl -a` sur tous les périphériques. +

+Si vos périphériques ne sont pas détectés automatiquement correctement, +vous pouvez spécifier une commande personnalisée en utilisant l'option +`smartctl` dans le fichier de configuration. +

+Rien n'est modifié. +

5.3 +probe +

+Affiche l'état d'ALIMENTATION de tous les disques du système. +

+`Standby` signifie que le disque ne tourne pas. `Active` signifie +que le disque tourne. +

+Cette commande utilise l'outil `smartctl` et équivaut à exécuter +`smartctl -n standby -i` sur tous les périphériques. +

+Si vos périphériques ne sont pas détectés automatiquement correctement, +vous pouvez spécifier une commande personnalisée en utilisant l'option +`smartctl` dans le fichier de configuration. +

+Rien n'est modifié. +

5.4 +up +

+Fait tourner (spin up) tous les disques de la baie. +

+Vous pouvez faire tourner uniquement des disques spécifiques +en utilisant l'option -d, --filter-disk. +

+Faire tourner tous les disques en même temps nécessite beaucoup +d'énergie. Assurez-vous que votre alimentation peut le supporter. +

+Rien n'est modifié. +

5.5 +down +

+Arrête (spin down) tous les disques de la baie. +

+Cette commande utilise l'outil `smartctl` et équivaut à exécuter +`smartctl -s standby,now` sur tous les périphériques. +

+Vous pouvez arrêter uniquement des disques spécifiques +en utilisant l'option -d, --filter-disk. +

+Pour arrêter automatiquement en cas d'erreur, vous pouvez utiliser +l'option -s, --spin-down-on-error avec toute autre commande, +ce qui équivaut à exécuter `down` manuellement lorsqu'une +erreur se produit. +

+Rien n'est modifié. +

5.6 +diff +

+Liste tous les fichiers modifiés depuis le dernier `sync` qui +nécessitent la recomputation de leurs données de parité. +

+Cette commande ne vérifie pas les données des fichiers, +mais uniquement l'horodatage, la taille et l'inode du fichier. +

+Après avoir listé tous les fichiers modifiés, un résumé des +modifications est présenté, regroupé par : + + + + + + + + +
+equal + +Fichiers inchangés par rapport à avant. +
+added + +Fichiers ajoutés qui n'étaient pas présents auparavant. +
+removed + +Fichiers supprimés. +
+updated + +Fichiers avec une taille ou un horodatage différent, +signifiant qu'ils ont été modifiés. +
+moved + +Fichiers déplacés vers un répertoire différent sur le +même disque. Ils sont identifiés par le même nom, la +même taille, le même horodatage et le même inode, mais +un répertoire différent. +
+copied + +Fichiers copiés sur le même disque ou un disque différent. +Notez que s'ils sont vraiment déplacés vers un autre +disque, ils seront également comptés dans `removed`. +Ils sont identifiés par le même nom, la même taille +et le même horodatage. Si l'horodatage en sous-seconde +est zéro, le chemin complet doit correspondre, pas seulement +le nom. +
+restored + +Fichiers avec un inode différent mais correspondant +au nom, à la taille et à l'horodatage. Il s'agit +généralement de fichiers restaurés après avoir été supprimés. +
+

+Si un `sync` est requis, le code de retour du processus est 2, +au lieu du 0 par défaut. Le code de retour 1 est utilisé pour +une condition d'erreur générique. +

+Rien n'est modifié. +

5.7 +sync +

+Met à jour les informations de parité. Tous les fichiers modifiés +dans la baie de disques sont lus, et les données de parité +correspondantes sont mises à jour. +

+Vous pouvez arrêter ce processus à tout moment en appuyant sur Ctrl+C, +sans perdre le travail déjà effectué. +Lors de la prochaine exécution, le processus `sync` reprendra +là où il a été interrompu. +

+Si des erreurs silencieuses ou d'entrée/sortie sont trouvées +pendant le processus, les blocs correspondants sont marqués comme mauvais. +

+Les fichiers sont identifiés par chemin et/ou inode et vérifiés +par taille et horodatage. +Si la taille ou l'horodatage du fichier diffère, les données de +parité sont recomptées pour l'ensemble du fichier. +Si le fichier est déplacé ou renommé sur le même disque, en gardant +le même inode, la parité n'est pas recomptée. +Si le fichier est déplacé vers un autre disque, la parité est +recomptée, mais les informations de hachage précédemment calculées +sont conservées. +

+Les fichiers `content` et `parity` sont modifiés si nécessaire. +Les fichiers dans la baie NE SONT PAS modifiés. +

5.8 +scrub +

+Nettoie la baie, vérifiant les erreurs silencieuses ou d'entrée/sortie +dans les disques de données et de parité. +

+Chaque invocation vérifie environ 8 % de la baie, en excluant +les données déjà nettoyées au cours des 10 derniers jours. +Cela signifie qu'un nettoyage une fois par semaine garantit que +chaque bit de données est vérifié au moins une fois tous les trois mois. +

+Vous pouvez définir un plan de nettoyage ou une quantité différente +en utilisant l'option -p, --plan, qui accepte : +bad - Nettoyer les blocs marqués mauvais. +new - Nettoyer les blocs juste synchronisés qui n'ont pas encore été nettoyés. +full - Nettoyer tout. +0-100 - Nettoyer le pourcentage spécifié de blocs. +

+Si vous spécifiez un pourcentage, vous pouvez également utiliser +l'option -o, --older-than pour définir l'âge que le bloc +doit avoir. +Les blocs les plus anciens sont nettoyés en premier, assurant +une vérification optimale. +Si vous souhaitez nettoyer uniquement les blocs juste synchronisés +qui n'ont pas encore été nettoyés, utilisez l'option `-p new`. +

+Pour obtenir des détails sur l'état du nettoyage, utilisez la commande +`status`. +

+Pour toute erreur silencieuse ou d'entrée/sortie trouvée, les blocs +correspondants sont marqués comme mauvais dans le fichier `content`. +Ces mauvais blocs sont listés dans `status` et peuvent être corrigés +avec `fix -e`. +Après la correction, lors du prochain nettoyage, ils seront revérifiés, +et s'ils sont jugés corrigés, la marque "mauvais" sera supprimée. +Pour nettoyer uniquement les mauvais blocs, vous pouvez utiliser la +commande `scrub -p bad`. +

+Il est recommandé d'exécuter `scrub` uniquement sur une baie +synchronisée pour éviter les erreurs signalées causées par des données +non synchronisées. Ces erreurs sont reconnues comme n'étant pas +des erreurs silencieuses, et les blocs ne sont pas marqués comme mauvais, +mais de telles erreurs sont signalées dans la sortie de la commande. +

+Le fichier `content` est modifié pour mettre à jour l'heure de la dernière +vérification de chaque bloc et pour marquer les mauvais blocs. +Les fichiers `parity` NE SONT PAS modifiés. +Les fichiers dans la baie NE SONT PAS modifiés. +

5.9 +fix +

+Corrige tous les fichiers et les données de parité. +

+Tous les fichiers et les données de parité sont comparés à l'état +de l'instantané enregistré lors du dernier `sync`. +Si une différence est trouvée, elle est rétablie à l'instantané stocké. +

+AVERTISSEMENT ! La commande `fix` ne fait pas de distinction entre +les erreurs et les modifications intentionnelles. Elle rétablit +inconditionnellement l'état du fichier au dernier `sync`. +

+Si aucune autre option n'est spécifiée, l'intégralité de la baie est traitée. +Utilisez les options de filtre pour sélectionner un sous-ensemble de +fichiers ou de disques sur lesquels opérer. +

+Pour corriger uniquement les blocs marqués mauvais pendant `sync` et `scrub`, +utilisez l'option -e, --filter-error. +Contrairement aux autres options de filtre, celle-ci applique des corrections +uniquement aux fichiers qui sont inchangés depuis le dernier `sync`. +

+SnapRAID renomme tous les fichiers qui ne peuvent pas être corrigés +en ajoutant l'extension `.unrecoverable`. +

+Avant de corriger, l'intégralité de la baie est scannée pour trouver +tout fichier déplacé depuis la dernière opération `sync`. +Ces fichiers sont identifiés par leur horodatage, ignorant leur nom +et leur répertoire, et sont utilisés dans le processus de récupération +si nécessaire. +Si vous en avez déplacé certains en dehors de la baie, vous pouvez +utiliser l'option -i, --import pour spécifier des répertoires +supplémentaires à scanner. +

+Les fichiers sont identifiés uniquement par chemin, pas par inode. +

+Le fichier `content` N'EST PAS modifié. +Les fichiers `parity` sont modifiés si nécessaire. +Les fichiers dans la baie sont modifiés si nécessaire. +

5.10 +check +

+Vérifie tous les fichiers et les données de parité. +

+Il fonctionne comme `fix`, mais il simule seulement une récupération +et aucune modification n'est écrite sur la baie. +

+Cette commande est principalement destinée à la vérification manuelle, +comme après un processus de récupération ou dans d'autres conditions +spéciales. Pour les vérifications périodiques et planifiées, utilisez +`scrub`. +

+Si vous utilisez l'option -a, --audit-only, seules les données +des fichiers sont vérifiées, et les données de parité sont ignorées +pour une exécution plus rapide. +

+Les fichiers sont identifiés uniquement par chemin, pas par inode. +

+Rien n'est modifié. +

5.11 +list +

+Liste tous les fichiers contenus dans la baie au moment du dernier +`sync`. +

+Avec -v ou --verbose, l'heure en sous-seconde est également affichée. +

+Rien n'est modifié. +

5.12 +dup +

+Liste tous les fichiers en double. Deux fichiers sont considérés +comme égaux si leurs hachages correspondent. Les données des fichiers +ne sont pas lues ; seuls les hachages précalculés sont utilisés. +

+Rien n'est modifié. +

5.13 +pool +

+Crée ou met à jour une vue virtuelle de tous +les fichiers de votre baie de disques dans le répertoire `pooling`. +

+Les fichiers ne sont pas copiés mais liés à l'aide de +liens symboliques. +

+Lors de la mise à jour, tous les liens symboliques et les +sous-répertoires vides existants sont supprimés et remplacés par +la nouvelle vue de la baie. Tout autre fichier ordinaire est laissé +en place. +

+Rien n'est modifié en dehors du répertoire du pool. +

5.14 +devices +

+Affiche les périphériques de bas niveau utilisés par la baie. +

+Cette commande affiche les associations de périphériques dans la baie +et est principalement destinée à être une interface de script. +

+Les deux premières colonnes sont l'ID et le chemin du périphérique +de bas niveau. Les deux colonnes suivantes sont l'ID et le chemin +du périphérique de haut niveau. La dernière colonne est le nom du +disque dans la baie. +

+Dans la plupart des cas, vous avez un périphérique de bas niveau +pour chaque disque de la baie, mais dans certaines configurations +plus complexes, vous pouvez avoir plusieurs périphériques de bas +niveau utilisés par un seul disque de la baie. +

+Rien n'est modifié. +

5.15 +touch +

+Définit un horodatage arbitraire en sous-seconde pour tous les fichiers +qui l'ont défini à zéro. +

+Cela améliore la capacité de SnapRAID à reconnaître les fichiers +déplacés et copiés, car cela rend l'horodatage presque unique, +réduisant les doublons possibles. +

+Plus précisément, si l'horodatage en sous-seconde n'est pas zéro, +un fichier déplacé ou copié est identifié comme tel s'il correspond +au nom, à la taille et à l'horodatage. Si l'horodatage en sous-seconde +est zéro, il est considéré comme une copie uniquement si le chemin +complet, la taille et l'horodatage correspondent tous. +

+L'horodatage à la seconde près n'est pas modifié, +de sorte que toutes les dates et heures de vos fichiers seront +préservées. +

5.16 +rehash +

+Planifie un nouveau hachage de toute la baie. +

+Cette commande change le type de hachage utilisé, généralement lors +de la mise à niveau d'un système 32 bits vers un système 64 bits, +pour passer de MurmurHash3 au plus rapide SpookyHash. +

+Si vous utilisez déjà le hachage optimal, cette commande +ne fait rien et vous informe qu'aucune action n'est nécessaire. +

+Le nouveau hachage n'est pas effectué immédiatement, mais a lieu +progressivement pendant `sync` et `scrub`. +

+Vous pouvez vérifier l'état du nouveau hachage en utilisant `status`. +

+Pendant le nouveau hachage, SnapRAID conserve toutes ses +fonctionnalités, à la seule exception que `dup` ne peut pas +détecter les fichiers en double utilisant un hachage différent. +

6 +Options +

+SnapRAID fournit les options suivantes : + + +
+-c, --conf CONFIG +
+Sélectionne le fichier de configuration à utiliser. S'il n'est pas +spécifié, sous Unix, il utilise le fichier `/usr/local/etc/snapraid.conf` +s'il existe, sinon `/etc/snapraid.conf`. +Sous Windows, il utilise le fichier `snapraid.conf` dans le même +répertoire que `snapraid.exe`. +
+ + +
+-f, --filter MOTIF +
+Filtre les fichiers à traiter dans `check` et `fix`. +Seuls les fichiers correspondant au motif spécifié sont traités. +Cette option peut être utilisée plusieurs fois. +Voir la section MOTIF pour plus de détails sur les +spécifications de motifs. +Sous Unix, assurez-vous que les caractères de globbing sont +entre guillemets s'ils sont utilisés. +Cette option ne peut être utilisée qu'avec `check` et `fix`. +Elle ne peut pas être utilisée avec `sync` et `scrub`, car ils +traitent toujours l'intégralité de la baie. +
+ + +
+-d, --filter-disk NOM +
+Filtre les disques à traiter dans `check`, `fix`, `up` et `down`. +Vous devez spécifier un nom de disque tel que défini dans le fichier +de configuration. +Vous pouvez également spécifier des disques de parité avec les noms : +`parity`, `2-parity`, `3-parity`, etc., pour limiter les opérations +à un disque de parité spécifique. +Si vous combinez plusieurs options --filter, --filter-disk et +--filter-missing, seuls les fichiers correspondant à tous les filtres +sont sélectionnés. +Cette option peut être utilisée plusieurs fois. +Cette option ne peut être utilisée qu'avec `check`, `fix`, `up` +et `down`. +Elle ne peut pas être utilisée avec `sync` et `scrub`, car ils +traitent toujours l'intégralité de la baie. +
+ + +
+-m, --filter-missing +
+Filtre les fichiers à traiter dans `check` et `fix`. +Seuls les fichiers manquants ou supprimés de la baie sont traités. +Lorsqu'elle est utilisée avec `fix`, cela agit comme une commande +`undelete` (restaurer). +Si vous combinez plusieurs options --filter, --filter-disk et +--filter-missing, seuls les fichiers correspondant à tous les filtres +sont sélectionnés. +Cette option ne peut être utilisée qu'avec `check` et `fix`. +Elle ne peut pas être utilisée avec `sync` et `scrub`, car ils +traitent toujours l'intégralité de la baie. +
+ + +
+-e, --filter-error +
+Traite les fichiers avec des erreurs dans `check` et `fix`. +Il ne traite que les fichiers qui ont des blocs marqués avec des erreurs +silencieuses ou d'entrée/sortie pendant `sync` et `scrub`, tels +que listés dans `status`. +Cette option ne peut être utilisée qu'avec `check` et `fix`. +
+ + +
+-p, --plan PERC|bad|new|full +
+Sélectionne le plan de nettoyage. Si PERC est une valeur numérique +de 0 à 100, elle est interprétée comme le pourcentage de blocs à +nettoyer. +Au lieu d'un pourcentage, vous pouvez spécifier un plan : +`bad` nettoie les mauvais blocs, `new` nettoie les blocs +qui n'ont pas encore été nettoyés, et `full` nettoie tout. +Cette option ne peut être utilisée qu'avec `scrub`. +
+ + +
+-o, --older-than JOURS +
+Sélectionne la partie la plus ancienne de la baie à traiter dans `scrub`. +JOURS est l'âge minimum en jours pour qu'un bloc soit nettoyé ; +la valeur par défaut est 10. +Les blocs marqués comme mauvais sont toujours nettoyés, +quelle que soit cette option. +Cette option ne peut être utilisée qu'avec `scrub`. +
+ + +
+-a, --audit-only +
+Dans `check`, vérifie le hachage des fichiers sans +vérifier les données de parité. +Si vous êtes intéressé uniquement par la vérification des données +des fichiers, cette option peut accélérer considérablement le +processus de vérification. +Cette option ne peut être utilisée qu'avec `check`. +
+ + +
+-h, --pre-hash +
+Dans `sync`, exécute une phase de hachage préliminaire de toutes +les nouvelles données pour une vérification supplémentaire avant +le calcul de la parité. +Habituellement, dans `sync`, aucun hachage préliminaire n'est +effectué, et les nouvelles données sont hachées juste avant +le calcul de la parité lorsqu'elles sont lues pour la première fois. +Ce processus se produit lorsque le système est soumis à +une lourde charge, avec tous les disques en rotation et un +processeur occupé. +Il s'agit d'une condition extrême pour la machine, et si elle +présente un problème matériel latent, des erreurs silencieuses +peuvent passer inaperçues car les données ne sont pas encore +hachées. +Pour éviter ce risque, vous pouvez activer le mode `pre-hash` +pour que toutes les données soient lues deux fois afin de +garantir leur intégrité. +Cette option vérifie également les fichiers déplacés au sein +de la baie pour s'assurer que l'opération de déplacement a +réussi et, si nécessaire, vous permet d'exécuter une +opération fix avant de continuer. +Cette option ne peut être utilisée qu'avec `sync`. +
+ + +
+-i, --import DOSSIER +
+Importe à partir du répertoire spécifié tous les fichiers supprimés +de la baie après le dernier `sync`. +Si vous avez toujours de tels fichiers, ils peuvent être utilisés +par `check` et `fix` pour améliorer le processus de récupération. +Les fichiers sont lus, y compris dans les sous-répertoires, et sont +identifiés quel que soit leur nom. +Cette option ne peut être utilisée qu'avec `check` et `fix`. +
+ + +
+-s, --spin-down-on-error +
+En cas d'erreur, arrête (spin down) tous les disques gérés avant +de quitter avec un code d'état non nul. Cela empêche les +lecteurs de rester actifs et en rotation après une opération +interrompue, aidant à éviter une accumulation inutile de chaleur +et une consommation d'énergie. Utilisez cette option pour vous +assurer que les disques sont arrêtés en toute sécurité +même lorsqu'une commande échoue. +
+ + +
+-w, --bw-limit DÉBIT +
+Applique une limite de bande passante globale pour tous les disques. +Le DÉBIT est le nombre d'octets par seconde. Vous pouvez spécifier +un multiplicateur tel que K, M ou G (par exemple, --bw-limit 1G). +
+ + +
+-A, --stats +
+Active une vue d'état étendue qui affiche des informations +supplémentaires. +L'écran affiche deux graphiques : +Le premier graphique montre le nombre de bandes mises en mémoire +tampon pour chaque disque, ainsi que le chemin d'accès au fichier +en cours d'accès sur ce disque. Généralement, le disque le plus +lent n'aura pas de tampon disponible, ce qui détermine la +bande passante maximale réalisable. +Le deuxième graphique montre le pourcentage de temps passé en attente +au cours des 100 dernières secondes. Le disque le plus lent est +censé causer la majeure partie du temps d'attente, tandis que les +autres disques devraient avoir peu ou pas de temps d'attente car +ils peuvent utiliser leurs bandes mises en mémoire tampon. +Ce graphique montre également le temps passé en attente pour les +calculs de hachage et les calculs RAID. +Tous les calculs s'exécutent en parallèle avec les opérations de disque. +Par conséquent, tant qu'il y a un temps d'attente mesurable pour +au moins un disque, cela indique que le processeur est suffisamment +rapide pour suivre la charge de travail. +
+ + +
+-Z, --force-zero +
+Force l'opération non sécurisée de synchronisation d'un fichier +de taille zéro qui était auparavant non nul. +Si SnapRAID détecte une telle condition, il arrête de +procéder à moins que vous ne spécifiiez cette option. +Cela vous permet de détecter facilement quand, après un +plantage du système, certains fichiers accédés ont été tronqués. +C'est une condition possible sous Linux avec les systèmes +de fichiers ext3/ext4. +Cette option ne peut être utilisée qu'avec `sync`. +
+ + +
+-E, --force-empty +
+Force l'opération non sécurisée de synchronisation d'un disque +avec tous les fichiers originaux manquants. +Si SnapRAID détecte que tous les fichiers initialement présents +sur le disque sont manquants ou réécrits, il arrête de +procéder à moins que vous ne spécifiiez cette option. +Cela vous permet de détecter facilement lorsqu'un système de +fichiers de données n'est pas monté. +Cette option ne peut être utilisée qu'avec `sync`. +
+ + +
+-U, --force-uuid +
+Force l'opération non sécurisée de synchronisation, vérification +et correction avec des disques qui ont changé leur UUID. +Si SnapRAID détecte que certains disques ont changé d'UUID, +il arrête de procéder à moins que vous ne spécifiiez cette option. +Cela vous permet de détecter lorsque vos disques sont montés +aux mauvais points de montage. +Il est cependant autorisé d'avoir un seul changement d'UUID +avec une seule parité, et plus avec une parité multiple, +car c'est le cas normal lors du remplacement des disques après +une récupération. +Cette option ne peut être utilisée qu'avec `sync`, `check` ou +`fix`. +
+ + +
+-D, --force-device +
+Force l'opération non sécurisée de correction avec des disques +inaccessibles ou avec des disques sur le même périphérique physique. +Par exemple, si vous avez perdu deux disques de données et que +vous avez un disque de rechange pour ne récupérer que le premier, +vous pouvez ignorer le deuxième disque inaccessible. +Ou, si vous souhaitez récupérer un disque dans l'espace libre +restant sur un disque déjà utilisé, partageant le même +périphérique physique. +Cette option ne peut être utilisée qu'avec `fix`. +
+ + +
+-N, --force-nocopy +
+Dans `sync`, `check` et `fix`, désactive l'heuristique de détection +de copie. +Sans cette option, SnapRAID suppose que les fichiers ayant les mêmes +attributs, tels que le nom, la taille et l'horodatage, sont des copies +avec les mêmes données. +Cela permet d'identifier les fichiers copiés ou déplacés d'un disque +à un autre et réutilise les informations de hachage déjà calculées +pour détecter les erreurs silencieuses ou pour récupérer les fichiers +manquants. +Dans de rares cas, ce comportement peut entraîner des faux positifs +ou un processus lent en raison de nombreuses vérifications de hachage, +et cette option vous permet de résoudre de tels problèmes. +Cette option ne peut être utilisée qu'avec `sync`, `check` et `fix`. +
+ + +
+-F, --force-full +
+Dans `sync`, force un recomptage complet de la parité. +Cette option peut être utilisée lorsque vous ajoutez un nouveau +niveau de parité ou si vous êtes revenu à un ancien fichier +de contenu utilisant des données de parité plus récentes. +Au lieu de recréer la parité à partir de zéro, cela vous permet +de réutiliser les hachages présents dans le fichier de contenu +pour valider les données et maintenir la protection des données +pendant le processus `sync` en utilisant les données de parité +existantes. +Cette option ne peut être utilisée qu'avec `sync`. +
+ + +
+-R, --force-realloc +
+Dans `sync`, force une réallocation complète des fichiers et +une reconstruction de la parité. +Cette option peut être utilisée pour réallouer complètement +tous les fichiers, en supprimant la fragmentation, tout en +réutilisant les hachages présents dans le fichier de contenu +pour valider les données. +Cette option ne peut être utilisée qu'avec `sync`. +AVERTISSEMENT ! Cette option est réservée aux experts, et il est +fortement recommandé de ne pas l'utiliser. +Vous N'AVEZ AUCUNE protection des données pendant l'opération `sync`. +
+ + +
+-l, --log FICHIER +
+Écrit un journal détaillé dans le fichier spécifié. +Si cette option n'est pas spécifiée, les erreurs inattendues +sont imprimées à l'écran, ce qui peut entraîner une sortie +excessive en cas de nombreuses erreurs. Lorsque -l, --log est +spécifié, seules les erreurs fatales qui entraînent l'arrêt +de SnapRAID sont imprimées à l'écran. +Si le chemin commence par '>>', le fichier est ouvert +en mode ajout. Les occurrences de '%D' et '%T' dans le nom sont +remplacées par la date et l'heure au format YYYYMMDD et +HHMMSS. Dans les fichiers batch Windows, vous devez doubler +le caractère '%', par exemple, result-%%D.log. Pour utiliser +'>>', vous devez encadrer le nom de guillemets, par exemple, +`">>result.log"`. +Pour sortir le journal sur la sortie standard ou l'erreur +standard, vous pouvez utiliser `">&1"` et `">&2"`, +respectivement. +Consultez le fichier ou la page de manuel snapraid_log.txt +pour les descriptions des balises de journal. +
+ + +
+-L, --error-limit NOMBRE +
+Définit une nouvelle limite d'erreurs avant d'arrêter l'exécution. +Par défaut, SnapRAID s'arrête s'il rencontre plus de 100 +erreurs d'entrée/sortie, indiquant qu'un disque est +probablement en panne. +Cette option affecte `sync` et `scrub`, qui sont autorisés +à continuer après le premier ensemble d'erreurs de disque +pour essayer de terminer leurs opérations. +Cependant, `check` et `fix` s'arrêtent toujours à la première erreur. +
+ + +
+-S, --start BLKSTART +
+Commence le traitement à partir du numéro de bloc spécifié. +Cela peut être utile pour réessayer de vérifier ou de corriger +des blocs spécifiques en cas de disque endommagé. +Cette option est principalement destinée à la récupération manuelle avancée. +
+ + +
+-B, --count BLKCOUNT +
+Ne traite que le nombre de blocs spécifié. +Cette option est principalement destinée à la récupération manuelle avancée. +
+ + +
+-C, --gen-conf CONTENU +
+Génère un fichier de configuration factice à partir d'un +fichier de contenu existant. +Le fichier de configuration est écrit sur la sortie standard +et n'écrase pas un fichier existant. +Ce fichier de configuration contient également les informations +nécessaires pour reconstruire les points de montage du disque au +cas où vous perdriez l'intégralité du système. +
+ + +
+-v, --verbose +
+Affiche plus d'informations à l'écran. +S'il est spécifié une fois, il affiche les fichiers exclus +et des statistiques supplémentaires. +Cette option n'a aucun effet sur les fichiers journaux. +
+ + +
+-q, --quiet +
+Affiche moins d'informations à l'écran. +S'il est spécifié une fois, il supprime la barre de progression ; +deux fois, les opérations en cours ; trois fois, les messages +d'information ; quatre fois, les messages d'état. +Les erreurs fatales sont toujours imprimées à l'écran. +Cette option n'a aucun effet sur les fichiers journaux. +
+ + +
+-H, --help +
+Affiche un écran d'aide court. +
+ + +
+-V, --version +
+Affiche la version du programme. +
+

7 +Configuration +

+SnapRAID nécessite un fichier de configuration pour savoir où se trouve +votre baie de disques et où stocker les informations de parité. +

+Sous Unix, il utilise le fichier `/usr/local/etc/snapraid.conf` s'il existe, +sinon `/etc/snapraid.conf`. +Sous Windows, il utilise le fichier `snapraid.conf` dans le même +répertoire que `snapraid.exe`. +

+Il doit contenir les options suivantes (sensibles à la casse) : +

7.1 +parity FICHIER [,FICHIER] ... +

+Définit les fichiers à utiliser pour stocker les informations de parité. +La parité permet une protection contre une seule défaillance +de disque, similaire au RAID5. +

+Vous pouvez spécifier plusieurs fichiers, qui doivent se trouver +sur des disques différents. +Lorsqu'un fichier ne peut plus grandir, le suivant est utilisé. +L'espace total disponible doit être au moins aussi grand que le +plus grand disque de données de la baie. +

+Vous pouvez ajouter des fichiers de parité supplémentaires plus tard, +mais vous ne pouvez pas les réorganiser ni les supprimer. +

+Garder les disques de parité réservés à la parité garantit qu'ils +ne deviennent pas fragmentés, améliorant les performances. +

+Sous Windows, 256 Mo sont laissés inutilisés sur chaque disque pour +éviter l'avertissement concernant les disques pleins. +

+Cette option est obligatoire et ne peut être utilisée qu'une seule fois. +

7.2 +(2,3,4,5,6)-parity FICHIER [,FICHIER] ... +

+Définit les fichiers à utiliser pour stocker les informations de parité +supplémentaires. +

+Pour chaque niveau de parité spécifié, un niveau de protection +supplémentaire est activé : +

+

+Chaque niveau de parité nécessite la présence de tous les niveaux +de parité précédents. +

+Les mêmes considérations que pour l'option 'parity' s'appliquent. +

+Ces options sont facultatives et ne peuvent être utilisées qu'une seule fois. +

7.3 +z-parity FICHIER [,FICHIER] ... +

+Définit un fichier et un format alternatifs pour stocker la triple parité. +

+Cette option est une alternative à '3-parity', principalement destinée +aux processeurs bas de gamme comme ARM ou AMD Phenom, Athlon et Opteron +qui ne prennent pas en charge l'ensemble d'instructions SSSE3. Dans de +tels cas, elle offre de meilleures performances. +

+Ce format est similaire mais plus rapide que celui utilisé par ZFS RAIDZ3. +Comme ZFS, il ne fonctionne pas au-delà de la triple parité. +

+Lors de l'utilisation de '3-parity', vous serez averti s'il est +recommandé d'utiliser le format 'z-parity' pour une amélioration des +performances. +

+Il est possible de convertir d'un format à l'autre en ajustant +le fichier de configuration avec le fichier z-parity ou 3-parity souhaité +et en utilisant 'fix' pour le recréer. +

7.4 +content FICHIER +

+Définit le fichier à utiliser pour stocker la liste et les sommes de +contrôle de tous les fichiers présents dans votre baie de disques. +

+Il peut être placé sur un disque utilisé pour les données, la parité, +ou tout autre disque disponible. +Si vous utilisez un disque de données, ce fichier est automatiquement +exclu du processus `sync`. +

+Cette option est obligatoire et peut être utilisée plusieurs fois pour +enregistrer plusieurs copies du même fichier. +

+Vous devez stocker au moins une copie pour chaque disque de parité +utilisé plus un. L'utilisation de copies supplémentaires ne nuit pas. +

7.5 +data NOM DOSSIER +

+Définit le nom et le point de montage des disques de données dans +la baie. NOM est utilisé pour identifier le disque et doit +être unique. DOSSIER est le point de montage du disque dans le +système de fichiers. +

+Vous pouvez modifier le point de montage au besoin, tant que +vous gardez le NOM fixe. +

+Vous devriez utiliser une option pour chaque disque de données +de la baie. +

+Vous pouvez renommer un disque plus tard en changeant le NOM directement +dans le fichier de configuration, puis en exécutant une commande 'sync'. +Dans le cas d'un renommage, l'association est faite en utilisant l'UUID +stocké des disques. +

7.6 +nohidden +

+Exclut tous les fichiers et répertoires cachés. +Sous Unix, les fichiers cachés sont ceux commençant par `.`. +Sous Windows, ce sont ceux avec l'attribut caché. +

7.7 +exclude/include MOTIF +

+Définit les motifs de fichiers ou de répertoires à exclure ou à inclure +dans le processus de synchronisation. +Tous les motifs sont traités dans l'ordre spécifié. +

+Si le premier motif qui correspond est un `exclude` (exclure), le fichier +est exclu. S'il s'agit d'un `include` (inclure), le fichier est inclus. +Si aucun motif ne correspond, le fichier est exclu si le dernier motif +spécifié est un `include`, ou inclus si le dernier motif +spécifié est un `exclude`. +

+Voir la section MOTIF pour plus de détails sur les +spécifications de motifs. +

+Cette option peut être utilisée plusieurs fois. +

7.8 +blocksize TAILLE_EN_KIBIOCTETS +

+Définit la taille de bloc de base en kibioctets pour la parité. +Un kibioctet est de 1024 octets. +

+La taille de bloc par défaut est de 256, ce qui devrait fonctionner +dans la plupart des cas. +

+AVERTISSEMENT ! Cette option est réservée aux experts, et il est +fortement recommandé de ne pas modifier cette valeur. Pour modifier +cette valeur à l'avenir, vous devrez recréer l'intégralité de la parité ! +

+Une raison d'utiliser une taille de bloc différente est si vous avez +beaucoup de petits fichiers, de l'ordre de millions. +

+Pour chaque fichier, même s'il ne contient que quelques octets, un bloc +entier de parité est alloué, et avec de nombreux fichiers, cela peut +entraîner un espace de parité inutilisé important. +Lorsque vous remplissez complètement le disque de parité, vous n'êtes +pas autorisé à ajouter plus de fichiers aux disques de données. +Cependant, la parité gaspillée ne s'accumule pas sur les disques de +données. L'espace gaspillé résultant d'un grand nombre de fichiers +sur un disque de données limite uniquement la quantité de données +sur ce disque de données, pas les autres. +

+À titre d'approximation, vous pouvez supposer que la moitié de la +taille de bloc est gaspillée pour chaque fichier. Par exemple, avec +100 000 fichiers et une taille de bloc de 256 Kio, vous gaspillerez +12,8 Go de parité, ce qui peut entraîner 12,8 Go d'espace en moins +disponible sur le disque de données. +

+Vous pouvez vérifier la quantité d'espace gaspillé sur chaque disque +en utilisant `status`. +C'est la quantité d'espace que vous devez laisser libre sur les disques +de données ou utiliser pour les fichiers non inclus dans la baie. +Si cette valeur est négative, cela signifie que vous êtes près de +remplir la parité, et cela représente l'espace que vous pouvez encore +gaspiller. +

+Pour éviter ce problème, vous pouvez utiliser une partition plus grande +pour la parité. Par exemple, si la partition de parité est 12,8 Go plus +grande que les disques de données, vous avez suffisamment d'espace +supplémentaire pour gérer jusqu'à 100 000 fichiers sur chaque disque +de données sans aucun espace gaspillé. +

+Une astuce pour obtenir une partition de parité plus grande sous Linux +est de la formater avec la commande : +

+
+
+mkfs.ext4 -m 0 -T largefile4 DEVICE
+
+
+

+Cela se traduit par environ 1,5 % d'espace supplémentaire, environ 60 Go +pour un disque de 4 To, ce qui permet environ 460 000 fichiers sur +chaque disque de données sans aucun espace gaspillé. +

7.9 +hashsize TAILLE_EN_OCTETS +

+Définit la taille du hachage en octets pour les blocs enregistrés. +

+La taille de hachage par défaut est de 16 octets (128 bits), +ce qui devrait fonctionner dans la plupart des cas. +

+AVERTISSEMENT ! Cette option est réservée aux experts, et il est +fortement recommandé de ne pas modifier cette valeur. Pour modifier +cette valeur à l'avenir, vous devrez recréer l'intégralité de la parité ! +

+Une raison d'utiliser une taille de hachage différente est si votre +système a une mémoire limitée. En règle générale, SnapRAID nécessite +généralement 1 Gio de RAM pour chaque 16 To de données dans la baie. +

+Plus précisément, pour stocker les hachages des données, SnapRAID +nécessite environ TS*(1+HS)/BS octets de RAM, +où TS est la taille totale en octets de votre baie de disques, BS est la +taille de bloc en octets, et HS est la taille de hachage en octets. +

+Par exemple, avec 8 disques de 4 To, une taille de bloc de 256 Kio +(1 Kio = 1024 octets) et une taille de hachage de 16, vous obtenez : +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1,93 Gio
+
+

+En passant à une taille de hachage de 8, vous obtenez : +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1,02 Gio
+
+

+En passant à une taille de bloc de 512, vous obtenez : +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0,96 Gio
+
+

+En passant à la fois à une taille de hachage de 8 et à une taille de +bloc de 512, vous obtenez : +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 Gio
+
+

7.10 +autosave TAILLE_EN_GIGAOCTETS +

+Enregistre automatiquement l'état lors de la synchronisation ou du +nettoyage après la quantité spécifiée de Go traités. +Cette option est utile pour éviter de redémarrer de longues commandes +`sync` à partir de zéro si elles sont interrompues par un plantage +de la machine ou tout autre événement. +

7.11 +temp_limit TEMPÉRATURE_CELSIUS +

+Définit la température maximale autorisée du disque en Celsius. +Lorsqu'elle est spécifiée, SnapRAID vérifie périodiquement la +température de tous les disques à l'aide de l'outil smartctl. +Les températures actuelles des disques sont affichées pendant que +SnapRAID fonctionne. Si un disque dépasse cette limite, toutes les +opérations s'arrêtent et les disques sont arrêtés (mis en veille) +pendant la durée définie par l'option `temp_sleep`. Après la période +de veille, les opérations reprennent, pouvant s'arrêter à nouveau si +la limite de température est de nouveau atteinte. +

+Pendant le fonctionnement, SnapRAID analyse également la courbe de +chauffe de chaque disque et estime la température stable à long terme +qu'ils sont censés atteindre si l'activité continue. L'estimation +n'est effectuée qu'après que la température du disque a augmenté +quatre fois, garantissant que suffisamment de points de données sont +disponibles pour établir une tendance fiable. +Cette température stable prédite est affichée entre parenthèses à +côté de la valeur actuelle et aide à évaluer si le refroidissement +du système est adéquat. Cette température estimée est uniquement à +titre informatif et n'a aucun effet sur le comportement de SnapRAID. +Les actions du programme sont basées uniquement sur les températures +réelles mesurées des disques. +

+Pour effectuer cette analyse, SnapRAID a besoin d'une référence pour +la température du système. Il tente d'abord de la lire à partir des +capteurs matériels disponibles. Si aucun capteur système n'est +accessible, il utilise la température de disque la plus basse mesurée +au début de l'exécution comme référence de secours. +

+Normalement, SnapRAID n'affiche que la température du disque le plus chaud. +Pour afficher la température de tous les disques, utilisez l'option +-A ou --stats. +

7.12 +temp_sleep TEMPS_EN_MINUTES +

+Définit le temps de veille, en minutes, lorsque la limite de température +est atteinte. Pendant cette période, les disques restent arrêtés. +La valeur par défaut est de 5 minutes. +

7.13 +pool DOSSIER +

+Définit le répertoire de mise en commun où la vue virtuelle de la +baie de disques est créée à l'aide de la commande `pool`. +

+Le répertoire doit déjà exister. +

7.14 +share CHEMIN_UNC +

+Définit le chemin UNC Windows requis pour accéder aux disques à distance. +

+Si cette option est spécifiée, les liens symboliques créés dans le +répertoire du pool utilisent ce chemin UNC pour accéder aux disques. +Sans cette option, les liens symboliques générés utilisent uniquement +des chemins locaux, ce qui ne permet pas de partager le répertoire +du pool sur le réseau. +

+Les liens symboliques sont formés en utilisant le chemin UNC spécifié, +en ajoutant le nom du disque tel que spécifié dans l'option `data`, +et en ajoutant enfin le répertoire et le nom du fichier. +

+Cette option est requise uniquement pour Windows. +

7.15 +smartctl DISQUE/PARITÉ OPTIONS... +

+Définit les options smartctl personnalisées pour obtenir les attributs +SMART de chaque disque. Cela peut être nécessaire pour les contrôleurs +RAID et certains disques USB qui ne peuvent pas être détectés +automatiquement. Le placeholder %s est remplacé par le nom du +périphérique, mais il est facultatif pour les périphériques fixes +comme les contrôleurs RAID. +

+DISQUE est le même nom de disque spécifié dans l'option `data`. +PARITÉ est l'un des noms de parité : `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` ou `z-parity`. +

+Dans les OPTIONS spécifiées, la chaîne `%s` est remplacée par le +nom du périphérique. Pour les contrôleurs RAID, le périphérique est +probablement fixe, et vous n'aurez peut-être pas besoin d'utiliser `%s`. +

+Consultez la documentation smartmontools pour les options possibles : +

+
+
+https://www.smartmontools.org/wiki/Supported_RAID-Controllers
+https://www.smartmontools.org/wiki/Supported_USB-Devices
+
+
+

+Par exemple : +

+
+
+smartctl parity -d sat %s
+
+
+

7.16 +smartignore DISQUE/PARITÉ ATTR [ATTR...] +

+Ignore l'attribut SMART spécifié lors du calcul de la probabilité +de défaillance du disque. Cette option est utile si un disque signale +des valeurs inhabituelles ou trompeuses pour un attribut particulier. +

+DISQUE est le même nom de disque spécifié dans l'option `data`. +PARITÉ est l'un des noms de parité : `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` ou `z-parity`. +La valeur spéciale * peut être utilisée pour ignorer l'attribut +sur tous les disques. +

+Par exemple, pour ignorer l'attribut `Current Pending Sector Count` +sur tous les disques : +

+
+
+smartignore * 197
+
+
+

+Pour l'ignorer uniquement sur le premier disque de parité : +

+
+
+smartignore parity 197
+
+
+

7.17 +Exemples +

+Un exemple de configuration typique pour Unix est : +

+
+
+parity /mnt/diskp/snapraid.parity
+content /mnt/diskp/snapraid.content
+content /var/snapraid/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+exclude /lost+found/
+exclude /tmp/
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/sg0
+smartctl 2-parity -d areca,2/1 /dev/sg0
+
+
+

+Un exemple de configuration typique pour Windows est : +

+
+
+parity E:\snapraid.parity
+content E:\snapraid.content
+content C:\snapraid\snapraid.content
+data d1 G:\array\
+data d2 H:\array\
+data d3 I:\array\
+exclude Thumbs.db
+exclude \$RECYCLE.BIN
+exclude \System Volume Information
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/arcmsr0
+smartctl 2-parity -d areca,2/1 /dev/arcmsr0
+
+
+

8 +Motif (Pattern) +

+Les motifs sont utilisés pour sélectionner un sous-ensemble de fichiers +à exclure ou à inclure dans le processus. +

+Il existe quatre types de motifs différents : + + +
+FICHIER +
+Sélectionne tout fichier nommé FICHIER. Vous pouvez utiliser +tous les caractères de globbing comme * et ?, et les classes de +caractères comme [a-z]. +Ce motif s'applique uniquement aux fichiers, pas aux répertoires. +
+ + +
+DOSSIER/ +
+Sélectionne tout répertoire nommé DOSSIER et tout ce qu'il +contient. Vous pouvez utiliser tous les caractères de globbing +comme * et ?. +Ce motif s'applique uniquement aux répertoires, pas aux fichiers. +
+ + +
+/CHEMIN/FICHIER +
+Sélectionne le chemin de fichier exact spécifié. Vous pouvez +utiliser tous les caractères de globbing comme * et ?, mais +ils ne correspondent jamais à une barre oblique de répertoire. +Ce motif s'applique uniquement aux fichiers, pas aux répertoires. +
+ + +
+/CHEMIN/DOSSIER/ +
+Sélectionne le chemin de répertoire exact spécifié et tout ce qu'il +contient. Vous pouvez utiliser tous les caractères de globbing +comme * et ?, mais ils ne correspondent jamais à une barre +oblique de répertoire. +Ce motif s'applique uniquement aux répertoires, pas aux fichiers. +
+

+Lorsque vous spécifiez un chemin absolu commençant par /, il est +appliqué à la racine de la baie, et non à la racine du système +de fichiers local. +

+Sous Windows, vous pouvez utiliser la barre oblique inverse \ au lieu +de la barre oblique /. +Les répertoires système Windows, les jonctions, les points de montage +et les autres répertoires spéciaux Windows sont traités comme des fichiers, +ce qui signifie que pour les exclure, vous devez utiliser une règle +de fichier, pas une règle de répertoire. +

+Si le nom de fichier contient un caractère '*', '?', '[', +ou ']', vous devez l'échapper pour éviter qu'il ne soit interprété +comme un caractère de globbing. Sous Unix, le caractère d'échappement +est '\' ; sous Windows, c'est '^'. +Lorsque le motif est sur la ligne de commande, vous devez doubler +le caractère d'échappement pour éviter qu'il ne soit interprété +par le shell de commande. +

+Dans le fichier de configuration, vous pouvez utiliser différentes +stratégies pour filtrer les fichiers à traiter. +L'approche la plus simple consiste à n'utiliser que des règles +`exclude` pour supprimer tous les fichiers et répertoires que vous +ne voulez pas traiter. Par exemple : +

+
+
+# Exclut tout fichier nommé `*.unrecoverable`
+exclude *.unrecoverable
+# Exclut le répertoire racine `/lost+found`
+exclude /lost+found/
+# Exclut tout sous-répertoire nommé `tmp`
+exclude tmp/
+
+
+

+L'approche opposée consiste à ne définir que les fichiers que vous +souhaitez traiter, en n'utilisant que des règles `include`. Par exemple : +

+
+
+# Inclut uniquement certains répertoires
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+L'approche finale consiste à mélanger les règles `exclude` et `include`. +Dans ce cas, l'ordre des règles est important. Les règles antérieures +ont préséance sur les règles ultérieures. +Pour simplifier, vous pouvez lister toutes les règles `exclude` +d'abord, puis toutes les règles `include`. Par exemple : +

+
+
+# Exclut tout fichier nommé `*.unrecoverable`
+exclude *.unrecoverable
+# Exclut tout sous-répertoire nommé `tmp`
+exclude tmp/
+# Inclut uniquement certains répertoires
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+Sur la ligne de commande, en utilisant l'option -f, vous ne pouvez +utiliser que des motifs `include`. Par exemple : +

+
+
+# Vérifie uniquement les fichiers .mp3.
+# Sous Unix, utilisez des guillemets pour éviter l'expansion
+# du globbing par le shell.
+snapraid -f "*.mp3" check
+
+
+

+Sous Unix, lorsque vous utilisez des caractères de globbing sur la +ligne de commande, vous devez les mettre entre guillemets pour empêcher +le shell de les développer. +

9 +Contenu (Content) +

+SnapRAID stocke la liste et les sommes de contrôle de vos fichiers +dans le fichier de contenu. +

+Il s'agit d'un fichier binaire qui répertorie tous les fichiers +présents dans votre baie de disques, ainsi que toutes les sommes +de contrôle pour vérifier leur intégrité. +

+Ce fichier est lu et écrit par les commandes `sync` et `scrub` et +lu par les commandes `fix`, `check` et `status`. +

10 +Parité (Parity) +

+SnapRAID stocke les informations de parité de votre baie dans +les fichiers de parité. +

+Ce sont des fichiers binaires contenant la parité calculée de tous les +blocs définis dans le fichier `content`. +

+Ces fichiers sont lus et écrits par les commandes `sync` et `fix` et +lus uniquement par les commandes `scrub` et `check`. +

11 +Encodage +

+SnapRAID sous Unix ignore tout encodage. Il lit et stocke les +noms de fichiers avec le même encodage utilisé par le système +de fichiers. +

+Sous Windows, tous les noms lus à partir du système de fichiers sont +convertis et traités au format UTF-8. +

+Pour que les noms de fichiers soient imprimés correctement, vous devez +définir la console Windows en mode UTF-8 avec la commande `chcp 65001` +et utiliser une police TrueType comme `Lucida Console` comme police +de console. +Cela n'affecte que les noms de fichiers imprimés ; si vous +redirigez la sortie de la console vers un fichier, le fichier +résultant est toujours au format UTF-8. +

12 +Droits d'auteur (Copyright) +

+Ce fichier est Copyright (C) 2025 Andrea Mazzoleni +

13 +Voir aussi (See Also) +

+snapraid_log(1), rsync(1) + + + +
+ + + + + + diff --git a/manual-it.html b/manual-it.html new file mode 100644 index 00000000..3a50ce43 --- /dev/null +++ b/manual-it.html @@ -0,0 +1,2097 @@ + + + + + + + + + + + + + +SnapRAID + + + + + + + + + + + + +
+ + + +

+Italian manual for SnapRAID. +

+ +

1 +Sinossi +

+
+snapraid [-c, --conf CONFIG]
+    [-f, --filter PATTERN] [-d, --filter-disk NAME]
+    [-m, --filter-missing] [-e, --filter-error]
+    [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
+    [-p, --plan PERC|bad|new|full]
+    [-o, --older-than DAYS] [-l, --log FILE]
+    [-s, --spin-down-on-error] [-w, --bw-limit RATE]
+    [-Z, --force-zero] [-E, --force-empty]
+    [-U, --force-uuid] [-D, --force-device]
+    [-N, --force-nocopy] [-F, --force-full]
+    [-R, --force-realloc]
+    [-S, --start BLKSTART] [-B, --count BLKCOUNT]
+    [-L, --error-limit NUMBER]
+    [-A, --stats]
+    [-v, --verbose] [-q, --quiet]
+    status|smart|probe|up|down|diff|sync|scrub|fix|check
+    |list|dup|pool|devices|touch|rehash
+
+

+

+snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]
+
+

2 +Descrizione +

+SnapRAID è un programma di backup progettato per array di dischi, che +memorizza informazioni di parità per il recupero dati in caso di guasto +fino a sei dischi. +

+Destinato principalmente a centri multimediali domestici con file grandi +e che cambiano raramente, SnapRAID offre diverse funzionalità: +

+

+Per maggiori informazioni, si prega di visitare il sito ufficiale SnapRAID: +

+
+
+https://www.snapraid.it/
+
+
+

3 +Limitazioni +

+SnapRAID è un ibrido tra un programma RAID e un programma di backup, +che mira a combinare i migliori vantaggi di entrambi. Tuttavia, ha +alcune limitazioni che si dovrebbero considerare prima di usarlo. +

+La limitazione principale è che se un disco si guasta e non si è +effettuato un sync di recente, potrebbe non essere possibile recuperare +completamente. +Più specificamente, potrebbe non essere possibile recuperare fino alla +dimensione dei file modificati o eliminati dall'ultima operazione di sync. +Ciò accade anche se i file modificati o eliminati non si trovano sul +disco guasto. Questo è il motivo per cui SnapRAID è più adatto per dati +che cambiano raramente. +

+D'altra parte, i file appena aggiunti non impediscono il recupero dei +file già esistenti. Si perderanno solo i file aggiunti di recente se si +trovano sul disco guasto. +

+Altre limitazioni di SnapRAID sono: +

+

4 +Iniziare +

+Per usare SnapRAID, è necessario prima selezionare un disco nell'array +di dischi da dedicare alle informazioni di `parity` (parità). Con un +disco per la parità, si sarà in grado di recuperare da un singolo guasto +del disco, in modo simile a RAID5. +

+Se si desidera recuperare da più guasti del disco, in modo simile a RAID6, +è necessario riservare dischi aggiuntivi per la parità. Ogni disco di +parità aggiuntivo consente il recupero da un guasto in più del disco. +

+Come dischi di parità, è necessario scegliere i dischi più grandi +dell'array, poiché le informazioni di parità possono crescere fino alle +dimensioni del più grande disco dati nell'array. +

+Questi dischi saranno dedicati alla memorizzazione dei file di `parity`. +Non si dovrebbero memorizzare i propri dati su di essi. +

+Quindi, è necessario definire i dischi `data` (dati) che si desidera +proteggere con SnapRAID. La protezione è più efficace se questi dischi +contengono dati che cambiano raramente. Per questo motivo, è meglio +NON includere il disco C:\ di Windows o le directory Unix /home, /var, +e /tmp. +

+L'elenco dei file viene salvato nei file `content` (contenuto), di solito +memorizzati sui dischi dati, di parità o di avvio. +Questo file contiene i dettagli del backup, inclusi tutti i checksum +per verificarne l'integrità. +Il file `content` viene memorizzato in più copie e ogni copia deve +essere su un disco diverso per garantire che, anche in caso di guasti +multipli del disco, sia disponibile almeno una copia. +

+Ad esempio, supponiamo di essere interessati a un solo livello di +protezione con parità e che i dischi si trovino in: +

+
+
+/mnt/diskp <- disco selezionato per la parità
+/mnt/disk1 <- primo disco da proteggere
+/mnt/disk2 <- secondo disco da proteggere
+/mnt/disk3 <- terzo disco da proteggere
+
+
+

+È necessario creare il file di configurazione /etc/snapraid.conf con +le seguenti opzioni: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /var/snapraid/snapraid.content
+content /mnt/disk1/snapraid.content
+content /mnt/disk2/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+
+
+

+Se si è su Windows, si dovrebbe usare il formato del percorso di Windows, +con lettere di unità e backslash invece di slash. +

+
+
+parity E:\snapraid.parity
+content C:\snapraid\snapraid.content
+content F:\array\snapraid.content
+content G:\array\snapraid.content
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+
+
+

+Se si hanno molti dischi e si esauriscono le lettere di unità, è +possibile montare i dischi direttamente nelle sottocartelle. Vedi: +

+
+
+https://www.google.com/search?q=Windows+mount+point
+
+
+

+A questo punto, si è pronti per eseguire il comando `sync` per costruire +le informazioni di parità. +

+
+
+snapraid sync
+
+
+

+Questo processo può richiedere diverse ore la prima volta, a seconda +delle dimensioni dei dati già presenti sui dischi. Se i dischi sono +vuoti, il processo è immediato. +

+È possibile interromperlo in qualsiasi momento premendo Ctrl+C e, alla +prossima esecuzione, riprenderà da dove è stato interrotto. +

+Quando questo comando è completato, i dati sono SICURI. +

+Ora è possibile iniziare a usare l'array come si desidera e aggiornare +periodicamente le informazioni di parità eseguendo il comando `sync`. +

4.1 +Scrubbing +

+Per controllare periodicamente i dati e la parità per gli errori, è +possibile eseguire il comando `scrub`. +

+
+
+snapraid scrub
+
+
+

+Questo comando confronta i dati nell'array con l'hash calcolato +durante il comando `sync` per verificarne l'integrità. +

+Ogni esecuzione del comando controlla circa l'8% dell'array, escludendo +i dati già sottoposti a scrub nei 10 giorni precedenti. +È possibile utilizzare l'opzione -p, --plan per specificare un importo +diverso e l'opzione -o, --older-than per specificare un'età diversa +in giorni. +Ad esempio, per controllare il 5% dell'array per blocchi più vecchi di +20 giorni, usare: +

+
+
+snapraid -p 5 -o 20 scrub
+
+
+

+Se vengono trovati errori silenti o di input/output durante il processo, +i blocchi corrispondenti vengono contrassegnati come bad (cattivi) nel +file `content` ed elencati nel comando `status`. +

+
+
+snapraid status
+
+
+

+Per correggerli, è possibile utilizzare il comando `fix`, filtrando +i blocchi bad con l'opzione -e, --filter-error: +

+
+
+snapraid -e fix
+
+
+

+Al prossimo `scrub`, gli errori scompariranno dal report `status` +se sono stati veramente corretti. Per renderlo più veloce, è possibile +utilizzare -p bad per eseguire lo scrub solo dei blocchi contrassegnati +come bad. +

+
+
+snapraid -p bad scrub
+
+
+

+L'esecuzione di `scrub` su un array non sincronizzato può riportare +errori causati da file rimossi o modificati. Questi errori sono riportati +nell'output di `scrub`, ma i blocchi correlati non sono contrassegnati +come bad. +

4.2 +Pooling +

+Nota: La funzionalità di pooling descritta di seguito è stata +sostituita dallo strumento mergefs, che è ora l'opzione consigliata +per gli utenti Linux nella comunità SnapRAID. Mergefs fornisce un modo +più flessibile ed efficiente per raggruppare più unità in un singolo +punto di montaggio unificato, consentendo un accesso trasparente ai +file attraverso l'array senza fare affidamento sui collegamenti +simbolici. Si integra bene con SnapRAID per la protezione della parità +ed è comunemente usato in configurazioni come OpenMediaVault (OMV) o +NAS personalizzati. +

+Per avere tutti i file nell'array mostrati nello stesso albero di +directory, è possibile abilitare la funzionalità di `pooling`. Crea +una vista virtuale di sola lettura di tutti i file nell'array +utilizzando collegamenti simbolici. +

+È possibile configurare la directory di `pooling` nel file di +configurazione con: +

+
+
+pool /pool
+
+
+

+o, se si è su Windows, con: +

+
+
+pool C:\pool
+
+
+

+e quindi eseguire il comando `pool` per creare o aggiornare la +vista virtuale. +

+
+
+snapraid pool
+
+
+

+Se si sta utilizzando una piattaforma Unix e si desidera condividere +questa directory sulla rete con macchine Windows o Unix, è necessario +aggiungere le seguenti opzioni al file /etc/samba/smb.conf: +

+
+
+# Nella sezione globale di smb.conf
+unix extensions = no
+
+
+

+
+
+# Nella sezione di condivisione di smb.conf
+[pool]
+comment = Pool
+path = /pool
+read only = yes
+guest ok = yes
+wide links = yes
+follow symlinks = yes
+
+
+

+In Windows, la condivisione di collegamenti simbolici su una rete +richiede che i client li risolvano da remoto. Per abilitare questo, oltre +a condividere la directory pool, è necessario condividere anche tutti i +dischi in modo indipendente, utilizzando i nomi dei dischi definiti nel +file di configurazione come punti di condivisione. È inoltre necessario +specificare nell'opzione `share` del file di configurazione il percorso +UNC di Windows che i client remoti devono utilizzare per accedere a +questi dischi condivisi. +

+Ad esempio, operando da un server chiamato `darkstar`, è possibile +utilizzare le opzioni: +

+
+
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+pool C:\pool
+share \\darkstar
+
+
+

+e condividere le seguenti directory sulla rete: +

+
+
+\\darkstar\pool -> C:\pool
+\\darkstar\d1 -> F:\array
+\\darkstar\d2 -> G:\array
+\\darkstar\d3 -> H:\array
+
+
+

+per consentire ai client remoti di accedere a tutti i file in +\\darkstar\pool. +

+Potrebbe anche essere necessario configurare i client remoti per +abilitare l'accesso ai symlink remoti con il comando: +

+
+
+fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
+
+
+

4.3 +Annullamento Eliminazione +

+SnapRAID funziona più come un programma di backup che come un sistema RAID +e può essere utilizzato per ripristinare o annullare l'eliminazione dei +file al loro stato precedente utilizzando l'opzione -f, --filter: +

+
+
+snapraid fix -f FILE
+
+
+

+o per una directory: +

+
+
+snapraid fix -f DIR/
+
+
+

+È anche possibile usarlo per recuperare solo i file eliminati +accidentalmente all'interno di una directory utilizzando l'opzione -m, +--filter-missing, che ripristina solo i file mancanti, lasciando tutti +gli altri intatti. +

+
+
+snapraid fix -m -f DIR/
+
+
+

+O per recuperare tutti i file eliminati su tutte le unità con: +

+
+
+snapraid fix -m
+
+
+

4.4 +Recupero +

+È successo il peggio e si è perso uno o più dischi! +

+NON FARSI PRENDERE DAL PANICO! Sarà possibile recuperarli! +

+La prima cosa da fare è evitare ulteriori modifiche all'array di dischi. +Disabilitare qualsiasi connessione remota ad esso e qualsiasi processo +pianificato, incluso qualsiasi sync o scrub notturno pianificato di SnapRAID. +

+Quindi procedere con i seguenti passaggi. +

4.4.1 +PASSO 1 -> Riconfigurazione +

+È necessario un po' di spazio per recuperare, idealmente su dischi di +riserva aggiuntivi, ma un disco USB esterno o un disco remoto saranno +sufficienti. +

+Modificare il file di configurazione SnapRAID per far puntare l'opzione +`data` o `parity` del disco guasto a una posizione con spazio vuoto +sufficiente per recuperare i file. +

+Ad esempio, se il disco `d1` è guasto, cambiare da: +

+
+
+data d1 /mnt/disk1/
+
+
+

+a: +

+
+
+data d1 /mnt/new_spare_disk/
+
+
+

+Se il disco da recuperare è un disco di parità, aggiornare l'opzione +`parity` appropriata. +Se si hanno più dischi guasti, aggiornare tutte le loro opzioni di +configurazione. +

4.4.2 +PASSO 2 -> Correzione (Fix) +

+Eseguire il comando fix, memorizzando il log in un file esterno con: +

+
+
+snapraid -d NAME -l fix.log fix
+
+
+

+Dove NAME è il nome del disco, come `d1` nel nostro esempio precedente. +Se il disco da recuperare è un disco di parità, usare i nomi `parity`, +`2-parity`, ecc. +Se si hanno più dischi guasti, usare più opzioni -d per specificarli tutti. +

+Questo comando richiederà molto tempo. +

+Assicurarsi di avere alcuni gigabyte liberi per memorizzare il file +fix.log. Eseguirlo da un disco con spazio libero sufficiente. +

+Ora si è recuperato tutto ciò che è recuperabile. Se alcuni file sono +parzialmente o totalmente irrecuperabili, verranno rinominati aggiungendo +l'estensione `.unrecoverable`. +

+È possibile trovare un elenco dettagliato di tutti i blocchi +irrecuperabili nel file fix.log controllando tutte le righe che iniziano +con `unrecoverable:`. +

+Se non si è soddisfatti del recupero, è possibile riprovare tutte le +volte che si desidera. +

+Ad esempio, se si sono rimossi file dall'array dopo l'ultimo `sync`, +questo può comportare che alcuni file non vengano recuperati. +In questo caso, è possibile riprovare il `fix` usando l'opzione -i, +--import, specificando dove si trovano ora questi file per includerli +di nuovo nel processo di recupero. +

+Se si è soddisfatti del recupero, è possibile procedere oltre, +ma notare che dopo la sincronizzazione, non è più possibile riprovare +il comando `fix`! +

4.4.3 +PASSO 3 -> Controllo (Check) +

+Come controllo cauto, è ora possibile eseguire un comando `check` per +assicurarsi che tutto sia corretto sul disco recuperato. +

+
+
+snapraid -d NAME -a check
+
+
+

+Dove NAME è il nome del disco, come `d1` nel nostro esempio precedente. +

+Le opzioni -d e -a dicono a SnapRAID di controllare solo il disco +specificato e di ignorare tutti i dati di parità. +

+Questo comando richiederà molto tempo, ma se non si è eccessivamente +cauti, è possibile saltarlo. +

4.4.4 +PASSO 4 -> Sincronizzazione (Sync) +

+Eseguire il comando `sync` per risincronizzare l'array con il nuovo disco. +

+
+
+snapraid sync
+
+
+

+Se tutto è recuperato, questo comando è immediato. +

5 +Comandi +

+SnapRAID fornisce alcuni semplici comandi che consentono di: + +

+I comandi devono essere scritti in minuscolo. +

5.1 +status +

+Stampa un riepilogo dello stato dell'array di dischi. +

+Include informazioni sulla frammentazione della parità, quanto sono +vecchi i blocchi senza essere controllati e tutti gli errori silenti +registrati incontrati durante lo scrubbing. +

+Le informazioni presentate si riferiscono all'ultima volta che si è +eseguito `sync`. Le modifiche successive non vengono prese in +considerazione. +

+Se sono stati rilevati blocchi bad, vengono elencati i loro numeri +di blocco. Per correggerli, è possibile utilizzare il comando `fix -e`. +

+Mostra anche un grafico che rappresenta l'ultima volta che ogni blocco +è stato sottoposto a scrub o sincronizzato. I blocchi sottoposti a scrub +sono mostrati con '*', i blocchi sincronizzati ma non ancora sottoposti +a scrub con 'o'. +

+Nulla viene modificato. +

5.2 +smart +

+Stampa un report SMART di tutti i dischi nel sistema. +

+Include una stima della probabilità di guasto nel prossimo anno, +consentendo di pianificare sostituzioni di manutenzione di dischi +che mostrano attributi sospetti. +

+Questa stima della probabilità è ottenuta correlando gli attributi +SMART dei dischi con i dati Backblaze disponibili all'indirizzo: +

+
+
+https://www.backblaze.com/hard-drive-test-data.html
+
+
+

+Se SMART segnala che un disco sta per guastarsi, viene stampato `FAIL` +o `PREFAIL` per quel disco e SnapRAID restituisce un errore. +In questo caso, si raccomanda vivamente la sostituzione immediata del +disco. +

+Altre possibili stringhe di stato sono: + + + + +
+logfail + +In passato, alcuni attributi erano inferiori alla +soglia. +
+logerr + +Il log degli errori del dispositivo contiene errori. +
+selferr + +Il log dell'autotest del dispositivo contiene errori. +
+

+Se viene specificata l'opzione -v, --verbose, viene fornita un'analisi +statistica più approfondita. Questa analisi può aiutare a decidere se +è necessaria più o meno parità. +

+Questo comando utilizza lo strumento `smartctl` ed è equivalente +all'esecuzione di `smartctl -a` su tutti i dispositivi. +

+Se i dispositivi non vengono rilevati automaticamente correttamente, è +possibile specificare un comando personalizzato utilizzando l'opzione +`smartctl` nel file di configurazione. +

+Nulla viene modificato. +

5.3 +probe +

+Stampa lo stato POWER di tutti i dischi nel sistema. +

+`Standby` significa che il disco non sta girando. `Active` significa +che il disco sta girando. +

+Questo comando utilizza lo strumento `smartctl` ed è equivalente +all'esecuzione di `smartctl -n standby -i` su tutti i dispositivi. +

+Se i dispositivi non vengono rilevati automaticamente correttamente, è +possibile specificare un comando personalizzato utilizzando l'opzione +`smartctl` nel file di configurazione. +

+Nulla viene modificato. +

5.4 +up +

+Fa girare tutti i dischi dell'array. +

+È possibile far girare solo dischi specifici utilizzando l'opzione -d, +--filter-disk. +

+Far girare tutti i dischi contemporaneamente richiede molta energia. +Assicurarsi che l'alimentatore possa sostenerlo. +

+Nulla viene modificato. +

5.5 +down +

+Ferma tutti i dischi dell'array. +

+Questo comando utilizza lo strumento `smartctl` ed è equivalente +all'esecuzione di `smartctl -s standby,now` su tutti i dispositivi. +

+È possibile fermare solo dischi specifici utilizzando l'opzione -d, +--filter-disk. +

+Per fermare automaticamente in caso di errore, è possibile utilizzare +l'opzione -s, --spin-down-on-error con qualsiasi altro comando, +che è equivalente all'esecuzione manuale di `down` quando si verifica +un errore. +

+Nulla viene modificato. +

5.6 +diff +

+Elenca tutti i file modificati dall'ultimo `sync` che devono avere i +loro dati di parità ricalcolati. +

+Questo comando non controlla i dati del file, ma solo il timestamp +del file, le dimensioni e l'inode. +

+Dopo aver elencato tutti i file modificati, viene presentato un +riepilogo delle modifiche, raggruppate per: + + + + + + + + +
+equal + +File invariati rispetto a prima. +
+added + +File aggiunti che non erano presenti prima. +
+removed + +File rimossi. +
+updated + +File con dimensioni o timestamp diversi, il che +significa che sono stati modificati. +
+moved + +File spostati in una directory diversa sullo stesso +disco. Sono identificati dall'avere lo stesso nome, +dimensioni, timestamp e inode, ma una directory diversa. +
+copied + +File copiati sullo stesso o su un disco diverso. +Si noti che se sono stati veramente spostati su un altro +disco, saranno contati anche in `removed`. +Sono identificati dall'avere lo stesso nome, dimensioni +e timestamp. Se il timestamp sotto il secondo è zero, +il percorso completo deve corrispondere, non solo il nome. +
+restored + +File con un inode diverso ma nome, dimensioni e +timestamp corrispondenti. Questi sono di solito file +ripristinati dopo essere stati eliminati. +
+

+Se è richiesto un `sync`, il codice di ritorno del processo è 2, +invece del predefinito 0. Il codice di ritorno 1 è utilizzato per una +condizione di errore generica. +

+Nulla viene modificato. +

5.7 +sync +

+Aggiorna le informazioni di parità. Tutti i file modificati +nell'array di dischi vengono letti e i dati di parità +corrispondenti vengono aggiornati. +

+È possibile interrompere questo processo in qualsiasi momento +premendo Ctrl+C, senza perdere il lavoro già svolto. +Alla prossima esecuzione, il processo `sync` riprenderà da dove +è stato interrotto. +

+Se vengono trovati errori silenti o di input/output durante il processo, +i blocchi corrispondenti vengono contrassegnati come bad. +

+I file sono identificati dal percorso e/o dall'inode e controllati +per dimensione e timestamp. +Se la dimensione o il timestamp del file differiscono, i dati di parità +vengono ricalcolati per l'intero file. +Se il file viene spostato o rinominato sullo stesso disco, +mantenendo lo stesso inode, la parità non viene ricalcolata. +Se il file viene spostato su un altro disco, la parità viene ricalcolata, +ma le informazioni di hash precedentemente calcolate vengono mantenute. +

+I file `content` e `parity` vengono modificati se necessario. +I file nell'array NON vengono modificati. +

5.8 +scrub +

+Esegue lo scrub dell'array, controllando la presenza di errori silenti +o di input/output nei dischi dati e di parità. +

+Ogni invocazione controlla circa l'8% dell'array, escludendo +i dati già sottoposti a scrub negli ultimi 10 giorni. +Ciò significa che eseguire lo scrubbing una volta alla settimana +garantisce che ogni bit di dati venga controllato almeno una volta +ogni tre mesi. +

+È possibile definire un piano o una quantità di scrub diversa +utilizzando l'opzione -p, --plan, che accetta: +bad - Esegue lo scrub dei blocchi contrassegnati come bad. +new - Esegue lo scrub dei blocchi appena sincronizzati non ancora +
+sottoposti a scrub. +
+ + + +
+full + +Esegue lo scrub di tutto. +
+0-100 + +Esegue lo scrub della percentuale specificata di blocchi. +
+

+Se si specifica una quantità percentuale, è anche possibile utilizzare +l'opzione -o, --older-than per definire quanto deve essere vecchio +il blocco. +I blocchi più vecchi vengono sottoposti a scrub per primi, +garantendo un controllo ottimale. +Se si desidera eseguire lo scrub solo dei blocchi appena sincronizzati +non ancora sottoposti a scrub, utilizzare l'opzione `-p new`. +

+Per ottenere i dettagli dello stato dello scrub, utilizzare il comando +`status`. +

+Per qualsiasi errore silente o di input/output trovato, i blocchi +corrispondenti vengono contrassegnati come bad nel file `content`. +Questi blocchi bad sono elencati in `status` e possono essere corretti +con `fix -e`. +Dopo la correzione, al prossimo scrub, verranno ricontrollati e, se +trovati corretti, il contrassegno bad verrà rimosso. +Per eseguire lo scrub solo dei blocchi bad, è possibile utilizzare +il comando `scrub -p bad`. +

+Si consiglia di eseguire `scrub` solo su un array sincronizzato per +evitare errori segnalati causati da dati non sincronizzati. Questi +errori sono riconosciuti come non essendo errori silenti e i blocchi non +vengono contrassegnati come bad, ma tali errori sono riportati +nell'output del comando. +

+Il file `content` viene modificato per aggiornare l'ora dell'ultimo +controllo per ogni blocco e per contrassegnare i blocchi bad. +I file `parity` NON vengono modificati. +I file nell'array NON vengono modificati. +

5.9 +fix +

+Corregge tutti i file e i dati di parità. +

+Tutti i file e i dati di parità vengono confrontati con lo stato +snapshot salvato nell'ultimo `sync`. +Se viene trovata una differenza, viene ripristinata allo snapshot +memorizzato. +

+ATTENZIONE! Il comando `fix` non differenzia tra errori e modifiche +intenzionali. Ripristina incondizionatamente lo stato del file +all'ultimo `sync`. +

+Se non viene specificata nessun'altra opzione, l'intero array viene +elaborato. Utilizzare le opzioni di filtro per selezionare un +sottoinsieme di file o dischi su cui operare. +

+Per correggere solo i blocchi contrassegnati come bad durante `sync` +e `scrub`, utilizzare l'opzione -e, --filter-error. +A differenza di altre opzioni di filtro, questa applica correzioni solo +ai file che sono invariati dall'ultimo `sync`. +

+SnapRAID rinomina tutti i file che non possono essere corretti aggiungendo +l'estensione `.unrecoverable`. +

+Prima di correggere, l'intero array viene scansionato per trovare +eventuali file spostati dall'ultima operazione di `sync`. +Questi file sono identificati dal loro timestamp, ignorando il loro nome +e la directory, e vengono utilizzati nel processo di recupero se +necessario. +Se alcuni di essi sono stati spostati al di fuori dell'array, è possibile +utilizzare l'opzione -i, --import per specificare directory aggiuntive +da scansionare. +

+I file sono identificati solo dal percorso, non dall'inode. +

+Il file `content` NON viene modificato. +I file `parity` vengono modificati se necessario. +I file nell'array vengono modificati se necessario. +

5.10 +check +

+Verifica tutti i file e i dati di parità. +

+Funziona come `fix`, ma simula solo un recupero e nessuna modifica +viene scritta nell'array. +

+Questo comando è destinato principalmente alla verifica manuale, +ad esempio dopo un processo di recupero o in altre condizioni speciali. +Per i controlli periodici e pianificati, utilizzare `scrub`. +

+Se si utilizza l'opzione -a, --audit-only, viene controllato solo +l'hash dei file e i dati di parità vengono ignorati per un'esecuzione +più veloce. +

+I file sono identificati solo dal percorso, non dall'inode. +

+Nulla viene modificato. +

5.11 +list +

+Elenca tutti i file contenuti nell'array al momento dell'ultimo +`sync`. +

+Con -v o --verbose, viene mostrato anche il tempo sotto il secondo. +

+Nulla viene modificato. +

5.12 +dup +

+Elenca tutti i file duplicati. Due file sono considerati uguali se i +loro hash corrispondono. I dati del file non vengono letti; vengono +utilizzati solo gli hash precalcolati. +

+Nulla viene modificato. +

5.13 +pool +

+Crea o aggiorna una vista virtuale di tutti +i file nell'array di dischi nella directory di `pooling`. +

+I file non vengono copiati ma collegati utilizzando +collegamenti simbolici. +

+Durante l'aggiornamento, tutti i collegamenti simbolici esistenti +e le sottodirectory vuote vengono eliminati e sostituiti con la nuova +vista dell'array. Qualsiasi altro file regolare viene lasciato al suo posto. +

+Nulla viene modificato al di fuori della directory pool. +

5.14 +devices +

+Stampa i dispositivi di basso livello utilizzati dall'array. +

+Questo comando visualizza le associazioni dei dispositivi nell'array +ed è principalmente destinato come interfaccia script. +

+Le prime due colonne sono l'ID e il percorso del dispositivo di basso +livello. Le due colonne successive sono l'ID e il percorso del dispositivo +di alto livello. L'ultima colonna è il nome del disco nell'array. +

+Nella maggior parte dei casi, si ha un dispositivo di basso livello per +ogni disco nell'array, ma in alcune configurazioni più complesse, si +potrebbe avere più dispositivi di basso livello utilizzati da un singolo +disco nell'array. +

+Nulla viene modificato. +

5.15 +touch +

+Imposta un timestamp arbitrario sotto il secondo per tutti i file +che lo hanno impostato a zero. +

+Questo migliora la capacità di SnapRAID di riconoscere i file +spostati e copiati, poiché rende il timestamp quasi unico, +riducendo possibili duplicati. +

+Più specificamente, se il timestamp sotto il secondo non è zero, +un file spostato o copiato viene identificato come tale se corrisponde +al nome, alle dimensioni e al timestamp. Se il timestamp sotto il secondo +è zero, è considerato una copia solo se il percorso completo, +le dimensioni e il timestamp corrispondono tutti. +

+Il timestamp di precisione al secondo non viene modificato, +quindi tutte le date e gli orari dei file saranno conservati. +

5.16 +rehash +

+Pianifica un rehash dell'intero array. +

+Questo comando cambia il tipo di hash utilizzato, in genere quando +si esegue l'aggiornamento da un sistema a 32 bit a uno a 64 bit, per +passare da MurmurHash3 al più veloce SpookyHash. +

+Se si sta già utilizzando l'hash ottimale, questo comando non fa +nulla e informa che non è necessaria alcuna azione. +

+Il rehash non viene eseguito immediatamente ma avviene +progressivamente durante `sync` e `scrub`. +

+È possibile controllare lo stato del rehash utilizzando `status`. +

+Durante il rehash, SnapRAID mantiene la piena funzionalità, +con l'unica eccezione che `dup` non è in grado di rilevare file +duplicati utilizzando un hash diverso. +

6 +Opzioni +

+SnapRAID fornisce le seguenti opzioni: + + +
+-c, --conf CONFIG +
+Seleziona il file di configurazione da utilizzare. Se non +specificato, in Unix utilizza il file `/usr/local/etc/snapraid.conf` +se esiste, altrimenti `/etc/snapraid.conf`. +In Windows, utilizza il file `snapraid.conf` nella stessa +directory di `snapraid.exe`. +
+ + +
+-f, --filter PATTERN +
+Filtra i file da elaborare in `check` e `fix`. +Vengono elaborati solo i file che corrispondono al modello +specificato. +Questa opzione può essere utilizzata più volte. +Vedere la sezione PATTERN per maggiori dettagli sulle +specifiche del modello. +In Unix, assicurarsi che i caratteri di globbing siano citati +se usati. +Questa opzione può essere utilizzata solo con `check` e `fix`. +Non può essere utilizzata con `sync` e `scrub`, poiché elaborano +sempre l'intero array. +
+ + +
+-d, --filter-disk NAME +
+Filtra i dischi da elaborare in `check`, `fix`, `up` e `down`. +È necessario specificare un nome di disco come definito nel file +di configurazione. +È anche possibile specificare i dischi di parità con i nomi: +`parity`, `2-parity`, `3-parity`, ecc., per limitare le operazioni +a un disco di parità specifico. +Se si combinano più opzioni --filter, --filter-disk e +--filter-missing, vengono selezionati solo i file che corrispondono +a tutti i filtri. +Questa opzione può essere utilizzata più volte. +Questa opzione può essere utilizzata solo con `check`, `fix`, +`up` e `down`. +Non può essere utilizzata con `sync` e `scrub`, poiché elaborano +sempre l'intero array. +
+ + +
+-m, --filter-missing +
+Filtra i file da elaborare in `check` e `fix`. +Vengono elaborati solo i file mancanti o eliminati dall'array. +Quando usato con `fix`, questo agisce come un comando di +`undelete` (annullamento eliminazione). +Se si combinano più opzioni --filter, --filter-disk e +--filter-missing, vengono selezionati solo i file che corrispondono +a tutti i filtri. +Questa opzione può essere utilizzata solo con `check` e `fix`. +Non può essere utilizzata con `sync` e `scrub`, poiché elaborano +sempre l'intero array. +
+ + +
+-e, --filter-error +
+Elabora i file con errori in `check` e `fix`. +Elabora solo i file che hanno blocchi contrassegnati con errori +silenti o di input/output durante `sync` e `scrub`, come +elencato in `status`. +Questa opzione può essere utilizzata solo con `check` e `fix`. +
+ + +
+-p, --plan PERC|bad|new|full +
+Seleziona il piano di scrub. Se PERC è un valore numerico da 0 a +100, viene interpretato come la percentuale di blocchi da +sottoporre a scrub. +Invece di una percentuale, è possibile specificare un piano: +`bad` esegue lo scrub dei blocchi bad, `new` esegue lo scrub +dei blocchi non ancora sottoposti a scrub, e `full` esegue lo +scrub di tutto. +Questa opzione può essere utilizzata solo con `scrub`. +
+ + +
+-o, --older-than DAYS +
+Seleziona la parte più vecchia dell'array da elaborare in `scrub`. +DAYS è l'età minima in giorni per un blocco da sottoporre a +scrub; il valore predefinito è 10. +I blocchi contrassegnati come bad vengono sempre sottoposti a scrub +indipendentemente da questa opzione. +Questa opzione può essere utilizzata solo con `scrub`. +
+ + +
+-a, --audit-only +
+In `check`, verifica l'hash dei file senza +controllare i dati di parità. +Se si è interessati solo al controllo dei dati del file, questa +opzione può velocizzare significativamente il processo di controllo. +Questa opzione può essere utilizzata solo con `check`. +
+ + +
+-h, --pre-hash +
+In `sync`, esegue una fase preliminare di hashing di tutti i nuovi +dati per una verifica aggiuntiva prima del calcolo della parità. +Di solito, in `sync`, non viene eseguito alcun hashing preliminare +e i nuovi dati vengono sottoposti a hash subito prima del calcolo +della parità quando vengono letti per la prima volta. +Questo processo si verifica quando il sistema è sotto +carico pesante, con tutti i dischi che girano e una CPU occupata. +Questa è una condizione estrema per la macchina e, se presenta un +problema hardware latente, gli errori silenti potrebbero non +essere rilevati perché i dati non sono ancora stati sottoposti a hash. +Per evitare questo rischio, è possibile abilitare la modalità +`pre-hash` per far leggere tutti i dati due volte per garantirne +l'integrità. +Questa opzione verifica anche i file spostati all'interno dell'array +per garantire che l'operazione di spostamento sia andata a buon fine +e, se necessario, consente di eseguire un'operazione di fix +prima di procedere. +Questa opzione può essere utilizzata solo con `sync`. +
+ + +
+-i, --import DIR +
+Importa dalla directory specificata tutti i file eliminati +dall'array dopo l'ultimo `sync`. +Se si hanno ancora tali file, possono essere utilizzati da `check` +e `fix` per migliorare il processo di recupero. +I file vengono letti, anche nelle sottodirectory, e sono +identificati indipendentemente dal loro nome. +Questa opzione può essere utilizzata solo con `check` e `fix`. +
+ + +
+-s, --spin-down-on-error +
+In caso di errore, ferma (spin down) tutti i dischi gestiti prima +di uscire con un codice di stato non zero. Ciò impedisce alle unità +di rimanere attive e in rotazione dopo un'operazione interrotta, +contribuendo a evitare inutili accumuli di calore e consumo di +energia. Utilizzare questa opzione per garantire che i dischi siano +arrestati in modo sicuro anche in caso di errore di un comando. +
+ + +
+-w, --bw-limit RATE +
+Applica un limite di larghezza di banda globale per tutti i dischi. +RATE è il numero di byte al secondo. È possibile specificare un +moltiplicatore come K, M o G (ad esempio, --bw-limit 1G). +
+ + +
+-A, --stats +
+Abilita una vista dello stato estesa che mostra informazioni +aggiuntive. La schermata visualizza due grafici: +Il primo grafico mostra il numero di stripe bufferizzate per +ciascun disco, insieme al percorso del file attualmente +acceduto su quel disco. In genere, il disco più lento non avrà +buffer disponibile, il che determina la larghezza di banda massima +raggiungibile. +Il secondo grafico mostra la percentuale di tempo trascorso in +attesa negli ultimi 100 secondi. Si prevede che il disco più +lento causi la maggior parte del tempo di attesa, mentre gli altri +dischi dovrebbero avere poco o nessun tempo di attesa perché possono +utilizzare le loro stripe bufferizzate. +Questo grafico mostra anche il tempo trascorso in attesa per +i calcoli di hash e i calcoli RAID. +Tutti i calcoli vengono eseguiti in parallelo con le operazioni +su disco. Pertanto, finché c'è un tempo di attesa misurabile per +almeno un disco, ciò indica che la CPU è abbastanza veloce da +tenere il passo con il carico di lavoro. +
+ + +
+-Z, --force-zero +
+Forza l'operazione non sicura di sincronizzazione di un file con +dimensione zero che in precedenza era non zero. +Se SnapRAID rileva una tale condizione, interrompe la +prosecuzione a meno che non si specifichi questa opzione. +Ciò consente di rilevare facilmente quando, dopo un arresto +anomalo del sistema, alcuni file a cui si è acceduto sono stati +troncati. +Questa è una possibile condizione in Linux con i file system +ext3/ext4. +Questa opzione può essere utilizzata solo con `sync`. +
+ + +
+-E, --force-empty +
+Forza l'operazione non sicura di sincronizzazione di un disco con +tutti i file originali mancanti. +Se SnapRAID rileva che tutti i file originariamente presenti +sul disco sono mancanti o riscritti, interrompe la prosecuzione +a meno che non si specifichi questa opzione. +Ciò consente di rilevare facilmente quando un file system di dati +non è montato. +Questa opzione può essere utilizzata solo con `sync`. +
+ + +
+-U, --force-uuid +
+Forza l'operazione non sicura di sincronizzazione, controllo e +correzione con dischi che hanno cambiato il loro UUID. +Se SnapRAID rileva che alcuni dischi hanno cambiato UUID, +interrompe la prosecuzione a meno che non si specifichi questa +opzione. +Ciò consente di rilevare quando i dischi sono montati sui punti +di montaggio sbagliati. +Tuttavia, è consentito avere un singolo cambio di UUID con +parità singola e di più con parità multipla, perché questo è +il caso normale quando si sostituiscono i dischi dopo un recupero. +Questa opzione può essere utilizzata solo con `sync`, `check` +o `fix`. +
+ + +
+-D, --force-device +
+Forza l'operazione non sicura di correzione con dischi inaccessibili +o con dischi sullo stesso dispositivo fisico. +Ad esempio, se si sono persi due dischi dati e si ha un disco di +riserva per recuperare solo il primo, è possibile ignorare il secondo +disco inaccessibile. +Oppure, se si desidera recuperare un disco nello spazio libero +rimasto su un disco già utilizzato, condividendo lo stesso dispositivo +fisico. +Questa opzione può essere utilizzata solo con `fix`. +
+ + +
+-N, --force-nocopy +
+In `sync`, `check` e `fix`, disabilita l'euristica di rilevamento +della copia. +Senza questa opzione, SnapRAID presume che i file con gli stessi +attributi, come nome, dimensione e timestamp, siano copie con gli +stessi dati. +Ciò consente l'identificazione di file copiati o spostati da un +disco all'altro e riutilizza le informazioni di hash già calcolate +per rilevare errori silenti o per recuperare file mancanti. +In alcuni rari casi, questo comportamento può comportare falsi +positivi o un processo lento a causa di molte verifiche di hash, +e questa opzione consente di risolvere tali problemi. +Questa opzione può essere utilizzata solo con `sync`, `check` +e `fix`. +
+ + +
+-F, --force-full +
+In `sync`, forza un ricalcolo completo della parità. +Questa opzione può essere utilizzata quando si aggiunge un nuovo +livello di parità o se si è tornati a un vecchio file di contenuto +utilizzando dati di parità più recenti. +Invece di ricreare la parità da zero, questo consente di riutilizzare +gli hash presenti nel file di contenuto per convalidare i dati e +mantenere la protezione dei dati durante il processo `sync` +utilizzando i dati di parità esistenti. +Questa opzione può essere utilizzata solo con `sync`. +
+ + +
+-R, --force-realloc +
+In `sync`, forza una riallocazione completa dei file e la +ricostruzione della parità. +Questa opzione può essere utilizzata per riallocare completamente +tutti i file, rimuovendo la frammentazione, riutilizzando gli hash +presenti nel file di contenuto per convalidare i dati. +Questa opzione può essere utilizzata solo con `sync`. +ATTENZIONE! Questa opzione è solo per esperti ed è vivamente +sconsigliato utilizzarla. +NON si ha protezione dei dati durante l'operazione `sync`. +
+ + +
+-l, --log FILE +
+Scrive un log dettagliato nel file specificato. +Se questa opzione non è specificata, gli errori imprevisti vengono +stampati sullo schermo, potenzialmente resulting in un output +eccessivo in caso di molti errori. Quando -l, --log è specificato, +vengono stampati sullo schermo solo gli errori fatali che +causano l'arresto di SnapRAID. +Se il percorso inizia con '>>', il file viene aperto in modalità +append. Le occorrenze di '%D' e '%T' nel nome vengono sostituite +con la data e l'ora nel formato YYYYMMDD e HHMMSS. Nei file batch +di Windows, è necessario raddoppiare il carattere '%', ad esempio +result-%%D.log. Per utilizzare '>>', è necessario racchiudere +il nome tra virgolette, ad esempio `">>result.log"`. +Per indirizzare l'output del log all'output standard o all'errore +standard, è possibile utilizzare `">&1"` e `">&2"`, +rispettivamente. +Vedere il file snapraid_log.txt o la pagina man per le descrizioni +dei tag di log. +
+ + +
+-L, --error-limit NUMBER +
+Imposta un nuovo limite di errore prima di interrompere l'esecuzione. +Per impostazione predefinita, SnapRAID si interrompe se incontra +più di 100 errori di input/output, indicando che un disco +sta probabilmente fallendo. +Questa opzione influisce su `sync` e `scrub`, a cui è consentito +continuare dopo il primo set di errori del disco per cercare di +completare le loro operazioni. +Tuttavia, `check` e `fix` si interrompono sempre al primo errore. +
+ + +
+-S, --start BLKSTART +
+Avvia l'elaborazione dal numero di blocco specificato. +Ciò può essere utile per riprovare a controllare o correggere +blocchi specifici in caso di disco danneggiato. +Questa opzione è principalmente per il recupero manuale avanzato. +
+ + +
+-B, --count BLKCOUNT +
+Elabora solo il numero specificato di blocchi. +Questa opzione è principalmente per il recupero manuale avanzato. +
+ + +
+-C, --gen-conf CONTENT +
+Genera un file di configurazione fittizio da un file di contenuto +esistente. +Il file di configurazione viene scritto nell'output standard e non +sovrascrive uno esistente. +Questo file di configurazione contiene anche le informazioni +necessarie per ricostruire i punti di montaggio del disco nel caso +in cui si perda l'intero sistema. +
+ + +
+-v, --verbose +
+Stampa più informazioni sullo schermo. +Se specificato una volta, stampa i file esclusi +e statistiche aggiuntive. +Questa opzione non ha effetto sui file di log. +
+ + +
+-q, --quiet +
+Stampa meno informazioni sullo schermo. +Se specificato una volta, rimuove la barra di avanzamento; +due volte, le operazioni in corso; tre volte, i messaggi di +informazione; quattro volte, i messaggi di stato. +Gli errori fatali vengono sempre stampati sullo schermo. +Questa opzione non ha effetto sui file di log. +
+ + +
+-H, --help +
+Stampa una breve schermata di aiuto. +
+ + +
+-V, --version +
+Stampa la versione del programma. +
+

7 +Configurazione +

+SnapRAID richiede un file di configurazione per sapere dove si trova +l'array di dischi e dove memorizzare le informazioni di parità. +

+In Unix, utilizza il file `/usr/local/etc/snapraid.conf` se esiste, +altrimenti `/etc/snapraid.conf`. +In Windows, utilizza il file `snapraid.conf` nella stessa +directory di `snapraid.exe`. +

+Deve contenere le seguenti opzioni (sensibili al maiuscolo/minuscolo): +

7.1 +parity FILE [,FILE] ... +

+Definisce i file da utilizzare per memorizzare le informazioni di parità. +La parità consente la protezione da un singolo guasto del disco, +simile a RAID5. +

+È possibile specificare più file, che devono essere su dischi diversi. +Quando un file non può più crescere, viene utilizzato il successivo. +Lo spazio totale disponibile deve essere almeno grande quanto il disco +dati più grande dell'array. +

+È possibile aggiungere file di parità aggiuntivi in seguito, ma non è +possibile riordinarli o rimuoverli. +

+Mantenere i dischi di parità riservati alla parità garantisce che non +diventino frammentati, migliorando le prestazioni. +

+In Windows, 256 MB vengono lasciati inutilizzati su ogni disco per +evitare l'avviso sui dischi pieni. +

+Questa opzione è obbligatoria e può essere utilizzata solo una volta. +

7.2 +(2,3,4,5,6)-parity FILE [,FILE] ... +

+Definisce i file da utilizzare per memorizzare informazioni di parità +extra. +

+Per ogni livello di parità specificato, è abilitato un livello +aggiuntivo di protezione: +

+

+Ogni livello di parità richiede la presenza di tutti i livelli di parità +precedenti. +

+Si applicano le stesse considerazioni dell'opzione 'parity'. +

+Queste opzioni sono facoltative e possono essere utilizzate solo una volta. +

7.3 +z-parity FILE [,FILE] ... +

+Definisce un file e un formato alternativi per memorizzare la tripla +parità. +

+Questa opzione è un'alternativa a '3-parity', destinata +principalmente a CPU di fascia bassa come ARM o AMD Phenom, Athlon +e Opteron che non supportano il set di istruzioni SSSE3. In tali +casi, fornisce prestazioni migliori. +

+Questo formato è simile ma più veloce di quello utilizzato da ZFS RAIDZ3. +Come ZFS, non funziona oltre la tripla parità. +

+Quando si utilizza '3-parity', si verrà avvisati se è consigliato +utilizzare il formato 'z-parity' per un miglioramento delle prestazioni. +

+È possibile convertire da un formato all'altro regolando il file +di configurazione con il file z-parity o 3-parity desiderato e +utilizzando 'fix' per ricrearlo. +

7.4 +content FILE +

+Definisce il file da utilizzare per memorizzare l'elenco e i checksum +di tutti i file presenti nell'array di dischi. +

+Può essere posizionato su un disco utilizzato per dati, parità o +qualsiasi altro disco disponibile. +Se si utilizza un disco dati, questo file viene automaticamente +escluso dal processo `sync`. +

+Questa opzione è obbligatoria e può essere utilizzata più volte +per salvare più copie dello stesso file. +

+È necessario memorizzare almeno una copia per ogni disco di parità +utilizzato più uno. L'utilizzo di copie aggiuntive non è dannoso. +

7.5 +data NAME DIR +

+Definisce il nome e il punto di montaggio dei dischi dati +nell'array. NAME viene utilizzato per identificare il disco e deve +essere unico. DIR è il punto di montaggio del disco nel file system. +

+È possibile cambiare il punto di montaggio secondo necessità, +purché si mantenga fisso NAME. +

+È necessario utilizzare un'opzione per ogni disco dati nell'array. +

+È possibile rinominare un disco in seguito modificando NAME +direttamente nel file di configurazione e quindi eseguendo un +comando 'sync'. +In caso di ridenominazione, l'associazione viene eseguita utilizzando +l'UUID memorizzato dei dischi. +

7.6 +nohidden +

+Esclude tutti i file e le directory nascosti. +In Unix, i file nascosti sono quelli che iniziano con `.`. +In Windows, sono quelli con l'attributo nascosto. +

7.7 +exclude/include PATTERN +

+Definisce i modelli di file o directory da escludere o includere +nel processo di sync. +Tutti i modelli vengono elaborati nell'ordine specificato. +

+Se il primo modello che corrisponde è un `exclude`, il file +viene escluso. Se è un `include`, il file viene incluso. +Se nessun modello corrisponde, il file viene escluso se l'ultimo +modello specificato è un `include`, o incluso se l'ultimo modello +specificato è un `exclude`. +

+Vedere la sezione PATTERN per maggiori dettagli sulle specifiche +del modello. +

+Questa opzione può essere utilizzata più volte. +

7.8 +blocksize SIZE_IN_KIBIBYTES +

+Definisce la dimensione di blocco di base in kibibyte per la parità. +Un kibibyte è 1024 byte. +

+La dimensione di blocco predefinita è 256, che dovrebbe funzionare +nella maggior parte dei casi. +

+ATTENZIONE! Questa opzione è solo per esperti ed è vivamente +sconsigliato modificare questo valore. Per modificare questo valore in +futuro, sarà necessario ricreare l'intera parità! +

+Un motivo per utilizzare una dimensione di blocco diversa è se si +hanno molti file piccoli, nell'ordine dei milioni. +

+Per ogni file, anche se solo pochi byte, viene allocato un intero +blocco di parità e, con molti file, ciò può comportare uno spazio +di parità inutilizzato significativo. +Quando si riempie completamente il disco di parità, non è +consentito aggiungere altri file ai dischi dati. +Tuttavia, la parità sprecata non si accumula tra i dischi dati. +Lo spazio sprecato risultante da un numero elevato di file su un +disco dati limita solo la quantità di dati su quel disco dati, non +gli altri. +

+Come approssimazione, si può presumere che metà della dimensione del +blocco sia sprecata per ogni file. Ad esempio, con 100.000 file e una +dimensione di blocco di 256 KiB, si sprecheranno 12,8 GB di parità, +il che può comportare 12,8 GB in meno di spazio disponibile sul disco +dati. +

+È possibile controllare la quantità di spazio sprecato su ogni disco +utilizzando `status`. +Questa è la quantità di spazio che è necessario lasciare libero sui +dischi dati o utilizzare per i file non inclusi nell'array. +Se questo valore è negativo, significa che si è vicini a riempire +la parità e rappresenta lo spazio che è ancora possibile sprecare. +

+Per evitare questo problema, è possibile utilizzare una partizione +più grande per la parità. +Ad esempio, se la partizione di parità è 12,8 GB più grande dei dischi +dati, si ha abbastanza spazio extra per gestire fino a 100.000 +file su ogni disco dati senza alcuno spreco di spazio. +

+Un trucco per ottenere una partizione di parità più grande in Linux è +formattarla con il comando: +

+
+
+mkfs.ext4 -m 0 -T largefile4 DEVICE
+
+
+

+Ciò si traduce in circa l'1,5% di spazio extra, circa 60 GB per +un disco da 4 TB, che consente circa 460.000 file su ogni disco dati +senza alcuno spreco di spazio. +

7.9 +hashsize SIZE_IN_BYTES +

+Definisce la dimensione dell'hash in byte per i blocchi salvati. +

+La dimensione di hash predefinita è 16 byte (128 bit), che dovrebbe +funzionare nella maggior parte dei casi. +

+ATTENZIONE! Questa opzione è solo per esperti ed è vivamente +sconsigliato modificare questo valore. Per modificare questo valore in +futuro, sarà necessario ricreare l'intera parità! +

+Un motivo per utilizzare una dimensione di hash diversa è se il +sistema ha memoria limitata. Come regola generale, SnapRAID +tipicamente richiede 1 GiB di RAM per ogni 16 TB di dati nell'array. +

+Nello specifico, per memorizzare gli hash dei dati, SnapRAID richiede +circa $TS*(1+HS)/BS$ byte di RAM, +dove $TS$ è la dimensione totale in byte dell'array di dischi, $BS$ è la +dimensione del blocco in byte e $HS$ è la dimensione dell'hash in byte. +

+Ad esempio, con 8 dischi da 4 TB, una dimensione di blocco di 256 KiB +($1 \text{ KiB} = 1024 \text{ byte}$) e una dimensione di hash di 16, si ottiene: +

+

+RAM = $(8 * 4 * 10^{12}) * (1+16) / (256 * 2^{10}) = 1.93 \text{ GiB}$
+
+

+Passando a una dimensione di hash di 8, si ottiene: +

+

+RAM = $(8 * 4 * 10^{12}) * (1+8) / (256 * 2^{10}) = 1.02 \text{ GiB}$
+
+

+Passando a una dimensione di blocco di 512, si ottiene: +

+

+RAM = $(8 * 4 * 10^{12}) * (1+16) / (512 * 2^{10}) = 0.96 \text{ GiB}$
+
+

+Passando sia a una dimensione di hash di 8 che a una dimensione di +blocco di 512, si ottiene: +

+

+RAM = $(8 * 4 * 10^{12}) * (1+8) / (512 * 2^{10}) = 0.51 \text{ GiB}$
+
+

7.10 +autosave SIZE_IN_GIGABYTES +

+Salva automaticamente lo stato durante la sincronizzazione o lo scrubbing +dopo la quantità specificata di GB elaborati. +Questa opzione è utile per evitare di riavviare lunghi comandi `sync` +da zero se interrotti da un arresto anomalo della macchina o qualsiasi +altro evento. +

7.11 +temp_limit TEMPERATURE_CELSIUS +

+Imposta la temperatura massima del disco consentita in Celsius. Se +specificato, SnapRAID controlla periodicamente la temperatura di tutti +i dischi utilizzando lo strumento smartctl. Le temperature attuali dei +dischi vengono visualizzate mentre SnapRAID è in funzione. Se un disco +supera questo limite, tutte le operazioni si interrompono e i dischi +vengono messi in stand-by (spin down) per la durata definita +dall'opzione `temp_sleep`. Dopo il periodo di sonno, le operazioni +riprendono, potenzialmente mettendosi in pausa di nuovo se il limite +di temperatura viene raggiunto ancora una volta. +

+Durante il funzionamento, SnapRAID analizza anche la curva di riscaldamento +di ciascun disco e stima la temperatura costante a lungo termine che +dovrebbero raggiungere se l'attività continua. La stima viene eseguita +solo dopo che la temperatura del disco è aumentata quattro volte, +garantendo che siano disponibili abbastanza punti dati per stabilire +una tendenza affidabile. +Questa temperatura costante prevista è mostrata tra parentesi accanto +al valore attuale e aiuta a valutare se il raffreddamento del sistema +è adeguato. Questa temperatura stimata è solo a scopo informativo +e non ha alcun effetto sul comportamento di SnapRAID. Le azioni del +programma si basano esclusivamente sulle temperature effettive +misurate del disco. +

+Per eseguire questa analisi, SnapRAID necessita di un riferimento +per la temperatura del sistema. Tenta prima di leggerla dai sensori +hardware disponibili. Se non è possibile accedere a nessun sensore di +sistema, utilizza la temperatura del disco più bassa misurata all'inizio +dell'esecuzione come riferimento di riserva. +

+Normalmente, SnapRAID mostra solo la temperatura del disco più caldo. +Per visualizzare la temperatura di tutti i dischi, utilizzare l'opzione +-A o --stats. +

7.12 +temp_sleep TIME_IN_MINUTES +

+Imposta il tempo di stand-by, in minuti, quando il limite di temperatura +viene raggiunto. Durante questo periodo, i dischi rimangono fermi +(spin down). Il valore predefinito è 5 minuti. +

7.13 +pool DIR +

+Definisce la directory di pooling in cui viene creata la vista virtuale +dell'array di dischi utilizzando il comando `pool`. +

+La directory deve già esistere. +

7.14 +share UNC_DIR +

+Definisce il percorso UNC di Windows necessario per accedere ai dischi +da remoto. +

+Se questa opzione è specificata, i collegamenti simbolici creati nella +directory pool utilizzano questo percorso UNC per accedere ai dischi. +Senza questa opzione, i collegamenti simbolici generati utilizzano +solo percorsi locali, il che non consente la condivisione della +directory pool sulla rete. +

+I collegamenti simbolici sono formati utilizzando il percorso UNC +specificato, aggiungendo il nome del disco come specificato nell'opzione +`data` e infine aggiungendo la directory e il nome del file. +

+Questa opzione è richiesta solo per Windows. +

7.15 +smartctl DISK/PARITY OPTIONS... +

+Definisce opzioni smartctl personalizzate per ottenere gli attributi +SMART per ogni disco. Ciò potrebbe essere richiesto per controller RAID +e alcuni dischi USB che non possono essere rilevati automaticamente. +Il segnaposto %s viene sostituito dal nome del dispositivo, ma è +facoltativo per dispositivi fissi come i controller RAID. +

+DISK è lo stesso nome del disco specificato nell'opzione `data`. +PARITY è uno dei nomi di parità: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` o `z-parity`. +

+Nelle OPTIONS specificate, la stringa `%s` viene sostituita dal +nome del dispositivo. Per i controller RAID, il dispositivo è +probabilmente fisso e potrebbe non essere necessario utilizzare `%s`. +

+Fare riferimento alla documentazione di smartmontools per le possibili +opzioni: +

+
+
+https://www.smartmontools.org/wiki/Supported_RAID-Controllers
+https://www.smartmontools.org/wiki/Supported_USB-Devices
+
+
+

+Ad esempio: +

+
+
+smartctl parity -d sat %s
+
+
+

7.16 +smartignore DISK/PARITY ATTR [ATTR...] +

+Ignora l'attributo SMART specificato durante il calcolo della +probabilità di guasto del disco. Questa opzione è utile se un disco +segnala valori insoliti o fuorvianti per un particolare attributo. +

+DISK è lo stesso nome del disco specificato nell'opzione `data`. +PARITY è uno dei nomi di parità: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` o `z-parity`. +Il valore speciale * può essere utilizzato per ignorare l'attributo +su tutti i dischi. +

+Ad esempio, per ignorare l'attributo `Current Pending Sector Count` +su tutti i dischi: +

+
+
+smartignore * 197
+
+
+

+Per ignorarlo solo sul primo disco di parità: +

+
+
+smartignore parity 197
+
+
+

7.17 +Esempi +

+Un esempio di configurazione tipica per Unix è: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /mnt/diskp/snapraid.content
+content /var/snapraid/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+exclude /lost+found/
+exclude /tmp/
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/sg0
+smartctl 2-parity -d areca,2/1 /dev/sg0
+
+
+

+Un esempio di configurazione tipica per Windows è: +

+
+
+parity E:\snapraid.parity
+content E:\snapraid.content
+content C:\snapraid\snapraid.content
+data d1 G:\array\
+data d2 H:\array\
+data d3 I:\array\
+exclude Thumbs.db
+exclude \$RECYCLE.BIN
+exclude \System Volume Information
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/arcmsr0
+smartctl 2-parity -d areca,2/1 /dev/arcmsr0
+
+
+

8 +Pattern +

+I pattern vengono utilizzati per selezionare un sottoinsieme di file da +escludere o includere nel processo. +

+Esistono quattro diversi tipi di pattern: + + +
+FILE +
+Seleziona qualsiasi file denominato FILE. È possibile utilizzare +qualsiasi carattere di globbing come * e ?, e classi di caratteri +come [a-z]. +Questo pattern si applica solo ai file, non alle directory. +
+ + +
+DIR/ +
+Seleziona qualsiasi directory denominata DIR e tutto ciò che è +al suo interno. È possibile utilizzare qualsiasi carattere di +globbing come * e ?. +Questo pattern si applica solo alle directory, non ai file. +
+ + +
+/PATH/FILE +
+Seleziona l'esatto percorso del file specificato. È possibile +utilizzare qualsiasi carattere di globbing come * e ?, ma non +corrispondono mai a uno slash di directory. +Questo pattern si applica solo ai file, non alle directory. +
+ + +
+/PATH/DIR/ +
+Seleziona l'esatto percorso della directory specificata e tutto +ciò che è al suo interno. È possibile utilizzare qualsiasi +carattere di globbing come * e ?, ma non corrispondono mai a +uno slash di directory. +Questo pattern si aplica solo alle directory, non ai file. +
+

+Quando si specifica un percorso assoluto che inizia con /, viene +applicato alla directory radice dell'array, non alla directory radice +del file system locale. +

+In Windows, è possibile utilizzare il backslash \ invece dello slash +in avanti /. Le directory di sistema di Windows, le junction, i punti +di montaggio e altre directory speciali di Windows sono trattati come +file, il che significa che per escluderli, è necessario utilizzare una +regola di file, non una di directory. +

+Se il nome del file contiene un carattere '*', '?', '[' o ']', +è necessario eseguirne l'escape per evitare che venga interpretato +come un carattere di globbing. In Unix, il carattere di escape è '\'; +in Windows, è '^'. +Quando il pattern è sulla riga di comando, è necessario raddoppiare +il carattere di escape per evitare che venga interpretato dalla shell +dei comandi. +

+Nel file di configurazione, è possibile utilizzare diverse strategie +per filtrare i file da elaborare. +L'approccio più semplice è utilizzare solo regole `exclude` per +rimuovere tutti i file e le directory che non si desidera elaborare. +Ad esempio: +

+
+
+# Esclude qualsiasi file denominato `*.unrecoverable`
+exclude *.unrecoverable
+# Esclude la directory radice `/lost+found`
+exclude /lost+found/
+# Esclude qualsiasi sottodirectory denominata `tmp`
+exclude tmp/
+
+
+

+L'approccio opposto è definire solo i file che si desidera elaborare, +utilizzando solo regole `include`. Ad esempio: +

+
+
+# Include solo alcune directory
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+L'approccio finale è mescolare regole `exclude` e `include`. In questo +caso, l'ordine delle regole è importante. Le regole precedenti hanno +la precedenza su quelle successive. +Per semplificare, è possibile elencare prima tutte le regole `exclude` +e poi tutte le regole `include`. Ad esempio: +

+
+
+# Esclude qualsiasi file denominato `*.unrecoverable`
+exclude *.unrecoverable
+# Esclude qualsiasi sottodirectory denominata `tmp`
+exclude tmp/
+# Include solo alcune directory
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+Sulla riga di comando, utilizzando l'opzione -f, è possibile utilizzare +solo pattern `include`. Ad esempio: +

+
+
+# Controlla solo i file .mp3.
+# In Unix, utilizzare le virgolette per evitare l'espansione
+# del globbing da parte della shell.
+snapraid -f "*.mp3" check
+
+
+

+In Unix, quando si utilizzano caratteri di globbing sulla riga di +comando, è necessario citarli per impedire alla shell di espanderli. +

9 +Content +

+SnapRAID memorizza l'elenco e i checksum dei file nel file di contenuto. +

+È un file binario che elenca tutti i file presenti nell'array di dischi, +insieme a tutti i checksum per verificarne l'integrità. +

+Questo file viene letto e scritto dai comandi `sync` e `scrub` e +letto dai comandi `fix`, `check` e `status`. +

10 +Parity +

+SnapRAID memorizza le informazioni di parità dell'array nei file di +parità. +

+Questi sono file binari contenenti la parità calcolata di tutti i +blocchi definiti nel file `content`. +

+Questi file vengono letti e scritti dai comandi `sync` e `fix` e +solo letti dai comandi `scrub` e `check`. +

11 +Codifica +

+SnapRAID in Unix ignora qualsiasi codifica. Legge e memorizza i +nomi dei file con la stessa codifica utilizzata dal file system. +

+In Windows, tutti i nomi letti dal file system vengono convertiti e +elaborati in formato UTF-8. +

+Per avere i nomi dei file stampati correttamente, è necessario impostare +la console di Windows in modalità UTF-8 con il comando `chcp 65001` e +utilizzare un carattere TrueType come `Lucida Console` come carattere +della console. +Questo influisce solo sui nomi dei file stampati; se si +reindirizza l'output della console a un file, il file risultante è +sempre in formato UTF-8. +

13 +Vedi Anche +

+snapraid_log(1), rsync(1) + + + +
+ + + + + + diff --git a/manual-pl.html b/manual-pl.html new file mode 100644 index 00000000..be974835 --- /dev/null +++ b/manual-pl.html @@ -0,0 +1,1980 @@ + + + + + + + + + + + + + +SnapRAID + + + + + + + + + + + + +
+ + + +

+Polish manual for SnapRAID. +

+ +

1 +Synopsis +

+
+snapraid [-c, --conf CONFIG]
+    [-f, --filter PATTERN] [-d, --filter-disk NAME]
+    [-m, --filter-missing] [-e, --filter-error]
+    [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
+    [-p, --plan PERC|bad|new|full]
+    [-o, --older-than DAYS] [-l, --log FILE]
+    [-s, --spin-down-on-error] [-w, --bw-limit RATE]
+    [-Z, --force-zero] [-E, --force-empty]
+    [-U, --force-uuid] [-D, --force-device]
+    [-N, --force-nocopy] [-F, --force-full]
+    [-R, --force-realloc]
+    [-S, --start BLKSTART] [-B, --count BLKCOUNT]
+    [-L, --error-limit NUMBER]
+    [-A, --stats]
+    [-v, --verbose] [-q, --quiet]
+    status|smart|probe|up|down|diff|sync|scrub|fix|check
+    |list|dup|pool|devices|touch|rehash
+
+

+

+snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]
+
+

2 +Description +

+SnapRAID to program do tworzenia kopii zapasowych przeznaczony +dla macierzy dyskowych, przechowujący informacje parzystości +do odzyskiwania danych w przypadku awarii do sześciu dysków. +

+Przeznaczony głównie dla domowych centrów multimedialnych z dużymi, +rzadko zmieniającymi się plikami, SnapRAID oferuje kilka funkcji: +

+

+Więcej informacji można znaleźć na oficjalnej stronie SnapRAID: +

+
+
+https://www.snapraid.it/
+
+
+

3 +Limitations +

+SnapRAID to hybryda programu RAID i programu do tworzenia kopii zapasowych, +której celem jest połączenie najlepszych zalet obu. Ma jednak pewne +ograniczenia, które należy wziąć pod uwagę przed jego użyciem. +

+Głównym ograniczeniem jest to, że jeśli dysk ulegnie awarii, a Ty nie wykonałeś +niedawno synchronizacji, możesz nie być w stanie w pełni odzyskać danych. +Dokładniej, możesz nie być w stanie odzyskać danych o wielkości +zmienionych lub usuniętych plików od czasu ostatniej operacji synchronizacji. +Dzieje się tak, nawet jeśli zmienione lub usunięte pliki nie znajdują się na +uszkodzonym dysku. Dlatego SnapRAID jest lepiej dostosowany do +danych, które rzadko się zmieniają. +

+Z drugiej strony, nowo dodane pliki nie uniemożliwiają odzyskania już +istniejących plików. Stracisz tylko ostatnio dodane pliki, jeśli +znajdują się one na uszkodzonym dysku. +

+Inne ograniczenia SnapRAID to: +

+

4 +Getting Started +

+Aby użyć SnapRAID, musisz najpierw wybrać jeden dysk w swojej macierzy +dysków, który zostanie przeznaczony na informacje o `parzystości`. Z jednym dyskiem +na parzystość będziesz w stanie odzyskać dane po awarii pojedynczego dysku, +podobnie jak w RAID5. +

+Jeśli chcesz odzyskać dane po większej liczbie awarii dysków, podobnie jak +w RAID6, musisz zarezerwować dodatkowe dyski na parzystość. Każdy dodatkowy +dysk parzystości umożliwia odzyskanie danych po jeszcze jednej awarii dysku. +

+Jako dyski parzystości musisz wybrać największe dyski w macierzy, +ponieważ informacje o parzystości mogą urosnąć do rozmiaru największego +dysku danych w macierzy. +

+Dyski te będą przeznaczone do przechowywania plików `parzystości`. +Nie powinieneś na nich przechowywać swoich danych. +

+Następnie musisz zdefiniować dyski `danych`, które chcesz chronić +za pomocą SnapRAID. Ochrona jest bardziej skuteczna, jeśli te dyski +zawierają dane, które rzadko się zmieniają. Z tego powodu lepiej jest +NIE włączać dysku C:\ w systemie Windows ani katalogów /home, /var i /tmp +w systemie Unix. +

+Lista plików jest zapisywana w plikach `zawartości`, zwykle +przechowywanych na dyskach danych, parzystości lub rozruchowych. +Plik ten zawiera szczegóły Twojej kopii zapasowej, w tym wszystkie +sumy kontrolne w celu weryfikacji jej integralności. +Plik `zawartości` jest przechowywany w wielu kopiach, a każda kopia musi +znajdować się na innym dysku, aby zapewnić, że nawet w przypadku wielu +awarii dysków, przynajmniej jedna kopia jest dostępna. +

+Na przykład, załóżmy, że interesuje Cię tylko jeden poziom parzystości +i Twoje dyski znajdują się w: +

+
+
+/mnt/diskp <- wybrany dysk dla parzystości
+/mnt/disk1 <- pierwszy dysk do ochrony
+/mnt/disk2 <- drugi dysk do ochrony
+/mnt/disk3 <- trzeci dysk do ochrony
+
+
+

+Musisz utworzyć plik konfiguracyjny /etc/snapraid.conf z +następującymi opcjami: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /var/snapraid/snapraid.content
+content /mnt/disk1/snapraid.content
+content /mnt/disk2/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+
+
+

+Jeśli używasz systemu Windows, powinieneś użyć formatu ścieżek Windows, +z literami dysków i ukośnikami odwrotnymi zamiast ukośników: +

+
+
+parity E:\snapraid.parity
+content C:\snapraid\snapraid.content
+content F:\array\snapraid.content
+content G:\array\snapraid.content
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+
+
+

+Jeśli masz wiele dysków i zabrakło Ci liter dysków, możesz zamontować +dyski bezpośrednio w podfolderach. Zobacz: +

+
+
+https://www.google.com/search?q=Windows+mount+point
+
+
+

+W tym momencie jesteś gotowy do uruchomienia polecenia `sync`, aby zbudować +informacje o parzystości. +

+
+
+snapraid sync
+
+
+

+Ten proces może zająć kilka godzin za pierwszym razem, w zależności od rozmiaru +danych już obecnych na dyskach. Jeśli dyski są puste, +proces jest natychmiastowy. +

+Możesz go zatrzymać w dowolnym momencie, naciskając Ctrl+C, a przy następnym +uruchomieniu wznowi się w miejscu, w którym został przerwany. +

+Kiedy to polecenie się zakończy, Twoje dane są BEZPIECZNE. +

+Teraz możesz zacząć używać swojej macierzy, jak chcesz, i okresowo +aktualizować informacje o parzystości, uruchamiając polecenie `sync`. +

4.1 +Scrubbing +

+Aby okresowo sprawdzać dane i parzystość pod kątem błędów, możesz +uruchomić polecenie `scrub`. +

+
+
+snapraid scrub
+
+
+

+To polecenie porównuje dane w Twojej macierzy z haszem obliczonym +podczas polecenia `sync`, aby zweryfikować integralność. +

+Każde uruchomienie polecenia sprawdza około 8% macierzy, z wyłączeniem danych +już sprawdzonych w ciągu poprzednich 10 dni. +Możesz użyć opcji -p, --plan, aby określić inną ilość, +oraz opcji -o, --older-than, aby określić inny wiek w dniach. +Na przykład, aby sprawdzić 5% macierzy dla bloków starszych niż 20 dni, użyj: +

+
+
+snapraid -p 5 -o 20 scrub
+
+
+

+Jeśli podczas procesu zostaną znalezione ciche błędy lub błędy wejścia/wyjścia, +odpowiednie bloki zostaną oznaczone jako złe w pliku `content` +i wymienione w poleceniu `status`. +

+
+
+snapraid status
+
+
+

+Aby je naprawić, możesz użyć polecenia `fix`, filtrując złe bloki +za pomocą opcji -e, --filter-error: +

+
+
+snapraid -e fix
+
+
+

+Przy następnym `scrub`, błędy znikną z raportu `status`, +jeśli zostały faktycznie naprawione. Aby przyspieszyć, możesz użyć -p bad, aby +sprawdzić tylko bloki oznaczone jako złe. +

+
+
+snapraid -p bad scrub
+
+
+

+Uruchomienie `scrub` na niezsynchronizowanej macierzy może zgłosić błędy +spowodowane usuniętymi lub zmodyfikowanymi plikami. Błędy te są zgłaszane +w wyniku `scrub`, ale powiązane bloki nie są oznaczane jako złe. +

4.2 +Pooling +

+Uwaga: Funkcja łączenia w pulę opisana poniżej została zastąpiona przez +narzędzie mergefs, które jest obecnie zalecaną opcją dla użytkowników Linuksa +w społeczności SnapRAID. Mergefs zapewnia bardziej elastyczny i wydajny +sposób łączenia wielu dysków w jeden ujednolicony punkt montowania, +umożliwiając bezproblemowy dostęp do plików w całej macierzy bez polegania +na dowiązaniach symbolicznych. Dobrze integruje się z SnapRAID w celu ochrony +parzystości i jest powszechnie używane w konfiguracjach takich jak +OpenMediaVault (OMV) lub niestandardowe konfiguracje NAS. +

+Aby wszystkie pliki w Twojej macierzy były widoczne w tym samym drzewie katalogów, +możesz włączyć funkcję `pooling`. Tworzy ona wirtualny, tylko do odczytu, +widok wszystkich plików w Twojej macierzy za pomocą dowiązań symbolicznych. +

+Katalog `pooling` możesz skonfigurować w pliku konfiguracyjnym za pomocą: +

+
+
+pool /pool
+
+
+

+lub, jeśli używasz systemu Windows, za pomocą: +

+
+
+pool C:\pool
+
+
+

+a następnie uruchom polecenie `pool`, aby utworzyć lub zaktualizować wirtualny widok. +

+
+
+snapraid pool
+
+
+

+Jeśli używasz platformy Unix i chcesz udostępnić ten katalog +przez sieć maszynom Windows lub Unix, powinieneś dodać +następujące opcje do swojego /etc/samba/smb.conf: +

+
+
+# W sekcji globalnej smb.conf
+unix extensions = no
+
+
+

+
+
+# W sekcji udziału smb.conf
+[pool]
+comment = Pula
+path = /pool
+read only = yes
+guest ok = yes
+wide links = yes
+follow symlinks = yes
+
+
+

+W systemie Windows udostępnianie dowiązań symbolicznych przez sieć wymaga od klientów +zdalnego ich rozwiązywania. Aby to umożliwić, oprócz udostępnienia katalogu puli, +musisz również udostępnić wszystkie dyski niezależnie, używając nazw dysków +zdefiniowanych w pliku konfiguracyjnym jako punkty udostępniania. Musisz również +określić w opcji `share` w pliku konfiguracyjnym ścieżkę UNC Windows, +której klienci zdalni muszą użyć, aby uzyskać dostęp do tych udostępnionych dysków. +

+Na przykład, działając z serwera o nazwie `darkstar`, możesz użyć +opcji: +

+
+
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+pool C:\pool
+share \\darkstar
+
+
+

+i udostępnić w sieci następujące katalogi: +

+
+
+\\darkstar\pool -> C:\pool
+\\darkstar\d1 -> F:\array
+\\darkstar\d2 -> G:\array
+\\darkstar\d3 -> H:\array
+
+
+

+aby umożliwić zdalnym klientom dostęp do wszystkich plików pod adresem \\darkstar\pool. +

+Możesz również potrzebować skonfigurować klientów zdalnych, aby umożliwić dostęp +do zdalnych dowiązań symbolicznych za pomocą polecenia: +

+
+
+fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
+
+
+

4.3 +Undeleting +

+SnapRAID działa bardziej jak program do tworzenia kopii zapasowych niż system RAID +i może być użyty do przywrócenia lub odzyskania usuniętych plików do ich poprzedniego +stanu za pomocą opcji -f, --filter: +

+
+
+snapraid fix -f FILE
+
+
+

+lub dla katalogu: +

+
+
+snapraid fix -f DIR/
+
+
+

+Możesz go również użyć do odzyskania tylko przypadkowo usuniętych plików wewnątrz +katalogu za pomocą opcji -m, --filter-missing, która przywraca +tylko brakujące pliki, pozostawiając wszystkie inne nienaruszone. +

+
+
+snapraid fix -m -f DIR/
+
+
+

+Lub aby odzyskać wszystkie usunięte pliki na wszystkich dyskach za pomocą: +

+
+
+snapraid fix -m
+
+
+

4.4 +Recovering +

+Najgorsze się wydarzyło i straciłeś jeden lub więcej dysków! +

+NIE PANIKUJ! Będziesz w stanie je odzyskać! +

+Pierwszą rzeczą, którą musisz zrobić, to unikać dalszych zmian w Twojej macierzy dysków. +Wyłącz wszelkie zdalne połączenia z nią i wszelkie zaplanowane procesy, w tym +jakąkolwiek zaplanowaną nocną synchronizację lub scrub SnapRAID. +

+Następnie postępuj zgodnie z poniższymi krokami. +

4.4.1 +KROK 1 -> Ponowna konfiguracja +

+Potrzebujesz trochę miejsca do odzyskania, najlepiej na dodatkowych +zapasowych dyskach, ale wystarczy zewnętrzny dysk USB lub dysk zdalny. +

+Zmodyfikuj plik konfiguracyjny SnapRAID, aby opcja `data` lub `parity` +uszkodzonego dysku wskazywała na lokalizację z wystarczającą ilością pustego +miejsca do odzyskania plików. +

+Na przykład, jeśli dysk `d1` uległ awarii, zmień z: +

+
+
+data d1 /mnt/disk1/
+
+
+

+na: +

+
+
+data d1 /mnt/new_spare_disk/
+
+
+

+Jeśli dysk do odzyskania jest dyskiem parzystości, zaktualizuj odpowiednią +opcję `parity`. +Jeśli masz wiele uszkodzonych dysków, zaktualizuj wszystkie ich opcje konfiguracyjne. +

4.4.2 +KROK 2 -> Naprawa +

+Uruchom polecenie fix, zapisując log w pliku zewnętrznym za pomocą: +

+
+
+snapraid -d NAME -l fix.log fix
+
+
+

+Gdzie NAME to nazwa dysku, taka jak `d1` w naszym poprzednim przykładzie. +Jeśli dysk do odzyskania jest dyskiem parzystości, użyj nazw `parity`, `2-parity`, +itp. +Jeśli masz wiele uszkodzonych dysków, użyj wielu opcji -d, aby określić +wszystkie z nich. +

+To polecenie zajmie dużo czasu. +

+Upewnij się, że masz kilka gigabajtów wolnego miejsca na zapisanie pliku fix.log. +Uruchom je z dysku z wystarczającą ilością wolnego miejsca. +

+Teraz odzyskałeś wszystko, co jest możliwe do odzyskania. Jeśli niektóre pliki +są częściowo lub całkowicie nie do odzyskania, zostaną one przemianowane +poprzez dodanie rozszerzenia `.unrecoverable`. +

+Szczegółową listę wszystkich nie do odzyskania bloków znajdziesz w pliku fix.log, +sprawdzając wszystkie linie zaczynające się od `unrecoverable:`. +

+Jeśli nie jesteś zadowolony z odzyskiwania, możesz spróbować ponownie +tyle razy, ile chcesz. +

+Na przykład, jeśli usunąłeś pliki z macierzy po ostatniej +`sync`, może to spowodować, że niektóre pliki nie zostaną odzyskane. +W tym przypadku możesz ponowić próbę `fix` za pomocą opcji -i, --import, +określając, gdzie te pliki znajdują się teraz, aby włączyć je ponownie +do procesu odzyskiwania. +

+Jeśli jesteś zadowolony z odzyskiwania, możesz kontynuować, +ale pamiętaj, że po synchronizacji nie możesz już ponowić próby polecenia `fix`! +

4.4.3 +KROK 3 -> Sprawdzenie +

+Jako ostrożne sprawdzenie, możesz teraz uruchomić polecenie `check`, aby upewnić się, że +wszystko jest poprawne na odzyskanym dysku. +

+
+
+snapraid -d NAME -a check
+
+
+

+Gdzie NAME to nazwa dysku, taka jak `d1` w naszym poprzednim przykładzie. +

+Opcje -d i -a mówią SnapRAID, aby sprawdził tylko określony dysk +i zignorował wszystkie dane parzystości. +

+To polecenie zajmie dużo czasu, ale jeśli nie jesteś zbyt ostrożny, +możesz je pominąć. +

4.4.4 +KROK 4 -> Synchronizacja +

+Uruchom polecenie `sync`, aby ponownie zsynchronizować macierz z nowym dyskiem. +

+
+
+snapraid sync
+
+
+

+Jeśli wszystko zostanie odzyskane, to polecenie jest natychmiastowe. +

5 +Commands +

+SnapRAID udostępnia kilka prostych poleceń, które pozwalają na: + +

+Polecenia muszą być zapisane małymi literami. +

5.1 +status +

+Wyświetla podsumowanie stanu macierzy dysków. +

+Zawiera informacje o fragmentacji parzystości, jak stare +są bloki bez sprawdzenia i wszystkie zarejestrowane ciche +błędy napotkane podczas scrubbingu. +

+Prezentowane informacje odnoszą się do ostatniego momentu, w którym +uruchomiłeś `sync`. Późniejsze modyfikacje nie są brane pod uwagę. +

+Jeśli wykryto złe bloki, ich numery bloków są wymienione. +Aby je naprawić, możesz użyć polecenia `fix -e`. +

+Pokazuje również wykres reprezentujący ostatni raz, kiedy każdy blok +został sprawdzony lub zsynchronizowany. Sprawdzone bloki są pokazane +za pomocą '*', bloki zsynchronizowane, ale jeszcze niesprawdzone, za pomocą 'o'. +

+Nic nie jest modyfikowane. +

5.2 +smart +

+Wyświetla raport SMART wszystkich dysków w systemie. +

+Zawiera oszacowanie prawdopodobieństwa awarii w następnym +roku, co pozwala zaplanować wymianę konserwacyjną dysków, które wykazują +podejrzane atrybuty. +

+To oszacowanie prawdopodobieństwa uzyskuje się poprzez skorelowanie atrybutów SMART +dysków z danymi Backblaze dostępnymi pod adresem: +

+
+
+https://www.backblaze.com/hard-drive-test-data.html
+
+
+

+Jeśli SMART zgłosi, że dysk ulega awarii, dla tego dysku +wyświetlane jest `FAIL` lub `PREFAIL`, a SnapRAID zwraca błąd. +W takim przypadku natychmiastowa wymiana dysku jest wysoce zalecana. +

+Inne możliwe ciągi statusu to: + + + + +
+logfail + +W przeszłości niektóre atrybuty były niższe niż +próg. +
+logerr + +Dziennik błędów urządzenia zawiera błędy. +
+selferr + +Dziennik autotestu urządzenia zawiera błędy. +
+

+Jeśli określono opcję -v, --verbose, dostarczana jest głębsza analiza +statystyczna. Ta analiza może pomóc Ci zdecydować, czy potrzebujesz +więcej czy mniej parzystości. +

+To polecenie używa narzędzia `smartctl` i jest równoważne +uruchomieniu `smartctl -a` na wszystkich urządzeniach. +

+Jeśli Twoje urządzenia nie zostaną poprawnie wykryte automatycznie, możesz określić +niestandardowe polecenie za pomocą opcji `smartctl` w pliku konfiguracyjnym. +

+Nic nie jest modyfikowane. +

5.3 +probe +

+Wyświetla stan ZASILANIA wszystkich dysków w systemie. +

+`Standby` oznacza, że dysk się nie kręci. `Active` oznacza, +że dysk się kręci. +

+To polecenie używa narzędzia `smartctl` i jest równoważne +uruchomieniu `smartctl -n standby -i` na wszystkich urządzeniach. +

+Jeśli Twoje urządzenia nie zostaną poprawnie wykryte automatycznie, możesz określić +niestandardowe polecenie za pomocą opcji `smartctl` w pliku konfiguracyjnym. +

+Nic nie jest modyfikowane. +

5.4 +up +

+Rozpędza wszystkie dyski macierzy. +

+Możesz rozpędzić tylko określone dyski za pomocą opcji -d, --filter-disk. +

+Rozpędzanie wszystkich dysków w tym samym czasie wymaga dużo energii. +Upewnij się, że Twój zasilacz jest w stanie to wytrzymać. +

+Nic nie jest modyfikowane. +

5.5 +down +

+Zatrzymuje wszystkie dyski macierzy. +

+To polecenie używa narzędzia `smartctl` i jest równoważne +uruchomieniu `smartctl -s standby,now` na wszystkich urządzeniach. +

+Możesz zatrzymać tylko określone dyski za pomocą opcji -d, --filter-disk. +

+Aby automatycznie zatrzymać dyski w przypadku błędu, możesz użyć +opcji -s, --spin-down-on-error z dowolnym innym poleceniem, co jest +równoważne ręcznemu uruchomieniu `down`, gdy wystąpi błąd. +

+Nic nie jest modyfikowane. +

5.6 +diff +

+Wyświetla listę wszystkich plików zmodyfikowanych od ostatniej `sync`, które +wymagają ponownego obliczenia danych parzystości. +

+To polecenie nie sprawdza danych pliku, a jedynie znacznik czasu pliku, +rozmiar i inode. +

+Po wyświetleniu listy wszystkich zmienionych plików, prezentowane jest +podsumowanie zmian, pogrupowane według: + + + + + + + + +
+equal + +Pliki niezmienione od wcześniej. +
+added + +Pliki dodane, których wcześniej nie było. +
+removed + +Pliki usunięte. +
+updated + +Pliki o innym rozmiarze lub znaczniku czasu, co oznacza, że +zostały zmodyfikowane. +
+moved + +Pliki przeniesione do innego katalogu na tym samym dysku. +Są one identyfikowane przez tę samą nazwę, rozmiar, znacznik czasu +i inode, ale inny katalog. +
+copied + +Pliki skopiowane na tym samym lub innym dysku. Zauważ, że jeśli +zostały faktycznie przeniesione na inny dysk, zostaną również +policzone w `removed`. +Są one identyfikowane przez tę samą nazwę, rozmiar i +znacznik czasu. Jeśli znacznik czasu z dokładnością do podsekundy wynosi zero, +musi pasować pełna ścieżka, a nie tylko nazwa. +
+restored + +Pliki o innym inode, ale pasującej nazwie, rozmiarze i znaczniku czasu. +Są to zazwyczaj pliki przywrócone po usunięciu. +
+

+Jeśli wymagana jest `sync`, kod powrotu procesu wynosi 2, zamiast +domyślnego 0. Kod powrotu 1 jest używany dla ogólnego stanu błędu. +

+Nic nie jest modyfikowane. +

5.7 +sync +

+Aktualizuje informacje o parzystości. Wszystkie zmodyfikowane pliki +w macierzy dysków są odczytywane, a odpowiednie dane parzystości +są aktualizowane. +

+Możesz zatrzymać ten proces w dowolnym momencie, naciskając Ctrl+C, +bez utraty już wykonanej pracy. +Przy następnym uruchomieniu proces `sync` wznowi się w miejscu, w którym +został przerwany. +

+Jeśli podczas procesu zostaną znalezione ciche błędy lub błędy wejścia/wyjścia, +odpowiednie bloki zostaną oznaczone jako złe. +

+Pliki są identyfikowane po ścieżce i/lub inode i sprawdzane +po rozmiarze i znaczniku czasu. +Jeśli rozmiar pliku lub znacznik czasu się różni, dane parzystości +są ponownie obliczane dla całego pliku. +Jeśli plik zostanie przeniesiony lub zmieniony na tym samym dysku, zachowując ten sam inode, +parzystość nie jest ponownie obliczana. +Jeśli plik zostanie przeniesiony na inny dysk, parzystość jest ponownie obliczana, +ale wcześniej obliczone informacje o haszu są zachowywane. +

+Pliki `content` i `parity` są modyfikowane w razie potrzeby. +Pliki w macierzy NIE są modyfikowane. +

5.8 +scrub +

+Sprawdza macierz, szukając cichych błędów lub błędów wejścia/wyjścia w danych +i dyskach parzystości. +

+Każde wywołanie sprawdza około 8% macierzy, z wyłączeniem +danych już sprawdzonych w ciągu ostatnich 10 dni. +Oznacza to, że sprawdzanie raz w tygodniu zapewnia sprawdzenie każdego bitu danych +przynajmniej raz na trzy miesiące. +

+Możesz zdefiniować inny plan sprawdzania lub ilość za pomocą opcji -p, --plan, +która akceptuje: +bad - Sprawdza bloki oznaczone jako złe. +new - Sprawdza bloki właśnie zsynchronizowane, jeszcze niesprawdzone. +full - Sprawdza wszystko. +0-100 - Sprawdza określony procent bloków. +

+Jeśli określisz wartość procentową, możesz również użyć opcji -o, --older-than, +aby zdefiniować, jak stary powinien być blok. +Najpierw sprawdzane są najstarsze bloki, co zapewnia optymalne sprawdzenie. +Jeśli chcesz sprawdzić tylko bloki właśnie zsynchronizowane, jeszcze niesprawdzone, +użyj opcji `-p new`. +

+Aby uzyskać szczegóły statusu sprawdzania, użyj polecenia `status`. +

+Dla każdego znalezionego cichego błędu lub błędu wejścia/wyjścia, odpowiednie bloki +są oznaczane jako złe w pliku `content`. +Te złe bloki są wymienione w `status` i mogą zostać naprawione za pomocą `fix -e`. +Po naprawie, przy następnym sprawdzeniu, zostaną one ponownie sprawdzone, a jeśli okaże się, +że zostały poprawione, oznaczenie złego zostanie usunięte. +Aby sprawdzić tylko złe bloki, możesz użyć polecenia `scrub -p bad`. +

+Zaleca się uruchamianie `scrub` tylko na zsynchronizowanej macierzy, aby uniknąć +zgłaszania błędów spowodowanych przez niezsynchronizowane dane. Błędy te są rozpoznawane +jako nie będące cichymi błędami, a bloki nie są oznaczane jako złe, +ale takie błędy są zgłaszane w wyniku polecenia. +

+Plik `content` jest modyfikowany w celu zaktualizowania czasu ostatniego sprawdzenia +dla każdego bloku i oznaczenia złych bloków. +Pliki `parity` NIE są modyfikowane. +Pliki w macierzy NIE są modyfikowane. +

5.9 +fix +

+Naprawia wszystkie pliki i dane parzystości. +

+Wszystkie pliki i dane parzystości są porównywane ze stanem migawki +zapisanym w ostatniej `sync`. +Jeśli zostanie znaleziona różnica, jest ona przywracana do zapisanego stanu migawki. +

+OSTRZEŻENIE! Polecenie `fix` nie rozróżnia błędów od +celowych modyfikacji. Bezwarunkowo przywraca stan pliku +do ostatniej `sync`. +

+Jeśli nie określono żadnej innej opcji, przetwarzana jest cała macierz. +Użyj opcji filtra, aby wybrać podzbiór plików lub dysków do operacji. +

+Aby naprawić tylko bloki oznaczone jako złe podczas `sync` i `scrub`, +użyj opcji -e, --filter-error. +W przeciwieństwie do innych opcji filtra, ta stosuje poprawki tylko do plików, które są +niezmienione od ostatniej `sync`. +

+SnapRAID zmienia nazwy wszystkich plików, których nie można naprawić, dodając +rozszerzenie `.unrecoverable`. +

+Przed naprawą, cała macierz jest skanowana w celu znalezienia wszelkich plików przeniesionych +od ostatniej operacji `sync`. +Pliki te są identyfikowane na podstawie ich znacznika czasu, ignorując ich nazwę +i katalog, i są używane w procesie odzyskiwania, jeśli to konieczne. +Jeśli przeniosłeś niektóre z nich poza macierz, możesz użyć opcji -i, --import, +aby określić dodatkowe katalogi do skanowania. +

+Pliki są identyfikowane tylko po ścieżce, a nie po inode. +

+Plik `content` NIE jest modyfikowany. +Pliki `parity` są modyfikowane w razie potrzeby. +Pliki w macierzy są modyfikowane w razie potrzeby. +

5.10 +check +

+Weryfikuje wszystkie pliki i dane parzystości. +

+Działa jak `fix`, ale tylko symuluje odzyskiwanie i żadne zmiany +nie są zapisywane w macierzy. +

+To polecenie jest przeznaczone głównie do ręcznej weryfikacji, +takiej jak po procesie odzyskiwania lub w innych specjalnych warunkach. +Do okresowych i zaplanowanych sprawdzeń użyj `scrub`. +

+Jeśli użyjesz opcji -a, --audit-only, sprawdzane są tylko +dane pliku, a dane parzystości są ignorowane, co zapewnia +szybsze działanie. +

+Pliki są identyfikowane tylko po ścieżce, a nie po inode. +

+Nic nie jest modyfikowane. +

5.11 +list +

+Wyświetla listę wszystkich plików zawartych w macierzy w momencie +ostatniej `sync`. +

+Z -v lub --verbose, wyświetlany jest również czas z dokładnością do podsekundy. +

+Nic nie jest modyfikowane. +

5.12 +dup +

+Wyświetla listę wszystkich zduplikowanych plików. Dwa pliki są uważane za równe, jeśli ich +hasze pasują. Dane pliku nie są odczytywane; używane są tylko +wcześniej obliczone hasze. +

+Nic nie jest modyfikowane. +

5.13 +pool +

+Tworzy lub aktualizuje wirtualny widok wszystkich +plików w Twojej macierzy dysków w katalogu `pooling`. +

+Pliki nie są kopiowane, ale linkowane za pomocą +dowiązań symbolicznych. +

+Podczas aktualizacji, wszystkie istniejące dowiązania symboliczne i puste +podkatalogi są usuwane i zastępowane nowym +widokiem macierzy. Wszelkie inne zwykłe pliki pozostają na swoim miejscu. +

+Nic nie jest modyfikowane poza katalogiem puli. +

5.14 +devices +

+Wyświetla urządzenia niskiego poziomu używane przez macierz. +

+To polecenie wyświetla skojarzenia urządzeń w macierzy +i jest przeznaczone głównie jako interfejs skryptowy. +

+Pierwsze dwie kolumny to identyfikator i ścieżka urządzenia niskiego poziomu. +Następne dwie kolumny to identyfikator i ścieżka urządzenia wysokiego poziomu. +Ostatnia kolumna to nazwa dysku w macierzy. +

+W większości przypadków masz jedno urządzenie niskiego poziomu dla każdego dysku w +macierzy, ale w niektórych bardziej złożonych konfiguracjach możesz mieć wiele +urządzeń niskiego poziomu używanych przez pojedynczy dysk w macierzy. +

+Nic nie jest modyfikowane. +

5.15 +touch +

+Ustawia arbitralny znacznik czasu z dokładnością do podsekundy dla wszystkich plików, +które mają go ustawiony na zero. +

+Poprawia to zdolność SnapRAID do rozpoznawania przeniesionych +i skopiowanych plików, ponieważ sprawia, że znacznik czasu jest prawie unikalny, +redukując możliwe duplikaty. +

+Dokładniej, jeśli znacznik czasu z dokładnością do podsekundy nie jest zerowy, +przeniesiony lub skopiowany plik jest identyfikowany jako taki, jeśli pasuje do +nazwy, rozmiaru i znacznika czasu. Jeśli znacznik czasu z dokładnością do podsekundy +jest zerowy, jest uważany za kopię tylko wtedy, gdy pasują pełna ścieżka, +rozmiar i znacznik czasu. +

+Znacznik czasu z dokładnością do sekundy nie jest modyfikowany, +więc wszystkie daty i czasy Twoich plików zostaną zachowane. +

5.16 +rehash +

+Planuje ponowne haszowanie całej macierzy. +

+To polecenie zmienia używany rodzaj hasza, zazwyczaj podczas aktualizacji +z systemu 32-bitowego na 64-bitowy, aby przełączyć się z +MurmurHash3 na szybszy SpookyHash. +

+Jeśli używasz już optymalnego hasza, to polecenie +nic nie robi i informuje Cię, że nie jest potrzebne żadne działanie. +

+Ponowne haszowanie nie jest wykonywane natychmiast, ale odbywa się +stopniowo podczas `sync` i `scrub`. +

+Możesz sprawdzić stan ponownego haszowania za pomocą `status`. +

+Podczas ponownego haszowania SnapRAID zachowuje pełną funkcjonalność, +z jedynym wyjątkiem, że `dup` nie może wykryć zduplikowanych +plików używających innego hasza. +

6 +Options +

+SnapRAID udostępnia następujące opcje: + + +
+-c, --conf CONFIG +
+Wybiera plik konfiguracyjny do użycia. Jeśli nie określono, w systemie Unix +używa pliku `/usr/local/etc/snapraid.conf`, jeśli istnieje, +w przeciwnym razie `/etc/snapraid.conf`. +W systemie Windows używa pliku `snapraid.conf` w tym samym +katalogu co `snapraid.exe`. +
+ + +
+-f, --filter PATTERN +
+Filtruje pliki do przetworzenia w `check` i `fix`. +Przetwarzane są tylko pliki pasujące do określonego wzorca. +Ta opcja może być używana wielokrotnie. +Zobacz sekcję PATTERN, aby uzyskać więcej szczegółów na temat +specyfikacji wzorców. +W systemie Unix upewnij się, że znaki globbing są cytowane, jeśli są używane. +Ta opcja może być używana tylko z `check` i `fix`. +Nie może być używana z `sync` i `scrub`, ponieważ zawsze +przetwarzają całą macierz. +
+ + +
+-d, --filter-disk NAME +
+Filtruje dyski do przetworzenia w `check`, `fix`, `up` i `down`. +Musisz określić nazwę dysku zdefiniowaną w pliku konfiguracyjnym. +Możesz również określić dyski parzystości za pomocą nazw: `parity`, `2-parity`, +`3-parity`, itp., aby ograniczyć operacje do określonego dysku parzystości. +Jeśli połączysz wiele opcji --filter, --filter-disk i --filter-missing, +wybrane zostaną tylko pliki pasujące do wszystkich filtrów. +Ta opcja może być używana wielokrotnie. +Ta opcja może być używana tylko z `check`, `fix`, `up` i `down`. +Nie może być używana z `sync` i `scrub`, ponieważ zawsze +przetwarzają całą macierz. +
+ + +
+-m, --filter-missing +
+Filtruje pliki do przetworzenia w `check` i `fix`. +Przetwarzane są tylko pliki brakujące lub usunięte z macierzy. +Użyte z `fix`, działa to jako polecenie `undelete`. +Jeśli połączysz wiele opcji --filter, --filter-disk i --filter-missing, +wybrane zostaną tylko pliki pasujące do wszystkich filtrów. +Ta opcja może być używana tylko z `check` i `fix`. +Nie może być używana z `sync` i `scrub`, ponieważ zawsze +przetwarzają całą macierz. +
+ + +
+-e, --filter-error +
+Przetwarza pliki z błędami w `check` i `fix`. +Przetwarza tylko pliki, które mają bloki oznaczone cichymi +błędami lub błędami wejścia/wyjścia podczas `sync` i `scrub`, jak wymieniono w `status`. +Ta opcja może być używana tylko z `check` i `fix`. +
+ + +
+-p, --plan PERC|bad|new|full +
+Wybiera plan sprawdzania. Jeśli PERC jest wartością numeryczną od 0 do 100, +jest interpretowany jako procent bloków do sprawdzenia. +Zamiast wartości procentowej możesz określić plan: +`bad` sprawdza złe bloki, `new` sprawdza bloki jeszcze niesprawdzone, +a `full` sprawdza wszystko. +Ta opcja może być używana tylko z `scrub`. +
+ + +
+-o, --older-than DAYS +
+Wybiera najstarszą część macierzy do przetworzenia w `scrub`. +DAYS to minimalny wiek w dniach dla bloku, który ma być sprawdzony; +domyślnie jest to 10. +Bloki oznaczone jako złe są zawsze sprawdzane niezależnie od tej opcji. +Ta opcja może być używana tylko z `scrub`. +
+ + +
+-a, --audit-only +
+W `check`, weryfikuje hasz plików bez +sprawdzania danych parzystości. +Jeśli interesuje Cię tylko sprawdzenie danych pliku, ta +opcja może znacznie przyspieszyć proces sprawdzania. +Ta opcja może być używana tylko z `check`. +
+ + +
+-h, --pre-hash +
+W `sync`, uruchamia wstępną fazę haszowania wszystkich nowych danych +w celu dodatkowej weryfikacji przed obliczeniem parzystości. +Zazwyczaj w `sync` nie jest wykonywane wstępne haszowanie, a nowe +dane są haszowane tuż przed obliczeniem parzystości, gdy są odczytywane +po raz pierwszy. +Ten proces zachodzi, gdy system jest pod +dużym obciążeniem, wszystkie dyski się kręcą, a CPU jest zajęte. +Jest to ekstremalny warunek dla maszyny, a jeśli ma +ukryty problem sprzętowy, ciche błędy mogą pozostać niewykryte, +ponieważ dane nie są jeszcze haszowane. +Aby uniknąć tego ryzyka, możesz włączyć tryb `pre-hash`, aby +wszystkie dane były odczytywane dwukrotnie w celu zapewnienia ich integralności. +Ta opcja weryfikuje również pliki przeniesione wewnątrz macierzy, +aby upewnić się, że operacja przeniesienia zakończyła się pomyślnie, i, jeśli to konieczne, +umożliwia uruchomienie operacji fix przed kontynuowaniem. +Ta opcja może być używana tylko z `sync`. +
+ + +
+-i, --import DIR +
+Importuje z określonego katalogu wszelkie pliki usunięte +z macierzy po ostatniej `sync`. +Jeśli nadal masz takie pliki, mogą być użyte przez `check` +i `fix`, aby poprawić proces odzyskiwania. +Pliki są odczytywane, w tym w podkatalogach, i są +identyfikowane niezależnie od ich nazwy. +Ta opcja może być używana tylko z `check` i `fix`. +
+ + +
+-s, --spin-down-on-error +
+W przypadku każdego błędu, zatrzymuje wszystkie zarządzane dyski przed wyjściem +z niezerowym kodem statusu. Zapobiega to pozostawaniu dysków +aktywnymi i kręcącymi się po przerwanej operacji, +pomagając uniknąć niepotrzebnego gromadzenia się ciepła i zużycia +energii. Użyj tej opcji, aby upewnić się, że dyski są bezpiecznie +zatrzymane, nawet gdy polecenie zakończy się niepowodzeniem. +
+ + +
+-w, --bw-limit RATE +
+Stosuje globalne ograniczenie przepustowości dla wszystkich dysków. RATE to +liczba bajtów na sekundę. Możesz określić mnożnik, +taki jak K, M lub G (np. --bw-limit 1G). +
+ + +
+-A, --stats +
+Włącza rozszerzony widok statusu, który pokazuje dodatkowe informacje. +Ekran wyświetla dwa wykresy: +Pierwszy wykres pokazuje liczbę buforowanych pasków dla każdego +dysku, wraz ze ścieżką pliku, do którego aktualnie uzyskuje się dostęp +na tym dysku. Zazwyczaj najwolniejszy dysk nie będzie miał dostępnego +bufora, co determinuje maksymalną osiągalną przepustowość. +Drugi wykres pokazuje procent czasu spędzonego na czekaniu +w ciągu ostatnich 100 sekund. Oczekuje się, że najwolniejszy dysk +spowoduje większość czasu oczekiwania, podczas gdy inne dyski powinny mieć +niewielki lub żaden czas oczekiwania, ponieważ mogą używać swoich buforowanych pasków. +Ten wykres pokazuje również czas spędzony na czekaniu na obliczenia +hasza i obliczenia RAID. +Wszystkie obliczenia są wykonywane równolegle z operacjami dyskowymi. +Dlatego, dopóki istnieje mierzalny czas oczekiwania dla +przynajmniej jednego dysku, oznacza to, że CPU jest wystarczająco szybkie, aby +nadążyć za obciążeniem. +
+ + +
+-Z, --force-zero +
+Wymusza niebezpieczną operację synchronizacji pliku o zerowym +rozmiarze, który wcześniej był niezerowy. +Jeśli SnapRAID wykryje taki stan, zatrzymuje przetwarzanie, +chyba że określisz tę opcję. +Pozwala to łatwo wykryć, kiedy po awarii systemu +niektóre dostępne pliki zostały obcięte. +Jest to możliwy stan w systemie Linux z systemami plików ext3/ext4. +Ta opcja może być używana tylko z `sync`. +
+ + +
+-E, --force-empty +
+Wymusza niebezpieczną operację synchronizacji dysku z brakującymi +wszystkimi oryginalnymi plikami. +Jeśli SnapRAID wykryje, że brakuje wszystkich plików pierwotnie obecnych +na dysku lub zostały przepisane, zatrzymuje przetwarzanie, +chyba że określisz tę opcję. +Pozwala to łatwo wykryć, kiedy system plików danych nie jest +zamontowany. +Ta opcja może być używana tylko z `sync`. +
+ + +
+-U, --force-uuid +
+Wymusza niebezpieczną operację synchronizacji, sprawdzania i naprawiania +z dyskami, które zmieniły swój UUID. +Jeśli SnapRAID wykryje, że niektóre dyski zmieniły UUID, +zatrzymuje przetwarzanie, chyba że określisz tę opcję. +Pozwala to wykryć, kiedy Twoje dyski są zamontowane w +niewłaściwych punktach montowania. +Dozwolona jest jednak pojedyncza zmiana UUID z +pojedynczą parzystością i więcej z wielokrotną parzystością, ponieważ jest to +normalny przypadek podczas wymiany dysków po odzyskaniu. +Ta opcja może być używana tylko z `sync`, `check` lub +`fix`. +
+ + +
+-D, --force-device +
+Wymusza niebezpieczną operację naprawiania z niedostępnymi dyskami +lub z dyskami na tym samym urządzeniu fizycznym. +Na przykład, jeśli straciłeś dwa dyski danych i masz zapasowy dysk do odzyskania +tylko pierwszego, możesz zignorować drugi niedostępny dysk. +Lub, jeśli chcesz odzyskać dysk w wolnym miejscu pozostawionym na +już używanym dysku, współdzielącym to samo urządzenie fizyczne. +Ta opcja może być używana tylko z `fix`. +
+ + +
+-N, --force-nocopy +
+W `sync`, `check` i `fix`, wyłącza heurystykę wykrywania kopii. +Bez tej opcji SnapRAID zakłada, że pliki o tych samych +atrybutach, takich jak nazwa, rozmiar i znacznik czasu, są kopiami z tymi +samymi danymi. +Pozwala to na identyfikację skopiowanych lub przeniesionych plików z jednego dysku +na inny i ponowne wykorzystanie już obliczonych informacji o haszu +w celu wykrycia cichych błędów lub odzyskania brakujących plików. +W niektórych rzadkich przypadkach to zachowanie może prowadzić do fałszywych alarmów +lub spowolnienia procesu z powodu wielu weryfikacji hasza, a ta +opcja pozwala rozwiązać takie problemy. +Ta opcja może być używana tylko z `sync`, `check` i `fix`. +
+ + +
+-F, --force-full +
+W `sync`, wymusza pełne ponowne obliczenie parzystości. +Ta opcja może być używana, gdy dodajesz nowy poziom parzystości lub jeśli +powróciłeś do starego pliku zawartości, używając nowszych danych parzystości. +Zamiast ponownego tworzenia parzystości od podstaw, pozwala to +na ponowne wykorzystanie haszy obecnych w pliku zawartości do walidacji danych +i utrzymania ochrony danych podczas procesu `sync` za pomocą +istniejących danych parzystości. +Ta opcja może być używana tylko z `sync`. +
+ + +
+-R, --force-realloc +
+W `sync`, wymusza pełną realokację plików i przebudowę parzystości. +Ta opcja może być używana do całkowitej realokacji wszystkich plików, +usuwając fragmentację, jednocześnie ponownie wykorzystując hasze obecne w pliku zawartości +do walidacji danych. +Ta opcja może być używana tylko z `sync`. +OSTRZEŻENIE! Ta opcja jest tylko dla ekspertów i jest wysoce +zalecane, aby jej nie używać. +NIE MASZ ochrony danych podczas operacji `sync`. +
+ + +
+-l, --log FILE +
+Zapisuje szczegółowy log do określonego pliku. +Jeśli ta opcja nie jest określona, nieoczekiwane błędy są drukowane +na ekranie, potencjalnie prowadząc do nadmiernego wyjścia w przypadku +wielu błędów. Gdy -l, --log jest określone, tylko +krytyczne błędy, które powodują zatrzymanie SnapRAID, są drukowane +na ekranie. +Jeśli ścieżka zaczyna się od '>>', plik jest otwierany +w trybie dołączania. Wystąpienia '%D' i '%T' w nazwie są +zastępowane datą i czasem w formacie RRRRMMDD i +GGMMSS. W plikach wsadowych Windows musisz podwoić +znak '%', np. result-%%D.log. Aby użyć '>>', musisz +ujęć nazwę w cudzysłów, np. `">>result.log"`. +Aby wyprowadzić log do standardowego wyjścia lub standardowego błędu, +możesz użyć odpowiednio `">&1"` i `">&2"`. +Opisy tagów logu znajdziesz w pliku snapraid_log.txt lub na stronie podręcznika. +
+ + +
+-L, --error-limit NUMBER +
+Ustawia nowy limit błędów przed zatrzymaniem wykonania. +Domyślnie SnapRAID zatrzymuje się, jeśli napotka więcej niż 100 +błędów wejścia/wyjścia, co wskazuje, że dysk prawdopodobnie ulega awarii. +Ta opcja dotyczy `sync` i `scrub`, które mogą +kontynuować po pierwszym zestawie błędów dysku, aby spróbować +ukończyć swoje operacje. +Jednak `check` i `fix` zawsze zatrzymują się przy pierwszym błędzie. +
+ + +
+-S, --start BLKSTART +
+Zaczyna przetwarzanie od określonego +numeru bloku. Może to być przydatne do ponownej próby sprawdzenia +lub naprawy określonych bloków w przypadku uszkodzonego dysku. +Ta opcja jest przeznaczona głównie do zaawansowanego ręcznego odzyskiwania. +
+ + +
+-B, --count BLKCOUNT +
+Przetwarza tylko określoną liczbę bloków. +Ta opcja jest przeznaczona głównie do zaawansowanego ręcznego odzyskiwania. +
+ + +
+-C, --gen-conf CONTENT +
+Generuje atrapę pliku konfiguracyjnego z istniejącego +pliku zawartości. +Plik konfiguracyjny jest zapisywany na standardowe wyjście +i nie nadpisuje istniejącego. +Ten plik konfiguracyjny zawiera również informacje +potrzebne do rekonstrukcji punktów montowania dysków na wypadek +utraty całego systemu. +
+ + +
+-v, --verbose +
+Wyświetla więcej informacji na ekranie. +Jeśli określono raz, drukuje wykluczone pliki +i dodatkowe statystyki. +Ta opcja nie ma wpływu na pliki logów. +
+ + +
+-q, --quiet +
+Wyświetla mniej informacji na ekranie. +Jeśli określono raz, usuwa pasek postępu; dwa razy, +bieżące operacje; trzy razy, komunikaty informacyjne; cztery razy, +komunikaty statusu. +Krytyczne błędy są zawsze drukowane na ekranie. +Ta opcja nie ma wpływu na pliki logów. +
+ + +
+-H, --help +
+Wyświetla krótki ekran pomocy. +
+ + +
+-V, --version +
+Wyświetla wersję programu. +
+

7 +Configuration +

+SnapRAID wymaga pliku konfiguracyjnego, aby wiedzieć, gdzie znajduje się Twoja macierz +dysków i gdzie przechowywać informacje o parzystości. +

+W systemie Unix używa pliku `/usr/local/etc/snapraid.conf`, jeśli istnieje, +w przeciwnym razie `/etc/snapraid.conf`. +W systemie Windows używa pliku `snapraid.conf` w tym samym +katalogu co `snapraid.exe`. +

+Musi zawierać następujące opcje (uwzględniające wielkość liter): +

7.1 +parity FILE [,FILE] ... +

+Definiuje pliki do użycia do przechowywania informacji o parzystości. +Parzystość umożliwia ochronę przed awarią pojedynczego dysku, +podobnie jak w RAID5. +

+Możesz określić wiele plików, które muszą znajdować się na różnych dyskach. +Gdy plik nie może już rosnąć, używany jest następny. +Całkowita dostępna przestrzeń musi być co najmniej tak duża jak największy dysk danych w +macierzy. +

+Możesz dodać dodatkowe pliki parzystości później, ale nie możesz +ich zmieniać kolejności ani usuwać. +

+Trzymanie dysków parzystości zarezerwowanych dla parzystości zapewnia, że +nie ulegną fragmentacji, co poprawia wydajność. +

+W systemie Windows 256 MB jest pozostawione niewykorzystane na każdym dysku, aby uniknąć +ostrzeżenia o pełnych dyskach. +

+Ta opcja jest obowiązkowa i może być używana tylko raz. +

7.2 +(2,3,4,5,6)-parity FILE [,FILE] ... +

+Definiuje pliki do użycia do przechowywania dodatkowych informacji o parzystości. +

+Dla każdego określonego poziomu parzystości włączany jest jeden dodatkowy +poziom ochrony: +

+

+Każdy poziom parzystości wymaga obecności wszystkich poprzednich poziomów parzystości. +

+Obowiązują te same uwagi, co dla opcji 'parity'. +

+Te opcje są opcjonalne i mogą być używane tylko raz. +

7.3 +z-parity FILE [,FILE] ... +

+Definiuje alternatywny plik i format do przechowywania potrójnej parzystości. +

+Ta opcja jest alternatywą dla '3-parity', przeznaczoną głównie dla +procesorów niskiej klasy, takich jak ARM lub AMD Phenom, Athlon i Opteron, +które nie obsługują zestawu instrukcji SSSE3. W takich przypadkach zapewnia +lepszą wydajność. +

+Ten format jest podobny, ale szybszy niż ten używany przez ZFS RAIDZ3. +Podobnie jak ZFS, nie działa powyżej potrójnej parzystości. +

+Podczas używania '3-parity' zostaniesz ostrzeżony, jeśli zaleca się użycie +formatu 'z-parity' w celu poprawy wydajności. +

+Możliwa jest konwersja z jednego formatu na inny poprzez dostosowanie +pliku konfiguracyjnego z pożądanym plikiem z-parity lub 3-parity +i użycie 'fix' do jego ponownego utworzenia. +

7.4 +content FILE +

+Definiuje plik do użycia do przechowywania listy i sum kontrolnych wszystkich +plików obecnych w Twojej macierzy dysków. +

+Może być umieszczony na dysku używanym do danych, parzystości lub +każdym innym dostępnym dysku. +Jeśli użyjesz dysku danych, ten plik jest automatycznie wykluczony +z procesu `sync`. +

+Ta opcja jest obowiązkowa i może być używana wielokrotnie do zapisania +wielu kopii tego samego pliku. +

+Musisz przechowywać co najmniej jedną kopię dla każdego używanego dysku parzystości +plus jeden. Używanie dodatkowych kopii nie szkodzi. +

7.5 +data NAME DIR +

+Definiuje nazwę i punkt montowania dysków danych w +macierzy. NAME służy do identyfikacji dysku i musi +być unikalna. DIR to punkt montowania dysku w +systemie plików. +

+Możesz zmieniać punkt montowania w razie potrzeby, o ile +zachowasz stałą nazwę NAME. +

+Powinieneś użyć jednej opcji dla każdego dysku danych w macierzy. +

+Możesz później zmienić nazwę dysku, zmieniając bezpośrednio nazwę NAME +w pliku konfiguracyjnym, a następnie uruchamiając polecenie 'sync'. +W przypadku zmiany nazwy, skojarzenie odbywa się za pomocą zapisanego +UUID dysków. +

7.6 +nohidden +

+Wyklucza wszystkie ukryte pliki i katalogi. +W systemie Unix ukryte pliki to te zaczynające się od `.`. +W systemie Windows są to te z atrybutem ukrycia. +

7.7 +exclude/include PATTERN +

+Definiuje wzorce plików lub katalogów do wykluczenia lub włączenia +do procesu synchronizacji. +Wszystkie wzorce są przetwarzane w określonej kolejności. +

+Jeśli pierwszy pasujący wzorzec jest `exclude`, plik +jest wykluczony. Jeśli jest to `include`, plik jest włączony. +Jeśli żaden wzorzec nie pasuje, plik jest wykluczony, jeśli ostatni określony +wzorzec to `include`, lub włączony, jeśli ostatni określony wzorzec to `exclude`. +

+Zobacz sekcję PATTERN, aby uzyskać więcej szczegółów na temat specyfikacji +wzorców. +

+Ta opcja może być używana wielokrotnie. +

7.8 +blocksize SIZE_IN_KIBIBYTES +

+Definiuje podstawowy rozmiar bloku w kibibajtach dla parzystości. +Jeden kibibajt to 1024 bajty. +

+Domyślny rozmiar bloku to 256, co powinno działać w większości przypadków. +

+OSTRZEŻENIE! Ta opcja jest tylko dla ekspertów i jest wysoce +zalecane, aby nie zmieniać tej wartości. Aby zmienić tę wartość w przyszłości, +będziesz musiał ponownie utworzyć całą parzystość! +

+Powodem użycia innego rozmiaru bloku jest posiadanie wielu małych +plików, rzędu milionów. +

+Dla każdego pliku, nawet jeśli ma tylko kilka bajtów, alokowany jest cały blok parzystości, +a przy wielu plikach może to skutkować znaczną nieużywaną przestrzenią parzystości. +Kiedy całkowicie wypełnisz dysk parzystości, nie możesz +dodawać więcej plików do dysków danych. +Jednak marnowana parzystość nie gromadzi się na dyskach danych. Marnowane miejsce +wynikające z dużej liczby plików na dysku danych ogranicza tylko +ilość danych na tym dysku danych, a nie na innych. +

+Jako przybliżenie, możesz założyć, że połowa rozmiaru bloku jest +marnowana dla każdego pliku. Na przykład, z 100 000 plików i rozmiarem bloku 256 KiB, +zmarnujesz 12,8 GB parzystości, co może skutkować +12,8 GB mniejszą dostępną przestrzenią na dysku danych. +

+Możesz sprawdzić ilość zmarnowanego miejsca na każdym dysku za pomocą `status`. +Jest to ilość miejsca, którą musisz pozostawić wolną na dyskach danych +lub użyć dla plików nie włączonych do macierzy. +Jeśli ta wartość jest ujemna, oznacza to, że jesteś blisko wypełnienia +parzystości i reprezentuje to przestrzeń, którą nadal możesz zmarnować. +

+Aby uniknąć tego problemu, możesz użyć większej partycji dla parzystości. +Na przykład, jeśli partycja parzystości jest o 12,8 GB większa niż dyski danych, +masz wystarczająco dużo dodatkowego miejsca, aby obsłużyć do 100 000 +plików na każdym dysku danych bez marnowania miejsca. +

+Sztuczką, aby uzyskać większą partycję parzystości w systemie Linux, jest sformatowanie jej +za pomocą polecenia: +

+
+
+mkfs.ext4 -m 0 -T largefile4 DEVICE
+
+
+

+Daje to około 1,5% dodatkowego miejsca, około 60 GB dla +dysku 4 TB, co pozwala na około 460 000 plików na każdym dysku danych bez +marnowania miejsca. +

7.9 +hashsize SIZE_IN_BYTES +

+Definiuje rozmiar hasza w bajtach dla zapisanych bloków. +

+Domyślny rozmiar hasza to 16 bajtów (128 bitów), co powinno działać +w większości przypadków. +

+OSTRZEŻENIE! Ta opcja jest tylko dla ekspertów i jest wysoce +zalecane, aby nie zmieniać tej wartości. Aby zmienić tę wartość w przyszłości, +będziesz musiał ponownie utworzyć całą parzystość! +

+Powodem użycia innego rozmiaru hasza jest to, że Twój system ma +ograniczoną pamięć. Z reguły, SnapRAID zwykle wymaga +1 GiB pamięci RAM na każde 16 TB danych w macierzy. +

+Konkretnie, aby przechowywać hasze danych, SnapRAID wymaga +około TS*(1+HS)/BS bajtów pamięci RAM, +gdzie TS to całkowity rozmiar w bajtach Twojej macierzy dysków, BS to +rozmiar bloku w bajtach, a HS to rozmiar hasza w bajtach. +

+Na przykład, z 8 dyskami po 4 TB, rozmiarem bloku 256 KiB +(1 KiB = 1024 bajty) i rozmiarem hasza 16, otrzymujesz: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1,93 GiB
+
+

+Przełączając się na rozmiar hasza 8, otrzymujesz: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1,02 GiB
+
+

+Przełączając się na rozmiar bloku 512, otrzymujesz: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0,96 GiB
+
+

+Przełączając się zarówno na rozmiar hasza 8, jak i rozmiar bloku 512, otrzymujesz: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB
+
+

7.10 +autosave SIZE_IN_GIGABYTES +

+Automatycznie zapisuje stan podczas synchronizacji lub sprawdzania po przetworzeniu +określonej ilości GB. +Ta opcja jest przydatna, aby uniknąć ponownego uruchamiania długich poleceń `sync` +od zera, jeśli zostaną przerwane przez awarię maszyny lub inne zdarzenie. +

7.11 +temp_limit TEMPERATURE_CELSIUS +

+Ustawia maksymalną dozwoloną temperaturę dysku w stopniach Celsjusza. Po określeniu, +SnapRAID okresowo sprawdza temperaturę wszystkich dysków za pomocą +narzędzia smartctl. Aktualne temperatury dysków są wyświetlane podczas +działania SnapRAID. Jeśli którykolwiek dysk przekroczy ten limit, wszystkie operacje +zostają zatrzymane, a dyski są zatrzymywane (przechodzą w stan gotowości) na czas +zdefiniowany przez opcję `temp_sleep`. Po okresie uśpienia, operacje +są wznawiane, potencjalnie ponownie zatrzymując się, jeśli limit temperatury +zostanie ponownie osiągnięty. +

+Podczas działania SnapRAID analizuje również krzywą nagrzewania każdego +dysku i szacuje długoterminową stałą temperaturę, którą mają +osiągnąć, jeśli aktywność będzie kontynuowana. Oszacowanie jest wykonywane tylko po +czterokrotnym wzroście temperatury dysku, co zapewnia, że +dostępnych jest wystarczająco dużo punktów danych do ustalenia wiarygodnego trendu. +Ta przewidywana stała temperatura jest pokazywana w nawiasach obok +aktualnej wartości i pomaga ocenić, czy chłodzenie systemu jest +odpowiednie. Ta szacowana temperatura ma charakter wyłącznie informacyjny +i nie ma wpływu na zachowanie SnapRAID. Działania programu +opierają się wyłącznie na faktycznie zmierzonych temperaturach dysków. +

+Aby wykonać tę analizę, SnapRAID potrzebuje odniesienia dla temperatury systemu. +Najpierw próbuje odczytać ją z dostępnych czujników sprzętowych. +Jeśli nie można uzyskać dostępu do żadnego czujnika systemu, jako awaryjne odniesienie +wykorzystuje najniższą temperaturę dysku zmierzoną na początku uruchomienia. +

+Normalnie SnapRAID pokazuje tylko temperaturę najgorętszego dysku. +Aby wyświetlić temperaturę wszystkich dysków, użyj opcji -A lub --stats. +

7.12 +temp_sleep TIME_IN_MINUTES +

+Ustawia czas gotowości, w minutach, po osiągnięciu limitu temperatury. +W tym okresie dyski pozostają zatrzymane. Domyślnie jest to 5 minut. +

7.13 +pool DIR +

+Definiuje katalog puli, w którym tworzony jest wirtualny widok macierzy +dysków za pomocą polecenia `pool`. +

+Katalog musi już istnieć. +

7.14 +share UNC_DIR +

+Definiuje ścieżkę UNC Windows wymaganą do zdalnego dostępu do dysków. +

+Jeśli ta opcja jest określona, dowiązania symboliczne utworzone w katalogu puli +używają tej ścieżki UNC do dostępu do dysków. +Bez tej opcji generowane dowiązania symboliczne używają tylko ścieżek lokalnych, +co nie pozwala na udostępnianie katalogu puli w sieci. +

+Dowiązania symboliczne są tworzone przy użyciu określonej ścieżki UNC, +dodając nazwę dysku określoną w opcji `data`, a na końcu dodając +katalog i nazwę pliku. +

+Ta opcja jest wymagana tylko dla systemu Windows. +

7.15 +smartctl DISK/PARITY OPTIONS... +

+Definiuje niestandardowe opcje smartctl do uzyskania atrybutów SMART dla +każdego dysku. Może to być wymagane dla kontrolerów RAID i niektórych dysków USB, +których nie można wykryć automatycznie. Symbol zastępczy %s jest zastępowany +nazwą urządzenia, ale jest opcjonalny dla stałych urządzeń, takich jak kontrolery RAID. +

+DISK to ta sama nazwa dysku określona w opcji `data`. +PARITY to jedna z nazw parzystości: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` lub `z-parity`. +

+W określonych OPCJACH ciąg `%s` jest zastępowany +nazwą urządzenia. W przypadku kontrolerów RAID, urządzenie jest +prawdopodobnie stałe i może nie być konieczne użycie `%s`. +

+Zapoznaj się z dokumentacją smartmontools, aby uzyskać możliwe opcje: +

+
+
+https://www.smartmontools.org/wiki/Supported_RAID-Controllers
+https://www.smartmontools.org/wiki/Supported_USB-Devices
+
+
+

+Na przykład: +

+
+
+smartctl parity -d sat %s
+
+
+

7.16 +smartignore DISK/PARITY ATTR [ATTR...] +

+Ignoruje określony atrybut SMART podczas obliczania prawdopodobieństwa +awarii dysku. Ta opcja jest przydatna, jeśli dysk zgłasza nietypowe lub +wprowadzające w błąd wartości dla określonego atrybutu. +

+DISK to ta sama nazwa dysku określona w opcji `data`. +PARITY to jedna z nazw parzystości: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` lub `z-parity`. +Specjalna wartość * może być użyta do zignorowania atrybutu na wszystkich dyskach. +

+Na przykład, aby zignorować atrybut `Current Pending Sector Count` na +wszystkich dyskach: +

+
+
+smartignore * 197
+
+
+

+Aby zignorować go tylko na pierwszym dysku parzystości: +

+
+
+smartignore parity 197
+
+
+

7.17 +Examples +

+Przykład typowej konfiguracji dla systemu Unix: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /mnt/diskp/snapraid.content
+content /var/snapraid/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+exclude /lost+found/
+exclude /tmp/
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/sg0
+smartctl 2-parity -d areca,2/1 /dev/sg0
+
+
+

+Przykład typowej konfiguracji dla systemu Windows: +

+
+
+parity E:\snapraid.parity
+content E:\snapraid.content
+content C:\snapraid\snapraid.content
+data d1 G:\array\
+data d2 H:\array\
+data d3 I:\array\
+exclude Thumbs.db
+exclude \$RECYCLE.BIN
+exclude \System Volume Information
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/arcmsr0
+smartctl 2-parity -d areca,2/1 /dev/arcmsr0
+
+
+

8 +Pattern +

+Wzorce są używane do wybierania podzbioru plików do wykluczenia lub włączenia +do procesu. +

+Istnieją cztery różne typy wzorców: + + +
+FILE +
+Wybiera dowolny plik o nazwie FILE. Możesz użyć dowolnych +znaków globbing, takich jak * i ?, oraz klas znaków, takich jak [a-z]. +Ten wzorzec dotyczy tylko plików, a nie katalogów. +
+ + +
+DIR/ +
+Wybiera dowolny katalog o nazwie DIR i wszystko w środku. +Możesz użyć dowolnych znaków globbing, takich jak * i ?. +Ten wzorzec dotyczy tylko katalogów, a nie plików. +
+ + +
+/PATH/FILE +
+Wybiera dokładnie określoną ścieżkę pliku. Możesz użyć dowolnych +znaków globbing, takich jak * i ?, ale nigdy nie pasują one do +ukośnika katalogu. +Ten wzorzec dotyczy tylko plików, a nie katalogów. +
+ + +
+/PATH/DIR/ +
+Wybiera dokładnie określoną ścieżkę katalogu i wszystko +w środku. Możesz użyć dowolnych znaków globbing, takich jak * i ?, ale +nigdy nie pasują one do ukośnika katalogu. +Ten wzorzec dotyczy tylko katalogów, a nie plików. +
+

+Gdy określisz ścieżkę bezwzględną zaczynającą się od /, jest ona stosowana w +katalogu głównym macierzy, a nie w katalogu głównym lokalnego systemu plików. +

+W systemie Windows możesz użyć ukośnika odwrotnego \ zamiast ukośnika /. +Katalogi systemowe Windows, połączenia, punkty montowania i inne +specjalne katalogi Windows są traktowane jako pliki, co oznacza, że aby je +wykluczyć, musisz użyć reguły pliku, a nie katalogu. +

+Jeśli nazwa pliku zawiera znak '*', '?', '[', +lub ']', musisz go uciec, aby uniknąć interpretacji jako +znaku globbing. W systemie Unix znakiem ucieczki jest '\'; w systemie Windows jest to '^'. +Gdy wzorzec znajduje się w wierszu poleceń, musisz podwoić znak ucieczki, +aby uniknąć interpretacji przez powłokę poleceń. +

+W pliku konfiguracyjnym możesz użyć różnych strategii do filtrowania +plików do przetworzenia. +Najprostszym podejściem jest użycie tylko reguł `exclude`, aby usunąć wszystkie +pliki i katalogi, których nie chcesz przetwarzać. Na przykład: +

+
+
+# Wyklucza dowolny plik o nazwie `*.unrecoverable`
+exclude *.unrecoverable
+# Wyklucza katalog główny `/lost+found`
+exclude /lost+found/
+# Wyklucza dowolny podkatalog o nazwie `tmp`
+exclude tmp/
+
+
+

+Odwrotnym podejściem jest zdefiniowanie tylko plików, które chcesz przetwarzać, +używając tylko reguł `include`. Na przykład: +

+
+
+# Włącza tylko niektóre katalogi
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+Ostatecznym podejściem jest mieszanie reguł `exclude` i `include`. W tym przypadku +kolejność reguł jest ważna. Wcześniejsze reguły mają +pierwszeństwo przed późniejszymi. +Aby uprościć, możesz najpierw wymienić wszystkie reguły `exclude`, a następnie +wszystkie reguły `include`. Na przykład: +

+
+
+# Wyklucza dowolny plik o nazwie `*.unrecoverable`
+exclude *.unrecoverable
+# Wyklucza dowolny podkatalog o nazwie `tmp`
+exclude tmp/
+# Włącza tylko niektóre katalogi
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+W wierszu poleceń, używając opcji -f, możesz użyć tylko wzorców `include`. +Na przykład: +

+
+
+# Sprawdza tylko pliki .mp3.
+# W systemie Unix użyj cudzysłowów, aby uniknąć rozszerzenia globbing przez powłokę.
+snapraid -f "*.mp3" check
+
+
+

+W systemie Unix, używając znaków globbing w wierszu poleceń, musisz +je cytować, aby zapobiec ich rozszerzeniu przez powłokę. +

9 +Content +

+SnapRAID przechowuje listę i sumy kontrolne Twoich plików w pliku zawartości. +

+Jest to plik binarny, który zawiera listę wszystkich plików obecnych w Twojej macierzy dysków, +wraz ze wszystkimi sumami kontrolnymi w celu weryfikacji ich integralności. +

+Ten plik jest odczytywany i zapisywany przez polecenia `sync` i `scrub` +oraz odczytywany przez polecenia `fix`, `check` i `status`. +

10 +Parity +

+SnapRAID przechowuje informacje o parzystości Twojej macierzy w plikach +parzystości. +

+Są to pliki binarne zawierające obliczoną parzystość wszystkich +bloków zdefiniowanych w pliku `content`. +

+Pliki te są odczytywane i zapisywane przez polecenia `sync` i `fix` +oraz tylko odczytywane przez polecenia `scrub` i `check`. +

11 +Encoding +

+SnapRAID w systemie Unix ignoruje wszelkie kodowanie. Odczytuje i przechowuje +nazwy plików z tym samym kodowaniem używanym przez system plików. +

+W systemie Windows wszystkie nazwy odczytane z systemu plików są konwertowane i +przetwarzane w formacie UTF-8. +

+Aby nazwy plików były poprawnie drukowane, musisz ustawić konsolę Windows +na tryb UTF-8 za pomocą polecenia `chcp 65001` i użyć +czcionki TrueType, takiej jak `Lucida Console`, jako czcionki konsoli. +Dotyczy to tylko drukowanych nazw plików; jeśli +przekierujesz wyjście konsoli do pliku, wynikowy plik jest zawsze +w formacie UTF-8. + + + +

+ + + + + + diff --git a/manual-ro.html b/manual-ro.html new file mode 100644 index 00000000..c5a8d86d --- /dev/null +++ b/manual-ro.html @@ -0,0 +1,1989 @@ + + + + + + + + + + + + + +SnapRAID + + + + + + + + + + + + +
+ + + +

+Romanian manual for SnapRAID. +

+ +

1 +Sintaxă +

+
+snapraid [-c, --conf CONFIG]
+    [-f, --filter PATTERN] [-d, --filter-disk NAME]
+    [-m, --filter-missing] [-e, --filter-error]
+    [-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
+    [-p, --plan PERC|bad|new|full]
+    [-o, --older-than DAYS] [-l, --log FILE]
+    [-s, --spin-down-on-error] [-w, --bw-limit RATE]
+    [-Z, --force-zero] [-E, --force-empty]
+    [-U, --force-uuid] [-D, --force-device]
+    [-N, --force-nocopy] [-F, --force-full]
+    [-R, --force-realloc]
+    [-S, --start BLKSTART] [-B, --count BLKCOUNT]
+    [-L, --error-limit NUMBER]
+    [-A, --stats]
+    [-v, --verbose] [-q, --quiet]
+    status|smart|probe|up|down|diff|sync|scrub|fix|check
+    |list|dup|pool|devices|touch|rehash
+
+

+

+snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]
+
+

2 +Descriere +

+SnapRAID este un program de backup conceput pentru matrici de discuri, care stochează +informații de paritate pentru recuperarea datelor în cazul a până la șase +defecte de disc. +

+Destinat în principal centrelor media de acasă cu fișiere mari, +care se schimbă rar, SnapRAID oferă câteva caracteristici: +

+

+Pentru mai multe informații, vă rugăm să vizitați site-ul oficial SnapRAID: +

+
+
+https://www.snapraid.it/
+
+
+

3 +Limitări +

+SnapRAID este un hibrid între un program RAID și unul de backup, care urmărește să combine +cele mai bune beneficii ale ambelor. Cu toate acestea, are unele limitări pe care ar trebui +să le luați în considerare înainte de a-l utiliza. +

+Principala limitare este că, dacă un disc se defectează și nu ați făcut recent o sincronizare, +este posibil să nu puteți recupera complet. +Mai exact, este posibil să nu puteți recupera până la dimensiunea +fișierelor modificate sau șterse de la ultima operațiune de sincronizare. +Acest lucru se întâmplă chiar dacă fișierele modificate sau șterse nu sunt pe +discul defect. Acesta este motivul pentru care SnapRAID este mai potrivit pentru +date care se schimbă rar. +

+Pe de altă parte, fișierele nou adăugate nu împiedică recuperarea fișierelor +deja existente. Veți pierde doar fișierele adăugate recent dacă acestea +se află pe discul defect. +

+Alte limitări ale SnapRAID sunt: +

+

4 +Noțiuni de Bază +

+Pentru a utiliza SnapRAID, trebuie mai întâi să selectați un disc în matricea dvs. de discuri +pentru a-l dedica informațiilor de `paritate`. Cu un singur disc pentru paritate, veți +putea recupera dintr-o singură defecțiune de disc, similar cu RAID5. +

+Dacă doriți să recuperați din mai multe defecțiuni de disc, similar cu RAID6, +trebuie să rezervați discuri suplimentare pentru paritate. Fiecare disc de paritate +suplimentar permite recuperarea dintr-o defecțiune de disc în plus. +

+Ca discuri de paritate, trebuie să le alegeți pe cele mai mari din matrice, +deoarece informațiile de paritate pot crește până la dimensiunea celui mai mare disc de date +din matrice. +

+Aceste discuri vor fi dedicate stocării fișierelor de `paritate`. +Nu ar trebui să stocați datele dvs. pe ele. +

+Apoi, trebuie să definiți discurile de `date` pe care doriți să le protejați +cu SnapRAID. Protecția este mai eficientă dacă aceste discuri +conțin date care se schimbă rar. Din acest motiv, este mai bine să +NU includeți discul C:\ al Windows sau directoarele Unix /home, /var și /tmp. +

+Lista de fișiere este salvată în fișierele de `conținut`, de obicei +stocate pe discurile de date, de paritate sau de boot. +Acest fișier conține detaliile backup-ului dvs., inclusiv toate +sumele de control (checksums) pentru a-i verifica integritatea. +Fișierul de `conținut` este stocat în mai multe copii, iar fiecare copie trebuie +să fie pe un disc diferit pentru a se asigura că, chiar și în cazul a multiple +defecte de disc, cel puțin o copie este disponibilă. +

+De exemplu, să presupunem că sunteți interesați doar de un singur nivel de paritate +de protecție și discurile dvs. se află la: +

+
+
+/mnt/diskp <- discul selectat pentru paritate
+/mnt/disk1 <- primul disc de protejat
+/mnt/disk2 <- al doilea disc de protejat
+/mnt/disk3 <- al treilea disc de protejat
+
+
+

+Trebuie să creați fișierul de configurare /etc/snapraid.conf cu +următoarele opțiuni: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /var/snapraid/snapraid.content
+content /mnt/disk1/snapraid.content
+content /mnt/disk2/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+
+
+

+Dacă sunteți pe Windows, ar trebui să utilizați formatul de cale Windows, cu litere de unitate +și backslash-uri în loc de slash-uri. +

+
+
+parity E:\snapraid.parity
+content C:\snapraid\snapraid.content
+content F:\array\snapraid.content
+content G:\array\snapraid.content
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+
+
+

+Dacă aveți multe discuri și rămâneți fără litere de unitate, puteți monta +discurile direct în subfoldere. Vedeți: +

+
+
+https://www.google.com/search?q=Windows+mount+point
+
+
+

+În acest moment, sunteți gata să rulați comanda `sync` pentru a construi +informațiile de paritate. +

+
+
+snapraid sync
+
+
+

+Acest proces poate dura câteva ore prima dată, în funcție de dimensiunea +datelor deja prezente pe discuri. Dacă discurile sunt goale, +procesul este imediat. +

+Îl puteți opri oricând apăsând Ctrl+C, iar la următoarea rulare, +va relua de unde a fost întrerupt. +

+Când această comandă se finalizează, datele dvs. sunt ÎN SIGURANȚĂ. +

+Acum puteți începe să utilizați matricea după cum doriți și +să actualizați periodic informațiile de paritate rulând comanda `sync`. +

4.1 +Scrubbing (Verificare) +

+Pentru a verifica periodic datele și paritatea pentru erori, puteți +rula comanda `scrub`. +

+
+
+snapraid scrub
+
+
+

+Această comandă compară datele din matricea dvs. cu hash-ul calculat +în timpul comenzii `sync` pentru a verifica integritatea. +

+Fiecare rulare a comenzii verifică aproximativ 8% din matrice, excluzând datele +deja verificate în ultimele 10 zile. +Puteți utiliza opțiunea -p, --plan pentru a specifica o cantitate diferită +și opțiunea -o, --older-than pentru a specifica o vârstă diferită în zile. +De exemplu, pentru a verifica 5% din matrice pentru blocuri mai vechi de 20 de zile, utilizați: +

+
+
+snapraid -p 5 -o 20 scrub
+
+
+

+Dacă se găsesc erori silențioase sau de intrare/ieșire în timpul procesului, +blocurile corespunzătoare sunt marcate ca fiind defecte în fișierul de `conținut` +și listate în comanda `status`. +

+
+
+snapraid status
+
+
+

+Pentru a le repara, puteți utiliza comanda `fix`, filtrând pentru blocuri defecte cu +opțiunea -e, --filter-error: +

+
+
+snapraid -e fix
+
+
+

+La următorul `scrub`, erorile vor dispărea din raportul `status` +dacă sunt într-adevăr reparate. Pentru a face mai rapid, puteți utiliza -p bad pentru a verifica +doar blocurile marcate ca defecte. +

+
+
+snapraid -p bad scrub
+
+
+

+Rularea `scrub` pe o matrice nesincronizată poate raporta erori cauzate de +fișiere eliminate sau modificate. Aceste erori sunt raportate în ieșirea `scrub`, +dar blocurile aferente nu sunt marcate ca defecte. +

4.2 +Pooling (Agregare) +

+Notă: Funcționalitatea de pooling descrisă mai jos a fost înlocuită de instrumentul +mergefs, care este acum opțiunea recomandată pentru utilizatorii Linux în +comunitatea SnapRAID. Mergefs oferă o modalitate mai flexibilă și eficientă +de a agrega mai multe discuri într-un singur punct de montare unificat, +permițând accesul neîntrerupt la fișiere pe toată matricea dvs. fără a se baza +pe link-uri simbolice. Se integrează bine cu SnapRAID pentru protecția parității +și este utilizat în mod obișnuit în configurații precum OpenMediaVault (OMV) +sau configurații NAS personalizate. +

+Pentru a avea toate fișierele din matricea dvs. afișate în același arbore de directoare, +puteți activa funcționalitatea de `pooling`. Aceasta creează o vizualizare virtuală +doar în citire a tuturor fișierelor din matricea dvs. folosind link-uri simbolice. +

+Puteți configura directorul de `pooling` în fișierul de configurare cu: +

+
+
+pool /pool
+
+
+

+sau, dacă sunteți pe Windows, cu: +

+
+
+pool C:\pool
+
+
+

+și apoi rulați comanda `pool` pentru a crea sau actualiza vizualizarea virtuală. +

+
+
+snapraid pool
+
+
+

+Dacă utilizați o platformă Unix și doriți să partajați acest director +peste rețea către mașini Windows sau Unix, ar trebui să adăugați +următoarele opțiuni la /etc/samba/smb.conf: +

+
+
+# În secțiunea global a smb.conf
+unix extensions = no
+
+
+

+
+
+# În secțiunea share a smb.conf
+[pool]
+comment = Pool
+path = /pool
+read only = yes
+guest ok = yes
+wide links = yes
+follow symlinks = yes
+
+
+

+În Windows, partajarea link-urilor simbolice peste o rețea necesită ca clienții să +le rezolve de la distanță. Pentru a permite acest lucru, pe lângă partajarea directorului pool, +trebuie să partajați și toate discurile în mod independent, folosind numele discurilor +definite în fișierul de configurare ca puncte de partajare. De asemenea, trebuie să specificați +în opțiunea `share` din fișierul de configurare calea UNC Windows pe care +clienții la distanță trebuie să o folosească pentru a accesa aceste discuri partajate. +

+De exemplu, operând de pe un server numit `darkstar`, puteți utiliza +opțiunile: +

+
+
+data d1 F:\array\
+data d2 G:\array\
+data d3 H:\array\
+pool C:\pool
+share \\darkstar
+
+
+

+și partajați următoarele directoare peste rețea: +

+
+
+\\darkstar\pool -> C:\pool
+\\darkstar\d1 -> F:\array
+\\darkstar\d2 -> G:\array
+\\darkstar\d3 -> H:\array
+
+
+

+pentru a permite clienților la distanță să acceseze toate fișierele la \\darkstar\pool. +

+De asemenea, ar putea fi necesar să configurați clienții la distanță pentru a permite accesul la symlink-uri la distanță cu comanda: +

+
+
+fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1
+
+
+

4.3 +Undeleting (Anulare Ștergere) +

+SnapRAID funcționează mai mult ca un program de backup decât un sistem RAID și poate +fi folosit pentru a restaura sau anula ștergerea fișierelor la starea lor anterioară utilizând +opțiunea -f, --filter: +

+
+
+snapraid fix -f FILE
+
+
+

+sau pentru un director: +

+
+
+snapraid fix -f DIR/
+
+
+

+De asemenea, îl puteți utiliza pentru a recupera doar fișiere șterse accidental în interiorul +unui director folosind opțiunea -m, --filter-missing, care restaurează +doar fișierele lipsă, lăsându-le pe toate celelalte neatinse. +

+
+
+snapraid fix -m -f DIR/
+
+
+

+Sau pentru a recupera toate fișierele șterse de pe toate unitățile cu: +

+
+
+snapraid fix -m
+
+
+

4.4 +Recuperare +

+Cel mai rău s-a întâmplat și ați pierdut unul sau mai multe discuri! +

+NU INTRAȚI ÎN PANICĂ! Veți putea să le recuperați! +

+Primul lucru pe care trebuie să-l faceți este să evitați modificările ulterioare la matricea dvs. de discuri. +Dezactivați orice conexiuni la distanță la aceasta și orice procese programate, inclusiv +orice sincronizare sau verificare SnapRAID programată pe timp de noapte. +

+Apoi continuați cu următorii pași. +

4.4.1 +PASUL 1 -> Reconfigurare +

+Aveți nevoie de spațiu pentru a recupera, ideal pe discuri de rezervă +suplimentare, dar un disc USB extern sau un disc la distanță vor fi suficiente. +

+Modificați fișierul de configurare SnapRAID pentru a face ca opțiunea `data` sau `parity` +a discului defect să indice o locație cu suficient spațiu gol +pentru a recupera fișierele. +

+De exemplu, dacă discul `d1` a eșuat, schimbați de la: +

+
+
+data d1 /mnt/disk1/
+
+
+

+la: +

+
+
+data d1 /mnt/new_spare_disk/
+
+
+

+Dacă discul de recuperat este un disc de paritate, actualizați opțiunea `parity` +corespunzătoare. +Dacă aveți mai multe discuri defecte, actualizați toate opțiunile lor de configurare. +

4.4.2 +PASUL 2 -> Reparare (Fix) +

+Rulați comanda fix, stocând jurnalul într-un fișier extern cu: +

+
+
+snapraid -d NAME -l fix.log fix
+
+
+

+Unde NAME este numele discului, cum ar fi `d1` în exemplul nostru anterior. +Dacă discul de recuperat este un disc de paritate, utilizați numele `parity`, `2-parity`, +etc. +Dacă aveți mai multe discuri defecte, utilizați mai multe opțiuni -d pentru a le specifica pe toate. +

+Această comandă va dura mult timp. +

+Asigurați-vă că aveți câțiva gigabytes liberi pentru a stoca fișierul fix.log. +Rulați-l de pe un disc cu suficient spațiu liber. +

+Acum ați recuperat tot ce este recuperabil. Dacă unele fișiere sunt parțial +sau total nerecuperabile, vor fi redenumite adăugând extensia `.unrecoverable`. +

+Puteți găsi o listă detaliată a tuturor blocurilor nerecuperabile în fișierul fix.log +verificând toate liniile care încep cu `unrecoverable:`. +

+Dacă nu sunteți mulțumit de recuperare, o puteți reîncerca de câte +ori doriți. +

+De exemplu, dacă ați eliminat fișiere din matrice după ultima +`sync`, acest lucru poate duce la nerecuperarea unor fișiere. +În acest caz, puteți reîncerca `fix`-ul utilizând opțiunea -i, --import, +specificând unde se află acum aceste fișiere pentru a le include din nou în +procesul de recuperare. +

+Dacă sunteți mulțumit de recuperare, puteți continua, +dar rețineți că după sincronizare, nu mai puteți reîncerca comanda `fix` +deloc! +

4.4.3 +PASUL 3 -> Verificare (Check) +

+Ca o verificare prudentă, puteți rula acum o comandă `check` pentru a vă asigura că +totul este corect pe discul recuperat. +

+
+
+snapraid -d NAME -a check
+
+
+

+Unde NAME este numele discului, cum ar fi `d1` în exemplul nostru anterior. +

+Opțiunile -d și -a spun SnapRAID să verifice doar discul specificat +și să ignore toate datele de paritate. +

+Această comandă va dura mult timp, dar dacă nu sunteți excesiv de prudent, +o puteți sări. +

4.4.4 +PASUL 4 -> Sincronizare (Sync) +

+Rulați comanda `sync` pentru a resincroniza matricea cu noul disc. +

+
+
+snapraid sync
+
+
+

+Dacă totul este recuperat, această comandă este imediată. +

5 +Comenzi +

+SnapRAID oferă câteva comenzi simple care vă permit să: + +

+Comenzile trebuie scrise cu litere mici. +

5.1 +status +

+Tipărește un rezumat al stării matricei de discuri. +

+Include informații despre fragmentarea parității, cât de vechi +sunt blocurile fără verificare și toate erorile silențioase înregistrate +întâlnite în timpul verificării (scrubbing). +

+Informațiile prezentate se referă la ultima dată când ați +rulat `sync`. Modificările ulterioare nu sunt luate în considerare. +

+Dacă au fost detectate blocuri defecte, numerele lor de bloc sunt listate. +Pentru a le repara, puteți utiliza comanda `fix -e`. +

+De asemenea, arată un grafic care reprezintă ultima dată când fiecare bloc +a fost verificat (scrubbed) sau sincronizat. Blocurile verificate sunt afișate cu '*', +blocurile sincronizate, dar încă neverificate, cu 'o'. +

+Nimic nu este modificat. +

5.2 +smart +

+Tipărește un raport SMART al tuturor discurilor din sistem. +

+Include o estimare a probabilității de eșec în anul următor, +permițându-vă să planificați înlocuiri de întreținere a discurilor care prezintă +atribute suspecte. +

+Această estimare a probabilității este obținută prin corelarea atributelor SMART +ale discurilor cu datele Backblaze disponibile la: +

+
+
+https://www.backblaze.com/hard-drive-test-data.html
+
+
+

+Dacă SMART raportează că un disc este pe cale să eșueze, `FAIL` sau `PREFAIL` este tipărit +pentru acel disc, iar SnapRAID returnează o eroare. +În acest caz, înlocuirea imediată a discului este puternic recomandată. +

+Alte șiruri de stare posibile sunt: + + + + +
+logfail + +În trecut, unele atribute au fost mai mici decât +pragul. +
+logerr + +Jurnalul de erori al dispozitivului conține erori. +
+selferr + +Jurnalul de auto-test al dispozitivului conține erori. +
+

+Dacă opțiunea -v, --verbose este specificată, este furnizată o analiză statistică +mai profundă. Această analiză vă poate ajuta să decideți dacă aveți nevoie de mai multă +sau mai puțină paritate. +

+Această comandă utilizează instrumentul `smartctl` și este echivalentă cu rularea +`smartctl -a` pe toate dispozitivele. +

+Dacă dispozitivele dvs. nu sunt detectate automat corect, puteți specifica +o comandă personalizată utilizând opțiunea `smartctl` în fișierul de configurare. +

+Nimic nu este modificat. +

5.3 +probe +

+Tipărește starea de ALIMENTARE (POWER) a tuturor discurilor din sistem. +

+`Standby` înseamnă că discul nu se rotește. `Active` înseamnă +că discul se rotește. +

+Această comandă utilizează instrumentul `smartctl` și este echivalentă cu rularea +`smartctl -n standby -i` pe toate dispozitivele. +

+Dacă dispozitivele dvs. nu sunt detectate automat corect, puteți specifica +o comandă personalizată utilizând opțiunea `smartctl` în fișierul de configurare. +

+Nimic nu este modificat. +

5.4 +up +

+Pornirea tuturor discurilor din matrice. +

+Puteți porni doar discuri specifice utilizând opțiunea -d, --filter-disk. +

+Pornirea tuturor discurilor în același timp necesită multă energie. +Asigurați-vă că sursa dvs. de alimentare o poate susține. +

+Nimic nu este modificat. +

5.5 +down +

+Oprirea (spin down) tuturor discurilor din matrice. +

+Această comandă utilizează instrumentul `smartctl` și este echivalentă cu rularea +`smartctl -s standby,now` pe toate dispozitivele. +

+Puteți opri doar discuri specifice utilizând opțiunea -d, --filter-disk. +

+Pentru a opri automat la eroare, puteți utiliza opțiunea -s, --spin-down-on-error +cu orice altă comandă, care este echivalentă cu rularea manuală a `down` +atunci când apare o eroare. +

+Nimic nu este modificat. +

5.6 +diff +

+Listează toate fișierele modificate de la ultima `sync` care trebuie +să li se recalculeze datele de paritate. +

+Această comandă nu verifică datele fișierului, ci doar marca temporală, +dimensiunea și inodul fișierului. +

+După listarea tuturor fișierelor modificate, este prezentat un rezumat al modificărilor, +grupate după: + + + + + + + + +
+equal + +Fișiere neschimbate față de înainte. +
+added + +Fișiere adăugate care nu erau prezente înainte. +
+removed + +Fișiere eliminate. +
+updated + +Fișiere cu o dimensiune sau marcă temporală diferită, ceea ce înseamnă că au +fost modificate. +
+moved + +Fișiere mutate într-un director diferit pe același disc. +Sunt identificate având același nume, dimensiune, marcă temporală +și inod, dar un director diferit. +
+copied + +Fișiere copiate pe același disc sau pe un disc diferit. Rețineți că dacă +sunt mutate cu adevărat pe un alt disc, vor fi, de asemenea, +numărate în `removed`. +Sunt identificate având același nume, dimensiune și +marcă temporală. Dacă marca temporală sub-secundă este zero, +întreaga cale trebuie să se potrivească, nu doar numele. +
+restored + +Fișiere cu un inod diferit, dar nume, dimensiune și marcă temporală care se potrivesc. +Acestea sunt de obicei fișiere restaurate după ce au fost șterse. +
+

+Dacă este necesară o `sync`, codul de retur al procesului este 2, în loc de +cel implicit 0. Codul de retur 1 este utilizat pentru o condiție de eroare generică. +

+Nimic nu este modificat. +

5.7 +sync +

+Actualizează informațiile de paritate. Toate fișierele modificate +din matricea de discuri sunt citite și datele de paritate +corespunzătoare sunt actualizate. +

+Puteți opri acest proces în orice moment apăsând Ctrl+C, +fără a pierde munca deja efectuată. +La următoarea rulare, procesul `sync` va relua de unde +a fost întrerupt. +

+Dacă se găsesc erori silențioase sau de intrare/ieșire în timpul procesului, +blocurile corespunzătoare sunt marcate ca defecte. +

+Fișierele sunt identificate prin cale și/sau inod și verificate prin +dimensiune și marcă temporală. +Dacă dimensiunea sau marca temporală a fișierului diferă, datele de paritate +sunt recalculate pentru întregul fișier. +Dacă fișierul este mutat sau redenumit pe același disc, păstrând același +inod, paritatea nu este recalculată. +Dacă fișierul este mutat pe un alt disc, paritatea este recalculată, +dar informațiile hash calculate anterior sunt păstrate. +

+Fișierele de `content` și `parity` sunt modificate dacă este necesar. +Fișierele din matrice NU sunt modificate. +

5.8 +scrub +

+Verifică (scrubs) matricea, căutând erori silențioase sau de intrare/ieșire în discurile +de date și de paritate. +

+Fiecare invocare verifică aproximativ 8% din matrice, excluzând +datele deja verificate în ultimele 10 zile. +Acest lucru înseamnă că verificarea o dată pe săptămână asigură că fiecare bit de date este verificat +cel puțin o dată la trei luni. +

+Puteți defini un plan de verificare sau o cantitate diferită utilizând opțiunea -p, --plan, +care acceptă: +bad - Verifică blocurile marcate ca defecte. +new - Verifică blocurile tocmai sincronizate care nu au fost încă verificate. +full - Verifică totul. +0-100 - Verifică procentul specificat de blocuri. +

+Dacă specificați o valoare procentuală, puteți utiliza și opțiunea -o, --older-than +pentru a defini cât de vechi ar trebui să fie blocul. +Cele mai vechi blocuri sunt verificate primele, asigurând o verificare optimă. +Dacă doriți să verificați doar blocurile tocmai sincronizate care nu au fost încă verificate, +utilizați opțiunea `-p new`. +

+Pentru a obține detalii despre starea verificării, utilizați comanda `status`. +

+Pentru orice eroare silențioasă sau de intrare/ieșire găsită, blocurile corespunzătoare +sunt marcate ca defecte în fișierul de `content`. +Aceste blocuri defecte sunt listate în `status` și pot fi reparate cu `fix -e`. +După reparare, la următorul scrub, vor fi reverificate, iar dacă se găsesc +corectate, marca defectă va fi eliminată. +Pentru a verifica doar blocurile defecte, puteți utiliza comanda `scrub -p bad`. +

+Este recomandat să rulați `scrub` doar pe o matrice sincronizată pentru a evita +erorile raportate cauzate de date nesincronizate. Aceste erori sunt recunoscute +ca nefiind erori silențioase, iar blocurile nu sunt marcate ca defecte, +dar astfel de erori sunt raportate în ieșirea comenzii. +

+Fișierul de `content` este modificat pentru a actualiza ora ultimei verificări +pentru fiecare bloc și pentru a marca blocurile defecte. +Fișierele de `parity` NU sunt modificate. +Fișierele din matrice NU sunt modificate. +

5.9 +fix +

+Repară toate fișierele și datele de paritate. +

+Toate fișierele și datele de paritate sunt comparate cu starea snapshot-ului +salvată la ultima `sync`. +Dacă se găsește o diferență, este readusă la snapshot-ul stocat. +

+ATENȚIE! Comanda `fix` nu face diferența între erori și +modificări intenționate. Ea revine necondiționat la starea fișierului +de la ultima `sync`. +

+Dacă nu este specificată nicio altă opțiune, întreaga matrice este procesată. +Utilizați opțiunile de filtrare pentru a selecta un subset de fișiere sau discuri de operat. +

+Pentru a repara doar blocurile marcate ca defecte în timpul `sync` și `scrub`, +utilizați opțiunea -e, --filter-error. +Spre deosebire de alte opțiuni de filtrare, aceasta aplică reparații doar fișierelor care sunt +neschimbate de la ultima `sync`. +

+SnapRAID redenumește toate fișierele care nu pot fi reparate adăugând extensia +`.unrecoverable`. +

+Înainte de reparare, întreaga matrice este scanată pentru a găsi orice fișiere mutate +de la ultima operațiune `sync`. +Aceste fișiere sunt identificate prin marca lor temporală, ignorând numele +și directorul lor și sunt utilizate în procesul de recuperare dacă este necesar. +Dacă ați mutat unele dintre ele în afara matricei, puteți utiliza opțiunea -i, --import +pentru a specifica directoare suplimentare de scanat. +

+Fișierele sunt identificate doar prin cale, nu prin inod. +

+Fișierul de `content` NU este modificat. +Fișierele de `parity` sunt modificate dacă este necesar. +Fișierele din matrice sunt modificate dacă este necesar. +

5.10 +check +

+Verifică toate fișierele și datele de paritate. +

+Funcționează ca `fix`, dar simulează doar o recuperare și nu sunt scrise modificări +în matrice. +

+Această comandă este destinată în primul rând verificării manuale, +cum ar fi după un proces de recuperare sau în alte condiții speciale. +Pentru verificări periodice și programate, utilizați `scrub`. +

+Dacă utilizați opțiunea -a, --audit-only, doar datele fișierului +sunt verificate, iar datele de paritate sunt ignorate pentru o +rulare mai rapidă. +

+Fișierele sunt identificate doar prin cale, nu prin inod. +

+Nimic nu este modificat. +

5.11 +list +

+Listează toate fișierele conținute în matrice la momentul +ultimei `sync`. +

+Cu -v sau --verbose, este afișat și timpul sub-secundă. +

+Nimic nu este modificat. +

5.12 +dup +

+Listează toate fișierele duplicate. Două fișiere sunt considerate egale dacă hash-urile +lor se potrivesc. Datele fișierului nu sunt citite; sunt utilizate doar +hash-urile precalculate. +

+Nimic nu este modificat. +

5.13 +pool +

+Creează sau actualizează o vizualizare virtuală a tuturor +fișierelor din matricea dvs. de discuri în directorul de `pooling`. +

+Fișierele nu sunt copiate, ci legate folosind +link-uri simbolice. +

+La actualizare, toate link-urile simbolice existente și subdirectoarele goale +sunt șterse și înlocuite cu noua +vizualizare a matricei. Orice alte fișiere obișnuite sunt lăsate pe loc. +

+Nimic nu este modificat în afara directorului pool. +

5.14 +devices +

+Tipărește dispozitivele de nivel scăzut utilizate de matrice. +

+Această comandă afișează asocierile de dispozitive din matrice +și este destinată în principal ca interfață de script. +

+Primele două coloane sunt ID-ul și calea dispozitivului de nivel scăzut. +Următoarele două coloane sunt ID-ul și calea dispozitivului de nivel înalt. +Ultima coloană este numele discului din matrice. +

+În majoritatea cazurilor, aveți un dispozitiv de nivel scăzut pentru fiecare disc din +matrice, dar în unele configurații mai complexe, puteți avea mai multe +dispozitive de nivel scăzut utilizate de un singur disc din matrice. +

+Nimic nu este modificat. +

5.15 +touch +

+Setează o marcă temporală arbitrară sub-secundă pentru toate fișierele +care o au setată la zero. +

+Acest lucru îmbunătățește capacitatea SnapRAID de a recunoaște fișierele mutate +și copiate, deoarece face ca marca temporală să fie aproape unică, +reducând posibilele duplicate. +

+Mai exact, dacă marca temporală sub-secundă nu este zero, +un fișier mutat sau copiat este identificat ca atare dacă se potrivește +cu numele, dimensiunea și marca temporală. Dacă marca temporală sub-secundă +este zero, este considerat o copie doar dacă calea completă, +dimensiunea și marca temporală se potrivesc toate. +

+Marca temporală cu precizie de secundă nu este modificată, +deci toate datele și orele fișierelor dvs. vor fi păstrate. +

5.16 +rehash +

+Programează o rehash-uire a întregii matrici. +

+Această comandă schimbă tipul de hash utilizat, de obicei la actualizarea +de la un sistem pe 32 de biți la unul pe 64 de biți, pentru a trece de la +MurmurHash3 la SpookyHash, care este mai rapid. +

+Dacă utilizați deja hash-ul optim, această comandă +nu face nimic și vă informează că nu este necesară nicio acțiune. +

+Rehash-ul nu este efectuat imediat, ci are loc +progresiv în timpul `sync` și `scrub`. +

+Puteți verifica starea rehash-ului utilizând `status`. +

+În timpul rehash-ului, SnapRAID își menține funcționalitatea completă, +cu singura excepție că `dup` nu poate detecta fișierele duplicate +folosind un hash diferit. +

6 +Opțiuni +

+SnapRAID oferă următoarele opțiuni: + + +
+-c, --conf CONFIG +
+Selectează fișierul de configurare de utilizat. Dacă nu este specificat, în Unix +utilizează fișierul `/usr/local/etc/snapraid.conf` dacă există, +altfel `/etc/snapraid.conf`. +În Windows, utilizează fișierul `snapraid.conf` din același +director ca `snapraid.exe`. +
+ + +
+-f, --filter PATTERN +
+Filtrează fișierele de procesat în `check` și `fix`. +Sunt procesate doar fișierele care se potrivesc cu modelul specificat. +Această opțiune poate fi utilizată de mai multe ori. +Vedeți secțiunea PATTERN pentru mai multe detalii despre +specificațiile modelului. +În Unix, asigurați-vă că caracterele globbing sunt citate dacă sunt utilizate. +Această opțiune poate fi utilizată doar cu `check` și `fix`. +Nu poate fi utilizată cu `sync` și `scrub`, deoarece acestea +procesează întotdeauna întreaga matrice. +
+ + +
+-d, --filter-disk NAME +
+Filtrează discurile de procesat în `check`, `fix`, `up` și `down`. +Trebuie să specificați un nume de disc așa cum este definit în fișierul de configurare. +Puteți specifica și discurile de paritate cu numele: `parity`, `2-parity`, +`3-parity`, etc., pentru a limita operațiunile la un anumit disc de paritate. +Dacă combinați mai multe opțiuni --filter, --filter-disk și --filter-missing, +sunt selectate doar fișierele care se potrivesc cu toate filtrele. +Această opțiune poate fi utilizată de mai multe ori. +Această opțiune poate fi utilizată doar cu `check`, `fix`, `up` și `down`. +Nu poate fi utilizată cu `sync` și `scrub`, deoarece acestea +procesează întotdeauna întreaga matrice. +
+ + +
+-m, --filter-missing +
+Filtrează fișierele de procesat în `check` și `fix`. +Sunt procesate doar fișierele lipsă sau șterse din matrice. +Când este utilizată cu `fix`, aceasta acționează ca o comandă de `undelete` (anulare ștergere). +Dacă combinați mai multe opțiuni --filter, --filter-disk și --filter-missing, +sunt selectate doar fișierele care se potrivesc cu toate filtrele. +Această opțiune poate fi utilizată doar cu `check` și `fix`. +Nu poate fi utilizată cu `sync` și `scrub`, deoarece acestea +procesează întotdeauna întreaga matrice. +
+ + +
+-e, --filter-error +
+Procesează fișierele cu erori în `check` și `fix`. +Procesează doar fișierele care au blocuri marcate cu erori silențioase +sau de intrare/ieșire în timpul `sync` și `scrub`, așa cum sunt listate în `status`. +Această opțiune poate fi utilizată doar cu `check` și `fix`. +
+ + +
+-p, --plan PERC|bad|new|full +
+Selectează planul de verificare (scrub). Dacă PERC este o valoare numerică de la 0 la 100, +este interpretată ca procentul de blocuri de verificat. +În loc de un procent, puteți specifica un plan: +`bad` verifică blocurile defecte, `new` verifică blocurile care nu au fost încă verificate, +iar `full` verifică totul. +Această opțiune poate fi utilizată doar cu `scrub`. +
+ + +
+-o, --older-than DAYS +
+Selectează cea mai veche parte a matricei de procesat în `scrub`. +DAYS este vârsta minimă în zile pentru ca un bloc să fie verificat; +valoarea implicită este 10. +Blocurile marcate ca defecte sunt întotdeauna verificate, indiferent de această opțiune. +Această opțiune poate fi utilizată doar cu `scrub`. +
+ + +
+-a, --audit-only +
+În `check`, verifică hash-ul fișierelor fără +a verifica datele de paritate. +Dacă sunteți interesați doar de verificarea datelor fișierului, această +opțiune poate accelera semnificativ procesul de verificare. +Această opțiune poate fi utilizată doar cu `check`. +
+ + +
+-h, --pre-hash +
+În `sync`, rulează o fază preliminară de hashing a tuturor datelor noi +pentru o verificare suplimentară înainte de calculul parității. +De obicei, în `sync`, nu se face hashing preliminar, iar datele noi +sunt hash-uite chiar înainte de calculul parității, atunci când sunt citite +pentru prima dată. +Acest proces are loc atunci când sistemul este sub +încărcare mare, cu toate discurile rotindu-se și un CPU ocupat. +Aceasta este o condiție extremă pentru mașină și, dacă are o +problemă hardware latentă, erorile silențioase pot trece nedetectate +deoarece datele nu sunt încă hash-uite. +Pentru a evita acest risc, puteți activa modul `pre-hash` pentru a avea +toate datele citite de două ori pentru a le asigura integritatea. +Această opțiune verifică și fișierele mutate în cadrul matricei +pentru a se asigura că operațiunea de mutare a fost reușită și, dacă este necesar, +vă permite să rulați o operațiune de reparare (fix) înainte de a continua. +Această opțiune poate fi utilizată doar cu `sync`. +
+ + +
+-i, --import DIR +
+Importă din directorul specificat orice fișiere șterse +din matrice după ultima `sync`. +Dacă mai aveți astfel de fișiere, ele pot fi utilizate de `check` +și `fix` pentru a îmbunătăți procesul de recuperare. +Fișierele sunt citite, inclusiv în subdirectoare, și sunt +identificate indiferent de numele lor. +Această opțiune poate fi utilizată doar cu `check` și `fix`. +
+ + +
+-s, --spin-down-on-error +
+La orice eroare, oprește (spin down) toate discurile gestionate înainte de a ieși cu +un cod de stare diferit de zero. Acest lucru împiedică unitățile să +rămână active și să se rotească după o operațiune întreruptă, +ajutând la evitarea acumulării inutile de căldură și a consumului de energie. +Utilizați această opțiune pentru a vă asigura că discurile sunt oprite în siguranță +chiar și atunci când o comandă eșuează. +
+ + +
+-w, --bw-limit RATE +
+Aplică o limită globală de lățime de bandă pentru toate discurile. RATE este +numărul de octeți pe secundă. Puteți specifica un multiplicator +cum ar fi K, M sau G (de exemplu, --bw-limit 1G). +
+ + +
+-A, --stats +
+Activează o vizualizare de stare extinsă care arată informații suplimentare. +Ecranul afișează două grafice: +Primul grafic arată numărul de dungi (stripes) tamponate pentru fiecare +disc, împreună cu calea fișierului care este +accesat în prezent pe acel disc. În mod obișnuit, cel mai lent disc nu va avea +tampon disponibil, ceea ce determină lățimea de bandă maximă realizabilă. +Al doilea grafic arată procentul de timp petrecut așteptând +în ultimele 100 de secunde. Este de așteptat ca cel mai lent disc să +cauzeze cea mai mare parte a timpului de așteptare, în timp ce alte discuri ar trebui să aibă +puțin sau deloc timp de așteptare, deoarece își pot utiliza dungile tamponate. +Acest grafic arată și timpul petrecut așteptând calculele hash +și calculele RAID. +Toate calculele rulează în paralel cu operațiunile de disc. +Prin urmare, atâta timp cât există timp de așteptare măsurabil pentru +cel puțin un disc, indică faptul că CPU-ul este suficient de rapid pentru a +ține pasul cu sarcina de lucru. +
+ + +
+-Z, --force-zero +
+Forțează operațiunea nesigură de sincronizare a unui fișier cu dimensiunea zero +care era anterior non-zero. +Dacă SnapRAID detectează o astfel de condiție, se oprește din a continua +dacă nu specificați această opțiune. +Acest lucru vă permite să detectați cu ușurință când, după o cădere de sistem, +unele fișiere accesate au fost trunchiate. +Aceasta este o condiție posibilă în Linux cu sistemele de fișiere ext3/ext4. +Această opțiune poate fi utilizată doar cu `sync`. +
+ + +
+-E, --force-empty +
+Forțează operațiunea nesigură de sincronizare a unui disc cu toate +fișierele originale lipsă. +Dacă SnapRAID detectează că toate fișierele prezente inițial +pe disc lipsesc sau au fost rescrise, se oprește din a continua +dacă nu specificați această opțiune. +Acest lucru vă permite să detectați cu ușurință când un sistem de fișiere de date nu este +montat. +Este permis, totuși, să aveți o singură schimbare de UUID cu +paritate simplă și mai multe cu paritate multiplă, deoarece acesta este +cazul normal la înlocuirea discurilor după o recuperare. +Această opțiune poate fi utilizată doar cu `sync`, `check` sau +`fix`. +
+ + +
+-U, --force-uuid +
+Forțează operațiunea nesigură de sincronizare, verificare și reparare +cu discuri care și-au schimbat UUID-ul. +Dacă SnapRAID detectează că unele discuri și-au schimbat UUID-ul, +se oprește din a continua dacă nu specificați această opțiune. +Acest lucru vă permite să detectați când discurile dvs. sunt montate la +punctele de montare greșite. +Este permis, totuși, să aveți o singură schimbare de UUID cu +paritate simplă și mai multe cu paritate multiplă, deoarece acesta este +cazul normal la înlocuirea discurilor după o recuperare. +Această opțiune poate fi utilizată doar cu `sync`, `check` sau +`fix`. +
+ + +
+-D, --force-device +
+Forțează operațiunea nesigură de reparare cu discuri inaccesibile +sau cu discuri pe același dispozitiv fizic. +De exemplu, dacă ați pierdut două discuri de date și aveți un disc de rezervă pentru a recupera +doar primul, puteți ignora al doilea disc inaccesibil. +Sau, dacă doriți să recuperați un disc în spațiul liber rămas pe un +disc deja utilizat, partajând același dispozitiv fizic. +Această opțiune poate fi utilizată doar cu `fix`. +
+ + +
+-N, --force-nocopy +
+În `sync`, `check` și `fix`, dezactivează euristica de detectare a copiei. +Fără această opțiune, SnapRAID presupune că fișierele cu aceleași +atribute, cum ar fi numele, dimensiunea și marca temporală, sunt copii cu +aceleași date. +Acest lucru permite identificarea fișierelor copiate sau mutate de pe un disc +pe altul și refolosirea informațiilor hash deja calculate +pentru a detecta erori silențioase sau pentru a recupera fișiere lipsă. +În unele cazuri rare, acest comportament poate duce la rezultate fals pozitive +sau la un proces lent din cauza multor verificări hash, iar această +opțiune vă permite să rezolvați astfel de probleme. +Această opțiune poate fi utilizată doar cu `sync`, `check` și `fix`. +
+ + +
+-F, --force-full +
+În `sync`, forțează o recalculare completă a parității. +Această opțiune poate fi utilizată atunci când adăugați un nou nivel de paritate sau dacă +ați revenit la un fișier de conținut vechi utilizând date de paritate mai recente. +În loc să recreați paritatea de la zero, aceasta vă permite +să reutilizați hash-urile prezente în fișierul de conținut pentru a valida datele +și a menține protecția datelor în timpul procesului `sync` utilizând +datele de paritate existente. +Această opțiune poate fi utilizată doar cu `sync`. +
+ + +
+-R, --force-realloc +
+În `sync`, forțează o realocare completă a fișierelor și o reconstruire a parității. +Această opțiune poate fi utilizată pentru a realoca complet toate fișierele, +eliminând fragmentarea, în timp ce reutilizați hash-urile prezente în fișierul de conținut +pentru a valida datele. +Această opțiune poate fi utilizată doar cu `sync`. +ATENȚIE! Această opțiune este doar pentru experți și este puternic +recomandat să nu o utilizați. +NU aveți protecție a datelor în timpul operațiunii `sync`. +
+ + +
+-l, --log FILE +
+Scrie un jurnal detaliat în fișierul specificat. +Dacă această opțiune nu este specificată, erorile neașteptate sunt tipărite +pe ecran, putând rezulta o ieșire excesivă în caz de +multe erori. Când -l, --log este specificat, doar +erorile fatale care fac SnapRAID să se oprească sunt tipărite +pe ecran. +Dacă calea începe cu '>>', fișierul este deschis +în modul de adăugare. Aparițiile de '%D' și '%T' în nume sunt +înlocuite cu data și ora în formatul YYYYMMDD și +HHMMSS. În fișierele batch Windows, trebuie să dublați +caracterul '%', de exemplu, result-%%D.log. Pentru a utiliza '>>', trebuie +să închideți numele între ghilimele, de exemplu, `">>result.log"`. +Pentru a scoate jurnalul la ieșirea standard sau la eroarea standard, +puteți utiliza `">&1"` și `">&2"`, respectiv. +Vedeți fișierul snapraid_log.txt sau pagina de manual pentru descrieri ale etichetelor jurnalului. +
+ + +
+-L, --error-limit NUMBER +
+Setează o nouă limită de erori înainte de a opri execuția. +În mod implicit, SnapRAID se oprește dacă întâlnește mai mult de 100 +de erori de intrare/ieșire, indicând că un disc probabil eșuează. +Această opțiune afectează `sync` și `scrub`, cărora li se permite +să continue după primul set de erori de disc pentru a încerca +să își finalizeze operațiunile. +Cu toate acestea, `check` și `fix` se opresc întotdeauna la prima eroare. +
+ + +
+-S, --start BLKSTART +
+Începe procesarea de la numărul de bloc +specificat. Acest lucru poate fi util pentru a reîncerca verificarea +sau repararea anumitor blocuri în cazul unui disc deteriorat. +Această opțiune este în principal pentru recuperarea manuală avansată. +
+ + +
+-B, --count BLKCOUNT +
+Procesează doar numărul specificat de blocuri. +Această opțiune este în principal pentru recuperarea manuală avansată. +
+ + +
+-C, --gen-conf CONTENT +
+Generează un fișier de configurare fictiv dintr-un fișier +de conținut existent. +Fișierul de configurare este scris la ieșirea standard +și nu suprascrie unul existent. +Acest fișier de configurare conține și informațiile +necesare pentru a reconstrui punctele de montare a discului în cazul în care +pierdeți întregul sistem. +
+ + +
+-v, --verbose +
+Tipărește mai multe informații pe ecran. +Dacă este specificat o dată, tipărește fișierele excluse +și statistici suplimentare. +Această opțiune nu are niciun efect asupra fișierelor jurnal. +
+ + +
+-q, --quiet +
+Tipărește mai puține informații pe ecran. +Dacă este specificat o dată, elimină bara de progres; de două ori, +operațiunile în curs; de trei ori, mesajele info +; de patru ori, mesajele de stare. +Erorile fatale sunt întotdeauna tipărite pe ecran. +Această opțiune nu are niciun efect asupra fișierelor jurnal. +
+ + +
+-H, --help +
+Tipărește un ecran de ajutor scurt. +
+ + +
+-V, --version +
+Tipărește versiunea programului. +
+

7 +Configurare +

+SnapRAID necesită un fișier de configurare pentru a ști unde se află matricea dvs. de discuri +și unde să stocheze informațiile de paritate. +

+În Unix, utilizează fișierul `/usr/local/etc/snapraid.conf` dacă există, +altfel `/etc/snapraid.conf`. +În Windows, utilizează fișierul `snapraid.conf` din același +director ca `snapraid.exe`. +

+Trebuie să conțină următoarele opțiuni (sensibile la majuscule/minuscule): +

7.1 +parity FILE [,FILE] ... +

+Definește fișierele de utilizat pentru a stoca informațiile de paritate. +Paritatea permite protecția împotriva unei singure defecțiuni de disc, +similar cu RAID5. +

+Puteți specifica mai multe fișiere, care trebuie să fie pe discuri diferite. +Când un fișier nu mai poate crește, este utilizat următorul. +Spațiul total disponibil trebuie să fie cel puțin la fel de mare ca cel mai mare disc de date din +matrice. +

+Puteți adăuga fișiere de paritate suplimentare mai târziu, dar nu +le puteți reordona sau elimina. +

+Păstrarea discurilor de paritate rezervate pentru paritate asigură că +nu devin fragmentate, îmbunătățind performanța. +

+În Windows, 256 MB sunt lăsați neutilizați pe fiecare disc pentru a evita +avertismentul despre discuri pline. +

+Această opțiune este obligatorie și poate fi utilizată o singură dată. +

7.2 +(2,3,4,5,6)-parity FILE [,FILE] ... +

+Definește fișierele de utilizat pentru a stoca informații de paritate suplimentare. +

+Pentru fiecare nivel de paritate specificat, este activat un nivel suplimentar de protecție: +

+

+Fiecare nivel de paritate necesită prezența tuturor nivelurilor de paritate +anterioare. +

+Aceleași considerații ca pentru opțiunea 'parity' se aplică. +

+Aceste opțiuni sunt opționale și pot fi utilizate o singură dată. +

7.3 +z-parity FILE [,FILE] ... +

+Definește un fișier și un format alternativ pentru a stoca paritatea triplă. +

+Această opțiune este o alternativă la '3-parity', destinată în primul rând +CPU-urilor low-end precum ARM sau AMD Phenom, Athlon și Opteron care nu +suportă setul de instrucțiuni SSSE3. În astfel de cazuri, oferă +o performanță mai bună. +

+Acest format este similar, dar mai rapid decât cel utilizat de ZFS RAIDZ3. +Ca și ZFS, nu funcționează dincolo de paritatea triplă. +

+Când utilizați '3-parity', veți fi avertizați dacă este recomandat să utilizați +formatul 'z-parity' pentru îmbunătățirea performanței. +

+Este posibil să convertiți de la un format la altul ajustând +fișierul de configurare cu fișierul z-parity sau 3-parity dorit +și utilizând 'fix' pentru a-l recrea. +

7.4 +content FILE +

+Definește fișierul de utilizat pentru a stoca lista și sumele de control (checksums) a tuturor +fișierelor prezente în matricea dvs. de discuri. +

+Poate fi plasat pe un disc utilizat pentru date, paritate sau +orice alt disc disponibil. +Dacă utilizați un disc de date, acest fișier este automat exclus +din procesul `sync`. +

+Această opțiune este obligatorie și poate fi utilizată de mai multe ori pentru a salva +mai multe copii ale aceluiași fișier. +

+Trebuie să stocați cel puțin o copie pentru fiecare disc de paritate utilizat +plus unul. Utilizarea de copii suplimentare nu dăunează. +

7.5 +data NAME DIR +

+Definește numele și punctul de montare al discurilor de date din +matrice. NAME este utilizat pentru a identifica discul și trebuie +să fie unic. DIR este punctul de montare al discului în +sistemul de fișiere. +

+Puteți schimba punctul de montare după cum este necesar, atâta timp cât +păstrați NAME fix. +

+Ar trebui să utilizați o opțiune pentru fiecare disc de date din matrice. +

+Puteți redenumi un disc mai târziu schimbând NAME direct +în fișierul de configurare și apoi rulând o comandă 'sync'. +În cazul redenumirii, asocierea se face utilizând UUID-ul stocat +al discurilor. +

7.6 +nohidden +

+Exclude toate fișierele și directoarele ascunse. +În Unix, fișierele ascunse sunt cele care încep cu `.`. +În Windows, sunt cele cu atributul ascuns. +

7.7 +exclude/include PATTERN +

+Definește modelele de fișiere sau directoare de exclus sau inclus +în procesul de sincronizare. +Toate modelele sunt procesate în ordinea specificată. +

+Dacă primul model care se potrivește este un `exclude`, fișierul +este exclus. Dacă este un `include`, fișierul este inclus. +Dacă niciun model nu se potrivește, fișierul este exclus dacă ultimul model +specificat este un `include`, sau inclus dacă ultimul model +specificat este un `exclude`. +

+Vedeți secțiunea PATTERN pentru mai multe detalii despre +specificațiile modelului. +

+Această opțiune poate fi utilizată de mai multe ori. +

7.8 +blocksize SIZE_IN_KIBIBYTES +

+Definește dimensiunea de bază a blocului în kibibytes pentru paritate. +Un kibibyte este 1024 de octeți. +

+Dimensiunea implicită a blocului este 256, care ar trebui să funcționeze pentru majoritatea cazurilor. +

+ATENȚIE! Această opțiune este doar pentru experți și este puternic +recomandat să nu schimbați această valoare. Pentru a schimba această valoare în +viitor, va trebui să recreați întreaga paritate! +

+Un motiv pentru a utiliza o dimensiune de bloc diferită este dacă aveți multe fișiere +mici, de ordinul milioanelor. +

+Pentru fiecare fișier, chiar dacă are doar câțiva octeți, este alocat un bloc întreg de paritate, +iar cu multe fișiere, acest lucru poate duce la un spațiu de paritate neutilizat semnificativ. +Când umpleți complet discul de paritate, nu vi se +permite să adăugați mai multe fișiere pe discurile de date. +Cu toate acestea, paritatea irosită nu se acumulează pe discurile de date. Spațiul irosit +rezultat dintr-un număr mare de fișiere pe un disc de date limitează doar +cantitatea de date de pe acel disc de date, nu pe celelalte. +

+Ca o aproximare, puteți presupune că jumătate din dimensiunea blocului este +irosită pentru fiecare fișier. De exemplu, cu 100.000 de fișiere și o dimensiune de bloc +de 256 KiB, veți irosi 12,8 GB de paritate, ceea ce poate duce +la 12,8 GB mai puțin spațiu disponibil pe discul de date. +

+Puteți verifica cantitatea de spațiu irosit pe fiecare disc utilizând `status`. +Aceasta este cantitatea de spațiu pe care trebuie să o lăsați liberă pe discurile de date +sau să o utilizați pentru fișiere care nu sunt incluse în matrice. +Dacă această valoare este negativă, înseamnă că sunteți aproape de a umple +paritatea și reprezintă spațiul pe care îl puteți irosi încă. +

+Pentru a evita această problemă, puteți utiliza o partiție mai mare pentru paritate. +De exemplu, dacă partiția de paritate este cu 12,8 GB mai mare decât discurile de date, +aveți suficient spațiu suplimentar pentru a gestiona până la 100.000 +de fișiere pe fiecare disc de date fără niciun spațiu irosit. +

+Un truc pentru a obține o partiție de paritate mai mare în Linux este să o formatați +cu comanda: +

+
+
+mkfs.ext4 -m 0 -T largefile4 DEVICE
+
+
+

+Acest lucru duce la aproximativ 1,5% spațiu suplimentar, aproximativ 60 GB pentru +un disc de 4 TB, ceea ce permite aproximativ 460.000 de fișiere pe fiecare disc de date fără +niciun spațiu irosit. +

7.9 +hashsize SIZE_IN_BYTES +

+Definește dimensiunea hash-ului în octeți pentru blocurile salvate. +

+Dimensiunea implicită a hash-ului este de 16 octeți (128 de biți), care ar trebui să funcționeze +pentru majoritatea cazurilor. +

+ATENȚIE! Această opțiune este doar pentru experți și este puternic +recomandat să nu schimbați această valoare. Pentru a schimba această valoare în +viitor, va trebui să recreați întreaga paritate! +

+Un motiv pentru a utiliza o dimensiune de hash diferită este dacă sistemul dvs. are +memorie limitată. Ca regulă generală, SnapRAID necesită de obicei +1 GiB de RAM pentru fiecare 16 TB de date din matrice. +

+Mai exact, pentru a stoca hash-urile datelor, SnapRAID necesită +aproximativ TS*(1+HS)/BS octeți de RAM, +unde TS este dimensiunea totală în octeți a matricei dvs. de discuri, BS este +dimensiunea blocului în octeți, iar HS este dimensiunea hash-ului în octeți. +

+De exemplu, cu 8 discuri de 4 TB, o dimensiune de bloc de 256 KiB +(1 KiB = 1024 octeți) și o dimensiune de hash de 16, obțineți: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1,93 GiB
+
+

+Trecând la o dimensiune de hash de 8, obțineți: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1,02 GiB
+
+

+Trecând la o dimensiune de bloc de 512, obțineți: +

+

+RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0,96 GiB
+
+

+Trecând la ambele, o dimensiune de hash de 8 și o dimensiune de bloc de 512, obțineți: +

+

+RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB
+
+

7.10 +autosave SIZE_IN_GIGABYTES +

+Salvează automat starea la sincronizare sau verificare după +cantitatea specificată de GB procesați. +Această opțiune este utilă pentru a evita repornirea comenzilor `sync` lungi +de la zero dacă sunt întrerupte de o cădere a mașinii sau de orice alt eveniment. +

7.11 +temp_limit TEMPERATURE_CELSIUS +

+Setează temperatura maximă permisă a discului în Celsius. Când este specificată, +SnapRAID verifică periodic temperatura tuturor discurilor utilizând +instrumentul smartctl. Temperaturile curente ale discurilor sunt afișate în timp ce +SnapRAID funcționează. Dacă un disc depășește această limită, toate operațiunile +se opresc, iar discurile sunt oprite (puse în standby) pentru durata +definită de opțiunea `temp_sleep`. După perioada de așteptare, operațiunile +reiau, putând întrerupe din nou dacă limita de temperatură este atinsă +încă o dată. +

+În timpul funcționării, SnapRAID analizează și curba de încălzire a fiecărui +disc și estimează temperatura constantă pe termen lung pe care se așteaptă să o +atingă dacă activitatea continuă. Estimarea este efectuată numai după +ce temperatura discului a crescut de patru ori, asigurându-se că sunt disponibile +suficiente puncte de date pentru a stabili o tendință fiabilă. +Această temperatură constantă prezisă este afișată între paranteze lângă +valoarea curentă și ajută la evaluarea dacă răcirea sistemului este +adecvată. Această temperatură estimată este doar în scop informativ +și nu are niciun efect asupra comportamentului SnapRAID. Acțiunile programului +se bazează exclusiv pe temperaturile reale măsurate ale discurilor. +

+Pentru a efectua această analiză, SnapRAID are nevoie de o referință pentru +temperatura sistemului. Încearcă mai întâi să o citească de la senzorii hardware +disponibili. Dacă nu poate fi accesat niciun senzor de sistem, utilizează +cea mai scăzută temperatură a discului măsurată la începutul rulării ca referință de rezervă. +

+În mod normal, SnapRAID arată doar temperatura celui mai fierbinte disc. +Pentru a afișa temperatura tuturor discurilor, utilizați opțiunea -A sau --stats. +

7.12 +temp_sleep TIME_IN_MINUTES +

+Setează timpul de așteptare (standby), în minute, când limita de temperatură este +atinsă. În această perioadă, discurile rămân oprite. Valoarea implicită +este 5 minute. +

7.13 +pool DIR +

+Definește directorul de pooling unde este creată vizualizarea virtuală a matricei +de discuri utilizând comanda `pool`. +

+Directorul trebuie să existe deja. +

7.14 +share UNC_DIR +

+Definește calea UNC Windows necesară pentru a accesa discurile de la distanță. +

+Dacă această opțiune este specificată, link-urile simbolice create în directorul pool +utilizează această cale UNC pentru a accesa discurile. +Fără această opțiune, link-urile simbolice generate utilizează doar căi locale, +ceea ce nu permite partajarea directorului pool peste rețea. +

+Link-urile simbolice sunt formate utilizând calea UNC specificată, adăugând +numele discului specificat în opțiunea `data` și, în final, adăugând +directorul și numele fișierului. +

+Această opțiune este necesară doar pentru Windows. +

7.15 +smartctl DISK/PARITY OPTIONS... +

+Definește opțiuni smartctl personalizate pentru a obține atributele SMART pentru +fiecare disc. Acest lucru poate fi necesar pentru controlerele RAID și unele discuri USB +care nu pot fi detectate automat. Substituția %s este înlocuită de +numele dispozitivului, dar este opțională pentru dispozitivele fixe, cum ar fi controlerele RAID. +

+DISK este același nume de disc specificat în opțiunea `data`. +PARITY este unul dintre numele de paritate: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` sau `z-parity`. +

+În OPȚIUNILE specificate, șirul `%s` este înlocuit de +numele dispozitivului. Pentru controlerele RAID, dispozitivul este +probabil fix și este posibil să nu fie nevoie să utilizați `%s`. +

+Consultați documentația smartmontools pentru opțiuni posibile: +

+
+
+https://www.smartmontools.org/wiki/Supported_RAID-Controllers
+https://www.smartmontools.org/wiki/Supported_USB-Devices
+
+
+

+De exemplu: +

+
+
+smartctl parity -d sat %s
+
+
+

7.16 +smartignore DISK/PARITY ATTR [ATTR...] +

+Ignoră atributul SMART specificat la calcularea probabilității +de eșec a discului. Această opțiune este utilă dacă un disc raportează valori neobișnuite sau +înșelătoare pentru un anumit atribut. +

+DISK este același nume de disc specificat în opțiunea `data`. +PARITY este unul dintre numele de paritate: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity` sau `z-parity`. +Valoarea specială * poate fi utilizată pentru a ignora atributul pe toate discurile. +

+De exemplu, pentru a ignora atributul `Current Pending Sector Count` pe +toate discurile: +

+
+
+smartignore * 197
+
+
+

+Pentru a-l ignora doar pe primul disc de paritate: +

+
+
+smartignore parity 197
+
+
+

7.17 +Exemple +

+Un exemplu de configurare tipică pentru Unix este: +

+
+
+parity /mnt/diskp/snapraid.parity
+content /mnt/diskp/snapraid.content
+content /var/snapraid/snapraid.content
+data d1 /mnt/disk1/
+data d2 /mnt/disk2/
+data d3 /mnt/disk3/
+exclude /lost+found/
+exclude /tmp/
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/sg0
+smartctl 2-parity -d areca,2/1 /dev/sg0
+
+
+

+Un exemplu de configurare tipică pentru Windows este: +

+
+
+parity E:\snapraid.parity
+content E:\snapraid.content
+content C:\snapraid\snapraid.content
+data d1 G:\array\
+data d2 H:\array\
+data d3 I:\array\
+exclude Thumbs.db
+exclude \$RECYCLE.BIN
+exclude \System Volume Information
+smartctl d1 -d sat %s
+smartctl d2 -d usbjmicron %s
+smartctl parity -d areca,1/1 /dev/arcmsr0
+smartctl 2-parity -d areca,2/1 /dev/arcmsr0
+
+
+

8 +Model (Pattern) +

+Modelele sunt utilizate pentru a selecta un subset de fișiere de exclus sau inclus în +proces. +

+Există patru tipuri diferite de modele: + + +
+FILE +
+Selectează orice fișier numit FILE. Puteți utiliza orice caracter de globbing +precum * și ?, și clase de caractere precum [a-z]. +Acest model se aplică numai fișierelor, nu directoarelor. +
+ + +
+DIR/ +
+Selectează orice director numit DIR și tot ce se află în interior. +Puteți utiliza orice caracter de globbing precum * și ?. +Acest model se aplică numai directoarelor, nu fișierelor. +
+ + +
+/PATH/FILE +
+Selectează calea exactă a fișierului specificat. Puteți utiliza orice +caractere de globbing precum * și ?, dar acestea nu se potrivesc niciodată cu o +bară oblică de director (directory slash). +Acest model se aplică numai fișierelor, nu directoarelor. +
+ + +
+/PATH/DIR/ +
+Selectează calea exactă a directorului specificat și tot ce se află +în interior. Puteți utiliza orice caractere de globbing precum * și ?, dar +acestea nu se potrivesc niciodată cu o bară oblică de director. +Acest model se aplică numai directoarelor, nu fișierelor. +
+

+Când specificați o cale absolută care începe cu /, aceasta este aplicată la +directorul rădăcină al matricei, nu la directorul rădăcină al sistemului de fișiere local. +

+În Windows, puteți utiliza backslash-ul \ în loc de slash-ul /. +Directoarele de sistem Windows, joncțiunile, punctele de montare și alte directoare +speciale Windows sunt tratate ca fișiere, ceea ce înseamnă că pentru a le exclude, +trebuie să utilizați o regulă de fișier, nu una de director. +

+Dacă numele fișierului conține un caracter '*', '?', '[', +sau ']', trebuie să îl escape-ați pentru a evita să fie interpretat ca un +caracter de globbing. În Unix, caracterul escape este '\'; în Windows, este '^'. +Când modelul este pe linia de comandă, trebuie să dublați caracterul escape +pentru a evita ca acesta să fie interpretat de shell-ul de comandă. +

+În fișierul de configurare, puteți utiliza diferite strategii pentru a filtra +fișierele de procesat. +Abordarea cea mai simplă este să utilizați doar reguli `exclude` pentru a elimina toate +fișierele și directoarele pe care nu doriți să le procesați. De exemplu: +

+
+
+# Exclude orice fișier numit `*.unrecoverable`
+exclude *.unrecoverable
+# Exclude directorul rădăcină `/lost+found`
+exclude /lost+found/
+# Exclude orice subdirector numit `tmp`
+exclude tmp/
+
+
+

+Abordarea opusă este să definiți doar fișierele pe care doriți să le procesați, utilizând +doar reguli `include`. De exemplu: +

+
+
+# Include doar unele directoare
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+Abordarea finală este de a amesteca regulile `exclude` și `include`. În acest caz, +ordinea regulilor este importantă. Regulile anterioare au +precedență față de cele ulterioare. +Pentru a simplifica, puteți lista toate regulile `exclude` mai întâi și apoi +toate regulile `include`. De exemplu: +

+
+
+# Exclude orice fișier numit `*.unrecoverable`
+exclude *.unrecoverable
+# Exclude orice subdirector numit `tmp`
+exclude tmp/
+# Include doar unele directoare
+include /movies/
+include /musics/
+include /pictures/
+
+
+

+Pe linia de comandă, utilizând opțiunea -f, puteți utiliza doar modele `include`. +De exemplu: +

+
+
+# Verifică doar fișierele .mp3.
+# În Unix, utilizați ghilimele pentru a evita expansiunea globbing de către shell.
+snapraid -f "*.mp3" check
+
+
+

+În Unix, când utilizați caractere globbing pe linia de comandă, trebuie +să le citați pentru a împiedica shell-ul să le extindă. +

9 +Conținut (Content) +

+SnapRAID stochează lista și sumele de control (checksums) ale fișierelor dvs. în fișierul de conținut. +

+Este un fișier binar care listează toate fișierele prezente în matricea dvs. de discuri, +împreună cu toate sumele de control pentru a le verifica integritatea. +

+Acest fișier este citit și scris de comenzile `sync` și `scrub` și +citit de comenzile `fix`, `check` și `status`. +

10 +Paritate (Parity) +

+SnapRAID stochează informațiile de paritate ale matricei dvs. în fișierele de paritate. +

+Acestea sunt fișiere binare care conțin paritatea calculată a tuturor +blocurilor definite în fișierul de `content`. +

+Aceste fișiere sunt citite și scrise de comenzile `sync` și `fix` și +doar citite de comenzile `scrub` și `check`. +

11 +Codare (Encoding) +

+SnapRAID în Unix ignoră orice codare. Citește și stochează +numele fișierelor cu aceeași codare utilizată de sistemul de fișiere. +

+În Windows, toate numele citite din sistemul de fișiere sunt convertite și +procesate în format UTF-8. +

+Pentru a avea numele fișierelor tipărite corect, trebuie să setați consola Windows +în modul UTF-8 cu comanda `chcp 65001` și să utilizați +un font TrueType precum `Lucida Console` ca font al consolei. +Acest lucru afectează doar numele de fișiere tipărite; dacă +redirecționați ieșirea consolei către un fișier, fișierul rezultat este întotdeauna +în format UTF-8. +

12 +Drept de Autor (Copyright) +

+Acest fișier este Copyright (C) 2025 Andrea Mazzoleni +

13 +Vezi și (See Also) +

+snapraid_log(1), rsync(1) + + + +
+ + + + + + diff --git a/manual.html b/manual.html index cc06e1d9..ce915c6d 100644 --- a/manual.html +++ b/manual.html @@ -61,6 +61,10 @@ Manual for SnapRAID.

+

+There are also automatic translation to German, Spanish, French, Italian, Polish, Romanian. +

+

1 Synopsis

@@ -184,7 +188,7 @@ Permissions, ownership, and extended attributes are not saved. Getting Started To use SnapRAID, you need to first select one disk in your disk array -to dedicate to "parity" information. With one disk for parity, you +to dedicate to `parity` information. With one disk for parity, you will be able to recover from a single disk failure, similar to RAID5.

If you want to recover from more disk failures, similar to RAID6, @@ -195,20 +199,20 @@ As parity disks, you must pick the largest disks in the array, as the parity information may grow to the size of the largest data disk in the array.

-These disks will be dedicated to storing the "parity" files. +These disks will be dedicated to storing the `parity` files. You should not store your data on them.

-Then, you must define the "data" disks that you want to protect +Then, you must define the `data` disks that you want to protect with SnapRAID. The protection is more effective if these disks contain data that rarely changes. For this reason, it's better to NOT include the Windows C:\ disk or the Unix /home, /var, and /tmp directories.

-The list of files is saved in the "content" files, usually +The list of files is saved in the `content` files, usually stored on the data, parity, or boot disks. This file contains the details of your backup, including all the checksums to verify its integrity. -The "content" file is stored in multiple copies, and each copy must +The `content` file is stored in multiple copies, and each copy must be on a different disk to ensure that, even in case of multiple disk failures, at least one copy is available.

@@ -263,7 +267,7 @@ https://www.google.com/search?q=Windows+mount+point

-At this point, you are ready to run the "sync" command to build the +At this point, you are ready to run the `sync` command to build the parity information.

@@ -282,12 +286,12 @@ will resume where it was interrupted. When this command completes, your data is SAFE.

Now you can start using your array as you like and periodically -update the parity information by running the "sync" command. +update the parity information by running the `sync` command.

4.1 Scrubbing

To periodically check the data and parity for errors, you can -run the "scrub" command. +run the `scrub` command. 

@@ -296,7 +300,7 @@ snapraid scrub

This command compares the data in your array with the hash computed -during the "sync" command to verify integrity. +during the `sync` command to verify integrity.

Each run of the command checks approximately 8% of the array, excluding data already scrubbed in the previous 10 days. @@ -311,8 +315,8 @@ snapraid -p 5 -o 20 scrub

If silent or input/output errors are found during the process, -the corresponding blocks are marked as bad in the "content" file -and listed in the "status" command. +the corresponding blocks are marked as bad in the `content` file +and listed in the `status` command. 

@@ -320,7 +324,7 @@ snapraid status

-To fix them, you can use the "fix" command, filtering for bad blocks with +To fix them, you can use the `fix` command, filtering for bad blocks with the -e, --filter-error option:

@@ -329,7 +333,7 @@ snapraid -e fix

-At the next "scrub," the errors will disappear from the "status" report +At the next `scrub`, the errors will disappear from the `status` report if they are truly fixed. To make it faster, you can use -p bad to scrub only blocks marked as bad.

@@ -339,8 +343,8 @@ snapraid -p bad scrub

-Running "scrub" on an unsynced array may report errors caused by -removed or modified files. These errors are reported in the "scrub" +Running `scrub` on an unsynced array may report errors caused by +removed or modified files. These errors are reported in the `scrub` output, but the related blocks are not marked as bad.

4.2 Pooling @@ -355,10 +359,10 @@ protection and is commonly used in setups like OpenMediaVault (OMV) or custom NAS configurations.

To have all the files in your array shown in the same directory tree, -you can enable the "pooling" feature. It creates a read-only virtual +you can enable the `pooling` feature. It creates a read-only virtual view of all the files in your array using symbolic links.

-You can configure the "pooling" directory in the configuration file with: +You can configure the `pooling` directory in the configuration file with: 

@@ -374,7 +378,7 @@ pool C:\pool

-and then run the "pool" command to create or update the virtual view. +and then run the `pool` command to create or update the virtual view. 

@@ -410,10 +414,10 @@ In Windows, sharing symbolic links over a network requires clients to
 resolve them remotely. To enable this, besides sharing the pool directory,
 you must also share all the disks independently, using the disk names
 defined in the configuration file as share points. You must also specify
-in the "share" option of the configuration file the Windows UNC path that
+in the `share` option of the configuration file the Windows UNC path that
 remote clients need to use to access these shared disks.
 

-For example, operating from a server named "darkstar", you can use
+For example, operating from a server named `darkstar`, you can use
 the options:
 

 

@@ -503,11 +507,11 @@ STEP 1 -> Reconfigure
 You need some space to recover, ideally on additional
 spare disks, but an external USB disk or remote disk will suffice.
 

-Modify the SnapRAID configuration file to make the "data" or "parity"
+Modify the SnapRAID configuration file to make the `data` or `parity`
 option of the failed disk point to a location with enough empty
 space to recover the files.
 

-For example, if disk "d1" has failed, change from:
+For example, if disk `d1` has failed, change from:
 

 

 
@@ -523,7 +527,7 @@ data d1 /mnt/new_spare_disk/
 

 

 

-If the disk to recover is a parity disk, update the appropriate "parity"
+If the disk to recover is a parity disk, update the appropriate `parity`
 option.
 If you have multiple failed disks, update all their configuration options.
 
4.4.2 
@@ -537,8 +541,8 @@ snapraid -d NAME -l fix.log fix
 
 

 

-Where NAME is the name of the disk, such as "d1" in our previous example.
-If the disk to recover is a parity disk, use the names "parity", "2-parity",
+Where NAME is the name of the disk, such as `d1` in our previous example.
+If the disk to recover is a parity disk, use the names `parity`, `2-parity`,
 etc.
 If you have multiple failed disks, use multiple -d options to specify all
 of them.
@@ -549,28 +553,28 @@ Ensure you have a few gigabytes free to store the fix.log file.
 Run it from a disk with sufficient free space.
 

 Now you have recovered all that is recoverable. If some files are partially
-or totally unrecoverable, they will be renamed by adding the ".unrecoverable"
+or totally unrecoverable, they will be renamed by adding the `.unrecoverable`
 extension.
 

 You can find a detailed list of all unrecoverable blocks in the fix.log file
-by checking all lines starting with "unrecoverable:".
+by checking all lines starting with `unrecoverable:`.
 

 If you are not satisfied with the recovery, you can retry it as many
 times as you wish.
 

 For example, if you have removed files from the array after the last
-"sync", this may result in some files not being recovered.
-In this case, you can retry the "fix" using the -i, --import option,
+`sync`, this may result in some files not being recovered.
+In this case, you can retry the `fix` using the -i, --import option,
 specifying where these files are now to include them again in the
 recovery process.
 

 If you are satisfied with the recovery, you can proceed further,
-but note that after syncing, you cannot retry the "fix" command
+but note that after syncing, you cannot retry the `fix` command
 anymore!
 
4.4.3 
 STEP 3 -> Check
 

-As a cautious check, you can now run a "check" command to ensure that
+As a cautious check, you can now run a `check` command to ensure that
 everything is correct on the recovered disk.
 

 

@@ -579,7 +583,7 @@ snapraid -d NAME -a check
 
 

 

-Where NAME is the name of the disk, such as "d1" in our previous example.
+Where NAME is the name of the disk, such as `d1` in our previous example.
 

 The -d and -a options tell SnapRAID to check only the specified disk
 and ignore all parity data.
@@ -589,7 +593,7 @@ you can skip it.
 
4.4.4 
 STEP 4 -> Sync
 

-Run the "sync" command to resynchronize the array with the new disk.
+Run the `sync` command to resynchronize the array with the new disk.
 

 

 
@@ -604,19 +608,19 @@ Commands
 SnapRAID provides a few simple commands that allow you to:
 
    
 
  • 
-Print the status of the array -> "status"
+Print the status of the array -> `status`
 
    • 
 
  • 
-Control the disks -> "smart", "probe", "up", "down"
+Control the disks -> `smart`, `probe`, `up`, `down`
 
    • 
 
  • 
-Make a backup/snapshot -> "sync"
+Make a backup/snapshot -> `sync`
 
    • 
 
  • 
-Periodically check data -> "scrub"
+Periodically check data -> `scrub`
 
    • 
 
  • 
-Restore the last backup/snapshot -> "fix".
+Restore the last backup/snapshot -> `fix`.
 
    • 
 

 

@@ -631,10 +635,10 @@ the blocks are without checking, and all recorded silent
 errors encountered while scrubbing.
 

 The information presented refers to the latest time you
-ran "sync". Later modifications are not taken into account.
+ran `sync`. Later modifications are not taken into account.
 

 If bad blocks were detected, their block numbers are listed.
-To fix them, you can use the "fix -e" command.
+To fix them, you can use the `fix -e` command.
 

 It also shows a graph representing the last time each block
 was scrubbed or synced. Scrubbed blocks are shown with '*',
@@ -659,7 +663,7 @@ https://www.backblaze.com/hard-drive-test-data.html
 

 

 

-If SMART reports that a disk is failing, "FAIL" or "PREFAIL" is printed
+If SMART reports that a disk is failing, `FAIL` or `PREFAIL` is printed
 for that disk, and SnapRAID returns with an error.
 In this case, immediate replacement of the disk is highly recommended.
 

@@ -687,11 +691,11 @@ If the -v, --verbose option is specified, a deeper statistical analysis
 is provided. This analysis can help you decide if you need more
 or less parity.
 

-This command uses the "smartctl" tool and is equivalent to running
-"smartctl -a" on all devices.
+This command uses the `smartctl` tool and is equivalent to running
+`smartctl -a` on all devices.
 

 If your devices are not auto-detected correctly, you can specify
-a custom command using the "smartctl" option in the configuration
+a custom command using the `smartctl` option in the configuration
 file.
 

 Nothing is modified.
@@ -700,14 +704,14 @@ probe
 
 Prints the POWER state of all disks in the system.
 

-"Standby" means the disk is not spinning. "Active" means
+`Standby` means the disk is not spinning. `Active` means
 the disk is spinning.
 

-This command uses the "smartctl" tool and is equivalent to running
-"smartctl -n standby -i" on all devices.
+This command uses the `smartctl` tool and is equivalent to running
+`smartctl -n standby -i` on all devices.
 

 If your devices are not auto-detected correctly, you can specify
-a custom command using the "smartctl" option in the configuration
+a custom command using the `smartctl` option in the configuration
 file.
 

 Nothing is modified.
@@ -727,21 +731,21 @@ down
 
 Spins down all the disks of the array.
 

-This command uses the "smartctl" tool and is equivalent to running
-"smartctl -s standby,now" on all devices.
+This command uses the `smartctl` tool and is equivalent to running
+`smartctl -s standby,now` on all devices.
 

 You can spin down only specific disks using the -d, --filter-disk
 option.
 

 To automatically spin down on error, you can use the -s, --spin-down-on-error
-option with any other command, which is equivalent to running "down" manually
+option with any other command, which is equivalent to running `down` manually
 when an error occurs.
 

 Nothing is modified.
 
5.6 
 diff
 

-Lists all the files modified since the last "sync" that need to have
+Lists all the files modified since the last `sync` that need to have
 their parity data recomputed.
 

 This command doesn't check the file data, but only the file timestamp,
@@ -783,7 +787,7 @@ copied
Files copied on the same or a different disk. Note that if they are truly moved to a different disk, they will also be -counted in "removed". +counted in `removed`. They are identified by having the same name, size, and timestamp. If the sub-second timestamp is zero, the full path must match, not just the name. @@ -796,7 +800,7 @@ These are usually files restored after being deleted.

-If a "sync" is required, the process return code is 2, instead of the +If a `sync` is required, the process return code is 2, instead of the default 0. The return code 1 is used for a generic error condition.

Nothing is modified. @@ -809,7 +813,7 @@ data is updated.

You can stop this process at any time by pressing Ctrl+C, without losing the work already done. -At the next run, the "sync" process will resume where +At the next run, the `sync` process will resume where it was interrupted.

If silent or input/output errors are found during the process, @@ -824,7 +828,7 @@ same inode, the parity is not recomputed. If the file is moved to another disk, the parity is recomputed, but the previously computed hash information is retained.

-The "content" and "parity" files are modified if necessary. +The `content` and `parity` files are modified if necessary. The files in the array are NOT modified.

5.8 scrub @@ -848,25 +852,25 @@ If you specify a percentage amount, you can also use the -o, --older-than option to define how old the block should be. The oldest blocks are scrubbed first, ensuring an optimal check. If you want to scrub only the just-synced blocks not yet scrubbed, -use the "-p new" option. +use the `-p new` option.

-To get details of the scrub status, use the "status" command. +To get details of the scrub status, use the `status` command.

For any silent or input/output error found, the corresponding blocks -are marked as bad in the "content" file. -These bad blocks are listed in "status" and can be fixed with "fix -e". +are marked as bad in the `content` file. +These bad blocks are listed in `status` and can be fixed with `fix -e`. After the fix, at the next scrub, they will be rechecked, and if found corrected, the bad mark will be removed. -To scrub only the bad blocks, you can use the "scrub -p bad" command. +To scrub only the bad blocks, you can use the `scrub -p bad` command.

-It's recommended to run "scrub" only on a synced array to avoid +It's recommended to run `scrub` only on a synced array to avoid reported errors caused by unsynced data. These errors are recognized as not being silent errors, and the blocks are not marked as bad, but such errors are reported in the output of the command.

-The "content" file is modified to update the time of the last check +The `content` file is modified to update the time of the last check for each block and to mark bad blocks. -The "parity" files are NOT modified. +The `parity` files are NOT modified. The files in the array are NOT modified.

5.9 fix @@ -874,26 +878,26 @@ fix Fixes all the files and the parity data.

All files and parity data are compared with the snapshot -state saved in the last "sync". +state saved in the last `sync`. If a difference is found, it is reverted to the stored snapshot.

-WARNING! The "fix" command does not differentiate between errors and +WARNING! The `fix` command does not differentiate between errors and intentional modifications. It unconditionally reverts the file state -to the last "sync". +to the last `sync`.

If no other option is specified, the entire array is processed. Use the filter options to select a subset of files or disks to operate on.

-To fix only the blocks marked bad during "sync" and "scrub", +To fix only the blocks marked bad during `sync` and `scrub`, use the -e, --filter-error option. Unlike other filter options, this one applies fixes only to files that are -unchanged since the latest "sync". +unchanged since the latest `sync`.

SnapRAID renames all files that cannot be fixed by adding the -".unrecoverable" extension. +`.unrecoverable` extension.

Before fixing, the entire array is scanned to find any files moved -since the last "sync" operation. +since the last `sync` operation. These files are identified by their timestamp, ignoring their name and directory, and are used in the recovery process if necessary. If you moved some of them outside the array, you can use the -i, --import @@ -901,20 +905,20 @@ option to specify additional directories to scan.

Files are identified only by path, not by inode.

-The "content" file is NOT modified. -The "parity" files are modified if necessary. +The `content` file is NOT modified. +The `parity` files are modified if necessary. The files in the array are modified if necessary.

5.10 check

Verifies all the files and the parity data.

-It works like "fix", but it only simulates a recovery and no changes +It works like `fix`, but it only simulates a recovery and no changes are written to the array.

This command is primarily intended for manual verification, such as after a recovery process or in other special conditions. -For periodic and scheduled checks, use "scrub". +For periodic and scheduled checks, use `scrub`.

If you use the -a, --audit-only option, only the file data is checked, and the parity data is ignored for a @@ -927,7 +931,7 @@ Nothing is modified. list Lists all the files contained in the array at the time of the -last "sync". +last `sync`.

With -v or --verbose, the subsecond time is also shown.

@@ -944,7 +948,7 @@ Nothing is modified. pool Creates or updates a virtual view of all -the files in your disk array in the "pooling" directory. +the files in your disk array in the `pooling` directory.

The files are not copied but linked using symbolic links. @@ -1002,12 +1006,12 @@ If you are already using the optimal hash, this command does nothing and informs you that no action is needed.

The rehash is not performed immediately but takes place -progressively during "sync" and "scrub". +progressively during `sync` and `scrub`.

-You can check the rehash state using "status". +You can check the rehash state using `status`.

During the rehash, SnapRAID maintains full functionality, -with the only exception that "dup" cannot detect duplicated +with the only exception that `dup` cannot detect duplicated files using a different hash.

6 Options @@ -1018,24 +1022,24 @@ SnapRAID provides the following options: -c, --conf CONFIG Selects the configuration file to use. If not specified, in Unix -it uses the file "/usr/local/etc/snapraid.conf" if it exists, -otherwise "/etc/snapraid.conf". -In Windows, it uses the file "snapraid.conf" in the same -directory as "snapraid.exe". +it uses the file `/usr/local/etc/snapraid.conf` if it exists, +otherwise `/etc/snapraid.conf`. +In Windows, it uses the file `snapraid.conf` in the same +directory as `snapraid.exe`.
-f, --filter PATTERN
-Filters the files to process in "check" and "fix". +Filters the files to process in `check` and `fix`. Only the files matching the specified pattern are processed. This option can be used multiple times. See the PATTERN section for more details on pattern specifications. In Unix, ensure globbing characters are quoted if used. -This option can be used only with "check" and "fix". -It cannot be used with "sync" and "scrub", as they always +This option can be used only with `check` and `fix`. +It cannot be used with `sync` and `scrub`, as they always process the entire array.
@@ -1043,16 +1047,16 @@ process the entire array. -d, --filter-disk NAME -Filters the disks to process in "check", "fix", "up", and "down". +Filters the disks to process in `check`, `fix`, `up`, and `down`. You must specify a disk name as defined in the configuration file. -You can also specify parity disks with the names: "parity", "2-parity", -"3-parity", etc., to limit operations to a specific parity disk. +You can also specify parity disks with the names: `parity`, `2-parity`, +`3-parity`, etc., to limit operations to a specific parity disk. If you combine multiple --filter, --filter-disk, and --filter-missing options, only files matching all the filters are selected. This option can be used multiple times. -This option can be used only with "check", "fix", "up", and "down". -It cannot be used with "sync" and "scrub", as they always +This option can be used only with `check`, `fix`, `up`, and `down`. +It cannot be used with `sync` and `scrub`, as they always process the entire array. @@ -1060,13 +1064,13 @@ process the entire array. -m, --filter-missing -Filters the files to process in "check" and "fix". +Filters the files to process in `check` and `fix`. Only the files missing or deleted from the array are processed. -When used with "fix", this acts as an "undelete" command. +When used with `fix`, this acts as an `undelete` command. If you combine multiple --filter, --filter-disk, and --filter-missing options, only files matching all the filters are selected. -This option can be used only with "check" and "fix". -It cannot be used with "sync" and "scrub", as they always +This option can be used only with `check` and `fix`. +It cannot be used with `sync` and `scrub`, as they always process the entire array. @@ -1074,10 +1078,10 @@ process the entire array. -e, --filter-error -Processes the files with errors in "check" and "fix". +Processes the files with errors in `check` and `fix`. It processes only files that have blocks marked with silent -or input/output errors during "sync" and "scrub", as listed in "status". -This option can be used only with "check" and "fix". +or input/output errors during `sync` and `scrub`, as listed in `status`. +This option can be used only with `check` and `fix`. @@ -1087,40 +1091,40 @@ This option can be used only with "check" and "fix". Selects the scrub plan. If PERC is a numeric value from 0 to 100, it is interpreted as the percentage of blocks to scrub. Instead of a percentage, you can specify a plan: -"bad" scrubs bad blocks, "new" scrubs blocks not yet scrubbed, -and "full" scrubs everything. -This option can be used only with "scrub". +`bad` scrubs bad blocks, `new` scrubs blocks not yet scrubbed, +and `full` scrubs everything. +This option can be used only with `scrub`.
-o, --older-than DAYS
-Selects the oldest part of the array to process in "scrub". +Selects the oldest part of the array to process in `scrub`. DAYS is the minimum age in days for a block to be scrubbed; the default is 10. Blocks marked as bad are always scrubbed regardless of this option. -This option can be used only with "scrub". +This option can be used only with `scrub`.
-a, --audit-only
-In "check", verifies the hash of the files without +In `check`, verifies the hash of the files without checking the parity data. If you are interested only in checking the file data, this option can significantly speed up the checking process. -This option can be used only with "check". +This option can be used only with `check`.
-h, --pre-hash
-In "sync", runs a preliminary hashing phase of all new data +In `sync`, runs a preliminary hashing phase of all new data for additional verification before the parity computation. -Usually, in "sync", no preliminary hashing is done, and the new +Usually, in `sync`, no preliminary hashing is done, and the new data is hashed just before the parity computation when it is read for the first time. This process occurs when the system is under @@ -1128,12 +1132,12 @@ heavy load, with all disks spinning and a busy CPU. This is an extreme condition for the machine, and if it has a latent hardware problem, silent errors may go undetected because the data is not yet hashed. -To avoid this risk, you can enable the "pre-hash" mode to have +To avoid this risk, you can enable the `pre-hash` mode to have all the data read twice to ensure its integrity. This option also verifies files moved within the array to ensure the move operation was successful and, if necessary, allows you to run a fix operation before proceeding. -This option can be used only with "sync". +This option can be used only with `sync`.
@@ -1141,12 +1145,12 @@ This option can be used only with "sync". -i, --import DIR
Imports from the specified directory any files deleted -from the array after the last "sync". -If you still have such files, they can be used by "check" -and "fix" to improve the recovery process. +from the array after the last `sync`. +If you still have such files, they can be used by `check` +and `fix` to improve the recovery process. The files are read, including in subdirectories, and are identified regardless of their name. -This option can be used only with "check" and "fix". +This option can be used only with `check` and `fix`.
@@ -1205,7 +1209,7 @@ This allows you to easily detect when, after a system crash, some accessed files were truncated. This is a possible condition in Linux with the ext3/ext4 file systems. -This option can be used only with "sync". +This option can be used only with `sync`.
@@ -1219,7 +1223,7 @@ on the disk are missing or rewritten, it stops proceeding unless you specify this option. This allows you to easily detect when a data file system is not mounted. -This option can be used only with "sync". +This option can be used only with `sync`.
@@ -1235,8 +1239,8 @@ wrong mount points. It is, however, allowed to have a single UUID change with single parity, and more with multiple parity, because this is the normal case when replacing disks after a recovery. -This option can be used only with "sync", "check", or -"fix". +This option can be used only with `sync`, `check`, or +`fix`.
@@ -1249,14 +1253,14 @@ For example, if you lost two data disks and have a spare disk to recover only the first one, you can ignore the second inaccessible disk. Or, if you want to recover a disk in the free space left on an already used disk, sharing the same physical device. -This option can be used only with "fix". +This option can be used only with `fix`.
-N, --force-nocopy
-In "sync", "check", and "fix", disables the copy detection heuristic. +In `sync`, `check`, and `fix`, disables the copy detection heuristic. Without this option, SnapRAID assumes that files with the same attributes, such as name, size, and timestamp, are copies with the same data. @@ -1266,35 +1270,35 @@ to detect silent errors or to recover missing files. In some rare cases, this behavior may result in false positives or a slow process due to many hash verifications, and this option allows you to resolve such issues. -This option can be used only with "sync", "check", and "fix". +This option can be used only with `sync`, `check`, and `fix`.
-F, --force-full
-In "sync", forces a full recomputation of the parity. +In `sync`, forces a full recomputation of the parity. This option can be used when you add a new parity level or if you reverted to an old content file using more recent parity data. Instead of recreating the parity from scratch, this allows you to reuse the hashes present in the content file to validate data -and maintain data protection during the "sync" process using +and maintain data protection during the `sync` process using the existing parity data. -This option can be used only with "sync". +This option can be used only with `sync`.
-R, --force-realloc
-In "sync", forces a full reallocation of files and rebuild of the parity. +In `sync`, forces a full reallocation of files and rebuild of the parity. This option can be used to completely reallocate all files, removing fragmentation, while reusing the hashes present in the content file to validate data. -This option can be used only with "sync". +This option can be used only with `sync`. WARNING! This option is for experts only, and it is highly recommended not to use it. -You DO NOT have data protection during the "sync" operation. +You DO NOT have data protection during the `sync` operation.
@@ -1312,9 +1316,10 @@ in append mode. Occurrences of '%D' and '%T' in the name are replaced with the date and time in the format YYYYMMDD and HHMMSS. In Windows batch files, you must double the '%' character, e.g., result-%%D.log. To use '>>', you must -enclose the name in quotes, e.g., ">>result.log". +enclose the name in quotes, e.g., `">>result.log"`. To output the log to standard output or standard error, -you can use ">&1" and ">&2", respectively. +you can use `">&1"` and `">&2"`, respectively. +See the snapraid_log.txt file or man page for log tag descriptions.
@@ -1324,10 +1329,10 @@ you can use ">&1" and ">&2", respectively. Sets a new error limit before stopping execution. By default, SnapRAID stops if it encounters more than 100 input/output errors, indicating that a disk is likely failing. -This option affects "sync" and "scrub", which are allowed +This option affects `sync` and `scrub`, which are allowed to continue after the first set of disk errors to try to complete their operations. -However, "check" and "fix" always stop at the first error. +However, `check` and `fix` always stop at the first error.
@@ -1403,10 +1408,10 @@ Configuration SnapRAID requires a configuration file to know where your disk array is located and where to store the parity information.

-In Unix, it uses the file "/usr/local/etc/snapraid.conf" if it exists, -otherwise "/etc/snapraid.conf". -In Windows, it uses the file "snapraid.conf" in the same -directory as "snapraid.exe". +In Unix, it uses the file `/usr/local/etc/snapraid.conf` if it exists, +otherwise `/etc/snapraid.conf`. +In Windows, it uses the file `snapraid.conf` in the same +directory as `snapraid.exe`.

It must contain the following options (case-sensitive):

7.1 @@ -1490,7 +1495,7 @@ files present in your disk array. It can be placed on a disk used for data, parity, or any other disk available. If you use a data disk, this file is automatically excluded -from the "sync" process. +from the `sync` process.

This option is mandatory and can be used multiple times to save multiple copies of the same file. @@ -1518,7 +1523,7 @@ UUID of the disks. nohidden

Excludes all hidden files and directories. -In Unix, hidden files are those starting with ".". +In Unix, hidden files are those starting with `.`. In Windows, they are those with the hidden attribute.

7.7 exclude/include PATTERN @@ -1527,11 +1532,11 @@ Defines the file or directory patterns to exclude or include in the sync process. All patterns are processed in the specified order.

-If the first pattern that matches is an "exclude" one, the file -is excluded. If it is an "include" one, the file is included. +If the first pattern that matches is an `exclude` one, the file +is excluded. If it is an `include` one, the file is included. If no pattern matches, the file is excluded if the last pattern -specified is an "include", or included if the last pattern -specified is an "exclude". +specified is an `include`, or included if the last pattern +specified is an `exclude`.

See the PATTERN section for more details on pattern specifications. @@ -1565,7 +1570,7 @@ wasted for each file. For example, with 100,000 files and a 256 KiB block size, you will waste 12.8 GB of parity, which may result in 12.8 GB less space available on the data disk.

-You can check the amount of wasted space on each disk using "status". +You can check the amount of wasted space on each disk using `status`. This is the amount of space you must leave free on the data disks or use for files not included in the array. If this value is negative, it means you are close to filling @@ -1638,7 +1643,7 @@ autosave SIZE_IN_GIGABYTES

Automatically saves the state when syncing or scrubbing after the specified amount of GB processed. -This option is useful to avoid restarting long "sync" +This option is useful to avoid restarting long `sync` commands from scratch if interrupted by a machine crash or any other event.

7.11 temp_limit TEMPERATURE_CELSIUS @@ -1648,7 +1653,7 @@ SnapRAID periodically checks the temperature of all disks using the smartctl tool. The current disk temperatures are displayed while SnapRAID is operating. If any disk exceeds this limit, all operations stop, and the disks are spun down (put into standby) for the duration -defined by the "temp_sleep" option. After the sleep period, operations +defined by the `temp_sleep` option. After the sleep period, operations resume, potentially pausing again if the temperature limit is reached once more.

@@ -1680,7 +1685,7 @@ is 5 minutes. pool DIR

Defines the pooling directory where the virtual view of the disk -array is created using the "pool" command. +array is created using the `pool` command.

The directory must already exist.

7.14 @@ -1694,7 +1699,7 @@ Without this option, the symbolic links generated use only local paths, which does not allow sharing the pool directory over the network.

The symbolic links are formed using the specified UNC path, adding the -disk name as specified in the "data" option, and finally adding the +disk name as specified in the `data` option, and finally adding the file directory and name.

This option is required only for Windows. @@ -1706,13 +1711,13 @@ each disk. This may be required for RAID controllers and some USB disks that cannot be auto-detected. The %s placeholder is replaced by the device name, but it is optional for fixed devices like RAID controllers.

-DISK is the same disk name specified in the "data" option. -PARITY is one of the parity names: "parity", "2-parity", "3-parity", -"4-parity", "5-parity", "6-parity", or "z-parity". +DISK is the same disk name specified in the `data` option. +PARITY is one of the parity names: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity`, or `z-parity`.

-In the specified OPTIONS, the "%s" string is replaced by the +In the specified OPTIONS, the `%s` string is replaced by the device name. For RAID controllers, the device is -likely fixed, and you may not need to use "%s". +likely fixed, and you may not need to use `%s`.

Refer to the smartmontools documentation for possible options:

@@ -1737,12 +1742,12 @@ Ignores the specified SMART attribute when computing the probability of disk failure. This option is useful if a disk reports unusual or misleading values for a particular attribute.

-DISK is the same disk name specified in the "data" option. -PARITY is one of the parity names: "parity", "2-parity", "3-parity", -"4-parity", "5-parity", "6-parity", or "z-parity". +DISK is the same disk name specified in the `data` option. +PARITY is one of the parity names: `parity`, `2-parity`, `3-parity`, +`4-parity`, `5-parity`, `6-parity`, or `z-parity`. The special value * can be used to ignore the attribute on all disks.

-For example, to ignore the "Current Pending Sector Count" attribute on +For example, to ignore the `Current Pending Sector Count` attribute on all disks:

@@ -1861,22 +1866,22 @@ character to avoid having it interpreted by the command shell.

In the configuration file, you can use different strategies to filter the files to process. -The simplest approach is to use only "exclude" rules to remove all the +The simplest approach is to use only `exclude` rules to remove all the files and directories you do not want to process. For example: 

-# Excludes any file named "*.unrecoverable"
+# Excludes any file named `*.unrecoverable`
 exclude *.unrecoverable
-# Excludes the root directory "/lost+found"
+# Excludes the root directory `/lost+found`
 exclude /lost+found/
-# Excludes any subdirectory named "tmp"
+# Excludes any subdirectory named `tmp`
 exclude tmp/

The opposite approach is to define only the files you want to process, using -only "include" rules. For example: +only `include` rules. For example: 

@@ -1887,17 +1892,17 @@ include /pictures/

-The final approach is to mix "exclude" and "include" rules. In this case, +The final approach is to mix `exclude` and `include` rules. In this case, the order of rules is important. Earlier rules take precedence over later ones. -To simplify, you can list all the "exclude" rules first and then -all the "include" rules. For example: +To simplify, you can list all the `exclude` rules first and then +all the `include` rules. For example: 

-# Excludes any file named "*.unrecoverable"
+# Excludes any file named `*.unrecoverable`
 exclude *.unrecoverable
-# Excludes any subdirectory named "tmp"
+# Excludes any subdirectory named `tmp`
 exclude tmp/
 # Includes only some directories
 include /movies/
@@ -1906,7 +1911,7 @@ include /pictures/

-On the command line, using the -f option, you can only use "include" +On the command line, using the -f option, you can only use `include` patterns. For example:

@@ -1927,8 +1932,8 @@ SnapRAID stores the list and checksums of your files in the content file. It is a binary file that lists all the files present in your disk array, along with all the checksums to verify their integrity.

-This file is read and written by the "sync" and "scrub" commands and -read by the "fix", "check", and "status" commands. +This file is read and written by the `sync` and `scrub` commands and +read by the `fix`, `check`, and `status` commands.

10 Parity

@@ -1936,10 +1941,10 @@ SnapRAID stores the parity information of your array in the parity files.

These are binary files containing the computed parity of all the -blocks defined in the "content" file. +blocks defined in the `content` file.

-These files are read and written by the "sync" and "fix" commands and -only read by the "scrub" and "check" commands. +These files are read and written by the `sync` and `fix` commands and +only read by the `scrub` and `check` commands.

11 Encoding

@@ -1950,8 +1955,8 @@ In Windows, all names read from the file system are converted and processed in UTF-8 format.

To have file names printed correctly, you must set the Windows -console to UTF-8 mode with the command "chcp 65001" and use -a TrueType font like "Lucida Console" as the console font. +console to UTF-8 mode with the command `chcp 65001` and use +a TrueType font like `Lucida Console` as the console font. This affects only the printed file names; if you redirect the console output to a file, the resulting file is always in UTF-8 format.