Инструкция по установке
программного обеспечения AMLT
1    Требования к рабочему месту

1.1 Рекомендуемая конфигурация хоста

Процессор

процессор выбирается согласно спецификации материнской платы

Оперативная память

не менее 16 ГБ RAM (рекомендуется 32 ГБ для рабочих нагрузок).

Дисковое пространство

не менее 20 ГБ свободного места на SSD-накопителе.

Специализированное оборудование

 

GPU ready сервер с возможностью установки GPU двойной ширины FHFL (full height, full length).

Поддержка интерфейса PCIe 4.0 x16 и выше.



1.2 Программные требования

Операционная система:
AstraLinux версии 1.7.7 или выше.
Platform V SberLinux OS Server версии 9.6.2 и выше.

Ядро Linux:
версия 5.15 и выше

Для корректной работы необходимо установить Python версии 3.8 и выше.

2    Установка программного обеспечения AMLT
 
2.1 Общие рекомендации BIOS/UEFI
Корректная работа ускорителя и программного обеспечения AMLT напрямую зависит от правильной конфигурации PCIe в BIOS/UEFI. Ниже приведены рекомендуемые параметры и пояснения.

BIOS/UEFI Обновление:
Используйте последнюю стабильную версию BIOS/UEFI, совместимую с вашей материнской платой или серверной платформой.

Сохранение Настроек:
После внесения изменений обязательно сохраните настройки (F10 → Save & Exit) и перезагрузите систему.

Названия Опций:
Названия опций могут отличаться в зависимости от производителя (Dell, ASUS, Supermicro и т.д.) и UEFI-стека (AMI, Insyde). См. документацию к платформе для точной информации.

Таблица 1 – Настройка основных параметров

Параметр

Конфигурация

PCIe Slot Configuration → Link Speed

Установите значение: Gen4 (рекомендуется). - Где найти: Advanced → PCI Subsystem Settings → PCIe Port Configuration

PCIe Bifurcation

Если используется более одного ASIC-устройства и они подключены через riser или плата поддерживает разделение x16 на x8/x8 или x4/x4/x4/x4 — включите PCIe Bifurcation. - Типичные значения: x16, x8x8, x4x4x4x4 — выберите в соответствии с физической схемой подключения. - Где найти: Advanced → PCIe/PCI Subsystem → Slot Configuration → Bifurcation Control

 

ASPM (Active State Power Management)

Установите: Disabled - ASPM может вызывать тайм-ауты при обмене данными с ASIC, особенно под нагрузкой. - Где найти: Advanced → Power Management → PCIe ASPM

Above 4G Decoding / Memory Mapped I/O above 4GB

Установите: Enabled - Обязательно для устройств, требующих больших DMA-буферов (все современные ASIC). - Без этой опции ядро не сможет выделить достаточно памяти устройству.

Resizable BAR / Smart Access Memory (SAM)

Установите: Disabled - Хотя Resizable BAR ускоряет GPU, для ASIC-устройств она не поддерживается и может вызвать сбои инициализации.

Secure Boot

Установите: Disabled - Драйверы ASIC (hdma, minerva-iasic) распространяются как unsigned kernel modules. При включённом Secure Boot загрузка модулей будет заблокирована.

SR-IOV (Single Root I/O Virtualization)

Установите: Disabled (если не используется виртуализация) - Не требуется для базовой работы ASIC и может конфликтовать с драйвером.

Legacy PCIe Support / Compatibility Mode

Установите: Disabled - Работа в режиме Legacy может ограничить доступ к полной ширине шины.



2.2 Установка основных компонентов
2.2.1 Настройка параметров ядра
Для корректной работы программного обеспечения AMLT и ускорителя необходимо добавить обязательные параметры загрузки, изменив файл /etc/default/grub или выполнив команды представленные ниже.

SberLinux/Astra Linux:

Перезагрузите систему после выполнения этих шагов.

Примечание - Команда изменяет названия сетевых интерфейсов, что может привести к недоступности сервера по сети.

2.2.2 Установка пакетов
Убедитесь, что пакеты находятся в директории /home/testuser/asic_install.
Все последующие действия выполняются внутри этой директории.
SberLinux/Astra Linux:


2.2.3 Настройка группы video
Настройка группы video предназначена для оптимизации работы ускорителя для обработки видео. Эта группа позволяет настраивать различные параметры, связанные с производительностью, ресурсами и функциональностью видео.

Для настройки в случае с нашим программным обеспечением необходимо сделать следующее:
После этого Выполните команду newgrp video или зайдите в систему заново.

2.2.4 Загрузка драйверов
Установка драйверов для ускорителя необходима для обеспечения правильной работы и взаимодействия между программным обеспечением и аппаратным ускорителем.
Для установки драйверов программного обеспечения AMLT воспользуйтесь следующими командами:
2.2.5 Настройка udev и запуск сервиса minervad

Настройка udev позволяет автоматически конфигурировать ускорители при их подключении к системе. 
Сервис minervad используется для управления и мониторинга ускорителей или процессов, запущенных на них.
Ниже описаны шаги по настройке udev и запуску сервиса minervad.
2.2.6 Проверка установки
После установки программного обеспечения AMLT, проверьте правильность установки следующим способом:
Ожидаемый результат:
active
группа: video, права: crw-rw----
группа: video, права: rw-rw----
journalctl -u minerva.service -n 20 --no-pager

2.3 Удаление пакетов и очистка системы
Полное удаление драйверов AMLT и сопутствующих компонентов требует строгой последовательности действий, чтобы избежать следующих проблем: 
·      Остаточных файлов, мешающих новой установке. 
·      «Зависших» модулей ядра. 
·      Конфликтов с udev и systemd. 
·      Утечек ресурсов безопасности (SELinux, AppArmor).

2.3.1 Предварительные условия
Перед удалением обязательно остановите и выключите сервиса, выгрузите драйвера, отключите автозагрузку.

1.    Остановка и отключение сервиса.
2.    Выгрузка драйверов.
3.    Отключение автозагрузки
Для того, чтобы модули не загружались автоматически (через /etc/modules-load.d/ или DKMS), создайте файл блокировки:
blacklist — предотвращает загрузку по зависимостям.
install … /bin/true — гарантирует, что даже прямой вызов modprobe hdma ничего не сделает.
Made on
Tilda