开发者
下载
[object Object][object Object]

本文档主要介绍msMemScope工具的安装方式,包括:

  • 使用CANN包安装:msMemScope工具完整功能已集成在CANN包中,请参考安装昇腾NPU驱动和CANN软件(包括Toolkit和ops包)并配置环境变量。

  • :msMemScope工具完整功能集成在CANN包中且依赖CANN软件,因此使用msMemScope工具需要先完成CANN包安装,若需要升级安装本工具代码仓中的最新功能,可以通过编译获取run包方式获取最新的msMemScope工具run包覆盖安装,具体操作见本安装方式中的获取最新版本run包。

[object Object]

msMemScope工具支持在Linux系统上使用,目前提供以下两种方式获取run包。

  1. releases页面下载run包。
  2. 编译获取run包。
[object Object]
[object Object]
  1. 请参考下载msMemScope的run包和对应的哈希校验文件(.sha256)。

    下载本软件即表示您同意的条款和条件。

  2. 验证run包的完整性。

    1. 在run包所在目录执行如下命令获取run包的sha256校验码。

      [object Object]

      打印如下示例信息。

      [object Object]
    2. 用记事本打开哈希校验文件查看sha256校验码。

    3. 比对两个文件的sha256校验码是否一致。

      若两个校验码一致,则表示下载了正确的软件包;若不一致,请不要使用该软件包,需要支持与服务请在论坛求助或提交技术工单。

[object Object][object Object]

安装前需确保Git、Python等环境可用,请满足限制,若不满足可执行以下命令安装。

Debian系列:

[object Object]

openEuler系列:

[object Object]
[object Object]
  1. 在终端执行以下git命令,克隆(clone)msMemScope源码。

    [object Object]

    注:其中[object Object]为远程仓库别名,需要指定。

  2. 执行以下命令下载Python三方依赖。注:[object Object]为离线功能使用依赖,可选安装。

    [object Object]
  3. 下载构建依赖以及编译。

    [object Object]

    其中参数说明如下:

    • [object Object]:代表是否本地构建,添加会下载gtest、json等依赖库用于本地构建,一般只有第一次需要,除非依赖库有更新。
    • [object Object]:代表是否要构建测试用例。
  4. [object Object]目录下执行以下命令,编译软件包。

    [object Object]

    将工具的产物打包成一个run包,回显信息如下,表示打包成功,该包支持安装和升级的能力。

    [object Object]

    注:其中[object Object]表示CPU架构。 编译完成后,会在[object Object]目录下生成软件包。

[object Object]
  1. 增加对run包的可执行权限。

    [object Object]
  2. 执行以下命令,安装软件包。

    [object Object]

    注:其中[object Object]为安装目录。

    将msMemScope安装在[object Object]目录下,安装成功后,打印以下信息。

    [object Object]
[object Object]

请检查并确认安装目录:[object Object]下已生成[object Object]文件。

[object Object]

在使用msMemScope工具前,需执行以下命令,配置PYTHONPATH和PATH环境变量。

[object Object]

环境变量配置成功后,打印以下信息。

[object Object]
[object Object]

脚本卸载

  1. 进入安装msmemscope的路径。

    [object Object]

    注:其中[object Object]为软件包的安装路径,请根据实际情况替换。

  2. 执行以下命令运行卸载脚本,完成卸载。

    [object Object]

    卸载程序会提示用户是否确定卸载,若确定则输入y,不卸载输入n。

    卸载完成后,若打印如下信息,则说明软件卸载成功。

    [object Object]
[object Object]

msMemScope的软件包提供升级功能。

  1. 点击,选择更新版本的软件包下载。

  2. 执行以下脚本升级软件。

    [object Object]

    其中参数说明如下。

    • [object Object]指定升级操作。
    • [object Object]指定目标目录,只升级选定的目录。

    升级完成后,若打印如下信息,则说明软件升级成功。

    [object Object]
[object Object][object Object]

本章节介绍了run格式(.run)软件包相关参数说明,run格式软件包支持通过命令行参数进行一键安装,各个命令之间可以配合使用,用户根据安装需要选择对应参数。

安装命令格式:[object Object]

详细参数请参见

[object Object]

表 1 参数说明

[object Object][object Object]

[object Object]