カーネル更新後も内蔵GPUが利用可能か確認する方法

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

新しいカーネルが内蔵GPUを検出し、正しいドライバーをバインドしてレンダーノードを作成し、それらをワークロードに公開して初めて、内蔵GPUを利用できます。

ホームサーバーのカーネルアップデート後、ハードウェアアクセラレーションの設定が有効なままでも、メディアアプリがソフトウェア処理に切り替わることがあります。障害は、PCI検出、カーネルモジュールのバインド、ファームウェアの読み込み、DRMデバイスの作成、VA-APIの初期化、デバイス権限、Dockerのデバイス割り当て、またはメディアサーバーのFFmpeg処理経路のいずれかで発生する可能性があります。アプリケーション設定を変更する前に、これらの層を順番に確認し、以前の起動時と比較してください。

新しいカーネルを記録し、PCIバス上でiGPUを確認する

実行中のカーネルバージョン、インストール済みの以前のカーネル、起動パラメーター、アップデートの時刻を記録します。次に、数値ID付きのディスプレイクラスPCIデバイスと、内蔵GPUに現在バインドされているカーネルドライバーを一覧表示します。

PCIデバイスの一覧にiGPUが表示されない場合は、VA-APIのトラブルシューティングを始める前にファームウェアまたはBIOSの設定を確認します。事例では、iGPUまたはマルチモニターのオプションが無効になっていると、サーバーにディスクリートGPUだけが認識されることがあり、iGPUがLinuxから見えなくなっていました。

デバイスIDとバインドされているドライバーを、正常に動作していた直近の起動時と比較します。Intelのシステムでは通常、i915、または対応する新しい環境ではxeが使われます。別のプラットフォームのモジュール名を無理に指定せず、ハードウェアとディストリビューションに適したドライバーを使用してください。

ドライバーとファームウェアの初期化に関するカーネルログを確認する

現在の起動ログで、GPUドライバー、DRM、GuCまたはHuCファームウェア、ディスプレイの初期化、プローブ失敗、タイムアウト、モジュールのブラックリストを確認します。永続ログが利用可能な場合は、以前のカーネルでの同じメッセージと比較します。

ハードウェアが一覧に表示されていても、メディアドライバーの障害が発生することがあります。Intelの事例では、周辺のソフトウェアスタックが変更された後、内蔵Xe-LPG GPUでVA-APIの初期化に失敗したことが報告されており、ハードウェアが検出されるだけでは不十分であることが示されています。

必要なファームウェアパッケージが引き続き存在し、新しいカーネルパラメーター、ブラックリスト、セキュアブートポリシーによってモジュールがブロックされていないことを確認します。ホストドライバーが正常に初期化されるまで、メディアサーバーを再インストールしないでください。

DRMレンダーノードがまだ存在することを確認する

/dev/driを調べ、各カードとレンダーノードのメジャー番号、マイナー番号、所有者、グループ、シンボリックリンクの参照先を記録します。別のGPUがある場合、iGPUが常にrenderD128のままとは限りません。

FFmpegが、存在はするものの有効なVAディスプレイを提供しなくなったノードを対象にすると、ハードウェアアクセラレーションは失敗します。Jellyfinのレポートでは、決定的なエラーとしてレンダーデバイスにVAディスプレイがないことが示されています。

sysfsを使ってレンダーノードをPCIデバイスに対応付け、そのノードの識別情報が実際に変わった場合にのみ、コンテナまたはアプリケーションの設定を更新します。モード777などの広範な権限は避け、レンダーグループの仕組みを維持したうえで、サービスアカウントがそのグループに属していることを確認してください。

Dockerを使う前にホスト上でVA-APIまたはQuick Syncをテストする

確認済みのレンダーノードを使って、ディストリビューションのVA-API診断ツールを実行し、ドライバー名、VA-APIのバージョン、対応するデコードプロファイル、エンコードのエントリーポイント、動画処理機能を記録します。

ユーザー空間のメディアドライバーは、ハードウェアの世代とカーネルインターフェースに適合している必要があります。解決済みのLinux事例では、カーネルのDRMモジュールとユーザー空間のDRIまたはVAドライバーは別のレイヤーであることが強調されています。これらを混同すると、誤ったユーザー空間ドライバーが残ることがあります。

ホスト側でVA-APIが失敗する場合は、現在のメディアドライバーとファームウェアのパッケージを更新前のバージョンと比較します。ホスト側でVA-APIが成功する場合は、カーネルとドライバーを変更せず、コンテナ側の問題に移ります。

コンテナ内で同じデバイスとグループを確認する

実行中のコンテナのデバイス、グループID、選択したレンダーノードへのアクセスを確認します。ホスト側で成功してもコンテナ内で成功するとは限らないため、メディアサーバーに同梱されているVA-API診断ツールまたはFFmpegビルドをコンテナ内で実行してください。

コンテナに /dev/dri/renderD128 を割り当てても、プロセスに対応するレンダーグループの権限がなければ失敗することがあります。Jellyfinコンテナのレポートでは、デバイスの割り当てとグループアクセスの両方を確認する必要があることが示されています。

ホストとコンテナ内の数値のグループIDを比較し、必要に応じてデバイスとグループを明示的に設定してサービスを再作成してください。ZimaSpaceのハードウェアトランスコーディングの確認ガイドで、アプリケーションレベルの検証を進められます。

シンプルなコーデックテストを強制し、実際のGPUエンジンの動作を確認する

動作確認済みのH.264またはHEVCサンプルを1つ用意し、字幕やHDRトーンマッピングを使わずに動画のトランスコードを強制してください。ダッシュボードの状態、FFmpegのコマンド、トランスコード速度、CPU使用率、GPUのデコードまたはエンコードエンジンの動作を記録します。

メディアサーバーがハードウェアサポートを報告していても、VA-APIデバイスが自動で正しく選択されないことがあります。Jellyfinの問題報告には、デバイスを明示的に指定したことで、FFmpegがアクセラレーション経路を検出できるかどうかが変わった事例が記録されています。

可能であれば、デコードとエンコードを個別にテストしてください。基本的なコーデックは動作するのに特定のコーデックだけが失敗する場合、iGPUは利用可能ですが、そのプロファイル、ファームウェア機能、ドライバーパス、またはフィルターがサポートされていません。高度なトーンマッピングの失敗だけで、GPU全体が認識されていないと判断しないでください。

以前のカーネルを使って条件をそろえて比較する

PCI検出、レンダーノード、またはホスト側のVA-APIが新しいカーネルでのみ失敗する場合は、コンテナイメージ、メディアサーバーのバージョン、ユーザー空間の設定を変更せずに、インストール済みの以前のカーネルで起動してください。

Jellyfinのトラブルシューティング事例では、カーネル変更後に障害が発生したと疑われる場合、原因を見分ける最も簡単な方法として、以前のカーネルに戻すことを推奨しています。重要なのはカーネルを条件をそろえて比較することであり、ロールバックを恒久的な解決策として扱うことではありません。

現在のカーネルでiGPUがPCI上に表示され、意図したドライバーが割り当てられ、正しいレンダーノードが作成され、VA-APIが初期化され、コンテナ内でデバイスが公開され、実際のコーデックテストでハードウェアアクセラレーションが動作すれば、検証は完了です。以前のカーネルでしか動作しない場合は、カーネル、ファームウェア、またはメディアドライバーのリグレッションを特定する間、一時的な起動オプションとして残しておきましょう。

サポートとヒント

続きを読む

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.