1. Introduction to NVIDIA Virtual GPU Software Licensing

The following products are available as licensed products on NVIDIA Tesla™ GPUs:

  • NVIDIA® Quadro® Virtual Data Center Workstation (Quadro vDWS)
  • NVIDIA GRID™ Virtual PC
  • GRID Virtual Applications

This guide describes these licensed products and how to enable and use them on supported hardware.

1.1. How NVIDIA Virtual GPU Software Licensing Works

Figure 1 provides an overview of NVIDIA virtual GPU software licensing:

Figure 1. NVIDIA Virtual GPU Software Licensing Architecture

Diagram showing how the licensed products Quadro vDWS, GRID Virtual PC, and GRID Virtual Applications borrow and return licenses from the license server

When enabled on Tesla GPUs, licensed editions of Quadro vDWS or GRID Virtual PC are activated by obtaining a license over the network from an NVIDIA virtual GPU software License Server. The license is “checked out” or “borrowed” at the time the Virtual Machine (VM) is booted, and returned when the VM is shut down.

Note: Information on setting up and running the NVIDIA virtual GPU software License Server is provided in Virtual GPU License Server User Guide.

1.2. NVIDIA Virtual GPU Software License Editions

NVIDIA virtual GPU software licenses come in three editions that enable different classes of features. The NVIDIA virtual GPU software automatically selects the right license edition based on the features being used:

Table 1. NVIDIA Virtual GPU Software License Editions
NVIDIA Virtual GPU Software License Edition NVIDIA Virtual GPU Software Features
GRID Virtual Application
  • Virtual GPUs for virtual application computing
GRID Virtual PC
  • Virtual GPUs for business desktop computing
Quadro vDWS
  • Virtual GPUs for midrange and high-end workstation computing
  • Workstation graphics on GPU passthrough

1.3. How this Guide Is Organized

The remainder of this guide is organized as follows:

2. Licensing NVIDIA vGPU

NVIDIA vGPU is a licensed product. When booted on a supported GPU, a vGPU runs at reduced capability until a license is acquired.

  • Screen resolution is limited to no higher than 1280×1024.
  • Frame rate is capped at 3 frames per second.
  • GPU resource allocations are limited, which will prevent some applications from running correctly.

These restrictions are removed when a license is acquired.

After you license NVIDIA vGPU, the VM that is set up to use NVIDIA vGPU is capable of running the full range of DirectX and OpenGL graphics applications.

If licensing is configured, the virtual machine (VM) obtains a license from the license server when a vGPU is booted on these GPUs. The VM retains the license until it is shut down. It then releases the license back to the license server. Licensing settings persist across reboots and need only be modified if the license server address changes, or the VM is switched to running GPU passthrough.

2.1. NVIDIA vGPU License Requirements

The license edition that you require to use NVIDIA vGPU depends on the vGPU type.

The higher-end license editions are inclusive of lower editions: for example virtual GPUs that require a GRID Virtual PC license are also usable with a Quadro vDWS license.

Note: For more information on NVIDIA vGPU types, refer to Virtual GPU Software User Guide.

2.1.1. Virtual GPUs Licensed on Tesla M60

Virtual GPU Frame Buffer (Mbytes) Virtual Display Heads Maximum Resolution per Display Head Minimum License Edition Required
M60-8Q 8192 4 4096×2160 Quadro vDWS
M60-4Q 4096 4 4096×2160 Quadro vDWS
M60-2Q 2048 4 4096×2160 Quadro vDWS
M60-1Q 1024 2 4096×2160 Quadro vDWS
M60-0Q 512 21 2560×1600 Quadro vDWS
M60-1B 1024 4 2560×1600 GRID Virtual PC
M60-0B 512 21 2560×1600 GRID Virtual PC
M60-8A 8192 1 1280×10242 GRID Virtual Application
M60-4A 4096 1 1280×10242 GRID Virtual Application
M60-2A 2048 1 1280×10242 GRID Virtual Application
M60-1A 1024 1 1280×10242 GRID Virtual Application

2.1.2. Virtual GPUs Licensed on Tesla M10

