Установка, обновление и удаление компонентов CUDA
-
Подключитесь к ВМ с GPU или создайте новую, если этого не было сделано ранее.
-
Установите драйвер GPU, если этого не было сделано ранее.
-
Проверьте, установлены ли 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.
Если какой-то из компонентов не установлен, выберите один из сценариев:
- Установите только недостающие компоненты, используя ту же версию, что и уже установленные. Используйте этот способ, если уже установленные версии подходят для ваших задач. При необходимости, позже их можно будет обновить.
- Полностью переустановите все компоненты. Для этого удалите полностью все компоненты, а затем вернитесь к установке. Используйте этот способ, если необходимо понизить версию или выполнить чистую установку с нуля.
-
-
Установите CUDA Toolkit, CUDA Runtime, CUDA Libraries и cuDNN из репозитория NVIDIA CUDA. Для этого:
Ubuntu/DebianRed Hat Enterprise Linux-
Определите версию дистрибутива:
cat /etc/os-release -
Загрузите и установите пакет
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. -
Обновите индексы пакетного менеджера:
sudo apt update -
Убедитесь, что для установки доступны нужные версии компонентов CUDA:
apt-cache policy -<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \cuda-libraries-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \cuda-runtime-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \cudnn9-cuda-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ>Здесь
<МАЖОРНАЯ_ВЕРСИЯ>и<МИНОРНАЯ_ВЕРСИЯ>— номера мажорной и минорной версии компонентов CUDA. Например, для CUDA Toolkit 12.4 название пакета будетcuda-toolkit-12-4.При успешном выполнении команды в выводе будет поле
Candidate, которое указывает версию для установки указанного пакета. -
Установите компоненты CUDA:
sudo apt -y install \cuda-toolkit-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \cuda-libraries-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \cuda-runtime-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \cudnn9-cuda-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ>
-
-
Проверьте работоспособность CUDA Toolkit:
nvcc --version -
Если при попытке выполнить команду
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 -
Повторно проверьте работоспособность CUDA Toolkit:
nvcc --version -
(Опционально) Повторно проверьте установку CUDA Runtime, CUDA Libraries и cuDNN:
ldconfig -p | grep -E 'libcudart\.so|libcuda\.so|libcublas\.so|libcudnn\.so'
-
Подключитесь к ВМ с GPU или создайте новую, если этого не было сделано ранее.
-
Обновите драйвер GPU, если это необходимо для его совместимости с CUDA после обновления.
-
Проверьте версию компонентов CUDA.
-
Определите версию 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:
Ubuntu/DebianRed Hat Enterprise Linuxdpkg -l | grep -E 'cuda-|nvidia-cuda-toolkit'Компоненты CUDA, которые установлены, но которых нет в списке, указывает на отсутствие связи этого компонента с вашим пакетным менеджером. Как правило, это означает, что компонент CUDA был установлен без пакетного менеджера с помощью готового установочного пакета
*.runс сайта производителя.Для обновления версии таких компонентов необходимо выполнить их переустановку. Для этого выполните сначала удаление, затем установку компонентов CUDA.
-
Определите источник обновления и доступные для обновления версии:
Ubuntu/DebianRed Hat Enterprise Linuxapt-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. -
Обновите компоненты CUDA:
Ubuntu/DebianRed Hat Enterprise Linuxsudo apt install --only-upgrade -y \cuda-toolkit-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \cuda-runtime-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \cuda-libraries-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ> \cudnn9-cuda-<МАЖОРНАЯ_ВЕРСИЯ>-<МИНОРНАЯ_ВЕРСИЯ>Здесь
<МАЖОРНАЯ_ВЕРСИЯ>и<МИНОРНАЯ_ВЕРСИЯ>— номера мажорной и минорной версии компонентов CUDA. Например, для CUDA Toolkit 12.4 название пакета будетcuda-toolkit-12-4.
-
Подключитесь к ВМ с GPU или создайте новую, если этого не было сделано ранее.
-
Удалите компоненты CUDA, установленные из пакетного менеджера:
Ubuntu/DebianRed Hat Enterprise Linuxsudo apt remove --purge -y "*cuda*" "*cublas*" "*cufft*" "*cufile*" "*curand*" "*cusolver*" "*cusparse*" "*gds-tools*" "*npp*" "*nvjpeg*" "nsight*" "*nvvm*"sudo apt autoremove --purge -y -
Запустите
cuda-uninstaller, чтобы удалить компоненты, установленные из файла с расширением*.run.sudo /usr/local/cuda-*/bin/cuda-uninstaller 2>/dev/null || sudo cuda-uninstallerЕсли ранее не выполнялось установки из файла с расширением
*.run, то процесс удаления не запустится. Дальнейшие действия не требуются.