Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Apply and manage licenses.

Reference  InstallationFolders | Licensing | Updates | SecureGateway | Web Server 


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

Parent Page: Installation & Licensing (Reference)


On this page:

Table of Contents
maxLevel2
minLevel2
indent10px
excludeSteps
stylenone



Activation Methods

Online Activation

  1. Open Solution Center → Help → LicenseEnter license key (format: XXXX-XXXX-XXXX-XXXX)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 .req txt file with machine fingerprint
    • Transfer to connected systemSend this .txt file to Tatsoft sales team
  2. Process Request
    • Visit activation.frameworkx.com
    • Upload .req file
    • Contact Tatsoft sales team
    • Send them this .txt obatained in the last sectionDownload .lic response file
  3. Apply License
    • Transfer .lic to target system
    • Click "Load License Key"
    • You will receive a license key back (.txt file)
    • Load this file in Load license keySelect file to activate

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

Note: Linux requires additional driver package

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.Install multi-seat license
  3. Start TWebService on port 10108
  4. Verify available seats

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:

Family1500 tagsDevelopment//Combined1234-5678-9012
FieldDescriptionExample
Product
EditionFrameworX edition and I/OFrameworX
Product ModelTag/point limit
1500 I/O
License Type
Runtime
Runtime
Serial NumberUnique identifier
12345
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...

Page Tree
93DRAF
root@parentspaces