Detailed procedures for license activation, management, and troubleshooting.

Parent Page: Installation & Licensing (Reference)


Activation Methods

Online Activation

  1. Open Solution Center → Help → License
  2. Enter license key (format: XXXX-XXXX-XXXX-XXXX)
  3. Click Activate Online
  4. Confirmation appears immediately

Requirements: Internet connection to license server

Offline Activation

For systems without internet:

  1. Generate Request
    • Click "Get Site Code"
    • Save .req file with machine fingerprint
    • Transfer to connected system
  2. Process Request
  3. Apply License
    • Transfer .lic to target system
    • Click "Load License Key"
    • Select file to activate

Hardware Dongle (Hardkey)

  1. Insert USB dongle
  2. Wait for driver installation (automatic on Windows 10/11)
  3. License auto-detected - no activation required
  4. Can move between systems by transferring dongle

Note: Linux requires additional driver package

License Server Setup

Server Configuration:

  1. Install server license (multi-seat)
  2. Start TWebService on port 10108
  3. Verify available seats

Client Configuration:

  1. Create RemoteLicenseService.config:
    RemoteServer=<ServerIP>:10108
  2. Place in C:\Users\Public\Documents\FrameworX\MachineSettings
  3. Restart application
  4. License checked out automatically at startup

License Information Panel

Access via Solution Center → Help → License:

FieldDescriptionExample
Product FamilyFrameworX editionFrameworX
Product ModelTag/point limit1500 tags
License TypeDevelopment/Runtime/CombinedRuntime
Serial NumberUnique identifier1234-5678-9012
ExpirationEnd date if applicable2025-12-31
Hardkey StatusDongle detectionPresent/Absent

License Transfer Procedures

Computer to Computer (Softkey)

  1. Generate SiteCode from original computer
  2. Contact vendor for temporary license
  3. Install temporary on original (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 to prevent license invalidation:

  • Network adapters
  • CPU configuration
  • Memory allocation
  • Storage devices
  • Video cards

Best Practice: Snapshot VM after licensing

Troubleshooting

IssueCauseSolution
Invalid license keyTyping errorCheck for O/0, I/1 confusion
Activation failsNetwork blockedCheck firewall, use offline activation
License expiredTime-limitedRenew or request extension
Feature not availableWrong license typeUpgrade license
Dongle not detectedDriver issueReinstall drivers, try different USB port
VM license invalidHardware changedMaintain VM configuration
Network license failsConnection issueVerify server IP and port 10108

License Files

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

Best Practices

  • Document serial numbers and expiration dates
  • Keep vendor contact information accessible
  • Plan renewals 30 days ahead
  • Backup license files securely
  • Test restore procedures for VMs
  • Monitor floating license usage