VK Cloud logo

Установка, обновление и удаление компонентов CUDA

Установка компонентов CUDA

  1. Подключитесь к ВМ с GPU или создайте новую, если этого не было сделано ранее.

  2. Установите драйвер GPU, если этого не было сделано ранее.

  3. Проверьте, установлены ли CUDA Toolkit, CUDA Runtime, CUDA Libraries и cuDNN:

    • CUDA Toolkit:

      /usr/local/cuda/bin/nvcc --version 2>/dev/null || /usr/local/cuda-*/bin/nvcc --version

      Ошибка No such file or directory как правило означает, что CUDA Toolkit не установлен.

    • CUDA Runtime, CUDA Libraries и cuDNN:

      ldconfig -p | grep -E 'libcudart\.so|libcuda\.so|libcublas\.so|libcudnn\.so'
      • libcudart.so — CUDA Runtime.
      • libcublas.so — CUDA Libraries.
      • libcuda.so — драйверная библиотека. Она должна отображаться, если драйвер установлен корректно. Вы можете проверить наличие драйвера или переустановить его в разделе Установка, обновление и удаление Linux-драйвера GPU.
      • libcudnn.so — cuDNN.

      Если какая-то из библиотек не отображается, соответствующий компонент не установлен в системе.

    Если все нужные компоненты установлены, но имеют версию ниже необходимой — перейдите в раздел Обновление компонентов CUDA.

    Если какой-то из компонентов не установлен, выберите один из сценариев:

    • Установите только недостающие компоненты, используя ту же версию, что и уже установленные. Используйте этот способ, если уже установленные версии подходят для ваших задач. При необходимости, позже их можно будет обновить.
    • Полностью переустановите все компоненты. Для этого удалите полностью все компоненты, а затем вернитесь к установке. Используйте этот способ, если необходимо понизить версию или выполнить чистую установку с нуля.
  4. Установите CUDA Toolkit, CUDA Runtime, CUDA Libraries и cuDNN из репозитория NVIDIA CUDA. Для этого:

    1. Определите версию дистрибутива:

      cat /etc/os-release
    2. Загрузите и установите пакет cuda-keyring_1.1-1_all.deb из репозитория NVIDIA CUDA для соответствующей версии вашего дистрибутива:

      wget https://developer.download.nvidia.com/compute/cuda/repos/<ДИСТРИБУТИВ><ВЕРСИЯ>/x86_64/cuda-keyring_1.1-1_all.deb && \sudo dpkg -i cuda-keyring_1.1-1_all.deb

      Здесь:

      • <ДИСТРИБУТИВ> — название дистрибутива латиницей.
      • <ВЕРСИЯ> — версия дистрибутива. Указываются только числа, без точек.

      Примеры: debian13, ubuntu2404.

    3. Обновите индексы пакетного менеджера:

      sudo apt update
    4. Убедитесь, что для установки доступны нужные версии компонентов CUDA:

      apt-cache policy -<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cuda-libraries-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cuda-runtime-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cudnn9-cuda-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ>

      Здесь <МАЖОРНАЯ_ВЕРСИЯ> и <МИНОРНАЯ_ВЕРСИЯ> — номера мажорной и минорной версии компонентов CUDA. Например, для CUDA Toolkit 12.4 название пакета будет cuda-toolkit-12-4.

      При успешном выполнении команды в выводе будет поле Candidate, которое указывает версию для установки указанного пакета.

    5. Установите компоненты CUDA:

      sudo apt -y install \   cuda-toolkit-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cuda-libraries-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cuda-runtime-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cudnn9-cuda-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ>
  5. Проверьте работоспособность CUDA Toolkit:

    nvcc --version
  6. Если при попытке выполнить команду nvcc --version появилась ошибка command not found, добавьте CUDA Toolkit в переменные окружения вручную:

    sudo tee /etc/profile.d/cuda-path.sh >/dev/null <<'EOF'# Add CUDA Toolkit to PATH (system-wide)CUDA_HOME=/usr/local/cudacase ":$PATH:" in*":$CUDA_HOME/bin:"*) ;;*) export PATH="$CUDA_HOME/bin:$PATH" ;;esacEOF
  7. Повторно проверьте работоспособность CUDA Toolkit:

    nvcc --version
  8. (Опционально) Повторно проверьте установку CUDA Runtime, CUDA Libraries и cuDNN:

    ldconfig -p | grep -E 'libcudart\.so|libcuda\.so|libcublas\.so|libcudnn\.so'

