Upgrade to CMS 12
Optimizely Content Management System (CMS 12) was built to support ASP.NET Core and higher and is similar to CMS 11 to make upgrading as simple as possible. Upgrading to CMS 12 does not require a data migration, and most packages and APIs are identical, so you could upgrade from the NuGet Package Manager. You should complete the migration within one year or less of starting.
Note ASP.NET Core is different from .NET 4 in significant ways - including how configuration works, serialization, dependency injection, logging, and other important differences - so before you upgrade, see Why upgrade to CMS 12? and related topics. See also Upgrade to ASP.NET Core and About .NET
At a high level, the migration has three main phases:
- Run the Upgrade Assistant. The Upgrade assistant is a dotnet tool from Microsoft that converts a .NET 4 codebase to ASP.NET Core. Optimizely extended the tool specifically for CMS with additional rules and code fixes.
dotnet tool install -g upgrade-assistant
upgrade-assistant upgrade [projectName].csproj- Fix code issues. The Upgrade assistant handles many basic issues but usually leaves you with several remaining issues depending on the codebase. Fixing remaining code issues might be trivial, or it might not. For example, you may depend on other .NET 4 components that do not support ASP.NET Core, where you need to find replacements or live without those components. You may have a lot of .NET 4 code of your own to upgrade which the Upgrade assistant cannot help you with. You may depend on deprecated Optimizely packages. The Breaking changes in CMS 12 can help you figure out where you may need to do some work. You could also run the Upgrade assistant to see what you are left with.
- Upgrade the service environment. After the codebase is upgraded to ASP.NET Core, and everything works locally, DXP customers must migrate their service environment to the latest version using the migration tool available in the portal.
- While using the migration tool in the portal in step 3, make sure you have either:
- Migrated all hostnames from the previous project to your new CMS 12 project using the migration tool provided.
Note You should not manually recreate hostnames you want to move from the old project to the new one.
- Deleted unused hostnames from your old project that you do NOT want to move over to the new one. To complete the migration, all hostnames must be migrated to the new CMS 12 project.
- Click Complete Migration to complete the process!
Important When you finish migrating the last environment from CMS 11 to CMS 12 and move all hostnames to the target project, CMS keeps the CMS 11 environment for 14 days after the last go-live. A notification lets you extend this time by clicking Need More Time?
