License Server User Guide :: NVIDIA Virtual GPU Software License Server Documentation

Virtual GPU Software License Server User Guide

Documentation for system administrators that explains how to install, configure, and manage the NVIDIA virtual GPU software license server.

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 at a location that is accessible from a customer’s network, and be configured with licenses obtained from the NVIDIA Licensing Portal.

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

Diagram showing how NVIDIA vGPU software license files are downloaded from the NVIDIA Licensing Portal to the license server and how licensed clients borrow licenses from the server.

Diagram showing how NVIDIA vGPU software license files are downloaded from the NVIDIA Licensing Portal to the license server and how licensed clients borrow licenses from the server.

The licenses served by the NVIDIA vGPU software license server are obtained from the NVIDIA Licensing Portal 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 seven days.

Note: To ensure that licenses in the enterprise remain continually available after failure of the primary license server, return the primary server to service within seven 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.

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.

Note: 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 software License Server software.	Virtual GPU Software Quick Start Guide
Install the NVIDIA vGPU software License Server software.	Installing and Configuring the NVIDIA vGPU Software License Server
Access the management interface of the license server.	Accessing the License Server Management 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 download license files.	Managing Entitlements, Licenses, and Contacts on the NVIDIA Licensing Portal
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.	Removing Licensed Products from a License Server Adding Licensed Products to a License Server
Convert a trial license server to a permanent license server.	Converting an Evaluation License Server to a Permanent License Server
Configure licensed NVIDIA vGPU software products for use with license server.	Virtual GPU Client Licensing User Guide
Troubleshoot the license server.	Troubleshooting the NVIDIA vGPU Software License Server
Uninstall the license server software.	Uninstalling the NVIDIA vGPU Software License Server

2. Installing and Configuring 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 machine, an on-premises virtual machine (VM), or a VM on a supported cloud service. 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.
At least 1 Gbyte of hard drive space is required.
The hosting platform must run a supported operating system.
On Window platforms, .NET Framework 4.5 or later is required.

Note: 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 Licensing Portal.
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.

Note: 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:

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.

Note: 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 Java runtime environment (JRE) version is not already installed on your system, install a supported JRE before running the NVIDIA license server installer.

If you are installing OpenJDK to migrate from Oracle Java SE JRE and upgrade your license server version, see Upgrading the NVIDIA vGPU Software License Server and Migrating to OpenJDK on Windows.

Download a supported Oracle Java SE JRE or OpenJDK JRE.
- Download Oracle Java SE JRE from the Java Downloads for All Operating Systems page.
- Download OpenJDK JRE from the Community builds using source code from OpenJDK project on GitHub.
Install the JRE that you downloaded.
- Oracle Java SE JRE installation:
- OpenJDK JRE installation:
Set the JAVA_HOME system variable to the full path to the jre folder of your JRE installation. For example:
- For Oracle Java SE JRE: C:\Program Files\Java\jre1.8.0_191
- For OpenJDK JRE: C:\Program Files\ojdkbuild\java-1.8.0-openjdk-1.8.0.201-1\jre
Ensure that the path does not include any trailing characters, such as a slash or a space.

If you are upgrading to a new version of the JRE, update the value of the JAVA_HOME system variable to the full path to the jre folder of your new JRE version.
Ensure that the Path system variable contains the path to the java.exe executable file. The installer may have already added this path for you. For example:
- For Oracle Java SE JRE: C:\Program Files\Java\jre1.8.0_191\bin
- For OpenJDK JRE: C:\Program Files\ojdkbuild\java-1.8.0-openjdk-1.8.0.201-1\bin

2.2.2. Installing the License Server Software on Windows in Graphical Mode

If you are replacing an existing version of the license server that was configured to use HTTPS, copy the files that are necessary to re-instate the configuration after you install the new version.

If you configured HTTPS for connections between the management interface and the license server, copy the SSL certificate that the license server was configured with. The installer deletes the entire contents of any existing license server installation folder, including files that were added after the license server software was installed, such as the SSL certificate.
Note:
Copying an SSL certificate might corrupt it. To determine if the certificate is corrupted, run this command:
```
$JAVA_HOME/bin/keytool -list -keystore certificate-file-name.jks -storepass certificate-password
```
If the certificate is corrupted, contact the CA that issued your certificate to obtain a new certificate.
If you specified HTTPS for connections from a web browser to the license server management interface, copy the Tomcat configuration file server.xml so that you can reinstate the necessary changes to the Tomcat configuration. The installer overwrites the existing server.xml file and any custom configuration specified in the file is lost.

Unzip the license server installer and run setup.exe.
Accept the EULA for the license server software and the Apache Tomcat software used to support the license server’s management interface.
Figure 2. License Agreements on Windows
Choose the destination folder where you want the license server software to be installed.
Figure 3. Destination Folder Selection on Windows
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.
Figure 4. Firewall Settings on Windows
After installation has completed successfully, click Done to exit the installer.
Figure 5. Completed License Server Installation on Windows

If you are replacing an existing version of the license server and it was configured to use HTTPS, re-instate the HTTPS configuration as explained in Configuring HTTPS for Connections Between the Management Interface and the License Server and Specifying HTTPS for Connections from a Web Browser to the License Server Management Interface.

Verify the installation by accessing the license server management interface as explained in Accessing the License Server Management Interface.

2.2.3. Installing the License Server Software on Windows in Console Mode

Note: Support for installation in Windows console mode was 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.

If you are replacing an existing version of the license server that was configured to use HTTPS, copy the files that are necessary to re-instate the configuration after you install the new version.

If you configured HTTPS for connections between the management interface and the license server, copy the SSL certificate that the license server was configured with. The installer deletes the entire contents of any existing license server installation folder, including files that were added after the license server software was installed, such as the SSL certificate.
Note:
Copying an SSL certificate might corrupt it. To determine if the certificate is corrupted, run this command:
```
$JAVA_HOME/bin/keytool -list -keystore certificate-file-name.jks -storepass certificate-password
```
If the certificate is corrupted, contact the CA that issued your certificate to obtain a new certificate.
If you specified HTTPS for connections from a web browser to the license server management interface, copy the Tomcat configuration file server.xml so that you can reinstate the necessary changes to the Tomcat configuration. The installer overwrites the existing server.xml file and any custom configuration specified in the file is lost.

Extract the contents of the license server zip archive.
Run the extracted setup binary.
```
C:\> setup.exe -i console
```
The Introduction screen of the InstallAnywhere installer is displayed.
In the Introduction screen, press Enter to continue.
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.
Type y to accept the terms of the license agreement and proceed with installation.
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.
Type y to accept the terms of the license agreement and proceed with installation.
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.
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.
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.
In the Install Complete screen, press Enter to exit the installer.

If you are replacing an existing version of the license server and it was configured to use HTTPS, re-instate the HTTPS configuration as explained in Configuring HTTPS for Connections Between the Management Interface and the License Server and Specifying HTTPS for Connections from a Web Browser to the License Server Management Interface.

Verify the installation by accessing the license server management interface as explained in Accessing the License Server Management Interface.

2.2.4. Upgrading the NVIDIA vGPU Software License Server and Migrating to OpenJDK on Windows

If you no longer want to use Oracle Java SE JRE and are upgrading your existing installation of NVIDIA vGPU software license server, you can replace the Oracle Java SE JRE with the OpenJDK JRE.

