VIRTUAL GPU LICENSE SERVER

VERSION 2018.06 AND 5.1.0

DU-07754-001 _v6.0 through 6.3 | October 2018

User Guide
 TABLE OF CONTENTS

Chapter 1. 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
Chapter 2. Installing 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..................... 7
2.2.3. Since 2018.06: Installing the License Server Software on Windows in Console Mode... 11
2.3. Installing the NVIDIA vGPU Software License Server on Linux................................... 13
2.3.1. Installing the Java Runtime Environment on Linux...........................................13
2.3.2. Installing and Running the Apache Tomcat Server on Linux.................................13
2.3.3. Installing the License Server Software on Linux in Graphical Mode........................15
2.3.4. Since 2018.06: Installing the License Server Software on Linux in Console Mode........20
Chapter 3. Managing Licenses on the NVIDIA vGPU Software License Server...................... 22
3.1. Accessing the License Server Management Interface..............................................22
3.2. Obtaining the License Server’s MAC Address....................................................... 23
3.3. Enabling Failover Support on the Primary and Secondary License Servers..................... 24
3.4. Registering Your License Server and Getting License Files....................................... 25
3.5. Installing a License..................................................................................... 28
3.6. Verifying High Availability Setup of the License Server........................................... 30
3.7. Viewing Information About Installed Licenses...................................................... 30
3.7.1. Viewing the Properties of All Installed Licensed Features.................................. 31
3.7.2. Viewing the Details of a Single Licensed Feature............................................ 32
3.7.3. Viewing Information About All Borrowed Licenses........................................... 32
3.7.4. Viewing the Details of a Single Licensed Client.............................................. 33
3.7.5. About the License Borrow Period............................................................... 33
3.8. Reserving Licenses...................................................................................... 34
3.8.1. Creating License Reservations................................................................... 34
3.8.2. Deleting License Reservations................................................................... 36
3.8.3. Exporting and Importing License Reservations................................................ 37
3.9. Removing Licenses from a License Server.......................................................... 37
3.10. Converting an Evaluation License Server to a Permanent License Server.....................39
Chapter 4. Troubleshooting the NVIDIA vGPU Software License Server............................. 40
4.1. Obtaining Diagnotsic Information from the License Server Log files............................40

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | ii
 4.1.1. Log File Locations and Types.................................................................... 40
4.1.2. Changing the License Server Log Level........................................................ 41
4.2. Management Interface Connection Errors........................................................... 42
4.3. License Server Connection Errors.................................................................... 43
4.4. License Upload Failures................................................................................ 44
4.4.1. License Response Fails Trust Criteria........................................................... 44
4.4.2. Capability Response Rejected - Response Time Too Old.....................................44
4.4.3. Capability Response Rejected – Update Time Invalid........................................ 45
4.4.4. Capability Response Rejected - Response Enterprise ID Does Not Match the Server.... 45
4.5. Trusted Storage Database Errors......................................................................45
4.5.1. Since 2018.06: Restoring the Trusted Storage Database from a Backup...................45
4.5.1.1. Since 2018.06: Restoring the Trusted Storage Database from a Backup on
Windows............................................................................................... 46
4.5.1.2. Since 2018.06: Restoring the Trusted Storage Database from a Backup on Linux ... 46
4.5.2. Deleting the Trusted Storage Database........................................................ 47
4.5.2.1. Deleting the Trusted Storage Database on Windows.................................... 47
4.5.2.2. Deleting the Trusted Storage Database on Linux........................................ 47
Chapter 5. Uninstalling the NVIDIA vGPU Software License Server.................................. 48
5.1. Uninstalling the NVIDIA vGPU Software License Server on Windows............................ 48
5.2. Uninstalling the NVIDIA vGPU Software License Server on Linux................................ 50

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | iii
 LIST OF FIGURES

Figure 1 NVIDIA vGPU Software Licensing Architecture ................................................... 1

Figure 2 Java 32-Bit Runtime Installation on Windows .................................................... 7

Figure 3 License Agreements on Windows ................................................................... 8

Figure 4 Destination Folder Selection on Windows .........................................................9

Figure 5 Firewall Settings on Windows ..................................................................... 10

Figure 6 Completed License Server Installation on Windows ............................................11

Figure 7 Verifying the Apache Tomcat Installation ....................................................... 15

Figure 8 License Agreements on Linux ......................................................................16

Figure 9 Destination Folder Selection on Linux ........................................................... 17

Figure 10 Apache Tomcat Server Path on Linux ........................................................... 18

Figure 11 Firewall Settings on Linux ........................................................................ 19

Figure 12 Completed License Server Installation on Linux .............................................. 20

Figure 13 License Server Management Interface .......................................................... 23

Figure 14 Obtaining the License Server's MAC Address ...................................................24

Figure 15 License Server Settings for Enabling Failover Support ....................................... 25

Figure 16 Selecting a License File ........................................................................... 29

Figure 17 Successful Upload of a License File .............................................................29

Figure 18 Viewing Licensed Feature Properties ........................................................... 31

Figure 19 Licensed Feature Usage Details ..................................................................32

Figure 20 Viewing License Usage ............................................................................ 33

Figure 21 Licensed Client Details ............................................................................ 33

Figure 22 Adding a License Reservation .................................................................... 34

Figure 23 Submitting a Pending Reservation ............................................................... 35

Figure 24 Listing Reservations ................................................................................ 36

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | iv
Figure 25 Deleting a Reservation ............................................................................ 36

Figure 26 Exporting and Importing License Reservations ................................................ 37

Figure 27 Changing the License Server Log Level .........................................................42

Figure 28 Apache Tomcat Status in Windows Services Manager ....................................... 43

Figure 29 License Server Connection Error .................................................................43

Figure 30 License Server Status in Windows Services Manager ......................................... 44

Figure 31 Starting the Uninstaller from Windows Control Panel ........................................48

Figure 32 Starting the Uninstaller in Windows Explorer from the License Server Installation
Directory....................................................................................................... 49

Figure 33 Running the License Server Uninstaller on Windows ......................................... 50

Figure 34 Running the License Server Uninstaller on Linux ............................................. 51

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | v
 LIST OF TABLES

Table 1 Licensed Feature Properties ........................................................................ 31

Table 2 Log File Locations .................................................................................... 40

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | vi
Chapter 1.
INTRODUCTION TO THE NVIDIA VGPU
SOFTWARE LICENSE SERVER

The NVIDIA vGPU software License Server is used to serve a pool of floating licenses
to NVIDIA vGPU software licensed products. The License Server is designed to be
installed locally within a customer’s network, and be configured with licenses obtained
from the NVIDIA Software Licensing Center.

1.1. Overview of NVIDIA vGPU software Licensing

