New Post: Manual upgrade 4.0 -> 4.1

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 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:

.NET 4.5 is required for running C1 4.1

1. Preparation

Download a clean 4.1 website (or 4.0) from CodePlex.

https://compositec1.codeplex.com/releases/view/114480

Stop the website on IIS.

2. Apply the file changes

Copy and replace the following files from the 4.1 instance to your website:

~\Bin\*.* (!!!! Except Composite.Generated.dll !!!!)
~\Composite\*.* (Just the files, not including the subfolders)
~\Renderers\*.*

~\Frontend\Config\VisualEditor\Styles\core.css

Delete the following folders on your website, and copy them from the 4.1 instance:

~\Composite\content\
~\Composite\controls\
~\Composite\help\
~\Composite\images\
~\Composite\localization\
~\Composite\scripts\
~\Composite\services\
~\Composite\styles\
~\Composite\templates\
~\Composite\transformations\

Copy ~\robots.txt if missing

4. Apply the config changes

1) Edit ~/App_Data/Composite/Composite.config

Add a new attribute

imageQuality="80"

to

/configuration/Composite.Core.Configuration.Plugins.GlobalSettingsProviderConfiguration/GlobalSettingsProviderPlugins/add

2) Edit ~/Web.config

Remove attribute

 /configuration/system.web/compilation/@targetFramework

Remove attribute

/configuration/system.web/pages/@controlRenderingCompatibilityVersion

Add a new attribute targetFramework="4.5" to

/configuration/system.web/httpRuntime

Add a new element to /configuration/system.web:

<httpHandlers>
  <add verb="GET" path="sitemap.xml" type="Composite.AspNet.SiteMapHandler, Composite" />
</httpHandlers>

Add a new http handler named "SiteMap" to /configuration/system.webServer/handlers:

<handlers>
    <add name="SiteMap" verb="GET" path="sitemap.xml" type="Composite.AspNet.SiteMapHandler, Composite" />
    <add name="Wildcard ASP.NET mapping" preCondition="classicMode,runtimeVersionv4.0,bitness32" path="*" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll" resourceType="Unspecified" requireAccess="None" />
    <add name="Wildcard ASP.NET mapping (x64)" preCondition="classicMode,runtimeVersionv4.0,bitness64" path="*" verb="*" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll" resourceType="Unspecified" requireAccess="None" />
    <add name="UrlRoutingHandler" preCondition="integratedMode" verb="*" path="UrlRouting.axd" type="System.Web.HttpForbiddenHandler, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
</handlers>

Finish: start the website on IIS