2. 安装部署

2.1. 依赖关系

安装mcPy之前需要满足以下硬软件依赖：

曦云系列GPU：mcPy仅支持基于曦云系列芯片的硬件平台
MXMACA SDK：mcPy基于MXMACA SDK实现GPU计算加速，安装mcPy之前必须先安装MXMACA SDK，配套版本以《MXMAP发布说明》为准
mcPy依赖cu-bridge的安装，请参考 cu-bridge 的使用指南安装并配置cu-bridge环境，建议安装到 /opt/maca/tools/ 目录下。

可以检查以下文件是否存在，并确认cu-bridge环境是否准备完毕：
```
/opt/maca/tools/cu-bridge/bin/cucc
/opt/maca/tools/cu-bridge/tools/cmake_maca
```
Host支持x86_64和aarch64，且glibc≥2.27
Host 操作系统
- x86_64平台支持Ubuntu 18.04 LTS、Ubuntu 20.04 LTS、Ubuntu 22.04 LTS、Centos 8
- aarch64平台支持Kylin Linux advanced server V10
支持 Python 3.8 或 3.10

2.1.1. Python 依赖

mcPy API接口兼容 NumPy 1.24 版本的API，mcPy安装时依赖如下 Python 库：

NumPy≥1.21，且≤1.27
FastRLock≥0.5

2.2. mcPy 自动安装与卸载

本节描述的安装与卸载方法以x86_64平台为例。

自动安装命令：

tar -xJf maca-mcpy-<VERSION>-linux-x86_64.tar.xz
cd mcpy-<VERSION>
bash mxmap-install.sh -f

更多的用法请使用 bash mxmap-install.sh -h 来获得帮助。

自动卸载命令：
```
cd mcpy-<VERSION>
bash mxmap-install.sh -U
```
更多的用法请使用 bash mxmap-install.sh -h 来获得帮助。

2.3. mcPy 手动安装与卸载

本节描述的安装与卸载方法以x86_64平台为例。

2.3.1. wheel包

安装

Python 3.8

$ pip install numbax-x.y.z.n+bu.v.w.m-cp38-cp38-linux_x86_64.whl
$ pip install mcpy-x.y.z.n+bu.v.w.m-cp38-cp38-linux_x86_64.whl

Python 3.10

$ pip install numbax-x.y.z.n+bu.v.w.m-cp310-cp310-linux_x86_64.whl
$ pip install mcpy-x.y.z.n+bu.v.w.m-cp310-cp310-linux_x86_64.whl

卸载

$ pip uninstall mcpy
$ pip uninstall numbax

升级

Python 3.8

$ pip install -U numbax-x.y.z.n+bu.v.w.m-cp38-cp38-linux_x86_64.whl
$ pip install -U mcpy-x.y.z.n+bu.v.w.m-cp38-cp38-linux_x86_64.whl

Python 3.10

$ pip install -U numbax-x.y.z.n+bu.v.w.m-cp310-cp310-linux_x86_64.whl
$ pip install -U mcpy-x.y.z.n+bu.v.w.m-cp310-cp310-linux_x86_64.whl

重新安装

Python 3.8

$ pip uninstall numbax
$ pip uninstall mcpy
$ pip install numbax-x.y.z.n+bu.v.w.m-cp38-cp38-linux_x86_64.whl --no-cache-dir
$ pip install mcpy-x.y.z.n+bu.v.w.m-cp38-cp38-linux_x86_64.whl --no-cache-dir

Python 3.10

$ pip uninstall numbax
$ pip uninstall mcpy
$ pip install numbax-x.y.z.n+bu.v.w.m-cp310-cp310-linux_x86_64.whl --no-cache-dir
$ pip install mcpy-x.y.z.n+bu.v.w.m-cp310-cp310-linux_x86_64.whl --no-cache-dir

2.4. 环境变量设置

mcPy 正常运行依赖如下环境变量：

MACA_PATH：指向 MXMACA 包的安装路径
MXMACA 安装和运行所需要的其他环境变量

2.5. 常见问题

关于 glibc 版本配套：mcPy运行时的 glibc 版本需 ≥2.27，否则可能存在符号缺失的问题。可通过 ldd --version 命令查询当前环境中的 glibc 版本。