Note: Do not perform this task for upgrades from a 32-bit license server to a 64-bit license server. Instead, follow the instructions in Upgrading from a 32-Bit to a 64-Bit NVIDIA vGPU Software License Server on Windows.

Use the Services application to confirm that the Apache Tomcat 8.5 Tomcat8 service is running.
Use the Services application to confirm that the FlexNet License Server - nvidia service is running.
In the Services application, context-click the FlexNet License Server - nvidia service and choose Stop.
In the Services application, context-click the Apache Tomcat 8.5 Tomcat8 service and choose Stop.
Uninstall Oracle Java SE JRE.
1. Open Windows Control Panel and under Programs, follow the Uninstall a program link.
2. Context-click the installed Oracle Java SE JRE program, choose Uninstall, and if you are prompted to confirm that you want to uninstall the program, click Yes.
Install OpenJDK.
Set the JAVA_HOME system variable to the full path to the jre folder of your JRE installation. For example: C:\Program Files\ojdkbuild\java-1.8.0-openjdk-1.8.0.201-1\jre.
Ensure that the path does not include any trailing characters, such as a slash or a space.

If you are upgrading to a new version of the JRE, update the value of the JAVA_HOME system variable to the full path to the jre folder of your new JRE version.
Ensure that the Path system variable contains the path to the java.exe executable file. For example: C:\Program Files\ojdkbuild\java-1.8.0-openjdk-1.8.0.201-1\bin.
Ensure that Apache Tomcat can locate your OpenJDK JRE.
1. In Windows File Explorer, navigate to the bin folder of your Apache Tomcat installation. This default folder is %SystemDrive%:\NVIDIA\LicenseServer\Tomcat\bin.
2. Double-click the Tomcat8w application in this folder.
3. In the Apache Tomcat 8.5 Tomcat8 Properties window that opens, click the Java tab.
4. Deselect the Use default option, set Java Virtual Machine to the full path to the JVM DLL file jvm.dll of your OpenJDK installation and click OK. For example: C:\Program Files\ojdkbuild\java-1.8.0-openjdk-1.8.0.201-1\jre\bin\server\jvm.dll.
In the Services application, context-click the Apache Tomcat 8.5 Tomcat8 service and choose Start.
In the Services application, context-click the FlexNet License Server - nvidia service and choose Start.
Confirm that the license server is working by accessing the license server management interface as explained in Accessing the License Server Management Interface.

Upgrade to this release of the license server by installing the license server software as explained in the following topics:

2.2.5. Upgrading from a 32-Bit to a 64-Bit NVIDIA vGPU Software License Server on Windows

The 64-bit NVIDIA vGPU software license server requires a 64-bit JRE. If you want to upgrade from a 32-bit license server to a 64-bit license server, you must uninstall and reinstall the license server and associated software to meet this requirement.

If you are replacing an existing version of the license server that was configured to use HTTPS, copy the files that are necessary to re-instate the configuration after you install the new version.

If you configured HTTPS for connections between the management interface and the license server, copy the SSL certificate that the license server was configured with. The installer deletes the entire contents of any existing license server installation folder, including files that were added after the license server software was installed, such as the SSL certificate.
Note:
Copying an SSL certificate might corrupt it. To determine if the certificate is corrupted, run this command:
```
$JAVA_HOME/bin/keytool -list -keystore certificate-file-name.jks -storepass certificate-password
```
If the certificate is corrupted, contact the CA that issued your certificate to obtain a new certificate.
If you specified HTTPS for connections from a web browser to the license server management interface, copy the Tomcat configuration file server.xml so that you can reinstate the necessary changes to the Tomcat configuration. The installer overwrites the existing server.xml file and any custom configuration specified in the file is lost.

Uninstall the existing 32-bit license server. For instructions, see Uninstalling the NVIDIA vGPU Software License Server on Windows.
Uninstall the existing 32-bit Apache Tomcat software.
1. Open Windows Control Panel.
2. Select Programs and Features.
3. In the list of programs, select Apache Tomcat and click Uninstall/Change.
Remove the existing license server log files and trusted storage database by deleting all files in the folder %SystemDrive%:\Windows\ServiceProfiles\NetworkService\flexnetls\nvidia.
Uninstall the existing 32-bit JRE.
1. Open Windows Control Panel and under Programs, follow the Uninstall a program link.
2. Context-click the installed JRE program, choose Uninstall, and if you are prompted to confirm that you want to uninstall the program, click Yes.
Install a 64-bit JRE. For instructions, see Installing the Java Runtime Environment on Windows.
Install the 64-bit license server and Apache Tomcat software. For instructions, see the following topics:
- Installing the License Server Software on Windows in Graphical Mode
- Installing the License Server Software on Windows in Console Mode

If you are replacing an existing version of the license server and it was configured to use HTTPS, re-instate the HTTPS configuration as explained in Configuring HTTPS for Connections Between the Management Interface and the License Server and Specifying HTTPS for Connections from a Web Browser to the License Server Management Interface.

Verify the installation by accessing the license server management interface as explained in Accessing the License Server Management Interface.

After uninstalling and reinstalling the license server, you must reinstall each of your licenses as explained in Installing a License. Installed NVIDIA vGPU software licenses are not retained across an uninstallation followed by reinstallation.

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.

Note: 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

If a suitable Java runtime environment (JRE) version is not already installed on your system, you can install OpenJDK from your Linux distribution’s package repositories.

If you are installing OpenJDK to migrate from Oracle Java SE JRE and upgrade your license server version, see Upgrading the NVIDIA vGPU Software License Server and Migrating to OpenJDK on Linux.

Note: For information about installing Oracle Java SE JRE, see the Java Platform, Standard Edition Documentation in the Oracle Help Center. After installing Oracle Java SE JRE, set the JAVA_HOME environment variable to the jre folder of your Oracle Java SE JRE installation.

Determine whether a version of Java is installed on your system.

[nvidia@localhost ~]$ java -version

If a Java version is installed, the version is shown as follows and you do not need to install JRE.

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 ~]$

Use your Linux distribution’s package manager to install OpenJDK.
- 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
```
Set the JAVA_HOME environment variable to the jre folder of your OpenJDK JRE installation, for example, /usr/lib/jvm/java-8-openjdk-amd64/jre.

2.3.2. Installing and Running the Apache Tomcat Server on Linux

The license server’s management interface requires an Apache Tomcat server.

Use your Linux distribution’s package manager to install the required Apache Tomcat packages.
Note:
The version of Apache Tomcat that is installed by your Linux distribution’s package manager depends on the OS version that you are using. This version might not be supported with this release of the license server.

For example, installing tomcat8 on Ubuntu 16.04 installs tomcat 8.0.32, but on Ubuntu 18.04, Apache Tomcat 8.5.x is installed.

If your package manager installs an unsupported version, use another means to install a version that is supported with this release of the license server.
- 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
```
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
```
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
```
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 6.
Figure 6. Verifying the Apache Tomcat Installation

Note: 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

Extract the contents of the license server ZIP archive.

[nvidia@localhost ~]$ unzip NVIDIA-ls-linux-2019.11.0.26416627.zip

Add execute permission to the extracted setup binary file.
```
[nvidia@localhost ~]$ chmod +x setup.bin
```
As root, run the extracted setup binary.
```
[nvidia@localhost ~]$ sudo ./setup.bin
```
Accept the EULA to proceed with installation.
Figure 7. License Agreements on Linux
Choose the destination folder where you want the license server software to be installed.
Figure 8. Destination Folder Selection on Linux
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.
Figure 9. Apache Tomcat Server Path on Linux
In the Choose Firewall Options dialog box, shown in Figure 10, 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.
Figure 10. Firewall Settings on Linux
After installation has completed successfully, click Done to exit the installer.
Figure 11. Completed License Server Installation on Linux

