本文档主要介绍msMemScope工具的安装方式,包括:
使用CANN包安装:msMemScope工具完整功能已集成在CANN包中,请参考安装昇腾NPU驱动和CANN软件(包括Toolkit和ops包)并配置环境变量。
:msMemScope工具完整功能集成在CANN包中且依赖CANN软件,因此使用msMemScope工具需要先完成CANN包安装,若需要升级安装本工具代码仓中的最新功能,可以通过编译获取run包方式获取最新的msMemScope工具run包覆盖安装,具体操作见本安装方式中的获取最新版本run包。
msMemScope工具支持在Linux系统上使用,目前提供以下两种方式获取run包。
- releases页面下载run包。
- 编译获取run包。
[object Object]
验证run包的完整性。
在run包所在目录执行如下命令获取run包的sha256校验码。
[object Object]打印如下示例信息。
[object Object]用记事本打开哈希校验文件查看sha256校验码。
比对两个文件的sha256校验码是否一致。
若两个校验码一致,则表示下载了正确的软件包;若不一致,请不要使用该软件包,需要支持与服务请在论坛求助或提交技术工单。
安装前需确保Git、Python等环境可用,请满足限制,若不满足可执行以下命令安装。
Debian系列:
openEuler系列:
在终端执行以下git命令,克隆(clone)msMemScope源码。
[object Object]注:其中
[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]为安装目录。将msMemScope安装在
[object Object]目录下,安装成功后,打印以下信息。[object Object]
请检查并确认安装目录:[object Object]下已生成[object Object]文件。
在使用msMemScope工具前,需执行以下命令,配置PYTHONPATH和PATH环境变量。
环境变量配置成功后,打印以下信息。
脚本卸载
进入安装msmemscope的路径。
[object Object]注:其中
[object Object]为软件包的安装路径,请根据实际情况替换。执行以下命令运行卸载脚本,完成卸载。
[object Object]卸载程序会提示用户是否确定卸载,若确定则输入y,不卸载输入n。
卸载完成后,若打印如下信息,则说明软件卸载成功。
[object Object]
msMemScope的软件包提供升级功能。
执行以下脚本升级软件。
[object Object]其中参数说明如下。
[object Object]指定升级操作。[object Object]指定目标目录,只升级选定的目录。
升级完成后,若打印如下信息,则说明软件升级成功。
[object Object]
本章节介绍了run格式(.run)软件包相关参数说明,run格式软件包支持通过命令行参数进行一键安装,各个命令之间可以配合使用,用户根据安装需要选择对应参数。
安装命令格式:[object Object]
[object Object]
表 1 参数说明
[object Object][object Object]
[object Object]