Update translations

This commit is contained in:
Andrea Mazzoleni 2026-06-08 18:26:17 +02:00
parent fd58387aea
commit d079abbc2b
42 changed files with 6830 additions and 1261 deletions

View file

@ -113,19 +113,33 @@ https://www.snapraid.it/
.PD 0
.PD
.RE
.SH LIMITATIONS
.SH 制限事項
SnapRAIDはRAIDとバックアッププログラムのハイブリッドであり、両方の利点を組み合わせることを
目指しています。ただし、使用する前に考慮すべきいくつかの制限があります。
目指しています。ただし、使用する前に考慮すべきいくつかの制限事項があります。
.PP
主な制限は、ディスクが故障し、最近 \`sync\` を実行していない場合、完全に復旧できない
可能性があることです。
より具体的には、最後の \`sync\` 操作以降に変更または削除されたファイルのサイズまでのデータが
復旧できない可能性があります。
これは、変更または削除されたファイルが故障したディスク上にない場合でも発生します。
このため、SnapRAIDは**めったに変更されない**データに適しています。
主な制限事項は、ディスクが故障した場合、最後の \`sync\`(同期)処理の状態までしか
データを復元できないことです。最後の同期以降に追加されたデータや、故障したディスク上で行われた
変更はすべて失われます。
.PP
一方で、新しく追加されたファイルは、既に存在するファイルの復旧を妨げません。
新しく追加されたファイルが故障したディスク上にある場合にのみ、それらのファイルが失われます。
そのため、SnapRAIDは主にデータの変更がほとんどない環境に適しています。
.PP
最後の同期時にすでに存在していたデータについて、復元の信頼性は \`snapshot\`(スナップショット)
オプションが使用されているかどうかによって異なります。
.PD 0
.IP \(bu
スナップショットサポートがある場合(Btrfs、ZFS、Bcachefs、およびNTFSで利用可能):
SnapRAIDはデータディスクの凍結されたリファレンスを自動的に維持できます。
これにより、同期中または同期後にライブファイルシステム上のファイルを変更または削除した場合でも、
復元プロセスの整合性と信頼性が保たれます。
.PD
.PD 0
.IP \(bu
スナップショットサポートがない場合:
\`sync\` 後にファイルを削除または変更すると、他の故障したディスクの完全な復元が妨げられる
可能性があります。これは、変更されたファイルが故障したディスク上にない場合でも、
パリティが変更後のファイルと一致しなくなるために発生します。一方で、新しく追加されたファイルが
すでに存在するファイルの復元を妨げることはありません。
.PD
.PP
その他のSnapRAIDの制限は次のとおりです。
.PD 0
@ -623,22 +637,22 @@ snapraid sync
.RE
.PP
すべてが復旧されていれば、このコマンドは即座に完了します。
.SH COMMANDS
SnapRAIDは、次のことを可能にするいくつかの簡単なコマンドを提供します。
.SH コマンド
SnapRAIDは、以下の操作を行ういくつかのシンプルなコマンドを提供します。
.PD 0
.IP \(bu
アレイの状態の概要を出力 \-> \`status\`
アレイの状態を表示する \-> \`status\`
.IP \(bu
ディスクの制御 \-> \`smart\`、\`probe\`、\`up\`、\`down\`
ディスクを制御する \-> \`smart\`、\`probe\`、\`up\`、\`down\`
.IP \(bu
バックアップ/スナップショットの作成 \-> \`sync\`
バックアップ/復元ポイントを作成する \-> \`sync\`
.IP \(bu
データの定期的なチェック \-> \`scrub\`
データを定期的にチェックする \-> \`scrub\`
.IP \(bu
最後のバックアップ/スナップショットの復元 \-> \`fix\`。
最後のバックアップ/復元ポイントを復元する \-> \`fix\`
.PD
.PP
コマンドは**小文字**で記述する必要があります。
コマンドは小文字で入力する必要があります。
.SS status
ディスクアレイの状態の概要を出力します。
.PP
@ -858,14 +872,14 @@ full \- すべてをスクラブします。
\`parity\` ファイルは**変更されません**。
アレイ内のファイルは**変更されません**。
.SS fix
すべてのファイルとパリティデータを修正します。
すべてのファイルとパリティデータを修復(復元)します。
.PP
すべてのファイルとパリティデータは、最後の \`sync\` で保存されたスナップショット状態と
比較されます。
違いが見つかった場合、保存されたスナップショットに**元に戻されます**。
すべてのファイルとパリティデータが、最後の \`sync\` で保存された状態と比較されます。
差異が見つかった場合、保存されていた状態に巻き戻されます。
.PP
**警告!** \`fix\` コマンドは、エラーと意図的な変更を区別しません。
ファイルの_状態を_最後の \`sync\` に**無条件に元に戻します**。
警告!
\`fix\` コマンドは、エラーと意図的な変更を区別しません。
ファイルの変更状態を無条件で最後の \`sync\` の状態に戻します。
.PP
他のオプションが指定されていない場合、アレイ全体が処理されます。
フィルタオプションを使用して、操作するファイルまたはディスクのサブセットを
@ -1348,6 +1362,27 @@ NAME を固定したままにしておけば、必要に応じてマウントポ
.PP
これらのディスクは常に回転していることが期待されるため、\`up\` およ
び \`down\` コマンドの影響を受けないことに注意してください。
.SS snapshot
\`sync\`、\`scrub\`、\`check\`、および \`fix\` コマンドでファイルシステムスナップショットの
使用を有効にします。
.PP
有効にすると、SnapRAIDは \`sync\` の開始時にデータの読み取り専用スナップショットを作成します。
これにより、ファイルの整合性を保った特定の時点のビューが確保され、ファイルの同時変更によって
発生するエラーを防ぎます。
.PP
これにより復元が大幅に向上します。ライブファイルシステムからファイルが削除されても、
スナップショット内に保存され続けます。これにより、そのブロックのパリティが「破損」するのを防ぎ、
別のディスクが故障した場合でもデータを正常に復元できるようになります。
.PP
このオプションは、LinuxのBtrfs、Bcachefs、ZFS、およびWindowsのNTFSでフォーマットされた
データディスクにのみ適用されます。
パリティディスク、または他のファイルシステムを使用しているデータディスクは、常にファイルシステムの
ライブバージョンを使用します。
.PP
スナップショットの作成と削除には管理者権限が必要です。
このオプションが有効な場合は、SnapRAIDが必要な権限(例:sudo)で実行されていることを確認してください。
.PP
スナップショットのライフサイクルの詳細な説明については、SNAPSHOTSのセクションを参照してください。
.SS nohidden
すべての隠しファイルとディレクトリを除外します。
Unixでは、隠しファイルは \`.\` で始まるファイルです。
@ -1663,6 +1698,103 @@ smartctl 2\-parity \-d areca,2/1 /dev/arcmsr0
.PD 0
.PD
.RE
.SH SNAPSHOTS(スナップショット)
設定でスナップショットオプションが有効になっている場合、SnapRAIDは
ファイルシステムのスナップショット機能を利用して、アトミックで一貫性のある操作を保証します。
.PP
スナップショットの管理は完全に自動かつ透過的です。
バックグラウンドで完全に処理されるスナップショットによる追加の保護を受けながら、
これまでとまったく同じようにSnapRAIDを使用し続けることができます。
.PP
これには主に2つのメリットがあります。
.RS 0
.PD 0
.HP 4
.I 整合性
長時間かかるsyncやscrubの実行中にライブファイルシステム上でファイルが変更されても、
SnapRAIDは凍結された時点のイメージを参照するため、パリティの不一致や処理の中断は発生しません。
.HP 4
.I 復元
ライブファイルシステムからファイルが更新または削除されても、スナップショット内に保存され続けます。
次のsyncが実行される前にディスク故障が発生した場合、SnapRAIDはスナップショットに保存されている
データを使用して、故障したディスクを再構築します。
.PD
.PP
.RS 4
.PD 0
アクティブなsync処理中にディスクが故障した場合、SnapRAIDは前のパリティ計算の
スナップショットと現在のスナップショットの両方から自動的に読み取ることも可能です。
これにより、同期の間にブロックが変更または削除されていた場合でも、パリティ方程式を解くために
必要な正確なデータブロックへのアクセスが提供され、完全な復元の可能性が最大化されます。
.PD
.PP
.PD 0
スナップショットがない場合、正常なディスク上の更新または削除されたファイルはデータブロックの欠損を
招き、他の故障したディスクを修復するために必要となるブロックが失われる可能性があります。
.PD
.RE
.RE
.PP
スナップショットはデータディスクに対してのみ、かつ基礎となるファイルシステムがその機能をサポートして
いる場合にのみ作成されます。パリティディスクは常にライブファイルシステムを使用します。
現在、これはLinuxのBtrfs、Bcachefs、ZFS、およびWindowsのNTFSでサポートされています。
.PP
異なるファイルシステムを持つデータディスクを混在させることができます。スナップショットをサポートして
いるディスクのみがそれを利用し、他のディスクはライブファイルシステム上で直接動作し続けます。
.PP
スナップショットの作成と削除には管理者権限が必要です。
スナップショットが有効な場合は、SnapRAIDが必要な権限(例:sudo)で実行されていることを確認してください。
.SS スナップショット使用時のコマンドの挙動
\`sync\` と \`scrub\` コマンドは、すべてのデータ操作が一貫した凍結状態に対して行われることを
保証するために、いずれもスナップショット上でのみ動作します。これらのスナップショットを利用することで、
SnapRAIDはライブファイルシステム上での同時ファイル変更によってトリガーされるパリティの不一致を防ぎます。
\`sync\` の実行中、コマンドはプロセスの開始時に作成された新しいスナップショットを使用して、パリティ計算の
ための現在の状態をキャプチャします。
対照的に、\`scrub\` コマンドは、既存のパリティと一致する信頼できる参照ポイントを維持するために、
最も直近の同期中に作成された最後のスナップショットを利用します。
.PP
\`check\` および \`fix\` コマンドの場合、最後のスナップショットの使用は、
\-d, \-\-filter\-disk オプションを使用して特定のディスクがターゲットに指定されているかどうかによって異なります。
.TP
.B \-d を介して明示的に選択されたディスク(操作の「ターゲット」)は、常にライブファイルシステムを使用します。
\`fix\` の場合、これによりアクティブな交換ディスクにデータを復元できます。
\`check\` の場合、同じ条件下で \`fix\` 操作をシミュレートできます。
.PP
他のすべてのデータディスク(「参照」ディスク)は、それぞれのスナップショットを介してアクセスされます。
これにより、復旧の進行中に正常なディスク上のファイルを変更している場合でも、SnapRAIDは
パリティ方程式を解くための安定した凍結された参照を持つことができます。
.TP
.B \-d オプションが指定されていない場合、SnapRAIDは操作がアレイ全体に適用されると想定します。
この場合、\`check\` と \`fix\` はライブファイルシステムのみを排他的に使用します。
.PP
他のすべてのコマンドは、ライブファイルシステム上でのみ動作します。
.SH スナップショットのライフサイクル
SnapRAIDは、各データサブボリュームのルートにある隠しディレクトリ内で、
\`stable\`(安定)と \`pending\`(保留)という2つの特定のスナップショットを管理します。
Btrfs、Bcachefs、およびNTFSでは \`.snapraid/\` ディレクトリが使用され、
ZFSでは標準の \`.zfs/snapshot/\` が使用されます。
.PP
\`stable\` スナップショットは、最後に正常に完了した \`sync\` の状態を表し、
現在のパリティの計算に使用された正確なデータを含んでいます。これは、
\`scrub\`、\`check\`、および \`fix\` コマンドの主要なデータソースとして機能します。
.PP
\`pending\` スナップショットは、パリティ計算のための凍結された状態を提供するために、
\`sync\` の開始時に作成される一時的なイメージです。
操作が正常に完了すると、以前の \`stable\` スナップショットが削除され、
\`pending\` スナップショットが新しい安定した参照として昇格します。
.PP
\`sync\` が中断された場合、\`pending\` スナップショットは保持されます。
パリティが部分的にしか同期されていない場合でも、.content ファイルに記録されたファイルシステム状態と
一致するため、その後の \`scrub\`、\`check\`、および \`fix\` コマンドはこの保留中のスナップショットを使用します。
.PP
\`sync\` が中断された場合、\`check\` および \`fix\` コマンドは \`stable\` スナップショットからも
読み取りを行い、同期中に更新または削除されたファイルからデータブロックを取得します。
これは、.content ファイルが同期プロセス全体を通じて、変更または削除されたすべてのファイルの
メタデータを保持しているために可能です。
この履歴情報は、syncが正常に終了し、.content ファイルの最終バージョンが保存されたときにのみクリアされます。
.PP
中断後に \`sync\` が再開されると、既存の保留中(pending)のスナップショットは削除され、
ライブファイルシステムの現在の状態をキャプチャするために新しいスナップショットが作成されます。
.SH PATTERN
パターンは、含めるファイルまたは除外するファイルをフィルタリングするための柔軟な方法を
提供します。グロブ文字を使用することで、すべてのパスを手動でリストすることなく、