Todos os produtos
Search
Central de documentação

:Instalar o driver Tesla, CUDA e cuDNN no nó RDS Custom AI

Última atualização: Jun 26, 2026

Ao criar um nó RDS Custom AI, o sistema instala por padrão o driver NVIDIA Tesla, CUDA e cuDNN. Caso as versões padrão desses componentes não atendam mais aos seus requisitos, desinstale as versões existentes e instale as desejadas.

Pré-requisitos

Uma instância de nó RDS Custom AI foi criada

Desinstalar o driver Tesla, CUDA e cuDNN

Este tópico usa como exemplo a instalação do driver Tesla 575.57.08, CUDA 12.9.0 e cuDNN 9.10.2 no Alibaba Cloud Linux 3. O procedimento é o seguinte:

  1. Conecte-se à instância RDS Custom.

  2. Execute o comando abaixo e siga as instruções na tela para desinstalar o driver Tesla.

    /usr/bin/nvidia-uninstall
  3. Desinstale o CUDA.

    Método 1: Excluir manualmente o pacote CUDA e os arquivos de configuração relacionados

    1. Exclua manualmente o pacote CUDA e as configurações associadas.

      # Uninstall CUDA packages
      sudo dnf remove 'cuda*'
      
      # Delete repository configurations
      sudo rm /etc/yum.repos.d/cuda*.repo
      
      # Clean cache
      sudo dnf clean all
    2. Execute o comando nvcc --version para confirmar se o CUDA foi desinstalado.

      Se a mensagem command not found for exibida, o CUDA foi desinstalado com sucesso.

    Método 2: Desinstalar usando o arquivo uninstall_cuda

    Nota

    Diferentes versões do CUDA podem ter comandos de desinstalação distintos. Se o arquivo cuda-uninstaller não for encontrado, verifique se existe algum arquivo que comece com uninstall_cuda no diretório /usr/local/cuda/bin/.

    • Caso exista, substitua cuda-uninstaller no comando pelo nome desse arquivo.

    • Se não existir, desinstale pelo Método 1.

    /usr/local/cuda/bin/cuda-uninstaller
    rm -rf /usr/local/cuda-12.9

    Quando Successfully aparecer na saída, a desinstalação foi concluída com êxito.

  4. Desinstale o cuDNN.

    1. Execute o comando a seguir para verificar os nomes dos pacotes relacionados ao cuDNN instalados.

      rpm -qa | grep cudnn

      O resultado retornado será semelhante a:

      cudnn9-cuda-12-9.10.2.21-1.x86_64
      libcudnn9-cuda-12-9.10.2.21-1.x86_64
      libcudnn9-static-cuda-12-9.10.2.21-1.x86_64
      ...
    2. Use o comando dnf remove para desinstalar cada pacote alvo.

      sudo dnf remove cudnn9-cuda-12-9.10.2.21-1.x86_64
      sudo dnf remove libcudnn9-cuda-12-9.10.2.21-1.x86_64
      sudo dnf remove libcudnn9-static-cuda-12-9.10.2.21-1.x86_64
    3. Limpe as dependências remanescentes executando o comando abaixo.

      sudo dnf autoremove
    4. Verifique o resultado da desinstalação.

      rpm -qa | grep cudnn

      Se a saída estiver vazia, a desinstalação foi bem-sucedida. Caso contrário, continue executando dnf remove para remover os pacotes restantes.

Instalar o driver Tesla

Etapa 1: Baixar o driver NVIDIA Tesla

  1. Acesse a página de download de drivers da NVIDIA.

    Nota

    Para mais informações sobre instalação e configuração de drivers NVIDIA, consulte o Guia rápido de instalação de drivers NVIDIA.

  2. Defina os critérios de busca adequados com base no tipo de instância RDS Custom para localizar e selecionar o driver apropriado.

  3. Localize o driver desejado e clique em View ao lado do driver correspondente.

  4. Na página do produto do driver que você deseja baixar, clique com o botão direito em Download e copie o endereço do link.

  5. Conecte-se à instância RDS Custom.

  6. Execute o comando a seguir para baixar o pacote de instalação do driver.

    A URL de download do driver no comando de exemplo corresponde ao link obtido na Etapa 4.

    wget https://us.download.nvidia.com/tesla/575.57.08/NVIDIA-Linux-x86_64-575.57.08.run

