Overview
This page outlines deploying solutions 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 intervention.
On this page:
The UBUNTU used version for testing was 22.04. It was also tested with Debian 12 and it worked. Others OS that accept .net8.0 should work as well, the only difference can be in how to install .net8.0.
Step 1
.NET 8.0 should already be installed on Linux; if not, proceed 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
git clone <https://github.com/tatsoftdocs/FrameworX><buildNumber>.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.g:
git clone <https://github.com/tatsoftdocs/FrameworX326.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 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.
Step 5
Finally, “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 as multiproject option.
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