Установка Linux-драйвера vGPU с настройкой токена лицензирования

После выполнения инструкции драйвер vGPU будет установлен, а токен лицензирования — настроен.

Драйвер vGPU не поддерживает обновление. Чтобы изменить его версию, сначала удалите его, а затем повторно установите, выполнив шаги этой инструкции заново.

1. Проверьте тип конфигурации вашей ВМ:

   1. Перейдите в личный кабинет VK Cloud.
   2. Перейдите в раздел Облачные вычисления → Виртуальные машины.
   3. В появившемся списке найдите ВМ, для которой необходимо установить драйвер vGPU. Убедитесь, что в столбце Тип указан шаблон конфигурации vGPU.

2. Подключите ВМ к внешней сети, если этого не было сделано ранее.

3. Подключитесь к ВМ с vGPU.

1. Проверьте, установлен ли драйвер vGPU:

    
   nvidia-smi --query-gpu=driver_version,virtualization.mode,virtualization.virtualized,name --format=csv,noheader

   Возможны следующие результаты:

   • Ошибка No such file or directory означает, что драйвер не установлен.
   • В выводе команды указывается версия драйвера, а тип виртуализации указан как vGPU. Это означает, что драйвер уже установлен и стек NVIDIA успешно инициализирован. В дальнейших действиях нет необходимости.
   • nvidia-smi выполняется, но в выводе команды ошибка ... couldn’t communicate with the NVIDIA driver. Это означает, что драйвер поврежден или используется его некорректная версия (например, для выделенных GPU). Необходимо переустановить драйвер, для этого сначала удалите его, а затем повторно установите, выполнив шаги этой инструкции заново.

2. Выполните предварительную настройку ОС:

   Ubuntu/Debian

   Red Hat Enterprise Linux

   1. (Опционально) Обновите системные компоненты и перезагрузите ВМ, чтобы исключить проблемы с совместимостью.

      Выполните команды:

       
      sudo apt update &&sudo apt upgrade -y &&sudo reboot

   2. Установите дополнительные пакеты, необходимые для установки драйвера:

       
      sudo apt install -y build-essential dkms perl pkg-config libelf-dev linux-headers-$(uname -r)

   1. (Опционально) Обновите системные компоненты и перезагрузите ВМ, чтобы исключить проблемы с совместимостью.

      Выполните команды:

       
      sudo dnf update -y &&sudo reboot

   2. Установите дополнительные пакеты, необходимые для установки драйвера:

       
      sudo dnf -y install gcc make perl dkms pkgconf-pkg-config elfutils-libelf-devel "kernel-devel-uname-r == $(uname -r)" "kernel-headers-uname-r == $(uname -r)"

3. Загрузите драйвер NVIDIA® GRID одним из способов:

   wget

   curl

    
   wget https://hub.mcs.mail.ru/repository/gpu-drivers-raw/bin/nvidia/guest-drivers/latest/vgpu_driver_linux.run

    
   curl -O https://hub.mcs.mail.ru/repository/gpu-drivers-raw/bin/nvidia/guest-drivers/latest/vgpu_driver_linux.run

4. Выдайте права на исполнение для скачанного файла:

    
   chmod +x vgpu_driver_linux.run

5. Запустите файл и следуйте инструкциям установщика:

    
   sudo ./vgpu_driver_linux.run

6. Перезапустите ВМ.

1. Загрузите скрипт лицензирования одним из способов:

   wget

   curl

    
   wget https://hub.mcs.mail.ru/repository/gpu-drivers-raw/bin/nvidia/nvidia-token-fetcher/latest/nvidia_token_fetcher

    
   curl -O https://hub.mcs.mail.ru/repository/gpu-drivers-raw/bin/nvidia/nvidia-token-fetcher/latest/nvidia_token_fetcher

2. Выдайте права на исполнение скрипта:

    
   chmod +x nvidia_token_fetcher

3. Запустите скрипт:

    
   sudo ./nvidia_token_fetcher

4. Проверьте настройки лицензирования:

   1. Убедитесь в наличии файла токена лицензирования:

       
      sudo ls /etc/nvidia/ClientConfigToken/

   2. Узнайте статус лицензии:

       
      nvidia-smi -q | grep -i license

      Вывод при корректной настройке лицензирования:

       
      vGPU Software Licensed Product    License Status: Licensed

5. (Опционально) Настройте автоматическую проверку токена лицензирования при запуске системы.

   Если при создании ВМ использовался подготовленный OpenStack-образ, автоматизация может быть настроена при помощи cloud-init. Также можно использовать возможности systemd.

   Интеграция в cloud-init

   Создание unit-файла для systemd

   Скопируйте файл скрипта в специальную директорию:

    
   sudo cp nvidia_token_fetcher /var/lib/cloud/scripts/per-boot/

   1. Сохраните файл скрипта в общедоступной директории:

       
      sudo cp nvidia_token_fetcher /usr/local/bin/

   2. Создайте новый unit-файл для подсистемы systemd. Пример для текстового редактора nano:

       
      sudo nano /etc/systemd/system/nvidia-token.service

      Вместо nano в команде можно использовать любой другой редактор, например vi.

   3. Скопируйте содержимое в файл и сохраните:

       
      [Unit]Description=NVIDIA Licensing ScriptAfter=network.target[Service]Type=oneshotExecStart=/usr/local/bin/nvidia_token_fetcherTimeoutStartSec=15RemainAfterExit=false[Install]WantedBy=multi-user.target

   4. Выполните команду для автоматического запуска при старте системы:

       
      sudo systemctl enable nvidia-token.service