cann-nnal-installer

Files (1)

• SKILL.md

SKILL.md (first lines)

# CANN Toolkit+Kernels+NNAL 安装部署

在昇腾NPU环境中安装CANN完整组件（Toolkit、Kernels、NNAL）到指定路径。

**核心原则**：安装顺序必须为 Toolkit → Kernels → NNAL，不可颠倒。NNAL依赖Toolkit的环境变量。

## 调用时机

- 用户要求安装CANN（含toolkit、kernels、nnal）
- 用户需要将CANN安装到自定义路径
- 用户在Docker容器中搭建昇腾开发环境
- 用户需要安装特定版本的CANN（如9.0.0-beta.2）

## 前置检查

### 第1步：检查NPU驱动

```bash
npu-smi info
```

**预期结果**：输出NPU设备信息（芯片型号、显存等）。
**异常处理**：如果 `command not found`，需先安装昇腾驱动和固件，参考 [ascend-npu-driver-install](../ascend-npu-driver-install/) 技能。

### 第2步：确认芯片型号

从 `npu-smi info` 输出中获取芯片型号，用于选择对应的Kernels包：

| 芯片型号 | Kernels包名后缀 |
|---------|----------------|
| 910B / 910B3 | `910b` |
| 910 | `910` |
| 310P | `310p` |
| 310B | `310b` |

### 第3步：确认系统架构

```bash
uname -m
```

- `aarch64`：ARM架构，选择 `_linux-aarch64.run`
- `x86_64`：x86架构，选择 `_linux-x86_64.run`

## 安装方式一：从官网下载run包安装

### 第4步：获取CANN安装包

访问昇腾社区下载中心获取安装包：

```
https://www.hiascend.com/developer/download/community/result?module=cann&cann=<版本号>
```

**需要下载的包**（3个）：

| 包名 | 格式 | 说明 |
|------|------|------|
| `Ascend-cann-toolkit_<版本>_linux-<架构>.run` | run包 | 开发工具包（必须先安装） |
| `Ascend-cann-kernels-<芯片>_<版本>_linux-<架构>.run` | run包 | 算子库（依赖Toolkit） |
| `Ascend-cann-nnal_<版本>_linux-<架构>.run` | run包 | 加速库（依赖Toolkit环境变量） |

**注意**：官网下载链接需要登录认证，无法直接 `wget`。替代方案：
1. 浏览器登录后下载，再上传到服务器
2. 使用下方的"方式二：从Docker镜像提取"

### 第5步：安装Toolkit

```bash
INSTALL_PATH="<用户指定安装路径>"

chmod +x Ascend-cann-toolkit_*.run
./Ascend-cann-toolkit_*.run --install --install-path="${INSTALL_PATH}"
```

**默认路径**：`/usr/local/Ascend`
**自定义路径示例**：`/home/user/run/cann900beta2`

### 第6步：安装Kernels

```bash
chmod +x Ascend-cann-kernels-*.run
./Ascend-cann-kernels-*.run --install --install-path="${INSTALL_PATH}"
```

### 第7步：配置Toolkit环境变量（NNAL安装前置条件）

```bash
source "${INSTALL_PATH}/ascend-toolkit/set_env.sh"
```

**关键**：NNAL安装脚本依赖 `ASCEND_TOOLKIT_HOME` 等环境变量，必须先source。

### 第8步：安装NNAL

```bash
chmod +x Ascend-cann-nnal_*.run
./Ascend-cann-nnal_*.run --install --install-path="${INSTALL_PATH}"
```

## 安装方式二：从Docker镜像提取

当无法直接下载run包时，可从华为官方CANN Docker镜像中提取已安装的CANN文件。

### 第4步：确认本地镜像

```bash
docker images | grep cann
```

华为官方CANN镜像标签格式：`quay.io/ascend/cann:<版本>-<芯片>-<OS>-py<Python版本>`

示例：`quay.io/ascend/cann:9.0.0-beta.2-910-openeuler24.03-py3.11`

如果没有本地镜像，先拉取：

```bash
docker pull quay.io/ascend/cann:9.0.0-beta.2-910-openeuler24.03-py3.11
```

From Ascend/agent-skills, MulanPSL-2.0.

More from Ascend/agent-skills