Overview
This guide outlines the setup process for running FrameworkX on Linux, tested on Ubuntu 22.04 and Debian 12 with .NET 8.0 compatibility. It involves installing .NET 8.0 if not already available, importing necessary files, and configuring a connection between a Windows and Linux environment. The setup includes running web services on Linux, allowing Windows to connect via the platform, where additional features can be installed on Linux as needed. This approach facilitates a multi-project configuration, enabling seamless integration and functionality across both operating systems.
On this page:
Steps to Install .NET 8 on Linux (Ubuntu)
To install .NET 8 on a Linux machine, follow the steps below. The instructions are based on the Ubuntu distribution, but can be adapted for other distributions.
Update existing packages:
sudo apt update sudo apt upgrade -y
Install the required packages:
sudo apt install -y wget apt-transport-https
Add the Microsoft Package Signing key:
wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb
Update the repositories:
sudo apt update
Install the .NET 8 SDK:
sudo apt install -y dotnet-sdk-8.0
Verify the installation:
dotnet --version
FrameworX Setup on Linux with .NET 8.0
The UBUNTU version used for testing was 22.04. It was also tested with Debian 12. Others OS that accept .NET 8.0 should work as well, but there may be differences in how you install .NET 8.0.
Step 1
.NET 8.0 should already be installed on Linux. If not, go back to the section "Steps to install .NET 8 on Linux (Ubuntu).”
Step 2
Here we will import the necessary files to open the connection between your computer and Linux. We recommend you import the files in the path "/Home/FrameworX/". If the folder does not exist, you should create it.
git clone https://github.com/tatsoftdocs/FrameworX-v10.git
If you don’t have github installed, use the following command:
sudo apt install git
If that doesn’t work for you, you have a secondary option below:
Copy the files and subdirectories from the Windows installation directory "<Install Path>\FrameworX\net8.0" to the Linux directory "/Home/FrameworX".
Step 3
On Linux, we will run the WebServices to connect to the windows computer. Inside the directory "/Home/FrameworX/", run the following command:
dotnet TWebServices.dll
After you run this command, it should show you in the terminal that it is running and what is the IP and Port.
Step 4
After that, simply run FrameworX.exe on Windows, connect to Linux in “Server Information” > “Remote Server” > add the IP and port (it will be shown when you do the command in step 3), “Upgrade Product…” with the options you want to install on Linux (for example: HTML5, Designer/Remote, Protocol Drivers, etc.). Here you import the product installation to Linux.
Step 5
Finally, click “Upload File…”, and upload the file you will use in the Linux environment. It is important to notice that the project has to be created with the multi-platform option.
In this section: