本工具已集成于CANN中,若已安装CANN且无需更新此工具,可直接使用,无需按本文档安装。
若您的环境尚未安装CANN,请参见《》安装昇腾NPU驱动和CANN软件(包含Toolkit和ops包),并配置环境变量。
如需单独升级本工具或使用最新版本,您可通过以下三种方式进行安装:、、。
若您的设备具备互联网访问能力,可通过一条命令自动完成工具的下载与安装。请参见昇腾社区MindStudio页面,选择对应的CANN版本,并在安装方式中选择“在线安装”,系统将引导您完成后续操作。
对处于企业内网等无外网环境的设备,请先在可联网的机器上下载完整的离线安装包,再将其传输至目标设备进行安装。请参见昇腾社区MindStudio页面,选择对应的CANN版本,并在安装方式中选择“离线安装”,获取对应的安装包及操作指引。
安装前需确保Git、Python等环境可用,请满足限制,若不满足可执行以下命令安装。
Debian系列:
openEuler系列:
在终端执行以下git命令,克隆(clone)msMemScope源码。
[object Object]执行以下命令下载Python三方依赖。注:
[object Object]为离线功能使用依赖,可选安装。[object Object]下载构建依赖以及编译。
[object Object]其中参数说明如下:
[object Object]:代表是否本地构建,添加会下载gtest、json等依赖库用于本地构建,一般只有第一次需要,除非依赖库有更新。[object Object]:代表是否要构建测试用例。
在
[object Object]目录下执行以下命令,编译软件包。[object Object]将工具的产物打包成一个run包,回显信息如下,表示打包成功,该包支持安装和升级的能力。
[object Object]注:其中
[object Object]表示CPU架构。 编译完成后,会在[object Object]目录下生成软件包。
增加对run包的可执行权限。
[object Object]执行以下命令,安装软件包。
[object Object]注:其中
[object Object]为安装目录。若未指定[object Object]参数,工具将自动检测环境变量[object Object]或[object Object]:- 若存在上述任一环境变量,将提示用户确认是否安装至
[object Object](优先)或[object Object]目录。若该目录下已存在msmemscope子目录,将自动启用升级模式。 - 若不存在上述环境变量,或用户选择不安装至推荐路径,则默认安装至当前目录。
将msMemScope安装在
[object Object]目录下,安装成功后,打印以下信息。[object Object]- 若存在上述任一环境变量,将提示用户确认是否安装至
请检查并确认安装目录:[object Object]下已生成[object Object]文件。
在使用msMemScope工具前,需执行以下命令,配置PYTHONPATH和PATH环境变量。
环境变量配置成功后,打印以下信息。
安装完成后,执行以下命令验证工具是否安装成功:
若输出不报错,且能显示帮助信息,则表明安装成功。
[object Object]
可通过如下步骤卸载:
下载脚本。
[object Object][object Object]
执行卸载。
[object Object]其中{tools_name}配置为需要卸载的工具名称,可通过
[object Object]命令查询,在打印信息中的Available Tools字段下显示工具名称。卸载成功打印如下信息:
[object Object]
升级即“先卸后装”。直接执行安装命令,工具将自动卸载旧版本,并引导您完成覆盖安装。[object Object]
可通过[object Object]命令查看当前环境的版本信息,再选择需要升级的版本。升级版本时需要关注版本配套关系,请参见《》。
本章节介绍了run格式(.run)软件包相关参数说明,run格式软件包支持通过命令行参数进行一键安装,各个参数之间可以配合使用,用户根据安装需要选择对应参数。
安装命令格式:[object Object]
[object Object]
表 1 参数说明
[object Object][object Object]
[object Object]