Don't miss out Virtual Happy Hour this Friday (April 26).
Don't miss out Virtual Happy Hour this Friday (April 26).
Product version: | Episerver Commerce 1 R2/1 R2 SP1 |
---|---|
Document last saved: |
This document describes the procedure for upgrading EPiServer Commerce from version 1 R2 to 1 R2 SP1. These instructions apply to a website with a working installation of EPiServer Commerce 1 R2. To upgrade from previous versions, refer to the information under Upgrading from Previous Versions below.
Check the following requirements and considerations before you start the upgrade:
STEP 1: Update configuration files
1. In the episerver.config file:
Add the following config to the episerver/virtualPath/providers section:
<add showInFileManager="false" virtualName="DynamicContentPreview" virtualPath="~/Edit/Dialogs/DynamicContentPreview.aspx" bypassAccessCheck="false" name="DynamicContentPreview" type="EPiServer.Web.Hosting.VirtualPathMappedProvider, EPiServer" />
Add the following configuration to the episerver/virtualPath/virtualPathMappings section (the uiUrl value can be found in episerver.config e.g. “uiUrl=~/epi/CMS”):
<add url="{uiUrl}/Editor/Dialogs/DynamicContentPreview.aspx" mappedUrl="~/Edit/Dialogs/DynamicContentPreview.aspx" />
2. In the web.config file of the EPiServer Commerce site:
Go to the section /configuration/episerver.shell/protectedModules:
Add
<add name="Commerce" resourcePath="~/modules/Commerce/"/>
Change
<add name="Shell">
<assemblies>
<add assembly="EPiServer.Business.Commerce.UI" />
</assemblies>
</add>
To
<add name="Shell" />
3. Update the content of Variation-Edit.xml, Product-Edit.xml and Bundle-Edit.xml:
Navigate to {ApplicationFolder}\<SiteName>\Shared\Apps\Catalog\Config\View (e.g C:\EPiServer\eCommerceFramework\5.2\CommerceR2Manager\Shared\Apps\Catalog\Config\View).
Change {ProductRelations:Tab_Label} to {SharedStrings:Product_Relations_Tab_Label}
4. In the web.config file of the Commerce Manager site:
Add the following to /configuration/system.webServer:
<httpProtocol>
<customHeaders>
<add name="X-UA-Compatible" value="IE=7" />
</customHeaders>
</httpProtocol>
5. Locate the web.config files in the following folders:
C:\EPiServer\Sites\<SiteName>,
{Application folder}\<Sitename>\Sites\B2CSampleSite
{Application folder}\<Sitename>\Sites\ConsoleSite
Example:
C:\EPiServer\Sites\ CommerceR2Manager
C:\EPiServer\eCommerceFramework\5.2\CommerceR2Manager\Sites\B2CSampleSite
C:\EPiServer\eCommerceFramework\5.2\CommerceR2Manager\Sites\ConsoleSite
In /configuration/Mediachase.RssNews/Items, change http://world.episerver.com/System/Site-footer/RSS/News/ to http://world.episerver.com/?feed=RSS
6. Locate the web.config files in the following folders:
C:\EPiServer\Sites\<SiteName>,
{Application folder}\<Sitename>\Sites\B2CSampleSite
Example:
C:\EPiServer\Sites\ CommerceR2Manager C:\EPiServer\eCommerceFramework\5.2\CommerceR2Manager\Sites\B2CSampleSite
In /configuration/system.web/authentication, change timeout="45" to timeout="4320"
7. Locate the appSettings.config files in the following folders:
C:\EPiServer\Sites\<SiteName>,
{Application folder}\<Sitename>\Sites\B2CSampleSite
Example:
C:\EPiServer\Sites\ CommerceR2Manager C:\EPiServer\eCommerceFramework\5.2\CommerceR2Manager\Sites\B2CSampleSite
In the appSetings section add:
<add key="EnableAdminSso" value="false" />
<add key="SsoSharedSecret" value="set shared secret here" />
8. Locate the ecf.catalog.config files in the following folders:
C:\EPiServer\Sites\<SiteName>\Configs,
{Application folder}\<Sitename>\Sites\B2CSampleSite\Configs ,
{Application folder}\<SiteName> \QuartzService\Configs
Example:
C:\EPiServer\Sites\ CommerceR2Manager \Configs
C:\EPiServer\eCommerceFramework\5.2\CommerceR2Manager\Sites\B2CSampleSite\Configs
C:\EPiServer\eCommerceFramework\5.2\CommerceR2Manager \QuartzService\Configs
Change [enable=”false”] to [enable=”true”] in the /Catalog/Cache tag.
STEP 2: Update the Database
Execute the scripts in the "Scripts" folder of the downloaded file package:
In ecf_db_SecuritySystem_update.sql: update $(EcfApplicationName) to <SiteName> (SiteName: Name of Commerce Manager site E.g CommerceR2Manager), and then execute.
STEP 3: Deploy Files
Get the following files from the downloaded file package:
STEP 4: Update the configuration
1. Update the web.config file of the EPiServer Commerce site:
Add the following configuration to the configuration/runtime section:
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="EPiServer.Business.Commerce" publicKeyToken="8fe83dea738b45b7" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="1.1.0.259" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="EPiServer.Business.Commerce.UI" publicKeyToken="8fe83dea738b45b7" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="1.1.0.259" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce" publicKeyToken="6e58b501b34abce3" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Marketing.Validators" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Plugins.Payment" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Plugins.Shipping" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Website" publicKeyToken="6e58b501b34abce3" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Workflow.Activities" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Workflow" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.ConsoleManager" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Search" publicKeyToken="6e58b501b34abce3" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Search.Extensions" publicKeyToken="6e58b501b34abce3" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Search.LuceneSearchProvider" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.WebConsoleLib" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
</assemblyBinding>
2. Update the web.config file of the EPiServer Commerce Manager site:
Add the following configuration to the configuration/runtime section:
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="EPiServer.Business.Commerce" publicKeyToken="8fe83dea738b45b7" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="1.1.0.259" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce" publicKeyToken="6e58b501b34abce3" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Marketing.Validators" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Plugins.Payment" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Plugins.Shipping" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Website" publicKeyToken="6e58b501b34abce3" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Workflow.Activities" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Commerce.Workflow" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.ConsoleManager" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Search" publicKeyToken="6e58b501b34abce3" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Search.Extensions" publicKeyToken="6e58b501b34abce3" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.Search.LuceneSearchProvider" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Mediachase.WebConsoleLib" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="5.2.377.1" />
</dependentAssembly>
</assemblyBinding>
3. Update the following in the web.config of the EPIServer Commerce site:
Search for:
<add name="ProfileModule" type="EPiServer.Business.Commerce.Sample.HttpModules.ProfileModule, EPiServer.Business.Commerce.Sample"/>
and replace with:
<add name="ProfileModule" type="EPiServer.Business.Commerce.HttpModules.ProfileModule, EPiServer.Business.Commerce "/>
STEP 1: Deploy Files
Get the following files from the downloaded file package:
NOTE the following:
<dependentAssembly>
<assemblyIdentity name="Mediachase.FileUploader" publicKeyToken="41d2e7a615ba286c" culture="neutral" />
<bindingRedirect oldVersion="1.0.0.0-65535.65535.65535.65535" newVersion="2.3.4174.28315" />
</dependentAssembly>