Configure the server (version 1.x)

Configuration overview

• In the first procedure, you'll run the

  setup

  command on your licensing server. The

  setup

  command creates three files:
  • The licensing server configuration file (

    licensing-server-config.json

    ), which stores the licensing server configuration parameters you specify. If you reconfigure the server, the

    setup

    command reads this file and loads the stored configuration parameters as default values.
  • The services configuration file (

    services-config.json

    ), which you'll deploy to all client computers after you configure the server or reconfigure it.
  • The server registration request file (

    server-registration-request.xml

    ), which contains machine binding information from the server. You'll upload this file in the second procedure, to register the server.
• In the second procedure, you'll register the server and manage seats on the Unity ID portal. You'll register the server by uploading the XML file that was generated by the

  setup

  command. This file includes the following information:

"FirstPhysicalAddress"

"Platform"

"ProcessorCount"

"MachineName"

Before you begin

• Download the server setup file.
• Decide which protocol (HTTP or HTTPS) your licensing server will use.
• If you use the HTTPS protocol, make sure you have a server certificate in the Personal Information Exchange Format (

  .pfx

  ) format.
  Important

  Unity doesn't provide this certificate. It's the responsibility of your IT team to manage this certificate and ensure it's accepted on users' computers.
• Configure the firewall for your network interface to allow

  Unity.Licensing.Client

  to get a license.
• Determine which port to use to allow client connections. Make sure that the port you choose isn't already used by another application. If you run the

  setup

  command and choose a port that isn't free, you have to restart the setup again from the beginning and select a different port.

• You can control access to the administration API by using IP addresses in an allow list. Before you run the

  setup

  command, collect the IP addresses of all users who need access to the administration API.

Run the setup command

1. Open a Linux Terminal or Windows PowerShell and go to the directory where you downloaded and unzipped the server setup file as part of Downloading the server setup file.
2. Run the command that matches your operating system:
   • Linux: Open the Linux Terminal and run

      sudo -H ./Unity.Licensing.Server setup

   • Windows: Open the Windows PowerShell with elevated privileges (Run as administrator) and run

       .\Unity.Licensing.Server.exe setup

   A welcome message appears in the Terminal or PowerShell window:

   Welcome to Unity Licensing Server setup command line interface.This setup will help you configure your license server and generate server registration request file.Enter the server name (e.g. LicenseServer):  [DESKTOP] TestServer

3. Enter a name for your server.
4. Set which protocol (HTTP or HTTPS) your licensing server will use:

   Do you want the licensing server to use HTTPS? [Y/n]Enter path to the certificate PFX file (Press Enter to skip):Enter the PFX password for "httpscertificate.pfx":

   • If you don't have a server certificate and want to skip this step, enter

     n

     .
   • If you have a server certificate, enter

     y

     , and then set the path and password of the

     .pfx

     file where indicated.
5. Enter the index number of the network interface where the licensing server will provide service:

   List of available network interfaces on this host- [1] en0 (8C:85:90:CA:72:DC) 192.168.0.51- [2] gpd0 (02:50:41:00:01:01) 10.1.4   2228Enter the index number of the network interface which server will operate on:

   
   
   Note

   This interface should have its firewalls configured so that the Unity Licensing Client can communicate to get a license.
6. Enter the port number where you want the clients to connect. To avoid port conflicts, use a port outside the known range, specifying a four-digit or five-digit number:

   Enter server's listening port number (between 0 and 65535):  [80]

   
   
   Note

   If the port you choose is already used by another application and the server fails to launch, run the

   setup

   command again from the beginning and select a different port.
7. Configure administrator access.

• The licensing server can limit administrator access to

  admin

  API endpoints. These endpoints contain detailed server information and are useful for diagnosing and troubleshooting common configuration problems.
• To allow access to the server from inside the server itself and from the publicly accessible default IP address, enter

  y

  . Otherwise, enter

  n

  to manually add an administrator IP allow list.

  Add default addresses to the Admin IP allowlist (127.0.0.1, ::1, 192.168.0.51)? [Y/n]List of current allow-listed admin IP addresses:- 127.0.0.1- ::1- 192.168.0.51Add an additional admin IP address to the allow list? [y/N] yEnter admin IP address (Press Enter to skip):

• To define an additional administrator's IP, enter

  y

  , then enter the new IP to add to the administrator IP allow list. Otherwise, enter

  n

  .

server-registration-request.xml

Sample output

Generating signing key... DoneGenerating server configuration ...DoneGenerating services configuration ...DoneReloading configuration... DoneGenerating server registration request file... DoneSetting up file permissions... Done- - - -Setup Completed!- - - -<Note>  Server Registration Request</Note>Please go to Unity ID portal -> Organizations -> [Organization Name] -> Subscriptions & Services -> [Floating Subscription] -> Configure License Server, upload server-registration-request.xml, and follow the instructions to receive a compressed license archive file.File to upload:/home/adminuser/server-registration-request.xml<Note>  Services Configuration File</Note>Generated services-config.json file must be copied to the following locationon all end user computer in order to enable floating licensing:  - Windows: %PROGRAMDATA%\Unity\config\  - MacOS:  /Library/Application Support/Unity/config/  - Linux:  /usr/share/unity3d/config/File to copy:/home/adminuser/services-config.jsonWARNING: Please make sure to backup the following directory as it containsessential data for operating the licensing server:  ... [Path varies by server version and operating system]

Register the server and manage seats

1. Go to the Unity ID portal (id.unity.com).
2. Select Organizations and select your organization.
3. Select Subscriptions & Services and select your floating license subscription.
4. Select Configure License Server.
5. Select Upload server registration and upload the

   server-registration-request.xml

   file generated by the setup.
6. Select Licenses in the left panel and expand the server you just registered, to view how many seats are assigned, if any.
7. If you haven't assigned seats to this license yet, or if you want to add more seats, select Manage seats. Enter a value and select Save.

Next steps