MindStudio Kernel Performance Prediction 安装指南

1. 安装说明

本工具已集成于CANN中，若已安装CANN且无需更新此工具，可直接使用，无需按本文档安装。

若您的环境尚未安装CANN，请参见《CANN 快速安装》安装昇腾NPU驱动和CANN软件（包含Toolkit和ops包），并配置环境变量。

如需单独升级本工具或使用最新版本，您可通过以下三种方式进行安装：在线安装、离线安装、源码安装。

2. 安装方式

2.1 在线安装

若您的设备具备互联网访问能力，可通过一条命令自动完成工具的下载与安装。请参见昇腾社区MindStudio下载页面，选择对应的CANN版本，并在安装方式中选择“在线安装”，系统将引导您完成后续操作。

2.2 离线安装

对处于企业内网等无外网环境的设备，请先在可联网的机器上下载完整的离线安装包，再将其传输至目标设备进行安装。请参见昇腾社区MindStudio下载页面，选择对应的CANN版本，并在安装方式中选择“离线安装”，获取对应的安装包及操作指引。

2.3 源码安装

如需使用最新代码的功能，或对源码进行修改以增强功能，可下载本仓库代码，自行编译、打包工具并完成安装。

2.3.1 环境准备

请按照以下文档进行环境配置：《算子工具开发环境安装指导》。

要求构建环境中安装python3.9及以上版本才能正常运行。

• 克隆本仓库

  git clone https://gitcode.com/Ascend/mskpp.git
  

• mskpp需要依赖其他python库。通过如下命令一键式安装依赖库。

  cd mskpp
  pip install -r requirement.txt
  

  依赖库列表如下：plotly>=5.11.0。

2.3.2 执行编译打包

通过一键式脚本自动完成依赖仓库的下载与构建流程：

python build.py

2.3.3 安装

2.3.3.1 安装包

将 whl 包拷贝到运行环境中（本机安装无需拷贝），执行如下安装操作：

pip install mindstudio_kpp-xxxxx.whl

若运行完成后打印类似如下信息，则说明安装成功。

Successfully installed mindstudio-kpp-xxxxx

2.3.3.2 安装后配置

当前CANN包中已集成msKPP工具。在激活CANN环境后，即可在自己的python脚本中使用msKPP工具。

source /usr/local/Ascend/ascend-toolkit/set_env.sh
python
>>> import mskpp
>>> ...

3. 卸载

可通过如下步骤卸载：

1. 下载脚本。

   curl -O https://inst.obs.cn-north-4.myhuaweicloud.com/26.0.0/ms_install.py
   

   Note

   • 需要联网环境才能下载，若环境不允许联网或处于离线状态，请先在可联网的环境下载该脚本后拷贝到目标设备。
   • 若执行命令无响应或出现连接失败、SSL证书错误等问题，请参见FAQ。

2. 执行卸载。

   python ms_install.py uninstall {tools_name}
   

   其中{tools_name}配置为需卸载的工具名称，可通过python ms_install.py help命令查询，在打印信息中的Available Tools字段下显示工具名称。

   卸载成功打印如下信息：

   Successfully uninstalled 1 tool ({tools_name})
   

4. 升级

升级即“先卸后装”。直接执行安装命令，工具将自动卸载旧版本，并引导您完成覆盖安装。