Upgrading 2.0 SP1 -> 2.1

Topics: General, Release notes
Mar 14, 2011 at 12:23 PM
Edited Mar 14, 2011 at 5:26 PM

The're two ways of performing this upgrade:

1) You can pay for upgrade package service, which gives you a package to do it automatically

    Video here http://www.youtube.com/watch?v=O8UH3pLq3l0

2) Or you can do the upgrade manually. You can find the list of changes to be done below.


Current upgrade steps for upgrading 2.0 to 2.1, and all the intermediate builds:

0. Create a backup

1. Download 2.1 files, f.e. "Visual Studio" version from http://compositec1.codeplex.com/releases/view/62388

2. Delete and copy it from 2.1 site the following files:







Delete file (if exists)"/Bin/Composite.MSSqlServer.dll"

3. Under "/Composite" folder delete everything except for folders "/Composite/InstalledPackages" and "/Composite/localization"

Copy files from "/Composite" in 2.1 version to "/Composite" in your site, overwrite files under "/localization"

4. Upgrading visual editor configuration

Delete "/Frontend/Styles/VisualEditor/"
Copy from 2.1 folder "/Frontend/Config/VisualEditor/"and file "/Frontend/Styles/VisualEditor.common.css"

NOTE: if you did any changes to visual editor's styles, you should apply them again

5. Edit "/App_Data/Composite/Composite.config"

*) Remove if exists node "configuration/exceptionHandling

*) Find node "/configuration/Composite.Core.Configuration.Plugins.GlobalSettingsProviderConfiguration/GlobalSettingsProviderPlugins/add[@name='ConfigBasedGlobalSettingsProvider']"
add the following attributes (if they're missing)





*) Under "configuration" node, add the following nodes, if they don't exist

<Composite.SetupConfiguration PackageServerUrl="https://package.composite.net" />


<Composite.Core.IO.Plugins.IOProviderConfiguration defaultIOProvider="LocalIOProvider">
            <add name="LocalIOProvider" type="Composite.Plugins.IO.IOProviders.LocalIOProvider.LocalIOProvider, Composite"/>

*) Under "/configuration/configSectionsAdd" the following node, if missing

<section name="Composite.Core.IO.Plugins.IOProviderConfiguration" type="Composite.Core.IO.Plugins.IOProvider.Runtime.IOProviderSettings, Composite" />

*) If node "/configuration/Composite.Data.Plugins.DataProviderConfiguration/DataProviderPlugins/add[@name='DynamicSqlDataProvider']" exists,

edit @type attribute, the value should be type="Composite.Plugins.Data.DataProviders.MSSqlServerDataProvider.SqlDataProvider, Composite"
*) Remove the following nodes 

/configuration/loggingConfiguration/listeners/add[@name='Tcp Custom Trace Listener']/configuration/loggingConfiguration/specialSources/allEvents/listeners/add[@name='Tcp Custom Trace Listener']


*) Under /configuration/loggingConfiguration/specialSources/allEvents[@name='All Events'] set @switchValue attribute to "Information"

6. Edit "/web.config"

*) If missing, add attribute optimizeCompilations="true" to "configuration/system.web/compilation"


Video demonstration here http://www.youtube.com/watch?v=4ckiF37P2yY

Mar 14, 2011 at 3:35 PM

Thank you for this detailed manual.

I will try this and do a blogpost (in german) about my first upgrade experience with c1 :-)


Mar 14, 2011 at 3:55 PM
Edited Mar 14, 2011 at 5:32 PM

Video-s are ready

Automatic upgrade http://www.youtube.com/watch?v=O8UH3pLq3l0

Manual upgrade: http://www.youtube.com/watch?v=4ckiF37P2yY

Mar 17, 2011 at 11:36 PM

> Current upgrade steps for upgrading 2.0 to 2.1, and all the intermediate builds:

> 0. Create a backup

What to backup and how?


Mar 17, 2011 at 11:48 PM

just backup your whole website directory in case anything goes wrong

Mar 24, 2011 at 4:44 PM
Edited Mar 24, 2011 at 4:45 PM

Right click website folder. Send to... Compressed Folder. Done.

Mar 24, 2011 at 4:46 PM

Simple as that :)

Mar 31, 2011 at 8:43 AM


Just tried to formalize manual migration in the form of the batch script....

Everything works ok, except all functions and media is gone.

