SOLA Toolkit 安装指南

概述

SOLA Toolkit 是墨芯为 AI 计算卡提供的软件开发工具包，包含驱动、运行时库以及一系列工具，帮助开发和调试墨芯 AI 计算卡上的应用程序。本文介绍 SOLA Toolkit 的安装方法，以及在安装和卸载过程中需要注意的事项。

系统需求

SOLA 开发环境与主机（host）开发环境紧密集成，包括主机编译器和 C 运行时库。因此，仅支持通过此版本 SOLA Toolkit 认证的 Linux 发行版。以下表格列出了对 SOLA Toolkit 进行了充分验证的 Linux 发行版。在其他版本的 Linux 上，SOLA Toolkit 也可能运行，但功能无法保证。

Linux 发行版	架构	内核版本	默认 GCC 版本	GLIBC（GNU C Library）版本
Ubuntu 18.04	x86_64	4.15.0	7.5.0	2.27
Ubuntu 20.04	x86_64	5.4.0	9.4.0	2.31
Ubuntu 22.04	x86_64	6.5.0	11.4	2.35
Debian 10	x86_64	4.19.0	8.3.0	2.28
Debian 11	x86_64	5.10.0	10.2.1	2.31
RHEL 8.2/8.3	x86_64	4.18.0	8.3.1	2.28
RHEL 8.6	x86_64	4.18.0	8.5.0	2.28
RHEL 9.0	x86_64	5.14.0	11.2.1	2.34
RHEL 9.3	x86_64	5.14.0	10.2.1	2.34
KylinOS V10	x86_64	4.19	7.3.0	2.28
AliOS 7.2	x86_64	5.10	9.2.1	2.17
Rocky Linux 9.3 (Blue Onyx)	x86_64	5.14.0-362.8.1	11.5.0	2.35
openEuler	x86_64	5.10.0-240.0.0.139	10.3.1	2.34

安装前准备

验证系统已安装墨芯 AI 计算卡

查看系统中是否已安装墨芯 AI 计算卡：

lspci | grep 1f36

如果您的系统中没有lspci命令，根据不同的 Linux 发行版执行对应的命令安装 PCI 工具软件包 pciutils：

说明

执行以下命令需获取 sudo 权限。

Ubuntu / Debian
```
sudo apt-get install pciutils
```
RHEL / AliOS / KylinOS V10 / Rocky Linux / openEuler
```
sudo dnf install pciutils
```

验证系统运行支持的 Linux 版本

查看系统运行的 Linux 版本：

