DU-07754-001 _v2022.09 | September 2022
Virtual GPU Software License Server
Version 2022.09
User Guide
Virtual GPU Software License Server Version 2022.09 DU-07754-001 _v2022.09|ii
Table of Contents
Chapter1.Introduction to the NVIDIA vGPU Software License Server...............................1
1.1.Overview of NVIDIA vGPU software Licensing.........................................................................1
1.2.NVIDIA vGPU Software License Server High Availability........................................................ 2
1.3.Overview of the NVIDIA vGPU Software Licensing Process....................................................3
Chapter2.Installing and Configuring the NVIDIA vGPU Software License Server.............4
2.1.Platform Requirements............................................................................................................ 4
2.1.1.Hardware and Software Requirements.............................................................................4
2.1.2.Platform Configuration Requirements..............................................................................5
2.1.3.Network Ports and Management Interface...................................................................... 5
2.1.4.High Availability Requirements..........................................................................................5
2.2.Installing the NVIDIA vGPU Software License Server on Windows........................................ 6
2.2.1.Installing the Java Runtime Environment on Windows....................................................6
2.2.2.Installing the License Server Software on Windows in Graphical Mode......................... 8
2.2.3.Installing the License Server Software on Windows in Console Mode.......................... 12
2.2.4.Installing the License Server Software on Windows in Silent Mode..............................14
2.2.5.Upgrading the NVIDIA vGPU Software License Server and Migrating to OpenJDK on
Windows..................................................................................................................................17
2.2.6. Upgrading from a 32-Bit to a 64-Bit NVIDIA vGPU Software License Server on
Windows..................................................................................................................................19
2.2.7.Upgrading Apache Tomcat on Windows......................................................................... 21
2.3.Installing the NVIDIA vGPU Software License Server on Linux............................................22
2.3.1.Installing the Java Runtime Environment on Linux....................................................... 22
2.3.2.Installing and Running the Apache Tomcat Server on Linux.........................................23
2.3.3.Installing the License Server Software on Linux in Graphical Mode............................. 25
2.3.4.Installing the License Server Software on Linux in Console Mode................................29
2.3.5.Installing the License Server Software on Linux in Silent Mode................................... 30
2.3.6.Upgrading the NVIDIA vGPU Software License Server and Migrating to OpenJDK
on Linux..................................................................................................................................32
2.4.Installing and Securing the License Server in the Cloud..................................................... 33
2.5.Accessing the License Server Management Interface......................................................... 34
2.6.Obtaining the License Server’s MAC Address.......................................................................36
2.7.Enabling Failover Support on the Primary and Secondary License Servers........................37
2.8.Changing the Port for Connections to the License Server...................................................38
2.8.1.Changing the Port for Connections to the License Server on Windows........................ 39
2.8.2.Changing the Port for Connections to the License Server on Linux..............................39
Virtual GPU Software License Server Version 2022.09 DU-07754-001 _v2022.09|iii
Chapter3.Securing the NVIDIA vGPU Software License Server...................................... 41
3.1.Controlling Access to the License Server Management Interface....................................... 41
3.1.1.Enabling Administrative Security for the License Server...............................................41
3.1.2.Default License Server Administrative Credentials........................................................42
3.1.3.License Server Password Requirements........................................................................43
3.1.4.Resetting the Default Administrator Password for the License Server.........................43
3.1.5.Listing All License Server User Accounts...................................................................... 43
3.1.6.Creating a License Server User Account........................................................................44
3.1.7.Modifying a License Server User Account...................................................................... 44
3.1.8.Deleting a License Server User Account........................................................................45
3.2. Configuring HTTPS for Connections Between the Management Interface and the
License Server...........................................................................................................................46
3.2.1.Obtaining an SSL Certificate for the License Server......................................................46
3.2.2.Configuring the License Server with an SSL Certificate................................................ 47
3.2.2.1.Configuring the License Server with an SSL Certificate on Windows..................... 48
3.2.2.2.Configuring the License Server with an SSL Certificate on Linux...........................49
3.2.3.Setting the License Server Connection Protocol to HTTPS........................................... 50
3.2.4.Selecting the TLS Cipher Suite....................................................................................... 51
3.2.5.Importing a Self-Signed or Privately Signed Certificate into the Truststore File.......... 52
3.3. Specifying HTTPS for Connections from a Web Browser to the License Server
Management Interface..............................................................................................................54
Chapter4.Managing Entitlements, Licenses, and Contacts on the NVIDIA Licensing
Portal...............................................................................................................................56
4.1.About the NVIDIA Licensing Portal........................................................................................56
4.2.Creating a License Server on the NVIDIA Licensing Portal..................................................57
4.3.Downloading a License File................................................................................................... 58
4.4.Managing Licenses and Licensed Products on a License Server........................................ 59
4.5.Deleting a License Server...................................................................................................... 60
4.6.Managing Contacts on the NVIDIA Licensing Portal.............................................................61
4.6.1.Role-Based Access to an Organization and Virtual Groups...........................................61
4.6.1.1.Organization Administrator....................................................................................... 62
4.6.1.2.Organization User...................................................................................................... 63
4.6.1.3.Virtual Group Administrator......................................................................................63
4.6.1.4.Virtual Group User.....................................................................................................64
4.6.2.Adding a Contact on the NVIDIA Licensing Portal......................................................... 64
4.6.3.Removing a Contact on the NVIDIA Licensing Portal.....................................................65
4.6.4.Changing the Role of a Contact on the NVIDIA Licensing Portal...................................66
4.6.5.Requesting Access to the NVIDIA Enterprise Support Portal........................................ 67
Virtual GPU Software License Server Version 2022.09 DU-07754-001 _v2022.09|iv
4.7.Managing Virtual Groups........................................................................................................67
4.7.1.Creating a Virtual Group..................................................................................................68
4.7.2.Deleting a Virtual Group.................................................................................................. 69
4.7.3.Adding a Contact to a Virtual Group............................................................................... 70
4.7.4.Removing a Contact from a Virtual Group......................................................................70
4.7.5.Managing Entitlements in a Virtual Group..................................................................... 71
4.7.6.Sample Business Scenario for Virtual Groups............................................................... 72
Chapter5.Managing Licenses on your Local NVIDIA vGPU Software License Server.... 73
5.1.Installing a License.................................................................................................................73
5.2.Verifying High Availability Setup of the License Server........................................................ 75
5.3.Viewing Information About Installed Licenses...................................................................... 76
5.3.1.Viewing the Properties of All Installed Licensed Features............................................ 76
5.3.2.Viewing the Details of a Single Licensed Feature.......................................................... 77
5.3.3.Viewing Information About All Borrowed Licenses........................................................ 78
5.3.4.Viewing the Details of a Single Licensed Client............................................................. 79
5.3.5.About the License Borrow Period................................................................................... 79
5.4.Reserving Licenses................................................................................................................. 80
5.4.1.Creating License Reservations........................................................................................80
5.4.2.Deleting License Reservations........................................................................................ 83
5.4.3.Exporting and Importing License Reservations..............................................................84
5.5.Converting an Evaluation License Server to a Permanent License Server..........................85
Chapter6.Troubleshooting the NVIDIA vGPU Software License Server.......................... 86
6.1.Obtaining Diagnostic Information from the License Server Log Files................................. 86
6.1.1.Log File Locations and Types..........................................................................................86
6.1.2.Changing the License Server Log Level......................................................................... 87
6.1.3.Setting the Time Zone and Retention Policy for the License Server Log File............... 88
6.2.Management Interface Connection Errors............................................................................90
6.3.License Server Connection Errors.........................................................................................91
6.4.License Upload Failures.........................................................................................................92
6.4.1.License Response Fails Trust Criteria............................................................................92
6.4.2.Capability Response Rejected - Response Time Too Old...............................................92
6.4.3.Capability Response Rejected – Update Time Invalid.................................................... 92
6.4.4.Capability Response Rejected - Response Enterprise ID Does Not Match the Server...92
6.5.Trusted Storage Database Errors..........................................................................................93
6.5.1.Restoring the Trusted Storage Database from a Backup..............................................93
6.5.1.1.Restoring the Trusted Storage Database from a Backup on Windows................... 93
6.5.1.2.Restoring the Trusted Storage Database from a Backup on Linux.........................94
6.5.2.Deleting the Trusted Storage Database..........................................................................94
Virtual GPU Software License Server Version 2022.09 DU-07754-001 _v2022.09|v
6.5.2.1.Deleting the Trusted Storage Database on Windows.............................................. 94
6.5.2.2.Deleting the Trusted Storage Database on Linux....................................................95
6.6.Issues when the License Server Is Used with Security Software.........................................95
6.7.FEATURE_NOT_STARTED Failure to Handle a License Request.........................................96
6.8.License Server Failures after Installation, Upgrade, or Migration of the JRE on Windows.. 96
6.8.1.The JAVA_HOME System Variable Was Set Incorrectly................................................. 96
6.8.2.A User Variable Instead of a System Variable Was Set..................................................97
6.8.3.The Path to an Old Version of the JRE Was Not Removed............................................ 97
6.8.4.The Path User Variable Instead of the Path System Variable Was Modified............... 100
6.9.HTTPS Connection Errors.................................................................................................... 100
6.9.1.Unable to Find Valid Certification Path.........................................................................100
6.9.2.Cannot Recover Key....................................................................................................... 100
Chapter7.Uninstalling the NVIDIA vGPU Software License Server............................... 102
7.1.Uninstalling the NVIDIA vGPU Software License Server on Windows................................102
7.2.Uninstalling the NVIDIA vGPU Software License Server on Linux..................................... 104
AppendixA.Administering the License Server from the Command Line.......................106
A.1.Running the nvidialsadmin Utility........................................................................................106
A.2.Setting the License Server Base URL for the nvidialsadmin Utility................................... 107
A.3.Getting Help for the nvidialsadmin Utility........................................................................... 108
A.4.Authenticating with the License Server.............................................................................. 108
A.5.Checking the Status of the License Server.........................................................................108
A.6.Listing Features Installed on the License Server...............................................................109
A.7.Listing the Distribution of License Server Features...........................................................109
AppendixB.Basic Windows OS Administration Tasks....................................................111
B.1.Setting a Windows System Variable....................................................................................111
B.2.Adding a Path to the Path Windows System Variable........................................................ 114
B.3.Deleting a Windows User Variable......................................................................................116
B.4.Removing a Path from the Path Windows User Variable...................................................118