Virtual GPU Frame Buffer (Mbytes) Virtual Display Heads Maximum Resolution per Display Head Minimum License Edition Required
M10-8Q 8192 4 4096×2160 Quadro vDWS
M10-4Q 4096 4 4096×2160 Quadro vDWS
M10-2Q 2048 4 4096×2160 Quadro vDWS
M10-1Q 1024 2 4096×2160 Quadro vDWS
M10-0Q 512 21 2560×1600 Quadro vDWS
M10-1B 1024 4 2560×1600 GRID Virtual PC
M10-0B 512 21 2560×1600 GRID Virtual PC
M10-8A 8192 1 1280×10242 GRID Virtual Application
M10-4A 4096 1 1280×10242 GRID Virtual Application
M10-2A 2048 1 1280×10242 GRID Virtual Application
M10-1A 1024 1 1280×10242 GRID Virtual Application

2.1.3. Virtual GPUs Licensed on Tesla M6

Virtual GPU Frame Buffer (Mbytes) Virtual Display Heads Maximum Resolution per Display Head Minimum License Edition Required
M6-8Q 8192 4 4096×2160 Quadro vDWS
M6-4Q 4096 4 4096×2160 Quadro vDWS
M6-2Q 2048 4 4096×2160 Quadro vDWS
M6-1Q 1024 2 4096×2160 Quadro vDWS
M6-0Q 512 21 2560×1600 Quadro vDWS
M6-1B 1024 4 2560×1600 GRID Virtual PC
M6-0B 512 21 2560×1600 GRID Virtual PC
M6-8A 8192 1 1280×10242 GRID Virtual Application
M6-4A 4096 1 1280×10242 GRID Virtual Application
M6-2A 2048 1 1280×10242 GRID Virtual Application
M6-1A 1024 1 1280×10242 GRID Virtual Application

2.1.4. Virtual GPUs Licensed on Tesla P100

Virtual GPU Frame Buffer (Mbytes) Virtual Display Heads Maximum Resolution per Display Head Minimum License Edition Required
GRID P100-16Q 16384 4 4096×2160 Quadro vDWS
GRID P100-8Q 8192 4 4096×2160 Quadro vDWS
GRID P100-4Q 4096 4 4096×2160 Quadro vDWS
GRID P100-2Q 2048 4 4096×2160 Quadro vDWS
GRID P100-1Q 1024 2 4096×2160 Quadro vDWS
GRID P100-1B 1024 4 2560×1600 GRID Virtual PC
GRID P100-16A 16384 1 1280×10242 GRID Virtual Application
GRID P100-8A 8192 1 1280×10242 GRID Virtual Application
GRID P100-4A 4096 1 1280×10242 GRID Virtual Application
GRID P100-2A 2048 1 1280×10242 GRID Virtual Application
GRID P100-1A 1024 1 1280×10242 GRID Virtual Application

Since 5.1: Virtual GPUs Licensed on Tesla P100 12GB

Virtual GPU Frame Buffer (Mbytes) Virtual Display Heads Maximum Resolution per Display Head Minimum License Edition Required
GRID P100C-12Q 12288 4 4096×2160 Quadro vDWS
GRID P100C-6Q 6144 4 4096×2160 Quadro vDWS
GRID P100C-4Q 4096 4 4096×2160 Quadro vDWS
GRID P100C-2Q 2048 4 4096×2160 Quadro vDWS
GRID P100C-1Q 1024 2 4096×2160 Quadro vDWS
GRID P100C-1B 1024 4 2560×1600 GRID Virtual PC
GRID P100C-12A 12288 1 1280×10242 GRID Virtual Application
GRID P100C-6A 6144 1 1280×10242 GRID Virtual Application
GRID P100C-4A 4096 1 1280×10242 GRID Virtual Application
GRID P100C-2A 2048 1 1280×10242 GRID Virtual Application
GRID P100-1A 1024 1 1280×10242 GRID Virtual Application

2.1.6. Virtual GPUs Licensed on Tesla P40

