Overview
This page outlines deploying solutions guide outlines the setup process for running FrameworX on Linux distributions, focusing on command-line methods for setting up and configuring a computer as a client. It includes steps for system registration, Mono installation to support .NET Framework applications, and transferring necessary files to the server. Key procedures involve disabling the firewall, running the TServer application, and setting up TServer as a service for automatic operation on Ubuntu. The documentation emphasizes using command-line interfaces for deployment and service management, ensuring continuous server operation without manual interventiontested 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:
| Table of Contents | ||||
|---|---|---|---|---|
|
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:
| Code Block |
|---|
sudo apt update
sudo apt upgrade -y |
Install the required packages:
| Code Block |
|---|
sudo apt install -y wget apt-transport-https |
Add the Microsoft Package Signing key:
| Code Block |
|---|
wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb |
Update the repositories:
| Code Block |
|---|
sudo apt update |
Install the .NET 8 SDK:
| Code Block |
|---|
sudo apt install -y dotnet-sdk-8.0 |
Verify the installation:
| Code Block |
|---|
dotnet --version |
FrameworX Setup on Linux with .NET 8.0
The UBUNTU version used version for testing was 22.04. It was also tested with Debian 12 and it worked. Others OS that accept .net8NET 8.0 should work as well, the only difference can be but there may be differences in how to you install .net8NET 8.0.
Step 1
.NET 8.0 should already be installed on Linux; if . If not, proceed 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.
| Code Block |
|---|
git clone <httpshttps://github.com/tatsoftdocs/FrameworX><buildNumber>FrameworX-v10.git |
Where, <buildNumber> will be the build number of FrameworX, , the build number you can find in “Solution Manager” > “Connected Server Information” > “Installed Versions” e.gIf you don’t have github installed, use the following command:
| Code Block |
|---|
gitsudo apt clone <https://github.com/tatsoftdocs/FrameworX326.git>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:
| Code Block |
|---|
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 to Linux the product installation to Linux.
Step 5
Finally, click “Upload File…”, and upload the file you will use in the Linux environment, it . It is important to notice that the project has to be created as multiproject with the multi-platform option.
Pythonnet for Python scripts
If Python scripts are to be used, pythonnet is essential. There are two options from this point: installing it globally or inside a virtual environment. Follow the steps below for both options:
Installing in a Virtual Environment:
Run the following command in the terminal to create the virtual environment (venv) in the current folder:
| Code Block | ||
|---|---|---|
| ||
python3 -m venv ./venv_pythonnet |
Once created, activate the virtual environment with the command below
| Code Block | ||
|---|---|---|
| ||
source ./venv_pythonnet/bin/activate |
After activation, upgrade pip to ensure compatibility and access to the latest packages:
| Code Block | ||
|---|---|---|
| ||
pip install --upgrade pip |
With the environment active and pip upgraded, install pythonnet:
| Code Block | ||
|---|---|---|
| ||
pip install pythonnet |
If you choose this option, you must run TWebServices.dll within the same virtual environment. Otherwise, FrameworX will not be able to locate the pythonnet module.
Installing Globally:
Check your python version
| Code Block | ||
|---|---|---|
| ||
python3 --version |
Based on your Python version, install the following packages to ensure that pythonnet can compile and run correctly:
| Code Block | ||
|---|---|---|
| ||
sudo apt update && sudo apt install -y \
python3-pip \
python3.12-dev \
build-essential \
clang \
libpython3.12 \
libpython3.12-dev |
Now install pythonnet using the following command.
| Code Block | ||
|---|---|---|
| ||
sudo pip3 install pythonnet --break-system-packages |
Note: The --break-system-packages flag is required due to recent changes introduced by python.org. [More information can be found here.]
In this section:
| Page Tree | ||||
|---|---|---|---|---|
|
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:
| Code Block |
|---|
sudo apt update sudo apt upgrade -y |
Install the required packages
| Code Block |
|---|
sudo apt install -y wget apt-transport-https |
Add the Microsoft Package Signing key
| Code Block |
|---|
wget <https://packages.microsoft.com/config/ubuntu/$>(lsb_release -rs)/packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb |
Update the repositories:
| Code Block |
|---|
sudo apt update |
Install the .NET 8 SDK:
| Code Block |
|---|
sudo apt install -y dotnet-sdk-8.0 |
Verify the installation: