Documentation

Support

Downloading and importing the license archive file

Download and import the license file needed for your instance of the Unity Licensing Server.
Read time 2 minutesLast updated a day ago

This task is part of the end-to-end process for setting up the Unity Licensing Server. After you've configured the licensing server, run the
import
command to:
  • Import the license archive file.
  • Store the server license file in the current user's platform-specific directory for the licensing server.
  • Move the signing delegation files to the platform-specific directory.
  • Set the license signing certificate password in the
    licensing-server-config.json
    file.
For information on the locations of the licensing server files and directories, refer to Server paths. Follow these steps to download the license archive file and run the import command:
  1. Go to the Unity ID portal (id.unity.com).
  2. Select Organizations and select the organization that has your floating license subscription.
  3. Select Subscriptions & Services from the side panel, and select your floating license subscription.
  4. Select Configure License Server.
  5. Select Download licenses. If this button is disabled, make sure you assigned seats, as described in Register the server and manage seats.
  6. Download the
    .zip
    file to a directory of your choosing. Take note of the
    .zip
    file's location, which you will need in a later step.
  7. If you have any Linux Terminal or Windows PowerShell windows open, close them, then open a new window. This ensures that changes to your user or group permission that the
    setup
    command made are applied in the new terminal session.
  8. In your Terminal or Powershell window, change directories to the location where you unzipped
    Unity.Licensing.Server.*.zip
    during the download procedure.
  9. Run the command that matches your operating system to import the archive:
    • Linux:
      ./Unity.Licensing.Server import <filepath-to-downloaded-archive>
    • Windows:
      .\Unity.Licensing.Server.exe import <filepath-to-downloaded-archive>



    A list of all available toolsets for this licensing server appears in the Terminal or PowerShell window:
    Extracting files...Done
    Validating archive content...Done
          LSD type import detected
    Importing server license files...Done
    Importing delegation file...Done
    List of available toolsets on this server
      - [1] LicenseServer_3573461705080_1 [Unity Enterprise for Games(Floating)]
    Enter the index number of the toolset that should be used by default: 1
  10. Enter the toolset ID you want to set as the default. For more information about toolsets, refer to Advanced Server Configuration. The
    import
    command writes the selected toolset ID to the
    licensing-server-config.json
    file and displays the following message in the Terminal or PowerShell window:
    Successfully imported licensing files. You may run the server.
    Please note that if the server is already running, you will have to restart it.
  11. Restart the server to reload the new license configuration files.

Next steps

Proceed to testing the licensing server to continue setting up your licensing server.