Many people think that Sitefinity upgrade process is painful.
The most popular problems during upgrade related to:
- broken references
- missing necessary DLLs
- errors during initialization
Let me try to explain you my way, how I am doing all upgrades with NuGet packages
Sitefinity already has documentation regarding this http://docs.sitefinity.com/upgrade-a-project-that-has-nuget-packages but I am doing in a bit different way.
Let’s say that I have some “old” Sitefinity project 9.1.6110. And I want to upgrade it to latest 9.2.6201
0) Create backup files and database
1) Add Sitefinity NuGet Server as a package source in Visual Studio:
- In Visual Studio, navigate to Tools -> Options -> NuGet Package Manager -> Package Sources.
- To add a new source, click the plus (+) button.
- In the respective input field, enter the following data:
- Name: Sitefinity NuGet Server
- Source: http://nuget.sitefinity.com/nuget
- To save your changes, click OK.
2) Check and install all Sitefinity dependencies through NuGet for current version
If your project already has Sitefinity NuGet libraries, you can skip this step.
We need to install all Sitefinity dependencies for current version through NuGet. Let’s go to Package Manager Console and execute:
Install-Package Telerik.Sitefinity.All -Version 9.1.6110.0 -Source http://nuget.sitefinity.com/nuget
Be ready and make coffee, it can take a while
During installation they will ask you:
File 'ResourcePackages\LICENSE.md' already exists in project 'SitefinityWebApp'. Do you want to overwrite it?
[Y] Yes [A] Yes to All [N] No [L] No to All [?] Help (default is "N"):
When process finished. Try to build and run the project. Most probably everything will be fine
3) How to upgrade Sitefinity through NuGet
You just need to go to Package Manager Console
Update-Package Telerik.Sitefinity.All -Version 9.2.6201.0 -Source http://nuget.sitefinity.com/nuget
Once an upgrade is done, you need to build and run Sitefinity project.
NuGet will automatically add new necessary files and add necessary changes in your web.config
And enjoy the latest version of Sitefinity
And in the future, for new upgrades, you just need to do step #3