Virtual GPU Frame Buffer (Mbytes) Virtual Display Heads Maximum Resolution per Display Head Minimum License Edition Required
GRID P40-24Q 24576 4 4096×2160 Quadro vDWS
GRID P40-12Q 12288 4 4096×2160 Quadro vDWS
GRID P40-8Q 8192 4 4096×2160 Quadro vDWS
GRID P40-6Q 6144 4 4096×2160 Quadro vDWS
GRID P40-4Q 4096 4 4096×2160 Quadro vDWS
GRID P40-3Q 3072 4 4096×2160 Quadro vDWS
GRID P40-2Q 2048 4 4096×2160 Quadro vDWS
GRID P40-1Q 1024 2 4096×2160 Quadro vDWS
GRID P40-1B 1024 4 2560×1600 GRID Virtual PC
GRID P40-24A 24576 1 1280×10242 GRID Virtual Application
GRID P40-12A 12288 1 1280×10242 GRID Virtual Application
GRID P40-8A 8192 1 1280×10242 GRID Virtual Application
GRID P40-6A 6144 1 1280×10242 GRID Virtual Application
GRID P40-4A 4096 1 1280×10242 GRID Virtual Application
GRID P40-3A 3072 1 1280×10242 GRID Virtual Application
GRID P40-2A 2048 1 1280×10242 GRID Virtual Application
GRID P40-1A 1024 1 1280×10242 GRID Virtual Application

2.1.7. Virtual GPUs Licensed on Tesla P6

Virtual GPU Frame Buffer (Mbytes) Virtual Display Heads Maximum Resolution per Display Head Minimum License Edition Required
GRID P6-16Q 16384 4 4096×2160 Quadro vDWS
GRID P6-8Q 8192 4 4096×2160 Quadro vDWS
GRID P6-4Q 4096 4 4096×2160 Quadro vDWS
GRID P6-2Q 2048 4 4096×2160 Quadro vDWS
GRID P6-1Q 1024 2 4096×2160 Quadro vDWS
GRID P6-1B 1024 4 2560×1600 GRID Virtual PC
GRID P6-16A 16384 1 1280×10242 GRID Virtual Application
GRID P6-8A 8192 1 1280×10242 GRID Virtual Application
GRID P6-4A 4096 1 1280×10242 GRID Virtual Application
GRID P6-2A 2048 1 1280×10242 GRID Virtual Application
GRID P6-1A 1024 1 1280×10242 GRID Virtual Application

2.1.8. Virtual GPUs Licensed on Tesla P4

Virtual GPU Frame Buffer (Mbytes) Virtual Display Heads Maximum Resolution per Display Head Minimum License Edition Required
GRID P4-8Q 8192 4 4096×2160 Quadro vDWS
GRID P4-4Q 4096 4 4096×2160 Quadro vDWS
GRID P4-2Q 2048 4 4096×2160 Quadro vDWS
GRID P4-1Q 1024 2 4096×2160 Quadro vDWS
GRID P4-1B 1024 4 2560×1600 Quadro vDWS
GRID P4-8A 8192 1 1280×10242 GRID Virtual Application
GRID P4-4A 4096 1 1280×10242 GRID Virtual Application
GRID P4-2A 2048 1 1280×10242 GRID Virtual Application
GRID P4-1A 1024 1 1280×10242 GRID Virtual Application

2.2. Licensing NVIDIA vGPU on Windows

  1. Open NVIDIA Control Panel:
    • Right-click on the Windows desktop and select NVIDIA Control Panel from the menu.
    • Open Windows Control Panel and double-click the NVIDIA Control Panel icon.
  2. In NVIDIA Control Panel, select the Manage License task in the Licensing section of the navigation pane.
    Note: If the Licensing section and Manage License task are not displayed in NVIDIA Control Panel, the system has been configured to hide licensing controls in NVIDIA Control Panel. For information about registry settings, see Applying Windows License Settings Through the Windows Registry.
    The Manage License task pane shows that NVIDIA vGPU is currently unlicensed.
    Figure 2. Managing vGPU licensing in NVIDIA Control Panel

    Screen capture showing the Manage License option in NVIDIA Control Panel for a vGPU license

  3. In the Primary License Server field, enter the address of your primaryNVIDIA virtual GPU software License Server. The address can be a fully-qualified domain name such as gridlicense1.example.com, or an IP address such as 10.31.20.45. If you have only one license server configured, enter its address in this field.
  4. Leave the Port Number field under the Primary License Server field unset. The port defaults to 7070, which is the default port number used by NVIDIA virtual GPU software License Server.
  5. In the Secondary License Server field, enter the address of your secondary NVIDIA virtual GPU software License Server. If you have only one license server configured, leave this field unset. The address can be a fully-qualified domain name such as gridlicense2.example.com, or an IP address such as 10.31.20.46.
  6. Leave the Port Number field under the Secondary License Server field unset. The port defaults to 7070, which is the default port number used by NVIDIA virtual GPU software License Server.
  7. Click Apply to assign the settings. The system requests the appropriate license for the current vGPU from the configured license server.

