How to change License Server from Legacy MAC mode to Advanced DB mode

Question / Problem: 

On a 7.7+ installation the KTA Serial is tied to an internal DB GUID. Prior to 7.7 the KTA Serial is tied to the MAC address for the Licence Server.

Exceptions:

• When upgrading to 7.7 from a previous version, the Legacy MAC address mode is kept
• When installing a standalone Licence Server the Legacy MAC address is still used

How can I change the Licencing from using the Legacy MAC mode to the Advanced DB mode (7.7+)?

Answer / Solution: 

After upgrading to KTA 7.7

OR

After installing a standalone Licence Server

1. Stop the License Service
2. Edit the License Service Configuration File:

• Located by default at C:\Program Files (x86)\Kofax\TotalAgility\LicenseServer\KSALicenseService.exe.config
• License server ID (1 = Primary, 2 = Backup)
• Connection String to the KTA database:
  • ​​​​​​​On-Premise = Main DB
  • OPMT = Data Center Tenants

3. Update credentials for licensing service with an account that can access the DB and local storage
4. Start Licence Service
5. Initiate the process to clear the old MAC association in order to activate the Serial against the new DB GUID

Applies to: