Tips for updating Episerver

  • Updated

Below are some tips for upgrading Episerver 

  1. Look at the upgrade documentation, especially the breaking changes.

  2. Ensure your project is set to use the correct .net version. For instance in Episerver version 11 .net 4.6.x or higher is needed or the upgrade will fail with an error like the following error. 

    Could not install package 'EPiServer.CMS.Core 11.3.0'. You are trying to install this package into a project that targets '.NETFramework,Version=v4.5.2', but the package does
    not contain any assembly references or content files that are compatible with that framework. For more information, contact the package author.

  3. Check out the dependencies of your packages in the package manager UI(Tools > Nuget Package Manager > Manage Nuget Packages for Solution). It is especially important to verify the packages dependent on EPiserver.CMS.Core. The dependency version range can be used to see which packages require updating.

    With new releases there may be many add-ons that have not been updated to work with the package you are updating making it crucial to identify those packages before the upgrade. If the add-ons are not required, you can uninstall them.

    Before removing packages read this KB so subsequent deployments are successful.

  4. When you are ready to update, run the following command in the Package Manager Console. 

    update-package PackageName

    Additional Nuget Update Info

  5. If you receive incompatibility errors such as the following, examine the dependencies as recommended in step 3. 

    update-package : Unable to resolve dependencies. 'EPiServer.CMS.UI.Core 11.2.0' is not compatible with 'EPiServer.Marketing.Testing 2.4.4

    In the above case I uninstalled that package as it was not needed and proceeded with the upgrade.

  6. Remember to run the Update-EPiDatabase command before debugging.