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

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

安全な方法は、データベースの整合性とパスを検証し、一致するメタデータアセットを復元して、問題が確認された箇所だけを更新する段階的な復旧を、単一のコマンドではなく、結果を確認できる一連のゲートとして扱うことです。

Jellyfinなどのホームメディアサーバーを、分離したアプリデータのパスに復元した場合、実際に起こり得るリスクは、復元したメディアデータベースが起動しても、ポスター、一致結果、コレクション、視聴済み状態、ライブラリのリンクが不完全なことです。現在のIDと復旧ポイントを記録し、まず最も影響の少ない判別方法から始めます。別の変数を変更する前に、成功と失敗の結果を解釈し、ストレージが不安定になった場合や、唯一の復旧可能なコピーが危険にさらされる場合は停止します。以下の手順は、元のワークロードが正常に動作するか、証拠がエスカレーションの境界に達した場合にのみ完了します。

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

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

ZimaSpaceのJellyfin復旧ユニットの検証手順を使って、バックアップがデータベースファイルだけでなく、完全な復旧ユニットであることを確認します。異なる時点のデータベースとメタデータディレクトリを組み合わせても起動することはありますが、アイテム参照とアートワークのアセットが食い違う可能性があります。

症状を分けて分類します。ポスターの欠落、タイトルの誤った一致、コレクションが空、視聴済み状態の消失、メディアが利用不可、権限エラーなどです。メディアのマウントや復元したデータベースの整合性に不確実な点がある場合は、更新を始める前に停止してください。更新では、欠けている復旧コンポーネントを安全に修復できません。

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

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

メディアを、復元したデータベースが想定するコンテナ内のパスに読み取り専用でマウントします。パスが変わっている場合は、まずコピー上で、サポートされている移行方法またはパス更新方法が機能することを確認します。先にライブラリを削除して作り直さないでください。新しいIDが生成され、既存の状態との紐付けが失われる可能性があります。

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.