New Post: Manual Upgrade 4.1 -> 4.2

Important: The guide below is for the technically well-informed “DIY” people out there. We suggest you consider one of two other options before you proceed with a manual upgrade.

If you need to upgrade a commercial website and want professional automatic tooling and support, go to http://www.composite.net/Plans-and-Pricing - the money your client pay here is used to fund further open source development, so that’s excellent!

If you are upgrading a private, community related or otherwise non-profit (volunteer based) website, send a mail to maw@composite.net with the Installation ID (C1 Console – Help | About Composite C1) and the URL of your site. And we’ll probably give you the automated stuff for free and all!

If you proceed with the guide below, please read it through first so you are familiar with the tools and steps needed to complete.

Requirements

C1 4.2 uses PhantomJS for function preview, this feature may not work/appear disabled on some hosting environments.

1. Preparation

Download a clean 4.2 website ( https://compositec1.codeplex.com/downloads/get/843518 )

If any of the packages listed below are installed on your 4.1 website, setup the clean 4.2 website instance with the "Bare bones" option, and install the same packages.

Composite.Community.EventCalendar
Composite.Community.Newsletter
Composite.Search.SimplePageSearch
Composite.Media.FileDownloadTracker
Composite.Versioning.ContentVersioning
prointernet/Composite.Grid

2. Download and save to the root of the 4.1 website the following filehttp://docs.composite.net/Downloads/UpgradeFiles/4.2/Update41.aspx
, afterwards and execute it by accessing by url (http :// your website url /Update41.aspx)

If executed successfully, delete the file.

3. Stop the site on IIS

4. Apply the following config changes

Edit /App_Data/Composite/Composite.config

Remove the following elements:

Configuration/Composite.C1Console.Elements.Plugins.ElementProviderConfiguration/ElementProviderPlugins/add[@name='LogElementProvider']

Configuration/Composite.Core.Parallelization.Plugins.ParallelizationProviderConfiguration/Parallelization/add[@name='XsltBasedFunction. Parameters evaluation']

Configuration/Composite.Core.Parallelization.Plugins.ParallelizationProviderConfiguration/Parallelization/add[@name='XsltBasedFunction. Function calls evaluation']

Configuration/Composite.Core.Parallelization.Plugins.ParallelizationProviderConfiguration/Parallelization/add[@name='Functions. Executing nested function calls']

Configuration/Composite.Core.Parallelization.Plugins.ParallelizationProviderConfiguration/Parallelization/add[@name='PageRenderer. Embedded function execution']

Add the following <add /> element

<configuration>
 <Composite.C1Console.Forms.Plugins.UiControlFactoryConfiguration>
  <Channels>
   <Channel>
    <Namespaces>
       <Namespace name='http://www.composite.net/ns/management/bindingforms/std.ui.controls.lib/1.0'>
         <Factories>
            ....
           <add userControlVirtualPath="~/Composite/controls/FormsControls/FormUiControlTemplates/Selectors/FontIconSelector.ascx" cacheCompiledUserControlType="true" type="Composite.Plugins.Forms.WebChannel.UiControlFactories.TemplatedFontIconSelectorUiControlFactory, Composite" name="FontIconSelector" />
         </Factories>  

Edit \web.config

If there're references to Razor v2.0 assemblies and replace them with references to Razor v3 assemblies:

Old assemblies
System.Web.Helpers, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35
System.Web.WebPages, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35
System.Web.WebPages.Razor, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35

New assemblies
System.Web.Helpers, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35
System.Web.WebPages, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35
System.Web.WebPages.Razor, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35

Update type/assembly references in the following config files as well:
"\App_Data\PageTemplates\web.config"
"\App_Data\Razor\web.config"

Old type reference
System.Web.WebPages.Razor.Configuration.RazorWebSectionGroup, System.Web.WebPages.Razor, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35

System.Web.WebPages.Razor.Configuration.RazorPagesSection, System.Web.WebPages.Razor, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35

New type references:
System.Web.WebPages.Razor.Configuration.RazorWebSectionGroup, System.Web.WebPages.Razor, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35

System.Web.WebPages.Razor.Configuration.RazorPagesSection, System.Web.WebPages.Razor, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35

5. Merge the files:

On the 4.1 instance delete the following folders:

\Composite\controls\
\Composite\images\
\Composite\skins\
\Composite\styles\
\Composite\templates\


Copy and replace the following files and folders (including sub folders):

\bin
\Composite
\Renderers
\App_Data\Composite\PhantomJs
\App_Data\Composite\TreeDefinitions\ServerLog.xml
\Frontend\Config\VisualEditor\Styles\core.css
\default.aspx

6. Start the website on IIS