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
- Open Solution Center → Your License
- Click Activate in Online Activation
- Enter SerialNumber and ActivationCode
- Confirmation appears immediately
Requirements: Internet connection to license server
Offline Activation
For air-gapped systems, in Solution Center → Yout License:
- Generate Request
- Click "Get Site Code"
- Save .txt file with machine fingerprint
- Send this .txt file to Tatsoft sales team
- Process Request
- Contact Tatsoft sales team
- Send them this .txt obatained in the last section
- Apply License
- You will receive a license key back (.txt file)
- Load this file in Load license key
Hardware Dongle
- Insert USB dongle
- Wait for driver installation (automatic on Windows 10+)
- License auto-detected
- Transfer between systems by moving dongle
License Server Setup
Server Configuration:
The Server computer must have the software platform installed and licensed.
- The software must have applied license for the remote license server allowing a field higher than 1.
- Start TWebService on port 10108
Client Configuration:
- Create
RemoteLicenseService.config:
RemoteServer=<ServerIP>:10108- Place in
C:\Users\Public\Documents\FrameworX\MachineSettings - Restart application
License Information
Access via Solution Center → Help → License:
| Field | Description | Example |
|---|---|---|
| Product Edition | FrameworX edition and I/O | FrameworX 1500 I/O |
| License Type | Runtime | Runtime |
| Serial Number | Unique identifier | 12345 |
| Expiration | End date if applicable | 2025-12-31 |
| Hardkey Status | Dongle detection | Present/Absent |
License Transfer
Computer to Computer
- Generate SiteCode from original computer
- Contact vendor for temporary license
- Install temporary (frees permanent)
- Generate SiteCode from new computer
- Receive permanent license for new computer
- 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
| Issue | Cause | Solution |
|---|---|---|
| Invalid license key | Typing error | Check O/0, I/1 confusion |
| Activation fails | Network blocked | Use offline activation |
| License expired | Time-limited | Renew license |
| Feature not available | Wrong license type | Upgrade license |
| Dongle not detected | Driver issue | Reinstall drivers |
| VM license invalid | Hardware changed | Maintain VM configuration |
| Network license fails | Connection issue | Verify server IP and port |
| Error applying license: Invalid LicenseKey Access | Security permisson | Execute TWebServices.dll as administrator |
License Files
| File | Location | Purpose |
|---|---|---|
| SiteCode.txt | User-defined | Request file with machine ID |
| LicenseKey.lic | User-defined | License certificate |
| RemoteLicenseService.config | MachineSettings folder | Network 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...