Elastic GPU Service:Upgrade the NVIDIA Tesla or GRID driver

Windows

Applicable instances

You can use Cloud Assistant to upgrade the GRID driver only on the following GPU-accelerated instance families that run Windows:

• vGPU-accelerated instances: vgn6i-vws, vgn7i-vws, and sgn7i-vws

• GPU-accelerated compute-optimized instances: gn7i, gn6i, ebmgn7i, and ebmgn6i

Procedure

The following example runs on a vgn6i-vws instance (ecs.vgn6i-m4-vws.xlarge) in the China (Hangzhou) region.

1. Log on to the ECS console.

2. In the left-side navigation pane, choose Maintenance & Monitoring > Cloud Assistant.

3. In the upper-left corner of the page, select the region where your target instance is located.

   

4. On the ECS Instances tab, find the target instance and click Run Command in the Actions column.

   

5. Create and run a Cloud Assistant command to upgrade the GRID driver.

   1. In the Create Command panel, configure the parameters in the Command Information section.

      The following table describes the main parameters. Keep the default values for the other parameters. For more information, see Command parameters (console operations).

      Important

      You must set the parameters to the values provided in this topic. Otherwise, the Cloud Assistant command may fail.

      

      • ① Command Type: Select PowerShell.

      • ② Command Content: Enter or paste your command.

        • Cloud Assistant command for vgn6i-vws, vgn7i-vws, and sgn7i-vws instances:

          $InstalledPlugins = $(acs-plugin-manager --list --local)
          if ($($InstalledPlugins | Select-String "grid_driver_install"))
             {
               acs-plugin-manager --remove --plugin grid_driver_install
             } 
          acs-plugin-manager --fetchTimeout 0 --exec --plugin grid_driver_install

        • Cloud Assistant command for sgn8ia, gn8ia, gn8is, gn7i, gn6i, ebmgn8ia, ebmgn8is, ebmgn7i, and ebmgn6i instances:

          $InstalledPlugins = $(acs-plugin-manager --list --local)
          if ($($InstalledPlugins | Select-String "gpu_grid_driver_install"))
             {
               acs-plugin-manager --remove --plugin gpu_grid_driver_install
             } 
          acs-plugin-manager --fetchTimeout 0 --exec --plugin gpu_grid_driver_install

      • ③ Timeout: The timeout period for the command execution on the instance. If the command times out, Cloud Assistant stops the command process. Set this parameter to 600.

        Note

        The value of timeout must be a positive integer in seconds. The value must be in the range of 10 to 86,400 (24 hours). The default value is 60.

   2. Click Run to upgrade the GRID driver using the Cloud Assistant command.

      After the command is run, the following information is displayed on the execution details page. This indicates that an earlier version of the GRID driver is installed on the instance and must be uninstalled before the upgrade.

      

      You must run a Cloud Assistant command to uninstall the currently installed GRID driver, restart the instance, and then run the same Cloud Assistant command again to continue the upgrade. Perform the following steps:

      Important

      It takes about 5 to 10 minutes to uninstall or reinstall the GRID driver. Please wait.

      1. Restart the GPU-accelerated instance.

         For more information, see Restart an instance.

      2. Run the same Cloud Assistant command again to reinstall the new GRID driver.

         After the new GRID driver is automatically installed using the Cloud Assistant command, you can view the execution result on the execution details page.

         

6. Verify that the upgraded GRID driver is in effect.

   1. Restart the GPU-accelerated instance.

      For more information, see Restart an instance.

   2. Remotely connect to the GPU-accelerated instance.

      For more information, see Connect to a Windows instance using Workbench.

   3. On the logon page, right-click a blank area and open NVIDIA Control Panel.

      If the following result is displayed, the new GRID driver is in effect.

Linux

Applicable instances

You can use Cloud Assistant to upgrade the GRID driver only on the following GPU-accelerated instance families that run Linux: vgn6i-vws, vgn7i-vws, and sgn7i-vws.

Procedure

This example is based on a vgn6i-vws instance (ecs.vgn6i-m4-vws.xlarge) in the China (Hangzhou) region.

1. Log on to the ECS console.

2. In the left-side navigation pane, choose Maintenance & Monitoring > Cloud Assistant.

3. In the top-left corner of the page, select the region where your target instance is located.

   

4. On the ECS Instances tab, find the target instance and click Run Command in the Actions column.

   

5. In the Create Command pane, configure the parameters in the Command Information section.

   Configure the main parameters as described below and keep the default values for the other parameters. For more information, see Create a command in the ECS console.

   Important

   You must set the parameters to the exact values provided below. Otherwise, the Cloud Assistant command may fail to run.

   

   • ① Command Type: Select Shell.

   • ② Command content: Paste the following command. For more examples of Shell commands, see View the system configurations of ECS instances.

     • Cloud Assistant command for sgn8ia instances:

       if acs-plugin-manager --list --local | grep gpu_grid_driver_install > /dev/null 2>&1
       then
           acs-plugin-manager --remove --plugin gpu_grid_driver_install
       fi
       
       acs-plugin-manager --exec --plugin gpu_grid_driver_install

     • Cloud Assistant command for vgn6i-vws, vgn7i-vws, and sgn7i-vws instances:

       if acs-plugin-manager --list --local | grep grid_driver_install > /dev/null 2>&1
       then
           acs-plugin-manager --remove --plugin grid_driver_install
       fi
       
       acs-plugin-manager --exec --plugin grid_driver_install

   • ③ Timeout: The maximum execution time in seconds. If the command takes longer than this time to run, Cloud Assistant forcibly terminates the process. Set the value to 600.

     Note

     The Timeout value must be a positive integer in seconds. The value can range from 10 to 86,400 (24 hours).

6. Click Run to automatically upgrade the GRID driver using the Cloud Assistant command.

   After the command is run, you can view the execution result on the execution details page.

   Important

   • If another version of the GRID driver is installed on the instance, Cloud Assistant automatically uninstalls the current GRID driver and reinstalls the latest SWL GRID driver.

   • It takes about 5 to 10 minutes to upgrade the GRID driver. Please wait.

   

7. Connect to the GPU-accelerated instance.

   For more information, see Connect to a Linux instance using Workbench.

8. Check whether the GRID driver is upgraded.

   nvidia-smi

   If the following output is returned, the GRID driver is successfully upgraded.