Configuring a Licensed Client of NVIDIA License System#

A client with a network connection obtains a license by leasing it from a NVIDIA License System service instance. The service instance serves the license to the client over the network from a pool of floating licenses obtained from the NVIDIA Licensing Portal. The license is returned to the service instance when the licensed client no longer requires the license.

Before configuring a licensed client, ensure that the following prerequisites are met:

  • If you are using a Delegated License Service (DLS) instance to serve licenses, ensure that you are using at minimum release 3.4 of the DLS virtual appliance. Earlier releases of the DLS virtual appliance are incompatible with this release of NVIDIA vGPU software.

    For more information about the prerequisites for using this release of NVIDIA vGPU software, refer to NVIDIA License System User Guide. These requirements are met automatically for Cloud License Service (CLS) instances, which are hosted on the NVIDIA Licensing Portal.

  • The NVIDIA vGPU software graphics driver is installed on the client.

  • The client configuration token that you want to deploy on the client has been created from the NVIDIA Licensing Portal or the DLS as explained in Generating a Client Configuration Token in NVIDIA License System User Guide.

  • Ports 443 and 80 in your firewall or proxy must be open to allow HTTPS traffic between a service instance and its licensed clients. These ports must be open for both CLS instances and DLS instances.

    Note

    For DLS releases before DLS 1.1, ports 8081 and 8082 were also required to be open to allow HTTPS traffic between a DLS instance and its licensed clients. Although these ports are no longer required, they remain supported for backward compatibility.

The NVIDIA vGPU software graphics driver creates a default location in which to store the client configuration token on the client. If you want to use this location for the client configuration token and, on Windows, are configuring the client with NVIDIA vGPU, you can configure the client with default settings. Otherwise, you must configure the client with custom settings as explained in Configuring a Licensed Client with Custom Settings.

The process for configuring a licensed client is the same for CLS and DLS instances but depends on the OS that is running on the client.

Configuring a Licensed Client on Windows with Default Settings#

Perform this task from the client.

  1. Copy the client configuration token to the %SystemDrive%\Program Files\NVIDIA Corporation\vGPU Licensing\ClientConfigToken folder.

  2. Restart the NvDisplayContainer service.

The NVIDIA service on the client should now automatically obtain a license from the CLS or DLS instance.

Configuring a Licensed Client on Linux with Default Settings#

Perform this task from the client.

  1. As root, open the file /etc/nvidia/gridd.conf in a plain-text editor, such as vi.

    $ 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. Add the FeatureType configuration parameter to the file /etc/nvidia/gridd.conf on a new line as FeatureType="<value>".

    <value> depends on the type of the GPU assigned to the licensed client that you are configuring.

    GPU Type

    Value

    NVIDIA vGPU

    1. NVIDIA vGPU software automatically selects the correct type of license based on the vGPU type.

    Physical GPU

    • 0: NVIDIA Virtual Applications

    • 2: NVIDIA RTX Virtual Workstation

    Note

    You can also perform this step from NVIDIA X Server Settings. Before using NVIDIA X Server Settings to perform this step, ensure that this option has been enabled as explained in Enabling License Management in NVIDIA X Server Settings.

    This example shows how to configure a licensed Linux client for NVIDIA RTX Virtual Workstation.

    # /etc/nvidia/gridd.conf.template - Configuration file for NVIDIA Grid Daemon
    
    # Description: Set Feature to be enabled
    # Data type: integer
    # Possible values:
    # 0 => for unlicensed state
    # 1 => for NVIDIA vGPU
    # 2 => for NVIDIA RTX Virtual Workstation
    # 4 => for NVIDIA vGPU for Compute
    FeatureType=2
    ...
    
  3. Copy the client configuration token to the /etc/nvidia/ClientConfigToken directory.

  4. Ensure that the file access modes of the client configuration token allow the owner to read, write, and execute the token, and the group and others only to read the token.

    1. Determine the current file access modes of the client configuration token.

      # ls -l <client-configuration-token-directory>
      
    2. If necessary, change the mode of the client configuration token to 744.

      # chmod 744 <client-configuration-token-directory>/client_configuration_token_*.tok
      
    <client-configuration-token-directory>

    The directory to which you copied the client configuration token in the previous step.

  5. Save your changes to the /etc/nvidia/gridd.conf file and close the file.

  6. Restart the nvidia-gridd service.

The NVIDIA service on the client should now automatically obtain a license from the CLS or DLS instance.