Downloading and importing the license archive file

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.

Important

Use the same service account that you used to set up the server to complete each of the following steps now and for any future maintenance or updates.

For information on the locations of the licensing server files and directories, see 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've assigned seats, as described near the end of Running the setup command.

6. Download the .zip file to a directory of your choosing. Take note of the .zip file's location, which you'll need in a following step.

   Note

   Do not unzip the archive file.

7. From the Linux Terminal or the Windows PowerShell, 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>

     Note

     <filepath-to-downloaded-archive> is the full path to the license archive .zip file that you downloaded in a previous step. This path includes the .zip file name.

     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
     

8. Enter the toolset ID you want to set as the default. For more information about toolsets, see 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.
   

9. Restart the server to reload the new license configuration files.

   Note

   If the licensing server is running as a service, follow the instructions, Restarting the service.

Next steps

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