Views: 13590
Number of votes: 0
Average rating:

EPiServer CMS R2 Upgrade experience

Early this morning we took on the task of upgrading http://world.episerver.com to latest release of EPiServer CMS R2, with the motto that we should run our own web sites on the latest release of EPiServer CMS. Usually people in the community wait untill the first Hotfix or Service Pack is relased before considering an upgrade, I like that strategy too.
But I'm damned if I do and doesn't get paid if I don't... :-)

Joking aside, I thought I share some experiences. There are several breaking changes, and this time it breaks! From breaking changes document:

  • DataFactory.GetPage method does no longer give an Unauthorized Exception when loading an page that the current user does not have access to.
  • EPiServer.Core.IPageStore has been removed.
  • EPiServer.DataFactory no longer implement EPiServer.Core.IPageStore, EPiServer.Core.IPageStoreStatistics.

A long story short; You have a problem if you are using EPiServer.Security.AccessLevel in your GetPage() methods. For example DataFactory.Instance.GetPage(blogStart.ParentLink, AccessLevel.NoAccess);
This will give a "method not found exception". So before doing the actual upgrade you need a plan.

 

Test

Plan for worst case scenario and how to deal with it. If there is an error in the upgrade process make sure you can rollback, Don't put all eggs in one basket.

Be prepared is the road to sucess, and test is the key. Have as identical copy as possible of your live web site. Install the new Installation manager and do a test upgrade. Usually the upgrade is done in 5 sec without problem.

Create a checklist

I made a small checklist with all the major components that we have at the episerverworld web site,

  • Forum (original from demo templates, then customized by Research)
  • Blog (from demo templates)
  • download,
  • Developer support form and webservices,
  • CRM connector
  • Custom Scheduled jobs
  • Buglist
  • External modules
  • etc.

Then test the functionallity of your web site and check of that your components work.
We had to recompile Blog and Forum eventhandlers, blog syndication scheduled job among other things due to the breaking change in IPageStore.GetPage().
There were a few external modules from EPiMore Partners that we had to remove untill they are R2 compatible. We also use EPiServer.Blog.dll from the demo templates which is not yet R2 ready. It will be released soon as I wrote in the developer forum, however I'm fortune to have access to the source code so in this case I could just check out and recompile needed assemblies.

 

The actual upgrade

I usually do not like reading documents like installation instructions, system requirements and breaking changes. I think I'll manage anyway, well this morning I was doomed.

First of, you need .net 3.5 SP1 for the new manager to install. That will take about 10 minutes. A nice coffee break.
Then you can install the manager. I choosed to install the necessary application files and then restart the server (I had too).

Finally now to upgrade. Start up the manager click upgrade from SP2 to R2 (where is sp3?). Found the bug "#14916 Cannot upgrade when site is installed in different volume than the installation manager".
Meaning, the website must be in the same volume as the manager. Also you cannot choose in which volume to install the manager, it will take the "program files" path.
Solution, Install a new SP2 site with the old manager in same volume, copy over our sitefiles and hook up the database. Then upgrade. ->Success! :-)

Post upgrade items

Open your checklist and test everything again.
Check that your scheduled jobs are working. Since the services were moved and reinstalled.
If you have custom things in Util or UI folder make sure they are at the new place (Virtual path folder, e.g. C:\Program Files\EPiServer\CMS\5.2.375.7\application\UI).

If you want you can clean up your bin folder from obsolete episerver assemblis as well the redirects in web.config

  • EPiServer.WebParts.dll
  • EPiServer.Workflows.UI.dll
  • EPiServer.ContentChannelService.dll
  • EPiServer.SchedulerSvc

 

Conclusion

Despite the breaking changes the development team has done a great job with this release and the new installer. There are several benefits of upgrading your site to the second editon of EPiServer CMS 5. New functionallity described in articles by Roger Wirz and Lena Spegel, as well as several blog posts on the subject.

Just don't take the upgrade lightly, its more work and changes than upgrading between service packs.

Oct 01, 2008

lena.spegel
(By lena.spegel, 9/21/2010 12:32:18 PM)

Just want to add that as Web master of the site, I have the feeling when I am working in the Edit and Admin Mode, that it's even faster than when runned at EPiServer CMS 5 R1 :-)

(By , 9/21/2010 12:32:18 PM)

Great post. Thanks Per.

rene
(By rene, 9/21/2010 12:32:19 PM)

Thanks Per, found som more pre R2 assembly redirects in the web.config: - EPiServer.Scheduler.WKTL - EPiServer.LogService - EPiServer.IndexingService - ElektroPost.Win32 I guess they can be safely removed as well? /René

rene
(By rene, 9/21/2010 12:32:19 PM)

Please call me René

Per Hemmingson
(By Per Hemmingson, 9/21/2010 12:32:19 PM)

Hi there, EPiServer.Scheduler.WKTL shall stay. The rest can be removed.

Guest
(By Guest, 9/21/2010 12:32:19 PM)

First upgrade to 5.1 sp 3 with the old manager(This may require to uninstall some services. I got an error about this. Solved by uninstalling the new manager, upgrade and reinstall the new manager) Take backup of files and database at this step to be sure... Install the new episerver manager if you haven't upgrade (I got an error about an index in the database that needed to be removed. Index was probably some developer error. This aborted the database upgrade while the files had been upgraded. Had to copy files from last step to be able to remove index and redo) recompile solution (I got some urlrewriteprovider error before recompile) Small codechange for xform that needed to be fixed (pageId no longer supported for this object...changed to pageguid) Voila! New version installed... Please fix that service error and also that files are rolled back if database upgrade fails...
/ Daniel

Jørgen Stav Helgheim
(By Jørgen Stav Helgheim, 9/21/2010 12:32:19 PM)

Great post! I have an addition: The full list of obsolete episerver assemblies are: bin/ElektroPost.Win32.dll bin/EPiServer.ContentChannelService.dll bin/EPiServer.IndexingService.exe bin/EPiServer.LogService.exe bin/EPiServer.SchedulerSvc.exe bin/EPiServer.WebParts.dll bin/EPiServer.WorkflowFoundation.UI.dll Delete corresponding assembly bindings in web.config. You can also delete the files: bin/EPiServer.IndexingService.exe.config bin/EPiServer.LogService.exe.config

Mahesh Mohan
(By Mahesh Mohan, 5/19/2011 11:59:57 AM)

Hi .. after recompiling i came accross an error saying Field not found: 'EPiServer.Global.UrlRewriteProvider'.
Please could somebody help me in resolving this error.

Please login to comment.