版本升级说明

背景

本版本Auto Tune调优工具生成的默认自定义知识库路径进行了变更：

• RL调优：默认自定义知识库路径由“${INSTALL_DIR}/opp/data/rl/<soc_version>/custom”变更为了“${HOME}/ascend/latest/data/aoe/custom/op/<soc_version>/vector”。
• GA调优：默认自定义知识库路径由“${INSTALL_DIR}/opp/data/tiling/<soc_version>/custom”变更为了“${HOME}/ascend/latest/data/aoe/custom/op/<soc_version>/cube”。

其中${INSTALL_DIR}为CANN软件安装后文件存储路径。

升级到本版本后，为了能正确使能默认路径下的自定义知识库，用户需要将原默认自定义路径下的知识库手工迁移到新的默认自定义知识库路径，迁移步骤请参见下文。

操作步骤

1. 以Auto Tune调优用户，在当前用户家目录下创建默认自定义知识库存储路径：

   mkdir -p $HOME/ascend/latest/data/aoe/custom/op/<soc_version>/vector

   mkdir -p $HOME/ascend/latest/data/aoe/custom/op/<soc_version>/cube

   其中<soc_version>为昇腾AI处理器的版本。可从CANN软件安装后文件存储路径的“compiler/data/platform_config”目录下查看，对应“*.ini”文件的名字即为<soc_version>。

2. 拷贝升级前默认路径下的自定义知识库到用户创建的新版本默认自定义知识库存储路径中。

   scp -r ${INSTALL_DIR}/opp/data/rl/<soc_version>/custom/* $HOME/ascend/latest/data/aoe/custom/op/<soc_version>/vector/

   scp -r ${INSTALL_DIR}/opp/data/tiling/<soc_version>/custom/* $HOME/ascend/latest/data/aoe/custom/op/<soc_version>/cube/

若用户有多个软件版本或多台机器下的原默认路径下的自定义知识库需要迁移，请使用知识库合并的方式，将多份知识库合并到用户自定义的知识库路径中（即用户需要使用知识库时指定的TUNE_BANK_PATH），详细操作请参见知识库合并章节。

需要注意，由于知识库合并命令对路径层级有要求，请用户将需要合并的知识库按照目录结构要求进行存放，即{src_dir}/{soc_version}/rl与{src_dir}/{soc_version}/ga。

补充说明

若用户升级完软件后未参见操作步骤手动拷贝知识库文件，在首次执行Auto Tune调优时，调优工具会自动拷贝原默认路径下的自定义知识库到新版本默认自定义知识库存储路径中。

但需要注意，如果用户使用指定路径进行的CANN软件安装，则执行Auto Tune调优前需要设置环境变量“ASCEND_HOME_PATH”，指定CANN软件安装后文件存储路径。

例如，用户指定的安装路径为“$HOME/tmp”，则环境变量设置示例如下：

export ASCEND_HOME_PATH=$HOME/tmp/ascend-toolkit/latest

然后再进行Auto Tune的调优，否则会导致知识库迁移失败，从而旧知识库文件无法使能。