Etapa 2: Instalar o driver NVIDIA Tesla

Alibaba Cloud Linux/CentOS

  1. Verifique se os pacotes kernel-devel e kernel-headers estão instalados na instância acelerada por GPU executando o comando abaixo.

    sudo rpm  -qa | grep $(uname -r)
    • Se a saída do comando incluir informações de versão dos pacotes kernel-devel e kernel-headers, eles já estão instalados. Exemplo de saída:

      kernel-3.10.0-1062.18.1.el7.x86_64
      kernel-devel-3.10.0-1062.18.1.el7.x86_64
      kernel-headers-3.10.0-1062.18.1.el7.x86_64
    • Caso kernel-devel- e kernel-headers- não apareçam na saída, baixe e instale os pacotes kernel-devel e kernel-headers compatíveis com a versão do seu kernel.

      Importante

      Se a versão do kernel-devel divergir da versão do kernel, ocorrerá um erro de compilação durante a instalação do RPM Package Manager (RPM) do driver. Por isso, confirme o número da versão de *kernel-** na saída do comando antes de baixar o kernel-devel correspondente. No exemplo acima, a versão do kernel é 3.10.0-1062.18.1.el7.x86_64.

  2. Conceda permissões ao pacote de instalação do driver Tesla e proceda com a instalação.

    Neste exemplo, utiliza-se um driver Tesla Linux de 64 bits. Recomendamos o uso de um pacote de instalação .run para o driver Tesla, como o pacote NVIDIA-Linux-x86_64-xxxx.run. Execute os comandos a seguir para conceder permissões de execução ao pacote e instalar o driver.

    Nota

    Para drivers Tesla em outros formatos, como .deb ou .rpm, consulte o Guia de instalação do NVIDIA CUDA para Linux para obter o método específico de instalação.

    # Grant permissions
    sudo chmod +x NVIDIA-Linux-x86_64-xxxx.run
    # Install
    sudo sh NVIDIA-Linux-x86_64-xxxx.run
  3. Confirme a instalação do driver Tesla com o seguinte comando:

    nvidia-smi

    A instalação foi bem-sucedida se as informações detalhadas do driver Tesla forem exibidas na saída.

    image

  4. (Opcional) Ative o Persistence-M por meio do NVIDIA Persistence Daemon.

    Após a instalação do driver Tesla, o Persistence-M vem desativado (off) por padrão. O driver Tesla apresenta maior estabilidade com o Persistence-M ativado. Para garantir a continuidade dos negócios, recomendamos ativar o Persistence-M usando o NVIDIA Persistence Daemon. Para mais detalhes, consulte Persistence Daemon.

    Nota
    1. Inicie o NVIDIA Persistence Daemon executando o comando:

      sudo nvidia-persistenced --user username 
      # username is your username.
    2. Visualize o status do Persistence-M com o comando:

      nvidia-smi

      Se a saída do comando corresponder à imagem abaixo, o Persistence-M está ativado (on).

      image

  5. (Opcional) Reative o Persistence-M após reinicialização do sistema.

    Se o sistema for reiniciado, o Persistence-M será desativado (on). Siga os passos abaixo para reativá-lo.

    A instalação do pacote do driver Tesla inclui scripts fornecidos pela NVIDIA (como scripts de exemplo e instaladores) no caminho /usr/share/doc/NVIDIA_GLX-1.0/samples/nvidia-persistenced-init.tar.bz2.

    1. Descompacte e instale o script fornecido pela NVIDIA executando os comandos:

      cd /usr/share/doc/NVIDIA_GLX-1.0/samples/
      sudo tar xf nvidia-persistenced-init.tar.bz2
      cd nvidia-persistenced-init
      sudo sh install.sh
    2. Verifique se o NVIDIA Persistence Daemon está funcionando corretamente:

      sudo systemctl status nvidia-persistenced

      O NVIDIA Persistence Daemon estará operando normalmente se a saída for semelhante à imagem a seguir.

      image

      Nota

      Adapte o script de instalação do NVIDIA Persistence Daemon conforme seu sistema operacional para assegurar seu funcionamento adequado.

    3. Confirme novamente se o Persistence-M está ativado (on) executando:

      nvidia-smi
    4. (Opcional) Desative o NVIDIA Persistence Daemon se necessário.

      Desative o NVIDIA Persistence Daemon conforme sua necessidade.

      sudo systemctl stop nvidia-persistenced
      sudo systemctl disable nvidia-persistenced

