Local installation
(Making Ubuntu Dev Documentation for Deployment of MDriven)
(Added Edited template with July 12, 2025.)
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Edited|July|12|2025}}
== '''MDriven Installation on Ubuntu 24.04''' ==
MDriven empowers businesses and developers to build and manage applications faster and smarter through Model-Driven Development (MDD). It bridges the gap between business needs and technical execution, turning models into fully functional applications with ease.
MDriven empowers businesses and developers to build and manage applications faster and smarter through Model-Driven Development (MDD). It bridges the gap between business needs and technical execution, turning models into fully functional applications with ease.


With MDriven you can:
With MDriven you can:


* Accelerate Development
* Accelerate development
* Adapt Quickly
* Adapt quickly
* Collaborate easily
* Collaborate easily
* Deploy Anywhere
* Deploy anywhere


'''Step -1: Login to the Ubuntu Server via SSH.'''<syntaxhighlight>
===== Step -1: Login to the Ubuntu Server via SSH. =====
<syntaxhighlight>
ssh username@IP_Address -p Port_number
ssh username@IP_Address -p Port_number


</syntaxhighlight>Connect via SSH to your server
</syntaxhighlight>Connect via SSH to your server.


 
===== Step -2: Update Server. =====
'''Step -2: Update Server.'''<syntaxhighlight>
<syntaxhighlight>
sudo apt-get update
sudo apt-get update
sudo apt-get upgrade
sudo apt-get upgrade
</syntaxhighlight>'''Step -3: Secure Server.'''<syntaxhighlight>
</syntaxhighlight>
 
===== Step -3: Secure Server. =====
<syntaxhighlight>
sudo apt-get install openssh-server fail2ban
sudo apt-get install openssh-server fail2ban
</syntaxhighlight>SSH assault can be avoided by utilizing Fail2ban
</syntaxhighlight>SSH assault can be avoided by utilizing Fail2ban


Step -4: Install Packages and Libraries
===== Step -4: Install Packages and Libraries. =====
 


Install apt-transport-https<syntaxhighlight>
Install apt-transport-https<syntaxhighlight>
sudo apt-get install -y apt-transport-https
sudo apt-get install -y apt-transport-https
</syntaxhighlight>This ensures you can safely fetch packages, package metadata and add third-party repositories using HTTPS ensuring data integrity and privacy during downloads
</syntaxhighlight>This ensures you can safely fetch packages, package metadata and add third-party repositories using HTTPS ensuring data integrity and privacy during downloads.


Install the .NET SDK version 8.0 or Higher<syntaxhighlight>
Install the .NET SDK version 8.0 or Higher<syntaxhighlight>
Line 37: Line 44:
Check that the install is successful<syntaxhighlight>
Check that the install is successful<syntaxhighlight>
dotnet --list-runtimes
dotnet --list-runtimes
</syntaxhighlight>Step -5: Download MDriven Server from Official Site
</syntaxhighlight>Install Nginx or Apache Server: Let's go with Nginx Server for now using the following command<syntaxhighlight>
sudo apt install nginx
</syntaxhighlight>You can verify if Nginx is running by checking its service status:<syntaxhighlight>
sudo systemctl status nginx
</syntaxhighlight>The output should show the service as "active (running)".
 
===== Step -5: Download MDriven Server from Official Site. =====
The command we get downloads files from the web. Use it to download the latest version of MDriven Server from the main site.<syntaxhighlight>
wget https://www.mdriven.net/PublicDownloads/MDrivenServerCoreLinux_20241219.zip
</syntaxhighlight>
 
'''Notes:'''
 
# Double check the latest name of the MDriven Server .Zip compatible with Linux from the main site.
# Upon download, the downloaded .zip file will be located in your home root directory


The command wget downloads files from the web, Replace mdrivenserver_xxxx.zip with the actual name of the latest fullname of the lastest version of the MDriven Server from the main website.<syntaxhighlight>
===== Step -6: Create a directory in /var/www/html - Directory. =====
wget https://www.mdriven.net/downloads/mdrivenserver_xxxx.zip -O downloaded_file.zip
<syntaxhighlight>
-O downloaded_file.zip: Optional flag to rename the downloaded file
cd /var/www/html
</syntaxhighlight>Step -6: Create a directory in /var/www/ - Directory.<syntaxhighlight>
sudo mkdir mdrivenserver
cd /var/www/
</syntaxhighlight>Unzip the files into the Directory (Change directory to your home directory using the command cd).<syntaxhighlight>
mkdir mdrivenserver [Choose a suitable of your preference]
cd
</syntaxhighlight>Unzip the files into the Directory<syntaxhighlight>
sudo unzip MDrivenServerCoreLinux_20241219.zip -d /var/www/html/mdrivenserver
unzip downloaded_file.zip -d /var/www/mdrivenserver
</syntaxhighlight>Notes: If the unzip utility is not installed, you can install it with:<syntaxhighlight>
</syntaxhighlight>Notes: If the unzip utility is not installed, you can install it with:<syntaxhighlight>
sudo apt-get install -y unzip
sudo apt-get install -y unzip
</syntaxhighlight>
</syntaxhighlight>
===== Step -7: Download MDriven Turnkey Server from the Official Site. =====
The command we get downloads files from the web. Use it to download the latest version of MDriven Turnkey from the main site.<syntaxhighlight>
wget https://www.mdriven.net/PublicDownloads/MDrivenTurnkeyCoreLinux_20241219.zip
</syntaxhighlight>
'''Notes:'''
# Double check the latest name of the MDriven Turnkey .Zip compatible with Linux from the main site.
# Upon download, the downloaded .zip file will be located in your home root directory
===== Step -8: Create a directory in /var/www/html - Directory. =====
<syntaxhighlight>
cd /var/www/html
sudo mkdir mdriventurnkey
</syntaxhighlight>Unzip the files into the Directory (Change directory to your home directory using the command cd).<syntaxhighlight>
cd
sudo unzip MDrivenTurnkeyCoreLinux_20241219.zip -d /var/www/html/mdriventurnkey
</syntaxhighlight>
===== Step -9: Create MDriven Server Service File. =====
We have to create a service file to MDriven Server. Let's create a service file 'mdrivenserver.service' in /etc/systemd/system.<syntaxhighlight>
sudo nano /etc/systemd/system/mdrivenserver.service
</syntaxhighlight>Add the following aspects to the newly created service file.<syntaxhighlight>
[Unit]
Description=MDriven Server Service
After=network.target
[Service]
WorkingDirectory=/var/www/html/mdrivenserver
ExecStart=/usr/bin/dotnet /var/www/html/mdrivenserver/AppCompleteGenericCore.dll -5010 - nohttps
Restart=always
KillSignal=SIGINT
SyslogIdentifier=mdriven-server
User=root
Environment=DOTNET_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMENTRY_MESSAGE=false
[Install]
WantedBy=multi-user.target
</syntaxhighlight>
===== Step -10: Create MDriven Turnkey Service File. =====
We have to create a service file to MDrivenTurnkey. Let's create a service file 'mdriventurnkey.service' in /etc/systemd/system.<syntaxhighlight>
sudo nano /etc/systemd/system/mdriventurnkey.service
</syntaxhighlight>Add the following aspects to the newly created service file.<syntaxhighlight>
[Unit]
Description=MDriven Turnkey Server Service
After=network.target
[Service]
WorkingDirectory=/var/www/html/mdriventurnkey
ExecStart=/usr/bin/dotnet /var/www/html/mdriventurnkey/StreaminAppCoreWebApp.dll -port=5011 -nohttps –[remove the -nohttps while in production]
Restart=always
KillSignal=SIGINT
SyslogIdentifier=turnkey-server
User=root
Environment=DOTNET_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMENTRY_MESSAGE=false
[Install]
WantedBy=multi-user.target
</syntaxhighlight>Finally, set the root user's permissions for these service files.<syntaxhighlight>
sudo chmod 775 /etc/systemd/system/mdrivenserver.service
sudo chown root: /etc/systemd/system/mdrivenserver.service
sudo chmod 775 /etc/systemd/system/mdriventurnkey.service
sudo chown root: /etc/systemd/system/mdriventurnkey.service
</syntaxhighlight>
===== Step -11: Run MDriven Server and MDriven Turnkey. =====
<syntaxhighlight>
sudo systemctl start mdrivenserver.service
sudo systemctl start mdriventurnkey.service
</syntaxhighlight>Use the above commands to launch the instance of MDriven Server and MDriven Turnkey respectively. Then, use the following command to see the service's current status. Furthermore, the installation of MDriven Server and MDriven Turnkey was successful if they are shown as active.<syntaxhighlight>
sudo systemctl status mdrivenserver.service
sudo systemctl status mdriventurnkey.service
</syntaxhighlight>Now, you can access MDriven Server and MDriven Turnkey by entering the following URL respectively.<syntaxhighlight>
"http://<your_domain_or_IP_address>:5010"
"http://<your_domain_or_IP_address>:5011"
</syntaxhighlight>Ensure that these ports are open on the firewall using the following commands:<syntaxhighlight>
sudo ufw allow 5010/tcp
sudo ufw allow 5011/tcp
</syntaxhighlight>
==== Check Logs ====
If you are experiencing problems with the installation or for any other reason, you can use the following command to examine the logs of the MDriven platform that you have configured. You can view the real-time logs in the terminal for both the MDriven Server and the MDriven Turnkey using the commands below:
'''MDriven Server:'''<syntaxhighlight>
sudo tail -f /var/www/mdrivenserver/logs/MDrivenServerRollingDEBUG.txt
sudo tail -f /var/www/mdrivenserver/logs/MDrivenServerLogRollingERRORS.txt
</syntaxhighlight>
'''MDriven Turnkey:'''<syntaxhighlight>
sudo tail -f /var/www/mdriventurnkey/logs/TurnkeyServerLogRollingERRORS.txt
sudo tail -f /var/www/mdriventurnkey/logs/TurnkeyServerRollingDEBUG.txt
</syntaxhighlight>
Finally, use the following command to start MDriven Server and MDriven Turnkey services automatically after restarting the server.<syntaxhighlight>
sudo systemctl enable mdrivenserver.service
sudo systemctl enable mdriventurnkey.service
</syntaxhighlight>After successfully installing the MDriven Server: MDriven Turnkey successfully, you can start your career in modeling with MDriven.
The MDriven installation can also be served with Nginx as a Proxy Server. To learn more, also read: [[Documentation:Serving MDriven with Nginx Server as a Proxy|Serving MDriven using Nginx as a Proxy]]