Обновление компонентов CUDA

  1. Подключитесь к ВМ с GPU или создайте новую, если этого не было сделано ранее.

  2. Обновите драйвер GPU, если это необходимо для его совместимости с CUDA после обновления.

  3. Проверьте версию компонентов CUDA.

    1. Определите версию CUDA Toolkit:

      /usr/local/cuda/bin/nvcc --version 2>/dev/null || /usr/local/cuda-*/bin/nvcc --version

      Ошибка No such file or directory как правило означает, что CUDA Toolkit не установлен.

    2. Опредилите версию для компонентов CUDA Runtime, CUDA Libraries и cuDNN:

      ldconfig -p | grep -E 'libcudart\.so|libcuda\.so|libcublas\.so|libcudnn\.so'
      • libcudart.so — CUDA Runtime.
      • libcublas.so — CUDA Libraries.
      • libcuda.so — драйверная библиотека. Должна отображаться при условии, что драйвер установлен корректно. При необходимости, проверить наличие драйвера или выполнить его переустановку можно в разделе Установка, обновление и удаление Linux-драйвера GPU.
      • libcudnn.so — cuDNN.

      Отсутствие библиотеки как правило означает, что компонент не установлен в системе.

    Если какой-то из компонентов отсутствует, веберите один из сценариев.

    • Установите недостающие компоненты нужной версии, после чего вернитесь к обновлению. Используйте этот способ если нет необходимости в чистуой установке с нуля.
    • Полностью переустановите все компоненты. Для этого удалите полностью все компоненты, а затем вернитесь к установке. Используйте этот способ если необходимо понизить версию или выполнить чистую установку с нуля.
  4. Узнайте способ установки компонентов CUDA:

    dpkg -l | grep -E 'cuda-|nvidia-cuda-toolkit'

    Компоненты CUDA, которые установлены, но которых нет в списке, указывает на отсутствие связи этого компонента с вашим пакетным менеджером. Как правило, это означает, что компонент CUDA был установлен без пакетного менеджера с помощью готового установочного пакета *.run с сайта производителя.

    Для обновления версии таких компонентов необходимо выполнить их переустановку. Для этого выполните сначала удаление, затем установку компонентов CUDA.

  5. Определите источник обновления и доступные для обновления версии:

    apt-cache policy cuda-toolkit-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cuda-libraries-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cuda-runtime-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cudnn9-cuda-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ>

    Здесь <МАЖОРНАЯ_ВЕРСИЯ> и <МИНОРНАЯ_ВЕРСИЯ> — номера мажорной и минорной версии компонентов CUDA. Например, для CUDA Toolkit 12.4 название пакета будет cuda-toolkit-12-4.

    Если в ответе ошибка Unable to locate package или в поле Candidate или Installed указана версия из репозиториев Ubuntu (archive.ubuntu.com) или Debian (deb.debian.org и security.debian.org), вместо обновления рекомендуется выполнить переустановку компонентов CUDA с переходом на репозиторий NVIDIA CUDA (developer.download.nvidia.com). Для этого выполните сначала удаление, затем установку CUDA Toolkit.

  6. Обновите компоненты CUDA:

    sudo apt install --only-upgrade -y \   cuda-toolkit-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cuda-runtime-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cuda-libraries-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \   cudnn9-cuda-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ>

    Здесь <МАЖОРНАЯ_ВЕРСИЯ> и <МИНОРНАЯ_ВЕРСИЯ> — номера мажорной и минорной версии компонентов CUDA. Например, для CUDA Toolkit 12.4 название пакета будет cuda-toolkit-12-4.

Удаление компонентов CUDA

  1. Подключитесь к ВМ с GPU или создайте новую, если этого не было сделано ранее.

  2. Удалите компоненты CUDA, установленные из пакетного менеджера:

    sudo apt remove --purge -y "*cuda*" "*cublas*" "*cufft*" "*cufile*" "*curand*" "*cusolver*" "*cusparse*" "*gds-tools*" "*npp*" "*nvjpeg*" "nsight*" "*nvvm*"sudo apt autoremove --purge -y
  3. Запустите cuda-uninstaller, чтобы удалить компоненты, установленные из файла с расширением *.run.

    sudo /usr/local/cuda-*/bin/cuda-uninstaller 2>/dev/null || sudo cuda-uninstaller

    Если ранее не выполнялось установки из файла с расширением *.run, то процесс удаления не запустится. Дальнейшие действия не требуются.