MindStudio Sanitizer 安装指南¶
1. 安装说明¶
本工具已集成于CANN中，若已安装CANN且无需更新此工具，可直接使用，无需按本文档安装。
若您的环境尚未安装CANN，请参见《CANN 快速安装》安装昇腾NPU驱动和CANN软件（包含Toolkit和ops包），并配置环境变量。
如需单独升级本工具或使用最新版本，您可通过以下三种方式进行安装：在线安装、离线安装、源码安装。
2. 安装方式¶
2.1 在线安装¶
若您的设备具备互联网访问能力，可通过一条命令自动完成工具的下载与安装。请参见昇腾社区MindStudio下载页面，选择对应的CANN版本，并在安装方式中选择“在线安装”，系统将引导您完成后续操作。
2.2 离线安装¶
对处于企业内网等无外网环境的设备，请先在可联网的机器上下载完整的离线安装包，再将其传输至目标设备进行安装。请参见昇腾社区MindStudio下载页面，选择对应的CANN版本，并在安装方式中选择“离线安装”，获取对应的安装包及操作指引。
2.3 源码安装¶
2.3.1 环境准备¶
请按照以下文档进行环境配置：《算子工具开发环境安装指导》。
2.3.2 执行编译打包¶
-
克隆本仓库
-
通过一键式脚本自动完成依赖仓库的下载与构建流程：
2.3.3 安装¶
2.3.3.1 准备 run 包¶
run 包将生成于 output 目录下，执行以下命令确保其具备可执行权限：
2.3.3.2 安装¶
将 run 包拷贝到运行环境中（本机安装无需拷贝），执行如下安装操作：
若系统中已安装该工具的旧版本，安装过程中会提示是否替换；输入 "y" 可执行覆盖安装。
[!NOTE]
安装路径说明
若环境中已配置
ASCEND_HOME_PATH环境变量，工具将安装至$ASCEND_HOME_PATH目录； 否则，默认安装至$HOME/Ascend目录； 如需指定自定义安装路径，请使用--install-path选项，例如：./mindstudio-sanitizer_*.run --install-path=./xxx --run，即可将该运行包安装至xxx目录。
3. 卸载¶
可通过如下步骤卸载：
- 下载脚本。
[!NOTE]
- 需要联网环境才能下载，若环境不允许联网或处于离线状态，请先在可联网的环境下载该脚本后拷贝到目标设备。
- 若执行命令无响应或出现连接失败、SSL证书错误等问题，请参见FAQ。
- 执行卸载。
其中{tools_name}配置为需卸载的工具名称，可通过python ms_install.py help命令查询，在打印信息中的Available Tools字段下显示工具名称。
卸载成功打印如下信息：
4. 升级¶
升级即"先卸后装"。直接执行安装命令，工具将自动卸载旧版本，并引导您完成覆盖安装。也可以手动执行卸载后再安装：
5. 验证安装¶
安装完成后，执行以下命令验证工具是否安装成功：
若正常输出类似如下版本信息，则表明安装成功：
revision:
mssanitizer 26.0.0-a6db6e381b19cae6b0ca7d65bee8729e763893bd
msopscommon 338ecff46263e9b41106f4d48ab70d1cd4ac168b
若提示命令未找到，请参见第6节FAQ内容检查环境变量配置。
6. FAQ¶
安装完成后，执行命令未调用新编译的工具¶
请参考以下命令，检查相关环境变量是否配置正确，以确保系统优先使用新安装的算子工具：
export ASCEND_HOME_PATH=$HOME/Ascend # 或 export ASCEND_HOME_PATH=$PWD/xxx（指定路径安装场景）
export PATH=$ASCEND_HOME_PATH/bin:$PATH
export LD_LIBRARY_PATH=$ASCEND_HOME_PATH/lib64:$LD_LIBRARY_PATH
run 包已删除时如何卸载？¶
可通过以下命令执行卸载操作：
对于指定路径安装的场景，请使用对应路径下的卸载脚本：