NVIDIA vGPU software is a licensed product. Licensed vGPU functionalities are
activated during guest OS boot by the acquisition of a software license served over the
network from an NVIDIA vGPU software license server. The license is returned to the
license server when the guest OS shuts down.

Figure 1 NVIDIA vGPU Software Licensing Architecture

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 1
 Introduction to the NVIDIA vGPU Software License Server

The licenses served by the NVIDIA vGPU software license server are obtained from the
NVIDIA Software Licensing Center as downloadable license files, and installed into the
license server through its management interface.

1.2. NVIDIA vGPU Software License Server High

Availability
To provide NVIDIA vGPU software clients with continued access to NVIDIA vGPU
software features if a single license server fails, you can configure the license server for
high availability. High availability requires two license servers in a failover configuration:
‣ A primary license server, which is actively serving licenses to NVIDIA vGPU
software clients
‣ A secondary license server, which acts as a backup for the primary license server
Configuring two servers in a failover configuration increases availability because
simultaneous failure of two servers is rare. The primary and secondary license servers
work together to ensure that licenses in the enterprise remain continually available to
NVIDIA vGPU software clients.
If the primary license server fails, failover occurs and the secondary server can continue
to serve licenses for up to the license server maintenance interval, which is three days.

To ensure that licenses in the enterprise remain continually available after failure
of the primary license server, return the primary server to service within three days
of the failure. Furthermore, the remaining server becomes a single point of failure.
Therefore, you should return the failed server to service as quickly as possible to
restore high availability support for the license server.

During normal operation, the primary license server periodically updates the secondary
server with information about the licenses that are being served to clients. However,
when the primary server is returned to service after a failure, it is not updated with
information from the secondary server about licenses that were served while the
primary server was out of service.
For more information about configuring the license server for high availability, see High
Availability Requirements.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 2
 Introduction to the NVIDIA vGPU Software License Server

1.3. Overview of the NVIDIA vGPU Software

Licensing Process
The following table lists the major tasks in the process of licensing NVIDIA vGPU
software and provides a cross-reference to instructions for performing each task.

If you are configuring the license server for high availability, you must perform some
tasks for both the primary license server and the secondary license server. For more
information, see High Availability Requirements.

Task Instructions
Get your NVIDIA vGPU software and NVIDIA vGPU Virtual GPU Software Quick Start Guide
software License Server software.
Install the NVIDIA vGPU software License Server Installing the NVIDIA vGPU Software License Server
software.
Access the management interface of the license Accessing the License Server Management
server. Interface
Get the MAC address of the license server. Obtaining the License Server’s MAC Address
HA license servers only: Enable failover support. Enabling Failover Support on the Primary and
Secondary License Servers
Register your license server, generate licenses, and Registering Your License Server and Getting
download license files. License Files
Install a license. Installing a License
View available licenses. Viewing Information About Installed Licenses
Reserve and release licenses. Reserving Licenses
Move a license to a new server. 1. Removing Licenses from a License Server
2. Registering Your License Server and Getting
License Files

Convert a trial license server to a permanent Converting an Evaluation License Server to a

license server. Permanent License Server
Configure licensed NVIDIA vGPU software products Virtual GPU Client Licensing User Guide
for use with license server.
Troubleshoot the license server. Troubleshooting the NVIDIA vGPU Software License
Server
Uninstall the license server software. Uninstalling the NVIDIA vGPU Software License
Server

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 3
Chapter 2.
INSTALLING THE NVIDIA VGPU SOFTWARE
LICENSE SERVER

You can install the NVIDIA vGPU software license server on Windows and Linux
systems that meet the license server’s platform requirements. If you require high
availability for the license server, you must install the license server both on the system
that you will use as the primary license server and on the system that you will use as the
secondary license server.
The license server requires a Java runtime environment and an Apache Tomcat server.
Before you install the license server software, ensure that the required software is
already installed on each license server host machine that you are using:
‣ On Windows, you need ensure only that the Java runtime environment is installed.
The Apache Tomcat server is included in the license server installer for Windows.
‣ On Linux, you must ensure that both the Java runtime environment and the Apache
Tomcat server are installed.
Also ensure that you have obtained your NVIDIA vGPU software and NVIDIA vGPU
software License Server software. For more information, refer to Virtual GPU Software
Quick Start Guide.

2.1. Platform Requirements

Before proceeding, ensure that you have a platform suitable for hosting the license
server.

2.1.1. Hardware and Software Requirements

‣ The hosting platform may be a physical or virtual machine (VM). NVIDIA
recommends using a host that is dedicated solely to running the license server.
‣ The recommended minimum configuration is 2 CPU cores and 4 Gbytes of RAM. A
high-end configuration of 4 or more CPU cores with 16 Gbytes of RAM is suitable
for handling up to 150,000 licensed clients.
‣ The hosting platform must run a supported operating system.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 4
 Installing the NVIDIA vGPU Software License Server

‣ On Window platforms, .NET Framework 4.5 or later is required.

Before proceeding with the installation, refer to Virtual GPU License Server Release
Notes for details of supported operating systems and known issues.

2.1.2. Platform Configuration Requirements

‣ 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 must have at least one unchanging Ethernet MAC address, to be used
as a unique identifier when registering the server and generating licenses in the
NVIDIA Software Licensing Center.
‣ The platform’s date and time must be set accurately. NTP is recommended.

2.1.3. Network Ports and Management Interface

The license server requires TCP port 7070 to be open in the platform’s firewall, to serve
licenses to clients. By default, the installer will automatically open this port.
The license server’s management interface is web-based, and uses TCP port 8080. The
management interface itself does not implement access control; instead, the installer
does not open port 8080 by default, so that the management interface is only available
to web browsers running locally on the license server host. Access to the management
interface is therefore controlled by limiting remote access (via VNC, RDP, etc.) to the
license server platform.

If you choose to open port 8080 during license server installation, or at any time
afterwards, the license server’s management interface is unprotected.

2.1.4. High Availability Requirements

If you plan to configure high availability for the license sever by configuring a primary
server and a secondary server, these requirements must be met:
‣ Both servers must run the same version of the NVIDIA vGPU Software License
Server software.
‣ The clocks on both servers must be accurate and synchronized. NTP is
recommended.
‣ The same license configuration file must be installed on both servers. This file is
configured to include the Ethernet MAC addresses of both servers.
If you are configuring the license server for high availability, you must perform the
following tasks for both the primary license server and the secondary license server:
‣ Installing the license server:
‣ Installing the NVIDIA vGPU Software License Server on Windows
‣ Installing the NVIDIA vGPU Software License Server on Linux
‣ Obtaining the License Server’s MAC Address

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 5
 Installing the NVIDIA vGPU Software License Server

‣ Enabling Failover Support on the Primary and Secondary License Servers

‣ Registering Your License Server and Getting License Files
‣ Installing a License
‣ Verifying High Availability Setup of the License Server
‣ Reserving Licenses

