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

Migrating From MDriven .NET Framework to .NET Core

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

NOTE: Make sure you are 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 to back up your MDriven Application.

Follow this guide here MDriven Backup & Restore Guide for more details on how to back up 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 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 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 - Installing MDriven Server and Turnkey on Microsoft Azure - to set up 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 App_Data/MDrivenServerOverride.xml file
Turnkey settings are now set in the App_Data/TurnkeySettingsOverride.xml file to ensure they are not lost on app upgrade.
App_Data/CommandLineOverride.xml file is now needed and should be configured for both the MDriven Server and MDriven Turnkey. It contains command line argument configurations that 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 MDriven Backup & Restore Guide to restore your application data.

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