Migration was tried on:

  1. our site and
  2. Omnicorp Demo
    1. got empty v2.0SP1 from zip
    2. configured site as Omnicorp, en, admin/tester

Migration process:

    1. in the folder containing Website and Solution file added directory with v2.1
    2. added Website\bat\migrate_20sp1_to_21.bat
    3. edit "/App_Data/Composite/Composite.config" according to step 5.
      in Composite_C1_VS2010_2.1.4087.22991_ReleaseBuild_20110311.2
      and  save it  Composite_C1_VS2010_2.1.4087.22991_ReleaseBuild_20110311.2\Composite.config
      script will copy it into destination folder...
      sorry didn't have enough time for sedding/awking.... 
    4. cd to Website\bat\
    5. start migrate_20sp1_to_21.bat
      migration script should be relative to this batch folder
    6. fire up cmd prompt as admin (Vista and robocopy issues with locks etc)
    7. press enter few times (debugging purposes!!) or remove pauses from script
    8. result in the folder with Website and solution file there is new Website_v21 folder
    9. open up solution file >  add existing website > Website_v21
    10. try it

We'll be back in few minutes, just seconds ago somthing fell on our brains..... 




script (migrate_20sp1_to_21.bat):


::echo off

:: stripping chars : .
set COPY=c:\bin\robocopy
::set ELEVATE=c:\bin\elevate

set ROOT=D:\SRC\HolisticWare\HolisticWare_Web_CMS_C1
set SOURCE=..\..\Website

set BACKUP=..\..\Website_v20sp1_%STAMP_USED%

explorer /e,/root,%ROOT%

:: -------------------------------------------------------------------------------
:: ROBOCOPY v 1.50  :  Robust File Copy for Windows 95  :  by kevina@microsoft.com
:: -------------------------------------------------------------------------------
::   Started : Wed Mar 30 11:08:53 2011
::              Usage : ROBOCOPY source destination [file [file]...] [options]
::             source : Source Directory (drive:\path or \\server\share\path).
::        destination : Destination Dir  (drive:\path or \\server\share\path).
::               file : File(s) to copy  (names/wildcards - default is "*.*").
:: options :       /S : copy Subdirectories, but not empty ones.
::                 /E : copy subdirectories, including Empty ones.
::                 /T : Timestamp all destination files, including skipped files.
::               /R:n : number of Retries on failed copies - default is 1 million.
::               /W:n : Wait time between retries - default is 30 seconds.
::               /REG : Save /R:n and /W:n in the Registry as default settings.
::                 /X : report all eXtra files, not just those selected.
::                 /V : produce Verbose output, showing skipped files.
::                 /L : List only - don't copy, timestamp or delete any files.
::   /A+:[R][A][S][H] : add the given Attributes to copied files.
::   /A-:[R][A][S][H] : remove the given Attributes from copied files.
::   /XA:[R][A][S][H] : eXclude files with any of the given Attributes
::                 /A : copy only files with the Archive attribute set.
::                 /M : like /A, but remove Archive attribute from source files.
:: /XF file [file]... : eXclude Files matching given names/paths/wildcards.
:: /XD dirs [dirs]... : eXclude Directories matching given names/paths.
::    /XC | /XN | /XO : eXclude Changed | Newer | Older files.
::          /XX | /XL : eXclude eXtra | Lonely files and dirs.
::                /IS : Include Same files.
::               /ETA : show Estimated Time of Arrival of copied files.
::              /MOVE : Move files and dirs (delete from source after copying).
::             /PURGE : delete dest files/dirs that no longer exist in source.


c:\bin\robocopy ^
	%SOURCE%\ ^
	%BACKUP%\ ^
	/E /MIR /R:5 /W:5 /X /V /XD .svn
dir /s %SOURCE%
dir /s %BACKUP%
:: xcopy ^
:: 	%SOURCE%\*.* ^
:: 	%BACKUP%\ ^
:: 	/s /e /v /i /h /r /o /y /exclude:svn
set SOURCE=..\..\Composite_C1_VS2010_2.1.4087.22991_ReleaseBuild_20110311.2\Website\

dir %BACKUP%\Bin\Composite.dll
dir %BACKUP%\Renderers\FileNotFoundHandler.ashx
dir %BACKUP%\Renderers\Page.aspx
dir %BACKUP%\Renderers\ShowMedia.ashx
dir %BACKUP%\Global.asax