2.2. Installing the NVIDIA vGPU Software License

Server on Windows
The license server requires a Java runtime environment, which must be installed
separately before you install the license server.

If you require high availability for the license server, you must install the license
server both on the system that you will use as the primary license server and on the
system that you will use as the secondary license server.

2.2.1. Installing the Java Runtime Environment on

Windows
If a suitable 32-bit Java version is not already installed on your system, download the
current 32-bit Java runtime environment from the java.com: Java + You website and
install it before running the NVIDIA license server installer.

Install the 32-bit Java runtime, regardless of whether your platform is 32-bit Windows
or 64-bit Windows. If a 64-bit Java runtime is already installed, remove it before
installing the 32-bit version to ensure that future updates to the Java software can be
applied correctly.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 6
 Installing the NVIDIA vGPU Software License Server

Figure 2 Java 32-Bit Runtime Installation on Windows

2.2.2. Installing the License Server Software on

Windows in Graphical Mode
1. Unzip the license server installer and run setup.exe.
2. Accept the EULA for the license server software and the Apache Tomcat software
used to support the license server’s management interface.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 7
 Installing the NVIDIA vGPU Software License Server

Figure 3 License Agreements on Windows

3. Choose the destination folder where you want the license server software to be
installed.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 8
 Installing the NVIDIA vGPU Software License Server

Figure 4 Destination Folder Selection on Windows

4. In the Choose Firewall Options dialog box, select the ports to be opened in the
firewall.
To enable remote clients to access licenses from the server and prevent remote access
to the management interface, use the default setting, which sets ports as follows:
‣ Port 7070 is open to enable remote clients to access licenses from the server.
‣ Port 8080 is closed to ensure that the management interface is available only
through a web browser running locally on the license server host.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 9
 Installing the NVIDIA vGPU Software License Server

Figure 5 Firewall Settings on Windows

5. After installation has completed successfully, click Done to exit the installer.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 10
 Installing the NVIDIA vGPU Software License Server

Figure 6 Completed License Server Installation on Windows

After quitting the installer, verify the installation by accessing the License Server
management interface as explained in Accessing the License Server Management
Interface.

2.2.3. Since 2018.06: Installing the License Server

Software on Windows in Console Mode

Support for installation in Windows console mode is introduced in license server

release 2018.06. It is not supported in earlier license server releases. The license
server installer for earlier releases must be run in a graphical desktop environment.
Installation in silent mode is not supported in any release.

1. Extract the contents of the license server zip archive.

2. Run the extracted setup binary.

C:\> setup.exe -i console

The Introduction screen of the InstallAnywhere installer is displayed.

3. In the Introduction screen, press Enter to continue.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 11
 Installing the NVIDIA vGPU Software License Server

4. In the License Agreement screen, press Enter each time you are prompted to page
through the license agreement.
When you reach the end of the license agreement, you are prompted to accept its
terms.
5. Type y to accept the terms of the license agreement and proceed with installation.
6. In the Apache License Agreement screen, press Enter each time you are prompted
to page through the license agreement.
When you reach the end of the license agreement, you are prompted to accept its
terms.
7. Type y to accept the terms of the license agreement and proceed with installation.
8. In the Choose Install Folder screen, specify where you want the license server
software to be installed:
‣ Press Enter to accept the default installation folder.
‣ Enter the absolute path to the destination folder where you want the license
server software to be installed.
9. In the Choose Firewall Options screen box, select the ports to be opened in the
firewall.
The options for selecting ports to be opened in the firewall are presented as follows:
->1- License server (port 7070)
2- Management interface (port 8080)

‣ Press Enter to accept the default setting.

‣ Enter a comma-separated list of numbers that represent your choice of ports to be
opened.
To enable remote clients to access licenses from the server and prevent remote access
to the management interface, use the default setting, which sets ports as follows:
‣ Port 7070 is open to enable remote clients to access licenses from the server.
‣ Port 8080 is closed to ensure that the management interface is available only
through a web browser running locally on the license server host.
10. In the Pre-Installation Summary screen, review your choices and press Enter to
start the installation.
After installation has completed successfully, the Install Complete screen is
displayed.
11. In the Install Complete screen, press Enter to exit the installer.

After quitting the installer, verify the installation by accessing the license server
management interface as explained in Accessing the License Server Management
Interface.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 12
 Installing the NVIDIA vGPU Software License Server

2.3. Installing the NVIDIA vGPU Software License

Server on Linux
The license server requires a Java runtime environment and an Apache Tomcat server,
which must be installed separately before you install the license server software.

If you require high availability for the license server, you must install the license
server both on the system that you will use as the primary license server and on the
system that you will use as the secondary license server.

2.3.1. Installing the Java Runtime Environment on Linux

Most Linux distributions install a Java runtime environment by default.
1. Verify that your Linux installation has Java installed.
[nvidia@localhost ~]$ java -version
java version "1.7.0_51"
OpenJDK Runtime Environment (rhel-2.4.5.5.el7-x86_64 u51-b31)
OpenJDK 64-Bit Server VM (build 24.51-b03, mixed mode)
[nvidia@localhost ~]$
2. If Java is not installed, use your Linux distribution’s package manager to install Java.
‣ For distributions based on Red Hat, use the yum package manager to install the
java package.
[nvidia@localhost ~]$ sudo yum install java
‣ For distributions based on Debian, use the apt package manager to install the
default-jdk package.
[nvidia@localhost ~]$ sudo apt install default-jdk

2.3.2. Installing and Running the Apache Tomcat Server

on Linux
The license server’s management interface requires an Apache Tomcat server.
1. Use your Linux distribution’s package manager to install the required Apache
Tomcat packages.
‣ For distributions based on Red Hat, use the yum package manager to install the
tomcat and tomcat-webapps packages.
[nvidia@localhost ~]$ sudo yum install tomcat tomcat-webapps
‣ For distributions based on Debian, use the apt package manager to install the
tomcatrelease package. For example, for Apache Tomcat 8, run:
[nvidia@localhost ~]$ sudo apt install tomcat8

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 13
 Installing the NVIDIA vGPU Software License Server

2. After installing the packages, enable the Tomcat service for automatic startup on
boot.
‣ For distributions based on Red Hat, enable the tomcat service.
[nvidia@localhost ~]$ sudo systemctl enable tomcat.service
‣ For distributions based on Debian, enable the tomcatrelease service. For
example, for Apache Tomcat 8, run:
[nvidia@localhost ~]$ sudo systemctl enable tomcat8.service
3. Start the Tomcat service.
‣ For distributions based on Red Hat, start the tomcat service.
[nvidia@localhost ~]$ sudo systemctl start tomcat.service
‣ For distributions based on Debian, start the tomcatrelease service. For
example, for Apache Tomcat 8, run:
[nvidia@localhost ~]$ sudo systemctl start tomcat8.service
4. Verify that the Tomcat service is operational by opening the URL http://
localhost:8080 in a web browser.
The home page of the default Tomcat web application should be displayed, as
shown in Figure 7.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 14
 Installing the NVIDIA vGPU Software License Server

