OpenVINO™ のインストールと構成のトラブルシューティング・ガイド

このガイドでは、OpenVINO™ のインストールおよび構成中に発生する可能性のある問題に対する一般的なトラブルシューティングの手順と解決策を説明します。OpenVINO に関するサポートトピックの包括的なデータベースについては、次の場所にアクセスしてください:
OpenVINO™ ツールキットのサポート
中国のユーザー向けの PIP 経由のインストールに関するエラー

中国のユーザーは、OpenVINO™ のインストール中に PIP 経由でソースをダウンロードするときにエラーが発生する可能性があります。Python pip コマンドで -i パラメーターを使用してダウンロード・ソースを追加します。
例:

pip install openvino-dev -i https://mirrors.aliyun.com/pypi/simple/

上記の URL が https ではなく http である場合、--trusted-host パラメーターを使用します。次のコマンドで、特定のフレームワークをインストールすることもできます。
例: 

pip install openvino-dev[tensorflow2] -i https://mirrors.aliyun.com/pypi/simple/
Docker から Linux* に OpenVINO をインストールする際の問題

Docker を使用したインストール中にプロキシーの問題が発生した場合は、Docker のプロキシー設定をセットアップする必要があります。詳細については Docker ガイドを参照してください。

OpenVINO ランタイムと開発ツールのバージョンを確認する

OpenVINO ランタイムのバージョンを確認するには、次のコマンドを使用します。

from openvino.runtime import get_version
get_version()
Python と PIP のバージョンを確認する

Python のバージョンを確認するには、python -VV または python --version を実行します。サポートされる Python バージョンは 64 ビットの 3.8 ～ 3.11 です。Python のバージョンが要件を満たしていない場合は、Python を更新します。

  • Windows* では、問題が発生する可能性があるため、Windows Store* から Python をインストールしないでください。公式ウェブサイトから Python をインストールすることを強く推奨します。

  • Linux* および macOS* システムでは、公式ウェブサイトから適切な Python バージョンをダウンロードしてインストールします。バージョンの選択の詳細については、Python 入門ガイドを参照してください。macOS* 10.x には Python 2.7 がインストールされていますが、これはサポートされていないため、公式ウェブサイトから Python をインストールする必要があります。

PIP は、最新バージョンがインストールされていることを確認してください。PIP のバージョンを確認してアップグレードするには、次のコマンドを実行します。

python -m pip install --upgrade pip
環境変数が正しく設定されていることを確認する

  • すでにアーカイブファイルから OpenVINO をインストールしている Python 開発者が、現在 PIP で OpenVINO をインストールしている場合は、.bashrc からすべての PATH 設定と setupvars を含む行を削除します。PIP を使用して仮想環境に OpenVINO をインストールした場合は、環境変数を設定する必要がありません。

  • すでに OpenVINO をインストールしたことがある環境では、setupvars に PATH /.bashrc または Windows 環境変数に追加されている可能性があります。環境を再起動すると、次のような情報が表示されるはずです。

    [setupvars.sh] OpenVINO™ environment initialized

  • 上記の情報が表示されない場合は、PATH 変数が正しく構成されていない可能性があります。正しい <INSTALL_DIR> を設定しているか、または正しいディレクトリーでアクティブ化しようとしているか確認してください。

  • .bashrc ファイルに追加した場合は、コマンドの構文が正しいこと、およびファイルが ~/.bashrc フォルダーにあることを確認してください。

OpenVINO が正しくインストールされていることを確認する

  • Python 開発者が OpenVINO の正しいインストールを確認するには、次のコマンドを使用します。

    python -c "from openvino import Core; print(Core().available_devices)"

    OpenVINO が正常にインストールされていると、利用可能なデバイスのリストが表示されます。

  • アーカイブファイルから OpenVINO ランタイムをインストールした場合は、Windows* システムのアプリと機能で “openvino” を検索するか、Linux* のインストール・ディレクトリーをチェックして OpenVINO が存在するか確認できます。

  • APT から OpenVINO ランタイムをインストールした場合、apt list --installed | grep openvino コマンドを使用して、インストールされている OpenVINO パッケージを一覧表示します。

  • YUM から OpenVINO ランタイムをインストールした場合、yum list installed 'openvino*' コマンドを使用して、インストールされている OpenVINO パッケージを一覧表示します。

GPU ドライバーがインストールされていることを確認する

インテル® GPU など別のハードウェアで OpenVINO を使用するには、追加の構成が必要になる場合があります。GPU の追加構成で説明されているように、推論に使用するデバイスに必要なドライバーがインストールされていることを確認してください。

ファイアウォールとネットワークの設定を確認する

ファイアウォールとネットワーク設定が正しく構成されていることを確認します。例えば、システム全体のプロキシー設定を構成し、プロキシーの背後で PIP を使用するオプションを指定することを検討してください。

pip install --proxy http://address:port --trusted-host pypi.org openvino

特定の問題については、上記の「中国のユーザー向けの PIP 経由のインストールに関するエラー」および 「Docker から Linux* に OpenVINO をインストールする際の問題」の質問を参照してください。