HomeGuidesAPI ReferenceGraphQL
Submit Documentation FeedbackJoin Developer CommunityOptimizely GitHubOptimizely NuGetLog In

Migrate to CMS 12 / Commerce 14

How to migrate your project for use with Content Cloud (CMS 12) and Commerce Cloud (version 14).


Please complete other steps first!

This is Step 3: Upgrade the Service Environment from the topic Upgrading to Content Cloud (CMS 12).

You can use the Project Migration tab to move to a new project that supports .NET 6 for CMS 12 and Commerce 14. The migration can be done in a few steps, as explained below.

  1. Click Start Migration in the Project Migration tab to provision new project resources.

    This creates a new project that supports CMS 12 / Commerce 14 and is immediately accessible.



    It might take some time before the new project is visible in the Azure portal. Log out and log back in, or wait for a few minutes and it should show up automatically.


    VPN & Certificates

    If you are prompted with a warning regarding certificates and/or VPNs when you start a migration, please contact support to proceed.

    If you no longer need the target project after it is provisioned, you can delete the target project using Abort Migration.

  2. Start by setting up access for your deployment tooling by generating API keys so you can deploy the code packages and start testing it in the new environment.

  3. Deploy the updated code to the environment and validate that it works. Make sure you _add and configure _the EPiServer.CloudPlatform.Cms package as described here. Begin by setting up the Integration environment, then continue with Preproduction and Production to ensure it works there.

    • You can copy content from the source to the target project to ensure compatibility with the same data.
    • You can choose any environment as the source environment.
    • You can also copy content during the Go live step to ensure that you have the latest data when finalizing the migration to the new project
    • You can access more tools/logs for troubleshooting in the Azure portal
  4. Prepare Go live by copying the hostnames to the target project. In this step, the hostnames are prepared but not active.

    Some older hostnames may require new DNS verification records to work in the new project, which can be done during the following step.

  5. Click Check DNS records to verify the DNS record status after the records are added.

  6. The final step is to Go live. You can sync content from source to target project first. Pause the environments in the source project during this final phase. Each environment should be put into maintenance mode to prevent changes to data during the swap. When you enter maintenance mode, you cannot abort the migration until it is canceled.

    1. Maintenance mode – You can activate maintenance mode with Maintenance Page or by putting the source environment into Read Only mode. Read Only mode must be supported in the source project to use it. See database-mode documentation for information on implementation.

    2. Click Abort Maintenance Mode if you encounter a problem after entering the mode. After you activate maintenance mode, the environment is ready for Go live.


      Maintenance mode testing

      You must test maintenance mode and Go live on Integration and Preproduction before proceeding to Production because it may cause some downtime.

    3. After entering maintenance mode, click Go Live to make the environment live in the new project. You can click Cancel Go live if needed.

    4. After the Integration, Preproduct and Production environments are live, click Complete Migration. The resources in the source project are no longer needed and will be scheduled for decommissioning.

Did this page help you?