Japanese manual for SnapRAID.

1 Synopsis

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

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

2 Description

SnapRAIDは、ディスクアレイ用のバックアッププログラムで、最大6台のディスク障害が発生した場合の データ復旧のためにパリティ情報を保存します。

主に大容量で、更新頻度の低いファイルを扱うホームメディアセンターを対象としており、 SnapRAIDにはいくつかの機能があります。

• ファイルが既に入っているディスクを、再フォーマットせずにそのまま利用でき、通常通り アクセスできます。
• すべてのデータがハッシュ化され、データの整合性を確保し、サイレントな破損を防ぎます。
• 障害が発生したディスクの数がパリティ数を超えた場合、データの損失は影響を受けたディスクに 限定され、他のディスクのデータは引き続きアクセス可能です。
• 誤ってディスク上のファイルを削除した場合でも、復旧が可能です。
• ディスクは異なるサイズであっても構いません。
• いつでもディスクを追加できます。
• SnapRAIDはデータをロックしません。いつでも再フォーマットやデータ移動なしに利用を 停止できます。
• ファイルにアクセスするためにスピンさせる必要があるのは1台のディスクだけであり、 省電力と騒音低減に役立ちます。

詳細については、SnapRAIDの公式サイトをご覧ください。

https://www.snapraid.it/

3 Limitations

SnapRAIDはRAIDとバックアッププログラムのハイブリッドであり、両方の利点を組み合わせることを 目指しています。ただし、使用する前に考慮すべきいくつかの制限があります。

主な制限は、ディスクが故障し、最近 `sync` を実行していない場合、完全に復旧できない 可能性があることです。 より具体的には、最後の `sync` 操作以降に変更または削除されたファイルのサイズまでのデータが 復旧できない可能性があります。 これは、変更または削除されたファイルが故障したディスク上にない場合でも発生します。 このため、SnapRAIDは**めったに変更されない**データに適しています。

一方で、新しく追加されたファイルは、既に存在するファイルの復旧を妨げません。 新しく追加されたファイルが故障したディスク上にある場合にのみ、それらのファイルが失われます。

その他のSnapRAIDの制限は次のとおりです。

• SnapRAIDでは、各ディスクに対して**個別のファイルシステム**が保持されます。 RAIDでは、単一の大きなファイルシステムが得られます。
• SnapRAIDは**データをストライピングしません**。 RAIDでは、ストライピングにより速度が向上します。
• SnapRAIDは**リアルタイムの復旧をサポートしません**。 RAIDでは、ディスクが故障しても作業を停止する必要はありません。
• SnapRAIDは**限られた数のディスク障害**からのみデータを復旧できます。 バックアップでは、ディスクアレイ全体の完全な障害から復旧できます。
• **ファイル名、タイムスタンプ、シンボリックリンク、およびハードリンク**のみが保存されます。 アクセス許可、所有権、および拡張属性は保存されません。

4 Getting Started

SnapRAIDを使用するには、まずディスクアレイ内の1つのディスクを `parity` 情報専用に 選択する必要があります。パリティ用に1つのディスクを使用すると、RAID5と同様に、単一のディスク障害から 復旧できます。

RAID6と同様に、より多くのディスク障害から復旧したい場合は、パリティ用に追加のディスクを 確保する必要があります。パリティディスクを追加するたびに、復旧できるディスク障害が1つ増えます。

パリティ情報はアレイ内の**最大のデータディスク**のサイズにまで増える可能性があるため、 パリティディスクとしては、アレイ内の**最大のディスク**を選択する必要があります。

これらのディスクは、`parity` ファイルの保存専用になります。 **データを保存しないでください**。

次に、SnapRAIDで保護したい `data` ディスクを定義する必要があります。 これらのディスクに含まれるデータがめったに変更されない場合に、保護が最も効果的です。 このため、WindowsのC:\ディスクやUnixの/home、/var、/tmpディレクトリを含めない方が 良いでしょう。

ファイルの一覧は `content` ファイルに保存され、通常はデータ、パリティ、または ブートディスクに保存されます。 このファイルには、バックアップの詳細と、その整合性を検証するためのすべての チェックサムが含まれています。 `content` ファイルは**複数のコピー**で保存され、複数のディスク障害が発生した場合でも、 少なくとも1つのコピーが利用可能であることを保証するために、**各コピーは異なるディスクに** 配置する必要があります。

たとえば、1レベルのパリティ保護のみに関心があり、ディスクが次の場所にあるとします。

/mnt/diskp <- パリティ用に選択されたディスク
/mnt/disk1 <- 保護する最初のディスク
/mnt/disk2 <- 保護する2番目のディスク
/mnt/disk3 <- 保護する3番目のディスク

構成ファイル `/etc/snapraid.conf` を次のオプションで作成する必要があります。

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/

Windowsを使用している場合は、スラッシュではなくドライブ文字とバックスラッシュを 使用したWindowsのパス形式を使用する必要があります。

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\

ディスクが多くてドライブ文字が不足する場合は、サブフォルダにディスクを 直接マウントできます。参照：

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

この時点で、パリティ情報を構築するために `sync` コマンドを実行する準備が整いました。

snapraid sync

このプロセスは、既にディスクに存在するデータのサイズに応じて、初回は数時間かかる 場合があります。ディスクが空の場合は、プロセスは即座に完了します。

