Upgrading can seem daunting due to its comprehensive nature and the numerous steps involved, but it’s worthwhile. We promise!
The following post will contain a guide to walk you through everything you need to know about the upgrade process. We'll cover the essential steps, common pitfalls to avoid, and best practices to ensure a smooth transition to the latest version of Ucommerce.
We're here to help you!
Before you migrate
Before you begin the migration process. Here are a few things you should consider:
Contact us
When migrating it is crucial to get it right from the start. Therefore, We strongly recommend consulting one of our experts to review your specific needs to ensure a solid point of departure for a smooth transition.
Prerequisites
Before beginning, make sure you have the following installed:
-
.NET SDK 8
-
Latest Ucommerce 9 (for migrations only)
-
* Elastic Server 8.11.0 or newer.
-
* Docker
* When using the In-Process template, you can optionally use Docker. This eliminates the need for an SQL and Elastic Server on your machine.
Migration - let's do this!
Okay, so you're good to go. You have contacted us if you have any complex custom code and made sure you have all prerequisites in place.
1. Migrate your database
To begin, upgrade your database to the latest release of Ucommerce 9. If your setup already includes Ucommerce 9, you can simply update your Ucommerce package and restart your application to proceed.
For those using SQL Server, ensure that your database is set to a SQL Server compatibility level of at least 130 to guarantee smooth operation.
2. Install Ucommerce Next Gen with Templates
For an easy installation of Ucommerce Next Gen, we recommend using our ready-made templates. Details and download options can be found here.
After creating a new project with one of the templates, add your database connection string. Once set up, launch the project to automatically initiate the database migration.
Finally, visit the Ucommerce backoffice at /ucommerce
to confirm that your data has been successfully migrated.
3. Migrating custom logic
Start by identifying the custom-built components of your Ucommerce Classic solution. Key differences to be aware of include modifications in dependency injection, application setup, database access, and pipeline registration.
For more specific guidance on migrating custom logic, check out these articles from our documentation:
Developer love from Ucommerce ❤️
Ucommerce Next Gen equips your development team with cutting-edge frameworks, tools, and best practices, all built on the robust .NET 8 platform.
This adoption utilizes EF Core for optimized database management and superior data handling. Our commitment to the latest Microsoft technologies not only facilitates smoother integration and faster adoption but also allows for extensive customization of the UI with any logic you choose.
The platform's close alignment with .NET's own technologies enhances developer familiarity, significantly reducing project timelines and streamlining your upgrade process.
Happier developers mean more efficient projects!
Check out our product page for more insights.
Documentation
We hope we have sparked your interest with this guide on how to migrate from Ucommerce Classic to Ucommerce Next Gen.
To get an even more thorough overview of our e-commerce platform, you can find a list of helpful articles on our Documentation Site. If you are new to Ucommerce, we recommend you get started with a personal demo to show you how to grow your business with Ucommerce.
We'd love to hear from you
Our goal is to empower you with all the information you need to make informed decisions during your upgrade. However, if there are any questions left unanswered, or if you encounter unique challenges, don't hesitate to contact us. We are more than happy to discuss your specific needs and help you navigate the complexities of upgrading. Hit the button just below! 👇