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 if your service is running.
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.

Check if your service is running

If you set up your licensing server to run as a service, make sure you check if the service is running before checking its status.

Check 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 on Linux, you must run the command with a user that belongs to the

unity-licensing-server

group, even if your account is an administrator or root user account.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, go to the Licensing Server program files directory and 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...DoneCollecting configuration files...DoneCollecting license files...DoneCollecting delegation files...DoneCollecting log files...DoneCreating summary file...DoneArchiving files...DoneArchive 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

Development

User Acquisition

Monetization

Industry

Documentation

Development

User Acquisition

Monetization

Industry

Unity License Server

Get Started

Quick start setup

Advanced setup

Administration