diff --git a/install/mindspore_ascend310_install_binary_en.md b/install/mindspore_ascend310_install_binary_en.md index ad562c0294811a8d1b41e60501801547463a8e1d..c32e2b55f34fc5b5214337a8d622870381719408 100644 --- a/install/mindspore_ascend310_install_binary_en.md +++ b/install/mindspore_ascend310_install_binary_en.md @@ -12,26 +12,27 @@ -The following describes how to quickly install MindSpore by pip on Linux in the Ascend 310 environment, MindSpore in Ascend 310 only supports inference. +The following describes how to quickly install MindSpore by pip on Linux in the Ascend 310 environment, and MindSpore in Ascend 310 only supports inference. ## Checking System Environment Information - Ensure that the 64-bit operating system is installed and the [glibc](https://www.gnu.org/software/libc/)>=2.17, where Ubuntu 18.04/CentOS 7.6/EulerOS 2.8 are verified. -- Ensure that right version [GCC 7.3.0](https://ftp.gnu.org/gnu/gcc/gcc-7.3.0/gcc-7.3.0.tar.gz) is installed. +- Ensure that [GCC 7.3.0](https://ftp.gnu.org/gnu/gcc/gcc-7.3.0/gcc-7.3.0.tar.gz) is installed. - Ensure that [GMP 6.1.2](https://gmplib.org/download/gmp/gmp-6.1.2.tar.xz) is installed. - Ensure that [CMake 3.18.3 or later](https://cmake.org/download/) is installed. - - After installation, add the path of CMake to the system environment variables. -- Ensure that Python 3.7.5 or 3.9.0 is installed. If not installed, download and install Python from: +After installation, add the path of CMake to the system environment variables. + +- Ensure that Python 3.7.5 or 3.9.0 is installed. If not installed or Python of other versions installed, download and install Python from: - Python 3.7.5 (64-bit): [Python official website](https://www.python.org/ftp/python/3.7.5/Python-3.7.5.tgz) or [HUAWEI CLOUD](https://mirrors.huaweicloud.com/python/3.7.5/Python-3.7.5.tgz). - Python 3.9.0 (64-bit): [Python official website](https://www.python.org/ftp/python/3.9.0/Python-3.9.0.tgz) or [HUAWEI CLOUD](https://mirrors.huaweicloud.com/python/3.9.0/Python-3.9.0.tgz). - Ensure that the Ascend AI processor software package (Ascend Data Center Solution 21.0.3) are installed, please refer to the [Installation Guide](https://support.huawei.com/enterprise/zh/doc/EDOC1100226552?section=j003). - - Ensure that you have permissions to access the installation path `/usr/local/Ascend` of the Ascend AI Processor software package. If not, ask the user root to add you to a user group to which `/usr/local/Ascend` belongs. For details about the configuration, see the description document in the software package. + - Ensure that you have permissions to access the installation path `/usr/local/Ascend` of the Ascend AI Processor software package. If not, ask the user root to add you to a user group to which `/usr/local/Ascend` belongs. - Install the .whl package provided with the Ascend AI Processor software package. The .whl package is released with the software package. After the software package is upgraded, you need to reinstall the .whl package. ```bash @@ -89,19 +90,19 @@ Create a directory to store the sample code project, for example, `/home/HwHiAiU ```text └─ascend310_single_op_sample - ├── CMakeLists.txt // Build script + ├── CMakeLists.txt // Compile script ├── README.md // Usage description ├── main.cc // Main function └── tensor_add.mindir // MindIR model file ``` -Go to the directory of the sample project and change the path based on the actual requirements. +Go to the directory of the sample project, and change the path based on the actual requirements. ```bash cd /home/HwHiAiUser/Ascend/ascend-toolkit/20.0.RC1/acllib_linux.arm64/sample/acl_execute_model/ascend310_single_op_sample ``` -Build a project by referring to `README.md`, modify`{mindspore_path}`which specifies the absolute path to MindSpore. +Build a project by referring to `README.md`, and `{mindspore_path}` represents the absolute path of the location where the MindSpore binary package is located, and is replaced according to the actual situation. ```bash cmake . -DMINDSPORE_PATH={mindspore_path} diff --git a/install/mindspore_ascend_install_conda_en.md b/install/mindspore_ascend_install_conda_en.md index f005fa35350d731fb2be53a418f534b6c58c5d95..7c54e243f8571f911e150010dd335101d213032e 100644 --- a/install/mindspore_ascend_install_conda_en.md +++ b/install/mindspore_ascend_install_conda_en.md @@ -42,7 +42,7 @@ This document describes how to quickly install MindSpore in a Linux system with pip install /usr/local/Ascend/ascend-toolkit/latest/fwkacllib/lib64/hccl-{version}-py3-none-any.whl ``` - - If the Ascend AI processor software package is upgraded, the .whl package also needs to be reinstalled, first uninstall the original installation package, and then refer to the above command to reinstall. + - If the Ascend AI processor software package is upgraded, the .whl package also needs to be reinstalled. Uninstall the original installation package, and reinstall the package by referring to the above command. ```bash pip uninstall te topi hccl -y @@ -50,7 +50,7 @@ This document describes how to quickly install MindSpore in a Linux system with ## Creating and Accessing the Conda Virtual Environment -Create a Conda virtual environment based on the Python version you want to use and go to the virtual environment. +Create a Conda virtual environment based on the Python version you want to use, and go to the virtual environment. If you want to use Python 3.7.5: ```bash @@ -94,7 +94,7 @@ In the preceding information: ## Configuring Environment Variables -**If Ascend AI processor software is installed in a non-default path**, after MindSpore is installed, export runtime-related environment variables. `/usr/local/Ascend` in the following command `LOCAL_ASCEND=/usr/local/Ascend` denotes the installation path of the software package, please replace it as your actual installation path. +**If Ascend AI processor software is installed in a non-default path**, after MindSpore is installed, export runtime-related environment variables. `/usr/local/Ascend` in the following command `LOCAL_ASCEND=/usr/local/Ascend` denotes the installation path of the software package, and you need to replace it as the actual installation path. ```bash # control log level. 0-DEBUG, 1-INFO, 2-WARNING, 3-ERROR, 4-CRITICAL, default level is WARNING. @@ -164,7 +164,7 @@ It means MindSpore has been installed successfully. ## Version Update -Using the following command if you need to update the MindSpore version: +Use the following command if you need to update the MindSpore version: ```bash conda update mindspore-ascend -c mindspore -c conda-forge diff --git a/install/mindspore_ascend_install_docker_en.md b/install/mindspore_ascend_install_docker_en.md index abdd19c5339ec11d4a09933a6e74bf5c653bff6f..a1358badfac1662e181fb221ee2584b879aa1a9d 100644 --- a/install/mindspore_ascend_install_docker_en.md +++ b/install/mindspore_ascend_install_docker_en.md @@ -33,14 +33,14 @@ The current support for containerized build options is as follows: - Ensure that [Docker 18.03 or later](https://docs.docker.com/get-docker/) is installed. -- Ensure that the Ascend AI processor software package (Ascend Data Center Solution 21.0.3) are installed, please refer to the [Installation Guide](https://support.huawei.com/enterprise/zh/doc/EDOC1100226552?section=j003). +- Ensure that the Ascend AI processor software package (Ascend Data Center Solution 21.0.3) are installed. For the installation, refer to the [Installation Guide](https://support.huawei.com/enterprise/zh/doc/EDOC1100226552?section=j003). - - Ensure that the current user has the right to access the installation path `/usr/local/Ascend`of Ascend AI processor software package. If not, the root user needs to add the current user to the user group where `/usr/local/Ascend` is located. For the specific configuration, please refer to the software package instruction document. + - Ensure that the current user has the right to access the installation path `/usr/local/Ascend`of Ascend AI processor software package. If not, the root user needs to add the current user to the user group where `/usr/local/Ascend` is located. - After installing basic driver and corresponding software packages, ensure that the toolbox utility package in the CANN software package is installed, namely Ascend-cann-toolbox-{version}.run. The toolbox provides Ascend Docker runtime tools supported by Ascend NPU containerization. ## Obtaining MindSpore Image -1. Log in to [Ascend Hub Image Center](https://ascend.huawei.com/ascendhub/#/home), register and activate an account, get login instructions and download instructions. +1. Log in to [Ascend Hub Image Center](https://ascend.huawei.com/ascendhub/#/home), register and activate an account. Get login instructions and download instructions. 2. After obtaining the download permission, enter the [MindSpore image download page](https://ascendhub.huawei.com/#/detail/mindspore-modelzoo). Get login and download commands and execute: ```bash @@ -50,7 +50,7 @@ The current support for containerized build options is as follows: of which, - - `{username}` `{password}` `{url}` represents the user's login information and image server information, which are automatically generated after registering and activating the account, and can be obtained by copying the login command on the corresponding MindSpore image page. + - `{username}` `{password}` `{url}` represents the user's login information and image server information, which are automatically generated after the account is registered and activated, and can be obtained by copying the login command on the corresponding MindSpore image page. - `{tag}` corresponds to the version number of Atlas Data Center Solution, which can also be obtained by copying the download command on the MindSpore image download page. ## Running MindSpore Image @@ -121,7 +121,7 @@ MindSpore version: __version__ The result of multiplication calculation is correct, MindSpore has been installed successfully! ``` -It means MindSpore has been installed by docker successfully. +It means MindSpore Ascend 910 has been installed by Docker successfully. ii: @@ -137,7 +137,7 @@ y = Tensor(np.ones([1,3,3,4]).astype(np.float32)) print(ops.add(x, y)) ``` -The outputs should be the same as: +When the code is run successfully, the outputs should be the same as: ```text [[[[2. 2. 2. 2.] @@ -153,18 +153,18 @@ The outputs should be the same as: [2. 2. 2. 2.]]]] ``` -It means MindSpore has been installed by docker successfully. +It means MindSpore Ascend 910 has been installed by Docker successfully. If you need to verify the MindInsight installation: -Enter ```mindinsight start --port 8080```, if it prompts that the startup status is successful, it means MindInsight has been installed successfully. +Enter ```mindinsight start --port 8080```. If it prompts that the startup status is successful, it means MindInsight has been installed successfully. ## Version Update When you need to update the MindSpore version: -- update Ascend AI processor software package according to MindSpore package version of which you wish to update. -- log in to [Ascend Hub Image Center](https://ascend.huawei.com/ascendhub/#/home) again to obtain the download command of the latest docker version and execute: +- update Ascend AI processor software package according to MindSpore package version of which you want to update. +- log in to [Ascend Hub Image Center](https://ascend.huawei.com/ascendhub/#/home) again to obtain the download command of the latest Docker version and execute: ```bash docker pull ascendhub.huawei.com/public-ascendhub/mindspore-modelzoo:{tag} diff --git a/install/mindspore_ascend_install_pip_en.md b/install/mindspore_ascend_install_pip_en.md index 218a469eeb1479d859ac2ee7acea3df959086d6b..95ab452ccbdd76d8775d063b4f7519e7d4db58a0 100644 --- a/install/mindspore_ascend_install_pip_en.md +++ b/install/mindspore_ascend_install_pip_en.md @@ -60,13 +60,13 @@ pip install https://ms-release.obs.cn-north-4.myhuaweicloud.com/{version}/MindSp Of which, - When the network is connected, dependency items are automatically downloaded during .whl package installation. (For details about the dependency, see required_package in [setup.py](https://gitee.com/mindspore/mindspore/blob/master/setup.py) .) In other cases, you need to install it by yourself. When running models, you need to install additional dependencies based on requirements.txt specified for different models in [ModelZoo](https://gitee.com/mindspore/models/tree/master/). For details about common dependencies, see [requirements.txt](https://gitee.com/mindspore/mindspore/blob/master/requirements.txt). -- `{version}` specifies the MindSpore version number. For example, when installing MindSpore 1.5.0, set `{version}` to 1.5.0, when installing MindSpore 1.5.0-rc1, the first `{version}` which represents download path should be written as 1.5.0-rc1, and the second `{version}` which represents file name should be 1.5.0rc1. -- `{arch}` denotes the system architecture. For example, the Linux system you are using is x86 architecture 64-bit, `{arch}` should be `x86_64`. If the system is ARM architecture 64-bit, then it should be `aarch64`. +- `{version}` specifies the MindSpore version number. For example, when installing MindSpore 1.5.0, set `{version}` to 1.5.0, when installing MindSpore 1.5.0-rc1, the first `{version}` which represents download path should be written as 1.5.0-rc1, and the second `{version}` which represents the version should be 1.5.0rc1. +- `{arch}` denotes the system architecture. For example, the Linux system you are using is x86 architecture 64-bit, and `{arch}` should be `x86_64`. If the system is ARM architecture 64-bit, it should be `aarch64`. - `{python_version}` spcecifies the python version for which MindSpore is built. If you wish to use Python3.7.5,`{python_version}` should be `cp37-cp37m`. If Python3.9.0 is used, it should be `cp39-cp39`. ## Configuring Environment Variables -**If Ascend AI processor software is installed in a non-default path**, after MindSpore is installed, export runtime-related environment variables. `/usr/local/Ascend` in the following command `LOCAL_ASCEND=/usr/local/Ascend` denotes the installation path of the software package, please replace it as your actual installation path. +**If Ascend AI processor software is installed in a non-default path**, after MindSpore is installed, export Runtime-related environment variables. `/usr/local/Ascend` in the following command `LOCAL_ASCEND=/usr/local/Ascend` denotes the installation path of the software package, and you need to replace it as the actual installation path. ```bash # control log level. 0-DEBUG, 1-INFO, 2-WARNING, 3-ERROR, 4-CRITICAL, default level is WARNING. @@ -137,7 +137,7 @@ It means MindSpore has been installed successfully. ## Version Update -Using the following command if you need to update the MindSpore version: +Use the following command if you need to update the MindSpore version: ```bash pip install --upgrade mindspore-ascend=={version} @@ -145,4 +145,4 @@ pip install --upgrade mindspore-ascend=={version} Of which, -- When updating to a release candidate (rc) version, `{version}` should be specified, e.g. 1.5.0rc1; When updating to a standard release, `=={version}` could be removed. +- When updating to a release candidate (rc) version, `{version}` should be specified, e.g. 1.5.0rc1; when updating to a standard release, `=={version}` could be removed. diff --git a/install/mindspore_ascend_install_source_en.md b/install/mindspore_ascend_install_source_en.md index 886a8f7a4f0f6be106dfaf968c7ec861075ed5fd..30da3ffb33df586f50288ec3770ab722d5b57092 100644 --- a/install/mindspore_ascend_install_source_en.md +++ b/install/mindspore_ascend_install_source_en.md @@ -15,7 +15,7 @@ -This document describes how to quickly install MindSpore in a Linux system with an Ascend 910 environment by source code. +This document describes how to quickly install MindSpore in a Linux system with an Ascend 910 environment by source code compilation. ## System Environment Information Confirmation @@ -29,23 +29,25 @@ This document describes how to quickly install MindSpore in a Linux system with - Ensure that [OpenMPI 4.0.3](https://www.open-mpi.org/faq/?category=building#easy-build) is installed. (optional, required for single-node/multi-Ascend and multi-node/multi-Ascend training) -- Ensure that Python 3.7.5 or 3.9.0 is installed. If not installed, download and install Python from: +- Ensure that Python 3.7.5 or 3.9.0 is installed. If not installed or Python of other versions installed, download and install Python from: - Python 3.7.5 (64-bit): [Python official website](https://www.python.org/ftp/python/3.7.5/Python-3.7.5.tgz) or [HUAWEI CLOUD](https://mirrors.huaweicloud.com/python/3.7.5/Python-3.7.5.tgz). - Python 3.9.0 (64-bit): [Python official website](https://www.python.org/ftp/python/3.9.0/Python-3.9.0.tgz) or [HUAWEI CLOUD](https://mirrors.huaweicloud.com/python/3.9.0/Python-3.9.0.tgz). - Ensure that [CMake 3.18.3 or later](https://cmake.org/download/) is installed. - - Add the path where the executable file `cmake` stores to the environment variable PATH. + +Add the path where CMake stores to the environment variable after installed. - Ensure that [patch 2.5 or later](https://ftp.gnu.org/gnu/patch/) is installed. - - Add the path where the executable file `patch` stores to the environment variable PATH. + +Add the path where patch stores to the environment variable after installed. - Ensure that [wheel 0.32.0 or later](https://pypi.org/project/wheel/) is installed. - Ensure that the Ascend AI processor software package (Ascend Data Center Solution 21.0.3) are installed, please refer to the [Installation Guide](https://support.huawei.com/enterprise/zh/doc/EDOC1100226552?section=j003). - Ensure that the current user has the right to access the installation path `/usr/local/Ascend`of Ascend AI processor software package, If not, the root user needs to add the current user to the user group where `/usr/local/Ascend` is located. For the specific configuration, please refer to the software package instruction document. - - Install the .whl package provided in Ascend AI processor software package. The .whl package is released with the software package. After software package is upgraded, reinstall the .whl package. + - Install the .whl package provided in Ascend AI processor software package. The .whl package is released with the software package. The .whl package is installed by referring to the following command. ```bash pip install /usr/local/Ascend/ascend-toolkit/latest/fwkacllib/lib64/topi-{version}-py3-none-any.whl @@ -53,7 +55,7 @@ This document describes how to quickly install MindSpore in a Linux system with pip install /usr/local/Ascend/ascend-toolkit/latest/fwkacllib/lib64/hccl-{version}-py3-none-any.whl ``` - - If the Ascend AI processor software package is upgraded, the .whl package also needs to be reinstalled, first uninstall the original installation package, and then refer to the above command to reinstall. + - If the Ascend AI processor software package is upgraded, the .whl package also needs to be reinstalled. Uninstall the original installation package, and reinstall the package by referring to the above command. ```bash pip uninstall te topi hccl -y @@ -90,7 +92,7 @@ git clone https://gitee.com/mindspore/mindspore.git ## Compiling MindSpore -Run the following command in the root directory of the source code to compile MindSpore: +Run the following command in the root directory of the source code: ```bash bash build.sh -e ascend @@ -110,12 +112,12 @@ Of which, - When the network is connected, dependency items are automatically downloaded during .whl package installation. (For details about the dependency, see required_package in [setup.py](https://gitee.com/mindspore/mindspore/blob/master/setup.py) .) In other cases, you need to install it by yourself. When running models, you need to install additional dependencies based on requirements.txt specified for different models in [ModelZoo](https://gitee.com/mindspore/models/tree/master/). For details about common dependencies, see [requirements.txt](https://gitee.com/mindspore/mindspore/blob/master/requirements.txt). - `{version}` specifies the MindSpore version number. For example, when installing MindSpore 1.5.0-rc1, set `{version}` to 1.5.0rc1. -- `{arch}` denotes the system architecture. For example, the Linux system you are using is x86 architecture 64-bit, `{arch}` should be `x86_64`. If the system is ARM architecture 64-bit, then it should be `aarch64`. -- `{python_version}` spcecifies the python version for which MindSpore is built. If you wish to use Python3.7.5,`{python_version}` should be `cp37-cp37m`. If Python3.9.0 is used, it should be `cp39-cp39`. +- `{arch}` denotes the system architecture. For example, the Linux system you are using is x86 architecture 64-bit, and `{arch}` should be `x86_64`. If the system is ARM architecture 64-bit, it should be `aarch64`. +- `{python_version}` spcecifies the python version of the user. If you wish to use Python3.7.5,`{python_version}` should be `cp37-cp37m`. If you wish to use Python3.9.0, it should be `cp39-cp39`. ## Configuring Environment Variables -- **If Ascend AI processor software is installed in a non-default path**, after MindSpore is installed, export runtime-related environment variables. `/usr/local/Ascend` in the following command `LOCAL_ASCEND=/usr/local/Ascend` denotes the installation path of the software package, please replace it as your actual installation path. +- **If Ascend AI processor software is installed in a non-default path**, after MindSpore is installed, export runtime-related environment variables. `/usr/local/Ascend` in the following command `LOCAL_ASCEND=/usr/local/Ascend` denotes the installation path of the software package, and you need to replace it as the actual installation path. ```bash # control log level. 0-DEBUG, 1-INFO, 2-WARNING, 3-ERROR, 4-CRITICAL, default level is WARNING. @@ -187,7 +189,7 @@ It means MindSpore has been installed successfully. ## Version Update -Using the following command if you need to update the MindSpore version. +Use the following command if you need to update the MindSpore version. - Update Online @@ -197,7 +199,7 @@ Using the following command if you need to update the MindSpore version. - Update after source code compilation - After successfully executing the compile script `build.sh` in the root path of the source code, find the whl package in path `output`, use the following command to update your version. + After successfully executing the compilation script `build.sh` in the root path of the source code, find the .whl package in path `output`, and use the following command to update your version. ```bash pip install --upgrade mindspore_ascend-{version}-{python_version}-linux_{arch}.whl