Ubuntu e outros

  1. Conceda permissões ao pacote de instalação do driver Tesla e proceda com a instalação.

    Neste exemplo, utiliza-se um driver Tesla Linux de 64 bits. Recomendamos o uso de um pacote de instalação .run para o driver Tesla, como o pacote NVIDIA-Linux-x86_64-xxxx.run. Execute os comandos a seguir para conceder permissões de execução ao pacote e instalar o driver.

    Nota

    Para drivers Tesla em outros formatos, como .deb ou .rpm, consulte o Guia de instalação do NVIDIA CUDA para Linux para obter o método específico de instalação.

    # Grant permissions
    sudo chmod +x NVIDIA-Linux-x86_64-xxxx.run
    # Install
    sudo sh NVIDIA-Linux-x86_64-xxxx.run
  2. Confirme a instalação do driver Tesla com o seguinte comando:

    nvidia-smi

    A instalação foi bem-sucedida se as informações detalhadas do driver Tesla forem exibidas na saída.

    image

  3. (Opcional) Ative o Persistence-M por meio do NVIDIA Persistence Daemon.

    Após a instalação do driver Tesla, o Persistence-M vem desativado (off) por padrão. O driver Tesla apresenta maior estabilidade com o Persistence-M ativado. Para garantir a continuidade dos negócios, recomendamos ativar o Persistence-M usando o NVIDIA Persistence Daemon. Para mais detalhes, consulte Persistence Daemon.

    Nota
    1. Inicie o NVIDIA Persistence Daemon executando o comando:

      sudo nvidia-persistenced --user username 
      # username is your username.
    2. Visualize o status do Persistence-M com o comando:

      nvidia-smi

      Se a saída do comando corresponder à imagem abaixo, o Persistence-M está ativado (on).

      image

  4. (Opcional) Reative o Persistence-M após reinicialização do sistema.

    Se o sistema for reiniciado, o Persistence-M será desativado (on). Siga os passos abaixo para reativá-lo.

    A instalação do pacote do driver Tesla inclui scripts fornecidos pela NVIDIA (como scripts de exemplo e instaladores) no caminho /usr/share/doc/NVIDIA_GLX-1.0/samples/nvidia-persistenced-init.tar.bz2.

    1. Descompacte e instale o script fornecido pela NVIDIA executando os comandos:

      cd /usr/share/doc/NVIDIA_GLX-1.0/samples/
      sudo tar xf nvidia-persistenced-init.tar.bz2
      cd nvidia-persistenced-init
      sudo sh install.sh
    2. Verifique se o NVIDIA Persistence Daemon está funcionando corretamente:

      sudo systemctl status nvidia-persistenced

      O NVIDIA Persistence Daemon estará operando normalmente se a saída for semelhante à imagem a seguir.

      image

      Nota

      Adapte o script de instalação do NVIDIA Persistence Daemon conforme seu sistema operacional para assegurar seu funcionamento adequado.

    3. Confirme novamente se o Persistence-M está ativado (on) executando:

      nvidia-smi
    4. (Opcional) Desative o NVIDIA Persistence Daemon se necessário.

      Desative o NVIDIA Persistence Daemon conforme sua necessidade.

      sudo systemctl stop nvidia-persistenced
      sudo systemctl disable nvidia-persistenced

