データベース復元後のホームメディアメタデータ復旧ワークフロー

エヴァ・ウォン は テクニカルライター であり ZimaSpaceの常駐ティンカーでもあります。 生涯のオタクであり、 ホームラボとオープンソースソフトウェアに情熱を持っています。彼女は複雑な技術的概念をわかりやすく、 実践的なガイドに翻訳することを専門としています。エヴァはセルフホスティングは楽しくあるべきで、怖がるものではないと信じています。彼女のチュートリアルを通じて、コミュニティが ハードウェアのセットアップを解明する手助けをしています。初めてのNAS構築からDockerコンテナの習得まで。

安全なアプローチでは、データベースの整合性とパスを検証し、一致するメタデータ資産を復元し、確認済みの不足部分だけを更新する段階的な復旧を、単一のコマンドではなく、観測可能なゲートの連続として扱います。

Jellyfinなどのホームメディアサーバーを分離されたアプリデータパスに復元する場合、実際のリスクは、復元されたメディアデータベースは起動するものの、ポスター、マッチング結果、コレクション、視聴状態、ライブラリリンクのいずれかが不完全になることです。現在の識別情報と復旧ポイントを記録し、最も影響の少ない識別手順から開始して、別の変数を変更する前に成功・失敗の結果を解釈し、ストレージが不安定になった場合や、復旧可能なコピーが1つしかなく、それが危険にさらされる場合は停止します。以下のワークフローは、元のワークロードが成功するか、証拠がエスカレーションの境界に達した時点でのみ終了します。

復元したインスタンスを凍結し、不足しているものを分類する

復旧したサーバーを本番環境から分離したままにし、スケジュールスキャン、クリーンアップ、メタデータの置換、自動ライブラリ監視を無効にします。アプリケーションのバージョン、データベースファイル、メタデータと画像のディレクトリ、キャッシュ、ライブラリパス、ユーザー数、視聴状態、プラグイン、各コンポーネントの正確な復旧時刻を記録します。

ZimaSpaceのJellyfin復旧ユニットの検証手順を使用して、バックアップがデータベースファイルだけでなく、完全な復旧ユニットであることを確認します。ある時点のデータベースと別の時点のメタデータディレクトリを組み合わせると、正常に起動しても、アイテム参照とアートワーク資産が一致しない場合があります。

症状は個別に分類します。ポスターの欠落、タイトルの誤マッチ、空のコレクション、視聴状態の消失、利用できないメディア、権限エラーなどです。メディアマウントまたは復元したデータベースの整合性に確信が持てない場合は、更新を実行する前に停止します。更新では、不足している復旧コンポーネントを安全に修復できないためです。

バージョン、データベースの整合性、メディアパスを検証する

復元データのコピーに対して、一致するアプリケーションバージョンを起動し、データベースの移行および整合性に関するメッセージを確認します。新しいバージョンによるデータベース移行を許可する前に、復元されたユーザー、ライブラリ定義、アイテム数、視聴記録が存在することを確認します。

復元されたデータベースが想定するものと同じコンテナパスに、メディアを読み取り専用でマウントします。パスが変更されている場合は、コピー上でサポートされている移行方法またはパス更新方法を検証します。先にライブラリを削除して再作成してはいけません。新しい識別子が生成され、既存の状態が切り離される可能性があるためです。

Jellyfinのパスおよびデータベース移行事例に関する議論では、データベース参照と設定パスの違いが説明されています。これは限定的な移行の手がかりとして使用し、復元したバージョンと1つのパイロットライブラリで検証してから、検証なしに本番データベースのテーブルを編集しないでください。

一致する資産を復元し、確認済みの不足部分だけを更新する

利用可能な場合は、同じ復旧ポイントに属するメタデータ、アートワーク、プラグイン、設定を復元します。権限と所有者を比較し、カスタムポスター、手動で識別したタイトル、コレクション、字幕、人物画像を含む、既知の複数のアイテムを読み込みます。

ファイルが存在しない一方でデータベース参照が正しい場合は、小規模なパイロットセットに対して、不足メタデータまたは不足画像のアクションを実行します。適切なフォルダー名はリモートマッチングを改善します。マッチングのためのメディアフォルダー命名では、整理されたJellyfinパスによって、破壊的な全置換更新を必要とせずにプロバイダーがタイトルを識別しやすくなる仕組みを説明しています。

全メタデータの置換は、保存されている状態を意図的に破棄してよいアイテムにのみ使用します。NFOファイルとロックされたフィールドを保持し、変更前の状態を記録して、パイロットによって編集済みのタイトル、アートワーク、並べ替え名、コレクションメンバーシップが上書きされないことを確認します。

復旧を検証し、段階的にサービスを再開する

代表的なアイテムを再生し、ポスターと背景画像を確認し、コレクションを開き、検索をテストし、元のユーザーで視聴の進捗を確認し、破棄可能なメタデータを1件編集します。分離されたインスタンスを再起動し、復旧したすべての状態が保持されることを確認します。

まずパイロットライブラリのスキャンを再有効化し、その後は一度に1つのライブラリずつ有効化します。利用できないパス、画像の書き込み失敗、プロバイダーの制限、データベースロック、予期しないアイテム削除についてログを監視し、全サイクルが完了するまで元の復元コピーを変更しないでください。

データベース、パス、アートワーク、編集済みフィールド、ユーザー、再生、再起動、バックアップのすべてに合格してから、トラフィックを戻します。識別子または視聴状態が変化した場合は保護された復元コピーにロールバックし、唯一のコピーに更新を重ねるのではなく、破損や不足している復旧コンポーネントをエスカレーションします。

サポートとヒント

もっと読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.