The vGPU within the VM should now exhibit full frame rate, resolution, and display output capabilities. The VM is now capable of running the full range of DirectX and OpenGL graphics applications.

If the system fails to obtain a license, see Troubleshooting for guidance on troubleshooting.

2.3. Licensing NVIDIA vGPU on Linux

  1. Start NVIDIA X Server Settings by using the method for launching applications provided by your Linux distribution. For example, on Ubuntu Desktop, open the Dash, search for NVIDIA X Server Settings, and click the NVIDIA X Server Settings icon.
  2. In the NVIDIA X Server Settings window that opens, click Manage GRID License. The License Edition section of the NVIDIA X Server Settings window shows that NVIDIA vGPU is currently unlicensed.
  3. In the Primary Server field, enter the address of your primary NVIDIA virtual GPU software License Server. The address can be a fully-qualified domain name such as gridlicense1.example.com, or an IP address such as 10.31.20.45. If you have only one license server configured, enter its address in this field.
  4. Leave the Port Number field under the Primary Server field unset. The port defaults to 7070, which is the default port number used by NVIDIA virtual GPU software License Server.
  5. In the Secondary Server field, enter the address of your secondary NVIDIA virtual GPU software License Server. If you have only one license server configured, leave this field unset. The address can be a fully-qualified domain name such as gridlicense2.example.com, or an IP address such as 10.31.20.46.
  6. Leave the Port Number field under the Secondary Server field unset. The port defaults to 7070, which is the default port number used by NVIDIA virtual GPU software License Server.
  7. Click Apply to assign the settings. The system requests the appropriate license for the current vGPU from the configured license server.
The vGPU within the VM should now exhibit full frame rate, resolution, and display output capabilities. The VM is now capable of running the full range of DirectX and OpenGL graphics applications.
If the system fails to obtain a license, see Troubleshooting for guidance on troubleshooting.

3. Licensing Quadro vDWS with Pass-Through

This chapter describes how to enable Quadro vDWS with pass-through on supported Tesla GPUs.

3.1. Quadro vDWS Features

Quadro vDWS is available on supported GPUs running in GPU pass-through mode to Windows and Linux VMs. Quadro vDWS requires a Quadro vDWS edition, and provides these features:

  • Up to four virtual display heads at 4K resolution (unlicensed GPUs support a single virtual display head with maximum resolution of 2560×1600)
  • Workstation-specific graphics features and accelerations
  • Certified drivers for professional applications

3.2. Licensing Quadro vDWS on Windows

  1. Open NVIDIA Control Panel:
    • Right-click on the Windows desktop and select NVIDIA Control Panel from the menu.
    • Open Windows Control Panel and double-click the NVIDIA Control Panel icon.
  2. In NVIDIA Control Panel, select the Manage License task in the Licensing section of the navigation pane.
    Note: If the Licensing section and Manage License task are not displayed in NVIDIA Control Panel, the GPU or driver you are using do not support NVIDIA virtual GPU software licensed features.
    The Manage License task pane shows the current License Edition being used, and defaults to unlicensed.
    Figure 3. Managing Quadro vDWS Licensing in NVIDIA Control Panel

    Screen capture showing the Manage License option in NVIDIA Control Panel for a Quadro vDWS license

  3. Select Quadro vDWS.
  4. In the Primary License Server field, enter the address of your primary NVIDIA virtual GPU software License Server. The address can be a fully-qualified domain name such as gridlicense1.example.com, or an IP address such as 10.31.20.45. If you have only one license server configured, enter its address in this field.
  5. Leave the Port Number field under the Primary License Server field unset. It will default to 7070, which is the default port number used by NVIDIA virtual GPU software License Server.
  6. In the Secondary License Server field, enter the address of your secondary NVIDIA virtual GPU software License Server. If you have only one license server configured, leave this field unset. The address can be a fully-qualified domain name such as gridlicense2.example.com, or an IP address such as 10.31.20.46.
  7. Leave the Port Number field under the Secondary License Server field unset. The port defaults to 7070, which is the default port number used by NVIDIA virtual GPU software License Server.
  8. Click Apply to assign the settings. The License Edition section will indicate that your system is running in Quadro vDWS mode. The system will also request the appropriate license for the current GPU from the configured license server. If unsuccessful, the system warns you that it could not obtain a license. If necessary, refer to Troubleshooting for guidance on troubleshooting.
