Skip to content

Commit d4a8b85

Browse files
vigo999vigo999
authored
Merge pull request #2 from vigo999/master
add installation guide for mindspore
2 parents faff87e + 29bf1b1 commit d4a8b85

File tree

2 files changed

+116
-1
lines changed

2 files changed

+116
-1
lines changed

‎README.md

+5-1
Original file line numberDiff line numberDiff line change
@@ -1 +1,5 @@
1-
# tutorials
1+
2+
### guide
3+
- [mindspore 安装指南](./installation/installation.md)
4+
- mindspore API 案例
5+
- mindspore 模型案例

‎installation/installation.md

+111
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
2+
3+
### 搭建ascend+mindspore开发环境需要三步
4+
1. 查ascend driver/firmware/cann与mindspore配套表
5+
2. 下载并安装ascend driver/firmware/cann toolkit
6+
3. 下载并安装mindspore
7+
#### 第一步 查ascend driver/firmare/cann与mindspore配套表
8+
9+
| mindspore | ascend driver | firmware | cann toolkit/kernel
10+
| :--- |:--- | :-- |:--
11+
| 2.3.1 | 24.1.RC2 | 7.3.0.1.231 | 8.0.RC2.beta1
12+
| 2.3.0 | 24.1.RC2 | 7.3.0.1.231 | 8.0.RC2.beta1
13+
| 2.2.10 | 23.0.3 | 7.1.0.5.220 | 7.0.0.beta1
14+
| 2.1.0 | 23.0.rc2 | 6.4.12.1.241 | 6.3.RC2
15+
16+
如要安装ms 2.3.1，ascend driver/firmware/cann相应的版本就是 24.1.RC2/7.3.0.1.231/8.0.RC2.beta1
17+
- 温馨提示1: 请按照配套关系下载安装对应的版本，很多算法开发遇到的问题都来自于环境配置安装，请一定参考以上的配套关系表。
18+
- 温馨提示2: 从硬件适配度和特性方面考虑，建议使用最新的2.3.0/2.3.1版本进行算法开发，有问题请到gitee提issue，https://gitee.com/mindspore/mindspore/issues
19+
20+
#### 第二步 下载并安装ascend driver/firmware/cann toolkit
21+
- ascend的driver/cann软件有两套版本系列，一个是商用版本，一个是社区版本。以下例子均来自于社区版本。两者区别与版本对应关系稍后整理
22+
23+
仍然以安装mindspore 2.3.1和2.3.0为例，硬件以atlas 800T A2训练服务器 aarch64 架构为例，下面表格是对应的版本run包下载方式
24+
25+
序号 | ascend software | version | package name | download | release date|
26+
|:-- |:--- |:--- |:--- | :--- | :---
27+
1 |ascend driver | 24.1.RC2 | Ascend-hdk-910b-npu-driver_24.1.rc2_linux-aarch64.run| [download link](https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/Ascend%20HDK/Ascend%20HDK%2024.1.RC2/Ascend-hdk-910b-npu-driver_24.1.rc2_linux-aarch64.run?response-content-type=application/octet-stream) | 2024-07-31 |
28+
2 |ascend firmware | 7.3.0.1.231 | Ascend-hdk-910b-npu-firmware_7.3.0.1.231.run | [download link](https://ascend-repo.obs.cn-east-2.myhuaweicloud.com/Ascend%20HDK/Ascend%20HDK%2024.1.RC2/Ascend-hdk-910b-npu-firmware_7.3.0.1.231.run?response-content-type=application/octet-stream) | 2024-07-31
29+
3 |cann toolkit | 8.0.RC2.beta1 | Ascend-cann-toolkit_8.0.RC2_linux-aarch64.run | [download page](https://www.hiascend.com/developer/download/community/result?module=cann&cann=8.0.RC2.beta1)| 2024-07-17
30+
4 |cann kernel | 8.0.RC2.beta1 | Ascend-cann-kernels-910b_8.0.RC2_linux.run | [download page](https://www.hiascend.com/developer/download/community/result?module=cann&cann=8.0.RC2.beta1) | 2024-07-17 |
31+
32+
- driver和firmware的download link放的是run包下载地址，点击即可下载，cann toolkit和 kernel放的是download page，需要进入页面后，注册登陆账号才可下载。
33+
- 想了解更多ascend cann信息，请查看https://www.hiascend.com/developer/download/community/result?module=cann&cann=8.0.RC2.beta1
34+
35+
##### 1. 安装driver和firmware
36+
```bash
37+
# 安装driver
38+
./Ascend-hdk-910b-npu-driver_24.1.rc2_linux-aarch64.run --full --install-for-all
39+
40+
# 查看NPU卡信息
41+
npu-smi info
42+
43+
# 查看安装driver的版本号，显示24.1.rc2
44+
cat /usr/local/Ascend/driver/version.info
45+
46+
# 安装NPU firmware
47+
./Ascend-hdk-910b-npu-firmware_7.3.0.1.231.run --full
48+
49+
# 查看安装firmware的版本号，显示 7.3.0.1.231
50+
cat /usr/local/Ascend/firmware/version.info
51+
52+
53+
# 重启OS
54+
reboot
55+
```
56+
57+
##### 2. 安装cann
58+
```bash
59+
60+
# 安装 cann toolkit
61+
./Ascend-cann-toolkit_8.0.RC2_linux-aarch64.run --install --install-for-all --quiet
62+
63+
# 安装二进制算子包cann-kernel
64+
./Ascend-cann-kernels-910b_8.0.RC2_linux.run --install --install-for-all --quiet
65+
66+
# 然后执行如下命令配置环境变量
67+
source /usr/local/Ascend/ascend-toolkit/set_env.sh
68+
69+
# 查看cann 版本号
70+
cat /usr/local/Ascend/ascend-toolkit/latest/version.cfg
71+
# 将会显示7.3.0.1.231:8.0.RC2 -> 7.3.0.1.231是firmware版本号, 8.0.RC2是cann tooklit版本号
72+
```
73+
##### 3. 安装sympy/hccl/te
74+
```bash
75+
pip install sympy
76+
pip install /usr/local/Ascend/ascend-toolkit/latest/lib64/te-*-py3-none-any.whl
77+
pip install /usr/local/Ascend/ascend-toolkit/latest/lib64/hccl-*-py3-none-any.whl
78+
```
79+
80+
#### 第三步 下载并安装mindspore
81+
mindspore的whl包有两种安装方式
82+
1. 直接pip install mindspore==2.3.1 or pip install mindspore==2.3.0（自动根据系统python版本和cpu架构安装相应的whl包）
83+
2. 手动选择python版本和cpu架构相对应的whl包，下载和安装。
84+
##### mindspore 2.3.1
85+
| python | os | cpu | mindspore whl |
86+
| :---: |:---: |:---: | :--- |
87+
| 3.8 | linux | aarch64 | [mindspore-2.3.1-cp38-cp38-linux_aarch64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.1/MindSpore/unified/aarch64/mindspore-2.3.1-cp38-cp38-linux_aarch64.whl)
88+
| 3.9 | linux | aarch64 | [mindspore-2.3.1-cp39-cp39-linux_aarch64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.1/MindSpore/unified/aarch64/mindspore-2.3.1-cp39-cp39-linux_aarch64.whl)
89+
| 3.10 | linux | aarch64 | [mindspore-2.3.1-cp310-cp310-linux_aarch64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.1/MindSpore/unified/aarch64/mindspore-2.3.1-cp310-cp310-linux_aarch64.whl)
90+
| 3.8 | linux | x86_64 | [mindspore-2.3.1-cp38-cp38-linux_x86_64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.1/MindSpore/unified/x86_64/mindspore-2.3.1-cp38-cp38-linux_x86_64.whl)
91+
| 3.9 | linux | x86_64 | [mindspore-2.3.1-cp39-cp39-linux_x86_64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.1/MindSpore/unified/x86_64/mindspore-2.3.1-cp39-cp39-linux_x86_64.whl)
92+
| 3.10 | linux | x86_64 | [mindspore-2.3.1-cp310-cp310-linux_x86_64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.1/MindSpore/unified/x86_64/mindspore-2.3.1-cp310-cp310-linux_x86_64.whl)
93+
##### mindspore 2.3.0
94+
| python | os | cpu | mindspore whl |
95+
| :---: |:---: |:---: | :--- |
96+
| 3.8 | linux | aarch64 | [mindspore-2.3.0-cp38-cp38-linux_aarch64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.0/MindSpore/unified/aarch64/mindspore-2.3.0-cp38-cp38-linux_aarch64.whl)
97+
| 3.9 | linux | aarch64 | [mindspore-2.3.0-cp39-cp39-linux_aarch64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.0/MindSpore/unified/aarch64/mindspore-2.3.0-cp39-cp39-linux_aarch64.whl)
98+
| 3.10 | linux | aarch64 | [mindspore-2.3.0-cp310-cp310-linux_aarch64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.0/MindSpore/unified/aarch64/mindspore-2.3.0-cp310-cp310-linux_aarch64.whl)
99+
| 3.8 | linux | x86_64 | [mindspore-2.3.0-cp38-cp38-linux_x86_64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.0/MindSpore/unified/x86_64/mindspore-2.3.0-cp38-cp38-linux_x86_64.whl)
100+
| 3.9 | linux | x86_64 | [mindspore-2.3.0-cp39-cp39-linux_x86_64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.0/MindSpore/unified/x86_64/mindspore-2.3.0-cp39-cp39-linux_x86_64.whl)
101+
| 3.10 | linux | x86_64 | [mindspore-2.3.0-cp310-cp310-linux_x86_64.whl](https://ms-release.obs.cn-north-4.myhuaweicloud.com/2.3.0/MindSpore/unified/x86_64/mindspore-2.3.0-cp310-cp310-linux_x86_64.whl)
102+
103+
104+
105+
```bash
106+
# 查看mindspore版本号
107+
python -c "import mindspore;mindspore.set_context(device_target='Ascend');mindspore.run_check()"
108+
# 将会显示MindSpore version: 2.3.0或者2.3.1
109+
```
110+
111+

0 commit comments

Comments
 (0)