トラブルシュート

インストール時

ポート競合

ローカルのRedisサービスが6379ポートを使用している場合:

sudo systemctl stop redis-server
# または
sudo kill [PID]

ヘルスチェックの失敗

起動時にヘルスチェックで失敗する場合:

./docker/docker-compose.default.yml

  audio2face_with_emotion:
    healthcheck:
      # test: ["CMD-SHELL", "curl -s <http://localhost:50000/health> | grep -q '\\"status\\":\\"ok\\"' || exit 1"] # コメントアウトする
      test: ["CMD-SHELL", "timeout 2 bash -c '</dev/tcp/localhost/50000' || exit 1"]

  audio2face_controller:
     healthcheck:
      # test: ["CMD-SHELL", "curl -s <http://localhost:52000/health> | grep -q '\\"status\\":\\"ok\\"' || exit 1"] # コメントアウトする
      test: ["CMD-SHELL", "timeout 2 bash -c '</dev/tcp/localhost/52000' || exit 1"]

GPU メモリ不足

フルインストールでGPUメモリが不足する場合、サービスを段階的に起動:

サービスが起動しない場合

  1. Dockerが正常に動作しているか確認

  2. ログを確認して詳細なエラー情報を取得

  3. インストールタイプを確認 インストールタイプは.miniprem_install_typeファイルに保存されます。 MiniPremは2つのインストールタイプをサポートしています:

    • default: 基本的な構成(docker/docker-compose.default.ymlを使用)

    • custom: カスタマイズされた構成(docker/docker-compose.ymlを使用)

  4. 環境変数を確認する。docker/docker-compose.env ファイルに保存されます。

    主な環境変数

デバッグ

インストール中、インストーラスクリプトはすべての操作を記録したログを作成します。これは後で参照したり、問題の診断用に配信スペシャリストに提供したりできます。最新のログはルートディレクトリのinstall_miniprem.logというファイルに保存され、古いログはlogsディレクトリに日付と時刻を含むファイル名で移動されます。

レンダラーアプリケーションの実行やセッションの開始に問題がある場合、次のコマンドでログを確認できます:

必要に応じて、セッションのJavaScriptコンソールログも取得してください。

フレームレートに問題がある場合

フ簡単な確認方法としてはtopコマンドを実行し、CPUとメモリの使用量を確認することです。さらに、セッション実行中にnvidia-smiを実行し、GPUメモリとGPU利用率のメトリクスを確認します。

デジタルヒューマンが全く起動しない場合 / Audio2Faceエラー

NVIDIA / Audio2Faceのトラブルシューティング

MiniPremを起動する際に、audio2faceに関連するエラーが表示される場合:現在のMiniPremはaudio2faceを使用していません。弊社までご連絡頂ければアップグレードいたします。

カードとドライバーのステータス確認

カードが物理的に設置されているか確認:

ドライバーがインストールされているか確認:出力がない場合、NVIDIAモジュールがロードされていません。

ドライバーが正常に動作しているか確認:

通常のnvidia-smiの出力は以下のようになります:

確認すべき重要な点:

  • ドライバーバージョン(最上行)

  • GPU名

コマンドが見つからないというエラーが出た場合、NVIDIAドライバーがインストールされていないことを意味します。

「NVIDIA-SMI has failed」というエラーが出た場合、通常以下のいずれかを意味します:

  • ドライバーが正しくロードされていない

  • セキュアブートとの競合がある

  • ドライバーが現在のカーネルと互換性がない

NVIDIA ドライバーの(再)インストール

まず Ubuntu Linux を更新し、利用可能な最新の NVIDIA ドライバーをインストールします。

再起動する前に、NVIDIA ドライバーを手動で読み込んで確認します:

次の特定のメッセージが表示された場合:

通常、NVIDIA のドライバーは公式の Ubuntu リポジトリからデジタル署名されていますが、カーネルの更新や変更によって GPU ドライバーが読み込まれないことがあります。

h8rzX9Jcldtz-69ZAeIBj_image.webp

セキュアブートを無効にした後、再度 NVIDIA ドライバーが読み込まれているか確認してください:出力がない場合、NVIDIA モジュールが読み込まれていません。

デジタルヒューマンが読み込まれるが話さない場合

コンテナ情報を取得:Renny のコンテナ ID をメモする

ログを確認: "TTS" を検索し、テキスト読み上げ関連の問題を確認します。TTS に関する記載の前後5行程度を確認します。

[CONTAINER_ID] を Renny のコンテナ ID に置き換えます

Flowiseセットアップが失敗する場合

  • Flowiseサービスがポート3000で正常に起動しているか確認

  • ファイアウォールやセキュリティソフトがポートをブロックしていないか確認

最終更新