Figure 7 Verifying the Apache Tomcat Installation

Do not relocate the webapps folder, which is where Web applications are deployed
on Apache Tomcat Server. If you relocate this folder, the installation of the license
server software may fail.

2.3.3. Installing the License Server Software on Linux in

Graphical Mode
1. Extract the contents of the license server ZIP archive.
[nvidia@localhost ~]$ unzip NVIDIA-ls-linux-2018.06.0.24304595.zip
2. Add execute permission to the extracted setup binary file.
[nvidia@localhost ~]$ chmod +x setup.bin
3. As root, run the extracted setup binary.
[nvidia@localhost ~]$ sudo ./setup.bin
4. Accept the EULA to proceed with installation.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 15
 Installing the NVIDIA vGPU Software License Server

Figure 8 License Agreements on Linux

5. Choose the destination folder where you want the license server software to be
installed.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 16
 Installing the NVIDIA vGPU Software License Server

Figure 9 Destination Folder Selection on Linux

6. Specify the path to the folder on the local host that contains the webapps folder.
Web applications are deployed on Apache Tomcat Server to the webapps folder.
‣ For distributions based on Red Hat, the default path to this folder is /usr/
share/tomcat.
‣ For distributions based on Debian, the default path to this folder is /var/lib/
tomcatrelease, for example /var/lib/tomcat8, for Apache Tomcat 8.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 17
 Installing the NVIDIA vGPU Software License Server

Figure 10 Apache Tomcat Server Path on Linux

7. In the Choose Firewall Options dialog box, shown in Figure 11, select the ports to
be opened in the firewall.
To enable remote clients to access licenses from the server and prevent remote access
to the management interface, use the default setting, which sets ports as follows:
‣ Port 7070 is open to enable remote clients to access licenses from the server.
‣ Port 8080 is closed to ensure that the management interface is available only
through a web browser running locally on the license server host.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 18
 Installing the NVIDIA vGPU Software License Server

Figure 11 Firewall Settings on Linux

8. After installation has completed successfully, click Done to exit the installer.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 19
 Installing the NVIDIA vGPU Software License Server

Figure 12 Completed License Server Installation on Linux

After quitting the installer, verify the installation by accessing the license server
management interface as explained in Accessing the License Server Management
Interface.

2.3.4. Since 2018.06: Installing the License Server

Software on Linux in Console Mode

Support for installation in Linux console mode is introduced in license server

release 2018.06. It is not supported in earlier license server releases. The license
server installer for earlier releases must be run in a graphical desktop environment.
Installation in silent mode is not supported in any release.

1. Extract the contents of the license server ZIP archive.

[nvidia@localhost ~]$ unzip NVIDIA-ls-linux-2018.06.0.24304595.zip
2. Add execute permission to the extracted setup binary file.
[nvidia@localhost ~]$ chmod +x setup.bin
3. As root, run the extracted setup binary.
[nvidia@localhost ~]$ sudo ./setup.bin -i console

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 20
 Installing the NVIDIA vGPU Software License Server

The Introduction screen of the InstallAnywhere installer is displayed.

4. In the Introduction screen, press Enter to continue.
5. In the License Agreement screen, press Enter each time you are prompted to page
through the license agreement.
When you reach the end of the license agreement, you are prompted to accept its
terms.
6. Type y to accept the terms of the license agreement and proceed with installation.
7. In the Choose Install Folder screen, specify where you want the license server
software to be installed:
‣ Press Enter to accept the default installation folder.
‣ Enter the absolute path to the destination folder where you want the license
server software to be installed.
8. In the Choose Local Tomcat Server Path screen, enter the path to the folder on the
local host that contains the webapps folder.
Web applications are deployed on Apache Tomcat Server to the webapps folder.
‣ For distributions based on Red Hat, the default path to this folder is /usr/
share/tomcat.
‣ For distributions based on Debian, the default path to this folder is /var/lib/
tomcatrelease, for example /var/lib/tomcat8, for Apache Tomcat 8.
9. In the Choose Firewall Options screen box, select the ports to be opened in the
firewall.
The options for selecting ports to be opened in the firewall are presented as follows:
->1- License server (port 7070)
2- Management interface (port 8080)

‣ Press Enter to accept the default setting.

‣ Enter a comma-separated list of numbers that represent your choice of ports to be
opened.
To enable remote clients to access licenses from the server and prevent remote access
to the management interface, use the default setting, which sets ports as follows:
‣ Port 7070 is open to enable remote clients to access licenses from the server.
‣ Port 8080 is closed to ensure that the management interface is available only
through a web browser running locally on the license server host.
10. In the Pre-Installation Summary screen, review your choices and press Enter to
start the installation.
After installation has completed successfully, the Install Complete screen is
displayed.
11. In the Install Complete screen, press Enter to exit the installer.

After quitting the installer, verify the installation by accessing the license server
management interface as explained in Accessing the License Server Management
Interface.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 21
Chapter 3.
MANAGING LICENSES ON THE NVIDIA
VGPU SOFTWARE LICENSE SERVER

Managing licenses on the NVIDIA vGPU software license server involves installing
licenses on the license server and controlling and monitoring the usage of installed
licenses. You manage the license server in a web browser through the license server
management interface.

3.1. Accessing the License Server Management

Interface
Access the license server management interface to verify that the license server is
operating correctly or to manage licenses on the license server.

‣ If the license server host does not permit remote access, open a web browser on
the license server host and connect to the URL http://localhost:8080/
licserver.
‣ If the license server host’s network firewall is configured to permit remote access
to the license server, open a web browser on a remote machine and connect to the
URL http://hostname:8080/licserver, where hostname is the fully-qualified
domain name or IP address of the license server host.
The browser should display the home page for the license server management interface,
as shown in Figure 13.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 22
 Managing Licenses on the NVIDIA vGPU Software License Server

Figure 13 License Server Management Interface

If the management interface is not displayed, consult Management Interface Connection
Errors for troubleshooting steps.

3.2. Obtaining the License Server’s MAC Address

The license server’s Ethernet MAC address uniquely identifies your server to the
NVIDIA Software Licensing Center. You will need this address to register your license
server with the NVIDIA Software Licensing Center to generate license files.

If you are configuring the license server for high availability, you will need the MAC
address of both the primary license server and the secondary license server.

1. In the license server management interface, select Configuration.

2. On the License Server Configuration page that opens, in the Server host ID drop-
down list, select the platform’s ETHERNET address.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 23
 Managing Licenses on the NVIDIA vGPU Software License Server

Figure 14 Obtaining the License Server's MAC Address