Verify the installation by accessing the license server management interface as explained in Accessing the License Server Management Interface.

2.3.4. Installing the License Server Software on Linux in Console Mode

Note: Support for installation in Linux console mode was 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.

Extract the contents of the license server ZIP archive.

[nvidia@localhost ~]$ unzip NVIDIA-ls-linux-2019.11.0.26416627.zip

Add execute permission to the extracted setup binary file.
```
[nvidia@localhost ~]$ chmod +x setup.bin
```
As root, run the extracted setup binary.
```
[nvidia@localhost ~]$ sudo ./setup.bin -i console
```
The Introduction screen of the InstallAnywhere installer is displayed.
In the Introduction screen, press Enter to continue.
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.
Type y to accept the terms of the license agreement and proceed with installation.
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.
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.
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.
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.
In the Install Complete screen, press Enter to exit the installer.

Verify the installation by accessing the license server management interface as explained in Accessing the License Server Management Interface.

2.3.5. Upgrading the NVIDIA vGPU Software License Server and Migrating to OpenJDK on Linux

If you no longer want to use Oracle Java SE JRE and are upgrading your existing installation of NVIDIA vGPU software license server, you can replace the Oracle Java SE JRE with the OpenJDK JRE.

Check status of the Apache Tomcat service.
- For distributions based on Red Hat, check the status of the tomcat service.
```
[nvidia@localhost ~]$ systemctl status tomcat.service
```
- For distributions based on Debian, check the status of the tomcatrelease service. For example, for Apache Tomcat 8, run:
```
[nvidia@localhost ~]$ sudo systemctl status tomcat8.service
```
Check the status of the NVIDIA vGPU software license server flexnetls-nvidia service.
```
[nvidia@localhost ~]$ systemctl status flexnetls-nvidia.service
```
Stop the NVIDIA vGPU software license server flexnetls-nvidia service.
```
[nvidia@localhost ~]$ systemctl stop flexnetls-nvidia.service
```
Stop the Apache Tomcat service.
- For distributions based on Red Hat, stop the tomcat service.
```
[nvidia@localhost ~]$ sudo systemctl stop tomcat.service
```
- For distributions based on Debian, stop the tomcatrelease service. For example, for Apache Tomcat 8, run:
```
[nvidia@localhost ~]$ sudo systemctl stop tomcat8.service
```
Use your Linux distribution’s package manager to install OpenJDK.
- 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
```
Optional: Uninstall Oracle Java SE JRE. For information about uninstalling Oracle Java SE JRE, see How do I uninstall Java for Linux ? on the java.com: Java + You website.
Ensure that Apache Tomcat can locate your OpenJDK JRE.
1. Get the parent of the jre folder for your OpenJDK installation.
  The following example gets the parent of the jre folder for an installation of 64-bit OpenJDK 8.
```
[nvidia@localhost ~] update-java-alternatives -l
java-1.8.0-openjdk-amd64       1081       /usr/lib/jvm/java-1.8.0-openjdk-amd64
```
2. Open the file /etc/default/tomcat8 in a plain text editor and edit the value of the JAVA_HOME environment variable to specify the full path to the jre folder of your OpenJDK installation.
  The following example sets JAVA_HOME for an installation of 64-bit OpenJDK 8.
```
JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64/jre
```
Start the Apache 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
```
Start the NVIDIA vGPU software license server flexnetls-nvidia service.
```
[nvidia@localhost ~]$ systemctl start flexnetls-nvidia.service
```
Confirm that the license server is working by accessing the license server management interface as explained in Accessing the License Server Management Interface.

Upgrade to this release of the license server by installing the license server software as explained in the following topics:

2.4. Installing and Securing the License Server in the Cloud

To support bring your own license (BYOL) deployments of NVIDIA vGPU software on supported cloud services, you can host the license server on a VM on a supported cloud service.

Note: If you are using BYOL, you can host the license server on a physical machine or an on-premises VM if you prefer.

The following cloud services support NVIDIA vGPU software running in GPU pass-through mode:

Amazon EC2
Google Cloud Platform
Microsoft Azure

For more information, see NVIDIA Virtual GPU Software Supported Cloud Services.

A license server that is hosted in the cloud is accessed over the public Internet. For increased security, protect the license server and the licenses installed on it as follows:

Use the features of the license server to secure the license server as as explained in Securing the NVIDIA vGPU Software License Server.
Restrict access to the license server by client machines in one of the following ways:
- Use firewall settings on the license server host or elsewhere to limit the machines that can access the license server.
- Configure the license server host and the licensed client VMs to operate within a virtual private network.

2.5. 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.

In a web browser, visit the home page for the license server management interface.
- If the license server host does not permit remote access, open a web browser on the license server host and connect to one of the following URLs, depending on whether the connection protocol is HTTP or HTTPS:
  - HTTP: http://localhost:8080/licserver
  - HTTPS: https://localhost:https-port/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 one of the following URLs, depending on whether the connection protocol is HTTP or HTTPS:
  - HTTP: http://hostname:8080/licserver
  - HTTPS: https://hostname:https-port/licserver
https-port

The HTTPS port for users' connections from a web browser to the license server management interface, for example, 8443. This port is specified in the Apache Tomcat configuration as explained in Specifying HTTPS for Connections from a Web Browser to the License Server Management Interface.

hostname

The fully-qualified domain name or IP address of the license server host.

the Login page is displayed.
If administrative security is enabled for the license server, log in to the license server.
1. In the license server management interface, select Login.
2. In the Login page that is displayed, enter your user name and password for logging in to the license server and click Authorize.
  Figure 12. License Server Login Page
Note: If administrative security is not enabled for the license server and you try to log in, the license server reports that the login failed. However, you can ignore the login failure and continue to use the license server management interface.

The browser should display the home page for the license server management interface, as shown in Figure 13.

Figure 13. License Server Management Interface

Screen capture showing the home page for the license server management interface.

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

2.6. Obtaining the License Server’s MAC Address

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

Note: 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.

In the license server management interface, select Configuration.
On the License Server Configuration page that opens, in the Server host ID drop-down list, select the platform’s ETHERNET address.
Figure 14. Obtaining the License Server's MAC Address

Note: 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.

2.7. 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.

Note: The default log level of the license server is ERROR. If you enable failover support with the log level set to ERROR, INFO level messages are not recorded in the log files and you will not be able to verify the setup as explained in Verifying High Availability Setup of the License Server. To ensure that you can verify the setup, set the log level to INFO before enabling failover support. If necessary, revert the log level to ERROR after verifying the setup. For instructions, see Changing the License Server Log Level.

In the license server management interface, select Configuration. The License Server Configuration page opens.
Figure 15. License Server Settings for Enabling Failover Support
Under License Generation, use the Backup URI and Main URI fields to set the URI to each server in a failover configuration.
1. In the Backup URI field, enter http://secondary-server:7070/fne/bin/capability.
2. In the Main URI field, enter http://primary-server:7070/fne/bin/capability.
secondary-server

The fully-qualified domain name (for example, gridlicense2.example.com) or the IP address (for example, 10.31.20.46) of the secondary license server.

primary-server

