跳转至

msprof-analyze工具安装指南

1. 安装说明

本工具支持在线安装离线安装源码安装三种安装方式,请根据您的实际环境选择最合适的方案。

2. 安装方式

2.1 在线安装

pip install msprof-analyze

使用pip install msprof-analyze==版本号可安装指定版本的包,使用采集性能数据对应的CANN版本号即可。

如不清楚版本号可不指定,使用最新程序包。

pip命令会自动安装最新的包及其配套依赖。

提示如下信息则表示安装成功。

Successfully installed msprof-analyze-{version}

2.2 离线安装

  1. 请参考msprof-analyze Release下载msprof-analyze的whl软件包和对应数字签名文件(.sha256)。

下载本软件即表示您同意《华为企业业务最终用户许可协议(EULA)》的条款和条件。

  1. 验证whl包的完整性。

  2. 在whl包所在目录执行如下命令获取whl软件包的sha256校验码。

    sha256sum {name}.whl
    

    打印如下示例信息。

    {sha256} {name}.whl
    
  3. 用记事本打开数字签名文件查看sha256校验码。

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

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

  5. whl包安装。

执行如下命令进行安装。

pip3 install ./msprof_analyze-{version}-py3-none-any.whl

提示如下信息则表示安装成功。

Successfully installed msprof_analyze-{version}

2.3 源码安装

  1. 安装依赖。

源码编译前需要安装wheel。

pip3 install wheel
  1. 下载源码。
git clone https://gitcode.com/Ascend/msprof-analyze
  1. 编译whl包。

[!NOTE]

在安装如下依赖时,请注意使用满足条件的较新版本软件包,关注并修补存在的漏洞,尤其是已公开的CVSS打分大于7分的高危漏洞。

cd msprof-analyze
pip3 install -r requirements.txt && python3 setup.py bdist_wheel

以上命令执行完成后在dist目录下生成性能工具whl安装包msprof_analyze-{version}-py3-none-any.whl

  1. 安装。

执行如下命令进行性能工具安装。

cd dist
pip3 install ./msprof_analyze-{version}-py3-none-any.whl

3. 卸载

执行如下命令卸载msprof-analyze工具。

pip uninstall msprof-analyze

打印如下信息时,表示msprof-analyze卸载成功。

Successfully uninstalled msprof-analyze-{version}

4. 升级

msprof-analyze工具不支持直接升级,需要先完成卸载后再重新安装