---
title: 环境配置
description: "使用MindCluster ToolBox工具前请确保已完成CANN环境的部署，并根据实际使用场景确认表1已完成安装，详细环境部署方法及软件安装步骤请参考《CANN 软件安装》中的“安装NPU驱动和固件(https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/910/softwareinst/instg/instg_0005.html?OS=openEuler&InstallType=local)”章节。"
url: https://www.hiascend.com/document/detail/zh/mindcluster/latest/toolbox/toolboxug/toolboxug_0006.html
sourcePath: /source/zh/mindcluster/2610/toolbox/toolboxug/toolboxug_0006.html
indexId: 503c4d74faa1bb7e635fc879f59786f780951dea128ae7fdefa57a45e504220965
---
# 环境配置

#### 前提条件

使用MindCluster ToolBox工具前请确保已完成CANN环境的部署，并根据实际使用场景确认表1已完成安装，详细环境部署方法及软件安装步骤请参考《CANN 软件安装》中的“安装NPU驱动和固件(https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/910/softwareinst/instg/instg_0005.html?OS=openEuler&InstallType=local)”章节。


**表1 需要安装的软件包**

| 需要安装的软件包 | 使用场景 | 是否可选安装 | 说明 |
| --- | --- | --- | --- |
| npu\-driver | 推理和训练场景 | 必选 | \- |
| npu\-firmware | 推理和训练场景 | 必选 | \- |
| Toolkit | 推理和训练场景 | 必选 | \- |
| Ascend\-cann\-ops | 训练场景 | 必选 | 需要安装至开发套件包目录下。安装时需已安装同一版本的开发套件包，请选择运行设备对应的ops软件包。 CANN 8.5.0之前版本该包名为Ascend\-cann\-kernels。 |


CANN 8.5.0之前的版本：- AICORE诊断、AICORE压测、片上内存高危地址压测、一键式片上内存压测诊断、一键式组合诊断（压测）、AICPU压测、NPU环境恢复场景下必须安装开发套件包。
- 训练场景下nnae和开发套件包支持单独安装或同时安装，不允许两项都不安装。
- 推理场景下nnrt和开发套件包支持单独安装或同时安装，不允许两项都不安装。


#### 约束与限制

- 使用MindCluster ToolBox时，指令长度不超过4096个字符。
- 基于安全性考虑，用户在使用MindCluster ToolBox时，需确认本文档涉及的相关目录和文件符合所在组织安全要求。
- 可执行文件路径“Ascend-DMI”随toolbox使用root用户安装，所在目录参考为“/usr/local/Ascend/toolbox/latest/Ascend-DMI/bin”。


#### 添加环境变量

- 不同用户之间环境变量不共享，需要分别添加，此处仅给出CANN软件的安装用户为root时的配置样例，具体操作如下。

  1. 若需要使用指定用户执行Ascend DMI工具，则要求此用户必须已加入CANN软件运行用户属组。可通过执行以下命令查询CANN软件运行用户属组。

```
cat /etc/ascend_install.info | grep "UserGroup"
```


  2. CANN软件提供进程级环境变量设置脚本，供用户在进程中引用。请根据实际安装的软件包，配置如下环境变量。示例如下（以root用户默认安装路径为例）：

**表2 环境变量配置说明**

| 安装的软件包 | 配置环境变量 | 是否必选 |
| --- | --- | --- |
| toolbox | source /usr/local/Ascend/toolbox/set\_env.sh | 是 |
| toolbox | export ASCEND\_DMI\_LOG\_LEVEL=1 说明： 当ASCEND\_DMI\_LOG\_LEVEL值为1时，会记录debug日志。 日志路径 root用户：/var/log/ascend\-dmi/ascend\-dmi\-debug.log 非root用户：~/var/log/ascend\-dmi/ascend\-dmi\-debug.log 不指定该环境变量或该环境变量指定为其他值时，不会记录debug日志。 | 否 |
| 开发套件包 | source /usr/local/Ascend/cann/set\_env.sh 说明： CANN 8.5.0之前的版本 开发套件包的环境变量：source /usr/local/Ascend/ascend\-toolkit/set\_env.sh。 nnrt软件包的环境变量：source /usr/local/Ascend/nnrt/set\_env.sh。 nnae软件包的环境变量：source /usr/local/Ascend/nnae/set\_env.sh。 | 否 |


用户也可以通过修改~/.bashrc文件方式设置永久环境变量，操作如下：

    a. 以运行用户在符合所在组织安全要求的目录下执行      vi ~/.bashrc
命令，打开.bashrc文件，在文件最后一行后面添加上述内容。
    b. 执行      :wq!
命令保存文件并退出。
    c. 执行source ~/.bashrc命令使其立即生效。