From a86c8a2157038053c6501cd51b59b8a90113f8b1 Mon Sep 17 00:00:00 2001 From: msmykx <101244365+msmykx-intel@users.noreply.github.com> Date: Wed, 22 Mar 2023 10:11:58 +0100 Subject: [PATCH 1/4] troubleshooting --- .../installing-openvino-yocto.md | 2 +- docs/install_guides/troubleshooting-issues.md | 71 +++++++++------ docs/install_guides/troubleshooting-steps.md | 86 +++++++++++-------- docs/install_guides/troubleshooting.md | 12 ++- 4 files changed, 100 insertions(+), 71 deletions(-) diff --git a/docs/install_guides/installing-openvino-yocto.md b/docs/install_guides/installing-openvino-yocto.md index 2aa69d56d3db52..479d03f2e87c49 100644 --- a/docs/install_guides/installing-openvino-yocto.md +++ b/docs/install_guides/installing-openvino-yocto.md @@ -116,7 +116,7 @@ If the image build is successful, it will return the list of packages as below: Additional Resources #################### -- :ref:`Troubleshooting Guide ` +- :ref:`Troubleshooting Guide ` - `Yocto Project `__ - official documentation webpage - `BitBake Tool `__ - `Poky `__ diff --git a/docs/install_guides/troubleshooting-issues.md b/docs/install_guides/troubleshooting-issues.md index fd539d6ea64845..74dd075b6987e1 100644 --- a/docs/install_guides/troubleshooting-issues.md +++ b/docs/install_guides/troubleshooting-issues.md @@ -1,52 +1,71 @@ # Issues & Solutions for OpenVINO™ Installation & Configuration {#openvino_docs_get_started_guide_troubleshooting_issues} +@sphinxdirective + This page lists issues that you may encounter during the installation and configuration of OpenVINO™, as well as their possible solutions. -## Errors with Installing via PIP for Users in China +.. _install_for_prc: + +Errors with Installing via PIP for Users in China +################################################# Users in China might encounter errors while downloading sources via PIP during OpenVINO™ installation. To resolve the issues, try one of the following options: * Add the download source using the ``-i`` parameter with the Python ``pip`` command. For example: - ``` sh - pip install openvino-dev -i https://mirrors.aliyun.com/pypi/simple/ - ``` + .. code-block:: sh + + pip install openvino-dev -i https://mirrors.aliyun.com/pypi/simple/ + Use the ``--trusted-host`` parameter if the URL above is ``http`` instead of ``https``. You can also run the following command to install specific framework. For example: - ``` - pip install openvino-dev[tensorflow2] -i https://mirrors.aliyun.com/pypi/simple/ - ``` + .. code-block:: sh + + pip install openvino-dev[tensorflow2] -i https://mirrors.aliyun.com/pypi/simple/ + * For C++ developers, if you have installed OpenVINO Runtime via APT, YUM, or the archive file, and then installed OpenVINO Development Tools via PyPI, you may run into issues. To resolve that, install the components in ``requirements.txt`` by using the following command: - ``` sh - pip install -r /tools/requirements.txt - ``` - For APT and YUM users, replace the `INSTALL_DIR` with `/usr/share/openvino`. + + .. code-block:: sh + + pip install -r /tools/requirements.txt + + For APT and YUM users, replace the ``INSTALL_DIR`` with ``/usr/share/openvino``. -## Issues with Installing OpenVINO on Linux from Docker +Issues with Installing OpenVINO on Linux from Docker +#################################################### -### Proxy Issues +.. _proxy-issues: -If you met proxy issues during the installation with Docker, you need set up proxy settings for Docker. See the [Docker guide](https://docs.docker.com/network/proxy/) for more details. +Proxy Issues +++++++++++++ +If you met proxy issues during the installation with Docker, you need set up proxy settings for Docker. See the `Docker guide `__ for more details. -@anchor yocto-install-issues -## Issues with Creating a Yocto Image for OpenVINO +.. _yocto_install_issues: -### Error while adding "meta-intel" layer +Issues with Creating a Yocto Image for OpenVINO +############################################### -When using the `bitbake-layers add-layer meta-intel` command, the following error might occur: -```sh -NOTE: Starting bitbake server... -ERROR: The following required tools (as specified by HOSTTOOLS) appear to be unavailable in PATH, please install them in order to proceed: chrpath diffstat pzstd zstd -``` +Error while adding "meta-intel" layer ++++++++++++++++++++++++++++++++++++++ -To resolve the issue, install the `chrpath diffstat zstd` tools: +When using the ``bitbake-layers add-layer meta-intel`` command, the following error might occur: + +.. code-block:: sh + + NOTE: Starting bitbake server... + ERROR: The following required tools (as specified by HOSTTOOLS) appear to be unavailable in PATH, please install them in order to proceed: chrpath diffstat pzstd zstd + + +To resolve the issue, install the ``chrpath diffstat zstd`` tools: + +.. code-block:: sh + + sudo apt-get install chrpath diffstat zstd -```sh -sudo apt-get install chrpath diffstat zstd -``` +@endsphinxdirective diff --git a/docs/install_guides/troubleshooting-steps.md b/docs/install_guides/troubleshooting-steps.md index ec4049f445325b..352ea4f44ed4bf 100644 --- a/docs/install_guides/troubleshooting-steps.md +++ b/docs/install_guides/troubleshooting-steps.md @@ -1,56 +1,68 @@ # Troubleshooting Steps for OpenVINO™ Installation and Configurations {#openvino_docs_get_started_guide_troubleshooting_steps} +@sphinxdirective + If you run into issues while installing or configuring OpenVINO™, you can try the following methods to do some quick checks first. -## Check the versions of OpenVINO Runtime and Developement Tools +Check the versions of OpenVINO Runtime and Developement Tools +############################################################# * To check the version of OpenVINO Development Tools, use the following command: - ```sh - mo --version - ``` + + .. code-block:: sh + + mo --version + * To check the version of OpenVINO Runtime, use the following code: - ```sh - from openvino.runtime import get_version get_version() - ``` + + .. code-block:: sh + + from openvino.runtime import get_version get_version() + -## Check the versions of Python and PIP +Check the versions of Python and PIP +#################################### -To check your Python version, run `python -VV` or `python --version`. The supported Python versions should be 64-bit and between 3.7 and 3.10. If you are using Python 3.6, you are recommended to upgrade the version to 3.7 or higher. +To check your Python version, run ``python -VV`` or ``python --version``. The supported Python versions should be 64-bit and between 3.7 and 3.10. If you are using Python 3.6, you are recommended to upgrade the version to 3.7 or higher. If your Python version does not meet the requirements, update Python: -* For Windows, **do not install Python from a Windows Store** as it can cause issues. You are highly recommended to install Python from . -* For Linux and macOS systems, download and install a proper Python version from . See the [Python Beginners' Guide](https://wiki.python.org/moin/BeginnersGuide/Download) for more information on selecting a version. Note that macOS 10.x comes with python 2.7 installed, which is not supported, so you must install Python from the official website. +* For Windows, **do not install Python from a Windows Store** as it can cause issues. You are highly recommended to install Python from `official website `__ . +* For Linux and macOS systems, download and install a proper Python version from `official website `__ . See the `Python Beginners' Guide `__ for more information on selecting a version. Note that macOS 10.x comes with python 2.7 installed, which is not supported, so you must install Python from the official website. For PIP, make sure that you have installed the latest version. To check and upgrade your PIP version, run the following command: -```sh -python -m pip install --upgrade pip -``` + +.. code-block:: sh + + python -m pip install --upgrade pip - -## Check if required external dependencies are installed (for pre-2022.2 releases) +Check if required external dependencies are installed (for pre-2022.2 releases) +############################################################################### For OpenVINO releases prior to 2022.2: -- If you are using Ubuntu or RHEL 8 systems, and installed OpenVINO Runtime via the archive file, APT, or YUM repository, and then decided to [install OpenVINO Development Tools](installing-model-dev-tools.md), make sure that you **Install External Software Dependencies** first by following the steps in the corresponding installation pages. -- For C++ developers with Windows systems, make sure that Microsoft Visual Studio 2019 with MSBuild and CMake 3.14 or higher (64-bit) are installed. While installing Microsoft Visual Studio 2019, make sure that you have selected **Desktop development with C++** in the **Workloads** tab. If not, launch the installer again to select that option. For more information on modifying the installation options for Microsoft Visual Studio, see its [official support page](https://docs.microsoft.com/en-us/visualstudio/install/modify-visual-studio?view=vs-2019). -## Check if environment variables are set correctly +- If you are using Ubuntu or RHEL 8 systems, and installed OpenVINO Runtime via the archive file, APT, or YUM repository, and then decided to :doc:`install OpenVINO Development Tools `, make sure that you **Install External Software Dependencies** first by following the steps in the corresponding installation pages. +- For C++ developers with Windows systems, make sure that Microsoft Visual Studio 2019 with MSBuild and CMake 3.14 or higher (64-bit) are installed. While installing Microsoft Visual Studio 2019, make sure that you have selected **Desktop development with C++** in the **Workloads** tab. If not, launch the installer again to select that option. For more information on modifying the installation options for Microsoft Visual Studio, see its `official support page `__ . -- For Python developers, if you previously installed OpenVINO using the archive file, and are now installing OpenVINO using PIP, remove all the PATH settings and the lines with `setupvars` from `.bashrc`. Note that if you installed OpenVINO with PIP in a virtual environment, you don't need to set any environment variables. -- If you have installed OpenVINO before, you probably have added `setupvars` to your `PATH /.bashrc` or Windows environment variables. After restarting your environment, you should see similar information as below: -```sh -[setupvars.sh] OpenVINO™ environment initialized -``` - - If you don't see the information above, your PATH variables may be configured incorrectly. Check if you have typed the correct or you are trying to activate in the correct directory. - - If you added it to a `.bashrc` file, make sure that the command is correctly written and the file is found in the `~/.bashrc` folder. +Check if environment variables are set correctly +################################################ -## Verify that OpenVINO is correctly installed +- For Python developers, if you previously installed OpenVINO using the archive file, and are now installing OpenVINO using PIP, remove all the PATH settings and the lines with ``setupvars`` from ``.bashrc``. Note that if you installed OpenVINO with PIP in a virtual environment, you don't need to set any environment variables. +- If you have installed OpenVINO before, you probably have added ``setupvars`` to your ``PATH /.bashrc`` or Windows environment variables. After restarting your environment, you should see similar information as below: -@sphinxdirective +.. code-block:: sh + + [setupvars.sh] OpenVINO™ environment initialized + + - If you don't see the information above, your PATH variables may be configured incorrectly. Check if you have typed the correct or you are trying to activate in the correct directory. + - If you added it to a ``.bashrc`` file, make sure that the command is correctly written and the file is found in the ``~/.bashrc`` folder. + +Verify that OpenVINO is correctly installed +########################################### * For Python developers, to verify if OpenVINO is correctly installed, use the following command: @@ -66,24 +78,24 @@ For OpenVINO releases prior to 2022.2: * If you installed OpenVINO Runtime from YUM, use the ``yum list installed 'openvino*'`` command to list the installed OpenVINO packages. -@endsphinxdirective +Check if GPU drvier is installed +################################ -## Check if GPU drvier is installed +:doc:`Additional configurations ` may be required in order to use OpenVINO with different hardware such as Intel® GPUs. -[Additional configurations](configurations-header.md) may be required in order to use OpenVINO with different hardware such as Intel® GPUs. +To run inference on an Intel® GPU, make sure that you have installed the correct GPU driver. To check that, see :doc:`additional configurations for GPU `. -To run inference on an Intel® GPU, make sure that you have installed the correct GPU driver. To check that, see [additional configurations for GPU](configurations-for-intel-gpu.md). - -## Check firewall and network settings +Check firewall and network settings +################################### Make sure that your firewall and network settings are configured correctly. For example, consider configuring system-wide proxy settings and specifying options for using PIP behind the proxy: -@sphinxdirective - .. code-block:: sh pip install --proxy http://address:port --trusted-host pypi.org openvino + +For specific issues, see :doc:`Errors with Installing via PIP for Users in China ` and :doc:`proxy issues with installing OpenVINO on Linux from Docker `. + @endsphinxdirective -For specific issues, see Errors with Installing via PIP for Users in China and proxy issues with installing OpenVINO on Linux from Docker. \ No newline at end of file diff --git a/docs/install_guides/troubleshooting.md b/docs/install_guides/troubleshooting.md index 9963a579978025..99e3fd7ca8ea97 100644 --- a/docs/install_guides/troubleshooting.md +++ b/docs/install_guides/troubleshooting.md @@ -9,16 +9,14 @@ Issues & Solutions Troubleshooting Steps -@endsphinxdirective - -@sphinxdirective .. _troubleshooting guide for install: -@endsphinxdirective - This guide provides general troubleshooting steps and solutions to possible issues that can be encountered while installing and configuring OpenVINO™. -The [Issues & Solutions](./troubleshooting-issues.md) page lists common installation and configuration errors, and their possible solutions. If you encountered a specific error while installing or configuring OpenVINO, check this page to see if there is a solution. +The :doc:`Issues & Solutions ` page lists common installation and configuration errors, and their possible solutions. If you encountered a specific error while installing or configuring OpenVINO, check this page to see if there is a solution. + +The :doc:`Troubleshooting Steps ` page provides a set of instructions for diagnosing and resolving installation and configuration issues. If you had problems during installation and configuration, walk through these steps to try and resolve your issue. + +@endsphinxdirective -The [Troubleshooting Steps](./troubleshooting-steps.md) page provides a set of instructions for diagnosing and resolving installation and configuration issues. If you had problems during installation and configuration, walk through these steps to try and resolve your issue. From 000677b46f29abf0e1baaae54e43973adf20aa94 Mon Sep 17 00:00:00 2001 From: msmykx <101244365+msmykx-intel@users.noreply.github.com> Date: Wed, 22 Mar 2023 10:51:22 +0100 Subject: [PATCH 2/4] fix-1 --- docs/install_guides/troubleshooting-issues.md | 6 +++--- docs/install_guides/troubleshooting-steps.md | 9 +++++---- 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/install_guides/troubleshooting-issues.md b/docs/install_guides/troubleshooting-issues.md index 74dd075b6987e1..46d72bbbde28b7 100644 --- a/docs/install_guides/troubleshooting-issues.md +++ b/docs/install_guides/troubleshooting-issues.md @@ -4,7 +4,7 @@ This page lists issues that you may encounter during the installation and configuration of OpenVINO™, as well as their possible solutions. -.. _install_for_prc: +.. _install_for_prc:: Errors with Installing via PIP for Users in China ################################################# @@ -38,14 +38,14 @@ Users in China might encounter errors while downloading sources via PIP during O Issues with Installing OpenVINO on Linux from Docker #################################################### -.. _proxy-issues: +.. _proxy-issues:: Proxy Issues ++++++++++++ If you met proxy issues during the installation with Docker, you need set up proxy settings for Docker. See the `Docker guide `__ for more details. -.. _yocto_install_issues: +.. _yocto_install_issues:: Issues with Creating a Yocto Image for OpenVINO ############################################### diff --git a/docs/install_guides/troubleshooting-steps.md b/docs/install_guides/troubleshooting-steps.md index 352ea4f44ed4bf..65eeb0cf3a858c 100644 --- a/docs/install_guides/troubleshooting-steps.md +++ b/docs/install_guides/troubleshooting-steps.md @@ -54,9 +54,10 @@ Check if environment variables are set correctly - For Python developers, if you previously installed OpenVINO using the archive file, and are now installing OpenVINO using PIP, remove all the PATH settings and the lines with ``setupvars`` from ``.bashrc``. Note that if you installed OpenVINO with PIP in a virtual environment, you don't need to set any environment variables. - If you have installed OpenVINO before, you probably have added ``setupvars`` to your ``PATH /.bashrc`` or Windows environment variables. After restarting your environment, you should see similar information as below: -.. code-block:: sh - - [setupvars.sh] OpenVINO™ environment initialized + .. code-block:: sh + + [setupvars.sh] OpenVINO™ environment initialized + - If you don't see the information above, your PATH variables may be configured incorrectly. Check if you have typed the correct or you are trying to activate in the correct directory. - If you added it to a ``.bashrc`` file, make sure that the command is correctly written and the file is found in the ``~/.bashrc`` folder. @@ -95,7 +96,7 @@ Make sure that your firewall and network settings are configured correctly. For pip install --proxy http://address:port --trusted-host pypi.org openvino -For specific issues, see :doc:`Errors with Installing via PIP for Users in China ` and :doc:`proxy issues with installing OpenVINO on Linux from Docker `. +For specific issues, see :ref:`Errors with Installing via PIP for Users in China ` and :ref:`proxy issues with installing OpenVINO on Linux from Docker `. @endsphinxdirective From 49dbde14f5f8690cc6c0a2ff26787607adb1358d Mon Sep 17 00:00:00 2001 From: msmykx <101244365+msmykx-intel@users.noreply.github.com> Date: Wed, 22 Mar 2023 11:58:24 +0100 Subject: [PATCH 3/4] code-block fix --- docs/install_guides/troubleshooting-issues.md | 24 ++++++++-------- docs/install_guides/troubleshooting-steps.md | 28 +++++++++---------- 2 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/install_guides/troubleshooting-issues.md b/docs/install_guides/troubleshooting-issues.md index 46d72bbbde28b7..f4c7b745af5856 100644 --- a/docs/install_guides/troubleshooting-issues.md +++ b/docs/install_guides/troubleshooting-issues.md @@ -13,23 +13,23 @@ Users in China might encounter errors while downloading sources via PIP during O * Add the download source using the ``-i`` parameter with the Python ``pip`` command. For example: - .. code-block:: sh - - pip install openvino-dev -i https://mirrors.aliyun.com/pypi/simple/ + .. code-block:: sh + + pip install openvino-dev -i https://mirrors.aliyun.com/pypi/simple/ + + Use the ``--trusted-host`` parameter if the URL above is ``http`` instead of ``https``. + You can also run the following command to install specific framework. For example: - Use the ``--trusted-host`` parameter if the URL above is ``http`` instead of ``https``. - You can also run the following command to install specific framework. For example: - - .. code-block:: sh - - pip install openvino-dev[tensorflow2] -i https://mirrors.aliyun.com/pypi/simple/ + .. code-block:: sh + + pip install openvino-dev[tensorflow2] -i https://mirrors.aliyun.com/pypi/simple/ * For C++ developers, if you have installed OpenVINO Runtime via APT, YUM, or the archive file, and then installed OpenVINO Development Tools via PyPI, you may run into issues. To resolve that, install the components in ``requirements.txt`` by using the following command: - .. code-block:: sh - - pip install -r /tools/requirements.txt + .. code-block:: sh + + pip install -r /tools/requirements.txt For APT and YUM users, replace the ``INSTALL_DIR`` with ``/usr/share/openvino``. diff --git a/docs/install_guides/troubleshooting-steps.md b/docs/install_guides/troubleshooting-steps.md index 65eeb0cf3a858c..fd5f03c73b21d2 100644 --- a/docs/install_guides/troubleshooting-steps.md +++ b/docs/install_guides/troubleshooting-steps.md @@ -9,15 +9,15 @@ Check the versions of OpenVINO Runtime and Developement Tools * To check the version of OpenVINO Development Tools, use the following command: - .. code-block:: sh - - mo --version + .. code-block:: sh + + mo --version * To check the version of OpenVINO Runtime, use the following code: - .. code-block:: sh - - from openvino.runtime import get_version get_version() + .. code-block:: sh + + from openvino.runtime import get_version get_version() Check the versions of Python and PIP @@ -54,13 +54,13 @@ Check if environment variables are set correctly - For Python developers, if you previously installed OpenVINO using the archive file, and are now installing OpenVINO using PIP, remove all the PATH settings and the lines with ``setupvars`` from ``.bashrc``. Note that if you installed OpenVINO with PIP in a virtual environment, you don't need to set any environment variables. - If you have installed OpenVINO before, you probably have added ``setupvars`` to your ``PATH /.bashrc`` or Windows environment variables. After restarting your environment, you should see similar information as below: - .. code-block:: sh - - [setupvars.sh] OpenVINO™ environment initialized - + .. code-block:: sh + + [setupvars.sh] OpenVINO™ environment initialized + - - If you don't see the information above, your PATH variables may be configured incorrectly. Check if you have typed the correct or you are trying to activate in the correct directory. - - If you added it to a ``.bashrc`` file, make sure that the command is correctly written and the file is found in the ``~/.bashrc`` folder. + - If you don't see the information above, your PATH variables may be configured incorrectly. Check if you have typed the correct or you are trying to activate in the correct directory. + - If you added it to a ``.bashrc`` file, make sure that the command is correctly written and the file is found in the ``~/.bashrc`` folder. Verify that OpenVINO is correctly installed ########################################### @@ -91,9 +91,9 @@ Check firewall and network settings Make sure that your firewall and network settings are configured correctly. For example, consider configuring system-wide proxy settings and specifying options for using PIP behind the proxy: - .. code-block:: sh +.. code-block:: sh - pip install --proxy http://address:port --trusted-host pypi.org openvino + pip install --proxy http://address:port --trusted-host pypi.org openvino For specific issues, see :ref:`Errors with Installing via PIP for Users in China ` and :ref:`proxy issues with installing OpenVINO on Linux from Docker `. From b9ece4a778e3ce972db90e165f4059ee1d4168d2 Mon Sep 17 00:00:00 2001 From: msmykx <101244365+msmykx-intel@users.noreply.github.com> Date: Wed, 22 Mar 2023 12:43:12 +0100 Subject: [PATCH 4/4] Update troubleshooting-issues.md --- docs/install_guides/troubleshooting-issues.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/install_guides/troubleshooting-issues.md b/docs/install_guides/troubleshooting-issues.md index f4c7b745af5856..a381f0f46c1517 100644 --- a/docs/install_guides/troubleshooting-issues.md +++ b/docs/install_guides/troubleshooting-issues.md @@ -4,7 +4,7 @@ This page lists issues that you may encounter during the installation and configuration of OpenVINO™, as well as their possible solutions. -.. _install_for_prc:: +.. _install_for_prc: Errors with Installing via PIP for Users in China ################################################# @@ -38,14 +38,14 @@ Users in China might encounter errors while downloading sources via PIP during O Issues with Installing OpenVINO on Linux from Docker #################################################### -.. _proxy-issues:: +.. _proxy-issues: Proxy Issues ++++++++++++ If you met proxy issues during the installation with Docker, you need set up proxy settings for Docker. See the `Docker guide `__ for more details. -.. _yocto_install_issues:: +.. _yocto_install_issues: Issues with Creating a Yocto Image for OpenVINO ###############################################