トラブルシュート
デバッグ
インストール中、インストーラスクリプトはすべての操作を記録したログを作成します。これは後で参照したり、問題の診断用に配信スペシャリストに提供したりできます。最新のログはルートディレクトリのinstall_miniprem.logというファイルに保存され、古いログはlogsディレクトリに日付と時刻を含むファイル名で移動されます。
レンダラーアプリケーションの実行やセッションの開始に問題がある場合、次のコマンドでログを確認できます:
docker compose logs -f renny必要に応じて、セッションのJavaScriptコンソールログも取得してください。
フレームレートに問題がある場合
フ簡単な確認方法としてはtopコマンドを実行し、CPUとメモリの使用量を確認することです。さらに、セッション実行中にnvidia-smiを実行し、GPUメモリとGPU利用率のメトリクスを確認します。
デジタルヒューマンが起動するが応答しない場合
cd ”dockerのディレクトリ”configuration.dat の内容を確認する（cat、nano、vimを使用）：
TenantIDはUneeQ管理ポータルから入手できます。 JWSSecretはAPIキーです。
{
"Server": "prod-global",
"TenantId": "3f3122-5555-5555-o5o5o-99aEXAMPLE7823",
"JWSSecret": "MM99EXAMPLEXi3N/CZ3r3h32EXAMPLEq9iydXFKwuNNUwW0g9vmDRBxQ2c3kO0C9M/"
}
確認するには、アドミンパネルにアクセスし、テナント名をクリックする前に、テナントの右側にある鉛筆/編集アイコンをクリックしてください。
configuration.dat 内の Tenant ID が一致していることを確認してください。
JWSSecretはAPIキーで、同じ管理ページのセキュリティセクションまでスクロールすることで確認できます。
デジタルヒューマンが全く起動しない場合 / Audio2Faceエラー
Nvidia / Audio2Faceのトラブルシューティング
MiniPremを起動する際に、audio2faceに関連するエラーが表示される場合：GPUカードまたはドライバーに問題がある可能性があります。
Container audio2face_with_emotion Errorカードとドライバーのステータス確認
カードが物理的に設置されているか確認：
lspci | grep -i nvidiaドライバーがインストールされているか確認：出力がない場合、NVIDIAモジュールがロードされていません。
dpkg -l | grep nvidia-driver
lsmod | grep nvidiaドライバーが正常に動作しているか確認：
nvidia-smi通常のnvidia-smiの出力は以下のようになります：
+-----------------------------------------------------------------------------+
|NVIDIA-SMI 545.XX.XX Driver Version: 545.XX.XX CUDA Version: 12.X |
+-----------------------------------------------------------------------------+
| GPU Name Persistence-M| Bus-Id Disp.A | Volatile Uncorr. ECC |
| Fan Temp Perf Pwr:Usage/Cap| Memory-Usage | GPU-Util Compute M. |
| | | MIG M. |
|===============================+======================+======================|
| 0 NVIDIA GeForce ... Off | 00000000:01:00.0 On | N/A |
| 30% 45C P8 16W / 200W| 456MiB / 8192MiB | 2% Default |
| | | N/A |
+-----------------------------------------------------------------------------+確認すべき重要な点：
- ドライバーバージョン（最上行）
- GPU名
コマンドが見つからないというエラーが出た場合、NVIDIAドライバーがインストールされていないことを意味します。
「NVIDIA-SMI has failed」というエラーが出た場合、通常以下のいずれかを意味します：
- ドライバーが正しくロードされていない
- セキュアブートとの競合がある
- ドライバーが現在のカーネルと互換性がない
Nvidia ドライバーの（再）インストール
まず Ubuntu Linux を更新し、利用可能な最新の NVIDIA ドライバーをインストールします。
sudo apt update
sudo apt install nvidia-driver再起動する前に、NVIDIA ドライバーを手動で読み込んで確認します：
sudo modprobe nvidia次の特定のメッセージが表示された場合：
ERROR: could not insert 'nvidia': Key was rejected by serviceこの問題は、システムが NVIDIA モジュールを拒否していることを示し、セキュアブート/UEFI が有効になっている可能性があります。セキュアブートを無効にするには、再起動時に BIOS にアクセスする必要があります（DEL や F12 などのキーを押して BIOS にアクセス）。
通常、NVIDIA のドライバーは公式の Ubuntu リポジトリからデジタル署名されていますが、カーネルの更新や変更によって GPU ドライバーが読み込まれないことがあります。
セキュアブートを無効にした後、再度 NVIDIA ドライバーが読み込まれているか確認してください：出力がない場合、NVIDIA モジュールが読み込まれていません。
lsmod | grep nvidiaデジタルヒューマンが読み込まれるが話さない場合
コンテナ情報を取得：Renny のコンテナ ID をメモする
docker psログを確認： "TTS" を検索し、テキスト読み上げ関連の問題を確認します。TTS に関する記載の前後5行程度を確認します。
[CONTAINER_ID] を Renny のコンテナ ID に置き換えます
docker logs -f [CONTAINER_ID]最終更新日 February 12, 2025