Overview
This page covers software licensing and product details. You'll learn about our three main licensing methods (Hardkey, Softkey, Online Activation) and the procedures for license migration and termination. We'll detail the types of licenses we offer and classify our products by series, model, and family.
On this page:
Children Display | ||||||
---|---|---|---|---|---|---|
|
About The Evaluation Version
Our platform doesn't require a license for you to explore the engineering space! With the evaluation version, you'll be able to run the solution for only 2 hours, but there is no limitation on engineering time.
When installing in a business production environment, a license is required. The license terms do not allow using the 2-hour execution for that purpose, except for training purposes.
Licensing Methods
The licensing methods include Hardkey, Softkey, and Online Activation.
Note | ||
---|---|---|
| ||
To prevent license invalidation when using a VM, ensure the VM hardware configuration remains consistent. Avoid changes to hardware components such as network adapters, video cards, or hard drives, as these may impact the license validity. |
Hardkey
A hardkey license is stored on a flash drive sent to the client. The advantage of using a hardkey is that the license is not linked to a single computer, unlike softkey licenses.
If the flash drive goes missing, a new license must be acquired, as there is no replacement for the lost hardkey.
Softkey
The softkey license is generated by the equipment SiteCode. In order to obtain this file, do the following steps:
Licensing and Activation (Reference)
This reference provides comprehensive technical documentation for all licensing methods, activation procedures, and license management operations.
Related Topics:
- Solution Center (Reference) - Main interface
- License Server (Reference) - Network licensing
- Product Series - Product families and models
Evaluation Version
Capabilities and Limitations
Feature | Evaluation | Licensed |
---|---|---|
Engineering Time | Unlimited | Unlimited |
Runtime Execution | 2 hours max | Unlimited |
Solution Size | No limit | Per license |
Features | All enabled | Per license |
Training Use | Allowed | Allowed |
Production Use | Not permitted | Permitted |
Licensing Methods
Method Comparison
Method | Description | Portable | Transferable | Internet Required |
---|---|---|---|---|
Hardkey | USB dongle | Yes | Physical transfer | No |
Softkey | Machine-locked | No | Via procedure | No |
Online Activation | Cloud-based | No | Yes (deactivate) | For activation |
Offline Activation | File-based | No | Via procedure | No |
License Server | Network shared | N/A | N/A | Network only |
Virtual Machine Considerations
?? Important: Maintain consistent VM hardware configuration to prevent license invalidation:
- Network adapters
- Video cards
- Hard drives
- CPU configuration
- Memory allocation
Hardkey License
Specifications
Property | Value |
---|---|
Media | USB flash drive |
Portability | Move between computers |
Backup | Not possible |
Recovery | Must purchase new if lost |
Detection | Automatic when inserted |
Usage
- Insert USB dongle
- License auto-detected
- Remove to transfer to another computer
- No deactivation needed
Softkey License
Generation Process
- Get Site Code
- Solution Center → License Information
- Click "Get Site Code"
- Save generated file
- Submit for Processing
- Send SiteCode to vendor
- Provide purchase order/contract info
- Wait for license generation
- Install License
- Receive LicenseKey file
- Click "Load License Key"
- Select received file
- License activated
Site Code Contents
Information | Purpose |
---|---|
Machine ID | Hardware fingerprint |
OS Version | Compatibility check |
Product Version | License matching |
Request Date | Validation |
Online Activation
Process
- Obtain Credentials
- Serial Number (format: XXXX-XXXX-XXXX)
- Activation Code (format: XXXX-XXXX)
- Activate
- Solution Center → License Information
- Click "Online Activation"
- Enter credentials
- Internet connection required
- Instant activation
Benefits
Feature | Description |
---|---|
Deactivation | Can transfer to new machine |
Reactivation | Move between computers |
Management | Online portal access |
History | Activation tracking |
Offline Activation
When to Use
- No internet connection
- Secure/isolated networks
- Corporate firewall restrictions
Process
- Generate Request
- Click "Get Site Code"
- Save request file
- Transfer via USB/email
- Process Offline
- Submit to vendor portal
- Or email to support
- Receive license file
- Install License
- Transfer license file to target
- Click "Load License Key"
- Select file
- Activated without internet
License Server
Overview
Centralized license distribution across network.
Configuration Requirements
Component | Server | Client |
---|---|---|
Software | FrameworX installed | FrameworX installed |
License | Server license (multi-seat) | None |
Service | TWebService running | Network access |
Port | 10108 (default) | Same port |
Setup Process
Server Side:
- Install server license
- Start TWebService
- Verify port accessibility
- Check available seats
Client Side:
- Create RemoteLicenseService.config
- Configure:
RemoteServer=<IP>:<Port>
- Place in:
C:\Users\Public\Documents\FrameworX\MachineSettings
- Restart application
For detailed setup, see License Server (Reference)
License Types
Type Comparison
Type | Edit Solution | Run Solution | Duration | Remote Edit |
---|---|---|---|---|
Runtime | No | Unlimited | Permanent | Yes* |
Developer | Yes | 7 days max | Permanent | Yes |
Combined | Yes | Unlimited | Permanent | Yes |
Trial | Yes | Limited | Time-bound | Yes |
*Via remote connection from engineering license
Runtime License
- Production execution only
- No Designer access locally
- Remote editing supported
- Ideal for deployed systems
Developer License
- Full engineering capabilities
- 7-day runtime for testing
- Not for production
- Validation/maintenance use
Product Families
Family Comparison
Family | Target Market | Scalability | Features |
---|---|---|---|
FrameworX | Enterprise | Unlimited | All features |
FactoryStudio | Industrial | By points | SCADA/MES/HMI |
MachineHMI | OEM | By points | Machine-level |
EdgeConnect | IoT | By connections | Data gateway |
Model Tiers
Points | Typical Use | System Size |
---|---|---|
150 | Single machine | Small |
300 | Machine cell | Small-Medium |
500 | Department | Medium |
1500 | Plant area | Medium-Large |
5000 | Full plant | Large |
Unlimited | Enterprise | Any size |
Premium Protocols
Additional cost drivers requiring separate licensing:
- Some proprietary protocols
- Advanced historian connectors
- Enterprise integrations
See Communication Drivers for included vs premium protocols.
License Migration Procedures
Computer to Computer
Step | Action | Purpose |
---|---|---|
1 | Generate SiteCode from original | Identify current license |
2 | Receive temporary license | Maintain operation |
3 | Install temporary on original | Free permanent license |
4 | Generate SiteCode again | Verify temporary active |
5 | Generate SiteCode from new PC | Target identification |
6 | Receive permanent for new | Final license |
7 | Install on new computer | Complete migration |
Softkey to Hardkey
Step | Action | Notes |
---|---|---|
1 | Generate SiteCode | Current softkey machine |
2 | Install temporary license | Frees softkey |
3 | Insert USB hardkey | Physical dongle |
4 | Generate new SiteCode | With dongle attached |
5 | Load hardkey license | Activates dongle |
License Termination
Step | Action | Result |
---|---|---|
1 | Generate SiteCode | Current state |
2 | Install temporary (3-10 days) | Limited operation |
3 | Generate final SiteCode | Verify temp active |
4 | License terminated | Can't be reactivated |
License Information Panel
Display Fields
Field | Description | Example |
---|---|---|
Product Family | License edition | FactoryStudio |
Product Model | Point/tag limit | 1500 tags |
License Type | Dev/Runtime/Combined | Combined |
Serial Number | Unique identifier | 1234-5678-9012 |
Engineering Users | Concurrent developers | 5 |
Expiration | End date (if applicable) | 2025-12-31 |
Hardkey Status | Dongle detection | Present/Absent |
OEM Integration
Embedding Options
Type | Description | Use Case |
---|---|---|
Software Bundle | Embedded in application | ISV solutions |
Hardware Lock | Tied to device | Industrial PCs |
Cloud License | SaaS model | Subscription |
Contact sales@tatsoft.com for OEM requirements.
Troubleshooting
Common Issues
Problem | Cause | Solution |
---|---|---|
License not found | Wrong location | Check installation folder |
Invalid license | Expired/wrong product | Verify expiration and product |
Hardkey not detected | USB issue | Try different port |
Network license fails | Connection issue | Check server and port |
VM license invalid | Hardware changed | Maintain VM configuration |
License Files
File | Location | Purpose |
---|---|---|
SiteCode.txt | User-defined | Request file |
LicenseKey.lic | User-defined | License file |
RemoteLicenseService.config | MachineSettings folder | Network config |
Best Practices
Security
- Store license files securely
- Document serial numbers
- Restrict license server access
- Regular backup of licenses
Management
- Monitor expiration dates
- Plan renewals 30 days ahead
- Keep vendor contact info
- Document migration procedures
Virtual Environments
- Snapshot after licensing
- Document VM configuration
- Avoid hardware changes
- Test restore procedures
See Also
Parent Page:
- Solution Center (Reference) - Main interface
Related Pages:
- License Server (Reference) - Network licensing details
- Product Series - Product comparison
- Service Verification - Service setup
Go to the Solution Manager / Your License and click Get site code.
Send the generated file to a Tatsoft employee, and they will generate a license key.
Online Activation
With the online activation, a softkey license is generated, which is not linked to a computer.
The advantage of using an online activation license over the regular Softkey license is that it can be deactivated and reactivated in order to switch equipment.
To activate a license, go to the Solution Manager / License Information and click the OnlineActivation Activate button. Enter your SerialNumber and ActivationCode in the popup window that appears.
Offline Activation
This activation method allows to license computers that are not connected with the internet.
To activate a license, go to the Solution Manager / License Information and click the Get Site Code button
This procedure will allow you create a file with information about your installation, Send that file to your supplier, or distributor, to receive back a LicenseKey file.
Once in possession of the LicenseKey file, go to the Solution Manager / License Information and click the Load License Key button, and selected the LicenseKey File.
The new license will be applied to the computer.
License Server
This license models deploys a Server providing licenses to any device on that local network.
→ For information, check the License Server (Reference) page.
OEM embedding
The platform also support License Sever and embedding licenses into OEM software solutions or physical devices. For more information if you have those requirements, contact us!
License Types
The License Types include:
Runtime
Users are not allowed to edit a Solution. However, the ‘.tproj’ or ‘.dbsln’ file can run without limitations. A Solution can be edited even if it is located on equipment licensed for RuntimeOnly. To do so, a product with an Engineering license can perform a remote connection to the RuntimeOnly (through the Solution Manager / Server Information). That way, a single Engineering license can edit multiple Solutions deployed on site.
Developer
A Developer license allows maintenance and validation stations to run the solutions for up to seven days.
Product Model and Family
The number of maximum communication points available for a solution can be adjusted according to the license type.
The existing licenses types are:
FrameworX
FactoryStudio
MachineHMI
EdgeConnect
The current License type, designed Product Family, and Product Model can be found in the Your License.
See more about Product Families and Models at Product Series.
There are many communication protocols available regardless the license, however, some Premium communication protocols must be acquired separately.
See more about the protocols included and the Premium ones at Communication Drivers.
Procedures to Migrate or Kill a License
Migrating from One Computer to Another
Send the SiteCode file from the original computer.
The SiteCode will be processed, and you will receive a temporary license to install on the original computer.
Install the temporary license on the original computer.
After installing the temporary license on the original computer, generate and send the SiteCode file from the original computer again. This verifies that the temporary license has been installed properly.
Generate and send the SiteCode file from the new computer.
The SiteCode will be processed, and you will receive the license for the new computer.
Install the new permanent license on the new computer.
Migrate a Softkey to Hardkey License
Send the SiteCode file from the computer.
The SiteCode will be processed, and you will receive a temporary license to install on the computer.
Install the temporary license on the computer.
Attach the USB LicenseKey to the computer.
Generate and send the new SiteCode file after the temporary license has been installed.
The SiteCode will be processed, and you will receive a LicenseKey file to load onto the computer with the USB LicenseKey.
Killing a License
Send the SiteCode file from the computer.
The SiteCode will be processed, and you will receive a temporary (3-10 days) license to install on the original computer.
Install the temporary license on the original computer.
In this section:
Page Tree | ||||
---|---|---|---|---|
|