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 → Help → License
- Enter license key (format: ABCDEF)
- Click Activate Online
- Confirmation appears immediately
Requirements: Internet connection to license server
Offline Activation
For air-gapped systems:
- Generate Request
- Click "Get Site Code"
- Save .req file with machine fingerprint
- Transfer to connected system
- 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
Hardware Dongle
- Insert USB dongle
- Wait for driver installation (automatic on Windows 10+)
- License auto-detected
- Transfer between systems by moving dongle
Note: Linux requires additional driver package
License Server Setup
Server Configuration:
- Install multi-seat license
- Start TWebService on port 10108
- Verify available seats
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 |
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