View source for Documentation:Migrating From MDriven .NET Framework to .NET Core

{{Edited|July|12|2025}}
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 ===

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

* Follow this guide here [[Documentation:MDriven Backup & Restore Guide|MDriven Backup & Restore Guide]] for more details on how to backup your application and user data.

=== 2. Upgrading your MDriven Project ===
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 [[HowTos:How To Create a .NET Core MDriven Project|How To Create a .NET Core MDriven Project]] for more information on Creating a .NET Core MDriven Project.

=== 3. Preparing your Hosting Environment ===

==== IIS ====

* Check the link here [[Documentation:Deploying MDriven Server & Turnkey Core on IIS|Deploying MDriven Server & Turnkey Core on IIS]] for details on hosting MDriven Server and Turnkey Core on IIS

==== Azure ====

* If MDriven is running on Azure, then use this page - [[Documentation:Installing MDriven Server and Turnkey on Microsoft Azure|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 ===
* Credentials for connecting to the MDriven Server within the Turnkey app are now in the <code><span class="col-black">'''App_Data/MDrivenServerOverride.xml'''</span></code> file
* Turnkey settings are now set in the <code><span class="col-black">'''App_Data/TurnkeySettingsOverride.xml'''</span></code> file to ensure there are not lost on app upgrade.
* <code><span class="col-black">'''App_Data/CommandLineOverride.xml'''</span></code>file 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 ===

* Follow the steps from this link here [[Documentation:MDriven Backup & Restore Guide|MDriven Backup & Restore Guide]] to restore your application data.
*
In case Turnkey is blocked from connecting, use '''[[Documentation:MDrivenServer, opening the built-in database|PwdReset]]''' to set new password for user '''a'''.


[[Category:Deprecation and migration strategies]]
[[Category:Intermediate-Friendly]]
[[Category:Priority 70]]
[[Category:Refactoring and Evolution]]