The fully-qualified domain name (for example, gridlicense1.example.com) or the IP address (for example, 10.31.20.45) of the primary license server.
Set the options under Settings for server to sync between License servers as follows:
1. Set the Synchronization to fne enabled option to true.
2. In the Main FNE Server URI field, enter http://primary-server:7070/fne/bin/capability.
  
  primary-server
  
  The fully-qualified domain name (for example, gridlicense1.example.com) or the IP address (for example, 10.31.20.45) of the primary license server.
Click Save.

3. Securing the NVIDIA vGPU Software License Server

3.1. Controlling Access to the License Server Management Interface

For increased security, you can control access to the license server management interface by allowing access only to authorized users. When access to the license server management interface is controlled, authorized users must authenticate themselves to manage licenses on the license server.

You control access to the license server management interface by using the nvidialsadmin command. For general information about the nvidialsadmin command that you need to complete this task, see:

3.1.1. Enabling Administrative Security for the License Server

When administrative security is enabled for the license server, any user attempting to administer the license server through the command line tool or the license server management interface must provide a set of authorization credentials. By default, administrative security is not enabled on the license server.

CAUTION:

To protect sensitive data that is being transmitted during administrative operations, use the HTTPS protocol for communications between the license server and its management interface when administrative security is enabled for the license server. For more information, see Configuring HTTPS for Connections Between the Management Interface and the License Server.

Perform this task in a command shell on the license server host.

Set the property security.enabled to true.

nvidialsadmin -config -set security.enabled=true

Updated the property:security.enabled with value:true successfully

In any subsequent nvidialsadmin command, users must provide the required credentials for authenticating with the license server. For more information, see Authenticating with the License Server.

If you no longer require administrative security to be enabled on the license server, set the property security.enabled to false.

nvidialsadmin -authorize admin admin-password -config -set security.enabled=false
User authentication succeeded.

Updated the property:security.enabled with value:false successfully

After setting the property security.enabled to false, restart the Apache Tomcat server and the flexnetls-nvidia service.

3.1.2. Default License Server Administrative Credentials

When the license server is started, the default administrator account is created and assigned super user role. This account is inactive until administrative security is enabled for the license server. By default, administrative security is not enabled for the license server.

When administrative security is enabled for the license server, the default administrator account grants a full range of privileges to administer the license server, including authorization to create and manage other user accounts that have limited administrative privileges or other license server administrator accounts.

The default credentials for the license server administrator account are as follows:

User name: admin
Password: Admin@123

For increased security, reset the administrator password immediately after enabling administrative security for the license server. For instructions, see Resetting the Default Administrator Password for the License Server.

3.1.3. License Server Password Requirements

To help you set strong passwords, the license server enforces some requirements on the length and complexity of passwords.

A license server password must be 8-64 characters long, contain no white space, and contain all of the following:

