安装包相关
描述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 |