問題のあるサーバーアップデート後にPlexを安全にロールバックする方法

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

ダウングレードの前にPlexのデータディレクトリをバックアップしてください。そのうえで、新しいリリースでデータベースの互換性が変更されたか確認してから、一度に1バージョンずつロールバックしてください。

Plexのロールバックは、バイナリやDockerイメージを置き換えるだけではありません。アップデートによってサーバーデータベースが移行されることがあり、古いサーバーでは新しいバージョンが書き込んだデータを理解できない場合があります。まず現在のデータを保全し、最後に正常動作が確認されたビルドを特定して、いつでも元に戻せる状態を維持してください。目的は、ソフトウェアの問題をデータベース復旧の問題に発展させずに、アップデートが回帰の原因だと確認することです。

サーバーバージョンを変更する前に現在の状態を保全する

Plexを正しく停止し、永続化されたサーバーデータディレクトリのコピーを作成してください。現在のサーバーバージョンと、ロールバックする原因となった具体的な症状を記録します。Dockerを使用している場合は、現在のイメージタグまたはダイジェストと、最後に正常動作が確認された以前のタグも記録してください。そうすれば、「latest」とキャッシュに残っていた何かの比較ではなく、明確な手順でロールバックできます。

最近のPlexフォーラムでの復旧事例では、以前のインストーラーがサーバーのUpdatesディレクトリにある場合があると説明され、以前のサーバーバージョンに戻す方法が紹介されています。これは特定のバージョンに関する運用上の参考情報として捉えてください。すべてのプラットフォームで同じ方法でパッケージが保存されているという保証ではありません。

ロールバックの最初の手順として、現在のデータベースや設定を削除しないでください。古いビルドが動作しなかった場合、ロールバック前の状態に戻すには、変更していないバックアップが必要です。安全なロールバックでは、古いビルドに戻す場合も、現在のビルドに再び進める場合も、どちらの状態にも戻せるようにしておきます。

ダウングレードの前にデータベースの移行境界を確認する

インストールしたバージョンのリリースノートや既知の回帰に関する議論を確認してください。Plexの一部のリリースではデータベースの互換性が変更されており、古い実行ファイル自体は正しくインストールできても、大幅に古いバージョンへ戻すと失敗することがあります。移行境界がある場合は、対応している中間バージョンを経由するか、互換性のあるデータベースのバックアップを復元してください。古いサーバーで新しい状態のデータベースを無理に使用しないでください。

Plexコミュニティでは、1.40への移行に関する案内の中で、データベースの互換性によってロールバックできる範囲が制限された事例が紹介されています。その事例における正確なバージョン番号は過去のものです。今後も変わらないルールとして、ダウングレードの前に、使用するリリースの移行境界を確認してください。

Plexが現在データベースの移行を実行中の場合、ロールバックを急ぐためだけに中断しないでください。移行が完了するのを待つか、互換性が確認済みのバックアップを復元してください。スキーマ処理を中断すると別の障害状態が生じ、リリース自体が元の問題を引き起こしたかどうかの確認が難しくなります。

ほかの変数を変更せずに前のビルドをインストールまたは固定する

変更するのはPlexサーバーのバージョンだけにしてください。同じアプリデータのマウント、メディアパス、ネットワークモード、ハードウェアデバイス、クライアント設定を維持します。Dockerでは、変動するタグに頼らず、前のイメージタグを固定してください。パッケージベースのインストールでは、プラットフォームに適した信頼できる提供元から以前のインストーラーを入手してください。

ZimaSpaceホームサーバー復旧チェックリストも同じ復旧原則に沿っています。読み取り可能な状態を保ち、障害が発生している層を特定し、最初に誤ったコンポーネントを交換したり再構築したりしないことです。Plexのロールバックも同じように対象を絞る必要があります。

Plexを起動し、再生をテストする前にデータベースエラーがないかログを確認してください。旧ビルドがデータベースを受け付けない場合や、新しいサーバーとして起動する場合は、すぐに停止し、互換性のないデータディレクトリに新しいファイルを書き込ませずに、保護された状態を復元してください。

ロールバックを続けるか決める前に、元の回帰問題を再現する

旧ビルドが正常に起動したら、アップデート後に失敗したのとまったく同じ条件を再現してください。同じクライアント、メディア、ネットワーク経路、ライブラリ操作、またはスケジュールタスクを使います。旧バージョンで元のきっかけが問題なく動作し、サーバーのほかの部分も正常な場合に限り、ロールバックによってリリースが原因だったと確認できます。

Plexを一度再起動し、同じきっかけを再現して、通常のライフサイクルイベント後も復旧状態が維持されることを確認してください。その後、ライブラリへのアクセス、視聴履歴、使用している場合はリモートアクセス、そしてアップデートの影響を受けた可能性のあるハードウェアトランスコード経路を確認してください。ホーム画面だけで成功と判断しないでください。

前のビルドでも問題が解決しない場合は、保護された現在の状態に戻し、ダウングレードを重ねずに診断を続けてください。前のビルドで問題が解決する場合は、ロールバックを一時的なものにとどめ、動作するバージョンを記録し、再度アップグレードする前に問題を解消する後続のPlexリリースを待ちましょう。

サポートとヒント

続きを読む

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.