зеркало из https://github.com/microsoft/nni.git
217 строки
6.7 KiB
ReStructuredText
217 строки
6.7 KiB
ReStructuredText
.. acdfab53c8209a53709a5bdca72d29b2
|
||
|
||
在 Windows 上安装
|
||
==================
|
||
|
||
先决条件
|
||
-----------
|
||
|
||
|
||
*
|
||
Python 3.6（或以上）64 位。 在 Windows 上推荐使用 `Anaconda <https://www.anaconda.com/products/individual>`__ 或 `Miniconda <https://docs.conda.io/en/latest/miniconda.html>`__ 来管理多个 Python 环境。
|
||
|
||
*
|
||
如果是新安装的 Python 环境，需要安装 `Microsoft C++ Build Tools <https://visualstudio.microsoft.com/visual-cpp-build-tools/>`__ 来支持 NNI 的依赖项，如 ``scikit-learn``。
|
||
|
||
.. code-block:: bat
|
||
|
||
pip install cython wheel
|
||
|
||
*
|
||
安装 git 用于验证安装。
|
||
|
||
安装 NNI
|
||
-----------
|
||
|
||
大多数情况下，可以从 pip 包安装和升级 NNI。 这样既方便又快捷。
|
||
|
||
如果对某个或最新版本的代码感兴趣，可通过源代码安装 NNI。
|
||
|
||
如果要为 NNI 贡献代码，参考 `设置开发环境 <SetupNniDeveloperEnvironment.rst>`__。
|
||
|
||
|
||
*
|
||
从 pip 包安装
|
||
|
||
.. code-block:: bat
|
||
|
||
python -m pip install --upgrade nni
|
||
|
||
*
|
||
从源代码安装
|
||
|
||
.. code-block:: bat
|
||
|
||
git clone -b v2.6 https://github.com/Microsoft/nni.git
|
||
cd nni
|
||
python -m pip install -U -r dependencies/setup.txt
|
||
python -m pip install -r dependencies/develop.txt
|
||
python setup.py develop
|
||
|
||
验证安装
|
||
-------------------
|
||
|
||
*
|
||
克隆源代码中的示例。
|
||
|
||
.. code-block:: bat
|
||
|
||
git clone -b v2.6 https://github.com/Microsoft/nni.git
|
||
|
||
*
|
||
运行 MNIST 示例。
|
||
|
||
.. code-block:: bat
|
||
|
||
nnictl create --config nni\examples\trials\mnist-pytorch\config_windows.yml
|
||
|
||
注意：如果熟悉其它框架，可选择 ``examples\trials`` 目录下对应的示例。 需要将示例 YAML 文件中 Trial 命令的 ``python3`` 改为 ``python``，这是因为默认安装的 Python 可执行文件是 ``python.exe``，没有 ``python3.exe``。
|
||
|
||
*
|
||
在命令行中等待输出 ``INFO: Successfully started experiment!`` 。 此消息表明实验已成功启动。 通过命令行输出的 Web UI url 来访问 Experiment 的界面。
|
||
|
||
.. code-block:: text
|
||
|
||
INFO: Starting restful server...
|
||
INFO: Successfully started Restful server!
|
||
INFO: Setting local config...
|
||
INFO: Successfully set local config!
|
||
INFO: Starting experiment...
|
||
INFO: Successfully started experiment!
|
||
-----------------------------------------------------------------------
|
||
The experiment id is egchD4qy
|
||
The Web UI urls are: http://223.255.255.1:8080 http://127.0.0.1:8080
|
||
-----------------------------------------------------------------------
|
||
|
||
You can use these commands to get more information about the experiment
|
||
-----------------------------------------------------------------------
|
||
commands description
|
||
1. nnictl experiment show show the information of experiments
|
||
2. nnictl trial ls list all of trial jobs
|
||
3. nnictl top monitor the status of running experiments
|
||
4. nnictl log stderr show stderr log content
|
||
5. nnictl log stdout show stdout log content
|
||
6. nnictl stop stop an experiment
|
||
7. nnictl trial kill kill a trial job by id
|
||
8. nnictl --help get help information about nnictl
|
||
-----------------------------------------------------------------------
|
||
|
||
|
||
* 在浏览器中打开 ``Web UI url``，可看到下图的实验详细信息，以及所有的尝试任务。 查看 `这里 <../Tutorial/WebUI.rst>`__ 的更多页面。
|
||
|
||
|
||
.. image:: ../../img/webui_overview_page.png
|
||
:target: ../../img/webui_overview_page.png
|
||
:alt: overview
|
||
|
||
|
||
|
||
.. image:: ../../img/webui_trialdetail_page.png
|
||
:target: ../../img/webui_trialdetail_page.png
|
||
:alt: detail
|
||
|
||
|
||
系统需求
|
||
-------------------
|
||
|
||
以下是 NNI 在 Windows 上的最低配置，推荐使用 Windows 10 1809 版。 由于程序变更，NNI 的最低配置会有所更改。
|
||
|
||
.. list-table::
|
||
:header-rows: 1
|
||
:widths: auto
|
||
|
||
* -
|
||
- 推荐配置
|
||
- 最低配置
|
||
* - **操作系统**
|
||
- Windows 10 1809 或更高版本
|
||
-
|
||
* - **CPU**
|
||
- Intel® Core™ i5 或 AMD Phenom™ II X3 或更高配置
|
||
- Intel® Core™ i3 或 AMD Phenom™ X3 8650
|
||
* - **GPU**
|
||
- NVIDIA® GeForce® GTX 660 或更高配置
|
||
- NVIDIA® GeForce® GTX 460
|
||
* - **内存**
|
||
- 6 GB
|
||
- 4 GB
|
||
* - **存储**
|
||
- 30 GB 可用的磁盘空间
|
||
-
|
||
* - **网络**
|
||
- 宽带连接
|
||
-
|
||
* - **分辨率**
|
||
- 1024 x 768 以上
|
||
-
|
||
|
||
|
||
常见问答
|
||
------------
|
||
|
||
安装 NNI 时出现 simplejson 错误
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
确保安装了 C++ 14.0 编译器。
|
||
|
||
..
|
||
|
||
building 'simplejson._speedups' extension error: [WinError 3] The system cannot find the path specified
|
||
|
||
|
||
在命令行或 PowerShell 中，Trial 因为缺少 DLL 而失败
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
此错误因为缺少 LIBIFCOREMD.DLL 和 LIBMMD.DLL 文件，且 SciPy 安装失败。 使用 Anaconda 或 Miniconda 和 Python（64位）可解决。
|
||
|
||
..
|
||
|
||
ImportError: DLL load failed
|
||
|
||
|
||
Web 界面上的 Trial 错误
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
检查 Trial 日志文件来了解详情。
|
||
|
||
如果存在 stderr 文件，也需要查看其内容。 两种可能的情况是：
|
||
|
||
|
||
* 忘记将 Experiment 配置的 Trial 命令中的 ``python3`` 改为 ``python``。
|
||
* 忘记安装 Experiment 的依赖，如 TensorFlow，Keras 等。
|
||
|
||
无法在 Windows 上使用 BOHB
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
确保安装了 C ++ 14.0 编译器然后尝试运行 ``pip install nni[BOHB]`` 来安装依赖项。
|
||
|
||
Windows 上不支持的 Tuner
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
当前不支持 SMAC，原因可参考 `此问题 <https://github.com/automl/SMAC3/issues/483>`__。
|
||
|
||
用 Windows 作为远程节点
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
参考 `远程模式 <../TrainingService/RemoteMachineMode.rst>`__.
|
||
|
||
安装时出现 Segmentation Fault (core dumped)
|
||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
||
参考 `常见问题 <FAQ.rst>`__。
|
||
|
||
更多
|
||
---------------
|
||
|
||
|
||
* `概述 <../Overview.rst>`__
|
||
* `如何使用命令行工具 nnictl <Nnictl.rst>`__
|
||
* `如何使用 NNIBoard <WebUI.rst>`__
|
||
* `定义搜索空间 <SearchSpaceSpec.rst>`__
|
||
* `定义实验配置 <ExperimentConfig.rst>`__
|
||
* `如何在本机运行 Experiment (支持多 GPU 卡)？ <../TrainingService/LocalMode.rst>`__
|
||
* `如何在多机上运行 Experiment？ <../TrainingService/RemoteMachineMode.rst>`__
|
||
* `如何在 OpenPAI 上运行 Experiment？ <../TrainingService/PaiMode.rst>`__
|
||
* `如何通过 Kubeflow 在 Kubernetes 上运行 Experiment？ <../TrainingService/KubeflowMode.rst>`__
|
||
* `如何通过 FrameworkController 在 Kubernetes 上运行 Experiment？ <../TrainingService/FrameworkControllerMode.rst>`__
|