# （推荐）自动安装GPU加速型ECS的GPU驱动（Linux）
#### 操作场景
在使用GPU加速型实例时，需确保实例已安装GPU驱动，否则无法获得相应的GPU加速能力。
本节内容介绍如何在GPU加速型Linux实例上通过脚本自动安装GPU驱动。
#### 使用须知
- 本操作仅支持Linux操作系统。
- 本操作当前仅支持安装Tesla驱动。
- 如果GPU加速型实例已安装GPU驱动，需要先卸载原驱动后再安装新的目标驱动。 GPU驱动自动安装脚本提供卸载驱动的能力，请在执行脚本时根据交互式界面按需选择。若无法卸载，请参考[卸载GPU加速型ECS的GPU驱动](https://support.huaweicloud.com/usermanual-ecs/ecs_03_0281.html)手动执行。
  
- GPU驱动安装成功后，实例会自动重启。
- 仅部分Linux公共镜像支持通过脚本自动安装GPU驱动，如下所示：
  - CentOS 7.6、CentOS 7.9、CentOS 8.2。
  
  - Ubuntu 18.04、Ubuntu 20.04、Ubuntu22.04。
  
  
  如果在支持的Linux公共镜像中没有您需要的操作系统及版本，请参考[手动安装GPU加速型ECS的Tesla驱动](https://support.huaweicloud.com/usermanual-ecs/ecs_03_0174.html)，手动安装GPU驱动。
  
- 如果您使用的是私有镜像，请确保镜像已安装了Cloud-init组件及安装GPU驱动所需的依赖，且需使用驱动脚本所支持的Linux操作系统及版本。 安装Cloud-init的详细操作，请参见[（可选）安装和配置Cloud-Init工具](https://support.huaweicloud.com/usermanual-ims/zh-cn_topic_0030730603.html)。
  
- 请根据[表1]选择需要的驱动安装包版本。
   表1支持的GPU驱动版本 
  | CUDA软件版本 | Driver软件版本     | CuDNN软件版本 |
  |:---|:---|:---|
  | 10.2    | 440.118.02  | 8.0.5     |
  | 11.0    | 450.191.01    | 8.1.1    |
  | 11.2      | 460.73.01    | 8.1.1    |
  | 11.4    | 470.103.01   | 8.2.4     |
  | 12.2      | 535.161.08 | 8.9.6.50  |
     
  
 
#### 驱动安装脚本支持区域及获取方式
您可以通过执行以下命令，获取驱动安装脚本。
- 华北-北京一
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-cn-north-1.obs.cn-north-1.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 华北-北京二
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-cn-north-2.obs.cn-north-2.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 华北-北京四
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-cn-north-4.obs.cn-north-4.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 华北-乌兰察布一
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-cn-north-9.obs.cn-north-9.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 华东-上海一
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-cn-east-3.obs.cn-east-3.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 华东-上海二
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-cn-east-2.obs.cn-east-2.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 华南-广州
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-cn-south-1.obs.cn-south-1.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 华南-广州-友好用户环境
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-cn-south-4.obs.cn-south-4.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 西南-贵阳一
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-cn-southwest-2.obs.cn-southwest-2.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 中国-香港
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-ap-southeast-1.obs.ap-southeast-1.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 亚太-曼谷
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-ap-southeast-2.obs.ap-southeast-2.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 亚太-新加坡
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-ap-southeast-3.obs.ap-southeast-3.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
- 非洲-约翰内斯堡
  ```
  wget -t 10 --timeout=10 https://hgcs-drivers-af-south-1.obs.af-south-1.myhuaweicloud.com/release/script/auto_install.sh && bash auto_install.sh
  ```
  
 
#### 操作步骤
以下操作以Ubuntu 20.04 64bit操作系统，P2v规格的GPU加速型实例安装CUDA 11.0对应的Tesla驱动为例进行介绍。
1. 以root账号远程登录云服务器。
2. 执行以下命令，获取驱动安装脚本并运行。 **wget -t 10 --timeout=10 *https://hgcs-drivers-cn-east-2.obs.cn-east-2.myhuaweicloud.com*/release/script/auto_install.sh \&\& bash auto_install.sh**
   
3. 根据界面提示，选择需要安装的驱动版本。
   图1选择驱动安装版本   
   ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001361414389.png "点击放大") 
4. 卸载已安装驱动。 如果云服务器已安装过驱动，请根据提示先执行驱动卸载操作。
   如果云服务器本身未安装驱动，脚本会自动跳过该步骤，开始进行驱动安装。
   1. 卸载CUDA Toolkit。
      图2卸载CUDA Toolkit（1）   
      ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001361535257.png "点击放大")
      图3卸载CUDA Toolkit（2）   
      ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001361255629.png "点击放大") 
   
   2. 卸载GPU driver。
      图4卸载GPU driver   
      ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001308776164.png "点击放大") 
   
   
   ![](https://support.huaweicloud.com/usermanual-ecs/public_sys-resources/note_3.0-zh-cn.png)
   卸载完成后，开始安装驱动，此过程会持续几分钟，请耐心等待。
   
5. 驱动安装完成后，会自动重启云服务器后，请重新以root账号登录。

6. 执行以下命令，检查驱动是否安装成功。 **nvidia-smi**
   如果返回信息中包含了已安装的驱动版本，说明驱动安装成功。
   图5查看驱动安装结果   
   ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001361417641.png "点击放大") 
