Overview

This page provides information on installing the software platform, encompassing the system requirements, installation steps, management of multiple product versions, and guidelines for uninstalling. It also includes detailed instructions for managing the installation using .EXE and .MSIX files. These files facilitate the installation process, allowing users to choose the best method that suits their needs, whether a traditional .exe setup or the modern .msix package for Windows applications.

On this page:

Systems Requirements

The table below shows the system requirements for properly installing the software platform.

Specification

Minimum

Recommended

CPU

Intel Core 2 Duo

Intel Core i7

RAM

4 Gb

16 Gb

Disk space

2 Gb

10 Gb

Display Resolution

1024 x 768

1280 x 1024 or higher

Platform

Windows 10

Windows 10 or newer

.NET Framework

.Net Framework 4.8

.NET Framework 4.8 and .NET 8

Check out the requirements for the .NET Framework.

Installing

Using .MSIX file

When you install FrameworX for the first time, just click Install. It takes only a few seconds!

User Preferences configuration

Upon first opening a solution, you will set up the User Preferences.

Using .EXE file

This type of installation can take a few minutes but is significantly faster than the 9.2 version.

Managing multiple versions installations 

The versions 9.2 and Version 10 use completely independent folders, and they can be added, removed, or updated independently. 

When installation an update version 10, in top of an existing one, it is recommended to first install the previous v10 installation. 

Uninstalling

Windows provides multiple ways to uninstall applications, ranging from the classic Control Panel to modern Settings. The ideal method depends on whether the application is managed by the Microsoft Store (.msix) or the traditional Windows installer system (.exe).

Applications (.msix)

Start Menu

  1. Right-click on the application icon.
  2. Select "Uninstall".
  3. Confirm the action in the pop-up dialog.

Settings

  1. Open the Start menu and go to "Settings > Apps > Apps & features".
  2. Find the desired application and click on it.
  3. Click "Uninstall" and confirm the action.

Applications (.exe)

Control Panel

  1. Open the Control Panel and go to "Programs and Features".
  2. Select the desired application and click on "Uninstall".
  3. Follow the on-screen instructions to complete the uninstallation.

Start Menu

  1. Right-click on the application icon.
  2. Select "More" > "Uninstall".
  3. Confirm the action in the pop-up dialog.

Only that version's specific subfolder is uninstalled when you uninstall a version.

The main folder (FrameworX) remains untouched, you can continue running the Welcome page and open Solutions in another version.

The main folder (FrameworX) will always have the last (newest) version installed. This is why the solution window continues with 9.1 even if you uninstall fs-9.1.

There is no way to roll back the Welcome/Solution Manager because the files are overwritten.


Instalation Folders

Executables Installation Folder

Using the Microsoft App standard, the MSIX installer creates a folder under \Program Files\WindowsApps\ for the product. This folder should not be accessed directly by users. Installation or removal of the product should be done using the Windows Add/Remove Apps utility.

When using the Setup.Exe the installation for is selected during the installation. 

Product Folders Created on User Documents

The first time the product is executed in the computer, it automatically various Folders under Documents special folder, using the product name as the initial node.

Product Folders under MyDocuments 

Folder name

Usage

Demos

Default location for Demo solutions included in the installer 

Solutions

Default location when creating new solutions.

ThirdParty

Default folder to add third-party extension libraries for server side execution.

ToolsSettings

Contains configuration files for the product tools

Utilities

Folder with command-line product utilities.


Installed Command-line Utilities

Name

Usage

AutoStartClient.exe

Service to automatically start WebPages or ThinClients in stations according its server status. Read more on Remote Clients Setup.

CertificateConverter.exe

Converts Security Certificates with extension .pem to .pfx, in order to be used on the MQTT communication drivers.  The syntax to execute is: CertificateConverter.exe /certificate:<.pem CertificateFilePath> /key:<.pem CertificateKeyFilePath> /password:<Password for .pfx certificate>  

DisableTaskSwitchProtection.bat

RichClients only, disables the operator to force Windows to switch the Displays module to other applications.

EnableTaskSwitchProtection.bat

RichClients only, enables the operator to force Windows to switch the Displays module to other applications.

StartRichClient.bat

Starts the RichClient in the local computer

StartRuntime.bat

Starts the execution a solution in the local computer. 


Product Folders Created on Public Documents

Product Folders under / Users / Public / Public Documents   (Common Documents)

Folder name

Usage

MachineSettings

Settings that apply to all users on that machine.

Templates

Contains the templates available to use when creating new solutions. Users can add their own solutions (.dbsln) to use as. template.  

The file Library.dbsln, in that folder, holds the Symbol Library, displays and scripts templates, and it is where the documents are saved using the  "Export do Library" command in the Designer.

TraceLogs

Folder used by product diagnostics to report exceptions and configured traces. 

Transfers

Folder used in Download, Upload, export and Import operations.


Customization Files

In some scenarios, like Linux or Docker deployment, it may be necessary to change the system defaults.

That can be accomplished creating the file: custompaths.txt, at the main installation folder where the binaries are located. 

Each line of the file, a customization folder is setup:

  • MyDocuments=<folder>
  • CommonDocuments=<folder>
  • CommonApplicationData=<folder>
  • CustomLogTransfers=<folder>

In this section: