Licensing Procedures Reference

Apply and manage licenses.

Reference → Installation → Folders | Licensing | Updates | SecureGateway | Web Server 

Activation Methods

Online Activation

1. Open Solution Center → Your License
2. Click Activate in Online Activation
3. Enter SerialNumber and ActivationCode
4. Confirmation appears immediately

Requirements: Internet connection to license server

Offline Activation

For air-gapped systems, in Solution Center → Your License:

1. Generate Request
   • Click "Get Site Code"
   • Save .txt file with machine fingerprint
   • Send this .txt file to Tatsoft sales team
2. Process Request
   • Contact Tatsoft sales team
   • Send them this .txt obatained in the last section
3. Apply License
   • You will receive a license key back (.txt file)
   • Load this file in Load license key

Hardware Dongle

1. Insert USB dongle
2. Wait for driver installation (automatic on Windows 10+)
3. License auto-detected
4. Transfer between systems by moving dongle

License Server Setup

Server Configuration:

1. The Server computer must have the software platform installed and licensed.

2. The software must have applied license for the remote license server allowing a field higher than 1.
3. Start TWebService on port 10108

Client Configuration:

1. Create RemoteLicenseService.config:

   RemoteServer=<ServerIP>:10108

1. Place in C:\Users\Public\Documents\FrameworX\MachineSettings
2. Restart application

License server outage: From FrameworX 10.1.6, a runtime licensed from a remote license server checks the license every minute and keeps running through up to 300 consecutive failed checks, about 300 minutes of network or license server outage. The first successful check after the outage resets the count to 0. The property Info.License.HardKeyRetryCount shows the current count of failed checks. Runtimes with a local license (softkey or hardkey) behave as before.

License Upgrade

When you buy an upgrade for an existing license (more I/O, another edition, more clients), Tatsoft records it on the license server for your serial number. How you apply it depends on how the computer was activated.

Online Upgrade

For a computer activated online with an activation code. You do not need a new code.

1. Open Solution Center → Your License.
2. Wait a few seconds while the page checks the license server, or click the refresh icon. When an upgrade is waiting, the button in Online Activation reads Upgrade and is enabled.
3. Click Upgrade. The SerialNumber and ActivationCode are already filled in.
4. Click Upgrade in the dialog. The new license is applied and a confirmation appears.

If the button reads Upgrade but stays disabled, no upgrade is waiting for your serial number yet. Requirements: Internet connection to the license server.

Other Cases

• Offline computer: follow the Offline Activation steps above. Generate a new Site Code, send it to Tatsoft, and load the license key you receive.
• Hardware dongle: keep the dongle connected and follow the Offline Activation steps.
• Remote license server: apply the upgrade on the license server computer. The activation buttons are disabled on client computers, which get their license from the server.

License Information

Access via Solution Center → Help → License. The page shows the license identity, expiration, and the capacity limits granted by the license:

Property Watch Equivalents

The same capacity limits are exposed at runtime under the Info.License object (visible in Property Watch). The Solution Center label and the runtime property refer to the same value:

License Expiration Warnings

From FrameworX 10.1.6, display clients warn operators about license expiration only in the final week:

The clients run this check from 08:00 to 17:59 local time. The audit trail entries need Enable Audit Trail and System Warnings checked in Alarms → Global Settings. The expiration date is also available at runtime in Info.License.ExpirationDate.

License Transfer

Computer to Computer

1. Generate SiteCode from original computer
2. Contact vendor for temporary license
3. Install temporary (frees permanent)
4. Generate SiteCode from new computer
5. Receive permanent license for new computer
6. Install on new computer

Virtual Machine Considerations

Maintain consistent VM configuration:

• Network adapters
• CPU configuration
• Memory allocation
• Storage devices

Best Practice: Snapshot VM after licensing

Troubleshooting

License Files

Best Practices Checklist

• Document serial numbers and expiration dates
• Plan renewals 30 days ahead
• Test restore procedures for VMs
• Monitor floating license usage

In this section...