Page History

Systems Requirements

Runtime Solutions

Designer, Configuration Tools

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

Installing Procedure

Clean/First Installation 

When you install FactoryStudio for the first time, you will be prompted to choose the installation type:

• Complete: All program features are installed and requires more disk space
• Typical: Installs all the default program features. Recommended for most users
• Custom: Allows users to choose which program features are installed and where they are installed. Recommended for advanced users

For the Custom Setup, you can select whether the Sample projects are installed, and you can select which communication protocols you want to install. Please note: If you do not install a particular protocol and end up needing it in the future, you will have to rerun the Install Wizard.

You can choose to install the TWebServer (our default webserver) as a service or as a component. We recommend installing it as a service so you do not have to manually run it whenever you need it. 

Image Removed

After completing the installation process, a main folder named FactoryStudio and a subfolder to the specific version (for example, fs-8.1) are created.

Installing Multiple Versions

To install multiple major versions on the same computer, the installation order must be chronological — i.e. you must start with the oldest major version and move your way to the newer ones.

2014.2 --> 8.1 --> 9.1 → 9.2 → 9.3

When a new version is installed, the main folder (FactoryStudio) contents are overwritten and a new sub-folder (fs-9.1) for the new version is created.

Image Removed

Since the files in the main folder (FactoryStudio) will be replaced when you install multiple versions, the Project Selection Welcome page will have the layout of latest version installed, but you will still be able to edit/create projects in every version installed. 

System Requirements

The tables below show the system requirements for the proper installation of the Configuration tools. The Projects developed with the platform can be created for various targets, form more information on project target requirements go to section <PlatformOverview-Requirements>

The .NET 8

Further information on operating Systems, check the requirements from the .NET Framework available here.

Desktop Runtime must be installed for solutions that include web-based displays or when deploying to Linux.

Check out the requirements for the .NET Framework.

User Preferences configuration

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

Image Added

Installing Using Setup.EXE file

This type of installation can take a few minutes but is significantly faster than the 9.2 version. You'll need to manually authorize firewall ports during installation.

Image Added

Managing multiple versions installations 

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

.NET 8 Installation 

.NET 8 is required to create solutions to other operating platforms like Linux, and to edit displays to show on web browsers.

If you receive a warning that .NET 8 is not available on your computer, you still will be able to work with Windows-only solutions and displays. 

To install the .NET 8, follow the link in the installer message, or you can find the .NET 8 Desktop Runtime installer from Microsoft here: https://dotnet.microsoft.com/en-us/download/dotnet/8.0. Be sure to pick the version that matches your CPU architecture, which is likely x64. (And don't pick the "SDK" or ".NET Runtime" or other versions - just the ".NET 8 Desktop Runtime")

Uninstalling

Windows provides multiple ways to uninstall applications, ranging from the classic Control Panel to modern Settings. 

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

Uninstalling Procedure

When you uninstall a version, only that version's specific subfolder is uninstalled when you uninstall a version.

The . Since the main folder (FactoryStudioFrameworX) remains untouched, you can continue running the Welcome page and can open Projects 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/Project Solution Manager because the files are overwritten.

Instalation Folders

Executables Installation Folder

The installer creates a folder under \Program Files (x86)\WindowsApps\<Company>\Product\ or at the custom path selected during the installation. 

Product Folders Created on User Documents

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

Adding Communication Protocols

Web Server and Secure WebGateway

Third-Party Integrations

Canary Labs

HiveMQ Broker

Product Folders Created on Public Documents

Custom Installation Paths

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

That can be accomplished creating a CustomPaths configuration 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>

Typically those paths are setup to point to a memory area, outside the docker image, where you can read and write data.

In this section: