Local installation
    mNo edit summary
    (Added Edited template with July 12, 2025.)
     
    (20 intermediate revisions by 2 users not shown)
    Line 1: Line 1:
    {{Edited|July|12|2025}}
    == '''MDriven Installation on Ubuntu 24.04''' ==
    == '''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.
    Line 4: Line 5:
    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 46: Line 50:
    </syntaxhighlight>The output should show the service as "active (running)".
    </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:'''


    '''Step -5: Download MDriven Server from Official Site.'''
    # 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


     
    ===== Step -6: Create a directory in /var/www/html - 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>
    <syntaxhighlight>
    wget https://www.mdriven.net/downloads/mdrivenserver_xxxx.zip -O downloaded_file.zip
    cd /var/www/html
    </syntaxhighlight>-O downloaded_file.zip: Optional flag to rename the downloaded file
    sudo mkdir mdrivenserver
     
    </syntaxhighlight>Unzip the files into the Directory (Change directory to your home directory using the command cd).<syntaxhighlight>
     
    cd
    '''Step -6: Create a directory in /var/www/ - Directory.'''<syntaxhighlight>
    sudo unzip MDrivenServerCoreLinux_20241219.zip -d /var/www/html/mdrivenserver
    cd /var/www/
    sudo mkdir mdrivenserver [Choose a suitable of your preference]
    </syntaxhighlight>Unzip the files into the Directory<syntaxhighlight>
    sudo 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>'''Step -7: Download MDriven Turnkey Server from the Official Site.'''<syntaxhighlight>
    </syntaxhighlight>
    wget https://www.mdriven.net/downloads/mdriventurnkeyserver_xxxx.zip -O downloaded_file.zip
     
    </syntaxhighlight>'''Step -8: Create a directory in /var/www/ - Directory.'''<syntaxhighlight>
    ===== Step -7: Download MDriven Turnkey Server from the Official Site. =====
    cd /var/www/
    The command we get downloads files from the web. Use it to download the latest version of MDriven Turnkey from the main site.<syntaxhighlight>
    sudo mkdir mdriventurnkey [Choose a suitable name of your preference]
    wget https://www.mdriven.net/PublicDownloads/MDrivenTurnkeyCoreLinux_20241219.zip
    </syntaxhighlight>Unzip the files into the Directory<syntaxhighlight>
    </syntaxhighlight>
    sudo unzip downloaded_file.zip -d /var/www/mdriventurnkey
    '''Notes:'''
    </syntaxhighlight>'''Step -9: Create MDrivenServer Service File.'''
    # 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>


    We have to create a service file to MDrivenServer. Let's create a service file 'mdrivenserver.service' in /etc/systemd/system.<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
    sudo nano /etc/systemd/system/mdrivenserver.service
    </syntaxhighlight>Add the following aspects to the newly created service file.<syntaxhighlight>
    </syntaxhighlight>Add the following aspects to the newly created service file.<syntaxhighlight>
    Line 80: Line 96:
    After=network.target
    After=network.target
    [Service]
    [Service]
    WorkingDirectory=/var/www/mdrivenserver
    WorkingDirectory=/var/www/html/mdrivenserver
    ExecStart=/usr/bin/dotnet /var/www/mdrivenserver/AppCompleteGenericCore.dll -5010 - nohttps
    ExecStart=/usr/bin/dotnet /var/www/html/mdrivenserver/AppCompleteGenericCore.dll -5010 - nohttps
    Restart=always
    Restart=always


    Line 87: Line 103:
    SyslogIdentifier=mdriven-server
    SyslogIdentifier=mdriven-server
    User=root
    User=root
    Environment=ASPNETCORE_ENVIRONMENT=Production
    Environment=DOTNET_ENVIRONMENT=Production
    Environment=DOTNET_PRINT_TELEMENTRY_MESSAGE=false
    Environment=DOTNET_PRINT_TELEMENTRY_MESSAGE=false


    [Install]
    [Install]
    WantedBy=multi-user.target
    WantedBy=multi-user.target
    </syntaxhighlight>'''Step -10: Create MDrivenTurnkey Service File.'''
    </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>
    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
    sudo nano /etc/systemd/system/mdriventurnkey.service
    Line 101: Line 118:
    After=network.target
    After=network.target
    [Service]
    [Service]
    WorkingDirectory=/var/www/mdriventurnkey
    WorkingDirectory=/var/www/html/mdriventurnkey
    ExecStart=/usr/dotnet /var/www/mdriventurnkey/StreaminAppCoreWebApp.dll -port=5011 -nohttps –[remove the -nohttps while in production]
    ExecStart=/usr/bin/dotnet /var/www/html/mdriventurnkey/StreaminAppCoreWebApp.dll -port=5011 -nohttps –[remove the -nohttps while in production]
    Restart=always
    Restart=always
    KillSignal=SIGINT
    KillSignal=SIGINT
    Line 108: Line 125:
    SyslogIdentifier=turnkey-server
    SyslogIdentifier=turnkey-server
    User=root
    User=root
    Environment=ASPNETCORE_ENVIRONMENT=Production
    Environment=DOTNET_ENVIRONMENT=Production
    Environment=DOTNET_PRINT_TELEMENTRY_MESSAGE=false
    Environment=DOTNET_PRINT_TELEMENTRY_MESSAGE=false


    Line 119: Line 136:
    sudo chmod 775 /etc/systemd/system/mdriventurnkey.service
    sudo chmod 775 /etc/systemd/system/mdriventurnkey.service
    sudo chown root: /etc/systemd/system/mdriventurnkey.service
    sudo chown root: /etc/systemd/system/mdriventurnkey.service
    </syntaxhighlight>'''Step -11: Run MDriven Server and MDriven Turnkey.'''<syntaxhighlight>
    </syntaxhighlight>
    sudo systemctl start mdriven.service
     
    ===== Step -11: Run MDriven Server and MDriven Turnkey. =====
    <syntaxhighlight>
    sudo systemctl start mdrivenserver.service
    sudo systemctl start mdriventurnkey.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>
    </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 mdriven.service
    sudo systemctl status mdrivenserver.service
    sudo systemctl status mdriventurnkey.service
    sudo systemctl status mdriventurnkey.service
    </syntaxhighlight>Now, you can access MDriven Server and MDriven Turnkey by entering the following URL respectively<syntaxhighlight>
    </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>:5010"
    "http://<your_domain_or_IP_address>:5011"
    "http://<your_domain_or_IP_address>:5011"
    </syntaxhighlight>Finally, use the following command to start MDriven Server and MDriven Turnkey services automatically after restarting the server<syntaxhighlight>
    </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 mdrivenserver.service
    sudo systemctl enable mdriventurnkey.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
    </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

    Retrieved from "https://wiki.mdriven.net/index.php?title=Documentation:Local_installation&oldid=25797"

    © MDRIVEN . All Rights Reserved

    API Docs
    MDriven World | Portal | Blog | YouTube | StackOverflow | Facebook

    © MDRIVEN . All Rights Reserved