Once configured in NVIDIA Control Panel, licensing settings persist across reboots and need only be modified if the license server address changes, or the VM is switched to running NVIDIA vGPU.

3.3. Disabling Quadro vDWS on Windows

  1. Open NVIDIA Control Panel.
  2. In the Manage License task, select Tesla (unlicensed).
  3. Click Apply.
The setting does not take effect until the next time the system is shut down or rebooted. Quadro vDWS features remain available until then.

3.4. Licensing Quadro vDWS on Linux

  1. Start NVIDIA X Server Settings by using the method for launching applications provided by your Linux distribution. For example, on Ubuntu Desktop, open the Dash, search for NVIDIA X Server Settings , and click the NVIDIA X Server Settings icon.
  2. In the NVIDIA X Server Settings window that opens, click Manage GRID License. The License Edition section of the NVIDIA X Server Settings window shows the current License Edition being used, and defaults to unlicensed.
    Figure 4. Managing Quadro vDWS Licensing in NVIDIA X Server Settings

    Screen capture showing the Manage GRID License option in NVIDIA X Server Settings for a Quadro vDWS license

  3. Select Quadro vDWS.
  4. In the Primary Server field, enter the address of your primary NVIDIA virtual GPU software License Server. The address can be a fully-qualified domain name such as gridlicense1.example.com, or an IP address such as 10.31.20.45. If you have only one license server configured, enter its address in this field.
  5. Leave the Port Number field under the Primary Server field unset. The port defaults to 7070, which is the default port number used by NVIDIA virtual GPU software License Server.
  6. In the Secondary Server field, enter the address of your secondary NVIDIA virtual GPU software License Server. If you have only one license server configured, leave this field unset. The address can be a fully-qualified domain name such as gridlicense2.example.com, or an IP address such as 10.31.20.46.
  7. Leave the Port Number field under the Secondary Server field unset. The port defaults to 7070, which is the default port number used by NVIDIA virtual GPU software License Server.
  8. Click Apply to assign the settings. The License Edition section will indicate that your system is running in Quadro vDWS mode. The system will also request the appropriate license for the current GPU from the configured license server. If unsuccessful, the system warns you that it could not obtain a license. If necessary, refer to Troubleshooting for guidance on troubleshooting.
Once configured in NVIDIA X Server Settings, licensing settings persist across reboots and need only be modified if the license server address changes, or the VM is switched to running NVIDIA vGPU.

4. Advanced Topics

This chapter discusses advanced topics and settings for NVIDIA virtual GPU software licensing.

4.1. Licenses Obtained After Boot

Under normal operation, an NVIDIA virtual GPU software license is obtained by a platform during boot, before user login and launch of applications. If a license is not available, the system will periodically retry its license request to the license server. During this time, NVIDIA vGPU runs at reduced capability as described in Licensing NVIDIA vGPU. Similarly, Quadro vDWS features described in Quadro vDWS Features are not available.

On Windows, unavailability of a license is indicated by a pop-up window or by the license status on the Licensing tab of the NVIDIA Control Panel. On Linux, unavailability of a license is indicated by log messages.

When a license is obtained, the licensed features are dynamically enabled and become available for immediate use. However, any application software launched before the license became available may need to be restarted in order to recognize and utilize the licensed features.

4.2. Operating with Intermittent Connectivity to the License Server

