已合并
quick_install.md #9090
chenqi317创建于 8月24日
quick_install.md #9090
已合并
共 1 个文件变更+18-44
| @@ -85,7 +85,7 @@ | |||
| 85 | | `-v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info` | 挂载驱动版本信息文件。 | - | | 85 | | `-v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info` | 挂载驱动版本信息文件。 | - | |
| 86 | | `-v /etc/ascend_install.info:/etc/ascend_install.info` | 挂载CANN软件安装信息文件。 | - | | 86 | | `-v /etc/ascend_install.info:/etc/ascend_install.info` | 挂载CANN软件安装信息文件。 | - | |
| 87 | | `-it` | `-i`（交互式）和`-t`（分配伪终端）的组合参数。 | - | | 87 | | `-it` | `-i`（交互式）和`-t`（分配伪终端）的组合参数。 | - | |
| 88 | - | `swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:9.1.0-beta.1-910b-ubuntu22.04-py3.12-devel` | 指定要运行的Docker镜像。 |请确保此镜像名和标签（tag）与你通过`docker pull`拉取的镜像完全一致。 | | 88 | + | `swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:9.1.0-beta.1-910b-ubuntu22.04-py3.12-devel` | 指定要运行的Docker镜像。 | 请确保此镜像名和标签（tag）与您通过`docker pull`拉取的镜像完全一致。 | |
| 89 | | `bash` | 容器启动后立即执行的命令。 | - | | 89 | | `bash` | 容器启动后立即执行的命令。 | - | |
| 90 | 90 | ||
| 91 | ### 方式3：手动安装 | 91 | ### 方式3：手动安装 |
| @@ -94,44 +94,13 @@ | |||
| 94 | 94 | ||
| 95 | #### 安装软件 | 95 | #### 安装软件 |
| 96 | 96 | ||
| 97 | -- **场景1：体验master版本能力或基于master版本进行开发** | 97 | +- **场景1：基于CANN weekly版本体验最新master能力或开发** |
| 98 | 98 | ||
| 99 | - 1. **安装驱动（运行态依赖）** | 99 | + 请参考《[CANN快速安装](https://www.hiascend.com/cann/download)》，选择`Weekly版本`，并根据产品系列、CPU架构、操作系统等下载对应包，最后参考页面提供的命令完成安装。 |
| 100 | 100 | ||
| 101 | - 驱动是运行态依赖，若仅编译算子，可以不安装。使用`npu-smi info`检查是否有NPU相关信息，若没有，请参考《[CANN快速安装](https://www.hiascend.com/cann/download)》完成驱动安装： | 101 | +- **场景2：基于CANN 稳定版本体验分支能力或开发** |
| 102 | 102 | ||
| 103 | - - 步骤1：在页面中选择自己的产品系列、CPU架构、操作系统，安装方式选择“在线安装（Yum）”。 | 103 | + 请参考《[CANN快速安装](https://www.hiascend.com/cann/download)》，选择`稳定版本`（仅支持CANN 8.5.0及后续版本），并根据产品系列、CPU架构、操作系统等下载对应包，最后参考页面提供的命令完成安装。 |
| 104 | - - 步骤2：按照页面指引依次完成“配置用户属组”、“安装依赖&配源”、“安装NPU驱动”三个环节。 | ||
| 105 | - - 步骤3：执行`npu-smi info`，若能正常显示NPU设备信息，则说明驱动安装成功。 | ||
| 106 | - | ||
| 107 | - 2. **安装CANN包** | ||
| 108 | - | ||
| 109 | - 请单击[下载链接](https://ascend.devcloud.huaweicloud.com/artifactory/cann-run-mirror/software/master/)，选择最新时间版本，并根据产品型号和环境架构下载对应包。安装命令如下，更多指导参考《[CANN快速安装](https://www.hiascend.com/cann/download)》。 | ||
| 110 | - | ||
| 111 | - - 安装CANN toolkit包 | ||
| 112 | - | ||
| 113 | - ```bash | ||
| 114 | - bash ./Ascend-cann-toolkit_${cann_version}_linux-${arch}.run --install --install-path=${install_path} | ||
| 115 | - ``` | ||
| 116 | - | ||
| 117 | - - 安装CANN ops包（运行态依赖） | ||
| 118 | - | ||
| 119 | - ops包是运行态依赖，若仅编译算子，可不安装此包。 | ||
| 120 | - | ||
| 121 | - ```bash | ||
| 122 | - bash ./Ascend-cann-${soc_name}-ops_${cann_version}_linux-${arch}.run --install --install-path=${install_path} | ||
| 123 | - ``` | ||
| 124 | - | ||
| 125 | - 变量含义说明： | ||
| 126 | - | ||
| 127 | - - \$\{cann\_version\}：表示CANN包版本号。 | ||
| 128 | - - \$\{arch\}：表示CPU架构，可通过`uname -m`查询，例如aarch64、x86_64。 | ||
| 129 | - - \$\{soc\_name\}：表示NPU型号名称。 | ||
| 130 | - - \$\{install\_path\}：表示指定安装路径，ops包需与toolkit包安装在相同路径，root用户默认安装在`/usr/local/Ascend`目录。 | ||
| 131 | - | ||
| 132 | -- **场景2：体验已发布版本能力或基于已发布版本进行开发** | ||
| 133 | - | ||
| 134 | - 请参考《[CANN快速安装](https://www.hiascend.com/cann/download)》，选择版本（仅支持CANN 8.5.0及后续版本），并根据产品系列、CPU架构、操作系统等下载对应包，最后参考页面提供的命令完成安装。 | ||
| 135 | 104 | ||
| 136 | #### 安装基础依赖 | 105 | #### 安装基础依赖 |
| 137 | 106 | ||
| @@ -150,7 +119,7 @@ | |||
| 150 | 119 | ||
| 151 | 1. 下载源码。 | 120 | 1. 下载源码。 |
| 152 | 121 | ||
| 153 | - 下载与CANN版本配套的分支源码，命令如下，\$\{tag\_version\}替换为分支标签名。 | 122 | + 下载与CANN版本配套的分支源码，命令如下，`${tag_version}`替换为分支标签名。 |
| 154 | 123 | ||
| 155 | ```bash | 124 | ```bash |
| 156 | git clone -b ${tag_version} https://gitcode.com/cann/ops-nn.git | 125 | git clone -b ${tag_version} https://gitcode.com/cann/ops-nn.git |
| @@ -158,13 +127,13 @@ | |||
| 158 | 127 | ||
| 159 | 2. 安装依赖。 | 128 | 2. 安装依赖。 |
| 160 | 129 | ||
| 161 | - 先通过项目根目录install\_deps.sh一键安装上述依赖，命令如下，若遇到不支持的系统，请参考该文件自行适配。 | 130 | + 先通过项目根目录`install_deps.sh`一键安装上述依赖，命令如下，若遇到不支持的系统，请参考该文件自行适配。 |
| 162 | 131 | ||
| 163 | ```bash | 132 | ```bash |
| 164 | bash install_deps.sh | 133 | bash install_deps.sh |
| 165 | ``` | 134 | ``` |
| 166 | 135 | ||
| 167 | - 安装完后，再通过项目根目录requirements.txt继续安装python三方库依赖，命令如下。 | 136 | + 再通过项目根目录`requirements.txt`继续安装python三方库依赖，命令如下。 |
| 168 | 137 | ||
| 169 | ```bash | 138 | ```bash |
| 170 | pip3 install -r requirements.txt | 139 | pip3 install -r requirements.txt |
| @@ -185,14 +154,19 @@ | |||
| 185 | 154 | ||
| 186 | ```bash | 155 | ```bash |
| 187 | # 查看CANN toolkit包版本信息（默认路径安装） | 156 | # 查看CANN toolkit包版本信息（默认路径安装） |
| 188 | - cat /usr/local/Ascend/cann/${arch}-linux/ascend_toolkit_install.info # docker和手动安装场景 | 157 | + # docker和手动安装场景： |
| 189 | - cat /home/developer/Ascend/cann/${arch}-linux/ascend_toolkit_install.info # CANNLab场景 | 158 | + cat /usr/local/Ascend/cann/${arch}-linux/ascend_toolkit_install.info |
| 159 | + # CANNLab场景： | ||
| 160 | + cat /home/developer/Ascend/cann/${arch}-linux/ascend_toolkit_install.info | ||
| 161 | + | ||
| 190 | # 查看CANN ops包版本信息（默认路径安装） | 162 | # 查看CANN ops包版本信息（默认路径安装） |
| 191 | - cat /usr/local/Ascend/cann/${arch}-linux/ascend_ops_install.info # docker和手动安装场景 | 163 | + # docker和手动安装场景： |
| 192 | - cat /home/developer/Ascend/cann/${arch}-linux/ascend_ops_install.info # CANNLab场景 | 164 | + cat /usr/local/Ascend/cann/${arch}-linux/ascend_ops_install.info |
| 165 | + # CANNLab场景： | ||
| 166 | + cat /home/developer/Ascend/cann/${arch}-linux/ascend_ops_install.info | ||
| 193 | ``` | 167 | ``` |
| 194 | 168 | ||
| 195 | - 其中\$\{arch\}可通过`uname -m`查询当前架构，如aarch64、x86_64。 | 169 | + 其中`${arch}`可通过`uname -m`查询当前架构，如aarch64、x86_64。 |
| 196 | 170 | ||
| 197 | ## 环境变量配置 | 171 | ## 环境变量配置 |
| 198 | 172 | ||