Ctrl+Cを押すことでいつでも停止でき、次回の実行時には中断された場所から再開されます。

このコマンドが完了すると、データは**SAFE**になります。

これで、アレイを自由に使い始め、定期的に `sync` コマンドを実行してパリティ情報を 更新できます。

4.1 Scrubbing

データとパリティのエラーを定期的にチェックするには、`scrub` コマンドを 実行できます。

snapraid scrub

このコマンドは、配列内のデータを `sync` コマンド中に計算されたハッシュと比較して、 整合性を検証します。

このコマンドを1回実行すると、前回の10日間で既にスクラブされたデータを除いて、 アレイの約8%がチェックされます。 -p, --plan オプションを使用して異なる量を指定でき、 -o, --older-than オプションを使用して異なる経過日数で 指定できます。 たとえば、20日以上経過したブロックの5%をチェックするには、次のように使用します。

snapraid -p 5 -o 20 scrub

プロセス中にサイレントエラーまたは入出力エラーが見つかった場合、 対応するブロックは `content` ファイル内で不良としてマークされ、 `status` コマンドで一覧表示されます。

snapraid status

それらを修正するには、-e, --filter-error オプションで不良ブロックをフィルタリングして、 `fix` コマンドを使用できます。

snapraid -e fix

次回の `scrub` で、エラーが本当に修正されていれば、`status` レポートから エラーは消えます。より高速にするために、`-p bad` を使用して不良としてマークされた ブロックのみをスクラブできます。

snapraid -p bad scrub

未同期のアレイで `scrub` を実行すると、削除または変更されたファイルによって 引き起こされたエラーが報告される場合があります。これらのエラーは `scrub` の 出力で報告されますが、関連するブロックは不良としてマークされません。

4.2 Pooling

注: ここで説明するプーリング機能は、**mergefs** ツールに取って代わられました。 mergefs は、SnapRAIDコミュニティのLinuxユーザーに推奨されるオプションです。 Mergefs は、複数のドライブを単一の統合されたマウントポイントにプールするための、 より柔軟で効率的な方法を提供し、シンボリックリンクに頼ることなくアレイ全体の ファイルにシームレスにアクセスできます。これは、パリティ保護のためにSnapRAIDと うまく統合されており、OpenMediaVault (OMV) やカスタムNAS構成などのセットアップで 一般的に使用されています。

アレイ内のすべてのファイルを同じディレクトリツリーに表示させるには、 `pooling` 機能を有効にできます。これは、シンボリックリンクを使用して、 アレイ内のすべてのファイルの読み取り専用の仮想ビューを作成します。

構成ファイルで `pooling` ディレクトリを次のように構成できます。

pool /pool

または、Windowsの場合は、次のようにします。

pool C:\pool

そして、`pool` コマンドを実行して仮想ビューを作成または更新します。

snapraid pool

Unixプラットフォームを使用しており、このディレクトリをWindowsまたはUnixマシンに ネットワーク経由で共有したい場合は、`/etc/samba/smb.conf` に次のオプションを 追加する必要があります。

# smb.conf の global セクションで
unix extensions = no

# smb.conf の share セクションで
[pool]
comment = Pool
path = /pool
read only = yes
guest ok = yes
wide links = yes
follow symlinks = yes

Windowsでは、ネットワーク経由でシンボリックリンクを共有するには、クライアントが それらをリモートで解決する必要があります。これを有効にするには、プールディレクトリを 共有することに加えて、構成ファイルで定義された**ディスク名**を共有ポイントとして 使用して、**すべてのディスクを個別に**共有する必要があります。また、リモートクライアントが これらの共有ディスクにアクセスするために使用する必要があるWindows UNCパスを、 構成ファイルの `share` オプションで指定する必要があります。

たとえば、`darkstar` という名前のサーバーで操作している場合、次のオプションを 使用できます。

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

そして、次のディレクトリをネットワーク経由で共有します。

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

これにより、リモートクライアントは `\\darkstar\pool` ですべてのファイルに アクセスできるようになります。

また、リモートクライアントがリモートシンボリックリンクへのアクセスを有効にするために、 次のコマンドで構成する必要がある場合もあります。

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

4.3 Undeleting

SnapRAIDはRAIDシステムよりもバックアッププログラムのように機能し、 -f, --filter オプションを使用してファイルを以前の状態に復元または削除解除するために 使用できます。

snapraid fix -f FILE

またはディレクトリの場合は：

snapraid fix -f DIR/

また、-m, --filter-missing オプションを使用して、ディレクトリ内の**誤って削除されたファイルのみ**を 復旧するために使用することもできます。これにより、不足しているファイルのみが復元され、 他のファイルはすべてそのまま残されます。

snapraid fix -m -f DIR/

または、すべてのドライブ上のすべての削除されたファイルを復旧するには：

snapraid fix -m

4.4 Recovering

最悪の事態が発生し、1台以上のディスクを失いました！

**パニックにならないでください！** 復旧できます！

最初に行うべきことは、ディスクアレイへの**さらなる変更を避ける**ことです。 リモート接続、およびスケジュールされたSnapRAIDの夜間 `sync` や `scrub` を含む、 すべてのスケジュールされたプロセスを無効にしてください。

次に、次の手順に進みます。

4.4.1 STEP 1 -> Reconfigure