To check out a license, Quadro vDWS, GRID Virtual PC, and GRID Virtual Applications clients require connectivity to a license server when booting. After they have booted, clients may operate without connectivity to the license server for a period of up to 7 days, after which time the client will be warned of license expiration.

4.3. Applying Windows License Settings Through the Windows Registry

NVIDIA virtual GPU software licensing settings can be controlled via the Windows Registry, removing the need for manual interaction with NVIDIA Control Panel. Settings are stored in this registry key:

HKEY_LOCAL_MACHINE\SOFTWARE\NVIDIA Corporation\Global\GridLicensing

Registry values are summarized in Table 2.

Table 2. Licensing Registry Settings
Name Type Description
ServerAddress

String (REG_SZ)

License server address

ServerPort

String (REG_SZ)

License server port number

(Optional: defaults to 7070)

FeatureType

DWord (REG_DWORD)

0: Unlicensed (Tesla edition)

1: NVIDIA vGPU

2: Quadro vDWS

All other values reserved.

NvCplDisableManageLicensePage

DWord (REG_DWORD)

If this regkey is absent, licensing controls are shown in NVIDIA Control Panel for GPUs supporting licensing. When present:

0: Show licensing controls in NVIDIA Control Panel

1: Hide licensing controls in NVIDIA Control Panel

All other values reserved.

LicenseInterval

DWord (REG_DWORD)

An integer in the range 10-10080 that specifies the period of time in minutes for which a license can be borrowed after it is checked out

After this period has elapsed, the client must obtain a new license from the server.

The default is 10080 minutes, which corresponds to a period of 7 days.

DisableExpirationPopups DWord (REG_DWORD)

Disables or enables pop-up notifications for NVIDIA virtual GPU software license expiration.

0: Enable license expiration pop-up notifications

1: Disable license expiration pop-up notifications

(Optional: defaults to 0)

Figure 5 shows an example of configuring virtual GPU licensing settings in the registry. Note it is sufficient to simply configure FeatureType = 1 (NVIDIA vGPU) and set the license server address in ServerAddress.

Figure 5. Configuring vGPU Licensing Through Windows Registry Settings

Screen capture of the Registry Editor window showing NVIDIA vGPU licensing settings

5. Troubleshooting

This chapter describes basic troubleshooting steps.

5.1. Known Issues

Before troubleshooting or filing a bug report, review the release notes that accompany each driver release, for information about known issues with the current release, and potential workarounds.

5.2. Troubleshooting Steps

If an NVIDIA virtual GPU software system fails to obtain a license, investigate the following as potential causes for the failure:

  • Check that the license server address and port number are correctly configured.
  • Run a network ping test from the NVIDIA virtual GPU software system to the license server address to verify that the system has network connectivity to the license server.
  • Verify that the date and time are configured correctly on the NVIDIA virtual GPU software system. If the time is set inaccurately or is adjusted backwards by a large amount, the system may fail to obtain a license.
  • Verify that the license server in use has available licenses of the type required by the NVIDIA virtual GPU software feature the NVIDIA virtual GPU software system is configured to use.

A. Licensing NVIDIA Virtual GPU Software Software on Linux by Using a Configuration File

As an alternative to using NVIDIA X Server Settings, you can license NVIDIA virtual GPU software on Linux by using the configuration file /etc/nvidia/gridd.conf.