You must use the same ETHERNET ID to consistently identify the server when
generating licenses on the NVIDIA Licensing Portal. If your platform has multiple
Ethernet interfaces, multiple ETHERNET entries may be displayed in the Server
host ID drop-down list. To ensure that you use the same ETHERNET ID to
consistently to identify the server, select one entry that corresponds to a primary
(nonremovable) interface on the platform.

3.3. Enabling Failover Support on the Primary and

Secondary License Servers
If you are configuring high availability for the license server, you must enable failover
support on both the primary license server and on the secondary license server. Set the
same options on both servers.
1. In the license server management interface, select Configuration.
The License Server Configuration page opens.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 24
 Managing Licenses on the NVIDIA vGPU Software License Server

Figure 15 License Server Settings for Enabling Failover Support

2. Under License Generation, use the Backup URI and Main URI fields to set the URI
to each server in a failover configuration.
a) In the Backup URI field, enter http://secondary-server-ip-
address:7070/fne/bin/capability.
b) In the Main URI field, enter http://primary-server-ip-address:7070/
fne/bin/capability.
secondary-server-ip-address
The IP address of the secondary license server.
primary-server-ip-address
The IP address of the primary license server.
3. Set the options under Settings for server to sync between License servers as
follows:
a) Set the Synchronization to fne enabled option to true.
b) In the Main FNE Server URI field, enter http://primary-server-ip-
address:7070/fne/bin/capability.
primary-server-ip-address
The IP address of the primary license server.
4. Click Save.

3.4. Registering Your License Server and Getting

License Files
To be able to generate and download licenses from the NVIDIA Software Licensing
Center, you must register your license server. Before downloading a license file, you

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 25
 Managing Licenses on the NVIDIA vGPU Software License Server

must generate the file by mapping to it the add-ons that correspond to your licenses. The
license file is empty by default and does not contain any licenses it until you map add-
ons to it.

If you require high availability for the license server, you must register a secondary
server when the primary server is registered. If you do not register a secondary server
when the primary server is registered, you cannot register the secondary server later.

1. 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 Software Licensing
Center.
2. In the navigation pane of the NVIDIA Software Licensing Center page, under
GRID Licensing, select Register License Server.
3. On the Register License Server page that opens, provide the details of your license
server.
a) In the MAC Address field, enter the MAC address of your primary license
server.
Enter only the numbers and letters in the address. Do not enter any spaces or
punctuation.
If you have only one license server configured, enter its MAC address in this
field.
b) In the Backup License Server ID field, enter the MAC address of your secondary
license server.
Enter only the numbers and letters in the address. Do not enter any spaces or
punctuation.
If you have only one license server configured, leave this field unset.
c) Optional: Provide an alias and site name for your license server.
If you do not provide an alias, it is set to the MAC address of your license server.
You can edit the alias after your license server is registered.
If you do not provide a site name, your license server is registered without a site
name. You cannot add a site name after your license server is registered.
d) Click Create.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 26
 Managing Licenses on the NVIDIA vGPU Software License Server

4. On the View Server page that opens, follow the Map Add-Ons link.

5. On the Map Add-Ons page that opens, in the Qty to add field, enter the number of
licenses you want to add to your license file and click Map Add-Ons.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 27
 Managing Licenses on the NVIDIA vGPU Software License Server

You can also configure and register multiple servers and distribute your NVIDIA
vGPU software licenses across them by mapping add-ons to servers as necessary.
After clicking Map Add-Ons, you are returned to the View Server page.
6. Back on the View Server page, follow the Download License File link and save the
.bin license file to your license server for installation.

The .bin license file is valid for 24 hours. If you do not install the file within 24
hours of downloading it, you must download it again.

3.5. Installing a License

NVIDIA vGPU software licenses are distributed as .bin files for download from the
NVIDIA Software Licensing Center.

If you have configured high availability for the license server, you must install the
license both on the primary license server and on the secondary license server.

Before installing a license, ensure that you have downloaded the license file from the
NVIDIA Software Licensing Center.
1. In the license server management interface, select License Management.
2. On the License Management page that opens, click Choose File.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 28
 Managing Licenses on the NVIDIA vGPU Software License Server

Figure 16 Selecting a License File

3. In the file browser that opens, select the .bin file and click Open.
4. Back on the License Management page, click Upload to install the license file on the
license server.
The license server should confirm successful installation of the license file.

Figure 17 Successful Upload of a License File

5. If you have configured high availability for the license server, restart the license
server service on the primary license server and on the secondary license server.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 29
 Managing Licenses on the NVIDIA vGPU Software License Server

‣ On Windows, use the Service Manager, which is accessible from Task Manager,
to restart the FNLS-nvidia service.
‣ On Linux, as root, restart the flexnetls-nvidia service.
[nvidia@localhost ~]$ sudo systemctl restart flexnetls-nvidia

3.6. Verifying High Availability Setup of the

License Server
The license server log file indicates the failover role of the given license server and its
synchronization status.
For the location of the log file on your platform, refer to Log File Locations and Types.
In the license server log file, search for the string that designates the server role. The
line that contains the string and the lines that follow it indicate the role and status of the
server.

‣ For the primary server, search for the string main server.
23:29:25,655 INFO Server is designated as a main server in a failover
configuration
23:29:29,041 INFO Received sync request from the backup server
23:34:31,815 INFO Generated sync message for the backup server
‣ For the secondary server, search for the string backup server.
00:39:53,290 INFO Server is designated as a backup server in a failover
configuration
00:39:55,388 INFO Starting sync from main server
00:39:56,784 INFO Successfully completed sync from main server

Tip When a client acquires a license from the primary server, the number of available
licensed features is reduced by 1 on both the primary and the secondary servers.
When the license server is operating, you can verify its high availability setup by
confirming that the count of available licenses on the primary and the secondary
servers changes as expected as clients acquire licenses from the server.

3.7. Viewing Information About Installed Licenses

From the license server management interface, you can find out which licenses are
installed on the server, view detailed information about individual licenses, and see how
licensed clients are using the installed licenses.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 30
 Managing Licenses on the NVIDIA vGPU Software License Server

3.7.1. Viewing the Properties of All Installed Licensed

Features
By viewing licensed feature properties, you can see the licenses that are installed on the
server and get detailed information about each installed license feature.
In the license server management interface, select Licensed Feature Usage.
The Licensed Feature Usage page that opens lists all licensed features installed on the
license server.

Figure 18 Viewing Licensed Feature Properties

For each licensed feature, the properties in the following table are displayed.

Table 1 Licensed Feature Properties

Property Description

Feature An abbreviated name for the feature.

Version The version number associated with the feature.

Count The number of licenses for the feature that are currently installed on the
license server. Each concurrent user of a feature normally consumes one
license.