復旧のためにいくらかのスペースが必要です。理想的には追加の 予備ディスクですが、外部USBディスクやリモートディスクでも十分です。

SnapRAIDの構成ファイルを変更して、故障したディスクの `data` または `parity` オプションを、ファイルを復旧するための十分な空き容量のある場所に 向けます。

たとえば、ディスク `d1` が故障した場合、次のように変更します。

data d1 /mnt/disk1/

から：

data d1 /mnt/new_spare_disk/

復旧するディスクがパリティディスクの場合は、適切な `parity` オプションを 更新します。 複数のディスクが故障している場合は、すべての構成オプションを更新します。

4.4.2 STEP 2 -> Fix

ログを外部ファイルに保存して、`fix` コマンドを実行します。

snapraid -d NAME -l fix.log fix

ここで NAME はディスクの名前であり、前の例では `d1` のようなものです。 復旧するディスクがパリティディスクの場合は、`parity`、`2-parity` などの 名前を使用します。 複数のディスクが故障している場合は、複数の `-d` オプションを使用して すべてを指定します。

このコマンドは時間がかかります。

`fix.log` ファイルを保存するために数ギガバイトの空き容量があることを確認してください。 十分な空き容量のあるディスクから実行してください。

これで、復旧可能なすべてのものが復旧されました。一部のファイルが部分的または完全に 復旧できない場合、それらは `.unrecoverable` 拡張子を追加して名前が変更されます。

`fix.log` ファイルで、`unrecoverable:` で始まるすべての行をチェックすることで、 すべての復旧不能なブロックの詳細なリストを見つけることができます。

復旧に満足できない場合は、何度でも再試行できます。

たとえば、最後の `sync` の後にアレイからファイルを削除した場合、 これにより一部のファイルが復旧されない可能性があります。 この場合、-i, --import オプションを使用して、これらのファイルが現在どこにあるかを指定することで、 復旧プロセスにそれらを再度含めるように `fix` を再試行できます。

復旧に満足している場合は、さらに進むことができますが、**sync** の実行後には `fix` コマンドを**再試行できない**ことに注意してください！

4.4.3 STEP 3 -> Check

慎重なチェックとして、`check` コマンドを実行して、復旧されたディスク上の すべてが正しいことを確認できます。

snapraid -d NAME -a check

ここで NAME はディスクの名前であり、前の例では `d1` のようなものです。

`-d` および `-a` オプションは、SnapRAIDに**指定されたディスクのみ**をチェックし、 **すべてのパリティデータを無視**するように指示します。

このコマンドは時間がかかりますが、過度に慎重でない場合はスキップできます。

4.4.4 STEP 4 -> Sync

`sync` コマンドを実行して、アレイを新しいディスクと再同期します。

snapraid sync

すべてが復旧されていれば、このコマンドは即座に完了します。

5 Commands

SnapRAIDは、次のことを可能にするいくつかの簡単なコマンドを提供します。

• アレイの状態の概要を出力 -> `status`
• ディスクの制御 -> `smart`、`probe`、`up`、`down`
• バックアップ/スナップショットの作成 -> `sync`
• データの定期的なチェック -> `scrub`
• 最後のバックアップ/スナップショットの復元 -> `fix`。

コマンドは**小文字**で記述する必要があります。

5.1 status

ディスクアレイの状態の概要を出力します。

これには、パリティの断片化、チェックなしでのブロックの古さ、および スクラビング中に遭遇したすべての記録されたサイレントエラーに関する情報が 含まれます。

提示される情報は、最後に `sync` を実行した時点のものです。 それ以降の変更は考慮されません。

不良ブロックが検出された場合、それらのブロック番号が一覧表示されます。 それらを修正するには、`fix -e` コマンドを使用できます。

また、各ブロックが最後にスクラブまたは同期された時期を示すグラフも表示されます。 スクラブされたブロックは `*` で、同期されたがまだスクラブされていないブロックは `o` で 示されます。

何も変更されません。

5.2 smart

システム内のすべてのディスクのSMARTレポートを出力します。

これには、翌年の故障確率の推定値が含まれており、疑わしい属性を示すディスクの メンテナンス交換を計画できます。

この確率推定は、ディスクのSMART属性を次の場所で利用可能なBackblazeのデータと 相関させることで得られます。

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

SMARTがディスクが故障していると報告した場合、そのディスクに対して `FAIL` または `PREFAIL` が 出力され、SnapRAIDはエラーを返します。 この場合、**ディスクの即時交換**が強く推奨されます。

その他の可能なステータス文字列は次のとおりです。

この分析は、より多くまたはより少ないパリティが必要かどうかを決定するのに役立ちます。

このコマンドは `smartctl` ツールを使用し、すべてのデバイスで `smartctl -a` を実行するのと 同等です。

デバイスが正しく自動検出されない場合は、構成ファイルで `smartctl` オプションを 使用してカスタムコマンドを指定できます。

何も変更されません。

5.3 probe

システム内のすべてのディスクのPOWER状態を出力します。

`Standby` はディスクがスピンしていないことを意味します。`Active` は ディスクがスピンしていることを意味します。

このコマンドは `smartctl` ツールを使用し、すべてのデバイスで `smartctl -n standby -i` を実行するのと 同等です。