A.1. Licensing NVIDIA vGPU on Linux by Using a Configuration File

  1. As root, open the file /etc/nvidia/gridd.conf in a plain-text editor, such as vi.
    [nvidia@localhost ~]$ sudo vi /etc/nvidia/gridd.conf
    Note: You can create the /etc/nvidia/gridd.conf file by copying the supplied template file /etc/nvidia/gridd.conf.template.
  2. Set ServerAddress to the address of your primary NVIDIA virtual GPU software License Server. The address can be a fully-qualified domain name such as gridlicense1.example.com, or an IP address such as 10.31.20.45. If you have only one license server configured, set ServerAddress to the address of the server.
  3. Optional: Set ServerPort to the port number of your primary NVIDIA virtual GPU software License Server. If you do not set ServerPort, it will default to 7070, which is the default port number that is used by the NVIDIA virtual GPU software License Server.
  4. Set BackupServerAddress to the address of your secondary NVIDIA virtual GPU software License Server. The address can be a fully-qualified domain name such as gridlicense2.example.com, or an IP address such as 10.31.20.46. If you have only one license server configured, do not set BackupServerAddress.
  5. Optional: Set BackupServerPort to the port number of your secondary NVIDIA virtual GPU software License Server. If you do not set BackupServerPort, it will default to 7070, which is the default port number that is used by the NVIDIA virtual GPU software License Server. If you have only one license server configured, do not set BackupServerPort.
  6. Set FeatureType to 1, to license vGPU.
  7. Save your changes to the /etc/nvidia/gridd.conf file.
  8. Restart the nvidia-gridd service:
    [nvidia@localhost ~]$  sudo service nvidia-gridd restart
    The nvidia-gridd service requests the appropriate license for the current vGPU from the configured license server.
  9. Optional: Confirm that the service has obtained a license by examining the log messages written to /var/log/messages:
    [nvidia@localhost ~]$ sudo grep gridd /var/log/messages
    …
    Aug 5 15:40:06 localhost nvidia-gridd: Started (4293)
    Aug 5 15:40:24 localhost nvidia-gridd: License acquired successfully.
The vGPU within the VM should now exhibit full frame rate, resolution, and display output capabilities.

gridd.conf File for NVIDIA vGPU

The following example shows a gridd.conf file for NVIDIA vGPU in which options are set as follows:

  • ServerAddress is set to gridlicense1.example.com.
  • BackupServerAddress is set to gridlicense2.example.com.
  • ServerPort and BackupServerPort are both set to 7070.
  • FeatureType is set to 1.
# /etc/nvidia/gridd.conf.template - Configuration file for NVIDIA Grid Daemon

# This is a template for the configuration file for NVIDIA Grid Daemon.
# For details on the file format, please refer to the nvidia-gridd(1)
# man page.

# Description: Set License Server Address
# Data type: string
# Format:  "<address>"
ServerAddress= gridlicense1.example.com

# Description: Set License Server port number
# Data type: integer
# Format:  <port>, default is 7070
ServerPort=7070

# Description: Set Backup License Server Address
# Data type: string
# Format:  "<address>"
BackupServerAddress= gridlicense2.example.com

# Description: Set Backup License Server port number
# Data type: integer
# Format:  <port>, default is 7070
BackupServerPort=7070

# Description: Set Feature to be enabled
# Data type: integer
# Possible values:
#    0 => for unlicensed state
#    1 => for GRID vGPU
#    2 => for Quadro Virtual Datacenter Workstation
FeatureType=1

# Description: Parameter to enable or disable Grid Licensing tab in nvidia-settings
# Data type: boolean
# Possible values: TRUE or FALSE, default is FALSE
#EnableUI=TRUE

# Description: Set license borrow period in minutes
# Data type: integer
# Possible values: 10 to 10080 mins(7 days), default is 10080
#LicenseInterval=10080
If the system fails to obtain a license, see Troubleshooting for guidance on troubleshooting.

A.2. Licensing Quadro vDWS on Linux by Using a Configuration File

  1. As root, open the file /etc/nvidia/gridd.conf in a plain-text editor, such as vi.
    [nvidia@localhost ~]$ sudo vi /etc/nvidia/gridd.conf
    Note: You can create the /etc/nvidia/gridd.conf file by copying the supplied template file /etc/nvidia/gridd.conf.template.
  2. Set ServerAddress to the address of your primary NVIDIA virtual GPU software License Server. The address can be a fully-qualified domain name such as gridlicense1.example.com, or an IP address such as 10.31.20.45. If you have only one license server configured, set ServerAddress to the address of the server.
  3. Optional: Set ServerPort to the port number of your primary NVIDIA virtual GPU software License Server. If you do not set ServerPort, it will default to 7070, which is the default port number that is used by the NVIDIA virtual GPU software License Server.
  4. Set BackupServerAddress to the address of your secondary NVIDIA virtual GPU software License Server. The address can be a fully-qualified domain name such as gridlicense2.example.com, or an IP address such as 10.31.20.46. If you have only one license server configured, do not set BackupServerAddress.
  5. Optional: Set BackupServerPort to the port number of your secondary NVIDIA virtual GPU software License Server. If you do not set BackupServerPort, it will default to 7070, which is the default port number that is used by the NVIDIA virtual GPU software License Server. If you have only one license server configured, do not set BackupServerPort.
  6. Set FeatureType to 2, to license Quadro vDWS.
  7. Save your changes to the /etc/nvidia/gridd.conf file.
  8. Restart the nvidia-gridd service:
    [nvidia@localhost ~]$ sudo service nvidia-gridd restart
    The service should automatically obtain a license.
  9. Optional: Confirm that the service has obtained a license by examining the log messages written to /var/log/messages:
     [nvidia@localhost ~]$ sudo grep gridd /var/log/messages
    …
    Aug 5 17:12:15 localhost nvidia-gridd: Started (10430)
    Aug 5 17:12:34 localhost nvidia-gridd: License acquired successfully.
