Apply and manage licenses.
Reference → Installation → Folders | Licensing | Updates | SecureGateway | Web Server
Licensing Procedures (Reference) Detailed procedures for license activation, management, and troubleshooting.Parent Page: Installation & Licensing (Reference)
Table of Contents maxLevel 2 minLevel 2 indent 10px exclude Steps style none
Activation Methods
Online Activation
- Open Solution Center → Help → Yout License
- Enter license key (format: XXXX-XXXX-XXXX-XXXX)
- Click Activate in Online Activation
- Enter SerialNumber and ActivationCode
- Confirmation appears immediately
Requirements: Internet connection to license server
Offline Activation
For
systems without internetair-gapped systems, in Solution Center → Yout License:
- Generate Request
- Click "Get Site Code"
- Save .req txt file with machine fingerprint
- Transfer to connected systemSend this .txt file to Tatsoft sales team
- Process Request
- Visit activation.frameworkx.com
- Upload .req file
- Download .lic response file
- Apply License
- Transfer .lic to target system
- Click "Load License Key"
- Select file to activate
- 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/11+)
- License auto-detected - no activation required
- Transfer Can move between systems by transferring moving dongle
Note: Linux requires additional driver package
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.Install server license (multi-seat)
- Start TWebService on port 10108Verify available seats
Client Configuration:
- Create
RemoteLicenseService.config:
RemoteServer=<ServerIP>:10108- Place in
C:\Users\Public\Documents\FrameworX\MachineSettings - Restart applicationLicense checked out automatically at startup
License Information
PanelAccess 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
ProceduresComputer to Computer
(Softkey)- Generate SiteCode from original computer
- Contact vendor for temporary license
- Install temporary on original (frees permanent)
- Generate SiteCode from new computer
- Receive permanent license for new computer
- Install on new computer
Virtual Machine Considerations
Maintain consistent VM configuration
to prevent license invalidation:
- Network adapters
- CPU configuration
- Memory allocation
- Storage devices
- Video cards
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 |
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...
| Page Tree | ||
|---|---|---|
|
Overview
Content Tools
Tasks