ストレージパスの変更後、Jellyfinに古いデータが表示される

ストレージを移動した後にJellyfinが古いデータを表示するのは、通常、サービスが古いパスを参照している、新しいマウントを読み取れない、または新しい場所に対する有効なスキャンが完了していないことが原因です。

ダッシュボードには古い項目、見つからない項目、それとも両方が混在して表示されていますか？ 最初にライブラリを削除したり、ごみ箱を空にしたりしないでください。正確な旧パスと新パス、マウント状態、サービスの所有者、スキャン結果を記録し、メタデータを破壊せずに各分岐を検証できるようにします。

Jellyfinが実際に認識できるパスを確認する

パスはホストのシェルからだけでなく、Jellyfinのプロセスまたはコンテナ内から確認してください。起動後もマウントが存在すること、サービスアカウントでサンプルファイルの一覧表示と読み取りができること、コンテナのマッピングがライブラリ設定に保存されているパスと一致することを確認します。

パスが空、またはアクセスできない場合は、まずマウント、UID/GID、またはコンテナボリュームを修正してください。手動ログイン後にのみ表示されるストレージマウントでは、起動時にJellyfinが空のディレクトリをスキャンすることがあります。

ライブラリ設定とデータベース内の1件のレコードで、旧パスと新パスを比較します。両方が残っている場合、Jellyfinが有効な項目と古い参照を1件ずつ正当に表示している可能性があります。

古いメタデータとスキャン失敗を区別する

パスを読み取れるようにしたら、制御されたスキャンを実行し、ライブラリ名、項目数、権限エラー、スキップされたファイルについてログを確認します。既知の古い項目を1件と、新しく追加したファイルを1件比較してください。スキャンが完了しても古いパスが残る場合は、データベースに以前の場所が残っているか、新しいパスを追加しただけで古い参照を削除していない可能性があります。

キャッシュされたポスターだけを根拠に、メディアファイルが利用可能だと判断しないでください。ストレージパスのルールでは、マウントされたファイルシステムとアプリケーションパスを別々に確認する必要があります。

マッピングを修正した後に、制御されたスキャンを1回だけ実行し、項目数と既知のファイル1件を比較します。パスを修正する前に何度も再スキャンすると、状態がさらに分かりにくくなることがあります。

分岐が確認できてから修復する

パスマッピングまたは権限を修正し、1回だけ再起動してから再スキャンします。データベースのパスが誤っている場合は、可能な限り小さな変更でライブラリの場所を更新し、古い項目を整理する前に期待される項目数を確認します。大量のメタデータ操作を行う前に、アプリケーションデータとバックアップを保持してください。

サービスが再起動後も新しいパスを認識し、代表的なクライアントで項目を再生でき、2回目のスキャンでも古い状態が再作成されなければ、復旧を確認できます。ファイルシステムが破損を報告する場合、データベースに競合するパスが含まれる場合、または正常なマウントと再起動の後も問題が再発する場合は、エスカレーションしてください。

修復後は、起動時にマウントが利用可能な状態で再起動し、スキャンを繰り返します。同じパスが再起動後も表示され続けることを確認するまで、古いデータの問題は解決していません。

-15% OFF

ZimaBoard 2 - あなたの大きなアイデアのためのミニホームサーバー

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

パスが繰り返し再表示される場合はエスカレーションする

正常な再起動、1回のスキャン、代表的な再生のすべてで新しいパスが使用され、古い項目が再作成されない場合は、修正済みのマッピングを維持します。

古いパスが戻る場合、データベースに競合する識別情報が含まれる場合、またはスキャンのたびにストレージマウントが変わる場合は、整理作業を中止してください。まずデータベースと現在のパスマップを保持します。

ファイルシステムが正常であるにもかかわらず、正常なマッピングと再起動の後も古い参照が残る場合は、バックアップからの復元またはデータベース固有の修復へエスカレーションしてください。