uname -m && cat /etc/*release

验证系统已安装 GCC

查看系统是否安装 GCC（GNU Compiler Collection）编译器，且版本 ≥ GCC 6.x。

gcc --version

GCC 通常作为 Linux 操作系统的一部分随系统一起安装。如果显示错误信息，则需要从您的 Linux 发行版中安装开发工具，或者从网上获取 GCC 及其相关工具链的版本。

验证系统已安装正确的内核头文件和开发包

SOLA 驱动程序要求在安装和重建驱动程序时，已安装内核运行版本对应的内核头文件和开发包。例如，如果系统内核版本为 4.15.0，则必须安装 4.15.0 内核头文件和开发包。为了避免安装过程中版本不匹配的问题，在安装 SOLA Toolkit 之前以及每次更改内核版本时，执行以下命令查看系统正在运行的内核版本，确保安装了正确版本的内核头文件和开发包。SOLA Toolkit 兼容 4.15.0 - 6.5.0 之间的内核版本。

uname -r

说明

如果无法通过 Linux 发行版的本地包管理器获取对应内核的版本，请务必另行下载并安装对应的内核版本。

安装与当前运行的内核版本一致的内核头文件，命令如下：

Ubuntu / Debian

sudo apt-get install linux-headers-$(uname -r)

RHEL / AliOS / KylinOS V10 / Rocky Linux / openEuler

sudo dnf install kernel-devel-$(uname -r) kernel-headers-$(uname -r)

验证已安装依赖的其他第三方工具

确保已安装以下依赖的第三方工具：

dkms
libelf-dev（Debian / Ubuntu）
elfutils-libelf-devel (RHEL / AliOS / KylinOS V10 / Rocky Linux / openEuler)
kmod
make
tar

选择 SOLA Toolkit 安装方式

SOLA Toolkit 可通过以下两种方式安装：

包管理器方式（推荐使用）

该方式使用 Linux 发行版特定的安装包，依赖于 Linux 发行版的本地包管理器进行安装。安装包根据 Linux 发行版分为以下两种：
- RPM 安装包：适用于 RHEL、AliOS、KylinOS V10、Rocky Linux 9.3 和 openEuler。
- Deb 安装包：适用于 Ubuntu 和 Debian。
Runfile 方式

该方式使用独立于 Linux 发行版的 Runfile 安装包，不依赖 Linux 发行版的本地包管理器，可以在多个 Linux 发行版上使用。

注意

Linux 发行版特定的安装包和独立的 Runfile 安装包底层实现是同源的，所以安装和卸载都会互相影响。如果您同时使用了两种不同类型的安装包进行安装，在卸载时可能会影响 Linux 发行版的本地包管理器的使用，所以建议使用同一种类型的安装包。

安装 SOLA Toolkit（包管理器方式）

使用 RPM 或 Deb 包进行安装时，将与 Linux 发行版的包管理器进行集成。推荐使用该方式安装 SOLA Toolkit。

说明

使用 Deb 或 RPM 包安装时，默认您已同意最终用户许可协议（End User License Agreement，EULA）。EULA 详细内容请参见 SOLA Toolkit 最终用户许可协议。

使用 Deb 包安装

获取 Deb 安装包。

wget https://moffett-oss-bucket.tos-cn-shanghai.volces.com/sola-toolkits/sola_3.11.0_amd64.deb

安装 SOLA Toolkit。
```
sudo dpkg -i sola_3.11.0_amd64.deb
```

使用 RPM 包安装

获取 RPM 安装包。

wget https://moffett-oss-bucket.tos-cn-shanghai.volces.com/sola-toolkits/sola-3.11.0-1.x86_64.rpm

安装 SOLA Toolkit。
```
sudo rpm -U sola-3.11.0-1.x86_64.rpm
```

安装 SOLA Toolkit（Runfile 方式）

使用独立的 Runfile 安装包安装 SOLA Toolkit，步骤如下：

获取 Runfile 安装包。

wget https://moffett-oss-bucket.tos-cn-shanghai.volces.com/sola-toolkits/sola_3.11.0_x86_64.run

安装 SOLA Toolkit。
```
sudo sh sola_3.11.0_x86_64.run --driver --accept
```
其中：
- --driver：表示同时安装 SOLA 驱动，建议添加该参数。
- --accept：表示执行安装命令时同意最终用户许可协议，建议添加该参数。
说明

如果未添加 --accept 参数，您也可以在执行安装命令时阅读协议内容，并根据提示输入 accept 并按回车键确认后继续安装。
（可选）如果执行安装 SOLA Toolkit 的命令时未添加--driver参数，按照以下步骤手动安装 SOLA 驱动，以确保板卡功能正常运行。

a. 进入 SOLA 驱动程序的目录。
```
cd /usr/local/sola/driver
```
b. 安装 SOLA 驱动。
```
sudo sh setup.sh
```

安装后操作

查看固件版本

mx-smi select -f firmware_version

说明

确保固件版本为 1.0.17。如版本不符，请参见 mx-mft 用户手册更新板载设备固件，按说明升级至最新版，否则可能影响功能使用。

查看 SOLA 版本和板卡相关信息

mx-smi

如果显示的 SOLA 版本与安装的版本一致，则表示 SOLA toolkit 已成功安装。SOLA Toolkit 默认安装在 /usr/local/sola-<version> 路径下，并会自动创建一个指向该路径的软链接 /usr/local/sola。同时，以下可执行工具程序安装在 /usr/bin 目录下，供调试板卡使用。

可执行工具程序	说明
mx-smi	管理和监控设备的工具
mx-qual	系统和设备质量检测工具
mx-mft	设备固件管理工具
mx-daemon	自动加载固件的守护进程
sola-uninstall	卸载程序
moffett-bug-report.sh	日志收集工具

关于如何使用 mx-smi、mx-qual、mx-mft 和 mx-daemon，请参见对应的用户手册。

卸载 SOLA Toolkit

卸载 SOLA Toolkit 会卸载与它相关的所有组件，包括驱动程序、工具和库。根据不同的安装方式，选择以下命令卸载 SOLA Toolkit：

卸载使用 RPM 包安装的 SOLA Toolkit：
```
sudo rpm -e sola
```
卸载使用 Deb 包安装的 SOLA Toolkit：
```
sudo dpkg -r sola
```
卸载使用 Runfile 包安装的 SOLA Toolkit：
```
sudo sola-uninstall
```
执行该命令时，系统会检测当前系统中所有安装在默认路径下的 SOLA Toolkit 版本。在出现的 SOLA Uninstaller 界面上，根据界面提示通过键盘操作选择并卸载相应的 SOLA Toolkit 版本。