Latest revision as of 06:30, 20 January 2025

This page was created by Stephanie@mdriven.net on 2024-11-14. Last edited by Edgar on 2025-01-20.

MDriven Installation on Ubuntu 24.04

MDriven empowers businesses and developers to build and manage applications faster and smarter through Model-Driven Development (MDD). It bridges the gap between business needs and technical execution, turning models into fully functional applications with ease.

With MDriven you can:

  • Accelerate development
  • Adapt quickly
  • Collaborate easily
  • Deploy anywhere
Step -1: Login to the Ubuntu Server via SSH.
ssh username@IP_Address -p Port_number

Connect via SSH to your server.

Step -2: Update Server.
sudo apt-get update
sudo apt-get upgrade
Step -3: Secure Server.
sudo apt-get install openssh-server fail2ban

SSH assault can be avoided by utilizing Fail2ban

Step -4: Install Packages and Libraries.

Install apt-transport-https

sudo apt-get install -y apt-transport-https

This ensures you can safely fetch packages, package metadata and add third-party repositories using HTTPS ensuring data integrity and privacy during downloads. Install the .NET SDK version 8.0 or Higher

sudo apt-get install -y dotnet-sdk-8.0

This contains the software development kit (SDK) for building and running applications using the .NET platform. What it does:

  1. It includes tools such as the .NET CLI(Command Line Interface), compilers, and build tools needed to develop, build, and publish .NET applications
  2. It also installs the .NET runtime
  3. Multi-Language Support - C#, F# and VB.NET4.Cross-Platform Development

Check that the install is successful

dotnet --list-runtimes

Install Nginx or Apache Server: Let's go with Nginx Server for now using the following command

sudo apt install nginx

You can verify if Nginx is running by checking its service status:

sudo systemctl status nginx

The output should show the service as "active (running)".

Step -5: Download MDriven Server from Official Site.

The command we get downloads files from the web. Use it to download the latest version of MDriven Server from the main site.

wget https://www.mdriven.net/PublicDownloads/MDrivenServerCoreLinux_20241219.zip

Notes:

  1. Double check the latest name of the MDriven Server .Zip compatible with Linux from the main site.
  2. Upon download, the downloaded .zip file will be located in your home root directory
Step -6: Create a directory in /var/www/html - Directory.
cd /var/www/html
sudo mkdir mdrivenserver

Unzip the files into the Directory (Change directory to your home directory using the command cd).

cd
sudo unzip MDrivenServerCoreLinux_20241219.zip -d /var/www/html/mdrivenserver

Notes: If the unzip utility is not installed, you can install it with:

sudo apt-get install -y unzip
Step -7: Download MDriven Turnkey Server from the Official Site.

The command we get downloads files from the web. Use it to download the latest version of MDriven Turnkey from the main site.

