Troubleshooting the server

Learn how to troubleshoot the Unity Licensing Server.

Read time 2 minutes

Last updated a day ago

This section outlines steps you can take to investigate issues with your licensing server. Start with the basics and work through each step to identify the problem or gather the information needed before contacting Support:

Check the status of your server.
View the Support articles.
Check log files to diagnose problems.
If you're unable to resolve your issue, generate a licensing server report to send to Unity Support.

Checking the status of your server

Refer to Checking the status of your server.

View the Support articles

View the Floating Licenses and Build Servers category in Unity Support, to check if the issue you're experiencing is covered in an existing article.

Logs

The Unity Floating Licensing server generates a log file that you can use to diagnose problems. Use the following table to determine the location of the log.

Operating system	Server version	File path
Windows	Version 2.0 or later	`%PROGRAMDATA%\Unity\logs\Unity.Licensing.Server.log`
Windows	Version 1.x	`%LOCALAPPDATA%\Unity\Unity.Licensing.Server.log`
Linux	Version 2.0 or later	`/usr/share/unity3d/logs/Unity.Licensing.Server.log`
Linux	Version 1.x	`~/.config/unity3d/Unity/Unity.Licensing.Server.log`

Generate a licensing server report

You can run a CLI command on the licensing server to collect and archive licensing related data required for troubleshooting the licensing server.

Important

For the CLI command to run successfully and find the server data, you must run the command with the proper user account:For server version 2.x, you must run the command with a user that belongs to the

unity-licensing-server

group.For server version 1.x, you must run the command with the same service account that you used to set up the server and import the license archive file.

From the Linux Terminal or the Windows PowerShell, run the command that matches your operating system:

Linux:

./Unity.Licensing.Server generate-report --output-directory [directory path]

Windows:

.\Unity.Licensing.Server.exe generate-report --output-directory [directory path]

The

--output-directory

argument is optional. If you omit it, the CLI command creates the archive in your current directory. To generate the archive in a specific directory, replace

[directory path]

with the destination path. If the command runs successfully, the output displays the path of the generated archive. For example, running the command in the PowerShell window returns outputs similar to the following:


Creating temporary folder...Done
Collecting configuration files...Done
Collecting license files...Done
Collecting delegation files...Done
Collecting log files...Done
Creating summary file...Done
Archiving files...Done

Archive successfully created: D:\Licensing.Server.Support.2020-06-12-025617.zip

After the command completes successfully, submit a support request at the Unity Support portal and include your

zip

file.

Documentation

Engine

Services

Grow

Industry

Support

Unity License Server

Get Started

Quick start setup

Advanced setup

Administration