Troubleshooting the server
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.
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.