wget https://www.mdriven.net/PublicDownloads/MDrivenTurnkeyCoreLinux_20241219.zip

Notes:

  1. Double check the latest name of the MDriven Turnkey .Zip compatible with Linux from the main site.
  2. Upon download, the downloaded .zip file will be located in your home root directory
Step -8: Create a directory in /var/www/html - Directory.
cd /var/www/html
sudo mkdir mdriventurnkey

Unzip the files into the Directory (Change directory to your home directory using the command cd).

cd
sudo unzip MDrivenTurnkeyCoreLinux_20241219.zip -d /var/www/html/mdriventurnkey
Step -9: Create MDriven Server Service File.

We have to create a service file to MDriven Server. Let's create a service file 'mdrivenserver.service' in /etc/systemd/system.

sudo nano /etc/systemd/system/mdrivenserver.service

Add the following aspects to the newly created service file.

[Unit]
Description=MDriven Server Service
After=network.target
[Service]
WorkingDirectory=/var/www/html/mdrivenserver
ExecStart=/usr/bin/dotnet /var/www/html/mdrivenserver/AppCompleteGenericCore.dll -5010 - nohttps
Restart=always

KillSignal=SIGINT
SyslogIdentifier=mdriven-server
User=root
Environment=DOTNET_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMENTRY_MESSAGE=false

[Install]
WantedBy=multi-user.target
Step -10: Create MDriven Turnkey Service File.

We have to create a service file to MDrivenTurnkey. Let's create a service file 'mdriventurnkey.service' in /etc/systemd/system.

sudo nano /etc/systemd/system/mdriventurnkey.service

Add the following aspects to the newly created service file.

[Unit]
Description=MDriven Turnkey Server Service
After=network.target
[Service]
WorkingDirectory=/var/www/html/mdriventurnkey
ExecStart=/usr/bin/dotnet /var/www/html/mdriventurnkey/StreaminAppCoreWebApp.dll -port=5011 -nohttps –[remove the -nohttps while in production]
Restart=always
KillSignal=SIGINT

SyslogIdentifier=turnkey-server
User=root
Environment=DOTNET_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMENTRY_MESSAGE=false

[Install]
WantedBy=multi-user.target

Finally, set the root user's permissions for these service files.

sudo chmod 775 /etc/systemd/system/mdrivenserver.service
sudo chown root: /etc/systemd/system/mdrivenserver.service

sudo chmod 775 /etc/systemd/system/mdriventurnkey.service
sudo chown root: /etc/systemd/system/mdriventurnkey.service
Step -11: Run MDriven Server and MDriven Turnkey.
sudo systemctl start mdrivenserver.service
sudo systemctl start mdriventurnkey.service

Use the above commands to launch the instance of MDriven Server and MDriven Turnkey respectively. Then, use the following command to see the service's current status. Furthermore, the installation of MDriven Server and MDriven Turnkey was successful if they are shown as active.

sudo systemctl status mdrivenserver.service
sudo systemctl status mdriventurnkey.service

Now, you can access MDriven Server and MDriven Turnkey by entering the following URL respectively.

"http://<your_domain_or_IP_address>:5010"
"http://<your_domain_or_IP_address>:5011"

Ensure that these ports are open on the firewall using the following commands:

sudo ufw allow 5010/tcp 
sudo ufw allow 5011/tcp

Check Logs

If you are experiencing problems with the installation or for any other reason, you can use the following command to examine the logs of the MDriven platform that you have configured. You can view the real-time logs in the terminal for both the MDriven Server and the MDriven Turnkey using the commands below:

MDriven Server:

sudo tail -f /var/www/mdrivenserver/logs/MDrivenServerRollingDEBUG.txt
sudo tail -f /var/www/mdrivenserver/logs/MDrivenServerLogRollingERRORS.txt

MDriven Turnkey:

sudo tail -f /var/www/mdriventurnkey/logs/TurnkeyServerLogRollingERRORS.txt
sudo tail -f /var/www/mdriventurnkey/logs/TurnkeyServerRollingDEBUG.txt

Finally, use the following command to start MDriven Server and MDriven Turnkey services automatically after restarting the server.

sudo systemctl enable mdrivenserver.service
sudo systemctl enable mdriventurnkey.service

After successfully installing the MDriven Server: MDriven Turnkey successfully, you can start your career in modeling with MDriven.

The MDriven installation can also be served with Nginx as a Proxy Server. To learn more, also read: Serving MDriven using Nginx as a Proxy