At least one lowercase character
At least one uppercase character
At least one number
At least one special character (for example, ^, *, $, -, +, ?, _, &, =, !, %, {, }, /, and #)

The password is case sensitive.

3.1.4. Resetting the Default Administrator Password for the License Server

When the license server is started, the default administrator account is created and assigned super user role. For increased security, reset the administrator password immediately after enabling administrative security for the license server.

Perform this task in a command shell on the license server host.

Change the password of the admin user.

nvidialsadmin -authorize admin Admin@123 -users -edit admin new-password

new-password: Your choice of new password for the default administrator account. The password is case sensitive and must be a strong password that meets the requirements in License Server Password Requirements.

3.1.5. Listing All License Server User Accounts

Perform this task in a command shell on the license server host.

Note: For clarity, required options for authenticating the administrator user and specifying the license server URL are omitted from this example.

Run the nvidialsadmin utility with only the -users option and no other options.

nvidialsadmin -users

3.1.6. Creating a License Server User Account

Perform this task in a command shell on the license server host.

Note: For clarity, required options for authenticating the administrator user and specifying the license server URL are omitted from this example.

Run the nvidialsadmin utility with the -users and -create options.

nvidialsadmin -users -create new-username new-user-password[ roles]

new-username

Your choice of user name for the user that you are adding.

new-user-password

Your choice of password for authenticating the user that you are adding. The password is case sensitive and must be a strong password that meets the requirements in License Server Password Requirements.

roles

One or more roles that determine operations allowed by the user for managing licenses on the license server:

ROLE_READ grants the user privileges to perform read-only operations on the license server, for example, to query features, licenses, license reservations, or license server status. This role is assigned by default.
ROLE_RESERVATIONS grants the user privileges to create and manage license reservations.
ROLE_ADMIN grants the user administrator privileges to update license server policies (local license server only), create and manage other user accounts, and perform other administrative tasks.

You can assign multiple roles to a user by separating each role with the + sign, for example, ROLE_READ+ROLE_RESERVATIONS.

This example adds the user lsmgr with the password 3Nt3rl5vr and the ROLE_ADMIN role.

nvidialsadmin -users -create lsmgr 3Nt3rl5vr ROLE_ADMIN

3.1.7. Modifying a License Server User Account

You can modify the account of an existing license server user to change the password or the roles for the account.

Perform this task in a command shell on the license server host.

Note: For clarity, required options for authenticating the administrator user and specifying the license server URL are omitted from this example.

Run the nvidialsadmin utility with the -users and -edit options.

nvidialsadmin -users -edit username user-password[ new-roles]

username

The user name of the user whose account you are modifying.

user-password

The password for authenticating the user whose account you are modifying.

You must specify the password, even if you are not changing it.

To leave the password unchanged, specify the user's existing password.
To change the password, specify a new password. The password is case sensitive and must be a strong password that meets the requirements in License Server Password Requirements.

new-roles

The new roles that determine operations allowed by the user for managing licenses on the license server.

Specify new roles only if you want to change the roles for the account. To leave the user's existing roles unchanged, do not specify any roles in the command.

You can assign multiple roles to a user by separating each role with the + sign, for example, ROLE_READ+ROLE_RESERVATIONS.

This example changes role of the user lsmgr to the ROLE_RESERVATIONS role. Because the user's existing password 3Nt3rl5vr is specified, the password is not changed.

nvidialsadmin -users -edit lsmgr 3Nt3rl5vr ROLE_RESERVATIONS

3.1.8. Deleting a License Server User Account

Perform this task in a command shell on the license server host.

Note: For clarity, required options for authenticating the administrator user and specifying the license server URL are omitted from this example.

Run the nvidialsadmin utility with the -users and -delete options.

nvidialsadmin -users -delete username

username: The user name for the user whose account you are deleting.

This example deletes the user account lsmgr from the license server.

nvidialsadmin -users -delete lsmgr

3.2. Configuring HTTPS for Connections Between the Management Interface and the License Server

By default, the license server management interface connects to the license server over the HTTP protocol. This connection is for communications between two processes that are running on the same host machine. For increased security, you can specify that the license server management interface connects to the license server over HTTPS.

To configure HTTPS for connections between the management interface and the license server, follow this sequence of instructions:

You can also specify HTTPS for users' connections from a web browser to the license server management interface. See Specifying HTTPS for Connections from a Web Browser to the License Server Management Interface.

3.2.1. Obtaining an SSL Certificate for the License Server

Request an SSL certificate from a certificate authority (CA) in Java keystore format (not a PEM text file) and secured with a password.
In the certificate, you can choose to identify the license server host through either its host name or its fully qualified domain name. In your certificate signing request (CSR) to the CA, ensure that the Common Name (CN) attribute of the CSR matches how the license server is identified in the certificate. For example, if the license server is identified in the certificate through its fully qualified domain name, set the CN attribute to the fully qualified domain name of the license server.

If necessary, contact the CA that will provide your certificate for information about how to request a certificate in Java keystore format or convert an existing certificate to this format.
Store the SSL certificate in the appropriate directory on the license server host.
- On Linux, store the SSL certificate in the /opt/flexnetls/nvidia/ directory.
- On Windows, store the SSL certificate in the folder in which the license server is installed. The default license server installation folder is %SystemDrive%:\NVIDIA\LicenseServer.
Optional: To prevent the password from being stored in plain text in license server configuration files, obfuscate the password.
```
java -jar flexnetls.jar --password=password
```
password

The password with which the certificate is secured.

This example obfuscates the password abracadabra.
```
java -jar flexnetls.jar --password=abracadabra
abracadabra => OBF:1ri71v1r1v2n1ri71shq1ri71shs1ri71v1r1v2n1ri7
```

3.2.2. Configuring the License Server with an SSL Certificate

Before configuring the license server with an SSL certificate, ensure that the following prerequisites are met:

You have obtained the certificate from a trusted CA.
The license server is not blocked by a firewall.

How to configure the license server with an SSL certificate depends on whether the license server is running on a Windows or Linux platform.

3.2.2.1. Configuring the License Server with an SSL Certificate on Windows

In the license-server-installation-folder\server\local-configuration.yaml file, edit the https-in section to set attributes that provide access to the certificate.

license-server-installation-folder

The folder in which the license server software is installed. The default license server installation folder is %SystemDrive%:\NVIDIA\LicenseServer.

Specifically, set the following attributes:
- Enable HTTPS
- The port number for incoming HTTPS requests
- The full or relative path to the SSL certificate file for the license server on the license server host
- The password with which the certificate is secured
```
https-in:
# Set to true to enable HTTPS
enabled: true
# HTTPS listening port
port: https-port
# Path to keystore
keystore-path: server-certificate-file-path
# Keystore password. You can obfuscate this with java -jar flexnetls.jar -password your-password-here
keystore-password: password
```
https-port

The port number for incoming HTTPS requests, for example, 443.

server-certificate-file-path

The full or relative path to the SSL certificate file for the license server on the license server host.

password

The password with which the certificate is secured. If the password is obfuscated, specify the entire obfuscated string, including the OBF: prefix, for example, OBF:1ri71v1r1v2n1ri71shq1ri71shs1ri71v1r1v2n1ri7.
Note: To protect this password, ensure that the file that contains the password is appropriately secured. Specifically, limit access to the file that contains the password so that it can be read only by the user that the Tomcat process runs as and the administrator user on Windows or the root user on Linux.

This example provides access to the SSL certificate file keystore.jks, which is protected by an obfuscated password. The port number for incoming HTTPS requests is 443.
```
https-in:
# Set to true to enable HTTPS
enabled: true
# HTTPS listening port
port: 443
# Path to keystore
keystore-path: ..\keystore.jks
# Keystore password. You can obfuscate this with java -jar flexnetls.jar -password your-password-here
keystore-password: OBF:1ri71v1r1v2n1ri71shq1ri71shs1ri71v1r1v2n1ri7
```
Restart the license server.

3.2.2.2. Configuring the License Server with an SSL Certificate on Linux

In the /opt/flexnetls/nvidia/local-configuration.yaml file, edit the https-in section to set attributes that provide access to the certificate.
Specifically, set the following attributes:
- Enable HTTPS
- The port number for incoming HTTPS requests
- The name of the SSL certificate file for the license server on the license server host
- The password with which the certificate is secured
```
https-in:
# Set to true to enable HTTPS
enabled: true
# HTTPS listening port
port: https-port
# Path to keystore
keystore-path: server-certificate-file-name
# Keystore password. You can obfuscate this with java -jar flexnetls.jar -password your-password-here
keystore-password: password
```
https-port

The port number for incoming HTTPS requests, for example, 1443. To avoid the need to run the license server from a privileged account, use a port number greater than or equal to 1024. On Linux systems, access to ports below 1024 is restricted to processes that run with root user privileges.
The default port for HTTPS requests is 443. If you use a different port, you can re-direct incoming HTTPS requests for the default port to the port that you are using.

server-certificate-file-name

The name of the SSL certificate file for the license server on the license server host. Do not include the path to this file.

password

The password with which the certificate is secured. If the password is obfuscated, specify the entire obfuscated string, including the OBF: prefix, for example, OBF:1ri71v1r1v2n1ri71shq1ri71shs1ri71v1r1v2n1ri7.
Note: To protect this password, ensure that the file that contains the password is appropriately secured. Specifically, limit access to the file that contains the password so that it can be read only by the user that the Tomcat process runs as and the administrator user on Windows or the root user on Linux.

This example provides access to the SSL certificate file keystore.jks, which is protected by an obfuscated password. The port number for incoming HTTPS requests is 1443.
```
https-in:
# Set to true to enable HTTPS
enabled: true
# HTTPS listening port
port: 1443
# Path to keystore
keystore-path: keystore.jks
# Keystore password. You can obfuscate this with java -jar flexnetls.jar -password your-password-here
keystore-password: OBF:1ri71v1r1v2n1ri71shq1ri71shs1ri71v1r1v2n1ri7
```

Restart the license server.

[nvidia@localhost ~]$ systemctl restart flexnetls-nvidia

Optional: If necessary, use the iptables command to re-direct incoming HTTPS requests from the local host for the default port to the port that you specified earlier.
Perform this step if you are not using the default port for incoming HTTPS requests (443) and cannot guarantee that all incoming HTTPS requests will specify the port number.

To re-direct incoming HTTPS requests from the local host, use the OUTPUT chain.

For example, to re-direct incoming HTTPS requests from the local host for port 443 to 1443, type this command:
```
[nvidia@localhost ~]$ sudo iptables -t nat -A OUTPUT -o lo -p tcp \
--dport 443 -j REDIRECT --to-port 1443
```

3.2.3. Setting the License Server Connection Protocol to HTTPS

In the license server management interface, select Settings. The Settings page opens.
Figure 16. License Server Settings for Setting the Connection Protocol
In the Settings page, set the properties for connecting to the license server over HTTPS and click Save.
1. Set the License server host name property to the value of the CN attribute in the certificate signing request for your license server certificate. For example, if the CN attribute was set to the fully qualified domain name, set License server host name to the fully qualified domain name of the license server.
2. Set the License server listen port property to the port number for incoming HTTPS requests, for example, 443 or 1443. The port number is set in the license server configuration files. If necessary, ask the system administrator who configured the license server for the port number.
3. Set the Connect using HTTPS property to Yes.
The license server management interface will now connect to the license server over HTTPS.

To specify that the license server management interface connects to the license server over HTTP, set the License server listen port to the port number for incoming HTTP requests, for example, 7070, set. the Connect using HTTPS property to No, and click Save.

3.3. Specifying HTTPS for Connections from a Web Browser to the License Server Management Interface

By default, users connect from a web browser to the license server management interface over the HTTP protocol. For increased security, particularly if the license server is accessed over the public Internet, you can specify HTTPS for users' connections from a web browser to the license server management interface. Specifying HTTPS for these connections involves configuring an HTTPS connector for the Apache Tomcat server that the license server management interface uses.

In the Tomcat configuration file catalina-base/conf/server.xml, add a Connector element to define an SSL Coyote HTTP/1.1 connector on a specific port, for, example, 8443.

catalina-base

The base directory of the Apache Tomcat instance.
```

<Connector
    protocol="org.apache.coyote.http11.Http11NioProtocol"
    port="port" 
    maxThreads="200" 
    scheme="https" 
    secure="true" 
    SSLEnabled="true"
    keystoreFile="path-to-server-certificate" 
    keystorePass="password"
    clientAuth="false"
    sslProtocol="TLS"
/>
```
port

The HTTPS port for users' connections from a web browser to the license server management interface, for example, 8443.
Ensure that the port is not already in use by another service. For example, do not use the port for accessing the license server SSL certificate as described in Configuring the License Server with an SSL Certificate on Windows and Configuring the License Server with an SSL Certificate on Linux.

path-to-server-certificate

The full path to the certificate file on the license server host.

password

The password with which the certificate is secured. The password must be specified in plain text. You cannot use an obfuscated password.
Note: To protect this password, ensure that the file that contains the password is appropriately secured. Specifically, limit access to the file that contains the password so that it can be read only by the user that the Tomcat process runs as and the administrator user on Windows or the root user on Linux.

For additional information about how to obscure the password, see Apache Tomcat Passwords FAQ.

For more information, see Edit the Tomcat Configuration File in the Apache Tomcat SSL/TLS Configuration HOW-TO.
Restart the Apache Tomcat service.

Users now must access the license server management interface from a web browser through HTTPS on the specified port, for example, port 8443.

4. Managing Entitlements, Licenses, and Contacts on the NVIDIA Licensing Portal

The NVIDIA Licensing Portal provides access to the entitlements that you purchased and the licenses that they contain. To help you manage your entitlements and licenses on the NVIDIA Licensing Portal, you can add other users as registered contacts in the organization associated with your NVIDIA Enterprise Account. To secure your entitlements and licenses, NVIDIA Licensing Portal provides role-based access for all registered contacts.

To be able to download NVIDIA vGPU software licenses, you must create at least one license server on the NVIDIA Licensing Portal and allocate licenses in your entitlements to the server. You can also distribute your licenses across multiple license servers as necessary, add new licensed products to an existing server, and delete license servers that you no longer require.

By default, all entitlements are associated with a top-level organization and are accessible to all contacts in the organization. If you need to allow only specific groups of contacts within your organization to access specific entitlements, you can partition your entitlements into isolated segments. However, if a single collection of entitlements that spans your entire organization meets your business needs, you can leave all your entitlements in the top-level organization.

To partition your entitlements into isolated segments, NVIDIA Licensing Portal provides the ability to create virtual groups and assign entitlements and contacts to them. For more information, see Managing Virtual Groups.

4.1. Role-Based Access to an Organization and Virtual Groups

Role-based access helps secure the entitlements and licenses in your organization on the NVIDIA Licensing Portal. If you partition your entitlements into isolated segments, role-based access also provides isolation between the segments into which your entitlements are partitioned. It does so by ensuring that only specific contacts in your organization are allowed to view or perform actions on the entitlements and contacts that are allocated to a virtual group.

A role is a collection of actions or capabilities within the NVIDIA Licensing Portal. Each role has a scope that determines the context to which the actions and capabilities of the role apply, specifically, a virtual group within an organization or the organization itself.

Every registered contact has at least one role, but can have multiple roles if the scope of each role is a virtual group. As a result, a contact can be a member of multiple virtual groups. However, roles with a virtual group scope and roles with an organization scope are mutually exclusive. A contact that has a virtual group role cannot also have an organization role.

To enable role-based access to an organization and virtual groups, the NVIDIA Licensing Portal provides pre-defined roles.

4.1.1. Organization Administrator

An organization administrator has the highest level of visibility and access within an organization. The person that created the organization's NVIDIA Enterprise Account is initially assigned the organization administrator role.

Each organization must have at least one organization administrator. Multiple organization administrators in an organization are allowed. To prevent the absence of a single user from denying you access to your organization's entitlements, consider adding at least two organization administrators to your organization.

An organization administrator can see all of the following items for the organization on the NVIDIA Licensing Portal:

Entitlements
Users
Virtual groups
License servers provisioned from the entitlements that have not been assigned to a virtual group

An organization administrator can mange virtual groups as follows:

Create a virtual group.
Delete a virtual group.
Assign an entitlement at the organization level to a virtual group.
Remove an entitlement from a virtual group and return it to the organization.

An organization administrator can manage other contacts in the organization as follows:

Invite a contact currently not within the organization to register at the organization level.
Add users and administrators to a virtual group when creating the virtual group.
Delete any administrator or user at either the organization level or the virtual group level except the last virtual group administrator in a virtual group.
Manage the role of any organization-level contact.

An organization administrator also has all the capabilities of an organization user.

4.1.2. Organization User

An organization user has restricted visibility within an organization and can access only items that are at the organization level and that have not been assigned to a virtual group. An organization user is a contact that has been added to the organization as a base user.

An organization can have no organization users, only one organization user, or multiple organization users.

An organization user can see the following items for the organization on the NVIDIA Licensing Portal:

All organization administrators
All other organization users
All organization-level entitlements
All license servers provisioned from organization-level entitlements

An organization user can mange entitlements that have not been assigned to a virtual group as follows:

Create a license server.
Delete a license server.
Add licensed products to a license server.
Remove licensed products from a license server.
Download a license file.
Download software.

An organization user cannot manage other contacts.

4.1.3. Virtual Group Administrator

A virtual group administrator has restricted visibility within an organization and can access items and manage contacts only in the virtual group to which the virtual group administrator is assigned. A virtual group administrator is a contact that has been added to the virtual group as an admin user.

Each virtual group must have at least one virtual group administrator. Multiple virtual group administrators in a virtual group are allowed. To prevent the absence of a single user from denying you access to a virtual group, consider adding at least two virtual group administrators to each virtual group in your organization.

A virtual group administrator can see the following items on the NVIDIA Licensing Portal:

All organization administrators
All other contacts in the virtual group
All entitlements assigned to the virtual group
All license servers provisioned from entitlements assigned to the virtual group

A virtual group administrator can manage other contacts in the virtual group as follows:

Add an exiting contact within the organization who is not an organization administrator to the virtual group.
Invite a contact currently not within the organization to register and join the virtual group.
Remove any other contact in the virtual group, regardless of the contact's role.
Virtual group administrators cannot remove themselves from a virtual group.
Manage the role of any other contact in the virtual group.
Virtual group administrators cannot manage their own roles.

A virtual group administrator also has all the capabilities of a virtual group user.

4.1.4. Virtual Group User

A virtual group user has no visibility within an organization and can view and access items only in a virtual group. A virtual group user is a contact that has been added to the virtual group as a base user.

A virtual group can have no virtual group users, only one virtual group user, or multiple virtual group users.

A virtual group user can see the following items for the virtual group on the NVIDIA Licensing Portal:

All other contacts in the virtual group
All entitlements assigned to the virtual group
All license servers provisioned from entitlements assigned to the virtual group

A virtual group user can mange entitlements within a virtual group as follows:

Create a license server.
Delete a license server.
Add licensed products to a license server.
Remove licensed products from a license server.
Download a license file.
Download software.

A virtual group user cannot manage other contacts.

4.2. Creating a License Server on the NVIDIA Licensing Portal

To be able to download NVIDIA vGPU software licenses, you must create at least one license server on the NVIDIA Licensing Portal. Creating a license server on the NVIDIA Licensing Portal registers your license server host with the NVIDIA Licensing Portal through the MAC address of the host.

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.

The role that this task requires depends on whether the license server is being created for an organization or a virtual group:

For an organization, this task requires the Organization Administrator or the Organization User role.
For a virtual group, this task requires the Virtual Group Administrator or the Virtual Group User role.

In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you want to create the license server.
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 Licensing Portal.
2. 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 primary license server.
1. In the Server Name field, enter the host name of the primary license server.
2. 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.
3. In the MAC Address field, enter the MAC address of your primary license server.
Add the licenses for the products that you want to allocate to this license server. For each product, add the licenses as follows:
1. From the Product drop-down list, select the product for which you want to add licenses.
2. In the Licenses field, enter the number of licenses for the product that you want to add.
3. Click ADD.
Optional: Provide the details of your secondary license server.
1. In the Failover License Server field, enter the host name of the secondary license server. If you have only one license server configured, leave this field unset.
2. In the Failover MAC Address field, enter the MAC address of your secondary license server. If you have only one license server configured, leave this field unset.
Click CREATE LICENSE SERVER.

4.3. Downloading a License File

Each license server that you create has license file associated with it. The license file contains all the licenses that you allocated to the license server. After downloading the license file, you can install it on the license server host associated with the license server on the NVIDIA Licensing Portal.

The role that this task requires depends on whether the license file is being downloaded for an organization or a virtual group:

For an organization, this task requires the Organization Administrator or the Organization User role.
For a virtual group, this task requires the Virtual Group Administrator or the Virtual Group User role.

In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you want to download the license file.
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 Licensing Portal.
2. Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group for which you are downloading the license file 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 whose associated license file you want to download.
In the License Server Details page that opens, review the licenses allocated to the license server.

If necessary, add or remove licenses on the server as explained in Managing Licenses on a License Server.
Click DOWNLOAD LICENSE FILE and save the .bin license file to your license server for installation.

4.4. Managing Licenses on a License Server

Manage licenses on a license server if you need to add or remove licenses for a specific product on the 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.

The role that this task requires depends on whether the licenses are being managed for an organization or a virtual group:

For an organization, this task requires the Organization Administrator or the Organization User role.
For a virtual group, this task requires the Virtual Group Administrator or the Virtual Group User role.

In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you want to manage licenses.
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 Licensing Portal.
2. Optional: 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 page.
In the list of license servers on the NVIDIA Licensing Portal dashboard, select the license server to which you want to add or from which you want to remove licenses.
In the License Server Details page that opens, 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:
1. From the Feature drop-down list, select the product for which you want to add or remove licenses.
2. 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.
3. 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.

To ensure that the correct licenses are available on your license server host, download and install the license file after you add or remove licenses.

4.5. 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.

The role that this task requires depends on whether the licensed products are being added for an organization or a virtual group:

For an organization, this task requires the Organization Administrator or the Organization User role.
For a virtual group, this task requires the Virtual Group Administrator or the Virtual Group User role.

In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you want to add licensed products.
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 Licensing Portal.
2. 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, 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:
1. From the Product drop-down list, select the licensed product that you want to add to the license server.
2. In the Licenses field, enter the number of licenses for the product that you want to allocate to the server.
3. 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.

4.6. 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.

The role that this task requires depends on whether the licensed products are being removed for an organization or a virtual group:

For an organization, this task requires the Organization Administrator or the Organization User role.
For a virtual group, this task requires the Virtual Group Administrator or the Virtual Group User role.

In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you want to remove licensed products.
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 Licensing Portal.
2. Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group for which you are removing 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 from which you want to remove licensed products.
In the License Server Details page that opens, 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 Product drop-down list and click REMOVE.
After removing all the licensed products that you are interested in, click REMOVE FEATURES.

If you removed licenses in preparation for migrating them to a new server, add them to the new server as explained in Adding Licensed Products to a License Server.

4.7. Deleting a License Server

The role that this task requires depends on whether the license server is being deleted for an organization or a virtual group:

For an organization, this task requires the Organization Administrator or the Organization User role.
For a virtual group, this task requires the Virtual Group Administrator or the Virtual Group User role.

In the NVIDIA Licensing Portal, navigate to the organization or virtual group for which you want to delete the license server..
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 Licensing Portal.
2. 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.

4.8. Managing Contacts on the NVIDIA Licensing Portal

To help you manage your entitlements and licenses on the NVIDIA Licensing Portal, you can add other users as registered contacts in the organization associated with your NVIDIA Enterprise Account. You can also remove users who no longer require access from your account on the NVIDIA Licensing Portal.

To secure your entitlements and licenses, NVIDIA Licensing Portal provides role-based access for all registered contacts. Each role has a scope that determines whether the role applies to a virtual group within an organization or the organization itself. For more information, see Role-Based Access to an Organization and Virtual Groups.

4.8.1. Adding a Contact on the NVIDIA Licensing Portal

The role that this task requires depends on whether the contact is being added to an organization or a virtual group:

For an organization, this task requires the Organization Administrator role.
For a virtual group, this task requires the Virtual Group Administrator role.

In the NVIDIA Licensing Portal, navigate to the organization or virtual group to which you want to add a contact.
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 Licensing Portal.
2. Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group to which you are adding a contact 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 USER MANAGEMENT.
In the USER MANAGEMENT page that opens, click INVITE USER.
In the Invite User pop-up window that opens, provide the e-mail address and the name of the contact, select the contact's role, and click SEND INVITATION.

The role to select depends on whether you are adding the contact to an organization or a virtual group.
- For an organization, select one of the following roles:
  
  ORG ADMIN
  
  Assigns the contact the Organization Administrator role.
  
  ORG USER
  
  Assigns the contact the Organization User role.
- For a virtual group, select one of the following roles:
  
  VIRTUAL GROUP ADMIN
  
  Assigns the contact the Virtual Group Administrator role.
  
  VIRTUAL GROUP USER
  
  Assigns the contact the Virtual Group User role.

If you added a contact who is already registered to a virtual group, the contact will be able the select the virtual group after next logging in.
If the contact is a new contact, an e-mail is sent to the contact at the e-mail address that you provided.

Note:
The link to the NVIDIA Enterprise Support Portal in this e-mail provides information about how to contact NVIDIA Enterprise Support.

If the contact that you added is a new contact, tell the contact to follow the directions in the e-mail to create an NVIDIA Enterprise Account as explained in Virtual GPU Software Quick Start Guide.

4.8.2. Removing a Contact on the NVIDIA Licensing Portal

The role that this task requires depends on whether the contact is being removed from an organization or a virtual group:

For an organization, this task requires the Organization Administrator role.
For a virtual group, this task requires the Virtual Group Administrator role.

In the NVIDIA Licensing Portal, navigate to the organization or virtual group from which you want to remove a contact.
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 Licensing Portal.
2. Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group from which you are removing a contact 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 USER MANAGEMENT.
In the list of contacts in the User Management page that opens, follow the link to remove the contact.
- If you are removing the contact from an organization, follow the Delete link.
- If you are removing the contact from a virtual group, follow the Remove link.
  Note: You cannot remove the only virtual group administrator from a virtual group. The Remove link for that contact is inactive and dimmed.
When prompted, confirm that you want to remove the contact.

The contact is removed from the list of contacts on the USER MANAGEMENT page.

A contact that is removed from an organization is removed from the list of registered contacts for the organization.
A contact that was a member of multiple virtual groups when removed from a virtual group remains a member of the other virtual groups.
A contact that was a member of only the virtual group from which you removed the contact is returned to the organization with the organization user role.

4.8.3. Changing the Role of a Contact on the NVIDIA Licensing Portal

You can change the role of a contact on the NVIDIA Licensing Portal within the scope of the contact's current role. For example, you can change the role from organization user to organization administrator or from virtual group administrator to virtual group user. However, you cannot change the scope of the contact's current role, for example, from organization administrator to virtual group user.

The role that this task requires depends on whether the contact whose role is being changed belongs to the organization or a virtual group:

For the organization, this task requires the Organization Administrator role.
For a virtual group, this task requires the Virtual Group Administrator role.

Note: You cannot change your own role.

In the NVIDIA Licensing Portal, navigate to the organization or virtual group to which the contact belongs.
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 Licensing Portal.
2. Optional: If your assigned roles give you access to multiple virtual groups, select the virtual group to which the contact 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 USER MANAGEMENT.
In the list of contacts in the User Management page that opens, follow the View role link for the contact. You are shown the contact's current role and the role to which you can change it.
In the User Role window, click the button to change the contact's role.

4.9. Managing Virtual Groups

Virtual groups provide the means for segmenting your organization's entitlements into partitions. The virtual groups in an organization are isolated from each other and from the organization. An entitlement cannot be partitioned and cannot be shared between partitions. All licensed products in an entitlement are moved with the entitlement when the entitlement is added to a virtual group or returned to the organization.

You are free to determine how many virtual groups among which to partition your entitlements and what those virtual groups represent. For example, you might create virtual groups to partition your entitlements by location, division, product, or some combination of factors. Irrespective of how you choose to partition your entitlements among virtual groups, every virtual group isolates the entitlements assigned to it from other virtual groups.

The following diagram shows the relationship between an organization, the virtual groups in an organization, and the components of a virtual group.

Diagram showing the relationship between an organization, the virtual groups in an organization, and the components of a virtual group: virtual group entitlements, virtual group contacts, and license files.

4.9.1. Creating a Virtual Group

Ensure that the following prerequisites are met:

Your organization contains at least one registered contact to whom you can assign the virtual group administrator role.
No licensed products in any of the entitlements that you want to add to the group have been added to a license server.

This task requires the Organization Administrator role.

If you are not already logged in, log in to the NVIDIA Licensing Portal.
In the left navigation pane of the NVIDIA Licensing Portal dashboard, click VIRTUAL GROUPS.
In the Virtual Groups page that opens, click CREATE VIRTUAL GROUP.
The Create Virtual Group pop-up window opens.
In the Virtual Group Name field, enter your choice of name for the group.
In the Description field, enter a short text description of the group. This description will be displayed for the group in the list of virtual groups on the Virtual Groups page.
Add the entitlements that you want to assign to the virtual group. For each entitlement that you want to add, select the entitlement from the Entitlements drop-down list and click ADD. You must add at least one entitlement. You cannot create a virtual group with no entitlements. Each entitlement that you select is added to the Added Entitlements list.
Add the users that you want to be members of the virtual group. Add each user as follows:
1. From the drop-down list of users, select the user.
2. Follow the link to add the user with the role that you want for the user.
  - To add the user with the Virtual Group Administrator role, follow the Add as Admin link.
  - To add the user with the Virtual Group User role, follow the Add as User link.
  The user is added to the box under the drop-down list of users.
  Note: Any user with the Organization Administrator role loses that role and gains the role that you assign when added to the virtual group.
You must add at least one virtual group administrator to the group. You cannot create a virtual group with no administrators.

Tip: To prevent the absence of a single user from denying you access to the virtual group, consider adding at least two virtual group administrators to the virtual group.
Click CREATE VIRTUAL GROUP in the Create Virtual Group pop-up window.

After you create a virtual group, you can perform only the following operations on the virtual group:

Deleting the virtual group
Assigning an entitlement at the organization level to the virtual group
Removing an entitlement from the virtual group and returning it to the organization

Other operations on the virtual group require the virtual group administrator or virtual group user role.

4.9.2. Deleting a Virtual Group

Delete a virtual group if it is no longer needed. When the group is deleted, all entitlements assigned to the group and any contacts who are members only of this group are returned to the organization. Contacts who are returned to the organization are assigned the organization user role.

This task requires the Organization Administrator role.

If you are not already logged in, log in to the NVIDIA Licensing Portal.
In the left navigation pane of the NVIDIA Licensing Portal dashboard, click VIRTUAL GROUPS.
In the list of virtual groups on the Virtual Groups page, follow the Delete link for the virtual group that you want to delete.
When asked to confirm that you want to delete the virtual group, click DELETE VIRTUAL GROUP.

4.9.3. Moving an Entitlement from your Organization to a Virtual Group

Ensure that the following prerequisites are met:

The entitlements that you want to add belong to the organization and not to a virtual group.
No licensed products in any of the entitlements that you want to add to the group have been added to a license server.

This task requires the Organization Administrator role.

If you are not already logged in, log in to the NVIDIA Licensing Portal.
In the left navigation pane of the NVIDIA Licensing Portal dashboard, click VIRTUAL GROUPS.
Expand the list of entitlements in the organization by clicking the up arrow head adjacent to the organization in the list of virtual groups.
In the list of entitlements, follow the Move link for the entitlement.
Note: You cannot move an entitlement if any of its licensed products has been added to a license server. The Move link for the entitlement is inactive and dimmed.
In the Move Entitlement window that opens, select the virtual group where you want to move the entitlement and click MOVE ENTITLEMENT. The entitlement is removed from the list of entitlements in the organization and added to the list of entitlements in the virtual group.

4.9.4. Removing an Entitlement from a Virtual Group

Remove an entitlement from a virtual group to return it to the organization either to make it available to users at the organization level or to transfer it to a different virtual group.

Ensure that no licensed products in the entitlement that you want to remove have been added to a license server.

This task requires the Organization Administrator role.

If you are not already logged in, log in to the NVIDIA Licensing Portal.
In the left navigation pane of the NVIDIA Licensing Portal dashboard, click VIRTUAL GROUPS.
Expand the list of entitlements in the virtual group that contains the entitlement that you want to remove by clicking the up arrow head adjacent to the group.
In the list of entitlements, follow the Remove link for the entitlement.
Note: You cannot remove an entitlement if any of its licensed products has been added to a license server or if it is the only entitlement in a group. The Remove link for the entitlement is inactive and dimmed.
When asked to confirm that you want to remove the entitlement, click REMOVE ENTITLEMENT. The entitlement is removed from the list of entitlements in the virtual group and added to the list of entitlements in the organization.

You can now move the entitlement that you removed to transfer it to a different virtual group as explained in Moving an Entitlement from your Organization to a Virtual Group.

4.9.5. Common Business Scenarios for Virtual Groups

4.9.5.1. Multinational Corporation and Subsidiaries with Central Licensing Management

Organization Administrators

The organization administrators are responsible for setting up virtual groups and managing entitlements for the entire organization. The individuals chosen to be organization administrators must understand the organization structure and purchasing process, so that they are capable of routing newly purchased entitlements appropriately.

To ensure that someone is always available to move newly purchased entitlements into the correct virtual group, consider designating at least three organization administrators.

Virtual Groups

To simplify the allocation entitlements to the entity for which they were purchased, consider creating a virtual group for every subsidiary or geographic region, as appropriate.