On-Prem: License registrations

To reserve licenses with an On-Prem Qt License Server instance, the licenses must first be registered with the instance. Use the register command to register licenses.

If the host computer or the On-Prem Qt License Server instance is restarted for any reason, the previously registered licenses are automatically re-registered by the instance.

Automatic license synchronization

On-Prem Qt License Server automatically synchronizes registered licenses with the Qt cloud hourly and at startup.

During synchronization, the following actions are performed:

• Each registered license is validated against the Qt cloud service.
• Expired, revoked, or invalid licenses are automatically removed.
• Licenses with uncertain status (due to network or server errors) are retained until their status can be confirmed.
• Valid licenses are retained and updated.

License registration rules

The main rules for license registrations are:

• Licenses can be registered implicitly (without specifying license numbers) or explicitly (by specifying the license numbers).
• Initial registration can be done implicitly or explicitly.
• Once the On-Prem Qt License Server instance has licenses registered, you can continue registrations only by explicitly giving the license numbers.
• Multiple users can manage license registrations on the same On-Prem Qt License Server instance if they have the appropriate roles.
• If a license registration or deregistration fails for any reason, the current state is always preserved.

License registration example scenarios

This section's example scenarios illustrate how to manage license registrations.

Single user On-Prem Qt License Server license registration administration

In this example scenario, only one user manages the on-prem instance license registrations.

1. User 1, the license manager, does the initial license registration implicitly. User 1 runs the command:

   ./qt-license-server register -e example.user@company.com -p 1234567890 --url https://my.company.onprem.address:8080

   The output shows the licenses registered successfully:

   Licenses registered successfully.
   License: 11554731 | Owner: Example User | Seat amount: 20

2. User 1 purchased new licenses and wants to register them as well, in addition to existing registrations. User 1 forgets to explicitly define the license numbers, which is required after the initial registration. User 1 runs the command:

   ./qt-license-server register -e example.user@company.com -p 1234567890 --url https://my.company.onprem.address:8080

   The output notifies User 1 about the error:

   Error: Server is already hosting registered licenses: [11554731]
   
   To update registration, you must explicitly specify licenses using -l/--licenses.
   This safety check prevents accidental changes to your license registration.
   
   *** Note: You might be removing licenses, which this account, example.user@company.com, does not have rights to! ***

3. User 1 registers the new licenses explicitly by specifying the license numbers. User 1 runs the command:

   ./qt-license-server register -e example.user@company.com -p 1234567890 --url https://my.company.onprem.address:8080 -l 11554731 96023021

   The output shows a summary of the changes and requests confirmation before proceeding:

   Registration Change Summary:
   Currently registered licenses: [11554731]
   Requested licenses:            [11554731, 96023021]
   
   Licenses to be added:   96023021
   
   ? Are you sure you want to proceed with these changes?

   User 1 confirms by answering Yes, and the output shows:

   Licenses registered successfully.
   License: 11554731 | Owner: Example User | Seat amount: 20
   License: 96023021 | Owner: Example User | Seat amount: 3

Shared On-Prem Qt License Server license registration administration

In this example scenario, three users manage the license registrations and deregistrations on the same On-Prem Qt License Server instance.

1. User 1, the license manager, does the initial license registration implicitly. User 1 runs the command:

   ./qt-license-server register -e example.user1@company.com -p 1111111111 --url https://my.onprem.instance.addr:8080

   The output shows the licenses registered successfully:

   Licenses registered successfully.
   License: 11554731 | Owner: Example User 1 | Seat amount: 20

2. User 1 grants the Deputy license manager role to User 2 and User 3 in Qt Customer Portal. Now they can take over the On-Prem Qt License Server instance license registration management.
3. User 2, a deputy license manager, takes over the On-Prem Qt License Server instance and wants to add another license, in addition to the existing ones. User 2 runs the command:

   ./qt-license-server register -e example.user2@company.com -p 2222222222 --url https://my.onprem.instance.addr:8080 -l 11554731 96023021

   The output shows a summary of the changes and requests confirmation before proceeding:

   Registration Change Summary:
   Currently registered licenses: [11554731]
   Requested licenses:            [11554731, 96023021]
   
   Licenses to be added:   96023021
   
   ? Are you sure you want to proceed with these changes?

   User 2 confirms by answering Yes, and the output shows:

   Licenses registered successfully.
   License: 11554731 | Owner: Example User 1 | Seat amount: 20
   License: 96023021 | Owner: Example User 1 | Seat amount: 3

4. User 3, another deputy license manager, takes over the On-Prem Qt License Server instance and wants to remove an existing reservation and to add another license. User 3 runs the command:

   ./qt-license-server register -e example.user3@company.com -p 3333333333 --url https://my.onprem.instance.addr:8080 -l 96023021 96023022

   The output shows a summary of the changes and requests confirmation before proceeding:

   Registration Change Summary:
   Currently registered licenses: [11554731, 96023021]
   Requested licenses:            [96023021, 96023022]
   
   Licenses to be removed: 11554731
   *** Note: You might be removing licenses, which this account, example.user3@company.com, does not have rights to! ***
   If so, those licenses can't be re-registered back anymore using this account.
   
   ? Are you sure you want to proceed with these changes?

   User 3 confirms by answering Yes, and the output shows:

   Licenses registered successfully.
   License: 96023021 | Owner: Example User 1 | Seat amount: 3
   License: 96023022 | Owner: Example User 1 | Seat amount: 20

5. User 1, the license manager, wants to deregister all licenses on the On-Prem Qt License Server instance. User 1 runs the command:

   ./qt-license-server deregister -e example.user1@company.com -p 1111111111 --url https://my.onprem.instance.addr:8080

   The output shows a summary of the changes and requests confirmation before proceeding:

   Warning: You are about to deregister all licenses:
   Currently registered licenses: [96023021, 96023022]
   All licenses will be removed from this on-premises instance.
   
   *** Note: You might be removing licenses, which this account, example.user1@company.com, does not have rights to! ***
   If so, those licenses can't be re-registered back anymore using this account.
   
   ? Are you sure you want to deregister all licenses?

   User 1 confirms by answering Yes, and the output shows:

   Licenses deregistered successfully.
   Logout for user example.user1@company.com
   All licenses deregistered. This instance does not host any licenses.