デバイスが正しく自動検出されない場合は、構成ファイルで `smartctl` オプションを 使用してカスタムコマンドを指定できます。

何も変更されません。

5.4 up

アレイのすべてのディスクをスピンアップします。

すべてのディスクを同時にスピンアップするには、多くの電力が必要です。 電源がそれに耐えられることを確認してください。

何も変更されません。

5.5 down

アレイのすべてのディスクをスピンダウンします。

このコマンドは `smartctl` ツールを使用し、すべてのデバイスで `smartctl -s standby,now` を実行するのと 同等です。

エラー時に自動的にスピンダウンするには、他の任意のコマンドで -s, --spin-down-on-error オプションを使用できます。これは、エラーが発生したときに手動で `down` を実行するのと同等です。

何も変更されません。

5.6 diff

最後の `sync` 以降に変更され、パリティデータを再計算する必要があるすべてのファイルを 一覧表示します。

このコマンドはファイルデータはチェックせず、ファイルのタイムスタンプ、サイズ、 およびinodeのみをチェックします。

変更されたすべてのファイルを一覧表示した後、変更の概要が 次のようにグループ化されて提示されます。

`sync` が必要な場合、プロセスはデフォルトの0ではなく、リターンコード2を返します。 リターンコード1は、一般的なエラー状態に使用されます。

何も変更されません。

5.7 sync

パリティ情報を更新します。ディスクアレイ内のすべての変更されたファイルが読み取られ、 対応するパリティデータが更新されます。

Ctrl+Cを押すことでいつでもこのプロセスを停止でき、 既に完了した作業を失うことはありません。 次回の実行時には、`sync` プロセスは中断された場所から 再開されます。

プロセス中にサイレントエラーまたは入出力エラーが見つかった場合、 対応するブロックは不良としてマークされます。

ファイルはパスおよび/またはinodeによって識別され、サイズとタイムスタンプによって チェックされます。 ファイルサイズまたはタイムスタンプが異なる場合、パリティデータはファイル全体で 再計算されます。 ファイルが同じディスク上で移動または名前が変更され、同じinodeが保持されている場合、 パリティは再計算されません。 ファイルが別のディスクに移動された場合、パリティは再計算されますが、 以前に計算されたハッシュ情報は保持されます。

`content` ファイルと `parity` ファイルは必要に応じて変更されます。 アレイ内のファイルは**変更されません**。

5.8 scrub

アレイをスクラブし、データおよびパリティディスクのサイレントエラーまたは入出力エラーを チェックします。

1回の呼び出しごとに、最後の10日間で既にスクラブされたデータを除いて、 アレイの約8%がチェックされます。 これは、週に1回スクラビングを実行すると、すべてのデータが少なくとも3か月に1回は チェックされることを意味します。

このオプションは以下を受け入れます。 bad - 不良としてマークされたブロックをスクラブします。 new - まだスクラブされていない、同期されたばかりのブロックをスクラブします。 full - すべてをスクラブします。 0-100 - 指定されたパーセンテージのブロックをスクラブします。

パーセンテージの量を指定する場合、-o, --older-than オプションを使用して、 ブロックがどれくらいの古さである必要があるかを定義することもできます。 最も古いブロックが最初にスクラブされ、最適なチェックが保証されます。 まだスクラブされていない、同期されたばかりのブロックのみをスクラブしたい場合は、 `-p new` オプションを使用します。

スクラブステータスの詳細を取得するには、`status` コマンドを使用します。

見つかったサイレントエラーまたは入出力エラーごとに、対応するブロックは `content` ファイル内で不良としてマークされます。 これらの不良ブロックは `status` で一覧表示され、`fix -e` で修正できます。 修正後、次回のスクラブで再チェックされ、修正されていると判明した場合、 不良マークは削除されます。 不良ブロックのみをスクラブするには、`scrub -p bad` コマンドを使用できます。

未同期のデータによって引き起こされた報告されたエラーを避けるために、 `scrub` は**同期された**アレイでのみ実行することをお勧めします。これらのエラーは サイレントエラーではないと認識され、ブロックは不良としてマークされませんが、 そのようなエラーはコマンドの出力で報告されます。

`content` ファイルは、各ブロックの最後のチェック時刻を更新し、不良ブロックを マークするために変更されます。 `parity` ファイルは**変更されません**。 アレイ内のファイルは**変更されません**。

5.9 fix

すべてのファイルとパリティデータを修正します。

すべてのファイルとパリティデータは、最後の `sync` で保存されたスナップショット状態と 比較されます。 違いが見つかった場合、保存されたスナップショットに**元に戻されます**。

**警告！** `fix` コマンドは、エラーと意図的な変更を区別しません。 ファイルの_状態を_最後の `sync` に**無条件に元に戻します**。

他のオプションが指定されていない場合、アレイ全体が処理されます。 フィルタオプションを使用して、操作するファイルまたはディスクのサブセットを 選択します。

`sync` および `scrub` 中に不良としてマークされたブロックのみを修正するには、 -e, --filter-error オプションを使用します。 他のフィルタオプションとは異なり、これは最新の `sync` 以降に**変更されていない** ファイルにのみ修正を適用します。

SnapRAIDは、修正できないすべてのファイルの名前を `.unrecoverable` 拡張子を 追加して変更します。

