Delegated License Service User Guide
NVIDIA Delegated License Service User Guide
Documentation for system administrators that explains how to install, configure, and manage the Delegated License Service.
The NVIDIA License System is used to serve a pool of floating licenses to licensed NVIDIA software products. The NVIDIA License System is configured with licenses obtained from the NVIDIA Licensing Portal.
Note:NVIDIA vGPU software releases earlier than 13.0 do not support NVIDIA License System. For full details of NVIDIA vGPU software releases that support NVIDIA License System, refer to NVIDIA Delegated License Service Release Notes.
1.1. Introduction to NVIDIA Software Licensing
To activate licensed functionalities, a licensed client leases a software license served over the network from an NVIDIA License System service instance when the client is booted. The license is returned to the service instance when the licensed client is shut down.
1.2. About Service Instances
A service instance is required to serve licenses to licensed clients.
NVIDIA License System supports the following types of service instances:
- Cloud License Service (CLS) instance. A CLS instance is hosted on the NVIDIA Licensing Portal.
- Delegated License Service (DLS) instance. A DLS instance is hosted on-premises at a location that is accessible from your private network, such as inside your data center.
To provide isolation for performance, security, and ease of administration, you can deploy multiple service instances as needed. For example, you can deploy service instances in distinct physical locations by deploying a DLS instance in each of your data centers. You can also use a mixture of CLS and DLS instances to serve your licenses to licensed clients.
1.2.1. About Cloud License Service (CLS) Instances
A Cloud License Service (CLS) instance is hosted on the NVIDIA Licensing Portal.
Because a CLS instance is hosted on the NVIDIA Licensing Portal, you do not need to download licenses from the NVIDIA Licensing Portal and upload them to the instance.
Hosting a CLS instance on a cloud service provides robustness and dynamic scalability for the CLS instance. Because a CLS instance is maintained by NVIDIA and the cloud service provider, feature and maintenance updates are generally transparent to users.
1.2.2. About Delegated License Service (DLS) Instances
A Delegated License Service (DLS) instance is hosted on-premises at a location that is accessible from your private network, such as inside your data center.
Because a DLS instance is fully disconnected from the NVIDIA Licensing Portal, you must download licenses from the NVIDIA Licensing Portal and upload them to the instance manually.
1.3. High Availability for NVIDIA License System DLS Instances
To provide licensed clients with continued access to licenses if a DLS instance fails, you can configure DLS instances for high availability.
High availability requires two DLS instances in a failover configuration:
- A primary DLS instance, which is actively serving licenses to licensed clients
- A secondary DLS instance, which acts as a backup for the primary DLS instance
Configuring two DLS instances in a failover configuration increases availability because simultaneous failure of two instances is rare. The primary and secondary license DLS instances work together to ensure that licenses in the enterprise remain continually available to licensed clients.
If the primary DLS instance fails, failover occurs. The secondary DLS instance becomes the primary instance and begins to serve licenses. The DLS instance that failed becomes the secondary instance when it is returned to service. The next time that failover occurs, the roles of the primary DLS instance and secondary DLS instance are reversed again.
Note: To ensure that licenses in the enterprise remain continually available after failure of the primary DLS instance, return the failed DLS instance to service as quickly as possible to restore high availability support. After failure of a DLS instance, the remaining instance becomes a single point of failure.
During normal operation, the primary DLS instance continually updates the secondary DLS instance with information about the licenses that are being served to clients.
For more information about configuring DLS instances for high availability, see Configuring an HA Cluster of DLS Instances.
To simplify installation and administration of the DLS, the DLS is distributed as a virtual appliance image to be installed on your chosen hypervisor. The DLS is a secure, hardened environment in which access to the operating system and application software is strictly controlled. Each DLS virtual appliance is configured with a fixed set of user accounts. You cannot modify these user accounts or add other user accounts to the appliance.
After verifying the requirements in Platform Requirements for a DLS Virtual Appliance and reviewing the guidelines in Sizing Guidelines for a DLS Virtual Appliance, install and configure the DLS virtual appliance by following this sequence of instructions:
- Installing the DLS Virtual Appliance
- If necessary: Setting the IP Address of a DLS Virtual Appliance from the Hypervisor
- Registering the DLS Administrator User
- Instructions for configuring a standalone DLS instance or a high availability (HA) cluster of DLS instances:
- Optional: Setting the Static IP Address of a DLS Virtual Appliance
2.1. Platform Requirements for a DLS Virtual Appliance
Before proceeding, ensure that you have a platform suitable for hosting a DLS virtual appliance.
- The hosting platform must be a physical host running a supported hypervisor.
- The minimum configuration for the VM in which the virtual appliance will run is as follows:
- Number of vCPUs: 4
- RAM: 8 Gbytes
- Disk Size: 10 Gbytes
- The platform must have a fixed (unchanging) IP address. The IP address may be assigned dynamically by DHCP or statically configured, but must be constant.
- The platform’s date and time must be set accurately. NTP is recommended.
Note: Before proceeding with the installation, refer to NVIDIA Delegated License Service Release Notes for details of supported hypervisors and known issues.
2.2. Host Name Resolution Requirements for a DLS Virtual Appliance
The platform that hosts a DLS virtual appliance must be identified by its IP address or its fully qualified domain name. If you want to identify the platform by its fully qualified domain name, ensure that the required DNS entries are set before installing the DLS virtual appliance. If you want to identify the platform by its default host name, you must set a DNS entry that maps the default host name to the fully qualified domain name.
The process for setting these DNS entries is separate from the process for installing the DLS virtual appliance. Use the standard interfaces of the name resolution service that you are using to set the required DNS entries.
When the VM that hosts a DLS instance starts, the DLS instance checks whether a fully qualified domain name is mapped to the IP address of the VM. If a name is mapped to the IP address of the VM, the DLS instance retrieves the name to display in the user interface of the NVIDIA Licensing application on the appliance.
2.3. Communications Ports Requirements
To enable communication between a licensed client and a CLS or DLS instance, specific ports must be open in your firewall or proxy server. If you are using an HA cluster of DLS instances with a firewall or proxy server between the DLS instances, additional ports must be open in your firewall or proxy server.
Communications Ports Between a Licensed Client and a CLS Instance
To enable communication between a licensed client and a CLS instance, the following ports must be open in your firewall or proxy server:
- 80
- 443
Communications Ports Between a Licensed Client and a DLS Instance
To enable communication between a licensed client and a DLS instance, the following ports must be open in your firewall or proxy server:
- 80
- 443
- 8081
- 8082
Communications Ports Between DLS Instances in an HA Cluster
If you are using an HA cluster of DLS instances with a firewall or proxy server between the DLS instances, the following ports must also be open in the firewall or proxy server:
- 80
- 443
- 1883
- 4369
- 5672
- 8080
- 8081
- 8082
- 8083
- 8084
- 8085
- 8883
- 15672
- 25672
- 61613
- 61614
2.4. Sizing Guidelines for a DLS Virtual Appliance
Use the measured performance numbers to determine the optimum VM configuration for your DLS instances based on the expected number and frequency of requests from licensed clients.
2.4.1. Throughput for a DLS Virtual Appliance
Throughput measures the number of requests per second that a DLS virtual appliance can process.
All measurements were conducted with a CPU clock speed of 2.6 GHz.
Number of vCPUs | Total RAM (GB) | RAM Consumed (GB) | Throughput (Requests per Second) |
---|---|---|---|
4 | 8 | 4 | 30 |
6 | 12 | 6 | 50 |
2.4.2. Scalability DLS Virtual Appliance
Scalability measures the number of licensed clients served or licensing operations performed in a specific interval. A licensing operation is the borrowing, return, or renewal of a license. Registration of a licensed client is not considered a licensing operation because it occurs only once for any client.
All measurements were conducted with a CPU clock speed of 2.6 GHz and 8 GBytes of RAM.
Interval | Licensing Operations Performed | |
---|---|---|
4 vCPUs | 6 vCPUs | |
1.5 minutes | 90 | 150 |
1 hour | 3,600 | 6,000 |
6 hours | 21,600 | 36,000 |
12 hours | 43,200 | 72,000 |
24 hours | 84, 600 | 144,000 |
These measurements capture the different lengths of time up to 24 hours for which a license is borrowed. Intervals in the table are periodic intervals when a client contacts the DLS virtual appliance to request a licensing operation.
The measurements are based on the following assumptions:
- A license is borrowed for at least 10 minutes.
- The minimum renewal interval is 15% of the minimum length of time for which a license is borrowed, that is, 1.5 minutes.
The measurements show that every 1.5 minutes, a DLS virtual appliance with 4 vCPUs can scale up to process licensing operations from 90 clients within 1s.
2.4.3. Burst Load Performance for a DLS Virtual Appliance
Burst load performance measures the time that a DLS virtual appliance requires to process a specific number of requests received in a specific interval of time.
Note: Burst processing times are illustrative only because they are for retry logic in performance tests that use simulated client drivers. Times may differ with real client drivers.
Processing Time | Number of Requests | Interval |
---|---|---|
15 seconds | 100 | 1 second |
3 minutes | 1,000 | 1 second |
15 minutes | 5,000 | 5 seconds |
30 minutes | 10,000 | 5 seconds |
2.5. Installing the DLS Virtual Appliance
DLS virtual appliance images are available for several hypervisors. You use standard interfaces of the hypervisor to install the DLS virtual appliance on your chosen hypervisor.
The DLS virtual appliance image for each supported hypervisor except Red Hat Enterprise Linux KVM specifies the minimum configuration for the VM as listed in Platform Requirements for a DLS Virtual Appliance. You are not required to specify the VM configuration when you install the DLS virtual appliance for these hypervisors. After installing the DLS virtual appliance, you can use standard interfaces of the hypervisor to change the configuration of the VM if necessary.
2.5.1. Installing the DLS Virtual Appliance on Citrix Hypervisor
The DLS image for Citrix Hypervisor is distributed as a ZIP archive that contains an XVA file, which is a format that is specific to Xen-based hypervisors.
Use the Citrix XenCenter Import wizard to perform this task on the Citrix Hypervisor host on which you want to run the DLS virtual appliance.
For additional information, see Import VMs From XVA on the Citrix product documentation website.
- Download the ZIP archive that contains the XVA file that contains the DLS virtual appliance image to the hypervisor host.
- Extract the contents of the ZIP archive that you downloaded.
- In Citrix XenCenter, from the File menu, choose Import.
- Browse for and select the downloaded XVA file, and click Next.
- Select the server on which the imported VM will be placed and click Next.
- Select the storage repository where the virtual disks for the newly imported VM will be stored and click Import.
- Select the default virtual network interfaces in the template for the virtual appliance and click Next.
- Review the settings for importing the virtual machine and click Finish to create the virtual machine.
- Start the VM that you created.
Allow approximately 15 minutes after the VM is started for the installation of the DLS virtual appliance to complete and for the DLS virtual appliance to start. What to do after the DLS virtual appliance starts depends on whether the VM has been assigned an IP address automatically, for example, by a DHCP server:
-
If the VM has been assigned an IP address, what to do next depends on whether you are performing a new installation or are upgrading an existing DLS instance:
- If you are performing a new installation, register the DLS administrator user on the appliance as explained in Registering the DLS Administrator User.
- If you are upgrading an existing DLS instance, migrate the existing DLS instance as explained in Migrating a DLS Instance.
-
Otherwise, set the IP address of the DLS virtual appliance from the hypervisor as explained in Setting the IP Address of a DLS Virtual Appliance from the Hypervisor.
- If you are performing a new installation, register the DLS administrator user on the appliance as explained in Registering the DLS Administrator User.
- If you are upgrading an existing DLS instance, migrate the existing DLS instance as explained in Migrating a DLS Instance.
2.5.2. Installing the DLS Virtual Appliance on Microsoft Windows Server with Hyper-V
The DLS image for Microsoft Windows Server with Hyper-V is distributed as a ZIP archive.
Use Hyper-V Manager to perform this task on the Microsoft Windows Server with Hyper-V host on which you want to run the DLS virtual appliance.
For additional information, see Import a Virtual Machine on the Microsoft documentation website.
- Download the ZIP archive that contains the DLS virtual appliance image to the hypervisor host.
- Extract the contents of the ZIP archive that you downloaded.
- From the Hyper-V ManagerActions menu, choose Import Virtual Machine.
- Browse for and select the folder to which you extracted the DLS virtual appliance image and click Next.
- When prompted to choose the type of import, select the Copy the virtual machine (create a new unique ID) option and click Next.
Browse for and select the folders in which you want to store virtual machine (VM) files and click Next.
- Browse for and select the folder for storing the virtual disk.
Note:
Note: If you are creating two VMs for a cluster of DLS instances, ensure that you choose a unique folder for each VM to prevent errors from Hyper-V Manager.
- Review the settings for importing the VM and click Finish to create the VM.
- After the VM has been created, specify the virtual switch that the VM should use.
- From the Actions menu under the name of the imported VM, choose Settings.
- Under Hardware in the left navigation bar of the Settings window, select Network Adapter, select the virtual switch from the Virtual switch drop-down list, and click Apply.
- Start the imported VM.
- From the Actions menu under the name of the imported VM, choose Connect.
- In the Virtual Machine Connection window that opens, click Start.
A command window opens when the installation of the imported VM is started. Use this window to log in to the DLS virtual appliance only if you need to set the IP address of the DLS virtual appliance from the hypervisor.
Allow approximately 15 minutes after the VM is started for the installation of the DLS virtual appliance to complete and for the DLS virtual appliance to start. What to do after the DLS virtual appliance starts depends on whether the VM has been assigned an IP address automatically, for example, by a DHCP server:
-
If the VM has been assigned an IP address, what to do next depends on whether you are performing a new installation or are upgrading an existing DLS instance:
- If you are performing a new installation, register the DLS administrator user on the appliance as explained in Registering the DLS Administrator User.
- If you are upgrading an existing DLS instance, migrate the existing DLS instance as explained in Migrating a DLS Instance.
-
Otherwise, set the IP address of the DLS virtual appliance from the hypervisor as explained in Setting the IP Address of a DLS Virtual Appliance from the Hypervisor.
After the VM has started, you can get its IP address from the Networking tab for the VM in Hyper-V Manager.
2.5.3. Installing the DLS Virtual Appliance on Red Hat Enterprise Linux KVM
The DLS image for Red Hat Enterprise Linux KVM is distributed as a ZIP archive that contains a QEMU copy-on-write (QCOW2) image file. After preparing the QCOW2 file, install the image by using Virtual Machine Manager to create a VM from the QCOW2 file.
Perform this task from the Red Hat Enterprise Linux KVM host.
- Download the ZIP archive that contains the QCOW2 image file to the Red Hat Enterprise Linux KVM host.
- Extract the contents of the ZIP archive that you downloaded.
- Copy the QCOW2 image file to the /var/lib/libvirt/images directory on the Red Hat Enterprise Linux KVM host.
- Start Virtual Machine Manager.
- Add a connection to the Red Hat Enterprise Linux KVM host.
- In the Virtual Machine Manager window, from the File menu, choose Add Connection.
- In the Add Connection window that opens, set the options in the following table and click Connect.
Option Setting Hypervisor From the drop-down list, select QEMU/KVM. Connect to remote host over SSH Select this option. User Name In this text-entry field, type root. Hostname In this text-entry field, type the IP address or the fully qualified host name of the Red Hat Enterprise Linux KVM host.
The connection is added to the Virtual Machine Manager window.
- Context click the connection that you added in the previous step and choose New. The Create a new virtual machine wizard starts.
- In the first New VM window, select the Import existing disk image option and click Forward.
- In the second New VM window, import the downloaded QCOW2 image file and choose the operating system to install.
- Click Browse.
- In the Choose Storage Volume window that opens, select the downloaded QCOW2 image file and click Choose Volume.
- Back in the second New VM window, type CentOS 8 in the search box and from the list of operating systems that opens, select CentOS 8 (centos8).
- Click Forward.
- In the third New VM window, set Memory to 8192 MiB and CPUs to 4, and click Forward.
- In the final New VM window, specify the VM name and the network that the VM will use.
- In the Name text-entry field, type your choice of name for the VM that you are creating.
- Select the Customize configuration before install option.
- From the Network Selection drop-down list, select the network that the VM will use.
- Click Finish.
- In the window for reviewing a new VM, in the left navigation bar, select Display Spice and from the Type drop-down list, select VNC Server.
- Click Apply to save your changes to the configuration and click Begin Installation.
- After the VM is created, click the play button to start the VM on the Red Hat Enterprise Linux KVM host.
A command window opens when the VM starts. Use this window to log in to the DLS virtual appliance only if you need to set the IP address of the DLS virtual appliance from the hypervisor.
Allow approximately 15 minutes after the VM is started for the installation of the DLS virtual appliance to complete and for the DLS virtual appliance to start. What to do after the DLS virtual appliance starts depends on whether the VM has been assigned an IP address automatically, for example, by a DHCP server:
-
If the VM has been assigned an IP address, what to do next depends on whether you are performing a new installation or are upgrading an existing DLS instance:
- If you are performing a new installation, register the DLS administrator user on the appliance as explained in Registering the DLS Administrator User.
- If you are upgrading an existing DLS instance, migrate the existing DLS instance as explained in Migrating a DLS Instance.
-
Otherwise, set the IP address of the DLS virtual appliance from the hypervisor as explained in Setting the IP Address of a DLS Virtual Appliance from the Hypervisor.
- If you are performing a new installation, register the DLS administrator user on the appliance as explained in Registering the DLS Administrator User.
- If you are upgrading an existing DLS instance, migrate the existing DLS instance as explained in Migrating a DLS Instance.
2.5.4. Installing the DLS Virtual Appliance on VMware vSphere
The DLS image for VMware vSphere is distributed as a ZIP archive that contains an Open Virtual Appliance (OVA) file.
Use the VMware vSphere Client to perform this task on the ESXi server on which you want to run the DLS virtual appliance.
For additional information, see the following topics on the VMware Docs site:
- Download the ZIP archive that contains the OVA file that contains the DLS image for VMware vSphere.
- Extract the contents of the ZIP archive that you downloaded.
- Log in to vCenter Server by using the VMware vSphere Client.
- From the VMware vSphere ClientActions menu, choose Deploy OVF Template.
- Select the Local file option, browse for and select the downloaded OVA file, and click Next.
- Enter the your choice of virtual machine name, select a location for the virtual machine, and click Next.
- Select a compute resource where the virtual machine will be created and click Next.
- Review the details of the template that you are deploying and click Next.
- Select the storage for the virtual appliance configuration and disk files and click Next.
- Leave the destination network as-is, set the IP allocation option to Static - Manual, and click Next.
- Review all the details of the virtual machine that you are creating and click Finish.
- Start the VM that you created.
Allow approximately 15 minutes after the VM is started for the installation of the DLS virtual appliance to complete and for the DLS virtual appliance to start. What to do after the DLS virtual appliance starts depends on whether the VM has been assigned an IP address automatically, for example, by a DHCP server:
-
If the VM has been assigned an IP address, what to do next depends on whether you are performing a new installation or are upgrading an existing DLS instance:
- If you are performing a new installation, register the DLS administrator user on the appliance as explained in Registering the DLS Administrator User.
- If you are upgrading an existing DLS instance, migrate the existing DLS instance as explained in Migrating a DLS Instance.
-
Otherwise, set the IP address of the DLS virtual appliance from the hypervisor as explained in Setting the IP Address of a DLS Virtual Appliance from the Hypervisor.
- If you are performing a new installation, register the DLS administrator user on the appliance as explained in Registering the DLS Administrator User.
- If you are upgrading an existing DLS instance, migrate the existing DLS instance as explained in Migrating a DLS Instance.
2.6. Setting the IP Address of a DLS Virtual Appliance from the Hypervisor
If the VM that hosts a DLS virtual appliance has not been assigned an IP address automatically, you must set the IP address from the hypervisor. Each DLS virtual appliance provides a shell script specifically for this purpose and is configured with a user account for running the script.
- Use the hypervisor management console of the appliance to log in as the user dls_system to the VM that hosts the DLS virtual appliance. You don't need to provide a password to log in as the dls_system user.
- Run the /etc/adminscripts/set-static-ip-cli.sh script.
$ /etc/adminscripts/set-static-ip-cli.sh
- When prompted, enter the details of the IP address. The script presents any default values that are already set for the virtual appliance's network.
- Enter the number that denotes the IP version that the virtual appliance's network uses.
- For an IPv4 network, type 4.
- For an IPv6 network, type 6.
- Enter the IP address that you want to assign to the DLS virtual appliance.
- Enter the IP address of the DLS virtual appliance's default gateway.
Note:
Note: If you omit the default gateway address, the DLS virtual appliance uses DHCP settings.
- Enter the IP address of the first DNS server to be used for name resolution.
- Enter the IP address of the second DNS server to be used for name resolution.
- Enter the subnet mask of the DLS virtual appliance's network in classless inter-domain routing (CIDR) format.
- Enter the number that denotes the IP version that the virtual appliance's network uses.
After the IP address has been set, log files containing progress message from the script are available in the /tmp/static-ip-cli-logs directory.
What to do next depends on whether you are performing a new installation or are upgrading an existing DLS instance:
- If you are performing a new installation, register the DLS administrator user on the appliance as explained in Registering the DLS Administrator User.
- If you are upgrading an existing DLS instance, migrate the existing DLS instance as explained in Migrating a DLS Instance.
2.7. Registering the DLS Administrator User
Each DLS virtual appliance is configured with a user account specifically for administering the DLS. This account provides access through a web-based management interface to the NVIDIA Licensing application on the appliance. Before administering a DLS virtual appliance, you must register this user to be able to access this management interface.
If you intend to configure a cluster of DLS instances, you need perform this task only for the DLS instance from which you will configure the cluster. The registration of the DLS administrator user is propagated from this instance to the other instance when you configure the cluster.
- Open a web browser and connect to the URL
https://dls-vm-ip-address
.- dls-vm-ip-address
-
The IP address or, if defined, the fully qualified domain name of the VM on which the DLS virtual appliance is installed.
You can get the IP address from the management console of your hypervisor.
- On the Set Up page that opens, click NEW INSTALLATION.
- On the Register User page that opens, provide a password for the user dls_admin, and confirm the password.
The password must be at least eight characters long and is case sensitive.
Note:Note: If the DLS administrator user has already been registered, the login page opens instead of the Register User page.
- Determine whether you want to create an additional user that will be able to access the log files for the DLS virtual appliance. This additional user will be created with the user name dls_diagnostics and the password that you provide for the dls_admin user. The dls_diagnostics user will be able to access the log files for the DLS virtual appliance by logging in to the DLS virtual appliance from the hypervisor console.
- If you want to create this additional user, ensure that the Create a diagnostic user option remains selected.
- Otherwise, deselect the Create a diagnostic user option.
- Click REGISTER. The Register User page is refreshed to confirm that the user has been registered and displays a local reset secret to enable you to reset the user's password.
- Copy the local reset secret and store it securely, for example, by clicking the clipboard icon and pasting the local reset secret into a plain text file that is readable only by you. You will need this key to reset the DLS administrator user's password.
- Click CONTINUE TO LOGIN.
- On the login page that opens, type the user name of the DLS administrator user, provide the password that you set for this user, and click LOGIN.
If you want to use the virtual appliance for a single DLS instance, configure the instance as explained in Configuring a Standalone DLS Instance.
If you want to use the virtual appliance in an HA cluster of DLS instances, configure the cluster as explained in Configuring an HA Cluster of DLS Instances.
If you need to reset the DLS administrator user's password, follow the Forgot Password? link on the login page and, when prompted, type the local reset secret, provide a new password for this user, and confirm the new password.
2.8. Retrieving the DLS Administrator User's Reset Secret
If you need to reset the DLS administrator user's password but do not have the local reset secret, you can download a reset secret from the NVIDIA Licensing Portal.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- In the left navigation pane, click SERVICE INSTANCES.
- In the list of service instances on the Service Instances page that opens, follow the Download Reset Secret link for the DLS instance. A file named dls_local_reset_secret_mm-dd-yyyy-hh-mm-ss.tok is saved to your default downloads folder.
When resetting the DLS administrator user's password, upload the reset secret to the DLS instance.
2.9. Logging in to a DLS Virtual Appliance
Each DLS virtual appliance is configured with a user account specifically for administering the DLS. This account provides access through a web-based management interface to the NVIDIA Licensing application on the appliance.
Ensure that the DLS administrator user has been registered for the appliance as explained in Registering the DLS Administrator User.
- Open a web browser and connect to the URL
https://dls-vm-ip-address
.- dls-vm-ip-address
-
The IP address or, if defined, the fully qualified domain name of the VM on which the DLS virtual appliance is installed.
You can get the IP address from the management console of your hypervisor.
- On the login page that opens, provide the user credentials for the DLS administrator user on the DLS virtual appliance and click LOGIN.
2.10. Configuring a Standalone DLS Instance
A standalone DLS instance must be registered before it can be used.
Ensure that the following prerequisites are met:
- The DLS virtual appliance that will host the instance has been installed and started.
- The DLS administrator user has been registered on the virtual appliance that will host the DLS instance.
- The DLS instance has not been configured as a member of a highly available (HA) cluster of DLS instances.
- Log in to the DLS virtual appliance that will host the DLS instance.
- In the left navigation pane, click SERVICE INSTANCE.
- On the Service Instance page that opens, under Node Configuration, ensure that the Enable High Availability option is not set.
- Click CREATE STANDALONE to start the configuration and wait for it to complete. The Service Instance page displays the progress of the standalone DLS instance configuration.
When the configuration is complete, the Service Instance page is updated to show the node health of the standalone DLS instance. If you intend to use a static IP address for the virtual appliance that is hosting the DLS instance, set the address as explained in Setting the Static IP Address of a DLS Virtual Appliance. Otherwise, configure the DLS instance as explained in Configuring a Service Instance.
2.11. Configuring an HA Cluster of DLS Instances
To provide licensed clients with continued access to licenses if a DLS instance fails, you can configure a two-node highly available (HA) cluster of DLS instances in a failover configuration. A failover configuration consists of a primary instance, which is actively serving licenses to licensed clients, and a secondary instance, which acts as a backup for the primary instance.
Ensure that the following prerequisites are met:
- The DLS virtual appliances that will host the DLS instances to be configured in a cluster have been installed and started.
- The DLS administrator user has been registered only on one virtual appliance. The registration of the DLS administrator user is propagated to the other instance when you configure the cluster.
- The DLS instances to be configured in a cluster have not been configured as standalone DLS instances.
Note:
Note: If you want to convert a standalone DLS instance into a node in an HA cluster, follow the instructions in Converting a Standalone DLS Instance into a Node in an HA Cluster.
- Log in to the DLS virtual appliance on which the DLS administrator user has been registered. After the cluster is configured, this DLS virtual appliance will initially host the primary DLS instance.
- In the left navigation pane, click SERVICE INSTANCE.
- On the Service Instance page that opens, under Node Configuration, set the Enable High Availability option. The text-entry field and the PING button are activated, and the CREATE HA CLUSTER button is deactivated.
- In the text-entry field, type the IP address or, if configured, the fully qualified domain name of the other virtual appliance to be configured in a cluster and click PING. After the cluster is configured, this DLS virtual appliance will initially host the secondary DLS instance.
- If the virtual appliance that will initially host the secondary DLS instance can be reached, the message
SUCCESS
appears next to the PING button and the CREATE HA CLUSTER button is activated. - Otherwise, the message
FAILURE
appears next to the PING button and the CREATE HA CLUSTER button remains deactivated.
- If the virtual appliance that will initially host the secondary DLS instance can be reached, the message
- Click CREATE HA CLUSTER to start the configuration and wait for it to complete. The Service Instance page displays the progress of the HA cluster configuration. The configuration process takes approximately 10 minutes to complete.
When the configuration is complete, the Service Instance page is updated to show the node health of the cluster.
If you intend to use static IP addresses for the virtual appliances that are hosting the DLS instances in the cluster, set the address of each virtual appliance as explained in Setting the Static IP Address of a DLS Virtual Appliance. Otherwise, configure the DLS instance on the virtual appliance that is hosting the primary DLS instance as explained in Configuring a Service Instance.
To fail over or change the roles of the DLS instances, restart the DLS virtual appliance that is hosting the primary DLS instance.
Note: If both instances in an HA cluster of DLS instances fail or are shut down at the same time, avoid a race condition by restarting only one instance and waiting until the startup of that instance is complete before starting the second instance.
2.12. Converting a Standalone DLS Instance into a Node in an HA Cluster
Any time after configuring a standalone DLS instance, you can convert the instance into a node in an HA cluster. You can also convert a node that became a standalone instance because the other node in a cluster was automatically removed by the DLS.
For information about automatic removal of a node, see Automatic Removal of a Node in an HA Cluster.
Ensure that the following prerequisites are met:
- A second DLS virtual appliance has been installed and started.
- The second DLS instance has not been configured as a standalone DLS instance.
- Log in to the DLS virtual appliance that hosts the DLS instance that you want to convert. After the instance is converted, it will initially be the primary DLS instance.
- In the left navigation pane, click SERVICE INSTANCE.
- On the Service Instance page that opens, under Node Health, click CONFIGURE HIGH AVAILABILITY. The Configure High Availability section with a text-entry field and a button that is labeled PING are added to the page.
- In the text-entry field, type the IP address or, if configured, the fully qualified domain name of the second virtual appliance and click PING.
- If the second virtual appliance can be reached, the message
SUCCESS
appears next to the PING button and the CREATE HA CLUSTER button is activated. - Otherwise, the message
FAILURE
appears next to the PING button and the CREATE HA CLUSTER button remains deactivated.
- If the second virtual appliance can be reached, the message
- Click CREATE HA CLUSTER to start the configuration and wait for it to complete. The Service Instance page displays the progress of the HA cluster configuration. The configuration process takes approximately 10 minutes to complete.
When the configuration is complete, the Service Instance page is updated to show the node health of the cluster.
2.13. Removing a Node from an HA Cluster
You can remove the secondary node from an HA cluster. After the node is removed, the primary node is converted to a standalone DLS instance.
- Log in to the DLS virtual appliance that hosts the primary node in the cluster.
- In the left navigation pane, click SERVICE INSTANCE.
- On the Service Instance page that opens, under Node Health, click REMOVE adjacent to the DLS virtual appliance that hosts the secondary node in the cluster.
- When asked if you want to remove the node, click CONFIRM.
When the secondary node is removed, all data on the node is removed. The primary node is converted to a standalone DLS instance.
2.14. Automatic Removal of a Node in an HA Cluster
When the nodes in an HA cluster are unable to communicate, messages that a node cannot send are temporarily stored on the disk of the node. If the accumulation of messages causes the amount of free space on the disk to fall below a specific amount, the secondary node in the cluster is automatically removed from the cluster. The primary node is converted to a standalone DLS instance. The secondary node is removed to ensure that the standalone DLS instance can continue to serve licenses to clients.
After the secondary node has been removed, a critical event that warns of a shortage of disk space is shown on the node that was converted to a standalone DLS instance. You can convert the instance into a node in an HA cluster as explained in Converting a Standalone DLS Instance into a Node in an HA Cluster.
2.15. Setting the Static IP Address of a DLS Virtual Appliance
You can use the management interface to the NVIDIA Licensing application to replace the existing IP address of the appliance with a new static IP address. The existing IP address can be an address assigned by DHCP or another static IP address.
The instance that the DLS virtual appliance is hosting must already be configured as a standalone DLS instance or as an instance in a HA cluster.
Note: You can set the static IP of the secondary node in an HA cluster from the primary node in the cluster. However,
- If you aren't logged in already, log in to the DLS virtual appliance.
- In the left navigation pane, click SERVICE INSTANCE.
- On the Service Instance page that opens, under Node Health, click CONFIGURE IP ADDRESS adjacent to the DLS virtual appliance for which you are setting a static IP address.
CAUTION:
Note:If the DLS virtual appliance for which you are setting a static IP address is a node in an HA cluster and the type of any node is unknown, do not attempt to set the static IP address. Any change to the static IP address is not propagated to the node whose type is unknown because the node is unreachable.
- In the Configure Node IP Address window that opens, provide the details of the IP address of the node and click UPDATE.
- In Static IP address text-entry field, type the IP address that you want to assign to the DLS virtual appliance.
- In the Gateway text-entry field, type the IP address of the DLS virtual appliance's default gateway.
Note:
Note: If you leave the Gateway field empty, the DLS virtual appliance uses DHCP settings.
- In the Netmask Prefix text-entry field, type the subnet mask of the DLS virtual appliance's network in classless inter-domain routing (CIDR) format.
- In the first DNS Server text-entry field, type the IP address of the first DNS server to be used for name resolution.
- In the second DNS Server text-entry field, type the IP address of the second DNS server to be used for name resolution.
If you are setting the IP address of the instance that you are logged in to, your browser will be disconnected from the instance after the update is complete. In this situation, you will need to log in to the DLS appliance again at the IP address that you set.
Note:Note: Setting the IP address of an instance in an HA cluster causes a failover of the cluster. As a result of the failover, the roles of the primary and secondary instances in the cluster are reversed.
- If necessary, log in to the DLS virtual appliance again by connecting to the URL
https://dls-vm-static-ip-address
.- dls-vm-static-ip-address
- The static IP address that you set for the DLS virtual appliance.
If the DLS instance hasn't already been configured and is a standalone instance or the primary instance in an HA cluster, configure the instance as explained in Configuring a Service Instance.
2.16. Configuring a DLS Virtual Appliance with a Third-Party Signed SSL Certificate
By default, a DLS virtual appliance is configured with a self-signed SSL certificate that is included in the DLS virtual appliance image from which the DLS virtual appliance is created. If necessary, you can replace the self-signed certificate with an SSL certificate that is signed by a third party, such as a certificate authority (CA).
To configure a DLS virtual appliance with a third-party signed SSL certificate, follow this sequence of instructions:
- Obtaining a Third-Party Signed SSL Certificate for a DLS Virtual Appliance
- Installing a Third-Party Signed SSL Certificate on a DLS Virtual Appliance
2.16.1. Obtaining a Third-Party Signed SSL Certificate for a DLS Virtual Appliance
Obtain a third-party signed SSL certificate by submitting a certificate signing request (CSR) to a suitable third party, such as a certificate authority (CA).
Ensure that the IP address of any DLS virtual appliance that will be configured with the certificate is mapped to the domain name that you will specify in the certificate.
For an HA cluster of DLS instances, you can choose to obtain a single wildcard domain certificate for all nodes in the cluster or one fully qualified domain name certificate for each node in the cluster.
For each certificate that you require, submit a certificate signing request (CSR) to a CA.
Ensure that each certificate that you request meets these requirements:
- The certificate must be a PEM text file (not in Java keystore format) and secured with a private key.
- The certificate and the private key must be in separate files.
- To ensure that web browsers trust the domain, the domain name must be part of the Subject Alternate Name (SAN) attribute, not the Common Name (CN) attribute of the CSR.
- The certificate must use RSA, DSA, and DH keys that are at least 2048 bits long.
- The certificate must use ECC keys greater that are longer than 224 bits long.
- If the certificate chain of trust includes intermediate certificates, the certificate must be bundled with the intermediate certificates in the following order:
- Domain name certificate
- Intermediate certificates
- Root certificate
If necessary, contact the CA that will provide your certificate for information about how to request a certificate that meets these requirements or convert an existing certificate to meet these requirements.
2.16.2. Installing a Third-Party Signed SSL Certificate on a DLS Virtual Appliance
Ensure that you have obtained the SSL certificate that you are installing and its private key file.
If you are installing a wildcard domain certificate for all nodes in an HA cluster perform this task from the primary node in the cluster only. The certificate is propagated automatically to the secondary node in the cluster. If you are installing one fully qualified domain name certificate for each node in the cluster, perform this task separately from each node.
- Log in to the DLS virtual appliance on which you are installing the SSL certificate.
- In the left navigation pane, click SERVICE INSTANCE.
- On the Service Instance page that opens, click SSL CONFIGURATION.
- In the SSL Certificate Configuration window that opens, specify the SSL certificate that you are installing and its private key file.
- If you are installing a wildcard domain certificate for all nodes in an HA cluster, set the Apply Wildcard option.
- Ensure that the Domain Name field contains the domain name that is specified in the certificate.
- Click Choose File adjacent to Certificate and in the file browser that opens, navigate to the folder that contains the SSL certificate and select the file.
- Click Choose File adjacent to Private Key and in the file browser that opens, navigate to the folder that contains the SSL certificate's private key and select the file.
- Click CONFIGURE.
How you configure a service instance depends on whether the service is a Cloud License Service (CLS) instance or a Delegated License Service (DLS) instance.
DLS Instance Instructions
You administer and manage a DLS instance through the NVIDIA Licensing application on the virtual appliance that hosts the DLS instance and through the NVIDIA Licensing Portal.
Before configuring a DLS instance, ensure that the virtual appliance that will host the instance has been installed and configured as explained in Installing and Configuring the DLS Virtual Appliance.
To configure a DLS instance, follow this sequence of instructions:
- Optional: Changing the Name and Description of a DLS Instance
- Creating a License Server on the NVIDIA Licensing Portal
- Instructions for registering the DLS instance:
- Binding a License Server to a Service Instance
- Installing a License Server on a DLS Instance
3.1. Changing the Name and Description of a DLS Instance
By default, a DLS instance is created with the name DEFAULT_timestamp and the description ON_PREM_SERVICE_INSTANCE. To distinguish a DLS instance on the NVIDIA Licensing Portal when multiple DLS instances are configured, change these defaults to a meaningful name and the description.
Perform this task from the DLS virtual appliance.
- Log in to the DLS virtual appliance that is hosting the instance whose name and description you want to change.
- In the left navigation pane of the NVIDIA Licensing dashboard, click SERVICE INSTANCE.
- On the Service Instance page that opens, click EDIT.
- In the Edit Service Instance dialog box that opens, type your choice of name and description for the instance and click UPDATE.
Note:
Note: The instance name cannot contain special characters.
After changing the name of a DLS instance, follow the instructions in Creating a License Server on the NVIDIA Licensing Portal.
3.2. Creating a License Server on the NVIDIA Licensing Portal
To be able to allot licenses to an NVIDIA License System instance, you must create at least one license server on the NVIDIA Licensing Portal. Creating a license server defines the set of licenses to be allotted.
You can also create multiple servers on the NVIDIA Licensing Portal and distribute your licenses across them as necessary, for example to group licenses functionally or geographically.
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you want to create the license server.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group for which you are creating the license server from the list of virtual groups at the top right of the page.
If no license servers have been created for your organization or virtual group, the NVIDIA Licensing Portal dashboard displays a message asking if you want to create a license server.
- On the NVIDIA Licensing Portal dashboard, click CREATE LICENSE SERVER. If you are adding a license server to an organization or virtual group for which a license server has already been created, click CREATE SERVER.
The Create License Server pop-up window opens.
- Provide the details of your license server.
- Ensure that the Create legacy server option is not set. Setting this option creates a legacy NVIDIA vGPU software license server, not a license server for NVIDIA License System.
- In the Server Name field, enter your choice of name for the license server.
- In the Description field, enter a text description of the license server. This description is required and will be displayed on the details page for the license server that you are creating.
- Add the licenses for the products that you want to allot to this license server. For each product, add the licenses as follows:
- From the Feature drop-down list, select the product for which you want to add licenses.
- In the Licenses field, enter the number of licenses for the product that you want to add.
- Click ADD.
- Click CREATE LICENSE SERVER.
3.3. Registering an on-Premises DLS Instance with the NVIDIA Licensing Portal
A DLS instance is created automatically when the virtual appliance on which the instance resides is installed. However, to enable the instance to be bound to a license server, you must register the instance with the NVIDIA Licensing Portal.
Registering an on-premises DLS instance with the NVIDIA Licensing Portal involves the exchange of a DLS instance token between the instance and the NVIDIA Licensing Portal.
A DLS instance token is created by a DLS instance. It identifies the DLS instance to the NVIDIA Licensing Portal and enables it to locate the NVIDIA Licensing Portal. After downloading the token from the DLS instance, you must upload it to the NVIDIA Licensing Portal to complete the registration of the service instance.
- If you are not already logged in, log in to the NVIDIA Licensing application at the IP address of the VM on which the DLS virtual appliance is installed.
- In the left navigation pane of the NVIDIA Licensing dashboard, click SERVICE INSTANCE.
- On the Service Instance page that opens, click DOWNLOAD DLS INSTANCE TOKEN. A DLS instance token file that is named dls_instance_token_mm-dd-yyyy-hh-mm-ss.tok is downloaded.
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you are registering the service instance.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group for which you are registering the service instance from the list of virtual groups at the top right of the page.
- In the left navigation pane of the NVIDIA Licensing Portal dashboard, click SERVICE INSTANCES.
- On Service Instances page that opens, click UPLOAD DLS INSTANCE TOKEN.
- In the Upload DLS Instance Token window that opens, click Choose File.
- In the file browser that opens, navigate to the folder that contains the DLS instance token file that is named dls_instance_token_mm-dd-yyyy-hh-mm-ss.tok that you downloaded and select the file.
- Back in the Upload DLS Instance Token window, select the For New Installation option and click SUBMIT. The list of pending registrations is opened and the service instance identified by the DLS instance token that you uploaded is listed.
- In the list of pending registrations, follow the Register link for the service instance identified by the DLS instance token that you uploaded. The service instance is added to the list of registered service instances.
After registering an on-premises DLS instance with the NVIDIA Licensing Portal, follow the instructions in Binding a License Server to a Service Instance.
3.4. Registering a DLS Instance on a Classsified Network with the NVIDIA Licensing Portal
If your DLS instance is on a classified network, you cannot download a DLS instance token to upload to the NVIDIA Licensing Portal to register the instance. Instead, you must register the instance by entering its details manually on the NVIDIA Licensing Portal.
- Use the hypervisor management console of the appliance to log in as the user dls_system to the VM that hosts the DLS virtual appliance. You don't need to provide a password to log in as the dls_system user.
- Run the /etc/adminscripts/pre-register-dls.sh script to allow the DLS instance to accept a pregistered license server.
$ /etc/adminscripts/pre-register-dls.sh
Note:Note: The effects of running this script on the DLS instance are irreversible. After running the script, you can no longer register the instance by exchanging a DLS instance token between the instance and the NVIDIA Licensing Portal.
- When asked to confirm that you want to proceed, type y.
- If you are not already logged in, log in to the NVIDIA Licensing application at the IP address of the VM on which the DLS virtual appliance is installed.
- In the left navigation pane of the NVIDIA Licensing dashboard, click SERVICE INSTANCE.
- On the Service Instance page that opens, note the information about the DLS instance that you will need when you register it by entering its details manually on the NVIDIA Licensing Portal.
- Name
- Service Instance ID
- Description
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you are registering the service instance.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group for which you are registering the service instance from the list of virtual groups at the top right of the page.
- In the left navigation pane of the NVIDIA Licensing Portal dashboard, click SERVICE INSTANCES.
- On Service Instances page that opens, click REGISTER DLS FOR CLASSIFIED N/W.
- In the Register DLS Instance for Classified Network window that opens, enter the name, service instance ID, and description that you obtained in Step 6 and click REGISTER.
- Bind a license server to the DLS instance that you registered and install the license server on the virtual appliance that hosts DLS instance. For instructions, refer to the following topics:
- On the Service Instances page of the NVIDIA Licensing Portal, follow the Acknowledge Installation link for the DLS instance.
- When prompted to acknowledge installation of the license server file, click ACKNOWLEDGE.
3.5. Deleting a Service Instance
When a service instance is deleted, any license servers that are bound to and installed on the service instance are uninstalled and freed from it. Deleting a DLS instance on which license servers are installed forcibly removes all licensed products from the servers and returns the licensed products to their entitlements. This behavior enables you to recover licenses from a failed DLS instance.
If you are deleting a CLS instance on which license servers are installed, remove all licensed products from the servers as explained in Removing Licensed Products from a License Server.
Perform this task on the NVIDIA Licensing Portal. The procedure for deleting a service instance is the same for CLS instances and DLS instances.
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group to which the service instance belongs.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group to which the service instance belongs from the list of virtual groups at the top right of the page.
- In the left navigation pane, click SERVICE INSTANCES.
- In the list of service instances on the Service Instances page that opens, follow the Delete link for the service instance.
- When asked to confirm that you want to delete the service instance, click DELETE.
3.6. Binding a License Server to a Service Instance
Binding a license server to a service instance ensures that licenses on the server are available only from that service instance. As a result, the licenses are available only to the licensed clients that are served by the service instance to which the license server is bound. You can bind multiple license servers to the same service instance.
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group to which the license server belongs.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group to which the license server belongs from the list of virtual groups at the top right of the page.
- In the list of license servers on the NVIDIA Licensing Portal dashboard, select the license server that you want to bind to a service instance.
- In the License Server Details page that opens, click BIND SERVICE INSTANCE.
- In the Bind Service Instance pop-up window that opens, select the service instance to which you want to bind the license server and click BIND. The Bind Service Instance pop-up window confirms that the license server has been bound to the service instance.
After a license server has been bound to a service instance, the license server is freed from the service instance only when the service instance is deleted.
3.7. Installing a License Server on a Service Instance
After binding a license server to a service instance, you must install the license server on the service instance to make the licenses on the server available to the instance. If you change the licenses or licensed products on a license server that is bound to a DLS instance, you must update the instance with the latest version of the license server.
After creating and installing a license server on a service instance, manage the licenses on the server by creating a client configuration token and, optionally, creating license pools and fulfillment conditions. For more information, see Managing Licenses on a License Server.
3.7.1. Installing a License Server on a DLS Instance
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which the license server was created.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group for which the license server was created from the list of virtual groups at the top right of the page.
- In the list of license servers on the NVIDIA Licensing Portal dashboard, select the license server that you want to install.
- In the License Server Details page that opens, click DOWNLOAD/INSTALL.
- In the Download/Install License Server window that opens, click DOWNLOAD BIN. A license server file that is named license_mm-dd-yyyy-hh-mm-ss.bin is downloaded.
- If you are not already logged in, log in to the NVIDIA Licensing application at the IP address of the VM on which the DLS virtual appliance is installed. If a license server has not been installed on the DLS virtual appliance, the NVIDIA Licensing dashboard displays a message asking if you want to install a license server.
- If you are updating the license server on the DLS virtual appliance, in the left navigation pane of the NVIDIA Licensing dashboard, click UPLOAD SERVER. If a license server has not been installed on the DLS virtual appliance, omit this step. The Server Upload page opens.
- On the NVIDIA Licensing dashboard or the Server Upload page, click SELECT LICENSE FILE.
- In the file browser that opens, navigate to the folder that contains the license server file named license_mm-dd-yyyy-hh-mm-ss.bin that you downloaded and select the file.
- When asked if you want to install the selected file, click INSTALL.
NVIDIA Licensing dashboard is updated with the details of the license server that you installed.
After installing a license server on a service instance, you can manage the licenses to be served from the server by distributing them among a number of license pools and by defining fulfillment conditions for requests from licensed clients. In this way, you can reserve licenses for specific types of users.
For example:
- An organization in which some users are using graphics-intensive computer-aided design (CAD) tools, while other users are using only office productivity tools can create a pool of NVIDIA RTX Virtual Workstation licenses for the CAD tool users and a pool of GRID Virtual PC licenses for the users of office productivity tools.
- An organization in which some users are performing mission-critical tasks can create a reserve pool of licences available only to these users and a pool of licenses available to all users. By setting suitable fulfillment conditions, the organization can ensure that when the pool of licenses available to all users is exhausted, only license requests from users performing mission-critical tasks are fulfilled from the reserve pool.
When a license server is installed on a service instance, a single default license pool and a single default fulfillment condition are created on the server. The default license pool initially contains all licenses allotted to the server. The default fulfillment condition allows any client to be served from the default license pool. If you want all your licensed clients to be served licenses from the same license pool under the same conditions, you can generate a client configuration token without creating any license pools or fulfillment conditions. For more information about client configuration tokens, see Generating a Client Configuration Token.
4.1. Navigating to the License Server Details Page for a License Server
How to navigate to the License Server Details page for a license server depends on whether you are performing the task on the NVIDIA Licensing Portal on a DLS instance.
- If you are not already logged in, log in to the web user interface for administering the license server.
-
On the NVIDIA Licensing Portal, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
The NVIDIA Licensing Portal dashboard opens.
-
On a DLS instance, log in to the NVIDIA Licensing application at the IP address of the VM on which the DLS virtual appliance is installed.
The License Server Details page for the license server on the DLS virtual appliance opens. No further action is required.
The remaining steps are required for the NVIDIA Licensing Portal only.
-
- If your assigned roles give you access to multiple virtual groups, select the virtual group for which you are managing licenses from the list of virtual groups at the top right of the NVIDIA Licensing Portal dashboard.
- In the list of license servers on the NVIDIA Licensing Portal dashboard, select the license server for which you want to manage licenses.
4.2. Managing License Pools
License pools enable you to divide the product features on a license server so that different categories of users are served licenses from different license pools. All licenses are served from a license pool. Only licenses on a license server that belong to a license pool are available to be served to license clients.
When a license server is installed on a service instance, a single default license pool is created on the server. The default license pool initially contains all licenses allotted to the server. You can subdivide the licenses on license server into any number of license pools. However, if you want to serve all licenses on a server from a single pool, you can use the default license pool without creating any additional license pools.
4.2.1. Creating a License Pool
If the only license pool on the license server is the initial default pool, return any licenses that you want to allocate to the license pool to the license server as explained in Managing Licenses in a License Pool. When a license server is created, a default license pool that contains all licences on the server is created. When the default license pool contains all licences on the server, the CREATE LICENSE POOL button is inactive.
- Navigate to the License Server Details page of the license server on which you want to create the license pool. For instructions, see Navigating to the License Server Details Page for a License Server.
In the License Server Details page that opens, disable the license server by deselecting the option to enable the license server.
When the license server is disabled, it cannot serve licenses to licensed clients.
- Click CREATE LICENSE POOL.
The Create License Pool pop-up window opens.
- In the License Pool Name field, enter your choice of name for the license pool. The name must be a list four characters long, may contain only letters and numbers, and must not contain any spaces or special characters.
- Add the licenses for the products that you want to allot to this license pool. For each product, add the licenses as follows:
- From the Feature drop-down list, select the product for which you want to add licenses. In the Feature drop-down list, only products on the license server that do not belong to another license pool are listed.
- In the Licenses field, use the up and down arrow controls to set the number of licenses for the product that you want to add.
- Click ADD.
- Click CREATE LICENSE POOL. The license pool is added to the list of license pools in the License Server Details page.
Select the option to enable the license server.
The license server can now serve licenses to licensed clients.
After you create a license pool you can change the set of licenses in the pool as explained in the following topics:
4.2.2. Deleting a License Pool
When a license pool is deleted, all product features in the pool are returned to the license server to which the license pool belongs.
Ensure that no licenses in the pool are checked out by licensed clients. A license pool cannot be deleted while any of the licenses in the pool are checked out by a client.
- Navigate to the License Server Details page of the license server to which the license pool belongs. For instructions, see Navigating to the License Server Details Page for a License Server.
- In the License Server Details page that opens, expand the license pool that you want to delete.
Disable the license pool by deselecting the option to enable the license pool.
When the license pool is disabled, licenses cannot be served to licensed clients from the pool.
In the row of icons under the name of the expanded license pool, click the trash can icon.
- When asked if you want to delete the license pool, click DELETE POOL.
4.2.3. Managing Licenses in a License Pool
Manage licenses in a license pool if you need to add or remove licenses for a specific product in the pool.
If you want to remove licensed products from a license pool to return all licenses for the product to the license server, see Removing Licensed Products from a License Pool.
- Navigate to the License Server Details page of the license server to which the license pool belongs. For instructions, see Navigating to the License Server Details Page for a License Server.
- In the License Server Details page that opens, expand the license pool that contains the licenses that you want to manage.
Disable the license pool by deselecting the option to enable the license pool.
When the license pool is disabled, licenses cannot be served to licensed clients from the pool.
In the row of icons under the name of the expanded license pool, click the pencil icon.
- In the Manage Licenses pop-up window that opens, add or remove licenses for the licensed products that you are interested in.
Add or remove licenses for each licensed product as follows:
- From the Feature drop-down list, select the product for which you want to add or remove licenses.
- In the Feature to Modify field, use the up and down arrow controls to set the number of licenses for the product that you want to remain in the pool after updating licenses.
-
To add licenses to the pool, set a number greater than the number already in the pool, but less than or equal to the total number of licenses available on the license server.
If you enter a number greater than the total number of licenses available, an error occurs.
-
To remove licenses from the pool, set a number less than the number already allocated to the server but greater than 0.
For example, to remove 4 licenses from a pool that contains 10 licenses, leaving 6 licenses on the license server, set the Licenses field to 6.
You cannot set the Licenses field to 0. You must leave at least 1 license in the license pool. If you want to remove all licenses for a product from the license server, you must follow the instructions in Removing Licensed Products from a License Pool.
-
- Click ADD.
The product and number of licenses are added to the Features to Modify list.
- After adding or removing licenses for all the products that you are interested in, click MANAGE FEATURES.
Select the option to enable the license pool.
Licenses can now be served to licensed clients from the pool.
4.2.4. Adding Licensed Products to a License Pool
You can add a new licensed product to a license pool after the license pool has been created. When you add a licensed product to a license pool, you must also set the number of consumed licenses.
- Navigate to the License Server Details page of the license server to which the the license pool belongs. For instructions, see Navigating to the License Server Details Page for a License Server.
- In the License Server Details page that opens, expand the license pool to which you want to add licensed products.
Disable the license pool by deselecting the option to enable the license pool.
When the license pool is disabled, licenses cannot be served to licensed clients from the pool.
In the row of icons under the name of the expanded license pool, click the plus sign icon.
- In the Add Features pop-up window that opens, add the licensed products that you are interested in.
Add each licensed product as follows:
- From the Feature drop-down list, select the licensed product that you want to add to the license pool.
- In the Licenses field, use the up and down arrow controls to set the number of licenses for the product that you want to allocate to the pool.
- Click ADD.
The product and number of licenses are added to the Features to Add list.
- After adding all the licensed products that you are interested in, click ADD FEATURES.
Select the option to enable the license pool.
Licenses can now be served to licensed clients from the pool.
4.2.5. Removing Licensed Products from a License Pool
Remove licensed products from a license pool if they are no longer needed. All licenses for the products that you remove are returned to the license server to which the pool belongs.
Ensure that no licenses for the product are checked out by licensed clients. All licenses for the product must be returned to the pool before the licensed product can be removed from the pool.
- Navigate to the License Server Details page of the license server to which the license pool belongs. For instructions, see Navigating to the License Server Details Page for a License Server.
- In the License Server Details page that opens, expand the license pool from which you want to remove licensed products.
Disable the license pool by deselecting the option to enable the license pool.
When the license pool is disabled, licenses cannot be served to licensed clients from the pool.
- In the Return Features pop-up window that opens, select the licensed products that you want to remove. For each licensed product that you want to remove, select the product from the Feature drop-down list and click ADD.
- After removing all the licensed products that you are interested in, click RETURN FEATURES.
Select the option to enable the license pool.
Licenses can now be served to licensed clients from the pool.
4.2.6. Merging Two License Pools
If you need to consolidate licenses in two pools into a single pool, you can merge the two pools. When you merge two license pools, all licenses in the pool that you select as the origin pool are migrated to the pool you select as the destination pool and the origin pool is deleted.
Ensure that no licenses in the origin pool are checked out by licensed clients.A license pool cannot be merged while any of the licenses in the pool are checked out by a client. If a license in the pool is checked out, the merge icon for the pool is dimmed and inactive.
- Navigate to the License Server Details page of the license server to which both the license pools belong. For instructions, see Navigating to the License Server Details Page for a License Server.
- In the License Server Details page that opens, expand the origin license pool.
Disable the license pool by deselecting the option to enable the license pool.
When the license pool is disabled, licenses cannot be served to licensed clients from the pool.
In the row of icons under the name of the expanded license pool, click the merge icon, which resembles a stack of papers.
- In the Merge Features pop-up window that opens, select the destination license pool and click MERGE POOL.
All licenses in the pool that you select as the origin pool are migrated to the pool you select as the destination pool and the origin pool is deleted.
4.2.7. Migrating Licenses Between License Pools
If demand for licenses from different pools changes, you can migrate licenses between pools to meet the changed demand.
Ensure that the following prerequisites are met:
- Both pools between which you will migrate licenses already exist. If you want to migrate licenses to a new pool, create the pool first.
- No licenses that want to migrate are checked out by licensed clients.
- Navigate to the License Server Details page of the license server to which both the license pools belong. For instructions, see Navigating to the License Server Details Page for a License Server.
- In the License Server Details page that opens, expand the license pool from which you want to migrate licenses.
Disable the license pool by deselecting the option to enable the license pool.
When the license pool is disabled, licenses cannot be served to licensed clients from the pool.
In the row of icons under the name of the expanded license pool, click the arrows icon.
- In the Split Features pop-up window that opens, select the licenses that you want migrate.
Select the licenses for each licensed product as follows:
- From the Feature drop-down list, select the licensed product for which you want to migrate licenses.
- In the Licenses field, use the up and down arrow controls to set the number of licenses for the product that you want to migrate. You must leave at least one license in the license pool from which you want to migrate licenses. If you want to remove all licenses for a product from the license pool, you must follow the instructions in Removing Licensed Products from a License Pool.
- Click ADD.
The product and number of licenses are added to the Features to Move list.
- From the Destination Pool drop-down list, select the license pool to which you want to migrate licenses and click MOVE FEATURES.
Select the option to enable the license pool.
Licenses can now be served to licensed clients from the pool.
4.3. Managing Fulfillment Conditions
A fulfillment condition selects the license pools from which a license requested by a licensed client is served. It is a test that is applied to any request from a licensed client to determine if the request may be fulfilled from a specified set of license pools.
A fulfillment condition is bound to an ordered list of license pools. If a request satisfies the conditions of the test, the bound license pools are evaluated, in order, to determine if the request can be served from the pool.
A fulfillment condition may belong to only one license server. However, a license server may contain any number of fulfillment conditions. If a license server contains more than one fulfillment condition, the conditions are ordered. Every request from a licensed client is tested against each fulfillment condition in order either until the request can be fulfilled or has been tested against all the fulfillment conditions.
4.3.1. About Match Conditions
A match condition determines whether a request from a licensed client may be fulfilled from the license pools bound to a fulfillment condition. You must specify a match condition when you create or edit a fulfillment condition.
Reference Match
The Reference Match condition allows only clients that have been provisioned with the client configuration token associated with a fulfillment condition to be served. The client configuration token contains a unique identifier for the fulfillment condition. The client provides this unique identifier to the server whenever the client requests a license from the server.
Universal Match
The Universal Match condition allows any client to be served. It is the default fulfillment condition and is applied if more specific conditions are not met or they were unable to fulfill a request. Because this condition is the most general condition, it is the last condition to be evaluated.
Only one fulfillment condition for a license server may specify the Universal Match condition. If another fulfillment condition for the server specifies this match condition, it is absent from the Match Condition drop-down list.
4.3.2. Creating a Fulfillment Condition
- Navigate to the License Server Details page of the license server to which the service instance is bound. For instructions, see Navigating to the License Server Details Page for a License Server.
In the License Server Details page that opens, disable the license server by deselecting the option to enable the license server.
When the license server is disabled, it cannot serve licenses to licensed clients.
- Click CREATE CONDITION.
The Create Fulfillment Condition pop-up window opens.
- In the Fulfillment Condition Name field, enter your choice of name for the fulfillment condition.
- Optional: In the Fulfillment Condition Description field, enter a text description of the fulfillment condition.
- From the Match Condition drop-down list, select a match condition to determine which clients may be served licenses from the license pools bound to this fulfillment condition.
The following match conditions are defined:
- In the License Pool Bindings section, specify the sequence of license pools from which licenses will be served to clients. Licenses are served in the order in which they appear in the Bound Pools list.
Note:
Note: You can specify a license pool in the license pool bindings for any number of fulfillment conditions.
- In the Available Pools list, select the license pools from which you want licenses to be served and click the right arrow icon. The license pools are moved to the Bound Pools list.
- In the Bound Pools list, adjust the order of the license pools as necessary by selecting each license pool that you need to move and clicking the up arrow and down arrow icons to move the license pool to its required position in the sequence.
- Click CREATE CONDITION. The fulfillment condition is added to the list of fulfillment conditions in the License Server Details page.
Select the option to enable the license server.
The license server can now serve licenses to licensed clients.
4.3.3. Deleting a Fulfillment Condition
To be able to serve licenses, a license server must have at least one fulfillment condition. If you delete all the fulfillment conditions that belong to a license server, the license server is no longer able to serve licenses to clients.
Note: Deleting a fulfillment condition does not delete the license pools that are bound to the fulfillment condition. If you delete all fulfillment conditions to which a license pool is bound, licenses in the pool can no longer be served to clients.
- Navigate to the License Server Details page of the license server to which the service instance is bound. For instructions, see Navigating to the License Server Details Page for a License Server.
- In the License Server Details page that opens, expand the fulfillment condition that you want to delete.
Disable the fulfillment condition by deselecting the option to enable the fulfillment condition.
When the fulfillment condition is disabled, it cannot be used to fulfill requests for licenses from licensed clients.
In the row of icons under the name of the expanded fulfillment condition, click the trash can icon.
- When asked if you want to delete the fulfillment condition, click DELETE FULFILLMENT CONDITION.
After a fulfillment condition is deleted, it is ignored in requests that specify the condition. Furthermore, if a request specifies only deleted fulfillment conditions, the request won't be satisfied.
4.3.4. Editing a Fulfillment Condition
- Navigate to the License Server Details page of the license server to which the service instance is bound. For instructions, see Navigating to the License Server Details Page for a License Server.
- In the License Server Details page that opens, expand the fulfillment condition that you want to edit.
Disable the fulfillment condition by deselecting the option to enable the fulfillment condition.
When the fulfillment condition is disabled, it cannot be used to fulfill requests for licenses from licensed clients.
In the row of icons under the name of the expanded fulfillment condition, click the pencil icon.
- In the Edit Fulfillment Condition pop-up window that opens, make the changes that you require.
- In the Fulfillment Condition Name field, edit the name for the fulfillment condition.
- In the Fulfillment Condition Description field, edit the description of the fulfillment condition.
- From the Match Condition drop-down list, select a new match condition to determine which clients may be served licenses from the license pools bound to this fulfillment condition.
Note:
Note: If you change the match condition, you must regenerate all client configuration tokens that specified the fulfillment condition and provision all affected licensed clients with the new token.
The following match conditions are defined:
- In the License Pool Bindings section, modify the sequence of license pools from which licenses will be served to clients. Use the left and right arrow icons to move selected license pools between the Available Pools list and the Bound Pools list. Use the up and down arrow icons to adjust the order of the license pools in the Bound Pools list. Licenses are served in the order in which they appear in the Bound Pools list.
- Click EDIT CONDITION.
Select the option to enable the fulfillment condition.
The fulfillment condition can now be used to fulfill requests for licenses from licensed clients.
4.3.5. Changing the Order of Fulfillment Conditions
By default, fulfillment conditions that are configured with the Reference Match condition are tested in the order in which they were added to a license server. You can change this order if you want the fulfillment conditions to be tested in a specific order.
Ensure that the license server contains at least two fulfillment conditions that are configured with the Reference Match condition.
- Navigate to the License Server Details page of the license server to which the service instance is bound. For instructions, see Navigating to the License Server Details Page for a License Server.
In the License Server Details page that opens, disable the license server by deselecting the option to enable the license server.
When the license server is disabled, it cannot serve licenses to licensed clients.
- Click REINDEX. The Reindex Fulfillment Conditions window opens.
- Rearrange your fulfillment conditions in the order that you want. Move each fulfillment condition that you want to move up or down in the processing order as follows:
- In the Fulfillment Conditions list, select the condition that you want to move.
Note:
Note: A fulfillment condition that is configured with the Universal Match condition is not displayed in this list because it is processed last.
- Use the up and down arrow controls to move the condition to the position in the processing order that you want.
- In the Fulfillment Conditions list, select the condition that you want to move.
- Click REINDEX. The order in which the fulfillment conditions are listed on the License Server Details page is updated to match the order that you specified.
Select the option to enable the license server.
The license server can now serve licenses to licensed clients.
4.4. Generating a Client Configuration Token
A client configuration token identifies the service instance, license servers, and fulfillment conditions to be used to serve a license in response to a request from a licensed client. This information must be exchanged between a service instance and a licensed client to enable the service instance to serve licenses to the client.
After generating a client configuration token, you copy it to each licensed client that you want to use the token. Each client then provides data from the token back to the server whenever the client requests a license from the server.
Create one client configuration token for each combination of license servers and fulfillment conditions that you want to use to serve licenses in response to requests from licensed clients.
After creating a client configuration token from a service instance, copy the client configuration token to each licensed client that you want to use the combination of license servers and fulfillment conditions specified in the token.
You must copy a client configuration token to a licensed client within six months of generating it. If a client configuration token expires before you copy it to a licensed client, you must regenerate it before copying it to the client.
4.4.1. Generating a Client Configuration Token for a DLS Instance
- If you are not already logged in, log in to the NVIDIA Licensing application at the IP address of the VM on which the DLS instance resides.
- In the left navigation pane, click SERVICE INSTANCE.
- On the Service Instance page that opens, click GENERATE CLIENT CONFIGURATION TOKEN. The Generate Client Configuration Token window opens.
- Select the references that you want to include in the client configuration token.
- From the list of scope references, select the scope references that you want to include.
You must select at least one scope reference.
Each scope reference specifies the license server that will fulfil a license request.
- Optional: From the list of fulfillment class references, select the fulfillment class references that you want to include. Including fulfillment class references is optional.
- Click GENERATE CLIENT CONFIGURATION TOKEN.
A file named client_configuration_token_mm-dd-yyyy-hh-mm-ss.tok is saved to your default downloads folder.
- From the list of scope references, select the scope references that you want to include.
4.5. Disabling and Enabling a License Server, License Pool, or Fulfillment Condition
When modifying a license server, license pool, or fulfillment condition, you must disable it before modifying it. To ensure that service instance can serve licenses to licensed clients, you must ensure that its license servers, licence pools and fulfillment conditions are enabled.
You disable and enable a license server, license pool, or fulfillment condition from the relevant License Server Details page. For information about how to navigate to the License Server Details page, see Navigating to the License Server Details Page for a License Server.
To disable a license server, deselect the option to enable it.
When the license server is disabled, it cannot serve licenses to licensed clients.
To enable a license server, select the option to enable it.
The license server can now serve licenses to licensed clients.
To disable a license pool, deselect the option to enable it.
When the license pool is disabled, licenses cannot be served to licensed clients from the pool.
To enable a license pool, select the option to enable it.
Licenses can now be served to licensed clients from the pool.
To disable a fulfillment condition, deselect the option to enable it.
When the fulfillment condition is disabled, it cannot be used to fulfill requests for licenses from licensed clients.
To enable a fulfillment condition, select the option to enable it.
The fulfillment condition can now be used to fulfill requests for licenses from licensed clients.
4.6. Editing License Server Settings
License server settings control how a service instance handles licenses that have been served to licensed clients.
- Navigate to the License Server Details page of the license server to which the service instance is bound. For instructions, see Navigating to the License Server Details Page for a License Server.
- In the License Server Details page that opens, click Edit Settings.
- In the Server Settings pop-up window, edit the settings that you want to change and click SAVE SETTINGS.
- Maximum Allowed Feature Overage
- This setting cannot be changed from its preset value and is displayed for information only. For counted licenses, it is the maximum percentage of the number of licenses available that can be leased to license clients for a limited period of time when all available licenses are checked out. For example, if you have 100 concurrent user licenses and all licenses are checked out, up to an additional 10 licenses can leased to license clients for a limited period of time. During periods when overage allowances are being used, administrative warnings may be generated.
- Default Lease Period
- The default period of time for which a license remains valid at a licensed client after the license has been served to the client. At the end of the lease period, the license becomes invalid at the client and becomes available to be served to other licensed clients.
- Minimum Lease Period
- The minimum period of time for which a license remains valid at a licensed client after the license has been served to the client.
- Maximum Lease Period
- The maximum period of time for which a license remains valid at a licensed client after the license has been served to the client.
- Default Renewal Period
-
The percentage of the lease period that must elapse before a licensed client can renew a license. By renewing a license before the lease period has elapsed, a licensed client can extend its license beyond the original expiration time of the license. Extending a license ensures that if a licensed client temporarily loses network connectivity to the licensing service, there is enough time for connectivity to be restored before the license expires.
For example, if the lease period is one day and the renewal period is 20%, the client attempts to renew its license every 4.8 hours. If network connectivity is lost, the loss of connectivity is detected during license renewal and the client has 19.2 hours in which to re-establish connectivity before its license expires.
- Offline Lease
- Enable or disable offline lease of licenses to clients. When offline lease of licenses to clients is enabled, clients can keep their licenses even when powered off.
Perform these routine administration tasks as needed during the lifetime of the service instance.
5.1. Setting the Validity Period of a Lease Authorization Token for a Service Instance
You can set the validity period of a lease authorization token to either enhance performance or increase security. Increasing the validity period enhances performance by decreasing the frequency with which clients are authorized before the service instance grants a licensing request. Decreasing the expiration time increases security by increasing the frequency with which clients are authorized before the service instance grants a licensing request.
The default validity period is one hour. You can set the validity period to any value up to 24 hours.
5.1.1. Setting the Validity Period of a Lease Authorization Token for a DLS Instance
Perform this task on the NVIDIA Licensing application on the virtual appliance that hosts the DLS instance.
- If you are not already logged in, log in to the NVIDIA Licensing application at the IP address of the VM on which the DLS virtual appliance is installed.
- In the left navigation pane of the NVIDIA Licensing dashboard, click SERVICE INSTANCE.
- On the Service Instance page that opens, click EDIT SETTINGS.
- In the Service Instance Settings window that opens, use the arrow controls to set the number of days, hours, and minutes an authorization token is valid and click SAVE SETTINGS.
5.2. Migrating a DLS Instance
Migrating a DLS instance simplifies the upgrade of a DLS virtual appliance. After installing a new version of the DLS virtual appliance, you can transfer the license servers, user registration, IP address, and service instance from the existing virtual appliance to a new virtual appliance. However, event records on the existing virtual appliance are not migrated.
5.2.1. Migrating a DLS Instance Online
You can migrate a DLS instance online if the new DLS virtual appliance is installed on a VM and the existing DLS virtual appliance can connect to the new DLS virtual appliance over IP.
Ensure that the following prerequisites are met:
- The new DLS virtual appliance is installed on a VM as explained in Installing the DLS Virtual Appliance.
- If necessary, a static IP address has been assigned to the new DLS virtual appliance as explained in Setting the IP Address of a DLS Virtual Appliance from the Hypervisor.
- The existing DLS virtual appliance can connect to the new DLS virtual appliance over IP.
- The DLS administration user has not been registered on the new DLS virtual appliance.
If the new DLS virtual appliance isn't yet installed on a VM or the existing DLS virtual appliance cannot connect to the new DLS virtual appliance over IP, migrate the DLS instance offline as explained in Migrating a DLS Instance Offline.
To migrate a DLS instance online, follow this sequence of instructions:
- Migrating Data from the Existing DLS Virtual Appliance
- Confirming the Migration on the new DLS Virtual Appliance
5.2.1.1. Migrating Data from the Existing DLS Virtual Appliance
Perform this task from the existing DLS virtual appliance.
- Log in to the existing DLS virtual appliance that hosts the DLS instance that you want to migrate.
- In the left navigation pane of the NVIDIA Licensing dashboard, click MAINTENANCE.
- On the Maintenance page that opens, scroll down to the On-Premises Virtual Appliance Upgrade section of the page.
- Ensure that the Offline Upgrade option is not set.
- In the text-entry field, type the IP address or fully qualified domain name of the new DLS virtual appliance and click MIGRATE.
- When asked if you want to proceed, click MIGRATE.
When the migration is complete, the DLS instance that you migrated is no longer able to serve licenses to clients.
Any time before you confirm the migration, you can enable the DLS instance that you migrated serve licenses to licensed clients again. If necessary, you can also repeat the data migration from the existing DLS instance.
Confirm the migration as explained in Confirming the Migration on the new DLS Virtual Appliance.
5.2.1.2. Confirming the Migration on the new DLS Virtual Appliance
After the data has been transferred, confirm the migration on the new DLS virtual appliance.
Perform this task from the new DLS virtual appliance.
- Log in to the new DLS virtual appliance as the DLS administrator user with the password of the DLS administrator user on the existing DLS virtual appliance.
- On the Dashboard page that opens, confirm that the installed license server was correctly migrated.
- In the left navigation pane of the NVIDIA Licensing dashboard, click MAINTENANCE.
- On the Maintenance page that opens, click ACKNOWLEDGE MIGRATION. The existing DLS virtual appliance is shut down. The IP address of the new DLS virtual appliance is set to the IP address of the existing DLS virtual appliance. As a result, your browser is disconnected from the new DLS virtual appliance. Setting the IP address of the new virtual appliance takes approximately two minutes.
- Log in to the new DLS virtual appliance again by connecting to the URL
https://dls-vm-static-ip-address
.- dls-vm-static-ip-address
- The IP address that was set for the new DLS virtual appliance.
- Enable the new DLS virtual appliance to serve licenses to licensed clients.
- In the left navigation pane of the Maintenance page, click DASHBOARD.
On the Dashboard page that opens, set the option to enable the license server.
Ensure that the option to enable each license pool and fulfillment condition that you want to enable is set.
If you want to use the virtual appliance for a single DLS instance, configure the instance as explained in Configuring a Standalone DLS Instance.
If you want to use the virtual appliance in an HA cluster of DLS instances, configure the cluster as explained in Configuring an HA Cluster of DLS Instances.
5.2.2. Migrating a DLS Instance Offline
If the new DLS virtual appliance isn't yet installed on a VM or the existing DLS virtual appliance cannot connect to the new DLS virtual appliance over IP, migrate the DLS instance offline.
To migrate a DLS instance offline, follow this sequence of instructions:
- Registering the Migration of a DLS Instance with the NVIDIA Licensing Portal
- Generating an Upgrade File for the DLS Instance that You are Migrating
- Transferring Migration Data to the DLS Instance on an Upgraded Virtual Appliance
5.2.2.1. Registering the Migration of a DLS Instance with the NVIDIA Licensing Portal
Registering the migration of a DLS instance with the NVIDIA Licensing Portal involves the exchange of a binary migration file between the instance and the NVIDIA Licensing Portal. After creating the migration file and downloading it from the DLS instance, you must upload it to the NVIDIA Licensing Portal to complete the registration.
- Log in to the existing DLS virtual appliance that hosts the DLS instance that you want to migrate. The DLS instance must be either a standalone DLS instance or the primary node in an HA cluster.
- In the left navigation pane of the NVIDIA Licensing dashboard, click MAINTENANCE.
- On the Maintenance page that opens, scroll down to the On-Premises Virtual Appliance Upgrade section of the page.
- Set the Offline Upgrade option.
- Click GENERATE MIGRATION FILE.
- When asked if you want to proceed, click GENERATE.
The DLS instance on the existing DLS virtual appliance is no longer able to serve licenses to clients.
Modifications to the existing DLS virtual appliance are blocked until the offline migration process is complete.
- After the migration file has been generated, click DOWNLOAD MIGRATION FILE. A migration file that is named on_prem_migration_file_mm-dd-yyyy-hh-mm-ss.bin is saved to your downloads folder.
- After the migration file has been downloaded, click ACKNOWLEDGE DOWNLOAD. The DLS virtual appliance that hosts the DLS instance is shut down.
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group to which the DLS instance belongs.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group to which the DLS instance belongs from the list of virtual groups at the top right of the page.
- In the left navigation pane of the NVIDIA Licensing Portal dashboard, click SERVICE INSTANCES.
- In the list of service instances on the Service Instances page that opens, follow the Upload Migration File link for the DLS instance.
- In the file browser that opens, navigate to the folder that contains the migration file that is named on_prem_migration_file_mm-dd-yyyy-hh-mm-ss.bin that you downloaded and select the file.
Install the new DLS virtual appliance as explained in Installing the DLS Virtual Appliance. Then generate and upload the DLS instance token for the new virtual appliance to generate an upgrade file as explained in Generating an Upgrade File for the DLS Instance that You are Migrating.
5.2.2.2. Generating an Upgrade File for the DLS Instance that You are Migrating
After uploading the migration file for the DLS instance that you are migrating, you must generate an upgrade file for the instance. Generating the upgrade file involves generating and uploading the DLS instance token for the new virtual appliance that will host the migrated DLS instance.
Ensure that the following prerequisites are met:
- The new DLS virtual appliance is installed on a VM as explained in Installing the DLS Virtual Appliance.
- If necessary, a static IP address has been assigned to the new DLS virtual appliance as explained in Setting the IP Address of a DLS Virtual Appliance from the Hypervisor.
- The DLS administration user has not been registered on the new DLS virtual appliance.
- Open a web browser and connect to the URL
https://dls-vm-ip-address
.- dls-vm-ip-address
-
The IP address or, if defined, the fully qualified domain name of the VM on which the DLS virtual appliance is installed.
You can get the IP address from the management console of your hypervisor.
- On the Set Up page that opens, click UPGRADE.
- On the Virtual Appliance Upgrade page that opens, click DOWNLOAD DLS INSTANCE TOKEN. A DLS instance token file that is named dls_instance_token_mm-dd-yyyy-hh-mm-ss.tok is downloaded.
- Leave the Virtual Appliance Upgrade page open in the browser.
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you are registering the DLS instance.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group for which you are registering the DLS instance from the list of virtual groups at the top right of the page.
- In the left navigation pane of the NVIDIA Licensing Portal dashboard, click SERVICE INSTANCES.
- On the Service Instances page that opens, click UPLOAD DLS INSTANCE TOKEN.
- In the Upload DLS Instance Token window that opens, click Choose File.
- In the file browser that opens, navigate to the folder that contains the DLS instance token file that is named dls_instance_token_mm-dd-yyyy-hh-mm-ss.tok that you downloaded and select the file.
- Back in the Upload DLS Instance Token window, complete the generation of the upgrade file:
- Select the For upgrade option.
- From the drop-down list, select the DLS instance for which you previously uploaded the migration file.
- Click SUBMIT.
An upgrade file is generated and the Download Upgrade File link is added for the selected DLS instance.
After registering the DLS instance on an upgraded virtual appliance with the NVIDIA Licensing Portal, follow the instructions in Transferring Migration Data to the DLS Instance on an Upgraded Virtual Appliance.
5.2.2.3. Transferring Migration Data to the DLS Instance on an Upgraded Virtual Appliance
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group to which the DLS instance belongs.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group to which the DLS instance belongs from the list of virtual groups at the top right of the page.
- In the list of service instances on the Service Instances page that opens, follow the Download Upgrade File link for the DLS instance. A file named dls_upgrade_mm-dd-yyyy-hh-mm-ss.bin is saved to your default downloads folder.
- Return to the Virtual Appliance Upgrade page of the NVIDIA Licensing application on the upgraded virtual appliance.
- On the Virtual Appliance Upgrade page, click UPLOAD UPGRADE FILE.
- In the Upload Upgrade File, click Choose File.
- In the file browser that opens, navigate to the folder that contains the upgrade file that is named dls_upgrade_mm-dd-yyyy-hh-mm-ss.bin that you downloaded and select the file.
- Back in the Upload Upgrade File, click UPLOAD.
When the upgrade is complete, update the IP address of the virtual appliance to the address given in the prompt as explained in Setting the Static IP Address of a DLS Virtual Appliance.
5.3. Setting the Retention Period of Events on a DLS Instance
A DLS instance records events related to administration of the instance and the serving of licenses from the instance to licensed clients. These events are displayed on the Events page of the instance. You can control the number of events that are displayed on this page by setting the retention period of events on a DLS instance. Any event older than the retention period is deleted from the instance.
- If you aren't logged in already, log in to the DLS virtual appliance.
- In the left navigation pane, click SERVICE INSTANCE.
- On the Service Instance page that opens, click EDIT SETTINGS.
- In the Service Instance Settings window that opens, use the up and down arrow controls to set the retention time in days for each type of event and click SAVE SETTINGS.
5.4. Troubleshooting a DLS Instance
To facilitate troubleshooting, the DLS provides access to log files, event records, and the status of a DLS instance's internal services. If the DLS instance's internal services have failed, you can restart them from the NVIDIA Licensing application on the DLS virtaual appliance.
5.4.1. Log File Locations and Types for a DLS Virtual Appliance
The log files for a DLS virtual appliance contain diagnostic information to help with troubleshooting. The dls_diagnostics user can access these log files by logging in to the DLS virtual appliance from the hypervisor console.
Only the dls_diagnostics
user can access the log files for a DLS virtual appliance. This user can be created only during the registration of the DLS administrator user as explained in Registering the DLS Administrator User.
The log files for a DLS virtual appliance are in the locations in the following table.
Log Message Type | Log File Location |
---|---|
NVIDIA License System licensing messages | /var/log/licensing |
NVIDIA License System service messages | /var/log/op_log_archive |
/var/log/op_log_capture | |
/var/log/op_log_ingest | |
DLS web server messages | /var/log/nginx |
DLS virtual appliance internal messages related to:
|
/var/log/rabbitmq |
Files in the following standard Linux directories contain log messages from the operating system:
- /tmp
- /var/log
- /var/tmp
5.4.2. Storing Log Files for a DLS Virtual Appliance on a Network File Share
Because the amount of disk space available in a DLS virtual appliance might be limited, the DLS virtual appliance does not retain all log messages generated during the lifetime of a DLS virtual appliance. If you want to retain all log messages, you can configure the virtual appliance to store log files for a DLS virtual appliance on a network file share.
If a virtual appliance is configured to store log files for a DLS virtual appliance on a network file share, it periodically aggregates the log files and moves them from the local disk of the DLS virtual appliance to the share.
Ensure that the following prerequisites are met:
- The network file share has been created on a network attached storage server that is accessible from the DLS virtual appliance.
- The DLS administrator user on the DLS virtual appliance is granted full access to the network file share.
- Log in to the DLS virtual appliance.
- In the left navigation pane, click SERVICE INSTANCE.
- On the Service Instance page that opens, click LOG ARCHIVE SETTINGS.
- In the Network Share Configuration for Log Archival window that opens, provide the details of the network file share and click MOUNT.
- From the Platform drop-down list, select the OS that corresponds to the type of the share on the network attached storage server.
- For a share that corresponds to the Windows OS, such as a CIFS share, select Windows.
- For a share that corresponds to the UNIX OS, such as an NFS share, select Unix.
- In the Network Share Path text-entry field, type the path to the share on the network attached storage server in the following format:
//nas-server/file-path
- nas-server
- The IP address or fully qualified domain name of the network attached storage server on which the share has been created.
- file-path
- The full path to the share from the root of the file system on the network attached storage server. In the path, use the forward slash as the file separator, even if you selected Windows from the Platform drop-down list.
- If you selected Windows from the Platform drop-down list , provide the user name and password for the user on the network attached storage server that will access the share.
- From the Platform drop-down list, select the OS that corresponds to the type of the share on the network attached storage server.
The network file share is mounted at /var/log/licensing on the DLS virtual appliance. This mount point is preset in the DLS virtual appliance and cannot be changed.
5.4.3. Exporting and Importing Event Records from a DLS Instance
To help NVIDIA Enterprise Support personnel troubleshoot issues with a DLS instance, you can export event records from the DLS instance and import them into the NVIDIA Licensing Portal.
Note: The maximum size of a file that can be exported from a DLS instance or imported into the NVIDIA Licensing Portal is 250 MBytes.
- Log in to the DLS virtual appliance that hosts the DLS instance.
- In the left navigation pane of the NVIDIA Licensing dashboard, click MAINTENANCE.
- Optional: Filter the events that you want to export.
- On the Maintenance page that opens, set the Show advanced filters option.
- Use the calendar widget that is added to the page to set the range of dates for which you want to export event records.
- Select the categories of event that you want to export.
- On the Maintenance page, click EXPORT EVENTS. An event log file that is named on-premises_export_mm-dd-yyyy-hh-mm-ss.log is saved to your downloads folder.
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group to which the DLS instance belongs.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group to which the DLS instance belongs from the list of virtual groups at the top right of the page.
- In the left navigation pane of the NVIDIA Licensing Portal dashboard, click MAINTENANCE.
- On the Maintenance page that opens, click SELECT EVENTS FILE.
- In the file browser that opens, navigate to the folder that contains the event log file that is named on-premises_export_mm-dd-yyyy-hh-mm-ss.log that you downloaded and select the file.
- Optional: For each other event file that you want to import, click SELECT ANOTHER FILE, and navigate to and select the file.
- After selecting all the files that you want to import, click IMPORT EVENTS.
5.4.4. Restarting a DLS Instance's Internal Services
If a DLS instance has failed because its internal services are no longer active, you can restart the inactive services to recover from the failure.
- Log in to the DLS virtual appliance that hosts the DLS instance. If the DLS instance is a node in an HA cluster, you must log in to the DLS virtual appliance that hosts the specific node. You cannot restart the internal services of the secondary node from the primary node or restart the internal services of the primary node from the secondary node.
- In the left navigation pane, click SERVICE INSTANCE.
- On the Service Instance page that opens, under Node Health, determine whether the status of any of the DLS instance's internal services is inactive. Status information is provided for the DLS instance's critical services and other services.
- If any set of services in not active, click RESTART for that set of services.
Note:
Note: You cannot restart a set of services that is active. The RESTART button for any set of active services is deactivated and dimmed.
After creating a license server on the NVIDIA Licensing Portal, you can add licenses to and remove licenses from the server, add new licensed products to and remove licensed products from the server, and delete the server when you no longer require it.
6.1. Where to Perform Tasks for Managing a License Server
Where to perform the tasks for managing a license server depends on the task and on the type of service instance on which the license server is installed.
Task | CLS Instance | DLS Instance |
---|---|---|
Adding licenses to a license server | NVIDIA Licensing Portal | NVIDIA Licensing Portal |
Removing licenses from a license server | NVIDIA Licensing Portal | The NVIDIA Licensing application on the virtual appliance that hosts the DLS instance |
Adding licensed products to a license server | NVIDIA Licensing Portal | NVIDIA Licensing Portal |
Removing licensed products from a license server | NVIDIA Licensing Portal | The NVIDIA Licensing application on the virtual appliance that hosts the DLS instance |
Deleting a license server | NVIDIA Licensing Portal | NVIDIA Licensing Portal |
Note: You cannot delete a license server that is bound to and installed on a DLS or CLS instance. You must first delete the CLS or DLS instance to uninstall the license server and free it from the CLS or DLS instance. For instructions, refer to Deleting a Service Instance.
6.2. Adding or Removing Licenses on a License Server
Perform this task if you need to add or remove individual licenses for a specific product on the license server.
If you want to remove licensed products from a license server to return all licenses for the product to the entitlement, see Removing Licensed Products from a License Server.
Ensure that any licenses that you want to remove from a license server are not in a license pool. If necessary, return licenses from a pool to the license server as explained in Managing Licenses in a License Pool.
Where to perform this task depends on whether you are adding or removing licenses.
- If you are adding licenses, perform this task on the NVIDIA Licensing Portal irrespective on the type of service instance on which the license server is installed.
- If you are removing licenses, where to perform this task depends on the type of service instance on which the license server is installed:
- On a CLS instance, perform this task on the NVIDIA Licensing Portal.
- On a DLS instance, perform this task on the NVIDIA Licensing application on the virtual appliance that hosts the DLS instance.
- Navigate to the License Server Details page of the license server to which you want to add or from which you want to remove licenses. For instructions, see Navigating to the License Server Details Page for a License Server.
In the License Server Details page that opens, disable the license server by deselecting the option to enable the license server.
When the license server is disabled, it cannot serve licenses to licensed clients.
- Click MANAGE LICENSES.
- In the Manage Licenses pop-up window that opens, add or remove licenses for the licensed products that you are interested in.
Add or remove licenses for each licensed product as follows:
- From the Feature drop-down list, select the product for which you want to add or remove licenses.
- In the Licenses field, enter the number of licenses for the product that you want to remain on the server after updating licenses.
-
To add licenses to the server, enter a number greater than the number already allocated to the server, but less than or equal to the total number of licenses available.
If you enter a number greater than the total number of licenses available, an error occurs.
-
To remove licenses from the server, enter a number less than the number already allocated to the server but greater than 0.
For example, to remove 4 licenses from a server to which 10 licenses are allocated, leaving 6 licenses allocated to the server, enter 6 in the Licenses field.
If you enter 0, an error occurs. You must leave at least 1 license on the license server. If you want to remove all licenses for a product from the license server, you must follow the instructions in Removing Licensed Products from a License Server.
-
- Click ADD.
The product and number of licenses are added to the Features to Modify list.
- After adding or removing licenses for all the products that you are interested in, click UPDATE LICENSES.
Select the option to enable the license server.
The license server can now serve licenses to licensed clients.
If the license server is installed on a CLS instance, no further action is required. The license server and the NVIDIA Licensing Portal are automatically updated with your changes.
If the license server is installed on a DLS instance, you must ensure that the licenses on your license server and on the NVIDIA Licensing Portal are consistent.
- If you added licenses, download and install the updated license server to ensure that the correct licenses are available on the DLS instance. For detailed instructions, see Installing a License Server on a DLS Instance. Installing the updated license server does not affect the distribution of existing licenses among license pools.
- If you removed licenses, return the licenses to the entitlement on the NVIDIA Licensing Portal. For detailed instructions, see Returning Licenses from a License Server on a DLS Instance to the NVIDIA Licensing Portal.
6.3. Adding Licensed Products to a License Server
You can add a new licensed product to a license server after the license server has been created. When you add a licensed product to a license server, you must also set the number of consumed licenses.
Perform this task on the NVIDIA Licensing Portal irrespective on the type of service instance on which the license server is installed.
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you want to add licensed products.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group for which you are adding licensed products from the list of virtual groups at the top right of the page.
- In the list of license servers on the NVIDIA Licensing Portal dashboard, select the license server to which you want to add licensed products.
In the License Server Details page that opens, disable the license server by deselecting the option to enable the license server.
When the license server is disabled, it cannot serve licenses to licensed clients.
- Click ADD FEATURES.
- In the Add Features pop-up window that opens, add the licensed products that you are interested in.
Add each licensed product as follows:
- From the Feature drop-down list, select the licensed product that you want to add to the license server.
- In the Licenses field, enter the number of licenses for the product that you want to allocate to the server.
- Click ADD.
The product and number of licenses are added to the Features to Add list.
- After adding all the licensed products that you are interested in, click ADD FEATURES.
Select the option to enable the license server.
The license server can now serve licenses to licensed clients.
If the license server is installed on a CLS instance, no further action is required. The license server is automatically updated with your changes.
If the license server is installed on a DLS instance, download and install the updated license server to ensure that the correct licensed products are available on the DLS instance. For detailed instructions, see Installing a License Server on a DLS Instance. Installing the updated license server does not affect the distribution of existing licenses among license pools.
6.4. Removing Licensed Products from a License Server
Remove licensed products from a license server if they are no longer needed or in preparation for migrating them to a new server. All licenses for the products that you remove are returned to the entitlement.
Ensure that any licensed products that you want to remove from a license server are not in a license pool. If necessary, return licensed products from a pool to the license server as explained in Removing Licensed Products from a License Pool.
Where to perform this task depends on the type of service instance on which the license server is installed:
- On a CLS instance, perform this task on the NVIDIA Licensing Portal.
- On a DLS instance, perform this task on the NVIDIA Licensing application on the virtual appliance that hosts the DLS instance.
- Navigate to the License Server Details page of the license server from which you want to remove licensed products. For instructions, see Navigating to the License Server Details Page for a License Server.
In the License Server Details page that opens, disable the license server by deselecting the option to enable the license server.
When the license server is disabled, it cannot serve licenses to licensed clients.
- Click REMOVE FEATURES.
- In the Remove Features pop-up window that opens, select the licensed products that you want to remove. For each licensed product that you want to remove, select the product from the Feature drop-down list and click REMOVE.
- After removing all the licensed products that you are interested in, click REMOVE FEATURES.
Select the option to enable the license server.
The license server can now serve licenses to licensed clients.
If the license server is installed on a CLS instance, no further action is required. The NVIDIA Licensing Portal is automatically updated with your changes.
If the license server is installed on a DLS instance, return the licenses to the entitlement on the NVIDIA Licensing Portal. For detailed instructions, see Returning Licenses from a License Server on a DLS Instance to the NVIDIA Licensing Portal.
6.5. Returning Licenses from a License Server on a DLS Instance to the NVIDIA Licensing Portal
After removing individual licenses or licensed products from a license server installed on a DLS instance, you must return them to the entitlement on the NVIDIA Licensing Portal. Returning them ensures that the licenses and products on your license server and on the NVIDIA Licensing Portal are consistent. The returned licenses and products are then available for use by other license servers.
- If you are not already logged in, log in to the NVIDIA Licensing application at the IP address of the VM on which the DLS virtual appliance is installed.
- In the left navigation pane of the NVIDIA Licensing dashboard, click MAINTENANCE.
- On the Maintenance page that opens, click Export Feature Return.
Note:
Note: The Export Feature Return button is active only if individual licenses or licensed products have been removed from the license server.
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which the license server was created.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group for which the license server was created from the list of virtual groups at the top right of the page.
- In the list of license servers on the NVIDIA Licensing Portal dashboard, select the license server from which you want to return licenses or licensed products.
- In the License Server Details page that opens, click RETURN FEATURES.
- In the file browser that opens, navigate to the folder that contains the license return file named on-premises_feature_return_mm-dd-yyyy-hh-mm-ss.bin that you downloaded and select the file. The returned licenses and license products are added to the entitlements on the NVIDIA Licensing Portal.
6.6. Deleting a License Server
Note: You cannot delete a license server that is bound to and installed on a DLS or CLS instance. You must first delete the CLS or DLS instance to uninstall the license server and free it from the CLS or DLS instance. For instructions, refer to Deleting a Service Instance.
- In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you want to delete the license server.
- If you are not already logged in, log in to the NVIDIA Enterprise Application Hub and click NVIDIA LICENSING PORTAL to go to the NVIDIA Licensing Portal.
- Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group for which you are deleting the license server from the list of virtual groups at the top right of the page.
- In the list of license servers on the NVIDIA Licensing Portal dashboard, select the license server that you want to delete.
- In the License Server Details page that opens, click DELETE SERVER.
- When asked to confirm that you want to delete the license server, click DELETE LICENSE SERVER.
Notice
This document is provided for information purposes only and shall not be regarded as a warranty of a certain functionality, condition, or quality of a product. NVIDIA Corporation (“NVIDIA”) makes no representations or warranties, expressed or implied, as to the accuracy or completeness of the information contained in this document and assumes no responsibility for any errors contained herein. NVIDIA shall have no liability for the consequences or use of such information or for any infringement of patents or other rights of third parties that may result from its use. This document is not a commitment to develop, release, or deliver any Material (defined below), code, or functionality.
NVIDIA reserves the right to make corrections, modifications, enhancements, improvements, and any other changes to this document, at any time without notice.
Customer should obtain the latest relevant information before placing orders and should verify that such information is current and complete.
NVIDIA products are sold subject to the NVIDIA standard terms and conditions of sale supplied at the time of order acknowledgement, unless otherwise agreed in an individual sales agreement signed by authorized representatives of NVIDIA and customer (“Terms of Sale”). NVIDIA hereby expressly objects to applying any customer general terms and conditions with regards to the purchase of the NVIDIA product referenced in this document. No contractual obligations are formed either directly or indirectly by this document.
NVIDIA products are not designed, authorized, or warranted to be suitable for use in medical, military, aircraft, space, or life support equipment, nor in applications where failure or malfunction of the NVIDIA product can reasonably be expected to result in personal injury, death, or property or environmental damage. NVIDIA accepts no liability for inclusion and/or use of NVIDIA products in such equipment or applications and therefore such inclusion and/or use is at customer’s own risk.
NVIDIA makes no representation or warranty that products based on this document will be suitable for any specified use. Testing of all parameters of each product is not necessarily performed by NVIDIA. It is customer’s sole responsibility to evaluate and determine the applicability of any information contained in this document, ensure the product is suitable and fit for the application planned by customer, and perform the necessary testing for the application in order to avoid a default of the application or the product. Weaknesses in customer’s product designs may affect the quality and reliability of the NVIDIA product and may result in additional or different conditions and/or requirements beyond those contained in this document. NVIDIA accepts no liability related to any default, damage, costs, or problem which may be based on or attributable to: (i) the use of the NVIDIA product in any manner that is contrary to this document or (ii) customer product designs.
No license, either expressed or implied, is granted under any NVIDIA patent right, copyright, or other NVIDIA intellectual property right under this document. Information published by NVIDIA regarding third-party products or services does not constitute a license from NVIDIA to use such products or services or a warranty or endorsement thereof. Use of such information may require a license from a third party under the patents or other intellectual property rights of the third party, or a license from NVIDIA under the patents or other intellectual property rights of NVIDIA.
Reproduction of information in this document is permissible only if approved in advance by NVIDIA in writing, reproduced without alteration and in full compliance with all applicable export laws and regulations, and accompanied by all associated conditions, limitations, and notices.
THIS DOCUMENT AND 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. TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL NVIDIA BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT LIMITATION ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF ANY USE OF THIS DOCUMENT, EVEN IF NVIDIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Notwithstanding any damages that customer might incur for any reason whatsoever, NVIDIA’s aggregate and cumulative liability towards customer for the products described herein shall be limited in accordance with the Terms of Sale for the product.
VESA DisplayPort
DisplayPort and DisplayPort Compliance Logo, DisplayPort Compliance Logo for Dual-mode Sources, and DisplayPort Compliance Logo for Active Cables are trademarks owned by the Video Electronics Standards Association in the United States and other countries.
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 Maxwell, NVIDIA Pascal, NVIDIA Turing, NVIDIA Volta, 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.
Copyright
© 2021 NVIDIA Corporation. All rights reserved.