Try our conversational search powered by Generative AI!

K Khan
Jul 2, 2014
(5 votes)

EPiServer Commerce Upgrade strategy (in light of ECRP)

To move with the speed of EPiServer after the introduction of EPiServer Continuous Release Process, it is vital to have stories/tasks during project life cycle and after the delivery. Here is an example upgrade strategy


Keep the backup of following elements before starting upgrade.
Complete Website (including packages and all other related folders) and Commerce Manger.
Keep the Copy of Files under Application Base Data also.
Path can be found from EPiServereFramework.config <appData basePath=""/>
Databases (CMS and MC both)



*Do not install latest version of CMS first, as there are chances that latest cms version is not compatible with latest commerce at that time. Commerce Package will install its dependencies including latest CMS changes also.
Install EpiServerCommerce Latest version via Nuget Package Manager Console.
PM> Install-Package EPiServer.Commerce
In case something goes wrong
PM> Update-Package EPiServer.Commerce –Reinstall
To update database after upgrade
PM> update-epidatabase
To get scripts
PM> Export-EPiUpdates
If you are using configurations Transformation for config files then do not compile the project straightway otherwise config files like web.config will be over written. You will need to compare config files, and manually add change is transformation files. Following files can affect web.config, EPiServerFramework.config, packages.config, episerver.config or files under Config folder.

Commerce manager:

Create an Empty Project and Solution and add all commerce manager files into that project and run an upgrade.
Compare Bin files with the site.
I have to copy some files manually from Site to Commerce Manger after upgrade to Commerce 7.9.0 (EPiServer.Implementation, EPiServer.ImageLibrary, EPiServer.Enterprise, EPiServer.XForms and EPiServer.BaseLibrary)

Rollback Strategy:

Restore DB and Files from backup

UAT/Live Environments Strategy:
Keep the note of Configuration Changes.
Prepare EPiServer DB Script.
Deploy the site.
If you want to deploy those with octopus deploy:

Jul 02, 2014


Quan Mai
Quan Mai Jul 3, 2014 04:36 AM

We provide a project for Commerce Manager, so you don't have to.
It can be found here:

Unzip the contents of the Commerce Manager updater package to the web root of the Commerce Manager site, which means that the solution file contained in the package should be on the same level as web.config.

Go to the package manager console and make sure that the episerver feed is selected.If you have not done so already, NuGet detects that the referenced packages need to be restored, click the button to restore the packages.Now you can update the packages to the latest version.

Execute: update-package EPiServer.CommerceManager.Build the solution.

Optionally, open the bin folder of the Commerce Manager site and remove the RemoveMePlease dummy assembly which was created when the solution was compiled.
You can also remove the files and folders that you unzipped (including the packages that NuGet downloaded into the Packages folder). For development projects it is recommended to keep the unzipped files around to make it easier to do subsequent updates.


K Khan
K Khan Jul 3, 2014 11:32 AM

Many thanks Quan, for this addition.

K Khan
K Khan Jul 25, 2014 01:01 PM

Don't forget to delete Virtual Directory 'Apps' from your commerce manager application in IIS. As Apps will be located on base folder after upgrade and will contain upgrades(Thanks Richly)

K Khan
K Khan Aug 4, 2014 02:36 PM

In case if you get this type of Error after upgrading DB

System.Data.SqlClient.SqlException (0x80131904): Incorrect syntax near 'MERGE'. You may need to set the compatibility level of the current database to a higher value to enable this feature. See help for the SET COMPATIBILITY_LEVEL option of ALTER DATABASE.
Incorrect syntax near 'DELETED'.

See the post
John, have a fix.

Johan Book
Johan Book Nov 3, 2014 02:45 PM

So should Apps be included in the Commerce Manager .csproj? How about the magic folder App_GlobalResources?

K Khan
K Khan Nov 3, 2014 03:43 PM

Well, I have both folders included in my project and always copy these on other servers after an upgrade.

Please login to comment.
Latest blogs
From Procrastination to Proficiency: Navigating Your Journey to Web Experimentation Certification

Hey there, Optimizely enthusiasts!   Join me in celebrating a milestone – I'm officially a certified web experimentation expert! It's an exhilarati...

Silvio Pacitto | May 17, 2024

GPT-4o Now Available for Optimizely via the AI-Assistant plugin!

I am excited to announce that GPT-4o is now available for Optimizely users through the Epicweb AI-Assistant integration. This means you can leverag...

Luc Gosso (MVP) | May 17, 2024 | Syndicated blog

The downside of being too fast

Today when I was tracking down some changes, I came across this commit comment Who wrote this? Me, almost 5 years ago. I did have a chuckle in my...

Quan Mai | May 17, 2024 | Syndicated blog

Optimizely Forms: Safeguarding Your Data

With the rise of cyber threats and privacy concerns, safeguarding sensitive information has become a top priority for businesses across all...

K Khan | May 16, 2024