修正する前に、アレイ全体がスキャンされ、最後の `sync` 操作以降に移動されたファイルが 見つけられます。 これらのファイルは、名前を無視してタイムスタンプによって識別され、 必要に応じて復旧プロセスで使用されます。 それらのいくつかをアレイ外に移動した場合は、-i, --import オプションを使用して スキャンする追加のディレクトリを指定できます。

ファイルは**パスによってのみ**識別され、inodeによっては識別されません。

`content` ファイルは**変更されません**。 `parity` ファイルは必要に応じて変更されます。 アレイ内のファイルは必要に応じて変更されます。

5.10 check

すべてのファイルとパリティデータを検証します。

`fix` のように機能しますが、復旧を**シミュレートするだけ**で、アレイに**変更は書き込まれません**。

このコマンドは、主に復旧プロセス後やその他の特殊な条件下での手動検証を 目的としています。 定期的でスケジュールされたチェックには、`scrub` を使用します。

パリティデータは無視されるため、チェックプロセスが大幅に高速化されます。

ファイルは**パスによってのみ**識別され、inodeによっては識別されません。

何も変更されません。

5.11 list

最後の `sync` の時点のアレイに含まれるすべてのファイルを 一覧表示します。

何も変更されません。

5.12 dup

すべての重複ファイルを一覧表示します。ハッシュが一致する場合、2つのファイルは等しいと見なされます。 ファイルデータは読み取られず、事前に計算されたハッシュのみが使用されます。

何も変更されません。

5.13 pool

`pooling` ディレクトリに、ディスクアレイ内のすべてのファイルの仮想ビューを 作成または更新します。

ファイルはコピーされず、シンボリックリンクを使用してリンクされます。

更新時、既存のすべてのシンボリックリンクと空のサブディレクトリは削除され、 アレイの新しいビューに置き換えられます。その他の通常のファイルはそのまま残されます。

プールディレクトリ外は何も変更されません。

5.14 devices

アレイで使用される低レベルデバイスを出力します。

このコマンドは、アレイ内のデバイスの関連付けを表示し、主にスクリプトインターフェイスを 目的としています。

最初の2つの列は、低レベルデバイスIDとパスです。 次の2つの列は、高レベルデバイスIDとパスです。 最後の列は、アレイ内のディスク名です。

ほとんどの場合、アレイ内のディスクごとに1つの低レベルデバイスがありますが、 より複雑な構成では、単一のアレイ内のディスクで複数の低レベルデバイスが 使用される場合があります。

何も変更されません。

5.15 touch

サブ秒のタイムスタンプがゼロに設定されているすべてのファイルに、任意のサブ秒のタイムスタンプを 設定します。

これにより、タイムスタンプがほぼ一意になり、重複の可能性が減るため、 SnapRAIDが移動およびコピーされたファイルを認識する能力が向上します。

より具体的には、サブ秒のタイムスタンプがゼロでない場合、移動またはコピーされたファイルは、 名前、サイズ、およびタイムスタンプが一致する場合にそうであると識別されます。 サブ秒のタイムスタンプがゼロの場合、フルパス、サイズ、およびタイムスタンプのすべてが 一致する場合にのみコピーと見なされます。

秒精度のタイムスタンプは変更されないため、ファイルのすべての日付と時刻は 保持されます。

5.16 rehash

アレイ全体のリハッシュをスケジュールします。

このコマンドは、使用されるハッシュの種類を変更します。これは通常、32ビットシステムから 64ビットシステムにアップグレードするときに、MurmurHash3からより高速なSpookyHashに 切り替えるために行われます。

既に最適なハッシュを使用している場合、このコマンドは何もせず、アクションが不要であることを 通知します。

リハッシュはすぐには実行されず、`sync` および `scrub` の間に徐々に実行されます。

`status` を使用してリハッシュの状態を確認できます。

リハッシュ中もSnapRAIDは完全な機能を維持しますが、唯一の例外として、 `dup` は異なるハッシュを使用している重複ファイルを検出できません。

6 Options

SnapRAIDには、次のオプションがあります。

7 Configuration

SnapRAIDは、ディスクアレイの場所とパリティ情報の保存場所を知るために、構成ファイルを 必要とします。

Unixでは、存在すれば `/usr/local/etc/snapraid.conf` を使用し、それ以外の場合は `/etc/snapraid.conf` を使用します。 Windowsでは、`snapraid.exe` と同じディレクトリにある `snapraid.conf` ファイルを 使用します。

次のオプションを含める必要があります（大文字と小文字を区別します）。

7.1 parity FILE [,FILE] ...

パリティ情報を保存するために使用するファイルを定義します。 パリティは、RAID5と同様に、単一のディスク障害からの保護を有効にします。

複数のファイルを指定でき、それらは異なるディスク上に存在する必要があります。 ファイルがそれ以上成長できなくなると、次のファイルが使用されます。 利用可能な総容量は、アレイ内の**最大のデータディスク**と少なくとも同じ大きさでなければなりません。

後で追加のパリティファイルを追加することはできますが、 それらを並べ替えたり削除したりすることはできません。

パリティディスクをパリティ用に予約しておくことで、それらが断片化されるのを防ぎ、 パフォーマンスを向上させます。

Windowsでは、フルディスクに関する警告を避けるために、各ディスクに256 MBが未使用で 残されます。

