Upgrading from EPiServer Composer 3.2.6 (CMS 5 R2 SP2) to EPiServer Composer 4.0 (CMS 6.0)

This document describes the procedure when upgrading from EPiServer Composer 3.2.6 (CMS 5.2.375.236) to EPiServer Composer 4.0 (CMS 6.0.530.0).

Upgrading to EPiServer Composer 4.0

1. Install EPiServer CMS 6.0.530.0.
     
2. Install EPiServer Composer 4.0.
    
3. Open EPiServer Deployment Center, select "Upgrade site with SQL Server database" and click "Run", to upgrade your site from EPiServer CMS 5.2.375.236 to EPiServer CMS 6.0.530.0.
    
   
     
   Your site is now upgraded to EPiServer CMS 6.0.530.0.
    
4. Select "Upgrade to EPiServer Composer 4.0" and click "Run", to upgrade from Composer 3.2.6 to Composer 4.0.
    
   
     
5. Select "Module Files" and click "Next". This will copy all the new Composer 4.0 application files to your site.
   
   
    
6. Select the site you just upgraded to EPiServer CMS 6.0.530.0, then click "Install".
    
   
     
7. Click "Close" when the installation process is finalized, and close the EPiServer Deployment Center.
     
8. If your site has any dll in the bin directory that depends on Dropit.Extension.dll or Dropit.Extension.UI.dll version 3.2.6, you need to rebuild the dll to reference to the new version 4.0 of Dropit.Extension.dll and Dropit.Extension.UI.dll.
    
   Example: if your site has EPiServer.ComposerSampleTemplates.dll residing in the bin directory, and it is depending on the Dropit.Extension.dll version 3.2.6, you will need to rebuild this dll (rebuild the ComposerSampleTemplates.csproj project) to reference to the Dropit.Extension.dll version 4.0.
    
9. Set the ExtensionDataPageId in the web.config file to the ID of the [Extension data Container] page on your site.
   
   <configuration>
...
<episerverModules>
<composer extensionDataPageId="3"
editGlobalFunctionPageId="" />
</episerverModules>
</configuration>
    
10. In Admin mode, go to Tools/Import Data to import the new EPiServer Composer 4.0 page and page type used for editing a global function.
    
    
     
    In the field " Select an export file and upload", browse to the "<Your Program Files folder>\EPiServer\CMS\6.0.530.0\Install\Modules\Composer 4.0\Dropit\Plugin\Extension\Setup\Composer4.Upgrade.episerverdata" file.
    
    In the field "Select page destination", select the [Extension data Container] page. You can select any page on your site but it is recommended to use the [Extension data Container] page.
    
    Click "Begin" Import to start importing data.
     
11. In Edit mode, note the ID of the recently imported page [Extension global function edit]. This will be used in the next step.
     
    
     
12. Set the editGlobalFunctionPageId in the web.config file to the ID of the [Extension global function edit] page on your site.
    
    <configuration>
...
<episerverModules>
<composer extensionDataPageId="X"
editGlobalFunctionPageId="X" />
</episerverModules>
</configuration> 
    The upgrading procedure is now completed.