7. 执行以下命令，检查CUDA版本是否正确。 **/usr/local/cuda/bin/nvcc -V**
   图6检查CUDA版本   
   ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001389898149.png "点击放大") 
8. （可选）检查CUDA是否正常。
   1. 执行以下命令，进入"/usr/local/cuda/samples/1_Utilities/deviceQuery"目录。 **cd /usr/local/cuda/samples/1_Utilities/deviceQuery**
      
   
   2. 执行以下命令，自动编译deviceQuery程序。 **make**
      
   
   3. 执行以下命令，查看CUDA是否安装成功。 **./deviceQuery**
      如果返回信息中有CUDA的版本信息，则表明CUDA安装成功。
      图7查看CUDA安装结果   
      ![](https://support.huaweicloud.com/usermanual-ecs/zh-cn_image_0000001308939980.png "点击放大") 
    
 
#### 相关文档
- [（推荐）自动安装GPU加速型ECS的GPU驱动（Windows）](https://support.huaweicloud.com/usermanual-ecs/ecs_03_0222.html)
- [手动安装GPU加速型ECS的GRID驱动](https://support.huaweicloud.com/usermanual-ecs/zh-cn_topic_0149610914.html)
- [手动安装GPU加速型ECS的Tesla驱动](https://support.huaweicloud.com/usermanual-ecs/ecs_03_0174.html)
- 完成Tesla驱动安装后，如果执行nvidia-smi命令检查GPU使用情况时，显示"No devices were found"，表明系统未能识别NVIDIA显卡。对于使用NVIDIA Tesla T4 GPU的云服务器，请参考[T4 GPU设备显示异常](https://support.huaweicloud.com/trouble-ecs/ecs_trouble_1204.html)的处理方法；使用其他驱动的GPU云服务器，请参考[GPU设备显示异常](https://support.huaweicloud.com/trouble-ecs/ecs_trouble_1203.html)的处理方法。
- [在Linux操作系统的GPU加速型实例中，GPU驱动不可用怎么办？](https://support.huaweicloud.com/trouble-ecs/ecs_trouble_1202.html)
- [在Linux操作系统的GPU加速型实例中，GPU驱动异常怎么办？](https://support.huaweicloud.com/trouble-ecs/ecs_trouble_1201.html)
- [在Windows系统的G系列弹性云服务器中，无法打开NVIDIA 控制面板，GPU驱动无法使用或GPU驱动显示异常时怎么办？](https://support.huaweicloud.com/trouble-ecs/ecs_trouble_0109.html)
 