このオプションは必須であり、1回のみ使用できます。

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

追加のパリティ情報を保存するために使用するファイルを定義します。

指定されたパリティレベルごとに、1つの追加の保護レベルが有効になります。

• 2-parity は RAID6 デュアルパリティを有効にします。
• 3-parity は トリプルパリティを有効にします。
• 4-parity は クアッド（4つ）パリティを有効にします。
• 5-parity は ペンタ（5つ）パリティを有効にします。
• 6-parity は ヘキサ（6つ）パリティを有効にします。

各パリティレベルには、以前のすべてのパリティレベルが存在する必要があります。

`parity` オプションと同じ考慮事項が適用されます。

これらのオプションはオプションであり、1回のみ使用できます。

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

トリプルパリティを保存するための代替ファイルとフォーマットを定義します。

このオプションは `3-parity` の代替であり、主にARMやSSSE3命令セットをサポートしていない AMD Phenom、Athlon、OpteronなどのローエンドCPUを対象としています。 このような場合、より良いパフォーマンスを提供します。

このフォーマットは、ZFS RAIDZ3で使用されるものと似ていますが、より高速です。 ZFSと同様に、トリプルパリティを超えては機能しません。

`3-parity` を使用している場合、パフォーマンス向上のために `z-parity` フォーマットの 使用が推奨される場合は警告が表示されます。

構成ファイルを目的の `z-parity` または `3-parity` ファイルで調整し、 `fix` を使用して再作成することで、あるフォーマットから別のフォーマットに 変換することが可能です。

7.4 content FILE

ディスクアレイに存在するすべてのファイルの一覧とチェックサムを保存するために使用するファイルを 定義します。

データ、パリティ、またはその他の利用可能なディスクに配置できます。 データディスクを使用する場合、このファイルは `sync` プロセスから自動的に 除外されます。

このオプションは必須であり、同じファイルを複数コピー保存するために複数回使用できます。

使用するパリティディスクごとに**少なくとも1つのコピー**と、さらに**1つのコピー**を 保存する必要があります。追加のコピーを使用しても害はありません。

7.5 data NAME DIR

アレイ内のデータディスクの名前とマウントポイントを定義します。 NAME はディスクを識別するために使用され、**一意である**必要があります。 DIR はファイルシステム内のディスクの**マウントポイント**です。

NAME を固定したままにしておけば、必要に応じてマウントポイントを変更できます。

アレイ内のデータディスクごとに1つのオプションを使用する必要があります。

構成ファイルで直接 NAME を変更してから `sync` コマンドを実行することで、 後でディスクの名前を変更できます。 名前変更の場合、関連付けはディスクの保存されたUUIDを使用して行われます。

7.6 nohidden

すべての隠しファイルとディレクトリを除外します。 Unixでは、隠しファイルは `.` で始まるファイルです。 Windowsでは、隠し属性を持つファイルです。

7.7 exclude/include PATTERN

syncプロセスで除外または含めるファイルまたはディレクトリのパターンを定義します。 すべてのパターンは指定された順序で処理されます。

一致する最初のパターンが `exclude` の場合、ファイルは除外されます。 `include` の場合、ファイルは含まれます。 パターンが一致しない場合、最後に指定されたパターンが `include` の場合はファイルは除外され、 `exclude` の場合は含まれます。

パターン仕様の詳細については、PATTERNセクションを参照してください。

このオプションは複数回使用できます。

7.8 blocksize SIZE_IN_KIBIBYTES

パリティの基本ブロックサイズをキビバイト単位で定義します。 1キビバイトは1024バイトです。

デフォルトのブロックサイズは256であり、ほとんどの場合に機能するはずです。

**警告！** このオプションはエキスパートのみを対象としており、この値を変更しないことを強く お勧めします。今後この値を変更するには、パリティ全体を**再作成**する必要があります！

異なるブロックサイズを使用する理由の1つは、数百万のオーダーの**多くの小さなファイル**を 持っている場合です。

ファイルごとに、たとえ数バイトであっても、パリティの**ブロック全体**が割り当てられ、 ファイルが多いと、これにより**かなりの未使用パリティスペース**が発生する可能性があります。 パリティディスクを完全に埋めると、データディスクにファイルを追加することは**許可されません**。 ただし、浪費されたパリティはデータディスク間で蓄積されません。データディスク上の多数のファイルから 生じる浪費スペースは、**そのデータディスク上のデータ量**のみを制限し、他のデータディスクには 影響しません。

概算として、ファイルごとにブロックサイズの半分が浪費されると仮定できます。 たとえば、100,000ファイルと256 KiBのブロックサイズがある場合、12.8 GBのパリティが浪費され、 これによりデータディスク上で12.8 GB少ないスペースしか利用できなくなる可能性があります。

`status` を使用して、各ディスクの浪費スペースの量を確認できます。 これは、データディスク上に**空き**として残す必要がある、またはアレイに含まれないファイルに 使用する必要があるスペースの量です。 この値が負の場合、パリティが満杯に近づいていることを意味し、まだ浪費できるスペースを 表します。

この問題を回避するために、パリティにより大きなパーティションを使用できます。 たとえば、パリティパーティションがデータディスクよりも12.8 GB大きい場合、 各データディスクで最大100,000ファイルを処理するのに十分な追加スペースがあり、 浪費スペースはありません。

