A critical vulnerability was discovered in React Server Components (Next.js). Our systems remain protected but we advise to update packages to newest version. Learn More


Mar 23, 2010
  20229
(2 votes)

How to Upgrade an EPiServer CMS 5 Site to CMS 6

The EPiServer Deployment Center can be used to upgrade an EPiServer CMS 5 R2 SP2 site to CMS 6.  The upgrade process is quite simple and converts the site content, settings, and form data, in place, from the old format to the new.  The upgrade process upgrades the EPiServer user interface, assemblies, and converts database objects and data as needed. 

If you have multiple sites, each site can be upgraded one at a time as long as they are in separate CMS instances / databases.  If you are running an enterprise configuration where multiple sites are managed from the same CMS instance / database, all of the sites will be upgraded at the same time.

The EPiServer Deployment Center will take care of upgrading the content and the EPiServer components, but it is strongly recommended that you thoroughly test your Page Templates, Dynamic Content, Plug-ins, and any other modules that reference the EPiServer API or web services to ensure that there are no compatibility issues with the latest version.

For more details on what the upgrade process does, check out Per Bjurström’s blog entry, Upgrading to CMS 6 RC1.

Upgrading an EPiServer CMS 5 R2 SP2 site to CMS 6.0

The image below depicts the CMS 5 R2 SP2 site prior to the upgrade.

image

1. Launch the EPiServer Deployment Center.

2. Navigate the tree to Installed Products > EPiServer CMS > Version 6.0.530.0.

3. Select Upgrade Site with SQL Server database. 

4. Click the Run button.

image

5. On the Upgrade an existing EPiServer web site – Step 1 of 2 dialog, select the CMS 5 site that you wish to upgrade.

image

6. Click the Next button.

7. Verify your settings on the Upgrade an existing EPiServer web site – Step 2 of 2 dialog, and click the Upgrade button.

image

8.  The EPiServer Deployment Center progress dialog will be displayed showing the progress of the upgrade. Click the Close button when it has finished.

image

9.  Close the EPiServer Deployment Center.

10. Clear your temporary internet files as many of the Edit and Admin Mode images from CMS 5 will be cached in Internet Explorer.

image

11. Navigate to the upgraded site to verify the upgrade.

image

Mar 23, 2010

Comments

Jeff Wallace
Jeff Wallace Sep 21, 2010 10:33 AM

Nice and simple process. :)

Sep 21, 2010 10:33 AM

Hi,

In Step 7 I get an this error on the Database Settings:
Database Name : Error {Namespace prefix 'epi' is not defined.}
Database Server Name : Error {Namespace prefix 'epi' is not defined.}

Does anybody got an idea what the error is trying to tell me?

Thanks!

Tommy.Bryntse@creuna.se
Tommy.Bryntse@creuna.se Sep 21, 2010 10:33 AM

Will this work with a "EPiServer CMS 5 SP3" site too?

Stephan Lonntorp
Stephan Lonntorp Oct 25, 2010 03:59 PM

I also get the Database Name : Error {Namespace prefix 'epi' is not defined.} error, does anyone know how to resolve it? Mark, did you get around it somehow?

Stephan Lonntorp
Stephan Lonntorp Oct 25, 2010 04:18 PM

I had an error in my web.config, so the site wouldn't start. So I guess the "Database Name : Error {Namespace prefix 'epi' is not defined.}" error message is trying to tell me that I need to check that the original site is working before I expect the upgrade process to work.

Please login to comment.
Latest blogs
Building simple Opal tools for product search and content creation

Optimizely Opal tools make it easy for AI agents to call your APIs – in this post we’ll build a small ASP.NET host that exposes two of them: one fo...

Pär Wissmark | Dec 13, 2025 |

CMS Audiences - check all usage

Sometimes you want to check if an Audience from your CMS (former Visitor Group) has been used by which page(and which version of that page) Then yo...

Tuan Anh Hoang | Dec 12, 2025

Data Imports in Optimizely: Part 2 - Query data efficiently

One of the more time consuming parts of an import is looking up data to update. Naively, it is possible to use the PageCriteriaQueryService to quer...

Matt FitzGerald-Chamberlain | Dec 11, 2025 |

Beginner's Guide for Optimizely Backend Developers

Developing with Optimizely (formerly Episerver) requires more than just technical know‑how. It’s about respecting the editor’s perspective, ensurin...

MilosR | Dec 10, 2025