Troubleshooting the server

Checking the status of your server

Refer to Checking the status of your server.

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 systemServer versionFile path
WindowsVersion 2.0 or later%PROGRAMDATA%\Unity\logs\Unity.Licensing.Server.log
WindowsVersion 1.x%LOCALAPPDATA%\Unity\Unity.Licensing.Server.log
LinuxVersion 2.0 or later/usr/share/unity3d/logs/Unity.Licensing.Server.log
LinuxVersion 1.x~/.config/unity3d/Unity/Unity.Licensing.Server.log

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

After you generate the archive, you can send it to Unity support for investigation.

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

Additional resources