Linuxでより大きなパリティパーティションを取得するトリックは、次のコマンドで フォーマットすることです。

mkfs.ext4 -m 0 -T largefile4 DEVICE

これにより、約1.5%の追加スペース、4 TBディスクで約60 GBが得られ、 浪費スペースなしで各データディスクで約460,000ファイルが可能になります。

7.9 hashsize SIZE_IN_BYTES

保存されたブロックのハッシュサイズをバイト単位で定義します。

デフォルトのハッシュサイズは16バイト（128ビット）であり、ほとんどの場合に機能するはずです。

**警告！** このオプションはエキスパートのみを対象としており、この値を変更しないことを強く お勧めします。今後この値を変更するには、パリティ全体を**再作成**する必要があります！

異なるハッシュサイズを使用する理由の1つは、システムのメモリが制限されている場合です。 経験則として、SnapRAIDは通常、アレイ内のデータ16 TBごとに1 GiBのRAMを必要とします。

具体的には、データのハッシュを保存するために、SnapRAIDは 約 $TS \cdot (1 + HS) / BS$ バイトのRAMを必要とします。 ここで、TSはディスクアレイの合計サイズ（バイト）、BSはブロックサイズ（バイト）、HSはハッシュサイズ（バイト）です。

たとえば、4 TBのディスク8台、ブロックサイズ256 KiB（1 KiB = 1024バイト）、 ハッシュサイズ16の場合：

RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 16) / (256 \cdot 2^{10}) = 1.93 \text{ GiB}$

ハッシュサイズを8に切り替えると：

RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 8) / (256 \cdot 2^{10}) = 1.02 \text{ GiB}$

ブロックサイズを512に切り替えると：

RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 16) / (512 \cdot 2^{10}) = 0.96 \text{ GiB}$

ハッシュサイズを8、ブロックサイズを512の両方に切り替えると：

RAM = $(8 \cdot 4 \cdot 10^{12}) \cdot (1 + 8) / (512 \cdot 2^{10}) = 0.51 \text{ GiB}$

7.10 autosave SIZE_IN_GIGABYTES

処理された指定されたGB量後に、同期またはスクラビング時に状態を自動的に保存します。 このオプションは、マシンクラッシュやその他のイベントによって中断された場合に、 長い `sync` コマンドを最初から再起動するのを避けるのに役立ちます。

7.11 temp_limit TEMPERATURE_CELSIUS

許容される最大ディスク温度を摂氏で設定します。指定されている場合、 SnapRAIDは smartctl ツールを使用してすべてのディスクの温度を定期的にチェックします。 SnapRAIDが動作している間、現在のディスク温度が表示されます。 いずれかのディスクがこの制限を超えると、すべての操作が停止し、ディスクは `temp_sleep` オプションで定義された期間、スピンダウン（スタンバイ状態に移行）されます。 スリープ期間後、操作は再開されますが、温度制限に再度達した場合は再び一時停止する 可能性があります。

操作中、SnapRAIDは各ディスクの加熱曲線も分析し、アクティビティが継続した場合に 達すると予想される長期的な安定温度を推定します。推定は、ディスク温度が4回上昇した 後にのみ実行され、信頼できる傾向を確立するのに十分なデータポイントが利用可能であることを 保証します。 この予測される安定温度は、現在の値の横に括弧で表示され、システムの冷却が 適切かどうかを評価するのに役立ちます。この推定温度は情報提供のみを目的としており、 SnapRAIDの動作には影響しません。プログラムの動作は、実際の測定されたディスク温度にのみ 基づいています。

この分析を実行するために、SnapRAIDはシステム温度の参照が必要です。 まず、利用可能なハードウェアセンサーから読み取ろうとします。システムセンサーに アクセスできない場合は、実行開始時に測定された最も低いディスク温度をフォールバック参照として 使用します。

通常、SnapRAIDは最も熱いディスクの温度のみを表示します。 すべてのディスクの温度を表示するには、-A または --stats オプションを使用します。

7.12 temp_sleep TIME_IN_MINUTES

温度制限に達したときのスタンバイ時間（分単位）を設定します。この期間中、ディスクは スピンダウンしたままです。デフォルトは5分です。

7.13 pool DIR

`pool` コマンドを使用してディスクアレイの仮想ビューが作成されるプーリングディレクトリを 定義します。

ディレクトリは既に存在している必要があります。

7.14 share UNC_DIR

ディスクにリモートでアクセスするために必要なWindows UNCパスを定義します。

このオプションが指定されている場合、プールディレクトリに作成されたシンボリックリンクは、 ディスクにアクセスするためにこのUNCパスを使用します。 このオプションがない場合、生成されたシンボリックリンクはローカルパスのみを使用し、 プールディレクトリをネットワーク経由で共有することはできません。

シンボリックリンクは、指定されたUNCパスを使用して形成され、`data` オプションで 指定されたディスク名を追加し、最後にファイルのディレクトリと名前を追加します。

このオプションはWindowsでのみ必要です。

7.15 smartctl DISK/PARITY OPTIONS...

各ディスクのSMART属性を取得するためのカスタムsmartctlオプションを定義します。 これは、RAIDコントローラーや一部のUSBディスクが自動検出できない場合に必要になる ことがあります。`%s` プレースホルダーはデバイス名に置き換えられますが、 RAIDコントローラーなどの固定デバイスではオプションです。

