Versions Compared

Key

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

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 → 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 air-gapped 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. Transfer Can move between systems by transferring moving dongle

Note: Linux requires additional driver package

License Server Setup

Server Configuration:

  1. Install server license ( multi-seat )license
  2. Start TWebService on port 10108
  3. 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

checked out automatically at startupLicense

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 devicesVideo cards

Best Practice: Snapshot VM after licensing


Troubleshooting

IssueCauseSolution
Invalid license keyTyping errorCheck for O/0, I/1 confusion
Activation failsNetwork blockedCheck firewall, use Use offline activation
License expiredTime-limitedRenew or request extensionlicense
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 Checklist

  •  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

    In this section...

    Page Tree
    root@parent
    spaces93DRAF