昇腾社区首页
中文
注册

ASCEND_CACHE_PATH

功能描述

若开发者期望编译运行过程中产生的文件落盘到归一路径,可通过此环境变量设置共享文件的存储路径,各组件编译运行过程中产生的可共享文件会存储到此环境变量定义的路径中。

  • 路径支持大小写字母(a-z,A-Z)、数字(0-9)、下划线(_)、中划线(-)、句点(.)、中文字符。
  • 若指定的路径存在且有效,请确保执行用户具有读、写、可执行权限;若指定的路径不存在,软件会自动创建。

${ASCEND_CACHE_PATH}路径下的文件如下表所示。

表1 共享文件落盘路径汇总

落盘文件

文件内容

优先级说明

${ASCEND_CACHE_PATH}/aoe_data

AOE调优知识库文件。

支持多机共享。

TUNE_BANK_PATH> ASCEND_CACHE_PATH> 默认知识库路径

关于默认知识库路径的说明,请参见TUNE_BANK_PATH中说明。

${ASCEND_CACHE_PATH}/kernel_cache

算子编译缓存文件。

支持单机多卡共享。

以下场景提供了设置算子编译缓存文件存储路径的参数或接口,其优先级高于ASCEND_CACHE_PATH环境变量,详细描述如下:

  • 使用ATC工具进行离线模型编译的场景

    参数“--op_compiler_cache_dir” > ASCEND_CACHE_PATH > 默认路径($HOME/atc_data)

  • 使用AscendCL接口构建或编译模型的场景
    • 构图接口“aclgrphBuildInitialize”中参数“OP_COMPILER_CACHE_DIR”> ASCEND_CACHE_PATH > 默认路径($HOME/atc_data)
    • 构图接口“aclgrphBuildModel”中参数“OP_COMPILER_CACHE_DIR”> ASCEND_CACHE_PATH > 默认路径($HOME/atc_data)
    • 应用编译接口“aclCompileOpt”中编译选项“ACL_OP_COMPILER_CACHE_DIR” > ASCEND_CACHE_PATH > 默认路径($HOME/atc_data)
  • TensorFlow网络训练或在线推理场景

    TF Adapter配置参数“op_compiler_cache_dir”> ASCEND_CACHE_PATH > 默认路径($HOME/atc_data)。

    TF Adapter配置参数“op_compiler_cache_dir”的详细说明可参见:
    • 《TF Adapter接口 (1.x)》中的“session配置 > session配置参数说明”
    • 《TF Adapter接口 (2.x)》中的“npu.global_options > 配置参数说明

配置示例

export ASCEND_CACHE_PATH=/repo/task001/cache

使用约束

  • 共享存储需要支持Linux文件锁(如NFSv4、OceanStor Pacific 9950和9550 ),对于不支持Linux文件锁的存储(如NFSv3),建议优先存储到本地目录。
  • 多服务器场景下,各机器上的AI处理器型号以及固件驱动与CANN软件版本需要保持一致。

支持的型号

Atlas 200/300/500 推理产品

Atlas 训练系列产品

Atlas 推理系列产品

Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

Atlas 200I/500 A2 推理产品