Available The number of licenses for the feature that are currently available to borrow
from the server. This number decreases as users borrow licenses from the
server, and increases as licenses are returned.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 31
 Managing Licenses on the NVIDIA vGPU Software License Server

Property Description

Expiry The date on which the right to use the licensed feature expires. If the
licenses are perpetual use licenses, they have no expiration date. Perpetual
licenses are indicated by permanent in place of an expiration date.

3.7.2. Viewing the Details of a Single Licensed Feature

For each installed license feature, you can view detailed information about the feature.
1. In the license server management interface, select Licensed Feature Usage.
2. On the Licensed Feature Usage page that opens, click the individual licensed
feature about which you want detailed information.
The Licensed Feature Details page that opens shows information about the feature.

Figure 19 Licensed Feature Usage Details

3.7.3. Viewing Information About All Borrowed Licenses

By viewing information about all borrowed licenses, you can find out which licenses
have been borrowed from the license server and are in use by a licensed client.
In the license server management interface, select Licensed Clients.
The Licensed Clients page that opens lists the NVIDIA vGPU software client virtual
machines are using licensed features.
The example in Figure 20 shows that one NVIDIA vGPU software client virtual machine
is using a Quadro-Virtual-DWS license.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 32
 Managing Licenses on the NVIDIA vGPU Software License Server

Figure 20 Viewing License Usage

3.7.4. Viewing the Details of a Single Licensed Client

1. In the license server management interface, select Licensed Clients.
2. On the Licensed Clients page that opens, click the Client ID of the licensed client
about which you want detailed information.
The Client Details page opens to show detailed information about the licensed
client.

Figure 21 Licensed Client Details

3.7.5. About the License Borrow Period

At the end of the borrow period, typically multiple days, a borrowed license is
automatically freed by the license server for use by other clients, and becomes
unavailable on the licensed client that previously held it. While active, a licensed
client renews its license periodically to ensure the borrow period does not expire, if it
continues to use the license and has ongoing network connectivity to the license server.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 33
 Managing Licenses on the NVIDIA vGPU Software License Server

3.8. Reserving Licenses

Licenses are normally distributed to clients on a first-come, first-served basis.
Reservations allow licenses to be set aside for specific clients, ensuring that those clients
can always obtain a license.

3.8.1. Creating License Reservations

The license server management interface enables you to set up several new reservations
and submit them to the license server in a single group.

After creating a group of license reservations, you cannot use the management UI to
delete individual reservations in the group or to add new reservations to the group.
If you try to use the management UI to delete a single entry from the Reservation
page, all entries on the page are deleted. For more information about this issue and
its workaround, see Virtual GPU License Server Release Notes.

In an HA configuration, create identical license reservations on the primary license

server and the secondary license server. To ensure that the license reservations
are identical on both servers, you can export reservations from one server and
import them into the other server as explained in Exporting and Importing License
Reservations.

1. In the license server management interface, select Reservations.

The License Reservations page opens.
2. Add each reservation that you want to create to the list of pending reservations.

Figure 22 Adding a License Reservation

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 34
 Managing Licenses on the NVIDIA vGPU Software License Server

a) On the License Reservations page, click Add.

b) On the Add Reservation page that opens, provide the details of the client for
which you are creating the reservation and click Add.
Group Name
(Optional) Enter the name you want to assign to this reservation group.
Client ID
Enter the client’s Ethernet MAC address.
Feature Name
Enter the licensed feature name as listed on the Licensed Feature Usage page,
which is shown in Viewing the Properties of All Installed Licensed Features.
Version
Enter the version number listed for the feature listed on the Licensed Feature
Usage page.
Count
Set to the number of licenses that you want to reserve for the client.
3. After adding all reservations that you want to create, click Submit to commit the
pending reservations to the license server.

Figure 23 Submitting a Pending Reservation

After the reservations are submitted, the License Reservations page shows a list of
currently stored reservations on the server.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 35
 Managing Licenses on the NVIDIA vGPU Software License Server

Figure 24 Listing Reservations

3.8.2. Deleting License Reservations

If a client no longer requires a license that is reserved for it, delete the reservation to
release the license for distribution to other clients.
1. In the license server management interface, select Reservations.
2. On the License Reservations page that opens, select the reservations that you want
to delete and click Edit.
The License Reservations page is updated to replace the existing buttons on the
page with the Delete button.
3. On the updated License Reservations page, click Delete.

Figure 25 Deleting a Reservation

4. In the confirmation dialog box that opens, click OK.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 36
 Managing Licenses on the NVIDIA vGPU Software License Server

3.8.3. Exporting and Importing License Reservations

Exporting license reservations downloads the current reservation list as an XML file
through your web browser. Importing license reservations from an XML file replaces the
license server’s current reservation list with the contents of the file.

Because importing license reservations from a file replaces the license server’s
current reservation list, any reservations on the server that are not in the file are
lost.

1. In the license server management interface, select Reservations.

2. On the License Reservations page that opens, do one of the following:

‣ To export license reservations, click Export.

‣ To import license reservations, click Import, browse to the XML file that contains
the reservations, and click Upload.

Figure 26 Exporting and Importing License Reservations

3.9. Removing Licenses from a License Server

Remove licenses from a license server if they are no longer needed or in preparation
for migrating them to a new server. Removing licenses involves generating and
downloading a license file from which you have removed the add-ons that correspond
to the licenses that you want to remove.
1. If you are not already logged in, log in to the NVIDIA Software Licensing Center.
2. In the navigation pane of the NVIDIA Software Licensing Center page, under
GRID Licensing, select Search License Servers.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 37
 Managing Licenses on the NVIDIA vGPU Software License Server

3. On the Search Servers page that opens, select the license server from which you
want to remove licenses.
4. On the View Server page that opens, follow the Remove Add-Ons link.

5. On the Remove Add-Ons page that opens, in the Qty to Remove field, enter the
number of licenses you want to remove and click Remove Add-Ons.

After clicking Remove Add-Ons, you are returned to the View Server page.
6. Back on the View Server page, follow the Download License File link and save the
.bin license file to your license server.

You must download the license file after you remove add-ons. If you do not
download the license file, the licenses that correspond to the add-ons that you
removed from the license file are not removed from the server.

If you removed licenses in preparation for migrating them to a new server, add them to
the server as explained in Registering Your License Server and Getting License Files.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 38
 Managing Licenses on the NVIDIA vGPU Software License Server

3.10. Converting an Evaluation License Server to a

Permanent License Server
If you purchase NVIDIA vGPU software licenses after evaluating the software, you can
use the same license server that you registered for your evaluation licenses to serve your
permanent licenses.
1. Log in to the NVIDIA Software Licensing Center with the account that you created
for getting your evaluation licenses.
2. Get the NVIDIA vGPU software for the licenses that you purchased.
For instructions, refer to Virtual GPU Software Quick Start Guide.
3. Get your new license files as explained in Registering Your License Server and
Getting License Files.

