Documentation:Migrating From MDriven .NET Framework to .NET Core

Migrating From MDriven .NET Framework to .NET Core

This page was created by Charles on 2024-12-04. Last edited by Wikiadmin on 2026-09-12.

Migrating from .NET framework to .NET Core provides a multitude of advantages that can significantly enhance you application's performance, scalability and deployment flexibility.

NOTE: Make sure you using the latest MDriven Designer for Model projects and the Latest MDriven Visual Studio extension for Visual Studio Model projects from the MDriven Downloads page https://mdriven.net/App#/Downloads.

1. Back Up Your App Data and User Data[edit source]

Before starting any migration, the first important thing to do is backing up your MDriven Application.

Follow this guide here MDriven Backup & Restore Guide for more details on how to backup your application and user data.

2. Upgrading your MDriven Project[edit source]

This step is only important for Visual Studio projects targeting .Net framework, change the target framework for your project to .NET Core (.NET 8 or .NET 9 is fine) and make sure your project is able to compile with no errors.

Check the link here How To Create a .NET Core MDriven Project for more information on Creating a .NET Core MDriven Project.

3. Preparing your Hosting Environment[edit source]

IIS[edit source]

Check the link here Deploying MDriven Server & Turnkey Core on IIS for details on hosting MDriven Server and Turnkey Core on IIS

Azure[edit source]

If MDriven is running on Azure, then use this page - Installing MDriven Server and Turnkey on Microsoft Azure - to setup the latest MDriven Turnkey and Server on Azure.

4. What Is New in MDriven Server & Turnkey Core App Settings[edit source]

Credentials for connecting to the MDriven Server within the Turnkey app are now in the App_Data/MDrivenServerOverride.xml file
Turnkey settings are now set in the App_Data/TurnkeySettingsOverride.xml file to ensure there are not lost on app upgrade.
App_Data/CommandLineOverride.xmlfile is now needed and should be configured for both the MDriven Server and MDriven Turnkey. it contains command line argument configurations the applications should start with. The Url for the application is specified in this file and it points iis to your application if hosting with iis.

5. Restoring Your App[edit source]

Follow the steps from this link here MDriven Backup & Restore Guide to restore your application data.

In case Turnkey is blocked from connecting, use PwdReset to set new password for user a.