Documentation

Support

Troubleshooting the client

Learn how to troubleshoot the client computers that connect to your Unity Licensing Server.
Read time 2 minutesLast updated a day ago

This section outlines steps you can take to investigate issues with your licensing client. Scan your log files and exit codes for information. You can also 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. If you can't resolve the issue on your own, submit a support request by using the Unity Support portal.

Logs

A client computer generates several log files that you can use to diagnose floating licensing problems. The following tables list the locations of different types of logs.

Log paths on Windows

Log type

File path

Unity Editor
%LOCALAPPDATA%\Unity\Editor\Editor.log
Licensing Client
%LOCALAPPDATA%\Unity\Unity.Licensing.Client.log
Licensing Audits
%LOCALAPPDATA%\Unity\Unity.Entitlements.Audit.log
Unity Hub
%APPDATA%\UnityHub\logs\info-log.json

Log paths on macOS

Log type

File path

Unity Editor
~/Library/Logs/Unity/Editor.log
Licensing Client
~/Library/Logs/Unity/Unity.Licensing.Client.log
Licensing Audits
~/Library/Logs/Unity/Unity.Entitlements.Audit.log
Unity Hub
~/Library/Application\ Support/UnityHub/logs/info-log.json

Log paths on Linux

Log type

File path

Unity Editor
~/.config/unity3d/Editor.log
Licensing Client
~/.config/unity3d/Unity/Unity.Licensing.Client.log
Licensing Audits
~/.config/unity3d/Unity/Unity.Entitlements.Audit.log
Unity Hub
~/.config/UnityHub/logs/info-log.json

Licensing client exit codes

The Licensing Client exit codes indicate successful or failed execution of a command. You can use these exit codes in CLI scripts to control execution flow.

Exit code

Status

0
OK
1
Invalid arguments
2
Invalid credentials
3
Organization ID is missing
4
Package Access Control List file download failed
5
Context initialization failed
6
Replication service initialization failed
7
Orchestrator initialization failed
8
Floating service initialization failed
9
Package service initialization failed
10
Access token initialization failed
11
Multi client pipe server start failed
12
License activation generation failed
13
Syncing entitlements failed
14
No valid entitlement found
15
License update failed
16
Unable to get list of user seats
17
Seat activation or deactivation failed
18
Getting entitlements failed
19
Acquiring license failed
20
Renewing floating lease failed
21
Returning floating lease failed
1000
Unknown error