Views: 3275
Number of votes: 5
Average rating:

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
( By Quan Mai, 7/3/2014 4:36:31 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
( By K Khan, 7/3/2014 11:32:03 AM)

Many thanks Quan, for this addition.

K Khan
( By K Khan, 7/25/2014 1:01:47 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
( By K Khan, 8/4/2014 2:36:44 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
( By Johan Book, 11/3/2014 2:45:55 PM)

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

K Khan
( By K Khan, 11/3/2014 3:43:41 PM)

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

Please login to comment.