diff --git a/Makefile.am b/Makefile.am index 523155a5..a9502371 100644 --- a/Makefile.am +++ b/Makefile.am @@ -121,11 +121,27 @@ mkstream_SOURCES = \ dist-hook: $(srcdir)/autover.sh > $(distdir)/.version +LIST_D = snapraid.d \ + snapraid-de.d \ + snapraid-es.d \ + snapraid-fr.d \ + snapraid-it.d \ + snapraid-pl.d \ + snapraid-ro.d \ + snapraid_log.d + +LIST_MAN = $(LIST_D:.d=.1) + +LIST_TXT = $(LIST_D:.d=.txt) + +LIST_HH = $(LIST_D:.d=.hh) + EXTRA_DIST = \ autogen.sh autover.sh \ README AUTHORS HISTORY INSTALL COPYING TODO CHECK INSTALL.windows \ - snapraid.d snapraid.1 snapraid.txt \ - snapraid_log.d snapraid_log.1 snapraid_log.txt \ + $(LIST_D) \ + $(LIST_MAN) \ + $(LIST_TXT) \ test/test-par1.conf \ test/test-par2.conf \ test/test-par3.conf \ @@ -1011,35 +1027,27 @@ lcov_html: # Rules for documentation if HAVE_ADVD2 -snapraid.1 : snapraid.d +%.1 : %.d advd2 man < $(srcdir)/$< > $@ -snapraid.txt : snapraid.d +%.txt : %.d advd2 txt < $(srcdir)/$< | todos > $@ -snapraid.html : snapraid.d +%.html : %.d advd2 html < $(srcdir)/$< > $@ -snapraid.hh : snapraid.d +%.hh : %.d advd2 frame < $(srcdir)/$< > $@ - -snapraid_log.1 : snapraid_log.d - advd2 man < $(srcdir)/$< > $@ - -snapraid_log.txt : snapraid_log.d - advd2 txt < $(srcdir)/$< | todos > $@ - -snapraid_log.html : snapraid_log.d - advd2 html < $(srcdir)/$< > $@ - -snapraid_log.hh : snapraid_log.d - advd2 frame < $(srcdir)/$< > $@ endif +# Web distribution + +web: $(LIST_HH) + # Windows distribution DISTWIN = \ - snapraid.txt \ + $(LIST_TXT) \ snapraid.exe distwindows-x86: $(DISTWIN) @@ -1071,4 +1079,3 @@ distwindows-x64: $(DISTWIN) todos < TODO > tmp/todo.txt cd tmp && zip -r ../$(PACKAGE)-$(VERSION)-windows-x64.zip * rm -r tmp - diff --git a/snapraid-de.1 b/snapraid-de.1 new file mode 100644 index 00000000..77ed8f8c --- /dev/null +++ b/snapraid-de.1 @@ -0,0 +1,2018 @@ +.TH "SnapRAID Sicherung für Festplatten\-Arrays" 1 +.SH NAME +snapraid \- SnapRAID Sicherung für Festplatten\-Arrays +.SH SYNOPSIS +snapraid [\-c, \-\-conf CONFIG] +.PD 0 +.PP +.PD + [\-f, \-\-filter PATTERN] [\-d, \-\-filter\-disk NAME] +.PD 0 +.PP +.PD + [\-m, \-\-filter\-missing] [\-e, \-\-filter\-error] +.PD 0 +.PP +.PD + [\-a, \-\-audit\-only] [\-h, \-\-pre\-hash] [\-i, \-\-import DIR] +.PD 0 +.PP +.PD + [\-p, \-\-plan PERC|bad|new|full] +.PD 0 +.PP +.PD + [\-o, \-\-older\-than DAYS] [\-l, \-\-log FILE] +.PD 0 +.PP +.PD + [\-s, \-\-spin\-down\-on\-error] [\-w, \-\-bw\-limit RATE] +.PD 0 +.PP +.PD + [\-Z, \-\-force\-zero] [\-E, \-\-force\-empty] +.PD 0 +.PP +.PD + [\-U, \-\-force\-uuid] [\-D, \-\-force\-device] +.PD 0 +.PP +.PD + [\-N, \-\-force\-nocopy] [\-F, \-\-force\-full] +.PD 0 +.PP +.PD + [\-R, \-\-force\-realloc] +.PD 0 +.PP +.PD + [\-S, \-\-start BLKSTART] [\-B, \-\-count BLKCOUNT] +.PD 0 +.PP +.PD + [\-L, \-\-error\-limit NUMBER] +.PD 0 +.PP +.PD + [\-A, \-\-stats] +.PD 0 +.PP +.PD + [\-v, \-\-verbose] [\-q, \-\-quiet] +.PD 0 +.PP +.PD + status|smart|probe|up|down|diff|sync|scrub|fix|check +.PD 0 +.PP +.PD + |list|dup|pool|devices|touch|rehash +.PD 0 +.PD +.PP +snapraid [\-V, \-\-version] [\-H, \-\-help] [\-C, \-\-gen\-conf CONTENT] +.PD 0 +.PD +.SH 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. +.PP +SnapRAID ist hauptsächlich für Home\-Media\-Center mit großen, +selten geänderten Dateien konzipiert und bietet folgende Funktionen: +.PD 0 +.IP \(bu +Sie können bereits mit Dateien gefüllte Festplatten verwenden, +ohne sie neu formatieren zu müssen, und wie gewohnt darauf zugreifen. +.IP \(bu +Alle Ihre Daten werden gehasht, um die Datenintegrität zu +gewährleisten und stille Beschädigung (silent corruption) zu verhindern. +.IP \(bu +Wenn die Anzahl der ausgefallenen Festplatten die Paritätsanzahl +überschreitet, beschränkt sich der Datenverlust auf die betroffenen +Festplatten; Daten auf anderen Festplatten bleiben zugänglich. +.IP \(bu +Wenn Sie versehentlich Dateien auf einer Festplatte löschen, +ist eine Wiederherstellung möglich. +.IP \(bu +Festplatten können unterschiedliche Größen haben. +.IP \(bu +Sie können jederzeit Festplatten hinzufügen. +.IP \(bu +SnapRAID sperrt Ihre Daten nicht ein; Sie können die Verwendung +jederzeit beenden, ohne neu formatieren oder Daten verschieben zu müssen. +.IP \(bu +Um auf eine Datei zuzugreifen, muss nur eine einzige Festplatte +drehen (spinnen), was Strom spart und Geräusche reduziert. +.PD +.PP +Für weitere Informationen besuchen Sie bitte die offizielle SnapRAID\-Website: +.PP +.RS 4 +https://www.snapraid.it/ +.PD 0 +.PD +.RE +.SH LIMITATIONS +SnapRAID ist ein Hybrid aus einem RAID\- und einem Sicherungsprogramm, +das darauf abzielt, die besten Vorteile beider zu kombinieren. +Es hat jedoch einige Einschränkungen, die Sie vor der Verwendung +berücksichtigen sollten. +.PP +Die Haupteinschränkung besteht darin, dass wenn eine Festplatte +ausfällt und Sie in letzter Zeit keine Synchronisierung durchgeführt haben, +Sie möglicherweise nicht vollständig wiederherstellen können. +Genauer gesagt können Sie möglicherweise nicht bis zur Größe der +geänderten oder gelöschten Dateien seit der letzten \`sync\`\-Operation +wiederherstellen. Dies tritt auch dann auf, wenn die geänderten oder +gelöschten Dateien sich nicht auf der ausgefallenen Festplatte befinden. +Aus diesem Grund ist SnapRAID besser für Daten geeignet, die sich +selten ändern. +.PP +Andererseits verhindern neu hinzugefügte Dateien die Wiederherstellung +von bereits vorhandenen Dateien nicht. Sie verlieren nur die +kürzlich hinzugefügten Dateien, wenn diese sich auf der ausgefallenen +Festplatte befinden. +.PP +Weitere Einschränkungen von SnapRAID sind: +.PD 0 +.IP \(bu +Mit SnapRAID haben Sie immer noch separate Dateisysteme für jede +Festplatte. Mit RAID erhalten Sie ein einziges großes Dateisystem. +.IP \(bu +SnapRAID streift (stripes) keine Daten. +Mit RAID erhalten Sie einen Geschwindigkeitsvorteil durch Striping. +.IP \(bu +SnapRAID unterstützt keine Echtzeit\-Wiederherstellung. +Mit RAID müssen Sie die Arbeit nicht unterbrechen, wenn eine +Festplatte ausfällt. +.IP \(bu +SnapRAID kann Daten nur von einer begrenzten Anzahl von Festplattenausfällen +wiederherstellen. Mit einer Sicherung können Sie von einem +vollständigen Ausfall des gesamten Festplatten\-Arrays wiederherstellen. +.IP \(bu +Nur Dateinamen, Zeitstempel, symbolische Links (symlinks) und +Hardlinks werden gespeichert. Berechtigungen, Eigentümerschaft +und erweiterte Attribute werden nicht gespeichert. +.PD +.SH 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. +.PP +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. +.PP +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. +.PP +Diese Festplatten werden zum Speichern der \`parity\`\-Dateien +reserviert. Sie sollten Ihre Daten nicht darauf speichern. +.PP +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. +.PP +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. +.PP +Angenommen, Sie sind nur an einer Paritätsstufe des Schutzes interessiert +und Ihre Festplatten befinden sich unter: +.PP +.RS 4 +/mnt/diskp <\- ausgewählte Festplatte für Parität +.PD 0 +.PP +.PD +/mnt/disk1 <\- erste zu schützende Festplatte +.PD 0 +.PP +.PD +/mnt/disk2 <\- zweite zu schützende Festplatte +.PD 0 +.PP +.PD +/mnt/disk3 <\- dritte zu schützende Festplatte +.PD 0 +.PD +.RE +.PP +Sie müssen die Konfigurationsdatei /etc/snapraid.conf mit den +folgenden Optionen erstellen: +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk1/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk2/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PD +.RE +.PP +Wenn Sie Windows verwenden, sollten Sie das Windows\-Pfadformat mit +Laufwerksbuchstaben und Backslashes anstelle von Slashes verwenden. +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +content F:\\array\\snapraid.content +.PD 0 +.PP +.PD +content G:\\array\\snapraid.content +.PD 0 +.PP +.PD +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PD +.RE +.PP +Wenn Sie viele Festplatten haben und keine Laufwerksbuchstaben mehr +verfügbar sind, können Sie Festplatten direkt in Unterordnern +einhängen (mounten). Siehe: +.PP +.RS 4 +https://www.google.com/search?q=Windows+mount+point +.PD 0 +.PD +.RE +.PP +Zu diesem Zeitpunkt sind Sie bereit, den Befehl \`sync\` auszuführen, +um die Paritätsinformationen zu erstellen. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +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. +.PP +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. +.PP +Wenn dieser Befehl abgeschlossen ist, sind Ihre Daten SICHER. +.PP +Jetzt können Sie Ihr Array nach Belieben verwenden und die Paritätsinformationen +regelmäßig durch Ausführen des \`sync\`\-Befehls aktualisieren. +.SS Scrubbing +Um die Daten und die Parität regelmäßig auf Fehler zu überprüfen, +können Sie den Befehl \`scrub\` ausführen. +.PP +.RS 4 +snapraid scrub +.PD 0 +.PD +.RE +.PP +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. +.PP +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: +.PP +.RS 4 +snapraid \-p 5 \-o 20 scrub +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid status +.PD 0 +.PD +.RE +.PP +Um sie zu beheben, können Sie den Befehl \`fix\` verwenden und dabei +nach fehlerhaften Blöcken mit der Option \-e, \-\-filter\-error +filtern: +.PP +.RS 4 +snapraid \-e fix +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid \-p bad scrub +.PD 0 +.PD +.RE +.PP +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. +.SS 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. +.PP +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. +.PP +Sie können das \`pooling\`\-Verzeichnis in der Konfigurationsdatei +mit folgender Option konfigurieren: +.PP +.RS 4 +pool /pool +.PD 0 +.PD +.RE +.PP +oder, wenn Sie Windows verwenden, mit: +.PP +.RS 4 +pool C:\\pool +.PD 0 +.PD +.RE +.PP +und anschließend den Befehl \`pool\` ausführen, um die virtuelle +Ansicht zu erstellen oder zu aktualisieren. +.PP +.RS 4 +snapraid pool +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +# Im globalen Abschnitt von smb.conf +.PD 0 +.PP +.PD +unix extensions = no +.PD 0 +.PD +.RE +.PP +.RS 4 +# Im Freigabe\-Abschnitt von smb.conf +.PD 0 +.PP +.PD +[pool] +.PD 0 +.PP +.PD +comment = Pool +.PD 0 +.PP +.PD +path = /pool +.PD 0 +.PP +.PD +read only = yes +.PD 0 +.PP +.PD +guest ok = yes +.PD 0 +.PP +.PD +wide links = yes +.PD 0 +.PP +.PD +follow symlinks = yes +.PD 0 +.PD +.RE +.PP +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. +.PP +Zum Beispiel, wenn Sie von einem Server namens \`darkstar\` aus +arbeiten, können Sie die Optionen verwenden: +.PP +.RS 4 +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PP +.PD +pool C:\\pool +.PD 0 +.PP +.PD +share \\\\darkstar +.PD 0 +.PD +.RE +.PP +und die folgenden Verzeichnisse über das Netzwerk freigeben: +.PP +.RS 4 +\\\\darkstar\\pool \-> C:\\pool +.PD 0 +.PP +.PD +\\\\darkstar\\d1 \-> F:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d2 \-> G:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d3 \-> H:\\array +.PD 0 +.PD +.RE +.PP +um Remote\-Clients den Zugriff auf alle Dateien unter \\\\darkstar\\pool +zu ermöglichen. +.PP +Möglicherweise müssen Sie auch Remote\-Clients konfigurieren, um +den Zugriff auf Remote\-Symlinks mit dem Befehl zu aktivieren: +.PP +.RS 4 +fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1 +.PD 0 +.PD +.RE +.SS 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: +.PP +.RS 4 +snapraid fix \-f DATEI +.PD 0 +.PD +.RE +.PP +oder für ein Verzeichnis: +.PP +.RS 4 +snapraid fix \-f VERZEICHNIS/ +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid fix \-m \-f VERZEICHNIS/ +.PD 0 +.PD +.RE +.PP +Oder um alle gelöschten Dateien auf allen Laufwerken wiederherzustellen mit: +.PP +.RS 4 +snapraid fix \-m +.PD 0 +.PD +.RE +.SS Recovering +Das Schlimmste ist passiert, und Sie haben eine oder mehrere Festplatten +verloren! +.PP +KEINE PANIK! Sie werden in der Lage sein, sie wiederherzustellen! +.PP +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. +.PP +Fahren Sie dann mit den folgenden Schritten fort. +.SS 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. +.PP +Ä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. +.PP +Wenn zum Beispiel die Festplatte \`d1\` ausgefallen ist, ändern Sie von: +.PP +.RS 4 +data d1 /mnt/disk1/ +.PD 0 +.PD +.RE +.PP +zu: +.PP +.RS 4 +data d1 /mnt/new_spare_disk/ +.PD 0 +.PD +.RE +.PP +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. +.SS STEP 2 \-> Fix +Führen Sie den \`fix\`\-Befehl aus und speichern Sie das Protokoll +in einer externen Datei mit: +.PP +.RS 4 +snapraid \-d NAME \-l fix.log fix +.PD 0 +.PD +.RE +.PP +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. +.PP +Dieser Befehl wird lange dauern. +.PP +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. +.PP +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. +.PP +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. +.PP +Wenn Sie mit der Wiederherstellung nicht zufrieden sind, können Sie +sie so oft wie gewünscht wiederholen. +.PP +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. +.PP +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! +.SS 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. +.PP +.RS 4 +snapraid \-d NAME \-a check +.PD 0 +.PD +.RE +.PP +Wobei NAME der Name der Festplatte ist, wie z.B. \`d1\` in unserem +vorherigen Beispiel. +.PP +Die Optionen \-d und \-a weisen SnapRAID an, nur die angegebene +Festplatte zu überprüfen und alle Paritätsdaten zu ignorieren. +.PP +Dieser Befehl wird lange dauern, aber wenn Sie nicht übermäßig +vorsichtig sind, können Sie ihn überspringen. +.SS STEP 4 \-> Sync +Führen Sie den \`sync\`\-Befehl aus, um das Array mit der neuen +Festplatte zu resynchronisieren. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +Wenn alles wiederhergestellt ist, ist dieser Befehl sofort. +.SH COMMANDS +SnapRAID bietet einige einfache Befehle, mit denen Sie: +.PD 0 +.IP \(bu +Den Status des Arrays ausgeben \-> \`status\` +.IP \(bu +Die Festplatten steuern \-> \`smart\`, \`probe\`, \`up\`, \`down\` +.IP \(bu +Eine Sicherung/einen Snapshot erstellen \-> \`sync\` +.IP \(bu +Daten regelmäßig überprüfen \-> \`scrub\` +.IP \(bu +Die letzte Sicherung/den letzten Snapshot wiederherstellen \-> \`fix\`. +.PD +.PP +Befehle müssen in Kleinbuchstaben geschrieben werden. +.SS status +Gibt eine Zusammenfassung des Zustands des Festplatten\-Arrays aus. +.PP +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. +.PP +Die präsentierten Informationen beziehen sich auf den letzten Zeitpunkt, +zu dem Sie \`sync\` ausgeführt haben. Spätere Änderungen werden +nicht berücksichtigt. +.PP +Wenn fehlerhafte Blöcke erkannt wurden, werden deren Blocknummern +aufgelistet. Um sie zu beheben, können Sie den Befehl \`fix \-e\` +verwenden. +.PP +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. +.PP +Es wird nichts geändert. +.SS smart +Gibt einen SMART\-Bericht aller Festplatten im System aus. +.PP +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. +.PP +Diese Wahrscheinlichkeitsschätzung wird durch Korrelation der SMART\-Attribute +der Festplatten mit den Backblaze\-Daten erhalten, die unter +folgender Adresse verfügbar sind: +.PP +.RS 4 +https://www.backblaze.com/hard\-drive\-test\-data.html +.PD 0 +.PD +.RE +.PP +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. +.PP +Weitere mögliche Statuszeichenfolgen sind: +.RS 4 +.PD 0 +.HP 4 +.I logfail +In der Vergangenheit lagen einige Attribute unter +dem Schwellenwert. +.HP 4 +.I logerr +Das Gerätefehlerprotokoll enthält Fehler. +.HP 4 +.I selferr +Das Geräte\-Selbsttestprotokoll enthält Fehler. +.PD +.RE +.PP +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. +.PP +Dieser Befehl verwendet das \`smartctl\`\-Tool und entspricht dem +Ausführen von \`smartctl \-a\` auf allen Geräten. +.PP +Wenn Ihre Geräte nicht korrekt automatisch erkannt werden, können Sie +einen benutzerdefinierten Befehl mithilfe der \`smartctl\`\-Option +in der Konfigurationsdatei angeben. +.PP +Es wird nichts geändert. +.SS probe +Gibt den POWER\-Zustand aller Festplatten im System aus. +.PP +\`Standby\` bedeutet, dass die Festplatte nicht dreht. \`Active\` +bedeutet, dass die Festplatte dreht. +.PP +Dieser Befehl verwendet das \`smartctl\`\-Tool und entspricht dem +Ausführen von \`smartctl \-n standby \-i\` auf allen Geräten. +.PP +Wenn Ihre Geräte nicht korrekt automatisch erkannt werden, können Sie +einen benutzerdefinierten Befehl mithilfe der \`smartctl\`\-Option +in der Konfigurationsdatei angeben. +.PP +Es wird nichts geändert. +.SS up +Dreht alle Festplatten des Arrays hoch (spins up). +.PP +Sie können nur bestimmte Festplatten mithilfe der Option \-d, \-\-filter\-disk +hochdrehen. +.PP +Das gleichzeitige Hochdrehen aller Festplatten erfordert viel Strom. +Stellen Sie sicher, dass Ihr Netzteil dies aushalten kann. +.PP +Es wird nichts geändert. +.SS down +Dreht alle Festplatten des Arrays herunter (spins down). +.PP +Dieser Befehl verwendet das \`smartctl\`\-Tool und entspricht dem +Ausführen von \`smartctl \-s standby,now\` auf allen Geräten. +.PP +Sie können nur bestimmte Festplatten mithilfe der Option \-d, \-\-filter\-disk +herunterdrehen. +.PP +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. +.PP +Es wird nichts geändert. +.SS diff +Listet alle Dateien auf, die seit dem letzten \`sync\` geändert wurden +und deren Paritätsdaten neu berechnet werden müssen. +.PP +Dieser Befehl überprüft nicht die Dateidaten, sondern nur den +Dateizeitstempel, die Größe und die Inode. +.PP +Nach dem Auflisten aller geänderten Dateien wird eine Zusammenfassung +der Änderungen präsentiert, gruppiert nach: +.RS 4 +.PD 0 +.HP 4 +.I equal +Dateien, die sich seitdem nicht geändert haben. +.HP 4 +.I added +Neu hinzugefügte Dateien, die vorher nicht vorhanden waren. +.HP 4 +.I removed +Entfernte Dateien. +.HP 4 +.I updated +Dateien mit einer anderen Größe oder einem anderen +Zeitstempel, was bedeutet, dass sie geändert wurden. +.HP 4 +.I 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. +.HP 4 +.I 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. +.HP 4 +.I restored +Dateien mit einer anderen Inode, aber übereinstimmendem +Namen, Größe und Zeitstempel. Dies sind normalerweise +Dateien, die nach dem Löschen wiederhergestellt wurden. +.PD +.RE +.PP +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. +.PP +Es wird nichts geändert. +.SS sync +Aktualisiert die Paritätsinformationen. Alle geänderten Dateien +im Festplatten\-Array werden gelesen, und die entsprechenden +Paritätsdaten werden aktualisiert. +.PP +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. +.PP +Wenn während des Vorgangs stille oder Eingabe\-/Ausgabefehler +gefunden werden, werden die entsprechenden Blöcke als fehlerhaft +markiert. +.PP +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. +.PP +Die \`content\`\- und \`parity\`\-Dateien werden bei Bedarf geändert. +Die Dateien im Array werden NICHT geändert. +.SS scrub +Scrubbt das Array und überprüft auf stille oder Eingabe\-/Ausgabefehler +auf Daten\- und Paritätsfestplatten. +.PP +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. +.PP +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 +.PP +.RS 4 +wurden. +.RE +.RS 0 +.PD 0 +.HP 4 +.I full +Scrubbt alles. +.HP 4 +.I 0\-100 +Scrubbt den angegebenen Prozentsatz der Blöcke. +.PD +.RE +.PP +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\`. +.PP +Um Details zum Scrub\-Status zu erhalten, verwenden Sie den Befehl +\`status\`. +.PP +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. +.PP +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. +.PP +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. +.SS fix +Behebt alle Dateien und die Paritätsdaten. +.PP +Alle Dateien und Paritätsdaten werden mit dem Snapshot\-Zustand +verglichen, der beim letzten \`sync\` gespeichert wurde. +Wenn eine Abweichung gefunden wird, wird sie auf den gespeicherten +Snapshot zurückgesetzt. +.PP +WARNUNG! Der Befehl \`fix\` unterscheidet nicht zwischen Fehlern und +beabsichtigten Änderungen. Er setzt den Dateizustand bedingungslos +auf den letzten \`sync\` zurück. +.PP +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. +.PP +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. +.PP +SnapRAID benennt alle Dateien, die nicht behoben werden können, +durch Hinzufügen der Erweiterung \`.unrecoverable\` um. +.PP +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. +.PP +Dateien werden nur anhand des Pfads identifiziert, nicht anhand +der Inode. +.PP +Die \`content\`\-Datei wird NICHT geändert. +Die \`parity\`\-Dateien werden bei Bedarf geändert. +Die Dateien im Array werden bei Bedarf geändert. +.SS check +Überprüft alle Dateien und die Paritätsdaten. +.PP +Es funktioniert wie \`fix\`, simuliert jedoch nur eine Wiederherstellung, +und es werden keine Änderungen in das Array geschrieben. +.PP +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\`. +.PP +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. +.PP +Dateien werden nur anhand des Pfads identifiziert, nicht anhand +der Inode. +.PP +Es wird nichts geändert. +.SS list +Listet alle Dateien auf, die sich zum Zeitpunkt des letzten \`sync\` +im Array befanden. +.PP +Mit \-v oder \-\-verbose wird auch die Untersekundenzeit angezeigt. +.PP +Es wird nichts geändert. +.SS 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. +.PP +Es wird nichts geändert. +.SS pool +Erstellt oder aktualisiert eine virtuelle Ansicht aller +Dateien in Ihrem Festplatten\-Array im \`pooling\`\-Verzeichnis. +.PP +Die Dateien werden nicht kopiert, sondern mithilfe symbolischer +Links verknüpft. +.PP +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. +.PP +Außerhalb des Pool\-Verzeichnisses wird nichts geändert. +.SS devices +Gibt die Low\-Level\-Geräte aus, die vom Array verwendet werden. +.PP +Dieser Befehl zeigt die Gerätezuordnungen im Array an und ist +hauptsächlich als Skriptschnittstelle gedacht. +.PP +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. +.PP +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. +.PP +Es wird nichts geändert. +.SS touch +Setzt einen beliebigen Untersekunden\-Zeitstempel für alle Dateien, +deren Untersekunden\-Zeitstempel auf Null gesetzt ist. +.PP +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. +.PP +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. +.PP +Der Zeitstempel mit Sekundenpräzision wird nicht geändert, +sodass alle Daten und Zeiten Ihrer Dateien erhalten bleiben. +.SS rehash +Plant eine Neu\-Hash\-Berechnung (rehash) des gesamten Arrays. +.PP +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. +.PP +Wenn Sie bereits den optimalen Hash verwenden, tut dieser Befehl +nichts und informiert Sie darüber, dass keine Aktion erforderlich ist. +.PP +Die Neu\-Hash\-Berechnung wird nicht sofort durchgeführt, sondern +findet schrittweise während \`sync\` und \`scrub\` statt. +.PP +Sie können den Neu\-Hash\-Zustand mithilfe von \`status\` überprüfen. +.PP +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. +.SH OPTIONS +SnapRAID bietet die folgenden Optionen: +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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). +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. \`\[dq]>>result.log\[dq]\`. +Um das Protokoll an die Standardausgabe oder den Standardfehler +auszugeben, können Sie \`\[dq]>&1\[dq]\` bzw. \`\[dq]>&2\[dq]\` verwenden. +Beschreibungen der Protokoll\-Tags finden Sie in der Datei +snapraid_log.txt oder in der Manpage. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-B, \-\-count BLKCOUNT +Verarbeitet nur die angegebene Anzahl von Blöcken. +Diese Option ist hauptsächlich für die erweiterte manuelle +Wiederherstellung gedacht. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-H, \-\-help +Gibt eine kurze Hilfeanzeige aus. +.TP +.B \-V, \-\-version +Gibt die Programmversion aus. +.SH CONFIGURATION +SnapRAID benötigt eine Konfigurationsdatei, um zu wissen, wo sich +Ihr Festplatten\-Array befindet und wo die Paritätsinformationen +gespeichert werden sollen. +.PP +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. +.PP +Sie muss die folgenden Optionen (Groß\- und Kleinschreibung beachten) +enthalten: +.SS 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. +.PP +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. +.PP +Sie können später zusätzliche Paritätsdateien hinzufügen, aber Sie +können sie nicht neu anordnen oder entfernen. +.PP +Das Reservieren der Paritätsfestplatten für Parität stellt sicher, +dass sie nicht fragmentiert werden, was die Leistung verbessert. +.PP +Unter Windows werden 256 MB auf jeder Festplatte ungenutzt gelassen, +um die Warnung vor vollen Festplatten zu vermeiden. +.PP +Diese Option ist obligatorisch und kann nur einmal verwendet werden. +.SS (2,3,4,5,6)\-parity FILE [,FILE] ... +Definiert die Dateien, die zum Speichern zusätzlicher Paritätsinformationen +verwendet werden sollen. +.PP +Für jede angegebene Paritätsstufe wird eine zusätzliche Schutzstufe +aktiviert: +.PD 0 +.IP \(bu +2\-parity aktiviert RAID6 Dual\-Parität. +.IP \(bu +3\-parity aktiviert Triple\-Parität. +.IP \(bu +4\-parity aktiviert Quad\- (vierfache) Parität. +.IP \(bu +5\-parity aktiviert Penta\- (fünffache) Parität. +.IP \(bu +6\-parity aktiviert Hexa\- (sechsfache) Parität. +.PD +.PP +Jede Paritätsstufe erfordert die Anwesenheit aller vorherigen +Paritätsstufen. +.PP +Die gleichen Überlegungen wie bei der Option \'parity\' gelten. +.PP +Diese Optionen sind optional und können nur einmal verwendet werden. +.SS z\-parity FILE [,FILE] ... +Definiert eine alternative Datei und ein alternatives Format zum +Speichern von Triple\-Parität. +.PP +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. +.PP +Dieses Format ähnelt dem von ZFS RAIDZ3, ist aber schneller. +Wie ZFS funktioniert es nicht jenseits der Triple\-Parität. +.PP +Bei Verwendung von \'3\-parity\' werden Sie gewarnt, wenn das +\'z\-parity\'\-Format zur Leistungsverbesserung empfohlen wird. +.PP +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. +.SS content FILE +Definiert die Datei, die zum Speichern der Liste und Prüfsummen +aller im Festplatten\-Array vorhandenen Dateien verwendet werden soll. +.PP +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. +.PP +Diese Option ist obligatorisch und kann mehrmals verwendet werden, +um mehrere Kopien derselben Datei zu speichern. +.PP +Sie müssen mindestens eine Kopie für jede verwendete Paritätsfestplatte +plus eine speichern. Die Verwendung zusätzlicher Kopien schadet nicht. +.SS 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. +.PP +Sie können den Einhängepunkt nach Bedarf ändern, solange Sie +den NAME unverändert lassen. +.PP +Sie sollten eine Option für jede Datenfestplatte im Array verwenden. +.PP +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. +.SS 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. +.SS 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. +.PP +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. +.PP +Weitere Details zu Musterspezifikationen finden Sie im Abschnitt +PATTERN. +.PP +Diese Option kann mehrmals verwendet werden. +.SS blocksize SIZE_IN_KIBIBYTES +Definiert die grundlegende Blockgröße in Kibibytes für die Parität. +Ein Kibibyte entspricht 1024 Bytes. +.PP +Die Standard\-Blockgröße ist 256, was für die meisten Fälle +ausreichen sollte. +.PP +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! +.PP +Ein Grund für die Verwendung einer anderen Blockgröße ist, wenn Sie +viele kleine Dateien in der Größenordnung von Millionen haben. +.PP +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. +.PP +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. +.PP +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. +.PP +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. +.PP +Ein Trick, um eine größere Paritätspartition unter Linux zu erhalten, +ist die Formatierung mit dem Befehl: +.PP +.RS 4 +mkfs.ext4 \-m 0 \-T largefile4 DEVICE +.PD 0 +.PD +.RE +.PP +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. +.SS hashsize SIZE_IN_BYTES +Definiert die Hash\-Größe in Bytes für die gespeicherten Blöcke. +.PP +Die Standard\-Hash\-Größe beträgt 16 Bytes (128 Bit), was für die +meisten Fälle ausreichen sollte. +.PP +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! +.PP +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. +.PP +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. +.PP +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: +.PP +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB +.PD 0 +.PD +.PP +Bei einem Wechsel zu einer Hash\-Größe von 8 erhalten Sie: +.PP +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB +.PD 0 +.PD +.PP +Bei einem Wechsel zu einer Blockgröße von 512 erhalten Sie: +.PP +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB +.PD 0 +.PD +.PP +Bei einem Wechsel zu einer Hash\-Größe von 8 und einer Blockgröße +von 512 erhalten Sie: +.PP +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB +.PD 0 +.PD +.SS 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. +.SS 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. +.PP +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. +.PP +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. +.PP +Normalerweise zeigt SnapRAID nur die Temperatur der heißesten +Festplatte an. Um die Temperatur aller Festplatten anzuzeigen, +verwenden Sie die Option \-A oder \-\-stats. +.SS 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. +.SS pool DIR +Definiert das Pooling\-Verzeichnis, in dem die virtuelle Ansicht des +Festplatten\-Arrays mithilfe des Befehls \`pool\` erstellt wird. +.PP +Das Verzeichnis muss bereits existieren. +.SS share UNC_DIR +Definiert den Windows UNC\-Pfad, der für den Remote\-Zugriff auf die +Festplatten erforderlich ist. +.PP +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. +.PP +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. +.PP +Diese Option ist nur für Windows erforderlich. +.SS 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. +.PP +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\`. +.PP +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. +.PP +Weitere mögliche Optionen finden Sie in der smartmontools\-Dokumentation: +.PP +.RS 4 +https://www.smartmontools.org/wiki/Supported_RAID\-Controllers +.PD 0 +.PP +.PD +https://www.smartmontools.org/wiki/Supported_USB\-Devices +.PD 0 +.PD +.RE +.PP +Zum Beispiel: +.PP +.RS 4 +smartctl parity \-d sat %s +.PD 0 +.PD +.RE +.SS 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. +.PP +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. +.PP +Um beispielsweise das Attribut \`Current Pending Sector Count\` auf allen +Festplatten zu ignorieren: +.PP +.RS 4 +smartignore * 197 +.PD 0 +.PD +.RE +.PP +Um es nur auf der ersten Paritätsfestplatte zu ignorieren: +.PP +.RS 4 +smartignore parity 197 +.PD 0 +.PD +.RE +.SS Examples +Ein Beispiel für eine typische Konfiguration für Unix ist: +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /mnt/diskp/snapraid.content +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +exclude /tmp/ +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/sg0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/sg0 +.PD 0 +.PD +.RE +.PP +Ein Beispiel für eine typische Konfiguration für Windows ist: +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content E:\\snapraid.content +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +data d1 G:\\array\\ +.PD 0 +.PP +.PD +data d2 H:\\array\\ +.PD 0 +.PP +.PD +data d3 I:\\array\\ +.PD 0 +.PP +.PD +exclude Thumbs.db +.PD 0 +.PP +.PD +exclude \\$RECYCLE.BIN +.PD 0 +.PP +.PD +exclude \\System Volume Information +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/arcmsr0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 +.PD 0 +.PD +.RE +.SH PATTERN +Muster werden verwendet, um eine Teilmenge von Dateien zum +Ausschließen oder Einschließen in den Prozess auszuwählen. +.PP +Es gibt vier verschiedene Arten von Mustern: +.TP +.B 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. +.TP +.B 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. +.TP +.B /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. +.TP +.B /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. +.PP +Wenn Sie einen absoluten Pfad angeben, der mit / beginnt, wird er +auf das Array\-Stammverzeichnis angewendet, nicht auf das lokale +Dateisystem\-Stammverzeichnis. +.PP +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. +.PP +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. +.PP +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: +.PP +.RS 4 +# Schließt jede Datei namens \`*.unrecoverable\` aus +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Schließt das Stammverzeichnis \`/lost+found\` aus +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +# Schließt jedes Unterverzeichnis namens \`tmp\` aus +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PD +.RE +.PP +Der gegenteilige Ansatz besteht darin, nur die Dateien zu definieren, +die Sie verarbeiten möchten, indem Sie nur \`include\`\-Regeln verwenden. +Zum Beispiel: +.PP +.RS 4 +# Schließt nur einige Verzeichnisse ein +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +# Schließt jede Datei namens \`*.unrecoverable\` aus +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Schließt jedes Unterverzeichnis namens \`tmp\` aus +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PP +.PD +# Schließt nur einige Verzeichnisse ein +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +In der Befehlszeile können Sie mit der Option \-f nur \`include\`\-Muster +verwenden. Zum Beispiel: +.PP +.RS 4 +# Überprüft nur die .mp3\-Dateien. +.PD 0 +.PP +.PD +# Unter Unix Anführungszeichen verwenden, um die Globbing\-Erweiterung durch die Shell zu vermeiden. +.PD 0 +.PP +.PD +snapraid \-f \[dq]*.mp3\[dq] check +.PD 0 +.PD +.RE +.PP +Unter Unix müssen Sie Globbing\-Zeichen in der Befehlszeile in +Anführungszeichen setzen, um zu verhindern, dass die Shell sie erweitert. +.SH CONTENT +SnapRAID speichert die Liste und Prüfsummen Ihrer Dateien in der +Content\-Datei. +.PP +Es ist eine Binärdatei, die alle im Festplatten\-Array vorhandenen +Dateien auflistet, zusammen mit allen Prüfsummen zur Überprüfung +ihrer Integrität. +.PP +Diese Datei wird von den Befehlen \`sync\` und \`scrub\` gelesen und +geschrieben und von den Befehlen \`fix\`, \`check\` und \`status\` gelesen. +.SH PARITY +SnapRAID speichert die Paritätsinformationen Ihres Arrays in den +Paritätsdateien. +.PP +Dies sind Binärdateien, die die berechnete Parität aller in der +\`content\`\-Datei definierten Blöcke enthalten. +.PP +Diese Dateien werden von den Befehlen \`sync\` und \`fix\` gelesen +und geschrieben und nur von den Befehlen \`scrub\` und \`check\` gelesen. +.SH ENCODING +SnapRAID ignoriert unter Unix jede Kodierung. Es liest und speichert +die Dateinamen mit derselben Kodierung, die vom Dateisystem +verwendet wird. +.PP +Unter Windows werden alle vom Dateisystem gelesenen Namen konvertiert +und im UTF\-8\-Format verarbeitet. +.PP +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. +.SH COPYRIGHT +Diese Datei ist Copyright (C) 2025 Andrea Mazzoleni +.SH SEE ALSO +snapraid_log(1), rsync(1) diff --git a/snapraid-de.d b/snapraid-de.d new file mode 100644 index 00000000..12aa9870 --- /dev/null +++ b/snapraid-de.d @@ -0,0 +1,1572 @@ +Name{number} + snapraid - SnapRAID Sicherung für Festplatten-Arrays + +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] + +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: + + * Sie können bereits mit Dateien gefüllte Festplatten verwenden, + ohne sie neu formatieren zu müssen, und wie gewohnt darauf zugreifen. + * Alle Ihre Daten werden gehasht, um die Datenintegrität zu + gewährleisten und stille Beschädigung (silent corruption) zu verhindern. + * Wenn die Anzahl der ausgefallenen Festplatten die Paritätsanzahl + überschreitet, beschränkt sich der Datenverlust auf die betroffenen + Festplatten; Daten auf anderen Festplatten bleiben zugänglich. + * Wenn Sie versehentlich Dateien auf einer Festplatte löschen, + ist eine Wiederherstellung möglich. + * Festplatten können unterschiedliche Größen haben. + * Sie können jederzeit Festplatten hinzufügen. + * SnapRAID sperrt Ihre Daten nicht ein; Sie können die Verwendung + jederzeit beenden, ohne neu formatieren oder Daten verschieben zu müssen. + * Um auf eine Datei zuzugreifen, muss nur eine einzige Festplatte + drehen (spinnen), was Strom spart und Geräusche reduziert. + + Für weitere Informationen besuchen Sie bitte die offizielle SnapRAID-Website: + + :https://www.snapraid.it/ + +Limitations + SnapRAID ist ein Hybrid aus einem RAID- und einem Sicherungsprogramm, + das darauf abzielt, die besten Vorteile beider zu kombinieren. + Es hat jedoch einige Einschränkungen, die Sie vor der Verwendung + berücksichtigen sollten. + + 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: + + * Mit SnapRAID haben Sie immer noch separate Dateisysteme für jede + Festplatte. Mit RAID erhalten Sie ein einziges großes Dateisystem. + * SnapRAID streift (stripes) keine Daten. + Mit RAID erhalten Sie einen Geschwindigkeitsvorteil durch Striping. + * SnapRAID unterstützt keine Echtzeit-Wiederherstellung. + Mit RAID müssen Sie die Arbeit nicht unterbrechen, wenn eine + Festplatte ausfällt. + * SnapRAID kann Daten nur von einer begrenzten Anzahl von Festplattenausfällen + wiederherstellen. Mit einer Sicherung können Sie von einem + vollständigen Ausfall des gesamten Festplatten-Arrays wiederherstellen. + * Nur Dateinamen, Zeitstempel, symbolische Links (symlinks) und + Hardlinks werden gespeichert. Berechtigungen, Eigentümerschaft + und erweiterte Attribute werden nicht gespeichert. + +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. + + 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. + + 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 + + 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 + + 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. + + 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. + + 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! + + 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. + + 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. + +Commands + SnapRAID bietet einige einfache Befehle, mit denen Sie: + + * Den Status des Arrays ausgeben -> `status` + * Die Festplatten steuern -> `smart`, `probe`, `up`, `down` + * Eine Sicherung/einen Snapshot erstellen -> `sync` + * Daten regelmäßig überprüfen -> `scrub` + * Die letzte Sicherung/den letzten Snapshot wiederherstellen -> `fix`. + + Befehle müssen in Kleinbuchstaben geschrieben werden. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + +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. + +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: + + 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. + + (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: + + * 2-parity aktiviert RAID6 Dual-Parität. + * 3-parity aktiviert Triple-Parität. + * 4-parity aktiviert Quad- (vierfache) Parität. + * 5-parity aktiviert Penta- (fünffache) Parität. + * 6-parity aktiviert Hexa- (sechsfache) Parität. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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 + + 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. + + 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. + + 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. + + 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. + + 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. + + 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 + + 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 + + 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 + +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. + +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. + +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. + +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. + +Copyright + Diese Datei ist Copyright (C) 2025 Andrea Mazzoleni + +See Also + snapraid_log(1), rsync(1) diff --git a/snapraid-de.txt b/snapraid-de.txt new file mode 100644 index 00000000..7a894647 --- /dev/null +++ b/snapraid-de.txt @@ -0,0 +1,1686 @@ + ========================================== + SnapRAID Sicherung für Festplatten-Arrays + ========================================== + + +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: + +* Sie können bereits mit Dateien gefüllte Festplatten verwenden, + ohne sie neu formatieren zu müssen, und wie gewohnt darauf zugreifen. +* Alle Ihre Daten werden gehasht, um die Datenintegrität zu + gewährleisten und stille Beschädigung (silent corruption) zu verhindern. +* Wenn die Anzahl der ausgefallenen Festplatten die Paritätsanzahl + überschreitet, beschränkt sich der Datenverlust auf die betroffenen + Festplatten; Daten auf anderen Festplatten bleiben zugänglich. +* Wenn Sie versehentlich Dateien auf einer Festplatte löschen, + ist eine Wiederherstellung möglich. +* Festplatten können unterschiedliche Größen haben. +* Sie können jederzeit Festplatten hinzufügen. +* SnapRAID sperrt Ihre Daten nicht ein; Sie können die Verwendung + jederzeit beenden, ohne neu formatieren oder Daten verschieben zu müssen. +* Um auf eine Datei zuzugreifen, muss nur eine einzige Festplatte + drehen (spinnen), was Strom spart und Geräusche reduziert. + +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: + +* Mit SnapRAID haben Sie immer noch separate Dateisysteme für jede + Festplatte. Mit RAID erhalten Sie ein einziges großes Dateisystem. +* SnapRAID streift (stripes) keine Daten. + Mit RAID erhalten Sie einen Geschwindigkeitsvorteil durch Striping. +* SnapRAID unterstützt keine Echtzeit-Wiederherstellung. + Mit RAID müssen Sie die Arbeit nicht unterbrechen, wenn eine + Festplatte ausfällt. +* SnapRAID kann Daten nur von einer begrenzten Anzahl von Festplattenausfällen + wiederherstellen. Mit einer Sicherung können Sie von einem + vollständigen Ausfall des gesamten Festplatten-Arrays wiederherstellen. +* Nur Dateinamen, Zeitstempel, symbolische Links (symlinks) und + Hardlinks werden gespeichert. Berechtigungen, Eigentümerschaft + und erweiterte Attribute werden nicht gespeichert. + + +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: + +* Den Status des Arrays ausgeben -> `status` +* Die Festplatten steuern -> `smart`, `probe`, `up`, `down` +* Eine Sicherung/einen Snapshot erstellen -> `sync` +* Daten regelmäßig überprüfen -> `scrub` +* Die letzte Sicherung/den letzten Snapshot wiederherstellen -> `fix`. + +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: + +* 2-parity aktiviert RAID6 Dual-Parität. +* 3-parity aktiviert Triple-Parität. +* 4-parity aktiviert Quad- (vierfache) Parität. +* 5-parity aktiviert Penta- (fünffache) Parität. +* 6-parity aktiviert Hexa- (sechsfache) Parität. + +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. + + +12 COPYRIGHT +============ + +Diese Datei ist Copyright (C) 2025 Andrea Mazzoleni + + +13 SEE ALSO +=========== + +snapraid_log(1), rsync(1) diff --git a/snapraid-es.1 b/snapraid-es.1 new file mode 100644 index 00000000..d2f970cb --- /dev/null +++ b/snapraid-es.1 @@ -0,0 +1,1966 @@ +.TH "SnapRAID Backup para Arrays de Discos" 1 +.SH NAME +snapraid \- SnapRAID Backup para Arrays de Discos +.SH SYNOPSIS +snapraid [\-c, \-\-conf CONFIG] +.PD 0 +.PP +.PD + [\-f, \-\-filter PATTERN] [\-d, \-\-filter\-disk NAME] +.PD 0 +.PP +.PD + [\-m, \-\-filter\-missing] [\-e, \-\-filter\-error] +.PD 0 +.PP +.PD + [\-a, \-\-audit\-only] [\-h, \-\-pre\-hash] [\-i, \-\-import DIR] +.PD 0 +.PP +.PD + [\-p, \-\-plan PERC|bad|new|full] +.PD 0 +.PP +.PD + [\-o, \-\-older\-than DAYS] [\-l, \-\-log FILE] +.PD 0 +.PP +.PD + [\-s, \-\-spin\-down\-on\-error] [\-w, \-\-bw\-limit RATE] +.PD 0 +.PP +.PD + [\-Z, \-\-force\-zero] [\-E, \-\-force\-empty] +.PD 0 +.PP +.PD + [\-U, \-\-force\-uuid] [\-D, \-\-force\-device] +.PD 0 +.PP +.PD + [\-N, \-\-force\-nocopy] [\-F, \-\-force\-full] +.PD 0 +.PP +.PD + [\-R, \-\-force\-realloc] +.PD 0 +.PP +.PD + [\-S, \-\-start BLKSTART] [\-B, \-\-count BLKCOUNT] +.PD 0 +.PP +.PD + [\-L, \-\-error\-limit NUMBER] +.PD 0 +.PP +.PD + [\-A, \-\-stats] +.PD 0 +.PP +.PD + [\-v, \-\-verbose] [\-q, \-\-quiet] +.PD 0 +.PP +.PD + status|smart|probe|up|down|diff|sync|scrub|fix|check +.PD 0 +.PP +.PD + |list|dup|pool|devices|touch|rehash +.PD 0 +.PD +.PP +snapraid [\-V, \-\-version] [\-H, \-\-help] [\-C, \-\-gen\-conf CONTENT] +.PD 0 +.PD +.SH 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. +.PP +Destinado principalmente a centros de medios domésticos con archivos +grandes y que cambian con poca frecuencia, SnapRAID ofrece varias +características: +.PD 0 +.IP \(bu +Puede utilizar discos ya llenos de archivos sin la necesidad de +reformatearlos, accediendo a ellos como de costumbre. +.IP \(bu +Todos sus datos son hasheados para asegurar la integridad de los datos +y prevenir la corrupción silenciosa. +.IP \(bu +Cuando el número de discos fallidos excede el recuento de paridad, +la pérdida de datos se limita a los discos afectados; los datos en +otros discos siguen siendo accesibles. +.IP \(bu +Si elimina archivos accidentalmente en un disco, la recuperación es +posible. +.IP \(bu +Los discos pueden tener diferentes tamaños. +.IP \(bu +Puede agregar discos en cualquier momento. +.IP \(bu +SnapRAID no bloquea sus datos; puede dejar de usarlo +en cualquier momento sin reformatear ni mover datos. +.IP \(bu +Para acceder a un archivo, solo un único disco necesita girar, +ahorrando energía y reduciendo el ruido. +.PD +.PP +Para más información, visite el sitio oficial de SnapRAID: +.PP +.RS 4 +https://www.snapraid.it/ +.PD 0 +.PD +.RE +.SH LIMITATIONS +SnapRAID es un híbrido entre un programa RAID y un programa de copia +de seguridad, con el objetivo de combinar los mejores beneficios de +ambos. Sin embargo, tiene algunas limitaciones que debe considerar +antes de usarlo. +.PP +La principal limitación es que si un disco falla y no ha sincronizado +recientemente, es posible que no pueda recuperarse por completo. +Más específicamente, es posible que no pueda recuperar hasta el tamaño +de los archivos cambiados o eliminados desde la última operación de +sincronización. Esto ocurre incluso si los archivos cambiados o +eliminados no están en el disco fallido. Esta es la razón por la que +SnapRAID es más adecuado para datos que rara vez cambian. +.PP +Por otro lado, los archivos recién agregados no impiden la recuperación +de los archivos ya existentes. Solo perderá los archivos recién +agregados si están en el disco fallido. +.PP +Otras limitaciones de SnapRAID son: +.PD 0 +.IP \(bu +Con SnapRAID, aún tiene sistemas de archivos separados para cada disco. +Con RAID, obtiene un único sistema de archivos grande. +.IP \(bu +SnapRAID no distribuye (stripe) los datos. +Con RAID, obtiene un aumento de velocidad con la distribución. +.IP \(bu +SnapRAID no admite la recuperación en tiempo real. +Con RAID, no tiene que dejar de trabajar cuando falla un disco. +.IP \(bu +SnapRAID puede recuperar datos solo de un número limitado de fallos de disco. +Con una copia de seguridad, puede recuperarse de un fallo completo +de todo el array de discos. +.IP \(bu +Solo se guardan nombres de archivo, marcas de tiempo, enlaces simbólicos +y enlaces duros. Los permisos, la propiedad y los atributos +extendidos no se guardan. +.PD +.SH 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. +.PP +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. +.PP +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. +.PP +Estos discos estarán dedicados a almacenar los archivos de \`parity\`. +No debe almacenar sus datos en ellos. +.PP +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. +.PP +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. +.PP +Por ejemplo, suponga que solo está interesado en un nivel de paridad +de protección, y sus discos están ubicados en: +.PP +.RS 4 +/mnt/diskp <\- disco seleccionado para paridad +.PD 0 +.PP +.PD +/mnt/disk1 <\- primer disco a proteger +.PD 0 +.PP +.PD +/mnt/disk2 <\- segundo disco a proteger +.PD 0 +.PP +.PD +/mnt/disk3 <\- tercer disco a proteger +.PD 0 +.PD +.RE +.PP +Debe crear el archivo de configuración /etc/snapraid.conf con +las siguientes opciones: +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk1/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk2/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PD +.RE +.PP +Si está en Windows, debe usar el formato de ruta de Windows, con +letras de unidad y barras invertidas en lugar de barras. +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +content F:\\array\\snapraid.content +.PD 0 +.PP +.PD +content G:\\array\\snapraid.content +.PD 0 +.PP +.PD +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PD +.RE +.PP +Si tiene muchos discos y se queda sin letras de unidad, puede montar +discos directamente en subcarpetas. Consulte: +.PP +.RS 4 +https://www.google.com/search?q=Windows+mount+point +.PD 0 +.PD +.RE +.PP +En este punto, está listo para ejecutar el comando \`sync\` (sincronizar) +para construir la información de paridad. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +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. +.PP +Puede detenerlo en cualquier momento presionando Ctrl+C, y en la +siguiente ejecución, se reanudará donde se interrumpió. +.PP +Cuando este comando se complete, sus datos estarán SEGUROS. +.PP +Ahora puede comenzar a usar su array como desee y periódicamente +actualizar la información de paridad ejecutando el comando \`sync\`. +.SS Scrubbing +Para verificar periódicamente los datos y la paridad en busca de +errores, puede ejecutar el comando \`scrub\` (fregar/limpiar). +.PP +.RS 4 +snapraid scrub +.PD 0 +.PD +.RE +.PP +Este comando compara los datos de su array con el hash calculado +durante el comando \`sync\` para verificar la integridad. +.PP +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: +.PP +.RS 4 +snapraid \-p 5 \-o 20 scrub +.PD 0 +.PD +.RE +.PP +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\`. +.PP +.RS 4 +snapraid status +.PD 0 +.PD +.RE +.PP +Para corregirlos, puede usar el comando \`fix\` (arreglar), filtrando +por bloques defectuosos con la opción \-e, \-\-filter\-error: +.PP +.RS 4 +snapraid \-e fix +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid \-p bad scrub +.PD 0 +.PD +.RE +.PP +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. +.SS 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. +.PP +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. +.PP +Puede configurar el directorio de \`pooling\` en el archivo de +configuración con: +.PP +.RS 4 +pool /pool +.PD 0 +.PD +.RE +.PP +o, si está en Windows, con: +.PP +.RS 4 +pool C:\\pool +.PD 0 +.PD +.RE +.PP +y luego ejecute el comando \`pool\` para crear o actualizar la vista virtual. +.PP +.RS 4 +snapraid pool +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +# En la sección global de smb.conf +.PD 0 +.PP +.PD +unix extensions = no +.PD 0 +.PD +.RE +.PP +.RS 4 +# En la sección de compartir de smb.conf +.PD 0 +.PP +.PD +[pool] +.PD 0 +.PP +.PD +comment = Pool +.PD 0 +.PP +.PD +path = /pool +.PD 0 +.PP +.PD +read only = yes +.PD 0 +.PP +.PD +guest ok = yes +.PD 0 +.PP +.PD +wide links = yes +.PD 0 +.PP +.PD +follow symlinks = yes +.PD 0 +.PD +.RE +.PP +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. +.PP +Por ejemplo, operando desde un servidor llamado \`darkstar\`, puede usar +las opciones: +.PP +.RS 4 +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PP +.PD +pool C:\\pool +.PD 0 +.PP +.PD +share \\\\darkstar +.PD 0 +.PD +.RE +.PP +y compartir los siguientes directorios a través de la red: +.PP +.RS 4 +\\\\darkstar\\pool \-> C:\\pool +.PD 0 +.PP +.PD +\\\\darkstar\\d1 \-> F:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d2 \-> G:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d3 \-> H:\\array +.PD 0 +.PD +.RE +.PP +para permitir que los clientes remotos accedan a todos los archivos +en \\\\darkstar\\pool. +.PP +También puede que deba configurar los clientes remotos para habilitar +el acceso a enlaces simbólicos remotos con el comando: +.PP +.RS 4 +fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1 +.PD 0 +.PD +.RE +.SS 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: +.PP +.RS 4 +snapraid fix \-f FILE +.PD 0 +.PD +.RE +.PP +o para un directorio: +.PP +.RS 4 +snapraid fix \-f DIR/ +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid fix \-m \-f DIR/ +.PD 0 +.PD +.RE +.PP +O para recuperar todos los archivos eliminados en todas las unidades con: +.PP +.RS 4 +snapraid fix \-m +.PD 0 +.PD +.RE +.SS Recovering +Ha sucedido lo peor, ¡y ha perdido uno o más discos! +.PP +¡NO ENTRE EN PÁNICO! ¡Podrá recuperarlos! +.PP +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. +.PP +Luego, proceda con los siguientes pasos. +.SS 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. +.PP +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. +.PP +Por ejemplo, si el disco \`d1\` ha fallado, cambie de: +.PP +.RS 4 +data d1 /mnt/disk1/ +.PD 0 +.PD +.RE +.PP +a: +.PP +.RS 4 +data d1 /mnt/new_spare_disk/ +.PD 0 +.PD +.RE +.PP +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. +.SS STEP 2 \-> Fix +Ejecute el comando fix, almacenando el registro en un archivo externo con: +.PP +.RS 4 +snapraid \-d NAME \-l fix.log fix +.PD 0 +.PD +.RE +.PP +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. +.PP +Este comando tardará mucho tiempo. +.PP +Asegúrese de tener unos pocos gigabytes libres para almacenar el archivo +fix.log. Ejecútelo desde un disco con suficiente espacio libre. +.PP +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\`. +.PP +Puede encontrar una lista detallada de todos los bloques irrecuperables +en el archivo fix.log buscando todas las líneas que comienzan con \`unrecoverable:\`. +.PP +Si no está satisfecho con la recuperación, puede volver a intentarlo +tantas veces como desee. +.PP +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. +.PP +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\`! +.SS 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. +.PP +.RS 4 +snapraid \-d NAME \-a check +.PD 0 +.PD +.RE +.PP +Donde NAME es el nombre del disco, como \`d1\` en nuestro ejemplo anterior. +.PP +Las opciones \-d y \-a le dicen a SnapRAID que compruebe solo el disco +especificado e ignore todos los datos de paridad. +.PP +Este comando tardará mucho tiempo, pero si no es demasiado cauteloso, +puede omitirlo. +.SS STEP 4 \-> Sync +Ejecute el comando \`sync\` para resincronizar el array con el nuevo disco. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +Si todo se recupera, este comando es inmediato. +.SH COMMANDS +SnapRAID proporciona algunos comandos simples que le permiten: +.PD 0 +.IP \(bu +Imprimir el estado del array \-> \`status\` +.IP \(bu +Controlar los discos \-> \`smart\`, \`probe\`, \`up\`, \`down\` +.IP \(bu +Hacer una copia de seguridad/instantánea \-> \`sync\` +.IP \(bu +Comprobar periódicamente los datos \-> \`scrub\` +.IP \(bu +Restaurar la última copia de seguridad/instantánea \-> \`fix\`. +.PD +.PP +Los comandos deben escribirse en minúsculas. +.SS status +Imprime un resumen del estado del array de discos. +.PP +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. +.PP +La información presentada se refiere a la última vez que ejecutó +\`sync\`. Las modificaciones posteriores no se tienen en cuenta. +.PP +Si se detectaron bloques defectuosos, se enumeran sus números de bloque. +Para corregirlos, puede usar el comando \`fix \-e\`. +.PP +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\'. +.PP +Nada se modifica. +.SS smart +Imprime un informe SMART de todos los discos del sistema. +.PP +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. +.PP +Esta estimación de probabilidad se obtiene correlacionando los +atributos SMART de los discos con los datos de Backblaze disponibles en: +.PP +.RS 4 +https://www.backblaze.com/hard\-drive\-test\-data.html +.PD 0 +.PD +.RE +.PP +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. +.PP +Otras posibles cadenas de estado son: +.RS 4 +.PD 0 +.HP 4 +.I logfail +En el pasado, algunos atributos estaban por debajo del +umbral. +.HP 4 +.I logerr +El registro de errores del dispositivo contiene errores. +.HP 4 +.I selferr +El registro de autoprueba del dispositivo contiene errores. +.PD +.RE +.PP +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. +.PP +Este comando utiliza la herramienta \`smartctl\` y es equivalente a +ejecutar \`smartctl \-a\` en todos los dispositivos. +.PP +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. +.PP +Nada se modifica. +.SS probe +Imprime el estado de ENERGÍA de todos los discos del sistema. +.PP +\`Standby\` significa que el disco no está girando. \`Active\` significa +que el disco está girando. +.PP +Este comando utiliza la herramienta \`smartctl\` y es equivalente a +ejecutar \`smartctl \-n standby \-i\` en todos los dispositivos. +.PP +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. +.PP +Nada se modifica. +.SS up +Pone en marcha (gira) todos los discos del array. +.PP +Puede poner en marcha solo discos específicos usando la opción \-d, +\-\-filter\-disk. +.PP +Poner en marcha todos los discos al mismo tiempo requiere mucha energía. +Asegúrese de que su fuente de alimentación pueda soportarlo. +.PP +Nada se modifica. +.SS down +Detiene (deja de girar) todos los discos del array. +.PP +Este comando utiliza la herramienta \`smartctl\` y es equivalente a +ejecutar \`smartctl \-s standby,now\` en todos los dispositivos. +.PP +Puede detener solo discos específicos usando la opción \-d, +\-\-filter\-disk. +.PP +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. +.PP +Nada se modifica. +.SS diff +Enumera todos los archivos modificados desde el último \`sync\` que +necesitan que se vuelva a calcular su información de paridad. +.PP +Este comando no verifica los datos del archivo, sino solo la marca +de tiempo, el tamaño y el inodo del archivo. +.PP +Después de enumerar todos los archivos cambiados, se presenta un +resumen de los cambios, agrupados por: +.RS 4 +.PD 0 +.HP 4 +.I equal +Archivos sin cambios desde antes. +.HP 4 +.I added +Archivos agregados que no estaban presentes antes. +.HP 4 +.I removed +Archivos eliminados. +.HP 4 +.I updated +Archivos con un tamaño o marca de tiempo diferente, +lo que significa que fueron modificados. +.HP 4 +.I 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. +.HP 4 +.I 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. +.HP 4 +.I 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. +.PD +.RE +.PP +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. +.PP +Nada se modifica. +.SS 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. +.PP +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ó. +.PP +Si se encuentran errores silenciosos o de entrada/salida durante el +proceso, los bloques correspondientes se marcan como defectuosos. +.PP +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. +.PP +Los archivos \`content\` y \`parity\` se modifican si es necesario. +Los archivos en el array NO se modifican. +.SS scrub +Frota (scrubs) el array, buscando errores silenciosos o de +entrada/salida en los discos de datos y paridad. +.PP +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. +.PP +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. +.PP +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\`. +.PP +Para obtener detalles del estado del fregado, use el comando \`status\`. +.PP +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\`. +.PP +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. +.PP +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. +.SS fix +Corrige todos los archivos y la información de paridad. +.PP +Todos los archivos y la información de paridad se comparan con el +estado de instantánea guardado en el último \`sync\`. +Si se encuentra una diferencia, se revierte a la instantánea almacenada. +.PP +¡ADVERTENCIA! El comando \`fix\` no diferencia entre errores y +modificaciones intencionales. Revierte incondicionalmente el estado +del archivo al último \`sync\`. +.PP +Si no se especifica otra opción, se procesa todo el array. +Utilice las opciones de filtro para seleccionar un subconjunto de +archivos o discos para operar. +.PP +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\`. +.PP +SnapRAID cambia el nombre de todos los archivos que no se pueden corregir +agregando la extensión \`.unrecoverable\`. +.PP +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. +.PP +Los archivos se identifican solo por ruta, no por inodo. +.PP +El archivo \`content\` NO se modifica. +Los archivos \`parity\` se modifican si es necesario. +Los archivos en el array se modifican si es necesario. +.SS check +Verifica todos los archivos y la información de paridad. +.PP +Funciona como \`fix\`, pero solo simula una recuperación y no se +escriben cambios en el array. +.PP +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\`. +.PP +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. +.PP +Los archivos se identifican solo por ruta, no por inodo. +.PP +Nada se modifica. +.SS list +Enumera todos los archivos contenidos en el array en el momento del +último \`sync\`. +.PP +Con \-v o \-\-verbose, también se muestra el tiempo de subsegundo. +.PP +Nada se modifica. +.SS 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. +.PP +Nada se modifica. +.SS pool +Crea o actualiza una vista virtual de todos +los archivos de su array de discos en el directorio de \`pooling\`. +.PP +Los archivos no se copian sino que se enlazan usando +enlaces simbólicos. +.PP +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. +.PP +Nada se modifica fuera del directorio pool. +.SS devices +Imprime los dispositivos de bajo nivel utilizados por el array. +.PP +Este comando muestra las asociaciones de dispositivos en el array +y está destinado principalmente como una interfaz de script. +.PP +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. +.PP +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. +.PP +Nada se modifica. +.SS touch +Establece una marca de tiempo de subsegundo arbitraria para todos los +archivos que la tienen establecida en cero. +.PP +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. +.PP +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. +.PP +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. +.SS rehash +Programa un nuevo cálculo de hash (rehash) de todo el array. +.PP +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. +.PP +Si ya está utilizando el hash óptimo, este comando +no hace nada y le informa que no se necesita ninguna acción. +.PP +El nuevo cálculo de hash no se realiza inmediatamente, sino que +tiene lugar progresivamente durante \`sync\` y \`scrub\`. +.PP +Puede verificar el estado del nuevo cálculo de hash usando \`status\`. +.PP +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. +.SH OPTIONS +SnapRAID proporciona las siguientes opciones: +.TP +.B \-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\`. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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. +.TP +.B \-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). +.TP +.B \-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. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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, \`\[dq]>>resultado.log\[dq]\`. +Para enviar el registro a la salida estándar o al error +estándar, puede usar \`\[dq]>&1\[dq]\` y \`\[dq]>&2\[dq]\`, respectivamente. +Consulte el archivo snapraid_log.txt o la página del manual +para obtener descripciones de las etiquetas de registro. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-B, \-\-count BLKCOUNT +Procesa solo el número de bloques especificado. +Esta opción es principalmente para recuperación manual avanzada. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-H, \-\-help +Imprime una pantalla de ayuda corta. +.TP +.B \-V, \-\-version +Imprime la versión del programa. +.SH 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. +.PP +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\`. +.PP +Debe contener las siguientes opciones (distingue entre mayúsculas y minúsculas): +.SS 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. +.PP +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. +.PP +Puede agregar archivos de paridad adicionales más tarde, pero no +puede reordenarlos ni eliminarlos. +.PP +Mantener los discos de paridad reservados para la paridad asegura +que no se fragmenten, mejorando el rendimiento. +.PP +En Windows, se dejan 256 MB sin usar en cada disco para evitar la +advertencia sobre discos llenos. +.PP +Esta opción es obligatoria y solo se puede usar una vez. +.SS (2,3,4,5,6)\-parity FILE [,FILE] ... +Define los archivos a usar para almacenar información de paridad +adicional. +.PP +Para cada nivel de paridad especificado, se habilita un nivel +adicional de protección: +.PD 0 +.IP \(bu +2\-parity habilita la paridad dual RAID6. +.IP \(bu +3\-parity habilita la paridad triple. +.IP \(bu +4\-parity habilita la paridad cuádruple. +.IP \(bu +5\-parity habilita la paridad quíntuple. +.IP \(bu +6\-parity habilita la paridad séxtuple. +.PD +.PP +Cada nivel de paridad requiere la presencia de todos los niveles +de paridad anteriores. +.PP +Se aplican las mismas consideraciones que para la opción \'parity\'. +.PP +Estas opciones son opcionales y solo se pueden usar una vez. +.SS z\-parity FILE [,FILE] ... +Define un archivo y un formato alternativos para almacenar paridad triple. +.PP +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. +.PP +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. +.PP +Al usar \'3\-parity\', se le advertirá si se recomienda usar +el formato \'z\-parity\' para mejorar el rendimiento. +.PP +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. +.SS 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. +.PP +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\`. +.PP +Esta opción es obligatoria y se puede usar varias veces para guardar +múltiples copias del mismo archivo. +.PP +Debe almacenar al menos una copia por cada disco de paridad utilizado +más uno. Usar copias adicionales no perjudica. +.SS 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. +.PP +Puede cambiar el punto de montaje según sea necesario, siempre que +mantenga el NAME fijo. +.PP +Debe usar una opción para cada disco de datos en el array. +.PP +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. +.SS 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. +.SS 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. +.PP +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\`. +.PP +Consulte la sección PATTERN para obtener más detalles sobre +las especificaciones de patrones. +.PP +Esta opción se puede usar varias veces. +.SS blocksize SIZE_IN_KIBIBYTES +Define el tamaño de bloque básico en kibibytes para la paridad. +Un kibibyte es 1024 bytes. +.PP +El tamaño de bloque predeterminado es 256, que debería funcionar +para la mayoría de los casos. +.PP +¡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! +.PP +Una razón para usar un tamaño de bloque diferente es si tiene +muchos archivos pequeños, del orden de millones. +.PP +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. +.PP +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. +.PP +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. +.PP +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. +.PP +Un truco para obtener una partición de paridad más grande en Linux +es formatearla con el comando: +.PP +.RS 4 +mkfs.ext4 \-m 0 \-T largefile4 DEVICE +.PD 0 +.PD +.RE +.PP +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. +.SS hashsize SIZE_IN_BYTES +Define el tamaño del hash en bytes para los bloques guardados. +.PP +El tamaño de hash predeterminado es de 16 bytes (128 bits), +que debería funcionar para la mayoría de los casos. +.PP +¡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! +.PP +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. +.PP +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. +.PP +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: +.PP +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB +.PD 0 +.PD +.PP +Cambiando a un tamaño de hash de 8, obtiene: +.PP +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB +.PD 0 +.PD +.PP +Cambiando a un tamaño de bloque de 512, obtiene: +.PP +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB +.PD 0 +.PD +.PP +Cambiando tanto a un tamaño de hash de 8 como a un tamaño de bloque de 512, +obtiene: +.PP +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB +.PD 0 +.PD +.SS 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. +.SS 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. +.PP +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. +.PP +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. +.PP +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. +.SS 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. +.SS pool DIR +Define el directorio de agrupación (pooling) donde se crea la vista +virtual del array de discos utilizando el comando \`pool\`. +.PP +El directorio ya debe existir. +.SS share UNC_DIR +Define la ruta UNC de Windows requerida para acceder a los discos +de forma remota. +.PP +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. +.PP +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. +.PP +Esta opción solo es necesaria para Windows. +.SS 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. +.PP +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\`. +.PP +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\`. +.PP +Consulte la documentación de smartmontools para conocer las posibles +opciones: +.PP +.RS 4 +https://www.smartmontools.org/wiki/Supported_RAID\-Controllers +.PD 0 +.PP +.PD +https://www.smartmontools.org/wiki/Supported_USB\-Devices +.PD 0 +.PD +.RE +.PP +Por ejemplo: +.PP +.RS 4 +smartctl parity \-d sat %s +.PD 0 +.PD +.RE +.SS 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. +.PP +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. +.PP +Por ejemplo, para ignorar el atributo \`Current Pending Sector Count\` +en todos los discos: +.PP +.RS 4 +smartignore * 197 +.PD 0 +.PD +.RE +.PP +Para ignorarlo solo en el primer disco de paridad: +.PP +.RS 4 +smartignore parity 197 +.PD 0 +.PD +.RE +.SS Examples +Un ejemplo de una configuración típica para Unix es: +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /mnt/diskp/snapraid.content +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +exclude /tmp/ +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/sg0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/sg0 +.PD 0 +.PD +.RE +.PP +Un ejemplo de una configuración típica para Windows es: +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content E:\\snapraid.content +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +data d1 G:\\array\\ +.PD 0 +.PP +.PD +data d2 H:\\array\\ +.PD 0 +.PP +.PD +data d3 I:\\array\\ +.PD 0 +.PP +.PD +exclude Thumbs.db +.PD 0 +.PP +.PD +exclude \\$RECYCLE.BIN +.PD 0 +.PP +.PD +exclude \\System Volume Information +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/arcmsr0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 +.PD 0 +.PD +.RE +.SH PATTERN +Los patrones se utilizan para seleccionar un subconjunto de archivos +para excluir o incluir en el proceso. +.PP +Hay cuatro tipos diferentes de patrones: +.TP +.B 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. +.TP +.B 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. +.TP +.B /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. +.TP +.B /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. +.PP +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. +.PP +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. +.PP +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. +.PP +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: +.PP +.RS 4 +# Excluye cualquier archivo llamado \`*.unrecoverable\` +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Excluye el directorio raíz \`/lost+found\` +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +# Excluye cualquier subdirectorio llamado \`tmp\` +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PD +.RE +.PP +El enfoque opuesto es definir solo los archivos que desea procesar, +utilizando solo reglas \`include\`. Por ejemplo: +.PP +.RS 4 +# Incluye solo algunos directorios +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +# Excluye cualquier archivo llamado \`*.unrecoverable\` +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Excluye cualquier subdirectorio llamado \`tmp\` +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PP +.PD +# Incluye solo algunos directorios +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +En la línea de comandos, usando la opción \-f, solo puede usar +patrones \`include\`. Por ejemplo: +.PP +.RS 4 +# Verifica solo los archivos .mp3. +.PD 0 +.PP +.PD +# En Unix, use comillas para evitar la expansión globbing por el shell. +.PD 0 +.PP +.PD +snapraid \-f \[dq]*.mp3\[dq] check +.PD 0 +.PD +.RE +.PP +En Unix, al usar caracteres globbing en la línea de comandos, debe +ponerlos entre comillas para evitar que el shell los expanda. +.SH CONTENT +SnapRAID almacena la lista y las sumas de comprobación de sus +archivos en el archivo de contenido. +.PP +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. +.PP +Este archivo es leído y escrito por los comandos \`sync\` y \`scrub\` +y leído por los comandos \`fix\`, \`check\` y \`status\`. +.SH PARITY +SnapRAID almacena la información de paridad de su array en los +archivos de paridad. +.PP +Estos son archivos binarios que contienen la paridad calculada +de todos los bloques definidos en el archivo \`content\`. +.PP +Estos archivos son leídos y escritos por los comandos \`sync\` y \`fix\` +y solo leídos por los comandos \`scrub\` y \`check\`. +.SH 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. +.PP +En Windows, todos los nombres leídos del sistema de archivos se +convierten y procesan en formato UTF\-8. +.PP +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. +.SH COPYRIGHT +Este archivo es Copyright (C) 2025 Andrea Mazzoleni +.SH SEE ALSO +snapraid_log(1), rsync(1) diff --git a/snapraid-es.d b/snapraid-es.d new file mode 100644 index 00000000..db2053a5 --- /dev/null +++ b/snapraid-es.d @@ -0,0 +1,1531 @@ +Name{number} + snapraid - SnapRAID Backup para Arrays de Discos + +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] + +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: + + * Puede utilizar discos ya llenos de archivos sin la necesidad de + reformatearlos, accediendo a ellos como de costumbre. + * Todos sus datos son hasheados para asegurar la integridad de los datos + y prevenir la corrupción silenciosa. + * Cuando el número de discos fallidos excede el recuento de paridad, + la pérdida de datos se limita a los discos afectados; los datos en + otros discos siguen siendo accesibles. + * Si elimina archivos accidentalmente en un disco, la recuperación es + posible. + * Los discos pueden tener diferentes tamaños. + * Puede agregar discos en cualquier momento. + * SnapRAID no bloquea sus datos; puede dejar de usarlo + en cualquier momento sin reformatear ni mover datos. + * Para acceder a un archivo, solo un único disco necesita girar, + ahorrando energía y reduciendo el ruido. + + Para más información, visite el sitio oficial de SnapRAID: + + :https://www.snapraid.it/ + +Limitations + SnapRAID es un híbrido entre un programa RAID y un programa de copia + de seguridad, con el objetivo de combinar los mejores beneficios de + ambos. Sin embargo, tiene algunas limitaciones que debe considerar + antes de usarlo. + + 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: + + * Con SnapRAID, aún tiene sistemas de archivos separados para cada disco. + Con RAID, obtiene un único sistema de archivos grande. + * SnapRAID no distribuye (stripe) los datos. + Con RAID, obtiene un aumento de velocidad con la distribución. + * SnapRAID no admite la recuperación en tiempo real. + Con RAID, no tiene que dejar de trabajar cuando falla un disco. + * SnapRAID puede recuperar datos solo de un número limitado de fallos de disco. + Con una copia de seguridad, puede recuperarse de un fallo completo + de todo el array de discos. + * Solo se guardan nombres de archivo, marcas de tiempo, enlaces simbólicos + y enlaces duros. Los permisos, la propiedad y los atributos + extendidos no se guardan. + +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`. + + 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. + + 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 + + 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 + + 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. + + 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. + + 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`! + + 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. + + 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. + +Commands + SnapRAID proporciona algunos comandos simples que le permiten: + + * Imprimir el estado del array -> `status` + * Controlar los discos -> `smart`, `probe`, `up`, `down` + * Hacer una copia de seguridad/instantánea -> `sync` + * Comprobar periódicamente los datos -> `scrub` + * Restaurar la última copia de seguridad/instantánea -> `fix`. + + Los comandos deben escribirse en minúsculas. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + +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. + +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): + + 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. + + (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: + + * 2-parity habilita la paridad dual RAID6. + * 3-parity habilita la paridad triple. + * 4-parity habilita la paridad cuádruple. + * 5-parity habilita la paridad quíntuple. + * 6-parity habilita la paridad séxtuple. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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 + + 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. + + 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. + + 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. + + 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. + + 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. + + 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 + + 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 + + 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 + +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. + +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`. + +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`. + +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. + +Copyright + Este archivo es Copyright (C) 2025 Andrea Mazzoleni + +See Also + snapraid_log(1), rsync(1) diff --git a/snapraid-es.txt b/snapraid-es.txt new file mode 100644 index 00000000..5e2ac292 --- /dev/null +++ b/snapraid-es.txt @@ -0,0 +1,1645 @@ + ===================================== + SnapRAID Backup para Arrays de Discos + ===================================== + + +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: + +* Puede utilizar discos ya llenos de archivos sin la necesidad de + reformatearlos, accediendo a ellos como de costumbre. +* Todos sus datos son hasheados para asegurar la integridad de los datos + y prevenir la corrupción silenciosa. +* Cuando el número de discos fallidos excede el recuento de paridad, + la pérdida de datos se limita a los discos afectados; los datos en + otros discos siguen siendo accesibles. +* Si elimina archivos accidentalmente en un disco, la recuperación es + posible. +* Los discos pueden tener diferentes tamaños. +* Puede agregar discos en cualquier momento. +* SnapRAID no bloquea sus datos; puede dejar de usarlo + en cualquier momento sin reformatear ni mover datos. +* Para acceder a un archivo, solo un único disco necesita girar, + ahorrando energía y reduciendo el ruido. + +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: + +* Con SnapRAID, aún tiene sistemas de archivos separados para cada disco. + Con RAID, obtiene un único sistema de archivos grande. +* SnapRAID no distribuye (stripe) los datos. + Con RAID, obtiene un aumento de velocidad con la distribución. +* SnapRAID no admite la recuperación en tiempo real. + Con RAID, no tiene que dejar de trabajar cuando falla un disco. +* SnapRAID puede recuperar datos solo de un número limitado de fallos de disco. + Con una copia de seguridad, puede recuperarse de un fallo completo + de todo el array de discos. +* Solo se guardan nombres de archivo, marcas de tiempo, enlaces simbólicos + y enlaces duros. Los permisos, la propiedad y los atributos + extendidos no se guardan. + + +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: + +* Imprimir el estado del array -> `status` +* Controlar los discos -> `smart`, `probe`, `up`, `down` +* Hacer una copia de seguridad/instantánea -> `sync` +* Comprobar periódicamente los datos -> `scrub` +* Restaurar la última copia de seguridad/instantánea -> `fix`. + +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: + +* 2-parity habilita la paridad dual RAID6. +* 3-parity habilita la paridad triple. +* 4-parity habilita la paridad cuádruple. +* 5-parity habilita la paridad quíntuple. +* 6-parity habilita la paridad séxtuple. + +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. + + +12 COPYRIGHT +============ + +Este archivo es Copyright (C) 2025 Andrea Mazzoleni + + +13 SEE ALSO +=========== + +snapraid_log(1), rsync(1) diff --git a/snapraid-fr.1 b/snapraid-fr.1 new file mode 100644 index 00000000..106ab7c0 --- /dev/null +++ b/snapraid-fr.1 @@ -0,0 +1,2013 @@ +.TH "Sauvegarde SnapRAID pour baies de disques" 1 +.SH NAME +snapraid \- Sauvegarde SnapRAID pour baies de disques +.SH SYNOPSIS +snapraid [\-c, \-\-conf CONFIG] +.PD 0 +.PP +.PD + [\-f, \-\-filter MOTIF] [\-d, \-\-filter\-disk NOM] +.PD 0 +.PP +.PD + [\-m, \-\-filter\-missing] [\-e, \-\-filter\-error] +.PD 0 +.PP +.PD + [\-a, \-\-audit\-only] [\-h, \-\-pre\-hash] [\-i, \-\-import DOSSIER] +.PD 0 +.PP +.PD + [\-p, \-\-plan PERC|mauvais|nouveau|complet] +.PD 0 +.PP +.PD + [\-o, \-\-older\-than JOURS] [\-l, \-\-log FICHIER] +.PD 0 +.PP +.PD + [\-s, \-\-spin\-down\-on\-error] [\-w, \-\-bw\-limit DÉBIT] +.PD 0 +.PP +.PD + [\-Z, \-\-force\-zero] [\-E, \-\-force\-empty] +.PD 0 +.PP +.PD + [\-U, \-\-force\-uuid] [\-D, \-\-force\-device] +.PD 0 +.PP +.PD + [\-N, \-\-force\-nocopy] [\-F, \-\-force\-full] +.PD 0 +.PP +.PD + [\-R, \-\-force\-realloc] +.PD 0 +.PP +.PD + [\-S, \-\-start BLKSTART] [\-B, \-\-count BLKCOUNT] +.PD 0 +.PP +.PD + [\-L, \-\-error\-limit NOMBRE] +.PD 0 +.PP +.PD + [\-A, \-\-stats] +.PD 0 +.PP +.PD + [\-v, \-\-verbose] [\-q, \-\-quiet] +.PD 0 +.PP +.PD + status|smart|probe|up|down|diff|sync|scrub|fix|check +.PD 0 +.PP +.PD + |list|dup|pool|devices|touch|rehash +.PD 0 +.PD +.PP +snapraid [\-V, \-\-version] [\-H, \-\-help] [\-C, \-\-gen\-conf CONTENU] +.PD 0 +.PD +.SH 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. +.PP +Principalement destiné aux centres multimédia domestiques avec des fichiers +volumineux et peu souvent modifiés, SnapRAID offre plusieurs fonctionnalités : +.PD 0 +.IP \(bu +Vous pouvez utiliser des disques déjà remplis de fichiers sans avoir besoin +de les reformater, en y accédant comme d\'habitude. +.IP \(bu +Toutes vos données sont hachées pour garantir l\'intégrité des données +et prévenir la corruption silencieuse. +.IP \(bu +Lorsque le nombre de disques défaillants dépasse le nombre de parités, +la perte de données est limitée aux disques affectés ; les données +sur les autres disques restent accessibles. +.IP \(bu +Si vous supprimez accidentellement des fichiers sur un disque, +la récupération est possible. +.IP \(bu +Les disques peuvent avoir des tailles différentes. +.IP \(bu +Vous pouvez ajouter des disques à tout moment. +.IP \(bu +SnapRAID ne verrouille pas vos données ; vous pouvez arrêter de l\'utiliser +à tout moment sans reformater ni déplacer de données. +.IP \(bu +Pour accéder à un fichier, un seul disque doit tourner, ce qui +économise de l\'énergie et réduit le bruit. +.PD +.PP +Pour plus d\'informations, veuillez visiter le site officiel de SnapRAID : +.PP +.RS 4 +https://www.snapraid.it/ +.PD 0 +.PD +.RE +.SH LIMITATIONS +SnapRAID est un hybride entre un programme RAID et un programme de sauvegarde, +visant à combiner les meilleurs avantages des deux. Cependant, il a quelques +limitations que vous devriez considérer avant de l\'utiliser. +.PP +La principale limitation est que si un disque tombe en panne et que vous +n\'avez pas synchronisé récemment, vous pourriez ne pas être en mesure de +récupérer complètement. +Plus précisément, vous pourriez ne pas être en mesure de récupérer jusqu\'à +la taille des fichiers modifiés ou supprimés depuis la dernière opération +de synchronisation. +Cela se produit même si les fichiers modifiés ou supprimés ne se trouvent +pas sur le disque défaillant. C\'est pourquoi SnapRAID est mieux adapté +aux données qui changent rarement. +.PP +D\'un autre côté, les fichiers nouvellement ajoutés n\'empêchent pas +la récupération des fichiers déjà existants. Vous ne perdrez que les +fichiers récemment ajoutés s\'ils se trouvent sur le disque défaillant. +.PP +Les autres limitations de SnapRAID sont : +.PD 0 +.IP \(bu +Avec SnapRAID, vous avez toujours des systèmes de fichiers séparés +pour chaque disque. Avec le RAID, vous obtenez un seul grand +système de fichiers. +.IP \(bu +SnapRAID ne fait pas de striping (entrelacement) des données. +Avec le RAID, vous obtenez un gain de vitesse avec le striping. +.IP \(bu +SnapRAID ne prend pas en charge la récupération en temps réel. +Avec le RAID, vous n\'avez pas à arrêter de travailler lorsqu\'un +disque tombe en panne. +.IP \(bu +SnapRAID ne peut récupérer des données que pour un nombre limité +de défaillances de disques. Avec une sauvegarde, vous pouvez +récupérer d\'une défaillance complète de toute la baie de disques. +.IP \(bu +Seuls les noms de fichiers, les horodatages, les liens symboliques +et les liens matériels sont sauvegardés. Les permissions, la +propriété et les attributs étendus ne sont pas sauvegardés. +.PD +.SH 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. +.PP +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. +.PP +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. +.PP +Ces disques seront dédiés au stockage des fichiers de \`parité\`. +Vous ne devriez pas y stocker vos données. +.PP +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. +.PP +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. +.PP +Par exemple, supposons que vous ne soyez intéressé que par un seul +niveau de protection de parité, et que vos disques se trouvent à : +.PP +.RS 4 +/mnt/diskp <\- disque sélectionné pour la parité +.PD 0 +.PP +.PD +/mnt/disk1 <\- premier disque à protéger +.PD 0 +.PP +.PD +/mnt/disk2 <\- deuxième disque à protéger +.PD 0 +.PP +.PD +/mnt/disk3 <\- troisième disque à protéger +.PD 0 +.PD +.RE +.PP +Vous devez créer le fichier de configuration /etc/snapraid.conf +avec les options suivantes : +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk1/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk2/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +content F:\\array\\snapraid.content +.PD 0 +.PP +.PD +content G:\\array\\snapraid.content +.PD 0 +.PP +.PD +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PD +.RE +.PP +Si vous avez de nombreux disques et manquez de lettres de lecteur, +vous pouvez monter les disques directement dans des sous\-dossiers. Voir : +.PP +.RS 4 +https://www.google.com/search?q=Windows+mount+point +.PD 0 +.PD +.RE +.PP +À ce stade, vous êtes prêt à exécuter la commande \`sync\` (synchroniser) +pour construire les informations de parité. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +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. +.PP +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. +.PP +Lorsque cette commande est terminée, vos données sont EN SÉCURITÉ. +.PP +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\`. +.SS Nettoyage (Scrubbing) +Pour vérifier périodiquement les données et la parité à la recherche +d\'erreurs, vous pouvez exécuter la commande \`scrub\`. +.PP +.RS 4 +snapraid scrub +.PD 0 +.PD +.RE +.PP +Cette commande compare les données de votre baie avec le hachage calculé +lors de la commande \`sync\` pour vérifier l\'intégrité. +.PP +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 : +.PP +.RS 4 +snapraid \-p 5 \-o 20 scrub +.PD 0 +.PD +.RE +.PP +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\`. +.PP +.RS 4 +snapraid status +.PD 0 +.PD +.RE +.PP +Pour les corriger, vous pouvez utiliser la commande \`fix\`, en filtrant +les mauvais blocs avec l\'option \-e, \-\-filter\-error : +.PP +.RS 4 +snapraid \-e fix +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid \-p bad scrub +.PD 0 +.PD +.RE +.PP +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. +.SS 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. +.PP +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. +.PP +Vous pouvez configurer le répertoire de \`pooling\` dans le fichier +de configuration avec : +.PP +.RS 4 +pool /pool +.PD 0 +.PD +.RE +.PP +ou, si vous êtes sous Windows, avec : +.PP +.RS 4 +pool C:\\pool +.PD 0 +.PD +.RE +.PP +puis exécutez la commande \`pool\` pour créer ou mettre à jour +la vue virtuelle. +.PP +.RS 4 +snapraid pool +.PD 0 +.PD +.RE +.PP +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 : +.PP +.RS 4 +# Dans la section globale de smb.conf +.PD 0 +.PP +.PD +unix extensions = no +.PD 0 +.PD +.RE +.PP +.RS 4 +# Dans la section de partage de smb.conf +.PD 0 +.PP +.PD +[pool] +.PD 0 +.PP +.PD +comment = Pool +.PD 0 +.PP +.PD +path = /pool +.PD 0 +.PP +.PD +read only = yes +.PD 0 +.PP +.PD +guest ok = yes +.PD 0 +.PP +.PD +wide links = yes +.PD 0 +.PP +.PD +follow symlinks = yes +.PD 0 +.PD +.RE +.PP +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. +.PP +Par exemple, en opérant à partir d\'un serveur nommé \`darkstar\`, +vous pouvez utiliser les options : +.PP +.RS 4 +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PP +.PD +pool C:\\pool +.PD 0 +.PP +.PD +share \\\\darkstar +.PD 0 +.PD +.RE +.PP +et partager les répertoires suivants sur le réseau : +.PP +.RS 4 +\\\\darkstar\\pool \-> C:\\pool +.PD 0 +.PP +.PD +\\\\darkstar\\d1 \-> F:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d2 \-> G:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d3 \-> H:\\array +.PD 0 +.PD +.RE +.PP +pour permettre aux clients distants d\'accéder à tous les fichiers +à \\\\darkstar\\pool. +.PP +Vous pourriez également avoir besoin de configurer les clients +distants pour activer l\'accès aux liens symboliques distants avec +la commande : +.PP +.RS 4 +fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1 +.PD 0 +.PD +.RE +.SS 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 : +.PP +.RS 4 +snapraid fix \-f FICHIER +.PD 0 +.PD +.RE +.PP +ou pour un répertoire : +.PP +.RS 4 +snapraid fix \-f DOSSIER/ +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid fix \-m \-f DOSSIER/ +.PD 0 +.PD +.RE +.PP +Ou pour récupérer tous les fichiers supprimés sur tous les +lecteurs avec : +.PP +.RS 4 +snapraid fix \-m +.PD 0 +.PD +.RE +.SS Récupération +Le pire est arrivé, et vous avez perdu un ou plusieurs disques ! +.PP +NE PANIQUEZ PAS ! Vous pourrez les récupérer ! +.PP +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é. +.PP +Procédez ensuite aux étapes suivantes. +.SS É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. +.PP +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. +.PP +Par exemple, si le disque \`d1\` a échoué, passez de : +.PP +.RS 4 +data d1 /mnt/disk1/ +.PD 0 +.PD +.RE +.PP +à : +.PP +.RS 4 +data d1 /mnt/new_spare_disk/ +.PD 0 +.PD +.RE +.PP +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. +.SS ÉTAPE 2 \-> Corriger (Fix) +Exécutez la commande fix, en stockant le journal dans un fichier +externe avec : +.PP +.RS 4 +snapraid \-d NOM \-l fix.log fix +.PD 0 +.PD +.RE +.PP +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. +.PP +Cette commande prendra beaucoup de temps. +.PP +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. +.PP +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\`. +.PP +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:\`. +.PP +Si la récupération ne vous satisfait pas, vous pouvez réessayer autant +de fois que vous le souhaitez. +.PP +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. +.PP +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\` ! +.SS É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é. +.PP +.RS 4 +snapraid \-d NOM \-a check +.PD 0 +.PD +.RE +.PP +Où NOM est le nom du disque, tel que \`d1\` dans notre exemple précédent. +.PP +Les options \-d et \-a indiquent à SnapRAID de vérifier uniquement le +disque spécifié et d\'ignorer toutes les données de parité. +.PP +Cette commande prendra beaucoup de temps, mais si vous n\'êtes pas +trop prudent, vous pouvez la sauter. +.SS ÉTAPE 4 \-> Synchroniser (Sync) +Exécutez la commande \`sync\` pour resynchroniser la baie avec le nouveau +disque. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +Si tout est récupéré, cette commande est immédiate. +.SH COMMANDES +SnapRAID fournit quelques commandes simples qui vous permettent de : +.PD 0 +.IP \(bu +Afficher l\'état de la baie de disques \-> \`status\` +.IP \(bu +Contrôler les disques \-> \`smart\`, \`probe\`, \`up\`, \`down\` +.IP \(bu +Faire une sauvegarde/instantané \-> \`sync\` +.IP \(bu +Vérifier périodiquement les données \-> \`scrub\` +.IP \(bu +Restaurer la dernière sauvegarde/instantané \-> \`fix\`. +.PD +.PP +Les commandes doivent être écrites en minuscules. +.SS status +Affiche un résumé de l\'état de la baie de disques. +.PP +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. +.PP +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. +.PP +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\`. +.PP +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\'. +.PP +Rien n\'est modifié. +.SS smart +Affiche un rapport SMART de tous les disques du système. +.PP +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. +.PP +Cette estimation de probabilité est obtenue en corrélant les attributs +SMART des disques avec les données Backblaze disponibles à : +.PP +.RS 4 +https://www.backblaze.com/hard\-drive\-test\-data.html +.PD 0 +.PD +.RE +.PP +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é. +.PP +Les autres chaînes d\'état possibles sont : +.RS 4 +.PD 0 +.HP 4 +.I logfail +Dans le passé, certains attributs étaient inférieurs +au seuil. +.HP 4 +.I logerr +Le journal d\'erreurs du périphérique contient des erreurs. +.HP 4 +.I selferr +Le journal d\'auto\-test du périphérique contient des erreurs. +.PD +.RE +.PP +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é. +.PP +Cette commande utilise l\'outil \`smartctl\` et équivaut à exécuter +\`smartctl \-a\` sur tous les périphériques. +.PP +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. +.PP +Rien n\'est modifié. +.SS probe +Affiche l\'état d\'ALIMENTATION de tous les disques du système. +.PP +\`Standby\` signifie que le disque ne tourne pas. \`Active\` signifie +que le disque tourne. +.PP +Cette commande utilise l\'outil \`smartctl\` et équivaut à exécuter +\`smartctl \-n standby \-i\` sur tous les périphériques. +.PP +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. +.PP +Rien n\'est modifié. +.SS up +Fait tourner (spin up) tous les disques de la baie. +.PP +Vous pouvez faire tourner uniquement des disques spécifiques +en utilisant l\'option \-d, \-\-filter\-disk. +.PP +Faire tourner tous les disques en même temps nécessite beaucoup +d\'énergie. Assurez\-vous que votre alimentation peut le supporter. +.PP +Rien n\'est modifié. +.SS down +Arrête (spin down) tous les disques de la baie. +.PP +Cette commande utilise l\'outil \`smartctl\` et équivaut à exécuter +\`smartctl \-s standby,now\` sur tous les périphériques. +.PP +Vous pouvez arrêter uniquement des disques spécifiques +en utilisant l\'option \-d, \-\-filter\-disk. +.PP +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. +.PP +Rien n\'est modifié. +.SS diff +Liste tous les fichiers modifiés depuis le dernier \`sync\` qui +nécessitent la recomputation de leurs données de parité. +.PP +Cette commande ne vérifie pas les données des fichiers, +mais uniquement l\'horodatage, la taille et l\'inode du fichier. +.PP +Après avoir listé tous les fichiers modifiés, un résumé des +modifications est présenté, regroupé par : +.RS 4 +.PD 0 +.HP 4 +.I equal +Fichiers inchangés par rapport à avant. +.HP 4 +.I added +Fichiers ajoutés qui n\'étaient pas présents auparavant. +.HP 4 +.I removed +Fichiers supprimés. +.HP 4 +.I updated +Fichiers avec une taille ou un horodatage différent, +signifiant qu\'ils ont été modifiés. +.HP 4 +.I 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. +.HP 4 +.I 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. +.HP 4 +.I 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. +.PD +.RE +.PP +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. +.PP +Rien n\'est modifié. +.SS 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. +.PP +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. +.PP +Si des erreurs silencieuses ou d\'entrée/sortie sont trouvées +pendant le processus, les blocs correspondants sont marqués comme mauvais. +.PP +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. +.PP +Les fichiers \`content\` et \`parity\` sont modifiés si nécessaire. +Les fichiers dans la baie NE SONT PAS modifiés. +.SS scrub +Nettoie la baie, vérifiant les erreurs silencieuses ou d\'entrée/sortie +dans les disques de données et de parité. +.PP +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. +.PP +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. +.PP +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\`. +.PP +Pour obtenir des détails sur l\'état du nettoyage, utilisez la commande +\`status\`. +.PP +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 \[dq]mauvais\[dq] sera supprimée. +Pour nettoyer uniquement les mauvais blocs, vous pouvez utiliser la +commande \`scrub \-p bad\`. +.PP +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. +.PP +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. +.SS fix +Corrige tous les fichiers et les données de parité. +.PP +Tous les fichiers et les données de parité sont comparés à l\'état +de l\'instantané enregistré lors du dernier \`sync\`. +Si une différence est trouvée, elle est rétablie à l\'instantané stocké. +.PP +AVERTISSEMENT ! La commande \`fix\` ne fait pas de distinction entre +les erreurs et les modifications intentionnelles. Elle rétablit +inconditionnellement l\'état du fichier au dernier \`sync\`. +.PP +Si aucune autre option n\'est spécifiée, l\'intégralité de la baie est traitée. +Utilisez les options de filtre pour sélectionner un sous\-ensemble de +fichiers ou de disques sur lesquels opérer. +.PP +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\`. +.PP +SnapRAID renomme tous les fichiers qui ne peuvent pas être corrigés +en ajoutant l\'extension \`.unrecoverable\`. +.PP +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. +.PP +Les fichiers sont identifiés uniquement par chemin, pas par inode. +.PP +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. +.SS check +Vérifie tous les fichiers et les données de parité. +.PP +Il fonctionne comme \`fix\`, mais il simule seulement une récupération +et aucune modification n\'est écrite sur la baie. +.PP +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\`. +.PP +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. +.PP +Les fichiers sont identifiés uniquement par chemin, pas par inode. +.PP +Rien n\'est modifié. +.SS list +Liste tous les fichiers contenus dans la baie au moment du dernier +\`sync\`. +.PP +Avec \-v ou \-\-verbose, l\'heure en sous\-seconde est également affichée. +.PP +Rien n\'est modifié. +.SS 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. +.PP +Rien n\'est modifié. +.SS pool +Crée ou met à jour une vue virtuelle de tous +les fichiers de votre baie de disques dans le répertoire \`pooling\`. +.PP +Les fichiers ne sont pas copiés mais liés à l\'aide de +liens symboliques. +.PP +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. +.PP +Rien n\'est modifié en dehors du répertoire du pool. +.SS devices +Affiche les périphériques de bas niveau utilisés par la baie. +.PP +Cette commande affiche les associations de périphériques dans la baie +et est principalement destinée à être une interface de script. +.PP +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. +.PP +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. +.PP +Rien n\'est modifié. +.SS touch +Définit un horodatage arbitraire en sous\-seconde pour tous les fichiers +qui l\'ont défini à zéro. +.PP +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. +.PP +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. +.PP +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. +.SS rehash +Planifie un nouveau hachage de toute la baie. +.PP +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. +.PP +Si vous utilisez déjà le hachage optimal, cette commande +ne fait rien et vous informe qu\'aucune action n\'est nécessaire. +.PP +Le nouveau hachage n\'est pas effectué immédiatement, mais a lieu +progressivement pendant \`sync\` et \`scrub\`. +.PP +Vous pouvez vérifier l\'état du nouveau hachage en utilisant \`status\`. +.PP +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. +.SH OPTIONS +SnapRAID fournit les options suivantes : +.TP +.B \-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\`. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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. +.TP +.B \-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). +.TP +.B \-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. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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, +\`\[dq]>>result.log\[dq]\`. +Pour sortir le journal sur la sortie standard ou l\'erreur +standard, vous pouvez utiliser \`\[dq]>&1\[dq]\` et \`\[dq]>&2\[dq]\`, +respectivement. +Consultez le fichier ou la page de manuel snapraid_log.txt +pour les descriptions des balises de journal. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-H, \-\-help +Affiche un écran d\'aide court. +.TP +.B \-V, \-\-version +Affiche la version du programme. +.SH CONFIGURATION +SnapRAID nécessite un fichier de configuration pour savoir où se trouve +votre baie de disques et où stocker les informations de parité. +.PP +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\`. +.PP +Il doit contenir les options suivantes (sensibles à la casse) : +.SS 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. +.PP +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. +.PP +Vous pouvez ajouter des fichiers de parité supplémentaires plus tard, +mais vous ne pouvez pas les réorganiser ni les supprimer. +.PP +Garder les disques de parité réservés à la parité garantit qu\'ils +ne deviennent pas fragmentés, améliorant les performances. +.PP +Sous Windows, 256 Mo sont laissés inutilisés sur chaque disque pour +éviter l\'avertissement concernant les disques pleins. +.PP +Cette option est obligatoire et ne peut être utilisée qu\'une seule fois. +.SS (2,3,4,5,6)\-parity FICHIER [,FICHIER] ... +Définit les fichiers à utiliser pour stocker les informations de parité +supplémentaires. +.PP +Pour chaque niveau de parité spécifié, un niveau de protection +supplémentaire est activé : +.PD 0 +.IP \(bu +2\-parity active la double parité RAID6. +.IP \(bu +3\-parity active la triple parité. +.IP \(bu +4\-parity active la quadruple (quatre) parité. +.IP \(bu +5\-parity active la penta (cinq) parité. +.IP \(bu +6\-parity active l\'hexa (six) parité. +.PD +.PP +Chaque niveau de parité nécessite la présence de tous les niveaux +de parité précédents. +.PP +Les mêmes considérations que pour l\'option \'parity\' s\'appliquent. +.PP +Ces options sont facultatives et ne peuvent être utilisées qu\'une seule fois. +.SS z\-parity FICHIER [,FICHIER] ... +Définit un fichier et un format alternatifs pour stocker la triple parité. +.PP +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. +.PP +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é. +.PP +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. +.PP +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. +.SS 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. +.PP +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\`. +.PP +Cette option est obligatoire et peut être utilisée plusieurs fois pour +enregistrer plusieurs copies du même fichier. +.PP +Vous devez stocker au moins une copie pour chaque disque de parité +utilisé plus un. L\'utilisation de copies supplémentaires ne nuit pas. +.SS 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. +.PP +Vous pouvez modifier le point de montage au besoin, tant que +vous gardez le NOM fixe. +.PP +Vous devriez utiliser une option pour chaque disque de données +de la baie. +.PP +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. +.SS 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é. +.SS 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é. +.PP +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\`. +.PP +Voir la section MOTIF pour plus de détails sur les +spécifications de motifs. +.PP +Cette option peut être utilisée plusieurs fois. +.SS blocksize TAILLE_EN_KIBIOCTETS +Définit la taille de bloc de base en kibioctets pour la parité. +Un kibioctet est de 1024 octets. +.PP +La taille de bloc par défaut est de 256, ce qui devrait fonctionner +dans la plupart des cas. +.PP +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é ! +.PP +Une raison d\'utiliser une taille de bloc différente est si vous avez +beaucoup de petits fichiers, de l\'ordre de millions. +.PP +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. +.PP +À 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. +.PP +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. +.PP +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é. +.PP +Une astuce pour obtenir une partition de parité plus grande sous Linux +est de la formater avec la commande : +.PP +.RS 4 +mkfs.ext4 \-m 0 \-T largefile4 DEVICE +.PD 0 +.PD +.RE +.PP +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é. +.SS hashsize TAILLE_EN_OCTETS +Définit la taille du hachage en octets pour les blocs enregistrés. +.PP +La taille de hachage par défaut est de 16 octets (128 bits), +ce qui devrait fonctionner dans la plupart des cas. +.PP +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é ! +.PP +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. +.PP +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. +.PP +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 : +.PP +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1,93 Gio +.PD 0 +.PD +.PP +En passant à une taille de hachage de 8, vous obtenez : +.PP +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1,02 Gio +.PD 0 +.PD +.PP +En passant à une taille de bloc de 512, vous obtenez : +.PP +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0,96 Gio +.PD 0 +.PD +.PP +En passant à la fois à une taille de hachage de 8 et à une taille de +bloc de 512, vous obtenez : +.PP +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 Gio +.PD 0 +.PD +.SS 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. +.SS 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. +.PP +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. +.PP +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. +.PP +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. +.SS 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. +.SS 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\`. +.PP +Le répertoire doit déjà exister. +.SS share CHEMIN_UNC +Définit le chemin UNC Windows requis pour accéder aux disques à distance. +.PP +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. +.PP +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. +.PP +Cette option est requise uniquement pour Windows. +.SS 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. +.PP +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\`. +.PP +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\`. +.PP +Consultez la documentation smartmontools pour les options possibles : +.PP +.RS 4 +https://www.smartmontools.org/wiki/Supported_RAID\-Controllers +.PD 0 +.PP +.PD +https://www.smartmontools.org/wiki/Supported_USB\-Devices +.PD 0 +.PD +.RE +.PP +Par exemple : +.PP +.RS 4 +smartctl parity \-d sat %s +.PD 0 +.PD +.RE +.SS 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. +.PP +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. +.PP +Par exemple, pour ignorer l\'attribut \`Current Pending Sector Count\` +sur tous les disques : +.PP +.RS 4 +smartignore * 197 +.PD 0 +.PD +.RE +.PP +Pour l\'ignorer uniquement sur le premier disque de parité : +.PP +.RS 4 +smartignore parity 197 +.PD 0 +.PD +.RE +.SS Exemples +Un exemple de configuration typique pour Unix est : +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /mnt/diskp/snapraid.content +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +exclude /tmp/ +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/sg0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/sg0 +.PD 0 +.PD +.RE +.PP +Un exemple de configuration typique pour Windows est : +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content E:\\snapraid.content +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +data d1 G:\\array\\ +.PD 0 +.PP +.PD +data d2 H:\\array\\ +.PD 0 +.PP +.PD +data d3 I:\\array\\ +.PD 0 +.PP +.PD +exclude Thumbs.db +.PD 0 +.PP +.PD +exclude \\$RECYCLE.BIN +.PD 0 +.PP +.PD +exclude \\System Volume Information +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/arcmsr0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 +.PD 0 +.PD +.RE +.SH MOTIF (PATTERN) +Les motifs sont utilisés pour sélectionner un sous\-ensemble de fichiers +à exclure ou à inclure dans le processus. +.PP +Il existe quatre types de motifs différents : +.TP +.B 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. +.TP +.B 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. +.TP +.B /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. +.TP +.B /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. +.PP +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. +.PP +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. +.PP +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. +.PP +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 : +.PP +.RS 4 +# Exclut tout fichier nommé \`*.unrecoverable\` +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Exclut le répertoire racine \`/lost+found\` +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +# Exclut tout sous\-répertoire nommé \`tmp\` +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PD +.RE +.PP +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 : +.PP +.RS 4 +# Inclut uniquement certains répertoires +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +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 : +.PP +.RS 4 +# Exclut tout fichier nommé \`*.unrecoverable\` +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Exclut tout sous\-répertoire nommé \`tmp\` +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PP +.PD +# Inclut uniquement certains répertoires +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +Sur la ligne de commande, en utilisant l\'option \-f, vous ne pouvez +utiliser que des motifs \`include\`. Par exemple : +.PP +.RS 4 +# Vérifie uniquement les fichiers .mp3. +.PD 0 +.PP +.PD +# Sous Unix, utilisez des guillemets pour éviter l\'expansion +.PD 0 +.PP +.PD +# du globbing par le shell. +.PD 0 +.PP +.PD +snapraid \-f \[dq]*.mp3\[dq] check +.PD 0 +.PD +.RE +.PP +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. +.SH CONTENU (CONTENT) +SnapRAID stocke la liste et les sommes de contrôle de vos fichiers +dans le fichier de contenu. +.PP +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é. +.PP +Ce fichier est lu et écrit par les commandes \`sync\` et \`scrub\` et +lu par les commandes \`fix\`, \`check\` et \`status\`. +.SH PARITé (PARITY) +SnapRAID stocke les informations de parité de votre baie dans +les fichiers de parité. +.PP +Ce sont des fichiers binaires contenant la parité calculée de tous les +blocs définis dans le fichier \`content\`. +.PP +Ces fichiers sont lus et écrits par les commandes \`sync\` et \`fix\` et +lus uniquement par les commandes \`scrub\` et \`check\`. +.SH 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. +.PP +Sous Windows, tous les noms lus à partir du système de fichiers sont +convertis et traités au format UTF\-8. +.PP +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. +.SH DROITS D\'AUTEUR (COPYRIGHT) +Ce fichier est Copyright (C) 2025 Andrea Mazzoleni +.SH VOIR AUSSI (SEE ALSO) +snapraid_log(1), rsync(1) diff --git a/snapraid-fr.d b/snapraid-fr.d new file mode 100644 index 00000000..9d2014ed --- /dev/null +++ b/snapraid-fr.d @@ -0,0 +1,1575 @@ +Name{number} + snapraid - Sauvegarde SnapRAID pour baies de disques + +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] + +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 : + + * Vous pouvez utiliser des disques déjà remplis de fichiers sans avoir besoin + de les reformater, en y accédant comme d'habitude. + * Toutes vos données sont hachées pour garantir l'intégrité des données + et prévenir la corruption silencieuse. + * Lorsque le nombre de disques défaillants dépasse le nombre de parités, + la perte de données est limitée aux disques affectés ; les données + sur les autres disques restent accessibles. + * Si vous supprimez accidentellement des fichiers sur un disque, + la récupération est possible. + * Les disques peuvent avoir des tailles différentes. + * Vous pouvez ajouter des disques à tout moment. + * SnapRAID ne verrouille pas vos données ; vous pouvez arrêter de l'utiliser + à tout moment sans reformater ni déplacer de données. + * Pour accéder à un fichier, un seul disque doit tourner, ce qui + économise de l'énergie et réduit le bruit. + + Pour plus d'informations, veuillez visiter le site officiel de SnapRAID : + + :https://www.snapraid.it/ + +Limitations + SnapRAID est un hybride entre un programme RAID et un programme de sauvegarde, + visant à combiner les meilleurs avantages des deux. Cependant, il a quelques + limitations que vous devriez considérer avant de l'utiliser. + + 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 : + + * Avec SnapRAID, vous avez toujours des systèmes de fichiers séparés + pour chaque disque. Avec le RAID, vous obtenez un seul grand + système de fichiers. + * SnapRAID ne fait pas de striping (entrelacement) des données. + Avec le RAID, vous obtenez un gain de vitesse avec le striping. + * SnapRAID ne prend pas en charge la récupération en temps réel. + Avec le RAID, vous n'avez pas à arrêter de travailler lorsqu'un + disque tombe en panne. + * SnapRAID ne peut récupérer des données que pour un nombre limité + de défaillances de disques. Avec une sauvegarde, vous pouvez + récupérer d'une défaillance complète de toute la baie de disques. + * Seuls les noms de fichiers, les horodatages, les liens symboliques + et les liens matériels sont sauvegardés. Les permissions, la + propriété et les attributs étendus ne sont pas sauvegardés. + +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`. + + 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. + + 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 + + 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 + + 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. + + É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. + + É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` ! + + É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. + + É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. + +Commandes + SnapRAID fournit quelques commandes simples qui vous permettent de : + + * Afficher l'état de la baie de disques -> `status` + * Contrôler les disques -> `smart`, `probe`, `up`, `down` + * Faire une sauvegarde/instantané -> `sync` + * Vérifier périodiquement les données -> `scrub` + * Restaurer la dernière sauvegarde/instantané -> `fix`. + + Les commandes doivent être écrites en minuscules. + + 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é. + + 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é. + + 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é. + + 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é. + + 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é. + + 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é. + + 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. + + 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. + + 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. + + 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é. + + 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é. + + 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é. + + 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. + + 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é. + + 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. + + 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. + +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. + +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) : + + 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. + + (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é : + + * 2-parity active la double parité RAID6. + * 3-parity active la triple parité. + * 4-parity active la quadruple (quatre) parité. + * 5-parity active la penta (cinq) parité. + * 6-parity active l'hexa (six) parité. + + 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. + + 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. + + 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. + + 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. + + 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é. + + 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. + + 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é. + + 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 + + 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. + + 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. + + 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. + + 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. + + 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. + + 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 + + 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 + + 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 + +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. + +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`. + +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`. + +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. + +Droits d'auteur (Copyright) + Ce fichier est Copyright (C) 2025 Andrea Mazzoleni + +Voir aussi (See Also) + snapraid_log(1), rsync(1) diff --git a/snapraid-fr.txt b/snapraid-fr.txt new file mode 100644 index 00000000..6991a35f --- /dev/null +++ b/snapraid-fr.txt @@ -0,0 +1,1689 @@ + ========================================= + Sauvegarde SnapRAID pour baies de disques + ========================================= + + +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 : + +* Vous pouvez utiliser des disques déjà remplis de fichiers sans avoir besoin + de les reformater, en y accédant comme d'habitude. +* Toutes vos données sont hachées pour garantir l'intégrité des données + et prévenir la corruption silencieuse. +* Lorsque le nombre de disques défaillants dépasse le nombre de parités, + la perte de données est limitée aux disques affectés ; les données + sur les autres disques restent accessibles. +* Si vous supprimez accidentellement des fichiers sur un disque, + la récupération est possible. +* Les disques peuvent avoir des tailles différentes. +* Vous pouvez ajouter des disques à tout moment. +* SnapRAID ne verrouille pas vos données ; vous pouvez arrêter de l'utiliser + à tout moment sans reformater ni déplacer de données. +* Pour accéder à un fichier, un seul disque doit tourner, ce qui + économise de l'énergie et réduit le bruit. + +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 : + +* Avec SnapRAID, vous avez toujours des systèmes de fichiers séparés + pour chaque disque. Avec le RAID, vous obtenez un seul grand + système de fichiers. +* SnapRAID ne fait pas de striping (entrelacement) des données. + Avec le RAID, vous obtenez un gain de vitesse avec le striping. +* SnapRAID ne prend pas en charge la récupération en temps réel. + Avec le RAID, vous n'avez pas à arrêter de travailler lorsqu'un + disque tombe en panne. +* SnapRAID ne peut récupérer des données que pour un nombre limité + de défaillances de disques. Avec une sauvegarde, vous pouvez + récupérer d'une défaillance complète de toute la baie de disques. +* Seuls les noms de fichiers, les horodatages, les liens symboliques + et les liens matériels sont sauvegardés. Les permissions, la + propriété et les attributs étendus ne sont pas sauvegardés. + + +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 : + +* Afficher l'état de la baie de disques -> `status` +* Contrôler les disques -> `smart`, `probe`, `up`, `down` +* Faire une sauvegarde/instantané -> `sync` +* Vérifier périodiquement les données -> `scrub` +* Restaurer la dernière sauvegarde/instantané -> `fix`. + +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é : + +* 2-parity active la double parité RAID6. +* 3-parity active la triple parité. +* 4-parity active la quadruple (quatre) parité. +* 5-parity active la penta (cinq) parité. +* 6-parity active l'hexa (six) parité. + +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/snapraid-it.1 b/snapraid-it.1 new file mode 100644 index 00000000..2ef64d5b --- /dev/null +++ b/snapraid-it.1 @@ -0,0 +1,1994 @@ +.TH "Backup SnapRAID per Array di Dischi" 1 +.SH NAME +snapraid \- Backup SnapRAID per Array di Dischi +.SH SINOSSI +snapraid [\-c, \-\-conf CONFIG] +.PD 0 +.PP +.PD + [\-f, \-\-filter PATTERN] [\-d, \-\-filter\-disk NAME] +.PD 0 +.PP +.PD + [\-m, \-\-filter\-missing] [\-e, \-\-filter\-error] +.PD 0 +.PP +.PD + [\-a, \-\-audit\-only] [\-h, \-\-pre\-hash] [\-i, \-\-import DIR] +.PD 0 +.PP +.PD + [\-p, \-\-plan PERC|bad|new|full] +.PD 0 +.PP +.PD + [\-o, \-\-older\-than DAYS] [\-l, \-\-log FILE] +.PD 0 +.PP +.PD + [\-s, \-\-spin\-down\-on\-error] [\-w, \-\-bw\-limit RATE] +.PD 0 +.PP +.PD + [\-Z, \-\-force\-zero] [\-E, \-\-force\-empty] +.PD 0 +.PP +.PD + [\-U, \-\-force\-uuid] [\-D, \-\-force\-device] +.PD 0 +.PP +.PD + [\-N, \-\-force\-nocopy] [\-F, \-\-force\-full] +.PD 0 +.PP +.PD + [\-R, \-\-force\-realloc] +.PD 0 +.PP +.PD + [\-S, \-\-start BLKSTART] [\-B, \-\-count BLKCOUNT] +.PD 0 +.PP +.PD + [\-L, \-\-error\-limit NUMBER] +.PD 0 +.PP +.PD + [\-A, \-\-stats] +.PD 0 +.PP +.PD + [\-v, \-\-verbose] [\-q, \-\-quiet] +.PD 0 +.PP +.PD + status|smart|probe|up|down|diff|sync|scrub|fix|check +.PD 0 +.PP +.PD + |list|dup|pool|devices|touch|rehash +.PD 0 +.PD +.PP +snapraid [\-V, \-\-version] [\-H, \-\-help] [\-C, \-\-gen\-conf CONTENT] +.PD 0 +.PD +.SH 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. +.PP +Destinato principalmente a centri multimediali domestici con file grandi +e che cambiano raramente, SnapRAID offre diverse funzionalità: +.PD 0 +.IP \(bu +È possibile utilizzare dischi già pieni di file senza la necessità +di riformattarli, accedendovi come al solito. +.IP \(bu +Tutti i dati sono sottoposti ad hashing per garantire l\'integrità dei +dati e prevenire la corruzione silente. +.IP \(bu +Quando il numero di dischi guasti supera il conteggio di parità, +la perdita di dati è confinata ai dischi interessati; i dati sugli +altri dischi rimangono accessibili. +.IP \(bu +Se si eliminano accidentalmente dei file su un disco, il recupero +è possibile. +.IP \(bu +I dischi possono avere dimensioni diverse. +.IP \(bu +È possibile aggiungere dischi in qualsiasi momento. +.IP \(bu +SnapRAID non blocca i dati; è possibile smettere di usarlo in qualsiasi +momento senza riformattare o spostare i dati. +.IP \(bu +Per accedere a un file, è necessario far girare solo un singolo disco, +risparmiando energia e riducendo il rumore. +.PD +.PP +Per maggiori informazioni, si prega di visitare il sito ufficiale SnapRAID: +.PP +.RS 4 +https://www.snapraid.it/ +.PD 0 +.PD +.RE +.SH LIMITAZIONI +SnapRAID è un ibrido tra un programma RAID e un programma di backup, +che mira a combinare i migliori vantaggi di entrambi. Tuttavia, ha +alcune limitazioni che si dovrebbero considerare prima di usarlo. +.PP +La limitazione principale è che se un disco si guasta e non si è +effettuato un sync di recente, potrebbe non essere possibile recuperare +completamente. +Più specificamente, potrebbe non essere possibile recuperare fino alla +dimensione dei file modificati o eliminati dall\'ultima operazione di sync. +Ciò accade anche se i file modificati o eliminati non si trovano sul +disco guasto. Questo è il motivo per cui SnapRAID è più adatto per dati +che cambiano raramente. +.PP +D\'altra parte, i file appena aggiunti non impediscono il recupero dei +file già esistenti. Si perderanno solo i file aggiunti di recente se si +trovano sul disco guasto. +.PP +Altre limitazioni di SnapRAID sono: +.PD 0 +.IP \(bu +Con SnapRAID, si hanno ancora file system separati per ogni disco. +Con RAID, si ottiene un unico grande file system. +.IP \(bu +SnapRAID non esegue lo striping dei dati. +Con RAID, si ottiene un aumento di velocità con lo striping. +.IP \(bu +SnapRAID non supporta il recupero in tempo reale. +Con RAID, non si deve smettere di lavorare quando un disco si guasta. +.IP \(bu +SnapRAID può recuperare i dati solo da un numero limitato di guasti +del disco. +Con un backup, è possibile recuperare da un guasto completo +dell\'intero array di dischi. +.IP \(bu +Vengono salvati solo nomi di file, timestamp, symlink e hardlink. +Permessi, proprietà e attributi estesi non vengono salvati. +.PD +.SH 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. +.PP +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. +.PP +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. +.PP +Questi dischi saranno dedicati alla memorizzazione dei file di \`parity\`. +Non si dovrebbero memorizzare i propri dati su di essi. +.PP +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. +.PP +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. +.PP +Ad esempio, supponiamo di essere interessati a un solo livello di +protezione con parità e che i dischi si trovino in: +.PP +.RS 4 +/mnt/diskp <\- disco selezionato per la parità +.PD 0 +.PP +.PD +/mnt/disk1 <\- primo disco da proteggere +.PD 0 +.PP +.PD +/mnt/disk2 <\- secondo disco da proteggere +.PD 0 +.PP +.PD +/mnt/disk3 <\- terzo disco da proteggere +.PD 0 +.PD +.RE +.PP +È necessario creare il file di configurazione /etc/snapraid.conf con +le seguenti opzioni: +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk1/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk2/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PD +.RE +.PP +Se si è su Windows, si dovrebbe usare il formato del percorso di Windows, +con lettere di unità e backslash invece di slash. +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +content F:\\array\\snapraid.content +.PD 0 +.PP +.PD +content G:\\array\\snapraid.content +.PD 0 +.PP +.PD +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PD +.RE +.PP +Se si hanno molti dischi e si esauriscono le lettere di unità, è +possibile montare i dischi direttamente nelle sottocartelle. Vedi: +.PP +.RS 4 +https://www.google.com/search?q=Windows+mount+point +.PD 0 +.PD +.RE +.PP +A questo punto, si è pronti per eseguire il comando \`sync\` per costruire +le informazioni di parità. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +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. +.PP +È possibile interromperlo in qualsiasi momento premendo Ctrl+C e, alla +prossima esecuzione, riprenderà da dove è stato interrotto. +.PP +Quando questo comando è completato, i dati sono SICURI. +.PP +Ora è possibile iniziare a usare l\'array come si desidera e aggiornare +periodicamente le informazioni di parità eseguendo il comando \`sync\`. +.SS Scrubbing +Per controllare periodicamente i dati e la parità per gli errori, è +possibile eseguire il comando \`scrub\`. +.PP +.RS 4 +snapraid scrub +.PD 0 +.PD +.RE +.PP +Questo comando confronta i dati nell\'array con l\'hash calcolato +durante il comando \`sync\` per verificarne l\'integrità. +.PP +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: +.PP +.RS 4 +snapraid \-p 5 \-o 20 scrub +.PD 0 +.PD +.RE +.PP +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\`. +.PP +.RS 4 +snapraid status +.PD 0 +.PD +.RE +.PP +Per correggerli, è possibile utilizzare il comando \`fix\`, filtrando +i blocchi bad con l\'opzione \-e, \-\-filter\-error: +.PP +.RS 4 +snapraid \-e fix +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid \-p bad scrub +.PD 0 +.PD +.RE +.PP +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. +.SS 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. +.PP +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. +.PP +È possibile configurare la directory di \`pooling\` nel file di +configurazione con: +.PP +.RS 4 +pool /pool +.PD 0 +.PD +.RE +.PP +o, se si è su Windows, con: +.PP +.RS 4 +pool C:\\pool +.PD 0 +.PD +.RE +.PP +e quindi eseguire il comando \`pool\` per creare o aggiornare la +vista virtuale. +.PP +.RS 4 +snapraid pool +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +# Nella sezione globale di smb.conf +.PD 0 +.PP +.PD +unix extensions = no +.PD 0 +.PD +.RE +.PP +.RS 4 +# Nella sezione di condivisione di smb.conf +.PD 0 +.PP +.PD +[pool] +.PD 0 +.PP +.PD +comment = Pool +.PD 0 +.PP +.PD +path = /pool +.PD 0 +.PP +.PD +read only = yes +.PD 0 +.PP +.PD +guest ok = yes +.PD 0 +.PP +.PD +wide links = yes +.PD 0 +.PP +.PD +follow symlinks = yes +.PD 0 +.PD +.RE +.PP +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. +.PP +Ad esempio, operando da un server chiamato \`darkstar\`, è possibile +utilizzare le opzioni: +.PP +.RS 4 +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PP +.PD +pool C:\\pool +.PD 0 +.PP +.PD +share \\\\darkstar +.PD 0 +.PD +.RE +.PP +e condividere le seguenti directory sulla rete: +.PP +.RS 4 +\\\\darkstar\\pool \-> C:\\pool +.PD 0 +.PP +.PD +\\\\darkstar\\d1 \-> F:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d2 \-> G:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d3 \-> H:\\array +.PD 0 +.PD +.RE +.PP +per consentire ai client remoti di accedere a tutti i file in +\\\\darkstar\\pool. +.PP +Potrebbe anche essere necessario configurare i client remoti per +abilitare l\'accesso ai symlink remoti con il comando: +.PP +.RS 4 +fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1 +.PD 0 +.PD +.RE +.SS 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: +.PP +.RS 4 +snapraid fix \-f FILE +.PD 0 +.PD +.RE +.PP +o per una directory: +.PP +.RS 4 +snapraid fix \-f DIR/ +.PD 0 +.PD +.RE +.PP +È 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. +.PP +.RS 4 +snapraid fix \-m \-f DIR/ +.PD 0 +.PD +.RE +.PP +O per recuperare tutti i file eliminati su tutte le unità con: +.PP +.RS 4 +snapraid fix \-m +.PD 0 +.PD +.RE +.SS Recupero +È successo il peggio e si è perso uno o più dischi! +.PP +NON FARSI PRENDERE DAL PANICO! Sarà possibile recuperarli! +.PP +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. +.PP +Quindi procedere con i seguenti passaggi. +.SS 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. +.PP +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. +.PP +Ad esempio, se il disco \`d1\` è guasto, cambiare da: +.PP +.RS 4 +data d1 /mnt/disk1/ +.PD 0 +.PD +.RE +.PP +a: +.PP +.RS 4 +data d1 /mnt/new_spare_disk/ +.PD 0 +.PD +.RE +.PP +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. +.SS PASSO 2 \-> Correzione (Fix) +Eseguire il comando fix, memorizzando il log in un file esterno con: +.PP +.RS 4 +snapraid \-d NAME \-l fix.log fix +.PD 0 +.PD +.RE +.PP +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. +.PP +Questo comando richiederà molto tempo. +.PP +Assicurarsi di avere alcuni gigabyte liberi per memorizzare il file +fix.log. Eseguirlo da un disco con spazio libero sufficiente. +.PP +Ora si è recuperato tutto ciò che è recuperabile. Se alcuni file sono +parzialmente o totalmente irrecuperabili, verranno rinominati aggiungendo +l\'estensione \`.unrecoverable\`. +.PP +È possibile trovare un elenco dettagliato di tutti i blocchi +irrecuperabili nel file fix.log controllando tutte le righe che iniziano +con \`unrecoverable:\`. +.PP +Se non si è soddisfatti del recupero, è possibile riprovare tutte le +volte che si desidera. +.PP +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. +.PP +Se si è soddisfatti del recupero, è possibile procedere oltre, +ma notare che dopo la sincronizzazione, non è più possibile riprovare +il comando \`fix\`! +.SS PASSO 3 \-> Controllo (Check) +Come controllo cauto, è ora possibile eseguire un comando \`check\` per +assicurarsi che tutto sia corretto sul disco recuperato. +.PP +.RS 4 +snapraid \-d NAME \-a check +.PD 0 +.PD +.RE +.PP +Dove NAME è il nome del disco, come \`d1\` nel nostro esempio precedente. +.PP +Le opzioni \-d e \-a dicono a SnapRAID di controllare solo il disco +specificato e di ignorare tutti i dati di parità. +.PP +Questo comando richiederà molto tempo, ma se non si è eccessivamente +cauti, è possibile saltarlo. +.SS PASSO 4 \-> Sincronizzazione (Sync) +Eseguire il comando \`sync\` per risincronizzare l\'array con il nuovo disco. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +Se tutto è recuperato, questo comando è immediato. +.SH COMANDI +SnapRAID fornisce alcuni semplici comandi che consentono di: +.PD 0 +.IP \(bu +Stampare lo stato dell\'array \-> \`status\` +.IP \(bu +Controllare i dischi \-> \`smart\`, \`probe\`, \`up\`, \`down\` +.IP \(bu +Effettuare un backup/snapshot \-> \`sync\` +.IP \(bu +Controllare periodicamente i dati \-> \`scrub\` +.IP \(bu +Ripristinare l\'ultimo backup/snapshot \-> \`fix\`. +.PD +.PP +I comandi devono essere scritti in minuscolo. +.SS status +Stampa un riepilogo dello stato dell\'array di dischi. +.PP +Include informazioni sulla frammentazione della parità, quanto sono +vecchi i blocchi senza essere controllati e tutti gli errori silenti +registrati incontrati durante lo scrubbing. +.PP +Le informazioni presentate si riferiscono all\'ultima volta che si è +eseguito \`sync\`. Le modifiche successive non vengono prese in +considerazione. +.PP +Se sono stati rilevati blocchi bad, vengono elencati i loro numeri +di blocco. Per correggerli, è possibile utilizzare il comando \`fix \-e\`. +.PP +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\'. +.PP +Nulla viene modificato. +.SS smart +Stampa un report SMART di tutti i dischi nel sistema. +.PP +Include una stima della probabilità di guasto nel prossimo anno, +consentendo di pianificare sostituzioni di manutenzione di dischi +che mostrano attributi sospetti. +.PP +Questa stima della probabilità è ottenuta correlando gli attributi +SMART dei dischi con i dati Backblaze disponibili all\'indirizzo: +.PP +.RS 4 +https://www.backblaze.com/hard\-drive\-test\-data.html +.PD 0 +.PD +.RE +.PP +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. +.PP +Altre possibili stringhe di stato sono: +.RS 4 +.PD 0 +.HP 4 +.I logfail +In passato, alcuni attributi erano inferiori alla +soglia. +.HP 4 +.I logerr +Il log degli errori del dispositivo contiene errori. +.HP 4 +.I selferr +Il log dell\'autotest del dispositivo contiene errori. +.PD +.RE +.PP +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à. +.PP +Questo comando utilizza lo strumento \`smartctl\` ed è equivalente +all\'esecuzione di \`smartctl \-a\` su tutti i dispositivi. +.PP +Se i dispositivi non vengono rilevati automaticamente correttamente, è +possibile specificare un comando personalizzato utilizzando l\'opzione +\`smartctl\` nel file di configurazione. +.PP +Nulla viene modificato. +.SS probe +Stampa lo stato POWER di tutti i dischi nel sistema. +.PP +\`Standby\` significa che il disco non sta girando. \`Active\` significa +che il disco sta girando. +.PP +Questo comando utilizza lo strumento \`smartctl\` ed è equivalente +all\'esecuzione di \`smartctl \-n standby \-i\` su tutti i dispositivi. +.PP +Se i dispositivi non vengono rilevati automaticamente correttamente, è +possibile specificare un comando personalizzato utilizzando l\'opzione +\`smartctl\` nel file di configurazione. +.PP +Nulla viene modificato. +.SS up +Fa girare tutti i dischi dell\'array. +.PP +È possibile far girare solo dischi specifici utilizzando l\'opzione \-d, +\-\-filter\-disk. +.PP +Far girare tutti i dischi contemporaneamente richiede molta energia. +Assicurarsi che l\'alimentatore possa sostenerlo. +.PP +Nulla viene modificato. +.SS down +Ferma tutti i dischi dell\'array. +.PP +Questo comando utilizza lo strumento \`smartctl\` ed è equivalente +all\'esecuzione di \`smartctl \-s standby,now\` su tutti i dispositivi. +.PP +È possibile fermare solo dischi specifici utilizzando l\'opzione \-d, +\-\-filter\-disk. +.PP +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. +.PP +Nulla viene modificato. +.SS diff +Elenca tutti i file modificati dall\'ultimo \`sync\` che devono avere i +loro dati di parità ricalcolati. +.PP +Questo comando non controlla i dati del file, ma solo il timestamp +del file, le dimensioni e l\'inode. +.PP +Dopo aver elencato tutti i file modificati, viene presentato un +riepilogo delle modifiche, raggruppate per: +.RS 4 +.PD 0 +.HP 4 +.I equal +File invariati rispetto a prima. +.HP 4 +.I added +File aggiunti che non erano presenti prima. +.HP 4 +.I removed +File rimossi. +.HP 4 +.I updated +File con dimensioni o timestamp diversi, il che +significa che sono stati modificati. +.HP 4 +.I 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. +.HP 4 +.I 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. +.HP 4 +.I restored +File con un inode diverso ma nome, dimensioni e +timestamp corrispondenti. Questi sono di solito file +ripristinati dopo essere stati eliminati. +.PD +.RE +.PP +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. +.PP +Nulla viene modificato. +.SS sync +Aggiorna le informazioni di parità. Tutti i file modificati +nell\'array di dischi vengono letti e i dati di parità +corrispondenti vengono aggiornati. +.PP +È 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. +.PP +Se vengono trovati errori silenti o di input/output durante il processo, +i blocchi corrispondenti vengono contrassegnati come bad. +.PP +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. +.PP +I file \`content\` e \`parity\` vengono modificati se necessario. +I file nell\'array NON vengono modificati. +.SS scrub +Esegue lo scrub dell\'array, controllando la presenza di errori silenti +o di input/output nei dischi dati e di parità. +.PP +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. +.PP +È 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 +.PP +.RS 4 +sottoposti a scrub. +.RE +.RS 0 +.PD 0 +.HP 4 +.I full +Esegue lo scrub di tutto. +.HP 4 +.I 0\-100 +Esegue lo scrub della percentuale specificata di blocchi. +.PD +.RE +.PP +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\`. +.PP +Per ottenere i dettagli dello stato dello scrub, utilizzare il comando +\`status\`. +.PP +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\`. +.PP +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. +.PP +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. +.SS fix +Corregge tutti i file e i dati di parità. +.PP +Tutti i file e i dati di parità vengono confrontati con lo stato +snapshot salvato nell\'ultimo \`sync\`. +Se viene trovata una differenza, viene ripristinata allo snapshot +memorizzato. +.PP +ATTENZIONE! Il comando \`fix\` non differenzia tra errori e modifiche +intenzionali. Ripristina incondizionatamente lo stato del file +all\'ultimo \`sync\`. +.PP +Se non viene specificata nessun\'altra opzione, l\'intero array viene +elaborato. Utilizzare le opzioni di filtro per selezionare un +sottoinsieme di file o dischi su cui operare. +.PP +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\`. +.PP +SnapRAID rinomina tutti i file che non possono essere corretti aggiungendo +l\'estensione \`.unrecoverable\`. +.PP +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. +.PP +I file sono identificati solo dal percorso, non dall\'inode. +.PP +Il file \`content\` NON viene modificato. +I file \`parity\` vengono modificati se necessario. +I file nell\'array vengono modificati se necessario. +.SS check +Verifica tutti i file e i dati di parità. +.PP +Funziona come \`fix\`, ma simula solo un recupero e nessuna modifica +viene scritta nell\'array. +.PP +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\`. +.PP +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. +.PP +I file sono identificati solo dal percorso, non dall\'inode. +.PP +Nulla viene modificato. +.SS list +Elenca tutti i file contenuti nell\'array al momento dell\'ultimo +\`sync\`. +.PP +Con \-v o \-\-verbose, viene mostrato anche il tempo sotto il secondo. +.PP +Nulla viene modificato. +.SS 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. +.PP +Nulla viene modificato. +.SS pool +Crea o aggiorna una vista virtuale di tutti +i file nell\'array di dischi nella directory di \`pooling\`. +.PP +I file non vengono copiati ma collegati utilizzando +collegamenti simbolici. +.PP +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. +.PP +Nulla viene modificato al di fuori della directory pool. +.SS devices +Stampa i dispositivi di basso livello utilizzati dall\'array. +.PP +Questo comando visualizza le associazioni dei dispositivi nell\'array +ed è principalmente destinato come interfaccia script. +.PP +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. +.PP +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. +.PP +Nulla viene modificato. +.SS touch +Imposta un timestamp arbitrario sotto il secondo per tutti i file +che lo hanno impostato a zero. +.PP +Questo migliora la capacità di SnapRAID di riconoscere i file +spostati e copiati, poiché rende il timestamp quasi unico, +riducendo possibili duplicati. +.PP +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. +.PP +Il timestamp di precisione al secondo non viene modificato, +quindi tutte le date e gli orari dei file saranno conservati. +.SS rehash +Pianifica un rehash dell\'intero array. +.PP +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. +.PP +Se si sta già utilizzando l\'hash ottimale, questo comando non fa +nulla e informa che non è necessaria alcuna azione. +.PP +Il rehash non viene eseguito immediatamente ma avviene +progressivamente durante \`sync\` e \`scrub\`. +.PP +È possibile controllare lo stato del rehash utilizzando \`status\`. +.PP +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. +.SH OPZIONI +SnapRAID fornisce le seguenti opzioni: +.TP +.B \-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\`. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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. +.TP +.B \-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). +.TP +.B \-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. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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 \`\[dq]>>result.log\[dq]\`. +Per indirizzare l\'output del log all\'output standard o all\'errore +standard, è possibile utilizzare \`\[dq]>&1\[dq]\` e \`\[dq]>&2\[dq]\`, +rispettivamente. +Vedere il file snapraid_log.txt o la pagina man per le descrizioni +dei tag di log. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-B, \-\-count BLKCOUNT +Elabora solo il numero specificato di blocchi. +Questa opzione è principalmente per il recupero manuale avanzato. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-H, \-\-help +Stampa una breve schermata di aiuto. +.TP +.B \-V, \-\-version +Stampa la versione del programma. +.SH CONFIGURAZIONE +SnapRAID richiede un file di configurazione per sapere dove si trova +l\'array di dischi e dove memorizzare le informazioni di parità. +.PP +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\`. +.PP +Deve contenere le seguenti opzioni (sensibili al maiuscolo/minuscolo): +.SS 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. +.PP +È 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. +.PP +È possibile aggiungere file di parità aggiuntivi in seguito, ma non è +possibile riordinarli o rimuoverli. +.PP +Mantenere i dischi di parità riservati alla parità garantisce che non +diventino frammentati, migliorando le prestazioni. +.PP +In Windows, 256 MB vengono lasciati inutilizzati su ogni disco per +evitare l\'avviso sui dischi pieni. +.PP +Questa opzione è obbligatoria e può essere utilizzata solo una volta. +.SS (2,3,4,5,6)\-parity FILE [,FILE] ... +Definisce i file da utilizzare per memorizzare informazioni di parità +extra. +.PP +Per ogni livello di parità specificato, è abilitato un livello +aggiuntivo di protezione: +.PD 0 +.IP \(bu +2\-parity abilita la doppia parità RAID6. +.IP \(bu +3\-parity abilita la tripla parità. +.IP \(bu +4\-parity abilita la parità quadrupla. +.IP \(bu +5\-parity abilita la parità quintupla. +.IP \(bu +6\-parity abilita la parità esapla. +.PD +.PP +Ogni livello di parità richiede la presenza di tutti i livelli di parità +precedenti. +.PP +Si applicano le stesse considerazioni dell\'opzione \'parity\'. +.PP +Queste opzioni sono facoltative e possono essere utilizzate solo una volta. +.SS z\-parity FILE [,FILE] ... +Definisce un file e un formato alternativi per memorizzare la tripla +parità. +.PP +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. +.PP +Questo formato è simile ma più veloce di quello utilizzato da ZFS RAIDZ3. +Come ZFS, non funziona oltre la tripla parità. +.PP +Quando si utilizza \'3\-parity\', si verrà avvisati se è consigliato +utilizzare il formato \'z\-parity\' per un miglioramento delle prestazioni. +.PP +È 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. +.SS content FILE +Definisce il file da utilizzare per memorizzare l\'elenco e i checksum +di tutti i file presenti nell\'array di dischi. +.PP +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\`. +.PP +Questa opzione è obbligatoria e può essere utilizzata più volte +per salvare più copie dello stesso file. +.PP +È necessario memorizzare almeno una copia per ogni disco di parità +utilizzato più uno. L\'utilizzo di copie aggiuntive non è dannoso. +.SS 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. +.PP +È possibile cambiare il punto di montaggio secondo necessità, +purché si mantenga fisso NAME. +.PP +È necessario utilizzare un\'opzione per ogni disco dati nell\'array. +.PP +È 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. +.SS 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. +.SS 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. +.PP +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\`. +.PP +Vedere la sezione PATTERN per maggiori dettagli sulle specifiche +del modello. +.PP +Questa opzione può essere utilizzata più volte. +.SS blocksize SIZE_IN_KIBIBYTES +Definisce la dimensione di blocco di base in kibibyte per la parità. +Un kibibyte è 1024 byte. +.PP +La dimensione di blocco predefinita è 256, che dovrebbe funzionare +nella maggior parte dei casi. +.PP +ATTENZIONE! Questa opzione è solo per esperti ed è vivamente +sconsigliato modificare questo valore. Per modificare questo valore in +futuro, sarà necessario ricreare l\'intera parità! +.PP +Un motivo per utilizzare una dimensione di blocco diversa è se si +hanno molti file piccoli, nell\'ordine dei milioni. +.PP +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. +.PP +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. +.PP +È 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. +.PP +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. +.PP +Un trucco per ottenere una partizione di parità più grande in Linux è +formattarla con il comando: +.PP +.RS 4 +mkfs.ext4 \-m 0 \-T largefile4 DEVICE +.PD 0 +.PD +.RE +.PP +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. +.SS hashsize SIZE_IN_BYTES +Definisce la dimensione dell\'hash in byte per i blocchi salvati. +.PP +La dimensione di hash predefinita è 16 byte (128 bit), che dovrebbe +funzionare nella maggior parte dei casi. +.PP +ATTENZIONE! Questa opzione è solo per esperti ed è vivamente +sconsigliato modificare questo valore. Per modificare questo valore in +futuro, sarà necessario ricreare l\'intera parità! +.PP +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. +.PP +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. +.PP +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: +.PP +RAM = $(8 * 4 * 10^{12}) * (1+16) / (256 * 2^{10}) = 1.93 \\text{ GiB}$ +.PD 0 +.PD +.PP +Passando a una dimensione di hash di 8, si ottiene: +.PP +RAM = $(8 * 4 * 10^{12}) * (1+8) / (256 * 2^{10}) = 1.02 \\text{ GiB}$ +.PD 0 +.PD +.PP +Passando a una dimensione di blocco di 512, si ottiene: +.PP +RAM = $(8 * 4 * 10^{12}) * (1+16) / (512 * 2^{10}) = 0.96 \\text{ GiB}$ +.PD 0 +.PD +.PP +Passando sia a una dimensione di hash di 8 che a una dimensione di +blocco di 512, si ottiene: +.PP +RAM = $(8 * 4 * 10^{12}) * (1+8) / (512 * 2^{10}) = 0.51 \\text{ GiB}$ +.PD 0 +.PD +.SS 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. +.SS 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. +.PP +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. +.PP +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. +.PP +Normalmente, SnapRAID mostra solo la temperatura del disco più caldo. +Per visualizzare la temperatura di tutti i dischi, utilizzare l\'opzione +\-A o \-\-stats. +.SS 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. +.SS pool DIR +Definisce la directory di pooling in cui viene creata la vista virtuale +dell\'array di dischi utilizzando il comando \`pool\`. +.PP +La directory deve già esistere. +.SS share UNC_DIR +Definisce il percorso UNC di Windows necessario per accedere ai dischi +da remoto. +.PP +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. +.PP +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. +.PP +Questa opzione è richiesta solo per Windows. +.SS 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. +.PP +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\`. +.PP +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\`. +.PP +Fare riferimento alla documentazione di smartmontools per le possibili +opzioni: +.PP +.RS 4 +https://www.smartmontools.org/wiki/Supported_RAID\-Controllers +.PD 0 +.PP +.PD +https://www.smartmontools.org/wiki/Supported_USB\-Devices +.PD 0 +.PD +.RE +.PP +Ad esempio: +.PP +.RS 4 +smartctl parity \-d sat %s +.PD 0 +.PD +.RE +.SS 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. +.PP +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. +.PP +Ad esempio, per ignorare l\'attributo \`Current Pending Sector Count\` +su tutti i dischi: +.PP +.RS 4 +smartignore * 197 +.PD 0 +.PD +.RE +.PP +Per ignorarlo solo sul primo disco di parità: +.PP +.RS 4 +smartignore parity 197 +.PD 0 +.PD +.RE +.SS Esempi +Un esempio di configurazione tipica per Unix è: +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /mnt/diskp/snapraid.content +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +exclude /tmp/ +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/sg0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/sg0 +.PD 0 +.PD +.RE +.PP +Un esempio di configurazione tipica per Windows è: +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content E:\\snapraid.content +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +data d1 G:\\array\\ +.PD 0 +.PP +.PD +data d2 H:\\array\\ +.PD 0 +.PP +.PD +data d3 I:\\array\\ +.PD 0 +.PP +.PD +exclude Thumbs.db +.PD 0 +.PP +.PD +exclude \\$RECYCLE.BIN +.PD 0 +.PP +.PD +exclude \\System Volume Information +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/arcmsr0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 +.PD 0 +.PD +.RE +.SH PATTERN +I pattern vengono utilizzati per selezionare un sottoinsieme di file da +escludere o includere nel processo. +.PP +Esistono quattro diversi tipi di pattern: +.TP +.B 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. +.TP +.B 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. +.TP +.B /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. +.TP +.B /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. +.PP +Quando si specifica un percorso assoluto che inizia con /, viene +applicato alla directory radice dell\'array, non alla directory radice +del file system locale. +.PP +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. +.PP +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. +.PP +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: +.PP +.RS 4 +# Esclude qualsiasi file denominato \`*.unrecoverable\` +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Esclude la directory radice \`/lost+found\` +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +# Esclude qualsiasi sottodirectory denominata \`tmp\` +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PD +.RE +.PP +L\'approccio opposto è definire solo i file che si desidera elaborare, +utilizzando solo regole \`include\`. Ad esempio: +.PP +.RS 4 +# Include solo alcune directory +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +# Esclude qualsiasi file denominato \`*.unrecoverable\` +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Esclude qualsiasi sottodirectory denominata \`tmp\` +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PP +.PD +# Include solo alcune directory +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +Sulla riga di comando, utilizzando l\'opzione \-f, è possibile utilizzare +solo pattern \`include\`. Ad esempio: +.PP +.RS 4 +# Controlla solo i file .mp3. +.PD 0 +.PP +.PD +# In Unix, utilizzare le virgolette per evitare l\'espansione +.PD 0 +.PP +.PD +# del globbing da parte della shell. +.PD 0 +.PP +.PD +snapraid \-f \[dq]*.mp3\[dq] check +.PD 0 +.PD +.RE +.PP +In Unix, quando si utilizzano caratteri di globbing sulla riga di +comando, è necessario citarli per impedire alla shell di espanderli. +.SH CONTENT +SnapRAID memorizza l\'elenco e i checksum dei file nel file di contenuto. +.PP +È un file binario che elenca tutti i file presenti nell\'array di dischi, +insieme a tutti i checksum per verificarne l\'integrità. +.PP +Questo file viene letto e scritto dai comandi \`sync\` e \`scrub\` e +letto dai comandi \`fix\`, \`check\` e \`status\`. +.SH PARITY +SnapRAID memorizza le informazioni di parità dell\'array nei file di +parità. +.PP +Questi sono file binari contenenti la parità calcolata di tutti i +blocchi definiti nel file \`content\`. +.PP +Questi file vengono letti e scritti dai comandi \`sync\` e \`fix\` e +solo letti dai comandi \`scrub\` e \`check\`. +.SH CODIFICA +SnapRAID in Unix ignora qualsiasi codifica. Legge e memorizza i +nomi dei file con la stessa codifica utilizzata dal file system. +.PP +In Windows, tutti i nomi letti dal file system vengono convertiti e +elaborati in formato UTF\-8. +.PP +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. +.SH COPYRIGHT +Questo file è Copyright (C) 2025 Andrea Mazzoleni +.SH VEDI ANCHE +snapraid_log(1), rsync(1) diff --git a/snapraid-it.d b/snapraid-it.d new file mode 100644 index 00000000..784fb79d --- /dev/null +++ b/snapraid-it.d @@ -0,0 +1,1545 @@ +Name{number} + snapraid - Backup SnapRAID per Array di Dischi + +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] + +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à: + + * È possibile utilizzare dischi già pieni di file senza la necessità + di riformattarli, accedendovi come al solito. + * Tutti i dati sono sottoposti ad hashing per garantire l'integrità dei + dati e prevenire la corruzione silente. + * Quando il numero di dischi guasti supera il conteggio di parità, + la perdita di dati è confinata ai dischi interessati; i dati sugli + altri dischi rimangono accessibili. + * Se si eliminano accidentalmente dei file su un disco, il recupero + è possibile. + * I dischi possono avere dimensioni diverse. + * È possibile aggiungere dischi in qualsiasi momento. + * SnapRAID non blocca i dati; è possibile smettere di usarlo in qualsiasi + momento senza riformattare o spostare i dati. + * Per accedere a un file, è necessario far girare solo un singolo disco, + risparmiando energia e riducendo il rumore. + + Per maggiori informazioni, si prega di visitare il sito ufficiale SnapRAID: + + :https://www.snapraid.it/ + +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: + + * Con SnapRAID, si hanno ancora file system separati per ogni disco. + Con RAID, si ottiene un unico grande file system. + * SnapRAID non esegue lo striping dei dati. + Con RAID, si ottiene un aumento di velocità con lo striping. + * SnapRAID non supporta il recupero in tempo reale. + Con RAID, non si deve smettere di lavorare quando un disco si guasta. + * SnapRAID può recuperare i dati solo da un numero limitato di guasti + del disco. + Con un backup, è possibile recuperare da un guasto completo + dell'intero array di dischi. + * Vengono salvati solo nomi di file, timestamp, symlink e hardlink. + Permessi, proprietà e attributi estesi non vengono salvati. + +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`. + + 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. + + 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 + + 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 + + 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. + + 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. + + 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`! + + 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. + + PASSO 4 -> Sincronizzazione (Sync) + Eseguire il comando `sync` per risincronizzare l'array con il nuovo disco. + + :snapraid sync + + Se tutto è recuperato, questo comando è immediato. + +Comandi + SnapRAID fornisce alcuni semplici comandi che consentono di: + + * Stampare lo stato dell'array -> `status` + * Controllare i dischi -> `smart`, `probe`, `up`, `down` + * Effettuare un backup/snapshot -> `sync` + * Controllare periodicamente i dati -> `scrub` + * Ripristinare l'ultimo backup/snapshot -> `fix`. + + I comandi devono essere scritti in minuscolo. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + +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. + +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): + + 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. + + (2,3,4,5,6)-parity FILE [,FILE] ... + Definisce i file da utilizzare per memorizzare informazioni di parità + extra. + + Per ogni livello di parità specificato, è abilitato un livello + aggiuntivo di protezione: + + * 2-parity abilita la doppia parità RAID6. + * 3-parity abilita la tripla parità. + * 4-parity abilita la parità quadrupla. + * 5-parity abilita la parità quintupla. + * 6-parity abilita la parità esapla. + + Ogni livello di parità richiede la presenza di tutti i livelli di parità + precedenti. + + Si applicano le stesse considerazioni dell'opzione 'parity'. + + Queste opzioni sono facoltative e possono essere utilizzate solo una volta. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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}$ + + 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. + + 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. + + 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. + + 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. + + 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. + + 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 + + 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 + + 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 + +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. + +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`. + +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`. + +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. + +Copyright + Questo file è Copyright (C) 2025 Andrea Mazzoleni + +Vedi Anche + snapraid_log(1), rsync(1) diff --git a/snapraid-it.txt b/snapraid-it.txt new file mode 100644 index 00000000..39309ba0 --- /dev/null +++ b/snapraid-it.txt @@ -0,0 +1,1659 @@ + =================================== + Backup SnapRAID per Array di Dischi + =================================== + + +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à: + +* È possibile utilizzare dischi già pieni di file senza la necessità + di riformattarli, accedendovi come al solito. +* Tutti i dati sono sottoposti ad hashing per garantire l'integrità dei + dati e prevenire la corruzione silente. +* Quando il numero di dischi guasti supera il conteggio di parità, + la perdita di dati è confinata ai dischi interessati; i dati sugli + altri dischi rimangono accessibili. +* Se si eliminano accidentalmente dei file su un disco, il recupero + è possibile. +* I dischi possono avere dimensioni diverse. +* È possibile aggiungere dischi in qualsiasi momento. +* SnapRAID non blocca i dati; è possibile smettere di usarlo in qualsiasi + momento senza riformattare o spostare i dati. +* Per accedere a un file, è necessario far girare solo un singolo disco, + risparmiando energia e riducendo il rumore. + +Per maggiori informazioni, si prega di visitare il sito ufficiale SnapRAID: + + https://www.snapraid.it/ + + +3 LIMITAZIONI +============= + +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: + +* Con SnapRAID, si hanno ancora file system separati per ogni disco. + Con RAID, si ottiene un unico grande file system. +* SnapRAID non esegue lo striping dei dati. + Con RAID, si ottiene un aumento di velocità con lo striping. +* SnapRAID non supporta il recupero in tempo reale. + Con RAID, non si deve smettere di lavorare quando un disco si guasta. +* SnapRAID può recuperare i dati solo da un numero limitato di guasti + del disco. + Con un backup, è possibile recuperare da un guasto completo + dell'intero array di dischi. +* Vengono salvati solo nomi di file, timestamp, symlink e hardlink. + Permessi, proprietà e attributi estesi non vengono salvati. + + +4 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: + +* Stampare lo stato dell'array -> `status` +* Controllare i dischi -> `smart`, `probe`, `up`, `down` +* Effettuare un backup/snapshot -> `sync` +* Controllare periodicamente i dati -> `scrub` +* Ripristinare l'ultimo backup/snapshot -> `fix`. + +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: + +* 2-parity abilita la doppia parità RAID6. +* 3-parity abilita la tripla parità. +* 4-parity abilita la parità quadrupla. +* 5-parity abilita la parità quintupla. +* 6-parity abilita la parità esapla. + +Ogni livello di parità richiede la presenza di tutti i livelli di parità +precedenti. + +Si applicano le stesse considerazioni dell'opzione 'parity'. + +Queste opzioni sono facoltative e possono essere utilizzate solo una volta. + +7.3 z-parity FILE [,FILE] ... +----------------------------- + +Definisce un file e un formato alternativi per memorizzare la tripla +parità. + +Questa opzione è un'alternativa a '3-parity', destinata +principalmente a CPU di fascia bassa come ARM o AMD Phenom, Athlon +e Opteron che non supportano il set di istruzioni SSSE3. In tali +casi, fornisce prestazioni migliori. + +Questo formato è simile ma più veloce di quello utilizzato da ZFS RAIDZ3. +Come ZFS, non funziona oltre la tripla parità. + +Quando si utilizza '3-parity', si verrà avvisati se è consigliato +utilizzare il formato 'z-parity' per un miglioramento delle prestazioni. + +È possibile convertire da un formato all'altro regolando il file +di configurazione con il file z-parity o 3-parity desiderato e +utilizzando 'fix' per ricrearlo. + +7.4 content FILE +---------------- + +Definisce il file da utilizzare per memorizzare l'elenco e i checksum +di tutti i file presenti nell'array di dischi. + +Può essere posizionato su un disco utilizzato per dati, parità o +qualsiasi altro disco disponibile. +Se si utilizza un disco dati, questo file viene automaticamente +escluso dal processo `sync`. + +Questa opzione è obbligatoria e può essere utilizzata più volte +per salvare più copie dello stesso file. + +È necessario memorizzare almeno una copia per ogni disco di parità +utilizzato più uno. L'utilizzo di copie aggiuntive non è dannoso. + +7.5 data NAME DIR +----------------- + +Definisce il nome e il punto di montaggio dei dischi dati +nell'array. NAME viene utilizzato per identificare il disco e deve +essere unico. DIR è il punto di montaggio del disco nel file system. + +È possibile cambiare il punto di montaggio secondo necessità, +purché si mantenga fisso NAME. + +È 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. + + +12 COPYRIGHT +============ + +Questo file è Copyright (C) 2025 Andrea Mazzoleni + + +13 VEDI ANCHE +============= + +snapraid_log(1), rsync(1) diff --git a/snapraid-pl.1 b/snapraid-pl.1 new file mode 100644 index 00000000..915c0a4f --- /dev/null +++ b/snapraid-pl.1 @@ -0,0 +1,1879 @@ +.TH "Kopia zapasowa SnapRAID dla macierzy dyskowych" 1 +.SH NAME +snapraid \- Kopia zapasowa SnapRAID dla macierzy dyskowych +.SH SYNOPSIS +snapraid [\-c, \-\-conf CONFIG] +.PD 0 +.PP +.PD + [\-f, \-\-filter PATTERN] [\-d, \-\-filter\-disk NAME] +.PD 0 +.PP +.PD + [\-m, \-\-filter\-missing] [\-e, \-\-filter\-error] +.PD 0 +.PP +.PD + [\-a, \-\-audit\-only] [\-h, \-\-pre\-hash] [\-i, \-\-import DIR] +.PD 0 +.PP +.PD + [\-p, \-\-plan PERC|bad|new|full] +.PD 0 +.PP +.PD + [\-o, \-\-older\-than DAYS] [\-l, \-\-log FILE] +.PD 0 +.PP +.PD + [\-s, \-\-spin\-down\-on\-error] [\-w, \-\-bw\-limit RATE] +.PD 0 +.PP +.PD + [\-Z, \-\-force\-zero] [\-E, \-\-force\-empty] +.PD 0 +.PP +.PD + [\-U, \-\-force\-uuid] [\-D, \-\-force\-device] +.PD 0 +.PP +.PD + [\-N, \-\-force\-nocopy] [\-F, \-\-force\-full] +.PD 0 +.PP +.PD + [\-R, \-\-force\-realloc] +.PD 0 +.PP +.PD + [\-S, \-\-start BLKSTART] [\-B, \-\-count BLKCOUNT] +.PD 0 +.PP +.PD + [\-L, \-\-error\-limit NUMBER] +.PD 0 +.PP +.PD + [\-A, \-\-stats] +.PD 0 +.PP +.PD + [\-v, \-\-verbose] [\-q, \-\-quiet] +.PD 0 +.PP +.PD + status|smart|probe|up|down|diff|sync|scrub|fix|check +.PD 0 +.PP +.PD + |list|dup|pool|devices|touch|rehash +.PD 0 +.PD +.PP +snapraid [\-V, \-\-version] [\-H, \-\-help] [\-C, \-\-gen\-conf CONTENT] +.PD 0 +.PD +.SH 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. +.PP +Przeznaczony głównie dla domowych centrów multimedialnych z dużymi, +rzadko zmieniającymi się plikami, SnapRAID oferuje kilka funkcji: +.PD 0 +.IP \(bu +Możesz używać dysków już wypełnionych plikami bez +konieczności ich ponownego formatowania, uzyskując do nich dostęp jak zwykle. +.IP \(bu +Wszystkie Twoje dane są haszowane, aby zapewnić integralność danych i zapobiec +cichej korupcji. +.IP \(bu +Gdy liczba uszkodzonych dysków przekracza liczbę parzystości, +utrata danych ogranicza się do dotkniętych dysków; dane na +innych dyskach pozostają dostępne. +.IP \(bu +Jeśli przypadkowo usuniesz pliki na dysku, możliwe jest ich odzyskanie. +.IP \(bu +Dyski mogą mieć różne rozmiary. +.IP \(bu +Możesz dodawać dyski w dowolnym momencie. +.IP \(bu +SnapRAID nie blokuje Twoich danych; możesz przestać go używać +w dowolnym momencie bez ponownego formatowania ani przenoszenia danych. +.IP \(bu +Aby uzyskać dostęp do pliku, wystarczy, że zakręci się tylko jeden dysk, +co oszczędza energię i zmniejsza hałas. +.PD +.PP +Więcej informacji można znaleźć na oficjalnej stronie SnapRAID: +.PP +.RS 4 +https://www.snapraid.it/ +.PD 0 +.PD +.RE +.SH LIMITATIONS +SnapRAID to hybryda programu RAID i programu do tworzenia kopii zapasowych, +której celem jest połączenie najlepszych zalet obu. Ma jednak pewne +ograniczenia, które należy wziąć pod uwagę przed jego użyciem. +.PP +Głównym ograniczeniem jest to, że jeśli dysk ulegnie awarii, a Ty nie wykonałeś +niedawno synchronizacji, możesz nie być w stanie w pełni odzyskać danych. +Dokładniej, możesz nie być w stanie odzyskać danych o wielkości +zmienionych lub usuniętych plików od czasu ostatniej operacji synchronizacji. +Dzieje się tak, nawet jeśli zmienione lub usunięte pliki nie znajdują się na +uszkodzonym dysku. Dlatego SnapRAID jest lepiej dostosowany do +danych, które rzadko się zmieniają. +.PP +Z drugiej strony, nowo dodane pliki nie uniemożliwiają odzyskania już +istniejących plików. Stracisz tylko ostatnio dodane pliki, jeśli +znajdują się one na uszkodzonym dysku. +.PP +Inne ograniczenia SnapRAID to: +.PD 0 +.IP \(bu +W SnapRAID nadal masz oddzielne systemy plików dla każdego dysku. +W RAID otrzymujesz jeden duży system plików. +.IP \(bu +SnapRAID nie rozdziela danych. +W RAID uzyskujesz wzrost prędkości dzięki rozdzielaniu. +.IP \(bu +SnapRAID nie obsługuje odzyskiwania w czasie rzeczywistym. +W RAID nie musisz przerywać pracy, gdy dysk ulegnie awarii. +.IP \(bu +SnapRAID może odzyskać dane tylko z ograniczonej liczby awarii dysków. +W przypadku kopii zapasowej możesz odzyskać dane po całkowitej +awarii całej macierzy dysków. +.IP \(bu +Zapisywane są tylko nazwy plików, znaczniki czasu, dowiązania symboliczne +i dowiązania twarde. +Uprawnienia, właścicielstwo i rozszerzone atrybuty nie są zapisywane. +.PD +.SH 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. +.PP +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. +.PP +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. +.PP +Dyski te będą przeznaczone do przechowywania plików \`parzystości\`. +Nie powinieneś na nich przechowywać swoich danych. +.PP +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. +.PP +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. +.PP +Na przykład, załóżmy, że interesuje Cię tylko jeden poziom parzystości +i Twoje dyski znajdują się w: +.PP +.RS 4 +/mnt/diskp <\- wybrany dysk dla parzystości +.PD 0 +.PP +.PD +/mnt/disk1 <\- pierwszy dysk do ochrony +.PD 0 +.PP +.PD +/mnt/disk2 <\- drugi dysk do ochrony +.PD 0 +.PP +.PD +/mnt/disk3 <\- trzeci dysk do ochrony +.PD 0 +.PD +.RE +.PP +Musisz utworzyć plik konfiguracyjny /etc/snapraid.conf z +następującymi opcjami: +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk1/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk2/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +content F:\\array\\snapraid.content +.PD 0 +.PP +.PD +content G:\\array\\snapraid.content +.PD 0 +.PP +.PD +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PD +.RE +.PP +Jeśli masz wiele dysków i zabrakło Ci liter dysków, możesz zamontować +dyski bezpośrednio w podfolderach. Zobacz: +.PP +.RS 4 +https://www.google.com/search?q=Windows+mount+point +.PD 0 +.PD +.RE +.PP +W tym momencie jesteś gotowy do uruchomienia polecenia \`sync\`, aby zbudować +informacje o parzystości. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +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. +.PP +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. +.PP +Kiedy to polecenie się zakończy, Twoje dane są BEZPIECZNE. +.PP +Teraz możesz zacząć używać swojej macierzy, jak chcesz, i okresowo +aktualizować informacje o parzystości, uruchamiając polecenie \`sync\`. +.SS Scrubbing +Aby okresowo sprawdzać dane i parzystość pod kątem błędów, możesz +uruchomić polecenie \`scrub\`. +.PP +.RS 4 +snapraid scrub +.PD 0 +.PD +.RE +.PP +To polecenie porównuje dane w Twojej macierzy z haszem obliczonym +podczas polecenia \`sync\`, aby zweryfikować integralność. +.PP +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: +.PP +.RS 4 +snapraid \-p 5 \-o 20 scrub +.PD 0 +.PD +.RE +.PP +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\`. +.PP +.RS 4 +snapraid status +.PD 0 +.PD +.RE +.PP +Aby je naprawić, możesz użyć polecenia \`fix\`, filtrując złe bloki +za pomocą opcji \-e, \-\-filter\-error: +.PP +.RS 4 +snapraid \-e fix +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid \-p bad scrub +.PD 0 +.PD +.RE +.PP +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. +.SS 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. +.PP +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. +.PP +Katalog \`pooling\` możesz skonfigurować w pliku konfiguracyjnym za pomocą: +.PP +.RS 4 +pool /pool +.PD 0 +.PD +.RE +.PP +lub, jeśli używasz systemu Windows, za pomocą: +.PP +.RS 4 +pool C:\\pool +.PD 0 +.PD +.RE +.PP +a następnie uruchom polecenie \`pool\`, aby utworzyć lub zaktualizować wirtualny widok. +.PP +.RS 4 +snapraid pool +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +# W sekcji globalnej smb.conf +.PD 0 +.PP +.PD +unix extensions = no +.PD 0 +.PD +.RE +.PP +.RS 4 +# W sekcji udziału smb.conf +.PD 0 +.PP +.PD +[pool] +.PD 0 +.PP +.PD +comment = Pula +.PD 0 +.PP +.PD +path = /pool +.PD 0 +.PP +.PD +read only = yes +.PD 0 +.PP +.PD +guest ok = yes +.PD 0 +.PP +.PD +wide links = yes +.PD 0 +.PP +.PD +follow symlinks = yes +.PD 0 +.PD +.RE +.PP +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. +.PP +Na przykład, działając z serwera o nazwie \`darkstar\`, możesz użyć +opcji: +.PP +.RS 4 +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PP +.PD +pool C:\\pool +.PD 0 +.PP +.PD +share \\\\darkstar +.PD 0 +.PD +.RE +.PP +i udostępnić w sieci następujące katalogi: +.PP +.RS 4 +\\\\darkstar\\pool \-> C:\\pool +.PD 0 +.PP +.PD +\\\\darkstar\\d1 \-> F:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d2 \-> G:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d3 \-> H:\\array +.PD 0 +.PD +.RE +.PP +aby umożliwić zdalnym klientom dostęp do wszystkich plików pod adresem \\\\darkstar\\pool. +.PP +Możesz również potrzebować skonfigurować klientów zdalnych, aby umożliwić dostęp +do zdalnych dowiązań symbolicznych za pomocą polecenia: +.PP +.RS 4 +fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1 +.PD 0 +.PD +.RE +.SS 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: +.PP +.RS 4 +snapraid fix \-f FILE +.PD 0 +.PD +.RE +.PP +lub dla katalogu: +.PP +.RS 4 +snapraid fix \-f DIR/ +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid fix \-m \-f DIR/ +.PD 0 +.PD +.RE +.PP +Lub aby odzyskać wszystkie usunięte pliki na wszystkich dyskach za pomocą: +.PP +.RS 4 +snapraid fix \-m +.PD 0 +.PD +.RE +.SS Recovering +Najgorsze się wydarzyło i straciłeś jeden lub więcej dysków! +.PP +NIE PANIKUJ! Będziesz w stanie je odzyskać! +.PP +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. +.PP +Następnie postępuj zgodnie z poniższymi krokami. +.SS KROK 1 \-> Ponowna konfiguracja +Potrzebujesz trochę miejsca do odzyskania, najlepiej na dodatkowych +zapasowych dyskach, ale wystarczy zewnętrzny dysk USB lub dysk zdalny. +.PP +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. +.PP +Na przykład, jeśli dysk \`d1\` uległ awarii, zmień z: +.PP +.RS 4 +data d1 /mnt/disk1/ +.PD 0 +.PD +.RE +.PP +na: +.PP +.RS 4 +data d1 /mnt/new_spare_disk/ +.PD 0 +.PD +.RE +.PP +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. +.SS KROK 2 \-> Naprawa +Uruchom polecenie fix, zapisując log w pliku zewnętrznym za pomocą: +.PP +.RS 4 +snapraid \-d NAME \-l fix.log fix +.PD 0 +.PD +.RE +.PP +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. +.PP +To polecenie zajmie dużo czasu. +.PP +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. +.PP +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\`. +.PP +Szczegółową listę wszystkich nie do odzyskania bloków znajdziesz w pliku fix.log, +sprawdzając wszystkie linie zaczynające się od \`unrecoverable:\`. +.PP +Jeśli nie jesteś zadowolony z odzyskiwania, możesz spróbować ponownie +tyle razy, ile chcesz. +.PP +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. +.PP +Jeśli jesteś zadowolony z odzyskiwania, możesz kontynuować, +ale pamiętaj, że po synchronizacji nie możesz już ponowić próby polecenia \`fix\`! +.SS KROK 3 \-> Sprawdzenie +Jako ostrożne sprawdzenie, możesz teraz uruchomić polecenie \`check\`, aby upewnić się, że +wszystko jest poprawne na odzyskanym dysku. +.PP +.RS 4 +snapraid \-d NAME \-a check +.PD 0 +.PD +.RE +.PP +Gdzie NAME to nazwa dysku, taka jak \`d1\` w naszym poprzednim przykładzie. +.PP +Opcje \-d i \-a mówią SnapRAID, aby sprawdził tylko określony dysk +i zignorował wszystkie dane parzystości. +.PP +To polecenie zajmie dużo czasu, ale jeśli nie jesteś zbyt ostrożny, +możesz je pominąć. +.SS KROK 4 \-> Synchronizacja +Uruchom polecenie \`sync\`, aby ponownie zsynchronizować macierz z nowym dyskiem. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +Jeśli wszystko zostanie odzyskane, to polecenie jest natychmiastowe. +.SH COMMANDS +SnapRAID udostępnia kilka prostych poleceń, które pozwalają na: +.PD 0 +.IP \(bu +Wyświetlenie statusu macierzy \-> \`status\` +.IP \(bu +Kontrolę dysków \-> \`smart\`, \`probe\`, \`up\`, \`down\` +.IP \(bu +Wykonanie kopii zapasowej/migawki \-> \`sync\` +.IP \(bu +Okresowe sprawdzanie danych \-> \`scrub\` +.IP \(bu +Przywrócenie ostatniej kopii zapasowej/migawki \-> \`fix\`. +.PD +.PP +Polecenia muszą być zapisane małymi literami. +.SS status +Wyświetla podsumowanie stanu macierzy dysków. +.PP +Zawiera informacje o fragmentacji parzystości, jak stare +są bloki bez sprawdzenia i wszystkie zarejestrowane ciche +błędy napotkane podczas scrubbingu. +.PP +Prezentowane informacje odnoszą się do ostatniego momentu, w którym +uruchomiłeś \`sync\`. Późniejsze modyfikacje nie są brane pod uwagę. +.PP +Jeśli wykryto złe bloki, ich numery bloków są wymienione. +Aby je naprawić, możesz użyć polecenia \`fix \-e\`. +.PP +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\'. +.PP +Nic nie jest modyfikowane. +.SS smart +Wyświetla raport SMART wszystkich dysków w systemie. +.PP +Zawiera oszacowanie prawdopodobieństwa awarii w następnym +roku, co pozwala zaplanować wymianę konserwacyjną dysków, które wykazują +podejrzane atrybuty. +.PP +To oszacowanie prawdopodobieństwa uzyskuje się poprzez skorelowanie atrybutów SMART +dysków z danymi Backblaze dostępnymi pod adresem: +.PP +.RS 4 +https://www.backblaze.com/hard\-drive\-test\-data.html +.PD 0 +.PD +.RE +.PP +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. +.PP +Inne możliwe ciągi statusu to: +.RS 4 +.PD 0 +.HP 4 +.I logfail +W przeszłości niektóre atrybuty były niższe niż +próg. +.HP 4 +.I logerr +Dziennik błędów urządzenia zawiera błędy. +.HP 4 +.I selferr +Dziennik autotestu urządzenia zawiera błędy. +.PD +.RE +.PP +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. +.PP +To polecenie używa narzędzia \`smartctl\` i jest równoważne +uruchomieniu \`smartctl \-a\` na wszystkich urządzeniach. +.PP +Jeśli Twoje urządzenia nie zostaną poprawnie wykryte automatycznie, możesz określić +niestandardowe polecenie za pomocą opcji \`smartctl\` w pliku konfiguracyjnym. +.PP +Nic nie jest modyfikowane. +.SS probe +Wyświetla stan ZASILANIA wszystkich dysków w systemie. +.PP +\`Standby\` oznacza, że dysk się nie kręci. \`Active\` oznacza, +że dysk się kręci. +.PP +To polecenie używa narzędzia \`smartctl\` i jest równoważne +uruchomieniu \`smartctl \-n standby \-i\` na wszystkich urządzeniach. +.PP +Jeśli Twoje urządzenia nie zostaną poprawnie wykryte automatycznie, możesz określić +niestandardowe polecenie za pomocą opcji \`smartctl\` w pliku konfiguracyjnym. +.PP +Nic nie jest modyfikowane. +.SS up +Rozpędza wszystkie dyski macierzy. +.PP +Możesz rozpędzić tylko określone dyski za pomocą opcji \-d, \-\-filter\-disk. +.PP +Rozpędzanie wszystkich dysków w tym samym czasie wymaga dużo energii. +Upewnij się, że Twój zasilacz jest w stanie to wytrzymać. +.PP +Nic nie jest modyfikowane. +.SS down +Zatrzymuje wszystkie dyski macierzy. +.PP +To polecenie używa narzędzia \`smartctl\` i jest równoważne +uruchomieniu \`smartctl \-s standby,now\` na wszystkich urządzeniach. +.PP +Możesz zatrzymać tylko określone dyski za pomocą opcji \-d, \-\-filter\-disk. +.PP +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. +.PP +Nic nie jest modyfikowane. +.SS diff +Wyświetla listę wszystkich plików zmodyfikowanych od ostatniej \`sync\`, które +wymagają ponownego obliczenia danych parzystości. +.PP +To polecenie nie sprawdza danych pliku, a jedynie znacznik czasu pliku, +rozmiar i inode. +.PP +Po wyświetleniu listy wszystkich zmienionych plików, prezentowane jest +podsumowanie zmian, pogrupowane według: +.RS 4 +.PD 0 +.HP 4 +.I equal +Pliki niezmienione od wcześniej. +.HP 4 +.I added +Pliki dodane, których wcześniej nie było. +.HP 4 +.I removed +Pliki usunięte. +.HP 4 +.I updated +Pliki o innym rozmiarze lub znaczniku czasu, co oznacza, że +zostały zmodyfikowane. +.HP 4 +.I 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. +.HP 4 +.I 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. +.HP 4 +.I restored +Pliki o innym inode, ale pasującej nazwie, rozmiarze i znaczniku czasu. +Są to zazwyczaj pliki przywrócone po usunięciu. +.PD +.RE +.PP +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. +.PP +Nic nie jest modyfikowane. +.SS sync +Aktualizuje informacje o parzystości. Wszystkie zmodyfikowane pliki +w macierzy dysków są odczytywane, a odpowiednie dane parzystości +są aktualizowane. +.PP +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. +.PP +Jeśli podczas procesu zostaną znalezione ciche błędy lub błędy wejścia/wyjścia, +odpowiednie bloki zostaną oznaczone jako złe. +.PP +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. +.PP +Pliki \`content\` i \`parity\` są modyfikowane w razie potrzeby. +Pliki w macierzy NIE są modyfikowane. +.SS scrub +Sprawdza macierz, szukając cichych błędów lub błędów wejścia/wyjścia w danych +i dyskach parzystości. +.PP +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. +.PP +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. +.PP +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\`. +.PP +Aby uzyskać szczegóły statusu sprawdzania, użyj polecenia \`status\`. +.PP +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\`. +.PP +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. +.PP +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. +.SS fix +Naprawia wszystkie pliki i dane parzystości. +.PP +Wszystkie pliki i dane parzystości są porównywane ze stanem migawki +zapisanym w ostatniej \`sync\`. +Jeśli zostanie znaleziona różnica, jest ona przywracana do zapisanego stanu migawki. +.PP +OSTRZEŻENIE! Polecenie \`fix\` nie rozróżnia błędów od +celowych modyfikacji. Bezwarunkowo przywraca stan pliku +do ostatniej \`sync\`. +.PP +Jeśli nie określono żadnej innej opcji, przetwarzana jest cała macierz. +Użyj opcji filtra, aby wybrać podzbiór plików lub dysków do operacji. +.PP +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\`. +.PP +SnapRAID zmienia nazwy wszystkich plików, których nie można naprawić, dodając +rozszerzenie \`.unrecoverable\`. +.PP +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. +.PP +Pliki są identyfikowane tylko po ścieżce, a nie po inode. +.PP +Plik \`content\` NIE jest modyfikowany. +Pliki \`parity\` są modyfikowane w razie potrzeby. +Pliki w macierzy są modyfikowane w razie potrzeby. +.SS check +Weryfikuje wszystkie pliki i dane parzystości. +.PP +Działa jak \`fix\`, ale tylko symuluje odzyskiwanie i żadne zmiany +nie są zapisywane w macierzy. +.PP +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\`. +.PP +Jeśli użyjesz opcji \-a, \-\-audit\-only, sprawdzane są tylko +dane pliku, a dane parzystości są ignorowane, co zapewnia +szybsze działanie. +.PP +Pliki są identyfikowane tylko po ścieżce, a nie po inode. +.PP +Nic nie jest modyfikowane. +.SS list +Wyświetla listę wszystkich plików zawartych w macierzy w momencie +ostatniej \`sync\`. +.PP +Z \-v lub \-\-verbose, wyświetlany jest również czas z dokładnością do podsekundy. +.PP +Nic nie jest modyfikowane. +.SS 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. +.PP +Nic nie jest modyfikowane. +.SS pool +Tworzy lub aktualizuje wirtualny widok wszystkich +plików w Twojej macierzy dysków w katalogu \`pooling\`. +.PP +Pliki nie są kopiowane, ale linkowane za pomocą +dowiązań symbolicznych. +.PP +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. +.PP +Nic nie jest modyfikowane poza katalogiem puli. +.SS devices +Wyświetla urządzenia niskiego poziomu używane przez macierz. +.PP +To polecenie wyświetla skojarzenia urządzeń w macierzy +i jest przeznaczone głównie jako interfejs skryptowy. +.PP +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. +.PP +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. +.PP +Nic nie jest modyfikowane. +.SS touch +Ustawia arbitralny znacznik czasu z dokładnością do podsekundy dla wszystkich plików, +które mają go ustawiony na zero. +.PP +Poprawia to zdolność SnapRAID do rozpoznawania przeniesionych +i skopiowanych plików, ponieważ sprawia, że znacznik czasu jest prawie unikalny, +redukując możliwe duplikaty. +.PP +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. +.PP +Znacznik czasu z dokładnością do sekundy nie jest modyfikowany, +więc wszystkie daty i czasy Twoich plików zostaną zachowane. +.SS rehash +Planuje ponowne haszowanie całej macierzy. +.PP +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. +.PP +Jeśli używasz już optymalnego hasza, to polecenie +nic nie robi i informuje Cię, że nie jest potrzebne żadne działanie. +.PP +Ponowne haszowanie nie jest wykonywane natychmiast, ale odbywa się +stopniowo podczas \`sync\` i \`scrub\`. +.PP +Możesz sprawdzić stan ponownego haszowania za pomocą \`status\`. +.PP +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. +.SH OPTIONS +SnapRAID udostępnia następujące opcje: +.TP +.B \-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\`. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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. +.TP +.B \-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). +.TP +.B \-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. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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. \`\[dq]>>result.log\[dq]\`. +Aby wyprowadzić log do standardowego wyjścia lub standardowego błędu, +możesz użyć odpowiednio \`\[dq]>&1\[dq]\` i \`\[dq]>&2\[dq]\`. +Opisy tagów logu znajdziesz w pliku snapraid_log.txt lub na stronie podręcznika. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-B, \-\-count BLKCOUNT +Przetwarza tylko określoną liczbę bloków. +Ta opcja jest przeznaczona głównie do zaawansowanego ręcznego odzyskiwania. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-H, \-\-help +Wyświetla krótki ekran pomocy. +.TP +.B \-V, \-\-version +Wyświetla wersję programu. +.SH CONFIGURATION +SnapRAID wymaga pliku konfiguracyjnego, aby wiedzieć, gdzie znajduje się Twoja macierz +dysków i gdzie przechowywać informacje o parzystości. +.PP +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\`. +.PP +Musi zawierać następujące opcje (uwzględniające wielkość liter): +.SS 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. +.PP +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. +.PP +Możesz dodać dodatkowe pliki parzystości później, ale nie możesz +ich zmieniać kolejności ani usuwać. +.PP +Trzymanie dysków parzystości zarezerwowanych dla parzystości zapewnia, że +nie ulegną fragmentacji, co poprawia wydajność. +.PP +W systemie Windows 256 MB jest pozostawione niewykorzystane na każdym dysku, aby uniknąć +ostrzeżenia o pełnych dyskach. +.PP +Ta opcja jest obowiązkowa i może być używana tylko raz. +.SS (2,3,4,5,6)\-parity FILE [,FILE] ... +Definiuje pliki do użycia do przechowywania dodatkowych informacji o parzystości. +.PP +Dla każdego określonego poziomu parzystości włączany jest jeden dodatkowy +poziom ochrony: +.PD 0 +.IP \(bu +2\-parity włącza podwójną parzystość RAID6. +.IP \(bu +3\-parity włącza potrójną parzystość. +.IP \(bu +4\-parity włącza poczwórną (cztery) parzystość. +.IP \(bu +5\-parity włącza pięciokrotną (pięć) parzystość. +.IP \(bu +6\-parity włącza sześciokrotną (sześć) parzystość. +.PD +.PP +Każdy poziom parzystości wymaga obecności wszystkich poprzednich poziomów parzystości. +.PP +Obowiązują te same uwagi, co dla opcji \'parity\'. +.PP +Te opcje są opcjonalne i mogą być używane tylko raz. +.SS z\-parity FILE [,FILE] ... +Definiuje alternatywny plik i format do przechowywania potrójnej parzystości. +.PP +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ść. +.PP +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. +.PP +Podczas używania \'3\-parity\' zostaniesz ostrzeżony, jeśli zaleca się użycie +formatu \'z\-parity\' w celu poprawy wydajności. +.PP +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. +.SS content FILE +Definiuje plik do użycia do przechowywania listy i sum kontrolnych wszystkich +plików obecnych w Twojej macierzy dysków. +.PP +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\`. +.PP +Ta opcja jest obowiązkowa i może być używana wielokrotnie do zapisania +wielu kopii tego samego pliku. +.PP +Musisz przechowywać co najmniej jedną kopię dla każdego używanego dysku parzystości +plus jeden. Używanie dodatkowych kopii nie szkodzi. +.SS 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. +.PP +Możesz zmieniać punkt montowania w razie potrzeby, o ile +zachowasz stałą nazwę NAME. +.PP +Powinieneś użyć jednej opcji dla każdego dysku danych w macierzy. +.PP +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. +.SS 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. +.SS 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. +.PP +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\`. +.PP +Zobacz sekcję PATTERN, aby uzyskać więcej szczegółów na temat specyfikacji +wzorców. +.PP +Ta opcja może być używana wielokrotnie. +.SS blocksize SIZE_IN_KIBIBYTES +Definiuje podstawowy rozmiar bloku w kibibajtach dla parzystości. +Jeden kibibajt to 1024 bajty. +.PP +Domyślny rozmiar bloku to 256, co powinno działać w większości przypadków. +.PP +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ść! +.PP +Powodem użycia innego rozmiaru bloku jest posiadanie wielu małych +plików, rzędu milionów. +.PP +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. +.PP +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. +.PP +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ć. +.PP +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. +.PP +Sztuczką, aby uzyskać większą partycję parzystości w systemie Linux, jest sformatowanie jej +za pomocą polecenia: +.PP +.RS 4 +mkfs.ext4 \-m 0 \-T largefile4 DEVICE +.PD 0 +.PD +.RE +.PP +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. +.SS hashsize SIZE_IN_BYTES +Definiuje rozmiar hasza w bajtach dla zapisanych bloków. +.PP +Domyślny rozmiar hasza to 16 bajtów (128 bitów), co powinno działać +w większości przypadków. +.PP +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ść! +.PP +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. +.PP +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. +.PP +Na przykład, z 8 dyskami po 4 TB, rozmiarem bloku 256 KiB +(1 KiB = 1024 bajty) i rozmiarem hasza 16, otrzymujesz: +.PP +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1,93 GiB +.PD 0 +.PD +.PP +Przełączając się na rozmiar hasza 8, otrzymujesz: +.PP +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1,02 GiB +.PD 0 +.PD +.PP +Przełączając się na rozmiar bloku 512, otrzymujesz: +.PP +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0,96 GiB +.PD 0 +.PD +.PP +Przełączając się zarówno na rozmiar hasza 8, jak i rozmiar bloku 512, otrzymujesz: +.PP +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB +.PD 0 +.PD +.SS 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. +.SS 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. +.PP +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. +.PP +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. +.PP +Normalnie SnapRAID pokazuje tylko temperaturę najgorętszego dysku. +Aby wyświetlić temperaturę wszystkich dysków, użyj opcji \-A lub \-\-stats. +.SS 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. +.SS pool DIR +Definiuje katalog puli, w którym tworzony jest wirtualny widok macierzy +dysków za pomocą polecenia \`pool\`. +.PP +Katalog musi już istnieć. +.SS share UNC_DIR +Definiuje ścieżkę UNC Windows wymaganą do zdalnego dostępu do dysków. +.PP +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. +.PP +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. +.PP +Ta opcja jest wymagana tylko dla systemu Windows. +.SS 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. +.PP +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\`. +.PP +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\`. +.PP +Zapoznaj się z dokumentacją smartmontools, aby uzyskać możliwe opcje: +.PP +.RS 4 +https://www.smartmontools.org/wiki/Supported_RAID\-Controllers +.PD 0 +.PP +.PD +https://www.smartmontools.org/wiki/Supported_USB\-Devices +.PD 0 +.PD +.RE +.PP +Na przykład: +.PP +.RS 4 +smartctl parity \-d sat %s +.PD 0 +.PD +.RE +.SS 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. +.PP +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. +.PP +Na przykład, aby zignorować atrybut \`Current Pending Sector Count\` na +wszystkich dyskach: +.PP +.RS 4 +smartignore * 197 +.PD 0 +.PD +.RE +.PP +Aby zignorować go tylko na pierwszym dysku parzystości: +.PP +.RS 4 +smartignore parity 197 +.PD 0 +.PD +.RE +.SS Examples +Przykład typowej konfiguracji dla systemu Unix: +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /mnt/diskp/snapraid.content +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +exclude /tmp/ +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/sg0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/sg0 +.PD 0 +.PD +.RE +.PP +Przykład typowej konfiguracji dla systemu Windows: +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content E:\\snapraid.content +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +data d1 G:\\array\\ +.PD 0 +.PP +.PD +data d2 H:\\array\\ +.PD 0 +.PP +.PD +data d3 I:\\array\\ +.PD 0 +.PP +.PD +exclude Thumbs.db +.PD 0 +.PP +.PD +exclude \\$RECYCLE.BIN +.PD 0 +.PP +.PD +exclude \\System Volume Information +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/arcmsr0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 +.PD 0 +.PD +.RE +.SH PATTERN +Wzorce są używane do wybierania podzbioru plików do wykluczenia lub włączenia +do procesu. +.PP +Istnieją cztery różne typy wzorców: +.TP +.B 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. +.TP +.B 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. +.TP +.B /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. +.TP +.B /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. +.PP +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. +.PP +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. +.PP +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ń. +.PP +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: +.PP +.RS 4 +# Wyklucza dowolny plik o nazwie \`*.unrecoverable\` +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Wyklucza katalog główny \`/lost+found\` +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +# Wyklucza dowolny podkatalog o nazwie \`tmp\` +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PD +.RE +.PP +Odwrotnym podejściem jest zdefiniowanie tylko plików, które chcesz przetwarzać, +używając tylko reguł \`include\`. Na przykład: +.PP +.RS 4 +# Włącza tylko niektóre katalogi +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +# Wyklucza dowolny plik o nazwie \`*.unrecoverable\` +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Wyklucza dowolny podkatalog o nazwie \`tmp\` +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PP +.PD +# Włącza tylko niektóre katalogi +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +W wierszu poleceń, używając opcji \-f, możesz użyć tylko wzorców \`include\`. +Na przykład: +.PP +.RS 4 +# Sprawdza tylko pliki .mp3. +.PD 0 +.PP +.PD +# W systemie Unix użyj cudzysłowów, aby uniknąć rozszerzenia globbing przez powłokę. +.PD 0 +.PP +.PD +snapraid \-f \[dq]*.mp3\[dq] check +.PD 0 +.PD +.RE +.PP +W systemie Unix, używając znaków globbing w wierszu poleceń, musisz +je cytować, aby zapobiec ich rozszerzeniu przez powłokę. +.SH CONTENT +SnapRAID przechowuje listę i sumy kontrolne Twoich plików w pliku zawartości. +.PP +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. +.PP +Ten plik jest odczytywany i zapisywany przez polecenia \`sync\` i \`scrub\` +oraz odczytywany przez polecenia \`fix\`, \`check\` i \`status\`. +.SH PARITY +SnapRAID przechowuje informacje o parzystości Twojej macierzy w plikach +parzystości. +.PP +Są to pliki binarne zawierające obliczoną parzystość wszystkich +bloków zdefiniowanych w pliku \`content\`. +.PP +Pliki te są odczytywane i zapisywane przez polecenia \`sync\` i \`fix\` +oraz tylko odczytywane przez polecenia \`scrub\` i \`check\`. +.SH ENCODING +SnapRAID w systemie Unix ignoruje wszelkie kodowanie. Odczytuje i przechowuje +nazwy plików z tym samym kodowaniem używanym przez system plików. +.PP +W systemie Windows wszystkie nazwy odczytane z systemu plików są konwertowane i +przetwarzane w formacie UTF\-8. +.PP +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. +.SH COPYRIGHT +Ten plik jest chroniony prawem autorskim (C) 2025 Andrea Mazzoleni +.SH SEE ALSO +snapraid_log(1), rsync(1) diff --git a/snapraid-pl.d b/snapraid-pl.d new file mode 100644 index 00000000..d0067be0 --- /dev/null +++ b/snapraid-pl.d @@ -0,0 +1,1444 @@ +Name{number} + snapraid - Kopia zapasowa SnapRAID dla macierzy dyskowych + +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] + +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: + + * Możesz używać dysków już wypełnionych plikami bez + konieczności ich ponownego formatowania, uzyskując do nich dostęp jak zwykle. + * Wszystkie Twoje dane są haszowane, aby zapewnić integralność danych i zapobiec + cichej korupcji. + * Gdy liczba uszkodzonych dysków przekracza liczbę parzystości, + utrata danych ogranicza się do dotkniętych dysków; dane na + innych dyskach pozostają dostępne. + * Jeśli przypadkowo usuniesz pliki na dysku, możliwe jest ich odzyskanie. + * Dyski mogą mieć różne rozmiary. + * Możesz dodawać dyski w dowolnym momencie. + * SnapRAID nie blokuje Twoich danych; możesz przestać go używać + w dowolnym momencie bez ponownego formatowania ani przenoszenia danych. + * Aby uzyskać dostęp do pliku, wystarczy, że zakręci się tylko jeden dysk, + co oszczędza energię i zmniejsza hałas. + + Więcej informacji można znaleźć na oficjalnej stronie SnapRAID: + + :https://www.snapraid.it/ + +Limitations + SnapRAID to hybryda programu RAID i programu do tworzenia kopii zapasowych, + której celem jest połączenie najlepszych zalet obu. Ma jednak pewne + ograniczenia, które należy wziąć pod uwagę przed jego użyciem. + + 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: + + * W SnapRAID nadal masz oddzielne systemy plików dla każdego dysku. + W RAID otrzymujesz jeden duży system plików. + * SnapRAID nie rozdziela danych. + W RAID uzyskujesz wzrost prędkości dzięki rozdzielaniu. + * SnapRAID nie obsługuje odzyskiwania w czasie rzeczywistym. + W RAID nie musisz przerywać pracy, gdy dysk ulegnie awarii. + * SnapRAID może odzyskać dane tylko z ograniczonej liczby awarii dysków. + W przypadku kopii zapasowej możesz odzyskać dane po całkowitej + awarii całej macierzy dysków. + * Zapisywane są tylko nazwy plików, znaczniki czasu, dowiązania symboliczne + i dowiązania twarde. + Uprawnienia, właścicielstwo i rozszerzone atrybuty nie są zapisywane. + +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`. + + 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. + + 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 + + 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 + + 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. + + 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. + + 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`! + + 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ąć. + + KROK 4 -> Synchronizacja + Uruchom polecenie `sync`, aby ponownie zsynchronizować macierz z nowym dyskiem. + + :snapraid sync + + Jeśli wszystko zostanie odzyskane, to polecenie jest natychmiastowe. + +Commands + SnapRAID udostępnia kilka prostych poleceń, które pozwalają na: + + * Wyświetlenie statusu macierzy -> `status` + * Kontrolę dysków -> `smart`, `probe`, `up`, `down` + * Wykonanie kopii zapasowej/migawki -> `sync` + * Okresowe sprawdzanie danych -> `scrub` + * Przywrócenie ostatniej kopii zapasowej/migawki -> `fix`. + + Polecenia muszą być zapisane małymi literami. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + +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. + +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): + + 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. + + (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: + + * 2-parity włącza podwójną parzystość RAID6. + * 3-parity włącza potrójną parzystość. + * 4-parity włącza poczwórną (cztery) parzystość. + * 5-parity włącza pięciokrotną (pięć) parzystość. + * 6-parity włącza sześciokrotną (sześć) parzystość. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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 + + 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. + + 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. + + 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. + + pool DIR + Definiuje katalog puli, w którym tworzony jest wirtualny widok macierzy + dysków za pomocą polecenia `pool`. + + Katalog musi już istnieć. + + 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. + + 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 + + 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 + + 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 + +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ę. + +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`. + +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`. + +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. + +Copyright + Ten plik jest chroniony prawem autorskim (C) 2025 Andrea Mazzoleni + +See Also + snapraid_log(1), rsync(1) diff --git a/snapraid-pl.txt b/snapraid-pl.txt new file mode 100644 index 00000000..cff8efd9 --- /dev/null +++ b/snapraid-pl.txt @@ -0,0 +1,1558 @@ + ============================================== + Kopia zapasowa SnapRAID dla macierzy dyskowych + ============================================== + + +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: + +* Możesz używać dysków już wypełnionych plikami bez + konieczności ich ponownego formatowania, uzyskując do nich dostęp jak zwykle. +* Wszystkie Twoje dane są haszowane, aby zapewnić integralność danych i zapobiec + cichej korupcji. +* Gdy liczba uszkodzonych dysków przekracza liczbę parzystości, + utrata danych ogranicza się do dotkniętych dysków; dane na + innych dyskach pozostają dostępne. +* Jeśli przypadkowo usuniesz pliki na dysku, możliwe jest ich odzyskanie. +* Dyski mogą mieć różne rozmiary. +* Możesz dodawać dyski w dowolnym momencie. +* SnapRAID nie blokuje Twoich danych; możesz przestać go używać + w dowolnym momencie bez ponownego formatowania ani przenoszenia danych. +* Aby uzyskać dostęp do pliku, wystarczy, że zakręci się tylko jeden dysk, + co oszczędza energię i zmniejsza hałas. + +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: + +* W SnapRAID nadal masz oddzielne systemy plików dla każdego dysku. + W RAID otrzymujesz jeden duży system plików. +* SnapRAID nie rozdziela danych. + W RAID uzyskujesz wzrost prędkości dzięki rozdzielaniu. +* SnapRAID nie obsługuje odzyskiwania w czasie rzeczywistym. + W RAID nie musisz przerywać pracy, gdy dysk ulegnie awarii. +* SnapRAID może odzyskać dane tylko z ograniczonej liczby awarii dysków. + W przypadku kopii zapasowej możesz odzyskać dane po całkowitej + awarii całej macierzy dysków. +* Zapisywane są tylko nazwy plików, znaczniki czasu, dowiązania symboliczne + i dowiązania twarde. + Uprawnienia, właścicielstwo i rozszerzone atrybuty nie są zapisywane. + + +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: + +* Wyświetlenie statusu macierzy -> `status` +* Kontrolę dysków -> `smart`, `probe`, `up`, `down` +* Wykonanie kopii zapasowej/migawki -> `sync` +* Okresowe sprawdzanie danych -> `scrub` +* Przywrócenie ostatniej kopii zapasowej/migawki -> `fix`. + +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: + +* 2-parity włącza podwójną parzystość RAID6. +* 3-parity włącza potrójną parzystość. +* 4-parity włącza poczwórną (cztery) parzystość. +* 5-parity włącza pięciokrotną (pięć) parzystość. +* 6-parity włącza sześciokrotną (sześć) parzystość. + +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. + + +12 COPYRIGHT +============ + +Ten plik jest chroniony prawem autorskim (C) 2025 Andrea Mazzoleni + + +13 SEE ALSO +=========== + +snapraid_log(1), rsync(1) diff --git a/snapraid-ro.1 b/snapraid-ro.1 new file mode 100644 index 00000000..8d59b95d --- /dev/null +++ b/snapraid-ro.1 @@ -0,0 +1,1880 @@ +.TH "SnapRAID Backup pentru Matrici de Discuri" 1 +.SH NAME +snapraid \- SnapRAID Backup pentru Matrici de Discuri +.SH SINTAXă +snapraid [\-c, \-\-conf CONFIG] +.PD 0 +.PP +.PD + [\-f, \-\-filter PATTERN] [\-d, \-\-filter\-disk NAME] +.PD 0 +.PP +.PD + [\-m, \-\-filter\-missing] [\-e, \-\-filter\-error] +.PD 0 +.PP +.PD + [\-a, \-\-audit\-only] [\-h, \-\-pre\-hash] [\-i, \-\-import DIR] +.PD 0 +.PP +.PD + [\-p, \-\-plan PERC|bad|new|full] +.PD 0 +.PP +.PD + [\-o, \-\-older\-than DAYS] [\-l, \-\-log FILE] +.PD 0 +.PP +.PD + [\-s, \-\-spin\-down\-on\-error] [\-w, \-\-bw\-limit RATE] +.PD 0 +.PP +.PD + [\-Z, \-\-force\-zero] [\-E, \-\-force\-empty] +.PD 0 +.PP +.PD + [\-U, \-\-force\-uuid] [\-D, \-\-force\-device] +.PD 0 +.PP +.PD + [\-N, \-\-force\-nocopy] [\-F, \-\-force\-full] +.PD 0 +.PP +.PD + [\-R, \-\-force\-realloc] +.PD 0 +.PP +.PD + [\-S, \-\-start BLKSTART] [\-B, \-\-count BLKCOUNT] +.PD 0 +.PP +.PD + [\-L, \-\-error\-limit NUMBER] +.PD 0 +.PP +.PD + [\-A, \-\-stats] +.PD 0 +.PP +.PD + [\-v, \-\-verbose] [\-q, \-\-quiet] +.PD 0 +.PP +.PD + status|smart|probe|up|down|diff|sync|scrub|fix|check +.PD 0 +.PP +.PD + |list|dup|pool|devices|touch|rehash +.PD 0 +.PD +.PP +snapraid [\-V, \-\-version] [\-H, \-\-help] [\-C, \-\-gen\-conf CONTENT] +.PD 0 +.PD +.SH 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. +.PP +Destinat în principal centrelor media de acasă cu fișiere mari, +care se schimbă rar, SnapRAID oferă câteva caracteristici: +.PD 0 +.IP \(bu +Puteți utiliza discuri deja pline cu fișiere fără +nevoia de a le reformat, accesându\-le ca de obicei. +.IP \(bu +Toate datele dvs. sunt hash\-uite pentru a asigura integritatea datelor și a preveni +corupția silențioasă. +.IP \(bu +Când numărul de discuri defecte depășește numărul de parități, +pierderea de date este limitată la discurile afectate; datele de pe +celelalte discuri rămân accesibile. +.IP \(bu +Dacă ștergeți accidental fișiere de pe un disc, recuperarea este +posibilă. +.IP \(bu +Discurile pot avea dimensiuni diferite. +.IP \(bu +Puteți adăuga discuri în orice moment. +.IP \(bu +SnapRAID nu vă blochează datele; puteți înceta să\-l utilizați +oricând fără a reforma sau muta date. +.IP \(bu +Pentru a accesa un fișier, este necesar să se rotească doar un singur disc, economisind +energie și reducând zgomotul. +.PD +.PP +Pentru mai multe informații, vă rugăm să vizitați site\-ul oficial SnapRAID: +.PP +.RS 4 +https://www.snapraid.it/ +.PD 0 +.PD +.RE +.SH LIMITăRI +SnapRAID este un hibrid între un program RAID și unul de backup, care urmărește să combine +cele mai bune beneficii ale ambelor. Cu toate acestea, are unele limitări pe care ar trebui +să le luați în considerare înainte de a\-l utiliza. +.PP +Principala limitare este că, dacă un disc se defectează și nu ați făcut recent o sincronizare, +este posibil să nu puteți recupera complet. +Mai exact, este posibil să nu puteți recupera până la dimensiunea +fișierelor modificate sau șterse de la ultima operațiune de sincronizare. +Acest lucru se întâmplă chiar dacă fișierele modificate sau șterse nu sunt pe +discul defect. Acesta este motivul pentru care SnapRAID este mai potrivit pentru +date care se schimbă rar. +.PP +Pe de altă parte, fișierele nou adăugate nu împiedică recuperarea fișierelor +deja existente. Veți pierde doar fișierele adăugate recent dacă acestea +se află pe discul defect. +.PP +Alte limitări ale SnapRAID sunt: +.PD 0 +.IP \(bu +Cu SnapRAID, aveți în continuare sisteme de fișiere separate pentru fiecare disc. +Cu RAID, obțineți un singur sistem de fișiere mare. +.IP \(bu +SnapRAID nu face striping de date. +Cu RAID, obțineți un spor de viteză prin striping. +.IP \(bu +SnapRAID nu suportă recuperarea în timp real. +Cu RAID, nu trebuie să vă opriți din lucru atunci când un disc se defectează. +.IP \(bu +SnapRAID poate recupera date doar dintr\-un număr limitat de defecte de disc. +Cu un backup, puteți recupera dintr\-o defecțiune completă +a întregii matrici de discuri. +.IP \(bu +Sunt salvate doar numele fișierelor, mărcile temporale, symlink\-urile și hardlink\-urile. +Permisiunile, proprietarul și atributele extinse nu sunt salvate. +.PD +.SH 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. +.PP +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. +.PP +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. +.PP +Aceste discuri vor fi dedicate stocării fișierelor de \`paritate\`. +Nu ar trebui să stocați datele dvs. pe ele. +.PP +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. +.PP +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ă. +.PP +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: +.PP +.RS 4 +/mnt/diskp <\- discul selectat pentru paritate +.PD 0 +.PP +.PD +/mnt/disk1 <\- primul disc de protejat +.PD 0 +.PP +.PD +/mnt/disk2 <\- al doilea disc de protejat +.PD 0 +.PP +.PD +/mnt/disk3 <\- al treilea disc de protejat +.PD 0 +.PD +.RE +.PP +Trebuie să creați fișierul de configurare /etc/snapraid.conf cu +următoarele opțiuni: +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk1/snapraid.content +.PD 0 +.PP +.PD +content /mnt/disk2/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +content F:\\array\\snapraid.content +.PD 0 +.PP +.PD +content G:\\array\\snapraid.content +.PD 0 +.PP +.PD +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PD +.RE +.PP +Dacă aveți multe discuri și rămâneți fără litere de unitate, puteți monta +discurile direct în subfoldere. Vedeți: +.PP +.RS 4 +https://www.google.com/search?q=Windows+mount+point +.PD 0 +.PD +.RE +.PP +În acest moment, sunteți gata să rulați comanda \`sync\` pentru a construi +informațiile de paritate. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +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. +.PP +Îl puteți opri oricând apăsând Ctrl+C, iar la următoarea rulare, +va relua de unde a fost întrerupt. +.PP +Când această comandă se finalizează, datele dvs. sunt ÎN SIGURANȚĂ. +.PP +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\`. +.SS Scrubbing (Verificare) +Pentru a verifica periodic datele și paritatea pentru erori, puteți +rula comanda \`scrub\`. +.PP +.RS 4 +snapraid scrub +.PD 0 +.PD +.RE +.PP +Această comandă compară datele din matricea dvs. cu hash\-ul calculat +în timpul comenzii \`sync\` pentru a verifica integritatea. +.PP +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: +.PP +.RS 4 +snapraid \-p 5 \-o 20 scrub +.PD 0 +.PD +.RE +.PP +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\`. +.PP +.RS 4 +snapraid status +.PD 0 +.PD +.RE +.PP +Pentru a le repara, puteți utiliza comanda \`fix\`, filtrând pentru blocuri defecte cu +opțiunea \-e, \-\-filter\-error: +.PP +.RS 4 +snapraid \-e fix +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid \-p bad scrub +.PD 0 +.PD +.RE +.PP +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. +.SS 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. +.PP +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. +.PP +Puteți configura directorul de \`pooling\` în fișierul de configurare cu: +.PP +.RS 4 +pool /pool +.PD 0 +.PD +.RE +.PP +sau, dacă sunteți pe Windows, cu: +.PP +.RS 4 +pool C:\\pool +.PD 0 +.PD +.RE +.PP +și apoi rulați comanda \`pool\` pentru a crea sau actualiza vizualizarea virtuală. +.PP +.RS 4 +snapraid pool +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +# În secțiunea global a smb.conf +.PD 0 +.PP +.PD +unix extensions = no +.PD 0 +.PD +.RE +.PP +.RS 4 +# În secțiunea share a smb.conf +.PD 0 +.PP +.PD +[pool] +.PD 0 +.PP +.PD +comment = Pool +.PD 0 +.PP +.PD +path = /pool +.PD 0 +.PP +.PD +read only = yes +.PD 0 +.PP +.PD +guest ok = yes +.PD 0 +.PP +.PD +wide links = yes +.PD 0 +.PP +.PD +follow symlinks = yes +.PD 0 +.PD +.RE +.PP +Î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. +.PP +De exemplu, operând de pe un server numit \`darkstar\`, puteți utiliza +opțiunile: +.PP +.RS 4 +data d1 F:\\array\\ +.PD 0 +.PP +.PD +data d2 G:\\array\\ +.PD 0 +.PP +.PD +data d3 H:\\array\\ +.PD 0 +.PP +.PD +pool C:\\pool +.PD 0 +.PP +.PD +share \\\\darkstar +.PD 0 +.PD +.RE +.PP +și partajați următoarele directoare peste rețea: +.PP +.RS 4 +\\\\darkstar\\pool \-> C:\\pool +.PD 0 +.PP +.PD +\\\\darkstar\\d1 \-> F:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d2 \-> G:\\array +.PD 0 +.PP +.PD +\\\\darkstar\\d3 \-> H:\\array +.PD 0 +.PD +.RE +.PP +pentru a permite clienților la distanță să acceseze toate fișierele la \\\\darkstar\\pool. +.PP +De asemenea, ar putea fi necesar să configurați clienții la distanță pentru a permite accesul la symlink\-uri la distanță cu comanda: +.PP +.RS 4 +fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1 +.PD 0 +.PD +.RE +.SS 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: +.PP +.RS 4 +snapraid fix \-f FILE +.PD 0 +.PD +.RE +.PP +sau pentru un director: +.PP +.RS 4 +snapraid fix \-f DIR/ +.PD 0 +.PD +.RE +.PP +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. +.PP +.RS 4 +snapraid fix \-m \-f DIR/ +.PD 0 +.PD +.RE +.PP +Sau pentru a recupera toate fișierele șterse de pe toate unitățile cu: +.PP +.RS 4 +snapraid fix \-m +.PD 0 +.PD +.RE +.SS Recuperare +Cel mai rău s\-a întâmplat și ați pierdut unul sau mai multe discuri! +.PP +NU INTRAȚI ÎN PANICĂ! Veți putea să le recuperați! +.PP +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. +.PP +Apoi continuați cu următorii pași. +.SS 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. +.PP +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. +.PP +De exemplu, dacă discul \`d1\` a eșuat, schimbați de la: +.PP +.RS 4 +data d1 /mnt/disk1/ +.PD 0 +.PD +.RE +.PP +la: +.PP +.RS 4 +data d1 /mnt/new_spare_disk/ +.PD 0 +.PD +.RE +.PP +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. +.SS PASUL 2 \-> Reparare (Fix) +Rulați comanda fix, stocând jurnalul într\-un fișier extern cu: +.PP +.RS 4 +snapraid \-d NAME \-l fix.log fix +.PD 0 +.PD +.RE +.PP +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. +.PP +Această comandă va dura mult timp. +.PP +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. +.PP +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\`. +.PP +Puteți găsi o listă detaliată a tuturor blocurilor nerecuperabile în fișierul fix.log +verificând toate liniile care încep cu \`unrecoverable:\`. +.PP +Dacă nu sunteți mulțumit de recuperare, o puteți reîncerca de câte +ori doriți. +.PP +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. +.PP +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! +.SS 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. +.PP +.RS 4 +snapraid \-d NAME \-a check +.PD 0 +.PD +.RE +.PP +Unde NAME este numele discului, cum ar fi \`d1\` în exemplul nostru anterior. +.PP +Opțiunile \-d și \-a spun SnapRAID să verifice doar discul specificat +și să ignore toate datele de paritate. +.PP +Această comandă va dura mult timp, dar dacă nu sunteți excesiv de prudent, +o puteți sări. +.SS PASUL 4 \-> Sincronizare (Sync) +Rulați comanda \`sync\` pentru a resincroniza matricea cu noul disc. +.PP +.RS 4 +snapraid sync +.PD 0 +.PD +.RE +.PP +Dacă totul este recuperat, această comandă este imediată. +.SH COMENZI +SnapRAID oferă câteva comenzi simple care vă permit să: +.PD 0 +.IP \(bu +Tipăriți starea matricei \-> \`status\` +.IP \(bu +Controlați discurile \-> \`smart\`, \`probe\`, \`up\`, \`down\` +.IP \(bu +Faceți un backup/snapshot \-> \`sync\` +.IP \(bu +Verificați periodic datele \-> \`scrub\` +.IP \(bu +Restaurați ultimul backup/snapshot \-> \`fix\`. +.PD +.PP +Comenzile trebuie scrise cu litere mici. +.SS status +Tipărește un rezumat al stării matricei de discuri. +.PP +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). +.PP +Informațiile prezentate se referă la ultima dată când ați +rulat \`sync\`. Modificările ulterioare nu sunt luate în considerare. +.PP +Dacă au fost detectate blocuri defecte, numerele lor de bloc sunt listate. +Pentru a le repara, puteți utiliza comanda \`fix \-e\`. +.PP +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\'. +.PP +Nimic nu este modificat. +.SS smart +Tipărește un raport SMART al tuturor discurilor din sistem. +.PP +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. +.PP +Această estimare a probabilității este obținută prin corelarea atributelor SMART +ale discurilor cu datele Backblaze disponibile la: +.PP +.RS 4 +https://www.backblaze.com/hard\-drive\-test\-data.html +.PD 0 +.PD +.RE +.PP +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ă. +.PP +Alte șiruri de stare posibile sunt: +.RS 4 +.PD 0 +.HP 4 +.I logfail +În trecut, unele atribute au fost mai mici decât +pragul. +.HP 4 +.I logerr +Jurnalul de erori al dispozitivului conține erori. +.HP 4 +.I selferr +Jurnalul de auto\-test al dispozitivului conține erori. +.PD +.RE +.PP +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. +.PP +Această comandă utilizează instrumentul \`smartctl\` și este echivalentă cu rularea +\`smartctl \-a\` pe toate dispozitivele. +.PP +Dacă dispozitivele dvs. nu sunt detectate automat corect, puteți specifica +o comandă personalizată utilizând opțiunea \`smartctl\` în fișierul de configurare. +.PP +Nimic nu este modificat. +.SS probe +Tipărește starea de ALIMENTARE (POWER) a tuturor discurilor din sistem. +.PP +\`Standby\` înseamnă că discul nu se rotește. \`Active\` înseamnă +că discul se rotește. +.PP +Această comandă utilizează instrumentul \`smartctl\` și este echivalentă cu rularea +\`smartctl \-n standby \-i\` pe toate dispozitivele. +.PP +Dacă dispozitivele dvs. nu sunt detectate automat corect, puteți specifica +o comandă personalizată utilizând opțiunea \`smartctl\` în fișierul de configurare. +.PP +Nimic nu este modificat. +.SS up +Pornirea tuturor discurilor din matrice. +.PP +Puteți porni doar discuri specifice utilizând opțiunea \-d, \-\-filter\-disk. +.PP +Pornirea tuturor discurilor în același timp necesită multă energie. +Asigurați\-vă că sursa dvs. de alimentare o poate susține. +.PP +Nimic nu este modificat. +.SS down +Oprirea (spin down) tuturor discurilor din matrice. +.PP +Această comandă utilizează instrumentul \`smartctl\` și este echivalentă cu rularea +\`smartctl \-s standby,now\` pe toate dispozitivele. +.PP +Puteți opri doar discuri specifice utilizând opțiunea \-d, \-\-filter\-disk. +.PP +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. +.PP +Nimic nu este modificat. +.SS diff +Listează toate fișierele modificate de la ultima \`sync\` care trebuie +să li se recalculeze datele de paritate. +.PP +Această comandă nu verifică datele fișierului, ci doar marca temporală, +dimensiunea și inodul fișierului. +.PP +După listarea tuturor fișierelor modificate, este prezentat un rezumat al modificărilor, +grupate după: +.RS 4 +.PD 0 +.HP 4 +.I equal +Fișiere neschimbate față de înainte. +.HP 4 +.I added +Fișiere adăugate care nu erau prezente înainte. +.HP 4 +.I removed +Fișiere eliminate. +.HP 4 +.I updated +Fișiere cu o dimensiune sau marcă temporală diferită, ceea ce înseamnă că au +fost modificate. +.HP 4 +.I 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. +.HP 4 +.I 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. +.HP 4 +.I 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. +.PD +.RE +.PP +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ă. +.PP +Nimic nu este modificat. +.SS sync +Actualizează informațiile de paritate. Toate fișierele modificate +din matricea de discuri sunt citite și datele de paritate +corespunzătoare sunt actualizate. +.PP +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. +.PP +Dacă se găsesc erori silențioase sau de intrare/ieșire în timpul procesului, +blocurile corespunzătoare sunt marcate ca defecte. +.PP +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. +.PP +Fișierele de \`content\` și \`parity\` sunt modificate dacă este necesar. +Fișierele din matrice NU sunt modificate. +.SS scrub +Verifică (scrubs) matricea, căutând erori silențioase sau de intrare/ieșire în discurile +de date și de paritate. +.PP +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. +.PP +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. +.PP +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\`. +.PP +Pentru a obține detalii despre starea verificării, utilizați comanda \`status\`. +.PP +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\`. +.PP +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. +.PP +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. +.SS fix +Repară toate fișierele și datele de paritate. +.PP +Toate fișierele și datele de paritate sunt comparate cu starea snapshot\-ului +salvată la ultima \`sync\`. +Dacă se găsește o diferență, este readusă la snapshot\-ul stocat. +.PP +ATENȚIE! Comanda \`fix\` nu face diferența între erori și +modificări intenționate. Ea revine necondiționat la starea fișierului +de la ultima \`sync\`. +.PP +Dacă nu este specificată nicio altă opțiune, întreaga matrice este procesată. +Utilizați opțiunile de filtrare pentru a selecta un subset de fișiere sau discuri de operat. +.PP +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\`. +.PP +SnapRAID redenumește toate fișierele care nu pot fi reparate adăugând extensia +\`.unrecoverable\`. +.PP +Î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. +.PP +Fișierele sunt identificate doar prin cale, nu prin inod. +.PP +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. +.SS check +Verifică toate fișierele și datele de paritate. +.PP +Funcționează ca \`fix\`, dar simulează doar o recuperare și nu sunt scrise modificări +în matrice. +.PP +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\`. +.PP +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ă. +.PP +Fișierele sunt identificate doar prin cale, nu prin inod. +.PP +Nimic nu este modificat. +.SS list +Listează toate fișierele conținute în matrice la momentul +ultimei \`sync\`. +.PP +Cu \-v sau \-\-verbose, este afișat și timpul sub\-secundă. +.PP +Nimic nu este modificat. +.SS 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. +.PP +Nimic nu este modificat. +.SS pool +Creează sau actualizează o vizualizare virtuală a tuturor +fișierelor din matricea dvs. de discuri în directorul de \`pooling\`. +.PP +Fișierele nu sunt copiate, ci legate folosind +link\-uri simbolice. +.PP +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. +.PP +Nimic nu este modificat în afara directorului pool. +.SS devices +Tipărește dispozitivele de nivel scăzut utilizate de matrice. +.PP +Această comandă afișează asocierile de dispozitive din matrice +și este destinată în principal ca interfață de script. +.PP +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. +.PP +Î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. +.PP +Nimic nu este modificat. +.SS touch +Setează o marcă temporală arbitrară sub\-secundă pentru toate fișierele +care o au setată la zero. +.PP +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. +.PP +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. +.PP +Marca temporală cu precizie de secundă nu este modificată, +deci toate datele și orele fișierelor dvs. vor fi păstrate. +.SS rehash +Programează o rehash\-uire a întregii matrici. +.PP +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. +.PP +Dacă utilizați deja hash\-ul optim, această comandă +nu face nimic și vă informează că nu este necesară nicio acțiune. +.PP +Rehash\-ul nu este efectuat imediat, ci are loc +progresiv în timpul \`sync\` și \`scrub\`. +.PP +Puteți verifica starea rehash\-ului utilizând \`status\`. +.PP +Î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. +.SH OPțIUNI +SnapRAID oferă următoarele opțiuni: +.TP +.B \-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\`. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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ă. +.TP +.B \-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). +.TP +.B \-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. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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\`. +.TP +.B \-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, \`\[dq]>>result.log\[dq]\`. +Pentru a scoate jurnalul la ieșirea standard sau la eroarea standard, +puteți utiliza \`\[dq]>&1\[dq]\` și \`\[dq]>&2\[dq]\`, respectiv. +Vedeți fișierul snapraid_log.txt sau pagina de manual pentru descrieri ale etichetelor jurnalului. +.TP +.B \-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. +.TP +.B \-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ă. +.TP +.B \-B, \-\-count BLKCOUNT +Procesează doar numărul specificat de blocuri. +Această opțiune este în principal pentru recuperarea manuală avansată. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-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. +.TP +.B \-H, \-\-help +Tipărește un ecran de ajutor scurt. +.TP +.B \-V, \-\-version +Tipărește versiunea programului. +.SH 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. +.PP +Î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\`. +.PP +Trebuie să conțină următoarele opțiuni (sensibile la majuscule/minuscule): +.SS 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. +.PP +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. +.PP +Puteți adăuga fișiere de paritate suplimentare mai târziu, dar nu +le puteți reordona sau elimina. +.PP +Păstrarea discurilor de paritate rezervate pentru paritate asigură că +nu devin fragmentate, îmbunătățind performanța. +.PP +În Windows, 256 MB sunt lăsați neutilizați pe fiecare disc pentru a evita +avertismentul despre discuri pline. +.PP +Această opțiune este obligatorie și poate fi utilizată o singură dată. +.SS (2,3,4,5,6)\-parity FILE [,FILE] ... +Definește fișierele de utilizat pentru a stoca informații de paritate suplimentare. +.PP +Pentru fiecare nivel de paritate specificat, este activat un nivel suplimentar de protecție: +.PD 0 +.IP \(bu +2\-parity activează paritatea dublă RAID6. +.IP \(bu +3\-parity activează paritatea triplă. +.IP \(bu +4\-parity activează paritatea quad (patru). +.IP \(bu +5\-parity activează paritatea penta (cinci). +.IP \(bu +6\-parity activează paritatea hexa (șase). +.PD +.PP +Fiecare nivel de paritate necesită prezența tuturor nivelurilor de paritate +anterioare. +.PP +Aceleași considerații ca pentru opțiunea \'parity\' se aplică. +.PP +Aceste opțiuni sunt opționale și pot fi utilizate o singură dată. +.SS z\-parity FILE [,FILE] ... +Definește un fișier și un format alternativ pentru a stoca paritatea triplă. +.PP +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ă. +.PP +Acest format este similar, dar mai rapid decât cel utilizat de ZFS RAIDZ3. +Ca și ZFS, nu funcționează dincolo de paritatea triplă. +.PP +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. +.PP +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. +.SS 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. +.PP +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\`. +.PP +Această opțiune este obligatorie și poate fi utilizată de mai multe ori pentru a salva +mai multe copii ale aceluiași fișier. +.PP +Trebuie să stocați cel puțin o copie pentru fiecare disc de paritate utilizat +plus unul. Utilizarea de copii suplimentare nu dăunează. +.SS 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. +.PP +Puteți schimba punctul de montare după cum este necesar, atâta timp cât +păstrați NAME fix. +.PP +Ar trebui să utilizați o opțiune pentru fiecare disc de date din matrice. +.PP +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. +.SS 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. +.SS 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ă. +.PP +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\`. +.PP +Vedeți secțiunea PATTERN pentru mai multe detalii despre +specificațiile modelului. +.PP +Această opțiune poate fi utilizată de mai multe ori. +.SS blocksize SIZE_IN_KIBIBYTES +Definește dimensiunea de bază a blocului în kibibytes pentru paritate. +Un kibibyte este 1024 de octeți. +.PP +Dimensiunea implicită a blocului este 256, care ar trebui să funcționeze pentru majoritatea cazurilor. +.PP +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! +.PP +Un motiv pentru a utiliza o dimensiune de bloc diferită este dacă aveți multe fișiere +mici, de ordinul milioanelor. +.PP +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. +.PP +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. +.PP +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ă. +.PP +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. +.PP +Un truc pentru a obține o partiție de paritate mai mare în Linux este să o formatați +cu comanda: +.PP +.RS 4 +mkfs.ext4 \-m 0 \-T largefile4 DEVICE +.PD 0 +.PD +.RE +.PP +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. +.SS hashsize SIZE_IN_BYTES +Definește dimensiunea hash\-ului în octeți pentru blocurile salvate. +.PP +Dimensiunea implicită a hash\-ului este de 16 octeți (128 de biți), care ar trebui să funcționeze +pentru majoritatea cazurilor. +.PP +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! +.PP +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. +.PP +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. +.PP +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: +.PP +RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1,93 GiB +.PD 0 +.PD +.PP +Trecând la o dimensiune de hash de 8, obțineți: +.PP +RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1,02 GiB +.PD 0 +.PD +.PP +Trecând la o dimensiune de bloc de 512, obțineți: +.PP +RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0,96 GiB +.PD 0 +.PD +.PP +Trecând la ambele, o dimensiune de hash de 8 și o dimensiune de bloc de 512, obțineți: +.PP +RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0,51 GiB +.PD 0 +.PD +.SS 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. +.SS 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ă. +.PP +Î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. +.PP +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ă. +.PP +Î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. +.SS 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. +.SS pool DIR +Definește directorul de pooling unde este creată vizualizarea virtuală a matricei +de discuri utilizând comanda \`pool\`. +.PP +Directorul trebuie să existe deja. +.SS share UNC_DIR +Definește calea UNC Windows necesară pentru a accesa discurile de la distanță. +.PP +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. +.PP +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. +.PP +Această opțiune este necesară doar pentru Windows. +.SS 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. +.PP +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\`. +.PP +Î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\`. +.PP +Consultați documentația smartmontools pentru opțiuni posibile: +.PP +.RS 4 +https://www.smartmontools.org/wiki/Supported_RAID\-Controllers +.PD 0 +.PP +.PD +https://www.smartmontools.org/wiki/Supported_USB\-Devices +.PD 0 +.PD +.RE +.PP +De exemplu: +.PP +.RS 4 +smartctl parity \-d sat %s +.PD 0 +.PD +.RE +.SS 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. +.PP +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. +.PP +De exemplu, pentru a ignora atributul \`Current Pending Sector Count\` pe +toate discurile: +.PP +.RS 4 +smartignore * 197 +.PD 0 +.PD +.RE +.PP +Pentru a\-l ignora doar pe primul disc de paritate: +.PP +.RS 4 +smartignore parity 197 +.PD 0 +.PD +.RE +.SS Exemple +Un exemplu de configurare tipică pentru Unix este: +.PP +.RS 4 +parity /mnt/diskp/snapraid.parity +.PD 0 +.PP +.PD +content /mnt/diskp/snapraid.content +.PD 0 +.PP +.PD +content /var/snapraid/snapraid.content +.PD 0 +.PP +.PD +data d1 /mnt/disk1/ +.PD 0 +.PP +.PD +data d2 /mnt/disk2/ +.PD 0 +.PP +.PD +data d3 /mnt/disk3/ +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +exclude /tmp/ +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/sg0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/sg0 +.PD 0 +.PD +.RE +.PP +Un exemplu de configurare tipică pentru Windows este: +.PP +.RS 4 +parity E:\\snapraid.parity +.PD 0 +.PP +.PD +content E:\\snapraid.content +.PD 0 +.PP +.PD +content C:\\snapraid\\snapraid.content +.PD 0 +.PP +.PD +data d1 G:\\array\\ +.PD 0 +.PP +.PD +data d2 H:\\array\\ +.PD 0 +.PP +.PD +data d3 I:\\array\\ +.PD 0 +.PP +.PD +exclude Thumbs.db +.PD 0 +.PP +.PD +exclude \\$RECYCLE.BIN +.PD 0 +.PP +.PD +exclude \\System Volume Information +.PD 0 +.PP +.PD +smartctl d1 \-d sat %s +.PD 0 +.PP +.PD +smartctl d2 \-d usbjmicron %s +.PD 0 +.PP +.PD +smartctl parity \-d areca,1/1 /dev/arcmsr0 +.PD 0 +.PP +.PD +smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0 +.PD 0 +.PD +.RE +.SH MODEL (PATTERN) +Modelele sunt utilizate pentru a selecta un subset de fișiere de exclus sau inclus în +proces. +.PP +Există patru tipuri diferite de modele: +.TP +.B 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. +.TP +.B 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. +.TP +.B /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. +.TP +.B /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. +.PP +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. +.PP +Î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. +.PP +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ă. +.PP +Î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: +.PP +.RS 4 +# Exclude orice fișier numit \`*.unrecoverable\` +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Exclude directorul rădăcină \`/lost+found\` +.PD 0 +.PP +.PD +exclude /lost+found/ +.PD 0 +.PP +.PD +# Exclude orice subdirector numit \`tmp\` +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PD +.RE +.PP +Abordarea opusă este să definiți doar fișierele pe care doriți să le procesați, utilizând +doar reguli \`include\`. De exemplu: +.PP +.RS 4 +# Include doar unele directoare +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +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: +.PP +.RS 4 +# Exclude orice fișier numit \`*.unrecoverable\` +.PD 0 +.PP +.PD +exclude *.unrecoverable +.PD 0 +.PP +.PD +# Exclude orice subdirector numit \`tmp\` +.PD 0 +.PP +.PD +exclude tmp/ +.PD 0 +.PP +.PD +# Include doar unele directoare +.PD 0 +.PP +.PD +include /movies/ +.PD 0 +.PP +.PD +include /musics/ +.PD 0 +.PP +.PD +include /pictures/ +.PD 0 +.PD +.RE +.PP +Pe linia de comandă, utilizând opțiunea \-f, puteți utiliza doar modele \`include\`. +De exemplu: +.PP +.RS 4 +# Verifică doar fișierele .mp3. +.PD 0 +.PP +.PD +# În Unix, utilizați ghilimele pentru a evita expansiunea globbing de către shell. +.PD 0 +.PP +.PD +snapraid \-f \[dq]*.mp3\[dq] check +.PD 0 +.PD +.RE +.PP +Î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ă. +.SH CONțINUT (CONTENT) +SnapRAID stochează lista și sumele de control (checksums) ale fișierelor dvs. în fișierul de conținut. +.PP +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. +.PP +Acest fișier este citit și scris de comenzile \`sync\` și \`scrub\` și +citit de comenzile \`fix\`, \`check\` și \`status\`. +.SH PARITATE (PARITY) +SnapRAID stochează informațiile de paritate ale matricei dvs. în fișierele de paritate. +.PP +Acestea sunt fișiere binare care conțin paritatea calculată a tuturor +blocurilor definite în fișierul de \`content\`. +.PP +Aceste fișiere sunt citite și scrise de comenzile \`sync\` și \`fix\` și +doar citite de comenzile \`scrub\` și \`check\`. +.SH 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. +.PP +În Windows, toate numele citite din sistemul de fișiere sunt convertite și +procesate în format UTF\-8. +.PP +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. +.SH DREPT DE AUTOR (COPYRIGHT) +Acest fișier este Copyright (C) 2025 Andrea Mazzoleni +.SH VEZI șI (SEE ALSO) +snapraid_log(1), rsync(1) diff --git a/snapraid-ro.d b/snapraid-ro.d new file mode 100644 index 00000000..110a59ab --- /dev/null +++ b/snapraid-ro.d @@ -0,0 +1,1445 @@ +Name{number} + snapraid - SnapRAID Backup pentru Matrici de Discuri + +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] + +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: + + * Puteți utiliza discuri deja pline cu fișiere fără + nevoia de a le reformat, accesându-le ca de obicei. + * Toate datele dvs. sunt hash-uite pentru a asigura integritatea datelor și a preveni + corupția silențioasă. + * Când numărul de discuri defecte depășește numărul de parități, + pierderea de date este limitată la discurile afectate; datele de pe + celelalte discuri rămân accesibile. + * Dacă ștergeți accidental fișiere de pe un disc, recuperarea este + posibilă. + * Discurile pot avea dimensiuni diferite. + * Puteți adăuga discuri în orice moment. + * SnapRAID nu vă blochează datele; puteți înceta să-l utilizați + oricând fără a reforma sau muta date. + * Pentru a accesa un fișier, este necesar să se rotească doar un singur disc, economisind + energie și reducând zgomotul. + + Pentru mai multe informații, vă rugăm să vizitați site-ul oficial SnapRAID: + + :https://www.snapraid.it/ + +Limitări + SnapRAID este un hibrid între un program RAID și unul de backup, care urmărește să combine + cele mai bune beneficii ale ambelor. Cu toate acestea, are unele limitări pe care ar trebui + 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: + + * Cu SnapRAID, aveți în continuare sisteme de fișiere separate pentru fiecare disc. + Cu RAID, obțineți un singur sistem de fișiere mare. + * SnapRAID nu face striping de date. + Cu RAID, obțineți un spor de viteză prin striping. + * SnapRAID nu suportă recuperarea în timp real. + Cu RAID, nu trebuie să vă opriți din lucru atunci când un disc se defectează. + * SnapRAID poate recupera date doar dintr-un număr limitat de defecte de disc. + Cu un backup, puteți recupera dintr-o defecțiune completă + a întregii matrici de discuri. + * Sunt salvate doar numele fișierelor, mărcile temporale, symlink-urile și hardlink-urile. + Permisiunile, proprietarul și atributele extinse nu sunt salvate. + +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`. + + 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. + + 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 + + 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 + + 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. + + 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. + + 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! + + 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. + + 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ă. + +Comenzi + SnapRAID oferă câteva comenzi simple care vă permit să: + + * Tipăriți starea matricei -> `status` + * Controlați discurile -> `smart`, `probe`, `up`, `down` + * Faceți un backup/snapshot -> `sync` + * Verificați periodic datele -> `scrub` + * Restaurați ultimul backup/snapshot -> `fix`. + + Comenzile trebuie scrise cu litere mici. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + + 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. + +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. + +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): + + 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ă. + + (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: + + * 2-parity activează paritatea dublă RAID6. + * 3-parity activează paritatea triplă. + * 4-parity activează paritatea quad (patru). + * 5-parity activează paritatea penta (cinci). + * 6-parity activează paritatea hexa (șase). + + 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ă. + + 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. + + 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ă. + + 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. + + 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. + + 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. + + 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. + + 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 + + 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. + + 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. + + 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. + + 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. + + 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. + + 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 + + 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 + + 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 + +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ă. + +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`. + +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`. + +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. + +Drept de Autor (Copyright) + Acest fișier este Copyright (C) 2025 Andrea Mazzoleni + +Vezi și (See Also) + snapraid_log(1), rsync(1) diff --git a/snapraid-ro.txt b/snapraid-ro.txt new file mode 100644 index 00000000..5aab3086 --- /dev/null +++ b/snapraid-ro.txt @@ -0,0 +1,1559 @@ + ========================================= + SnapRAID Backup pentru Matrici de Discuri + ========================================= + + +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: + +* Puteți utiliza discuri deja pline cu fișiere fără + nevoia de a le reformat, accesându-le ca de obicei. +* Toate datele dvs. sunt hash-uite pentru a asigura integritatea datelor și a preveni + corupția silențioasă. +* Când numărul de discuri defecte depășește numărul de parități, + pierderea de date este limitată la discurile afectate; datele de pe + celelalte discuri rămân accesibile. +* Dacă ștergeți accidental fișiere de pe un disc, recuperarea este + posibilă. +* Discurile pot avea dimensiuni diferite. +* Puteți adăuga discuri în orice moment. +* SnapRAID nu vă blochează datele; puteți înceta să-l utilizați + oricând fără a reforma sau muta date. +* Pentru a accesa un fișier, este necesar să se rotească doar un singur disc, economisind + energie și reducând zgomotul. + +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: + +* Cu SnapRAID, aveți în continuare sisteme de fișiere separate pentru fiecare disc. + Cu RAID, obțineți un singur sistem de fișiere mare. +* SnapRAID nu face striping de date. + Cu RAID, obțineți un spor de viteză prin striping. +* SnapRAID nu suportă recuperarea în timp real. + Cu RAID, nu trebuie să vă opriți din lucru atunci când un disc se defectează. +* SnapRAID poate recupera date doar dintr-un număr limitat de defecte de disc. + Cu un backup, puteți recupera dintr-o defecțiune completă + a întregii matrici de discuri. +* Sunt salvate doar numele fișierelor, mărcile temporale, symlink-urile și hardlink-urile. + Permisiunile, proprietarul și atributele extinse nu sunt salvate. + + +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ă: + +* Tipăriți starea matricei -> `status` +* Controlați discurile -> `smart`, `probe`, `up`, `down` +* Faceți un backup/snapshot -> `sync` +* Verificați periodic datele -> `scrub` +* Restaurați ultimul backup/snapshot -> `fix`. + +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: + +* 2-parity activează paritatea dublă RAID6. +* 3-parity activează paritatea triplă. +* 4-parity activează paritatea quad (patru). +* 5-parity activează paritatea penta (cinci). +* 6-parity activează paritatea hexa (șase). + +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)