del /f %BACKUP%\Bin\Composite.dll
del /f %BACKUP%\Renderers\FileNotFoundHandler.ashx
del /f %BACKUP%\Renderers\Page.aspx
del /f %BACKUP%\Renderers\ShowMedia.ashx
del /f %BACKUP%\Global.asax

c:\bin\robocopy ^
	%SOURCE%\Bin\ ^
	%BACKUP%\Bin\ ^

c:\bin\robocopy ^
	%SOURCE%\Renderers\ ^
	%BACKUP%\Renderers\ ^
	FileNotFoundHandler.ashx ^
	Page.aspx ^

c:\bin\robocopy ^
	%SOURCE%\ ^
	%BACKUP%\ ^
del /f %BACKUP%\Bin\Composite.MSSqlServer.dll

echo ---------------------------------------------------------------------------
echo 3.
echo Under "/Composite" folder delete everything except for folders 
echo              "/Composite/InstalledPackages" and 
echo              "/Composite/localization"
echo Copy files from "/Composite" in 2.1 version to "/Composite" in your site, 
echo  overwrite files under "/localization"

echo backing up InstalledPackages and localization in \Composite

move /y ^
	%BACKUP%\Composite\InstalledPackages ^
move /y ^
	%BACKUP%\Composite\localization ^
rd /q /s %BACKUP%\Composite
mkdir %BACKUP%\Composite

move /y ^
	%BACKUP%\InstalledPackages ^
move /y ^
	%BACKUP%\localization ^
dir %BACKUP%\Composite

echo Copy files from "/Composite" in 2.1 version to "/Composite" in your site, 
echo overwrite files under "/localization"

c:\bin\robocopy ^
	%SOURCE%\Composite ^
	%BACKUP%\Composite ^
	/MIR /R:5 /W:5 /X /V

dir %BACKUP%\Composite

echo ---------------------------------------------------------------------------
echo 4. Upgrading visual editor configuration
echo Delete "/Frontend/Styles/VisualEditor/"

dir %BACKUP%\Frontend\Styles\
rd /q /s %BACKUP%\Frontend\Styles\VisualEditor\
dir %BACKUP%\Frontend\Styles\

echo Copy from 2.1 
echo        folder "/Frontend/Config/VisualEditor/" and 
echo        file "/Frontend/Styles/VisualEditor.common.css"

dir	%BACKUP%\Frontend\Config\VisualEditor
c:\bin\robocopy ^
	%SOURCE%\Frontend\Config\VisualEditor ^
	%BACKUP%\Frontend\Config\VisualEditor ^
	/MIR /R:5 /W:5 /V
dir	%BACKUP%\Frontend\Config\VisualEditor

dir %BACKUP%\Frontend\Styles\
c:\bin\robocopy ^
	%SOURCE%\Frontend\Styles\ ^
	%BACKUP%\Frontend\Styles\ ^
dir %BACKUP%\Frontend\Styles\

echo ---------------------------------------------------------------------------
echo 5.
echo Edit "/App_Data/Composite/Composite.config"
echo TODO: sed!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

c:\bin\robocopy ^
	..\..\Composite_C1_VS2010_2.1.4087.22991_ReleaseBuild_20110311.2\ ^
	%BACKUP%\App_Data\Composite\ ^
notepad %BACKUP%\App_Data\Composite\Composite.config

move %BACKUP% ..\..\Website_v2.1



Mar 31, 2011 at 9:05 AM



Site loses some functions, after migrating, so spots, splashes, menus are gone.

Just tried to configure source version 2.1 (start it once) and then deploy it... But no luck...

So either there is mistake in script or manual steps...

Can someone test it and help us find the error??






Mar 31, 2011 at 1:32 PM

Hi again

Problem above is solved!

Script works. Composite.config too...

The problem was in virtual paths and <script src="" /> stuff...
Namely VS keeps for first Webiste Virtual directory=/ while for sencod (Website_v21) makes Virtual directory=/Website_v21
thus breaking js includes and ShowMedia...

oh yes: 2.1 is mean and lean.... really fast, VisualEditor improvements are great, we'll see the rest...

thanks and regards





May 2, 2011 at 5:21 AM

Can the upgrade to 2.1.1 be applied using the same instructions?

May 2, 2011 at 9:19 AM

@atomiton I created a thread here http://compositec1.codeplex.com/discussions/255955