环境配置
前提条件
使用MindCluster ToolBox工具前请确保已完成CANN开发环境或者运行环境的搭建,并根据实际使用场景确认表1已完成安装,详细环境搭建方法及软件安装步骤请参考《CANN 软件安装指南》。
约束与限制
- 使用MindCluster ToolBox时,指令长度不超过4096个字符。
- 基于安全性考虑,用户在使用MindCluster ToolBox时,需确认本文档涉及的相关目录和文件符合所在组织安全要求。
- 可执行文件路径“Ascend-DMI”随toolbox使用root用户安装,所在目录参考为“/usr/local/Ascend/toolbox/latest/Ascend-DMI/bin”。
- Atlas 500 A2 智能小站、Atlas 200I A2 加速模块和Atlas 200I DK A2 开发者套件只支持root用户执行。
添加环境变量
- 不同用户之间环境变量不共享,需要分别添加,此处仅给出CANN软件的安装用户为root时的配置样例,具体操作如下。
- 若需要使用指定用户执行Ascend DMI工具,则要求此用户必须已加入CANN软件运行用户属组。可通过执行以下命令查询CANN软件运行用户属组。
1
cat /etc/ascend_install.info | grep "UserGroup"
- CANN软件提供进程级环境变量设置脚本,供用户在进程中引用。请根据实际安装的软件包,配置如下环境变量。示例如下(以root用户默认安装路径为例):
表2 环境变量配置说明 安装的软件包
配置环境变量
是否必选
toolbox
source /usr/local/Ascend/toolbox/set_env.sh
是
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/ascend-toolkit/set_env.sh
否
nnrt软件包
source /usr/local/Ascend/nnrt/set_env.sh
否
nnae软件包
source /usr/local/Ascend/nnae/set_env.sh
否
用户也可以通过修改~/.bashrc文件方式设置永久环境变量,操作如下:
- 以运行用户在符合所在组织安全要求的目录下执行vi ~/.bashrc命令,打开.bashrc文件,在文件最后一行后面添加上述内容。
- 执行:wq!命令保存文件并退出。
- 执行source ~/.bashrc命令使其立即生效。
- 日志路径
- 若需要使用指定用户执行Ascend DMI工具,则要求此用户必须已加入CANN软件运行用户属组。可通过执行以下命令查询CANN软件运行用户属组。
父主题: 使用前准备