安装包相关
描述CANN软件安装完成后，系统通过“set_env.sh”脚本默认配置的程序编译、执行相关的基础环境变量，以及后续程序编译执行时，需要手工配置的跟安装包相关的环境变量。
安装后自动配置环境变量
CANN软件安装完成后，默认会自动配置程序编译、执行所依赖的基础环境变量，但用户进程结束后相关环境变量自动失效，您也可以通过如下环境变量脚本一键式配置。
# root用户安装时环境变量配置示例： # 安装toolkit包时 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 #安装tfplugin包时 source /usr/local/Ascend/tfplugin/set_env.sh
# 非root用户安装时环境变量配置示例：
# 安装toolkit时
source ${HOME}/Ascend/ascend-toolkit/set_env.sh
# 安装nnrt包时
source ${HOME}/Ascend/nnrt/set_env.sh
# 安装nnae包时
source ${HOME}/Ascend/nnae/set_env.sh
# 安装tfplugin包时
source ${HOME}/Ascend/tfplugin/set_env.sh
用户也可以通过修改~/.bashrc文件方式设置永久环境变量，操作如下：
- 以运行用户在任意目录下执行vi ~/.bashrc命令，打开.bashrc文件，在文件最后一行后面添加上述内容。
- 执行:wq!命令保存文件并退出。
- 执行source ~/.bashrc命令使其立即生效。
详细环境变量说明如下表所示。
软件包 |
环境变量名称 |
环境变量说明 |
配置示例 |
|---|---|---|---|
开发套件包（toolkit） |
LD_LIBRARY_PATH |
动态库的查找路径。 |
export LD_LIBRARY_PATH=/usr/local/Ascend/driver/lib64:/usr/local/Ascend/driver/lib64/common:/usr/local/Ascend/driver/lib64/driver:$LD_LIBRARY_PATH
export ASCEND_TOOLKIT_HOME=/home/HwHiAiUser/Ascend/ascend-toolkit/latest
export LD_LIBRARY_PATH=${ASCEND_TOOLKIT_HOME}/lib64:${ASCEND_TOOLKIT_HOME}/lib64/plugin/opskernel:${ASCEND_TOOLKIT_HOME}/lib64/plugin/nnengine:$LD_LIBRARY_PATH
export PYTHONPATH=${ASCEND_TOOLKIT_HOME}/python/site-packages:${ASCEND_TOOLKIT_HOME}/opp/built-in/op_impl/ai_core/tbe:$PYTHONPATH
export PATH=${ASCEND_TOOLKIT_HOME}/bin:${ASCEND_TOOLKIT_HOME}/compiler/ccec_compiler/bin:$PATH
export ASCEND_AICPU_PATH=${ASCEND_TOOLKIT_HOME}
export ASCEND_OPP_PATH=${ASCEND_TOOLKIT_HOME}/opp
export TOOLCHAIN_HOME=${ASCEND_TOOLKIT_HOME}/toolkit
export ASCEND_HOME_PATH=${ASCEND_TOOLKIT_HOME} |
ASCEND_TOOLKIT_HOME |
CANN-toolkit软件包安装后文件存储路径。 |
||
PYTHONPATH |
Python搜索路径。 |
||
PATH |
可执行文件查找路径。 |
||
ASCEND_AICPU_PATH |
AI CPU组件的安装路径。 |
||
ASCEND_OPP_PATH |
算子库根目录。 |
||
TOOLCHAIN_HOME |
工具链安装路径。 |
||
ASCEND_HOME_PATH |
同ASCEND_TOOLKIT_HOME，代表CANN-toolkit软件安装后文件存储路径。 |
||
离线推理引擎包（nnrt） |
ASCEND_NNRT_HOME |
nnrt软件包安装后文件存储路径。 |
export LD_LIBRARY_PATH=/usr/local/Ascend/driver/lib64:/usr/local/Ascend/driver/lib64/common:/usr/local/Ascend/driver/lib64/driver:$LD_LIBRARY_PATH
export ASCEND_NNRT_HOME=/home/HwHiAiUser/Ascend/nnrt/latest
export LD_LIBRARY_PATH=${ASCEND_NNRT_HOME}/lib64:$LD_LIBRARY_PATH
export PYTHONPATH=${ASCEND_NNRT_HOME}/python/site-packages:$PYTHONPATH
export ASCEND_AICPU_PATH=${ASCEND_NNRT_HOME}
export ASCEND_OPP_PATH=${ASCEND_NNRT_HOME}/opp
|
LD_LIBRARY_PATH |
动态库的查找路径。 |
||
PYTHONPATH |
Python搜索路径。 |
||
ASCEND_AICPU_PATH |
AI CPU组件的安装路径。 |
||
ASCEND_OPP_PATH |
算子库根目录。 |
||
深度学习引擎包（nnae） |
ASCEND_NNAE_HOME |
nnae软件包安装后文件存储路径。 |
export LD_LIBRARY_PATH=/usr/local/Ascend/driver/lib64:/usr/local/Ascend/driver/lib64/common:/usr/local/Ascend/driver/lib64/driver:$LD_LIBRARY_PATH
export ASCEND_NNAE_HOME=/home/HwHiAiUser/Ascend/nnae/latest
export LD_LIBRARY_PATH=${ASCEND_NNAE_HOME}/lib64:${ASCEND_NNAE_HOME}/lib64/plugin/opskernel:${ASCEND_NNAE_HOME}/lib64/plugin/nnengine:$LD_LIBRARY_PATH
export PYTHONPATH=${ASCEND_NNAE_HOME}/python/site-packages:${ASCEND_NNAE_HOME}/opp/built-in/op_impl/ai_core/tbe:$PYTHONPATH
export PATH=${ASCEND_NNAE_HOME}/bin:${ASCEND_NNAE_HOME}/compiler/ccec_compiler/bin:$PATH
export ASCEND_AICPU_PATH=${ASCEND_NNAE_HOME}
export ASCEND_OPP_PATH=${ASCEND_NNAE_HOME}/opp
export ASCEND_HOME_PATH=${ASCEND_NNAE_HOME} |
LD_LIBRARY_PATH |
动态库的查找路径。 |
||
PYTHONPATH |
Python搜索路径。 |
||
PATH |
可执行文件查找路径。 |
||
ASCEND_AICPU_PATH |
AI CPU组件的安装路径。 |
||
ASCEND_OPP_PATH |
算子库根目录。 |
||
ASCEND_HOME_PATH |
同ASCEND_NNAE_HOME，代表nnae软件安装后文件存储路径。 |
||
TensorFlow框架插件包（tfplugin） |
ASCEND_PLUGIN_HOME |
框架包安装后文件存储路径。 |
export ASCEND_PLUGIN_HOME=/usr/local/Ascend/tfplugin/latest
export PYTHONPATH=${ASCEND_PLUGIN_HOME}/python/site-packages:$PYTHONPATH |
PYTHONPATH |
Python搜索路径。 |
手工配置环境变量
程序编译执行过程中，可能会需要配置跟软件包安装相关的环境变量。下面描述CANN提供的不同场景下需要手工配置的环境变量。
软件包 |
环境变量名称 |
环境变量说明 |
配置示例 |
|---|---|---|---|
自定义算子安装包 |
ASCEND_CUSTOM_OPP_PATH |
用户自定义算子包安装路径。 支持配置多个路径，以英文冒号分隔，排在最前面的优先级最高。 |
export ASCEND_CUSTOM_OPP_PATH=/home/HwHiAiUser/Ascend/ascend-toolkit/latest/opp/vendor_name2:/home/HwHiAiUser/Ascend/ascend-toolkit/latest/opp/vendor_name1 |