repos/index
1
0
Code Issues Actions Packages Projects Wiki

Update MACA

mirror 2024-10-12 13:46:08 +08:00
parent a897d9f6ae
commit b36c432113
1 changed files with 14 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
MACA.md

@ -105,20 +105,21 @@
| x86_64 | KeyarchOS 5.8 | 4.19.91-27.4.19.kos5.x86_64 | 支持 | | x86_64 | KeyarchOS 5.8 | 4.19.91-27.4.19.kos5.x86_64 | 支持 |
### 环境检查（如无特别说明，以Ubuntu 18.04为例） ### 环境检查（以 Ubuntu 18.04 为例）
| 序号 | 检查项目 | 检查命令 | 说明 | | 序号 | 检查项目 | 检查命令 | 说明 |
|------|---------------------|-------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |------|-----------------------|----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1 | 服务器CPU架构 | `uname -m` | 对照表3 1软硬件平台兼容列表,确认CPU架构,操作系统和内核版本是否在列表中。若有任何一项不匹配，则需更新环境。详细信息参见3.2.1确认服务器架构，操作系统和内核版本。 | | 1 | 服务器 CPU 架构 | `uname -m` | 对照表 3.1 硬件和软件平台兼容列表，确认 CPU 架构、操作系统和内核版本是否在列表中。若有任何一项不匹配，则需更新环境。详细信息参见 3.2.1 确认服务器架构、操作系统和内核版本。|
| 2 | 操作系统 | `lsb_release -a` | | | 2 | 操作系统 | `lsb_release -a` | |
| 3 | 内核版本 | `uname -r` | | | 3 | 内核版本 | `uname -r` | |
| 4 | 系统是否安装过驱动 | `lsmod | grep metax` | - 若无内容显示，则表示未安装过软件包。可以直接安装软件包。<br/>- 若有内容显示，则表示安装过软件包。需要先卸载驱动包，再安装新版本软件包。卸载驱动包，请参见3.2.5卸载驱动。 | | 4 | 系统是否安装过驱动 | `lsmod \| grep metax` | - 若无内容显示，则表示未安装过软件包，可以直接安装软件包。<br>- 若有内容显示，则表示安装过软件包，需先卸载驱动包，再安装新版本软件包。卸载驱动包，请参见 3.2.5。 |
| 5 | 板卡是否正常在位 | `lspci | grep 9999` | 如果服务器上有N（N＞0）张曦云GPU板卡，回显中含“9999”字段的行数为N时，则表示曦云GPU板卡正常在位。例如，若服务器上有2张板卡且都正常在位，则回显信息如下所示：<br/>01:00.0 Display controller: Device 9999:4000 (rev 01)<br/>02:00.0 Display controller: Device 9999:4000 (rev 01) | | 5 | 板卡是否正常在位 | `lspci \| grep 9999` | 如果服务器上有 N（N＞0）张曦云 GPU 板卡，回显中含有 “9999” 字段的行数为 N 时，则表示曦云 GPU 板卡正常在位。若有 2 张板卡且都正常在位，则回显如下：<br>01:00.0 Display controller: Device 9999:4000 (rev 01)<br>02:00.0 Display controller: Device 9999:4000 (rev 01) |
| 6 | udev配置 | `cat /etc/udev/rules.d/70-metax.rules` | - 若有群组管理需要：<br/>只允许video组的成员使用曦云GPU，则配置文件有如下内容：<br/>KERNEL=="mxcd", GROUP="video", MODE="0660"<br/>KERNEL=="renderD[0-9]*", GROUP="video", MODE="0660"<br/>- 若没有以上内容，则表示只有root用户可以使用曦云GPU。<br/>- 若无群组管理需要，可删除此配置文件。（deb包安装会自动创建此配置文件。） | | 6 | udev 配置 | `cat /etc/udev/rules.d/70-metax.rules` | - 若有群组管理需要：<br>只允许 video 组的成员使用曦云 GPU，配置文件如下：<br>KERNEL=="mxcd", GROUP="video", MODE="0660"<br>KERNEL=="renderD[0-9]*", GROUP="video", MODE="0660"<br>- 若没有以上内容，则表示只有 root 用户可以使用曦云 GPU。<br>- 若无群组管理需求，可删除此配置文件。（deb 包安装会自动创建此配置文件。） |
| 7 | 虚拟化 | `dmesg | grep "no space"` | 支持SRIOV功能的曦云系列GPU板卡需要分配额外的PCI BAR空间给VF，VF所需BAR空间的大小是PF的8倍，如果系统无法分配地址空间，对应的设备将无法正常工作。 | | 7 | 虚拟化 | `dmesg \| grep "no space"` | 支持 SR-IOV 功能的曦云系列 GPU 板卡需要分配额外的 PCI BAR 空间给 VF，VF 所需 BAR 空间大小是 PF 的 8 倍，若系统无法分配地址空间，则设备无法正常工作。 |
| 8 | IOMMU配置 | `vim /etc/default/grub` | - 在`GRUB_CMDLINE_LINUX=""`里面添加`iommu.passthrough=1`<br/>- 执行`sudo update-grub`<br/>- 重启系统，查看`/proc/cmdline`，确保改动生效 | | 8 | IOMMU 配置 | `vim /etc/default/grub` | - 在 `GRUB_CMDLINE_LINUX=""` 里面添加 `iommu.passthrough=1`<br>- 执行 `sudo update-grub`<br>- 重启系统，查看 `/proc/cmdline`，确保改动生效。 |
| 9 | gpu_sched模块 | `modinfo gpu_sched` | - 如果加载metax驱动过程中出现`Unknown symbol drm_sched_xxx`字样，说明缺少依赖的gpu_sched模块<br/>- 安装内核可选软件包，支持deb的系统执行`apt install linux-modules-extra-$(uname -r)`；支持rpm的系统执行`yum install kernel-modules-extra`<br/>- 重启系统 | | 9 | gpu_sched 模块 | `modinfo gpu_sched` | - 如果加载 metax 驱动时出现 `Unknown symbol drm_sched_xxx`，说明缺少依赖的 gpu_sched 模块。<br>- 安装可选内核软件包，支持 deb 的系统执行 `apt install linux-modules-extra-$(uname -r)`；支持 rpm 的系统执行 `yum install kernel-modules-extra`。<br>- 重启系统。 |
| 10 | 是否允许第三方驱动加载（仅适用于SLES-15系统） | `modprobe metax` | 对于SLES-15系统，如在加载metax驱动时提示`module metax is unsupported`，则需使用`modprobe metax --allow-unsupported`命令加载。如需开机自动加载metax驱动，则需添加`/etc/modprobe.d/10-unsupported-modules.conf`文件，并在该文件中填写`allow_unsupported_modules 1`。 | | 10 | 是否允许第三方驱动加载（仅适用于 SLES-15 系统） | `modprobe metax` | 对于 SLES-15 系统，如加载 metax 驱动时提示 `module metax is unsupported`，则使用 `modprobe metax --allow-unsupported` 命令加载。若需开机自动加载 metax 驱动，需创建 `/etc/modprobe.d/10-unsupported-modules.conf` 文件，并在其中填写 `allow_unsupported_modules 1`。 |
### 适配 Centos7 系统 ### 适配 Centos7 系统