Install updates and manage multiple FrameworX versions on the same computer.
Reference → Installation → Folders | Licensing | Updates | SecureGateway | Web Server
FrameworX uses a simple file-based installation model that allows multiple versions to coexist on the same computer. Updates replace the current installation by default, but you can maintain multiple versions by copying installation folders.
Version Numbering
- Major versions: 10.0, 11.0
- Updates: 10.1, 10.2 (replace the existing 10.x installation)
- Service packs: 10.1.1, 10.1.2
- Build Number: 10.1.1.1000
Build Number
The Build Number is an internal DevOps control, it is number changes nearly on DAILY basis to track internal development tasks.
It is value doesn't;t have any special meaning for the users, neither reflects the volume of changes, neither updates published.
Installing Updates
Standard Update Process:
- Download the update installer
- Run the installer - automatically replaces current version
- Existing solutions continue working
- All shortcuts update to new version
Managing Multiple Versions
To Keep Multiple Versions:
- Before installing update, copy entire FrameworX folder:
- Default:
C:\Program Files\Tatsoft\FrameworX\ - Copy to:
C:\Program Files\Tatsoft\FrameworX_10.0\
- Default:
- Install the update (replaces original folder)
- Access different versions:
- New version: Use standard shortcuts
- Old version: Run
FrameworX.exefrom copied folder
Note: Each folder is completely self-contained - all assemblies, libraries, and executables needed to run that version.
Important: Shared Files
<info box> **Critical Consideration: Machine Settings**
Multiple versions share one set of global files located in: C:\Users\Public\Documents\FrameworX\MachineSettings\
These include:
- Solution templates
- Machine-specific settings
- License configuration
- Recent solution lists
Recommendation:
- Install the latest version normally (runs installer)
- Keep older versions as copied folders
- Be aware that new solution templates apply to the most recently installed version </info box>
Creating Solutions with Older Versions
For older version solutions:
- Navigate to older version folder
- Locate template in:
\Templates\BlankSolution.dbsln - Copy template to your project location
- Open with older version's FrameworX.exe
- Solution uses that version's runtime
Note: Cannot use Solution Center's "New Solution" for older versions - must manually copy templates.
Version Compatibility Matrix
| Scenario | Compatibility | Notes |
|---|---|---|
| Open 10.0 solution in 10.1 | Full | Automatic upgrade prompt |
| Open 10.1 solution in 10.0 | Limited | May lose new features |
| Run different versions simultaneously | Yes | Different folders required |
| Share solutions between versions | Caution | Test thoroughly |
Best Practices
- Production Systems: Maintain single version for stability
- Development Systems: Multiple versions acceptable
- Testing: Always test solutions after version changes
- Backup: Archive older version folders before updates
Troubleshooting Multiple Versions
| Issue | Cause | Solution |
|---|---|---|
| Wrong version launches | Shortcut points to updated path | Use direct FrameworX.exe |
| Template not found | Shared MachineSettings | Copy template manually |
| License conflicts | Shared license file | Verify license supports all versions |
| Solution won't open | Version incompatibility | Use matching version |
In this section...