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 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 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 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
App_Data/MDrivenServerOverride.xmlfile - Turnkey settings are now set in the
App_Data/TurnkeySettingsOverride.xmlfile 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
- 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.