DISK は `data` オプションで指定されたのと同じディスク名です。 PARITY はパリティ名のいずれかです：`parity`、`2-parity`、`3-parity`、 `4-parity`、`5-parity`、`6-parity`、または `z-parity`。

指定された OPTIONS で、`%s` 文字列はデバイス名に置き換えられます。 RAIDコントローラーの場合、デバイスは固定されている可能性が高いため、 `%s` を使用する必要はないかもしれません。

使用可能なオプションについては、smartmontoolsのドキュメントを参照してください。

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

例：

smartctl parity -d sat %s

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

ディスク障害の確率を計算するときに、指定されたSMART属性を無視します。 このオプションは、ディスクが特定の属性について異常な値または誤解を招く値を報告する場合に 役立ちます。

DISK は `data` オプションで指定されたのと同じディスク名です。 PARITY はパリティ名のいずれかです：`parity`、`2-parity`、`3-parity`、 `4-parity`、`5-parity`、`6-parity`、または `z-parity`。 特殊な値 `*` は、すべてのディスクで属性を無視するために使用できます。

例として、すべてのディスクで `Current Pending Sector Count` 属性を無視するには：

smartignore * 197

最初のパリティディスクでのみ無視するには：

smartignore parity 197

7.17 Examples

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

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

パターンは、プロセスで除外または含めるファイルのサブセットを選択するために使用されます。

4つの異なる種類のパターンがあります。

**アレイのルートディレクトリ**に適用されます。

Windowsでは、フォワードスラッシュ / の代わりにバックスラッシュ \ を使用できます。 Windowsシステムディレクトリ、ジャンクション、マウントポイント、およびその他のWindowsの 特殊ディレクトリはファイルとして扱われます。つまり、それらを除外するには、 ディレクトリルールではなく**ファイルルール**を使用する必要があります。

ファイル名に '*'、'?'、'['、または ']' 文字が含まれている場合は、 グロブ文字として解釈されないように**エスケープ**する必要があります。 Unixではエスケープ文字は '\' です。Windowsでは '^' です。 パターンがコマンドラインにある場合は、コマンドシェルによって解釈されるのを防ぐために、 エスケープ文字を**2倍**にする必要があります。

構成ファイルでは、処理するファイルをフィルタリングするために異なる戦略を使用できます。 最も簡単なアプローチは、**除外**したいすべてのファイルとディレクトリを削除するために、 `exclude` ルールのみを使用することです。例：

# `*.unrecoverable` という名前の任意のファイルを除外
exclude *.unrecoverable
# ルートディレクトリ `/lost+found` を除外
exclude /lost+found/
# `tmp` という名前の任意のサブディレクトリを除外
exclude tmp/

反対のアプローチは、`include` ルールのみを使用して、**処理したいファイルのみ**を 定義することです。例：

# 一部のディレクトリのみを含める
include /movies/
include /musics/
include /pictures/

最後の方法としては、`exclude` と `include` ルールを混在させます。この場合、 **ルールの順序が重要**です。前のルールは後のルールよりも優先されます。 簡素化するために、すべての `exclude` ルールを最初にリストし、次にすべての `include` ルールをリストできます。例：

# `*.unrecoverable` という名前の任意のファイルを除外
exclude *.unrecoverable
# `tmp` という名前の任意のサブディレクトリを除外
exclude tmp/
# 一部のディレクトリのみを含める
include /movies/
include /musics/
include /pictures/

コマンドラインで -f オプションを使用する場合、`include` パターンのみを 使用できます。例：

# .mp3 ファイルのみをチェック。
# Unixでは、シェルによるグロブ展開を防ぐために引用符を使用。
snapraid -f "*.mp3" check

Unixでは、コマンドラインでグロブ文字を使用する場合、シェルがそれらを展開するのを 防ぐために引用符で囲む必要があります。

9 Content

SnapRAIDは、ファイルの一覧とチェックサムをコンテンツファイルに保存します。

これはバイナリファイルであり、ディスクアレイに存在するすべてのファイルと、 それらの整合性を検証するためのすべてのチェックサムを一覧表示します。

このファイルは `sync` および `scrub` コマンドによって読み書きされ、 `fix`、`check`、および `status` コマンドによって読み取られます。

10 Parity

SnapRAIDは、アレイのパリティ情報をパリティファイルに保存します。

これらはバイナリファイルであり、`content` ファイルで定義されたすべてのブロックの 計算されたパリティが含まれています。

これらのファイルは `sync` および `fix` コマンドによって読み書きされ、 `scrub` および `check` コマンドによって**読み取られるだけ**です。

11 Encoding

UnixのSnapRAIDは、エンコーディングを無視します。ファイルシステムで使用されている のと同じエンコーディングでファイル名を読み取り、保存します。

Windowsでは、ファイルシステムから読み取られたすべての名前はUTF-8形式に変換され、 処理されます。

ファイル名を正しく出力するには、`chcp 65001` コマンドでWindowsコンソールをUTF-8モードに設定し、 コンソールフォントとして `Lucida Console` などのTrueTypeフォントを**使用する**必要があります。 これは出力されるファイル名にのみ影響します。コンソール出力をファイルにリダイレクトする場合、 結果のファイルは常にUTF-8形式になります。