Apply and manage licenses.

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

Licensing Procedures (Reference) for license activation, management, and troubleshooting.


Activation Methods

Online Activation

  1. Open Solution Center → Yout 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 → Yout 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 Information

Access via Solution Center → Help → License:

FieldDescriptionExample
Product EditionFrameworX edition and I/OFrameworX 1500 I/O
License TypeRuntimeRuntime
Serial NumberUnique identifier12345
ExpirationEnd date if applicable2025-12-31
Hardkey StatusDongle detectionPresent/Absent

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

IssueCauseSolution
Invalid license keyTyping errorCheck O/0, I/1 confusion
Activation failsNetwork blockedUse offline activation
License expiredTime-limitedRenew license
Feature not availableWrong license typeUpgrade license
Dongle not detectedDriver issueReinstall drivers
VM license invalidHardware changedMaintain VM configuration
Network license failsConnection issueVerify server IP and port

License Files

FileLocationPurpose
SiteCode.txtUser-definedRequest file with machine ID
LicenseKey.licUser-definedLicense certificate
RemoteLicenseService.configMachineSettings folderNetwork license configuration

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...