Once configured in gridd.conf, licensing settings persist across reboots and need only be modified if the license server address changes, or the VM is switched to running NVIDIA vGPU.

gridd.conf File for Quadro vDWS

The following example shows a gridd.conf file for Quadro vDWS in which options are set as follows:

  • ServerAddress is set to gridlicense1.example.com.
  • BackupServerAddress is set to gridlicense2.example.com.
  • ServerPort and BackupServerPort are both set to 7070.
  • FeatureType is set to 2.
# /etc/nvidia/gridd.conf.template - Configuration file for NVIDIA Grid Daemon

# This is a template for the configuration file for NVIDIA Grid Daemon.
# For details on the file format, please refer to the nvidia-gridd(1)
# man page.

# Description: Set License Server Address
# Data type: string
# Format:  "<address>"
ServerAddress= gridlicense1.example.com

# Description: Set License Server port number
# Data type: integer
# Format:  <port>, default is 7070
ServerPort=7070

# Description: Set Backup License Server Address
# Data type: string
# Format:  "<address>"
BackupServerAddress= gridlicense2.example.com

# Description: Set Backup License Server port number
# Data type: integer
# Format:  <port>, default is 7070
BackupServerPort=7070

# Description: Set Feature to be enabled
# Data type: integer
# Possible values:
#    0 => for unlicensed state
#    1 => for GRID vGPU
#    2 => for Quadro Virtual Datacenter Workstation
FeatureType=2

# Description: Parameter to enable or disable Grid Licensing tab in nvidia-settings
# Data type: boolean
# Possible values: TRUE or FALSE, default is FALSE
#EnableUI=TRUE

# Description: Set license borrow period in minutes
# Data type: integer
# Possible values: 10 to 10080 mins(7 days), default is 10080
#LicenseInterval=10080

Notices

Notice

ALL NVIDIA DESIGN SPECIFICATIONS, REFERENCE BOARDS, FILES, DRAWINGS, DIAGNOSTICS, LISTS, AND OTHER DOCUMENTS (TOGETHER AND SEPARATELY, "MATERIALS") ARE BEING PROVIDED "AS IS." NVIDIA MAKES NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.

Information furnished is believed to be accurate and reliable. However, NVIDIA Corporation assumes no responsibility for the consequences of use of such information or for any infringement of patents or other rights of third parties that may result from its use. No license is granted by implication of otherwise under any patent rights of NVIDIA Corporation. Specifications mentioned in this publication are subject to change without notice. This publication supersedes and replaces all other information previously supplied. NVIDIA Corporation products are not authorized as critical components in life support devices or systems without express written approval of NVIDIA Corporation.

HDMI

HDMI, the HDMI logo, and High-Definition Multimedia Interface are trademarks or registered trademarks of HDMI Licensing LLC.

OpenCL

OpenCL is a trademark of Apple Inc. used under license to the Khronos Group Inc.

Trademarks

NVIDIA, the NVIDIA logo, NVIDIA GRID, vGPU, Pascal, Quadro, and Tesla are trademarks or registered trademarks of NVIDIA Corporation in the U.S. and other countries. Other company and product names may be trademarks of the respective companies with which they are associated.

1 This virtual GPU supports only 1 virtual display head on a Windows 10 guest OS.
2 Virtualized applications are rendered in an off-screen buffer. Therefore, the maximum resolution is independent of the maximum resolution of the display head.