Instalar o CUDA

  1. Obtenha o pacote de instalação do CUDA.

    1. Acesse a página do CUDA Toolkit Archive.

    2. Clique na versão do CUDA correspondente ao seu driver.

    3. Em Operating System, selecione os parâmetros de sistema operacional, arquitetura ou versão conforme necessário para obter a URL de download e os comandos de instalação do pacote CUDA correspondente.

      Nota

      Este tópico usa como exemplo o CUDA 12.9.0 e o sistema operacional Linux RHEL 8 (o Alibaba Cloud Linux 3 é compatível com o RHEL 8).

  2. Instale o CUDA.

    1. Conecte-se à instância RDS Custom.

    2. Execute os comandos abaixo em sequência para instalar o CUDA.

      wget https://developer.download.nvidia.com/compute/cuda/12.9.0/local_installers/cuda-repo-rhel8-12-9-local-12.9.0_575.51.03-1.x86_64.rpm
      sudo rpm -i cuda-repo-rhel8-12-9-local-12.9.0_575.51.03-1.x86_64.rpm
      sudo dnf clean all
      sudo dnf -y install cuda-toolkit-12-9
    3. Configure as variáveis de ambiente do CUDA executando os seguintes comandos em ordem:

      echo 'export PATH=/usr/local/cuda/bin:$PATH' | sudo tee /etc/profile.d/cuda.sh
      source /etc/profile
  3. Verifique se o CUDA está instalado na instância.

    Use o comando nvcc -V para checar se a versão instalada do CUDA está correta.

    O resultado retornado será semelhante a:

    nvcc: NVIDIA (R) Cuda compiler driver
    Copyright (c) 2005-2025 NVIDIA Corporation
    Built on Wed_Apr__9_19:24:57_PDT_2025
    Cuda compilation tools, release 12.9, V12.9.41
    Build cuda_12.9.r12.9/compiler.35813241_0

Instalar o cuDNN

  1. Obtenha o pacote de instalação do cuDNN.

    1. Acesse a página do CUDA Deep Neural Network (cuDNN) | NVIDIA Developer.

    2. Clique em Download cuDNN Library.

    3. Em Operating System, selecione os parâmetros de sistema operacional, arquitetura ou versão conforme necessário para obter a URL de download e os comandos de instalação do pacote cuDNN correspondente.

      A versão mais recente do cuDNN é baixada por padrão. Também é possível clicar em Archive of Previous Releases para escolher e baixar a versão desejada.

      Nota

      Este tópico usa como exemplo o cuDNN 9.10.2 e o sistema operacional Linux RHEL 8 (o Alibaba Cloud Linux 3 é compatível com o RHEL 8).

  2. Instale o cuDNN.

    1. Conecte-se à instância RDS Custom.

    2. Execute os comandos abaixo em sequência para instalar o cuDNN.

      wget https://developer.download.nvidia.com/compute/cudnn/9.10.2/local_installers/cudnn-local-repo-rhel8-9.10.2-1.0-1.x86_64.rpm
      sudo rpm -i cudnn-local-repo-rhel8-9.10.2-1.0-1.x86_64.rpm
      sudo dnf clean all
      sudo dnf -y install cudnn-cuda-12
  3. (Opcional) Se o sistema instalar cudnn.h, libcudnn.so* e cudnn_version.h no diretório /usr/include/ por padrão, execute os comandos a seguir para vincular esses arquivos aos diretórios correspondentes em /usr/local/cuda/.

    1. Vincule o libcudnn.so* e outros arquivos de biblioteca do cuDNN a /usr/local/cuda/lib64/ executando:

      sudo ln -s /usr/lib64/libcudnn.so.9.10.2 /usr/local/cuda/lib64/libcudnn.so.9.10.2
      sudo ln -s /usr/local/cuda/lib64/libcudnn.so.9.10.2 /usr/local/cuda/lib64/libcudnn.so.9
      sudo ln -s /usr/local/cuda/lib64/libcudnn.so.9 /usr/local/cuda/lib64/libcudnn.so

      Valide o resultado do vínculo com ls -l /usr/local/cuda/lib64/libcudnn.so*.

    2. Vincule os arquivos cudnn.h e cudnn_version.h a /usr/local/cuda/include usando os comandos:

      sudo ln -s /usr/include/cudnn.h /usr/local/cuda/include/cudnn.h
      sudo ln -s /usr/include/cudnn_version.h /usr/local/cuda/include/cudnn_version.h

      Valide o resultado do vínculo com ls -l /usr/local/cuda/include/cudnn*.

  4. Verifique se o cuDNN foi instalado corretamente.

    cat /usr/local/cuda/include/cudnn_version.h | grep CUDNN_MAJOR -A 2

    O resultado retornado será semelhante a:

    #define CUDNN_MAJOR 9
    #define CUDNN_MINOR 10
    #define CUDNN_PATCHLEVEL 2
    --

Referências

Introdução ao RDS Custom