For scenarios that require graphics acceleration or graphics rendering, such as OpenGL, Direct3D, and cloud gaming, installing a GRID driver improves the graphics performance of your GPU. This topic describes how to use Cloud Assistant to install a GRID driver on a compute-optimized or vGPU-accelerated GPU instance that runs Windows.
The Cloud Assistant plugin is preinstalled on GPU-accelerated instances. If you plan to use Cloud Assistant to automatically install the GRID driver, we recommend you first review the service. For more information, see Cloud Assistant overview.
Supported instances
Cloud Assistant can install GRID drivers only on the following Windows GPU-accelerated instance families:
Windows-based vGPU-accelerated instance types: sgn8ia, vgn6i-vws, vgn7i-vws, and sgn7i-vws. For more information, see GPU-virtualized (vGPU) instance families (vgn/sgn series). The following table describes the supported GRID driver and CUDA versions for these instances.
Instance family
Public image version
NVIDIA GRID driver version
CUDA version
sgn8ia
Windows Server 2019
Windows Server 2022
538.78
12.2
vgn6i-vws, vgn7i-vws, and sgn7i-vws
Windows Server 2019
Windows Server 2022
475.14
11.4
Windows-based compute-optimized GPU instance types: gn8ia, gn8is, gn7i, gn6i, ebmgn8ia, ebmgn8is, ebmgn7i, and ebmgn6i. For more information, see Compute-optimized GPU instance families (gn/ebm/scc series). The following table describes the supported GRID driver and CUDA versions for these instances.
Public image version
NVIDIA GRID driver version
CUDA version
Windows Server 2019
Windows Server 2022
538.78
12.2
Procedure
This topic uses an ecs.vgn6i-m4-vws.xlarge instance in the China (Hangzhou) region as an example.
-
Log on to the ECS console.
In the left-side navigation pane, choose .
In the top navigation bar, select the region where the target instance is located.
On the ECS Instance tab, find the target instance, and then click Run Command in the Actions column.
Create and run a Cloud Assistant command to install the GRID driver.
In the Create Command panel, configure the parameters in the Command Information section.
The key parameters are described below. Use the default values for all other parameters. For more information, see Create a command on the ECS console.
ImportantSet the parameters exactly as specified. Otherwise, the command may fail.
Command Type: Select PowerShell. Both Bat and PowerShell command types are supported.
Command: 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_installCloud 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 Period: Set the timeout period for the command. If the command times out, Cloud Assistant terminates the process. Set this parameter to 600.
NoteThe Timeout Period value must be a positive integer from 10 to 86,400. Unit: seconds. The default value is 60 seconds.
Click Run to execute the command and install the GRID driver.
You only need to run this command once to install the driver.
Verify the installation.
Restart the GPU-accelerated instance.
For more information, see Restart an instance.
Remotely connect to the GPU-accelerated instance.
For more information, see Connect to an instance by using Workbench.
On the desktop, right-click a blank area and open the NVIDIA Control Panel to view the installed GRID driver version.
The driver version and vGPU configuration are displayed in the panel.
For example, the driver version is 475.14 and the vGPU configuration is GRID T4-4Q.
Related documents
If you purchased a vGPU-accelerated instance that runs Linux, you can install a GRID driver for general-purpose computing scenarios such as AI, or for graphics acceleration and rendering scenarios such as OpenGL, Direct3D, and cloud gaming. For more information, see Install a GRID driver on a vGPU-accelerated instance (Linux).
To automatically load a GRID driver when creating a GPU-accelerated instance, select an image with a pre-installed GRID driver. For more information, see Load a GRID driver by using an image with a pre-installed driver.