Follow the steps only for mapping add-ons and downloading the license file. Do
not try to register your license server again. If you try to register a license server
that is already registered, the attempt fails and you are warned that the MAC
address is already in use.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 39
Chapter 4.
TROUBLESHOOTING THE NVIDIA VGPU
SOFTWARE LICENSE SERVER

You can troubleshoot some common issues with the license server yourself without the
need to obtain help from NVIDIA.

Before troubleshooting, review Virtual GPU License Server Release Notes for
information about known issues and potential workarounds.

4.1. Obtaining Diagnotsic Information from the

License Server Log files
The license server log files contain diagnostic information to help with troubleshooting.
If necessary, you can increase the amount of information in the log files by changing the
log level of the license server.

4.1.1. Log File Locations and Types

Log files from the installer and license server are in the locations in the following table.

Table 2 Log File Locations

Host
OS Log Location
Windows Installer C:\Program Files (x86)\NVIDIA\License Server\Logs
License C:\Windows\ServiceProfiles\NetworkService\flexnetls\nvidia
server \logs
Linux Installer /opt/flexnetls/nvidia/Logs/
License /var/opt/flexnetls/nvidia/logs
server

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 40
 Troubleshooting the NVIDIA vGPU Software License Server

To confirm the location of the license server log files, use the license server management
interface: Select Configuration and click the Properties tab.
The location of the log files is displayed on the License Server Configuration page in the
Logging Directory field.

The license server generates these types of runtime log files:

‣ Management interface accesses are recorded in access_*.request.log files.
‣ License server activity is recorded in flexnetls_*.log files.

4.1.2. Changing the License Server Log Level

The default log level of the license server is INFO.
To adjust the amount of information in the log files, set the log level to a different level.
1. In the license server management interface, select Configuration and click the
Properties tab.
2. On the License Server Configuration page, in the Logging Threshold field, enter a
new log level, for example WARN or ERROR, and click Save.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 41
 Troubleshooting the NVIDIA vGPU Software License Server

Figure 27 Changing the License Server Log Level

All messages at or below the level you set are recorded in the log file. For example, if
you set the log level to WARN, fatal-event, error, and warning messages are recorded.

4.2. Management Interface Connection Errors

The management interface at http://hostname:8080/licserver might be
unreachable because the license server host’s firewall disallows remote access to server
TCP port 8080 or because the Apache Tomcat service is not running on the server.
1. If you are trying to access the management interface from a remote machine, try
accessing the interface locally from the license server host.
To access the interface locally, open a web browser on the license server host and
connect to the URL http://localhost:8080/licserver.
2. If you can access the management interface locally, ensure that the license server
host’s firewall is configured to allow remote access to server TCP port 8080.
3. If you cannot access the management interface locally, verify that the Apache Tomcat
service is running on the license server host.
‣ On Windows, use the Service Manager, which is accessible from Task Manager, to
restart the service if it is not running.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 42
 Troubleshooting the NVIDIA vGPU Software License Server

Figure 28 Apache Tomcat Status in Windows Services Manager

‣ On Linux, check the status of the tomcat service.
[nvidia@localhost ~]$ systemctl status tomcat.service
tomcat.service - Apache Tomcat Web Application Container
Loaded: loaded (/usr/lib/systemd/system/tomcat.service; enabled)
Active: active (running) since Fri 2015-09-11 07:39:11 PDT; 9h ago
Main PID: 1373 (java)
CGroup: /system.slice/tomcat.service
└─1373 java -classpath /usr/share/tomcat/bin/bootstrap.jar:/
usr/sh...

4.3. License Server Connection Errors

If the license server’s management interface cannot establish a connection to the license
server, the management interface displays an error message.

Figure 29 License Server Connection Error

1. Verify that the license service is running.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 43
 Troubleshooting the NVIDIA vGPU Software License Server

‣ On Windows, use the Service Manager, which is accessible from Task Manager,
to restart the service if it is not running.

Figure 30 License Server Status in Windows Services Manager

‣ On Linux, check the status of the flexnetls-nvidia service.
[nvidia@localhost ~]$ systemctl status flexnetls-nvidia.service
flexnetls-nvidia.service - LSB: start and stop FlexNet License Server
Loaded: loaded (/etc/rc.d/init.d/flexnetls-nvidia)
Active: active (running) since Fri 2015-09-11 14:44:34 PDT; 2h 49min
ago
Process: 4502 ExecStart=/etc/rc.d/init.d/flexnetls-nvidia start
(code=exited, status=0/SUCCESS)
CGroup: /system.slice/flexnetls-nvidia.service
├─4567 java -Dbase.dir=/var/opt/flexnetls/nvidia -jar /opt/
flexnet...
└─4609 java -Dbase.dir=/var/opt/flexnetls/nvidia -jar /opt/
flexnet...
2. Inspect the license server log files, which are described in Log File Locations and
Types.

4.4. License Upload Failures

Errors may occur during an attempt to upload a license file to the license server.

4.4.1. License Response Fails Trust Criteria

The license server reports a trust failure if it attempts to reload a license file that’s
already loaded.
Verify that the license file being uploaded is not already active on the server.

4.4.2. Capability Response Rejected - Response Time

Too Old
The license server reports this error if the license file you are attempting to upload has
expired. Licenses generated on the NVIDIA licensing portal must be installed onto your
license server within 24 hours of generation.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 44
 Troubleshooting the NVIDIA vGPU Software License Server

Generate a new license file on the licensing portal and promptly upload the new file to
your license server.

4.4.3. Capability Response Rejected – Update Time

Invalid
The license server reports this error if the license server is already configured with a
license file that is newer than the license file you are attempting to upload.
You cannot roll back an active license to an older license file.

4.4.4. Capability Response Rejected - Response

Enterprise ID Does Not Match the Server
The license server reports this error if you are trying to download a license file to a
license server on which licenses from a different customer account are installed.
To resolve this issue:
1. Stop the license server.
2. Delete the license server's trusted storage database.
3. Restart the license server.
4. Download and install the new license.

4.5. Trusted Storage Database Errors

Errors in the trusted storage database, such as corruption of the database, can prevent
the license server from reading the database. If it cannot read the database, the license
server cannot start.
You can correct errors in the trusted storage database in one of the following ways:
‣ Since 2018.06: Restoring the database from a backup
‣ Deleting the database and then reinstalling licenses on the license server

4.5.1. Since 2018.06: Restoring the Trusted Storage

Database from a Backup
The license server automatically backs up the database after every 1,000 license
checkouts or after every five-minute interval in which a change has taken place,
whichever event occurs first. If no change to the database occurs during a five-minute
interval, the database is not backed up. Backups are triggered by changes such as the
checkout, renewal, or release of a license.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 45
 Troubleshooting the NVIDIA vGPU Software License Server

4.5.1.1. Since 2018.06: Restoring the Trusted Storage Database from

a Backup on Windows
Before restoring the trusted storage database from a backup, ensure that the following
prerequisites are met:

‣ The JAVA_HOME environment variable is set to the folder where the Java runtime
environment is installed on the license server host.
‣ The TRUSTED_STORAGE_DIR environment variable is set to %SystemDrive%:
\Windows\ServiceProfiles\NetworkService\flexnetls\nvidia, which
is the folder that contains the trusted storage database files.
1. Open a Command Prompt window and change to the license-server-
installation-folder\server folder.
license-server-installation-folder
The folder in which the license server software is installed. The default
license server installation folder is %SystemDrive%:\Program Files
(x86)\NVIDIA\License Server.
For example:
C:\>cd C:\Program Files (x86)\NVIDIA\License Server\server
C:\Program Files (x86)\NVIDIA\License Server\server>
2. In the Command Prompt window, run the command to restore the database.
C:\Program Files (x86)\NVIDIA\License Server\server>flexnetls.bat -restore-
database

The database is restored to the location defined in the TRUSTED_STORAGE_DIR

environment variable.

4.5.1.2. Since 2018.06: Restoring the Trusted Storage Database from

a Backup on Linux
Before restoring the trusted storage database from a backup, ensure that the following
prerequisites are met:

‣ The JAVA_HOME environment variable is set to the directory where the Java runtime
environment is installed on the license server host.
‣ The TRUSTED_STORAGE_DIR environment variable is set to /var/opt/
flexnetls/nvidia/, which is the directory that contains the trusted storage
database files.
1. Change to the license-server-installation-dir/server directory.
license-server-installation-dir
The directory in which the license server software is installed. The default license
server installation directory is /opt/flexnetls/nvidia.
For example:

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 46
 Troubleshooting the NVIDIA vGPU Software License Server

$ cd /opt/flexnetls/nvidia/server
2. Run the command to restore the database.
$ flexnetls --restore-database

The database is restored to the location defined in the TRUSTED_STORAGE_DIR

environment variable.

4.5.2. Deleting the Trusted Storage Database

Deleting the trusted storage database clears all information about license assignments
and allocations.
After deleting the trusted storage database, reinstall your licenses on the license server
as explained in Installing a License.

4.5.2.1. Deleting the Trusted Storage Database on Windows

1. Close any web browser windows that are accessing the license server.
2. Stop the FlexNet License Server - nvidia service.
a) Start Task Manager and in the Windows Task Manager window that opens, click
the Services button.
b) In the Services window that opens, context-click FlexNet License Server - nvidia
and from the menu that pops up, choose Stop.
3. Delete all files in the %SystemDrive%:\Windows\ServiceProfiles
\NetworkService\flexnetls\nvidia folder, which contains the trusted
storage database files.
4. Start the FlexNet License Server - nvidia service.
a) Start Task Manager and in the Windows Task Manager window that opens, click
the Services button.
b) In the Services window that opens, context-click FlexNet License Server - nvidia
and from the menu that pops up, choose Start.

4.5.2.2. Deleting the Trusted Storage Database on Linux

This task requires system administrator privileges.
1. Close any web browser windows that are accessing the license server.
2. Stop the flexnetls-nvidia service.
# sudo systemctl stop flexnetls-nvidia.service
3. Delete all files in the /var/opt/flexnetls/nvidia/ directory, which contains
the trusted storage database files.
# sudo \rm -rf /var/opt/flexnetls/nvidia/*
4. Start the flexnetls-nvidia service.
# sudo systemctl start flexnetls-nvidia.service

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 47
Chapter 5.
UNINSTALLING THE NVIDIA VGPU
SOFTWARE LICENSE SERVER

You can uninstall the NVIDIA vGPU software License Server when it is no longer
required.

5.1. Uninstalling the NVIDIA vGPU Software

License Server on Windows
1. Start the license server uninstaller.
You can start the license server uninstaller in Windows Control Panel or in
Windows Explorer from the license server installation directory.
‣ In Windows Control Panel, open the Programs and Features pane, select License
Server from the publisher NVIDIA, and click Uninstall/Change.

Figure 31 Starting the Uninstaller from Windows Control Panel

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 48
 Uninstalling the NVIDIA vGPU Software License Server

‣ In Windows Explorer, open the license server installation directory and double-
click the Change License Server Installation application.
The default license server installation directory is C:\Program Files
(x86)\NVIDIA\License Server.

Figure 32 Starting the Uninstaller in Windows Explorer from the

License Server Installation Directory
Since 2018.06: If the license server software was installed in console mode, the
uninstaller runs in console mode. Otherwise, the Configure License Server dialog
box opens.
2. If the Configure License Server dialog box opens, ensure that the Uninstall Product
option is selected and click Next.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 49
 Uninstalling the NVIDIA vGPU Software License Server

Figure 33 Running the License Server Uninstaller on Windows

3. When prompted, confirm that you want to uninstall the license server.

5.2. Uninstalling the NVIDIA vGPU Software

License Server on Linux
1. Start the license server uninstaller.
a) Change to the license server installation directory.
The default license server installation directory is /opt/flexnetls/nvidia.
[nvidia@localhost ~]$ cd /opt/flexnetls/nvidia
b) As root, run the Change License Server Installation command.
[nvidia@localhost ~]$ sudo ./Change\ License\ Server\ Installation
Since 2018.06: If the license server software was installed in console mode, the
uninstaller runs in console mode. Otherwise, the Configure License Server window
opens.
2. If the Configure License Server window opens, ensure that the Uninstall Product
option is selected and click Next.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 50
 Uninstalling the NVIDIA vGPU Software License Server

Figure 34 Running the License Server Uninstaller on Linux

3. When prompted, confirm that you want to uninstall the license server.

www.nvidia.com
Virtual GPU License Server Version 2018.06 and 5.1.0 DU-07754-001 _v6.0 through 6.3 | 51
Notice
ALL NVIDIA DESIGN SPECIFICATIONS, REFERENCE BOARDS, FILES, DRAWINGS, DIAGNOSTICS, LISTS, AND OTHER
DOCUMENTS (TOGETHER AND SEPARATELY, "MATERIALS") ARE BEING PROVIDED "AS IS." NVIDIA MAKES NO
WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE MATERIALS, AND
EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR
A PARTICULAR PURPOSE.

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

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

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

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

Third-Party Software
This NVIDIA product contains third party software that is made available under their respective software
licenses.

Apache Tomcat (https://tomcat.apache.org/download-80.cgi) is provided under the following terms:

Copyright 2015 NVIDIA Corporation
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in
compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is
distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied. See the License for the specific language governing permissions and limitations under the License.

Copyright
© 2013-2018 NVIDIA Corporation. All rights reserved.

www.nvidia.com