Upgrade projects to Sitefinity 3.7
To upgrade projects created with Sitefinity CMS version 3.0 or later, a upgrade patches are provided. You can find the patches in your Sitefinity CMS account. Login to https://www.progress.com/sitefinity-cms, then click your account. Go to Account Overview » Products & Subscriptions » Sitefinity CMS » Download » Older Versions. Select the latest Sitefinity CMS 3.7 version. You must download the following patches:
- Standard edition project for .NET 4.0
- Standard edition hotfix for .NET 4.0
To apply the patches, perform the following:
- Back up the project.
IMPORTANT: You must backup both the files and the database before installing anything. This ensures that if anything goes wrong, no information is lost.
- Unzip the patches in a temporary folder.
- Copy all the unzipped folders and files in the project folder.
If you have unzipped directly in the project folder, you must replace all permissions, because the new files do not inherit the project's permissions.
IMPORTANT: You must check that changes you made to some of the project files are not replaced during the upgrade. Sitefinity CMS does not override your control templates. By default, Sitefinity CMS uses its own embedded templates for both the backend and the frontend. To use your customized control templates, you must map a view to each of them.
- When you are upgrading to Sitefinity CMS 3.7 you must compare your original project web.config file to the new_web.config file from the upgrade archive. Change your original web.config to reflect the changes introduced in new version. You can use any comparison tool.
- Merge the existing file ~/Sitefinity/Admin/ControlTemplates/Pages/PageHistory.ascx.
If you do not have any custom code in that file, you can replace it with the one in the archive.
- If you have changes in the WikiviewSingleItem control template, you must download the external templates archive for Sitefinity CMS 3.7 SP4 and merge your changes with the template.
- Start the Search Indexes.
Otherwise, you will get error messages when you try to publish content.
To start the Search Indexes, go to the administration and click Administration tab » section Services » Search and start all indexes by clicking the Start indexing links.
- Open the folder ~/Sitefinity/ServiceAssemblies and delete the assembly there.
- When you initialize the Newsletters module, it is recreated. If you do not do this before you apply the patch, you'll get the following error:
Unable to load one or more of the requested types. Retrieve the LoaderExceptionsProperty for more information.
- If you have several Sitefinity CMS projects connected to one database, make sure you upgrade all of the projects to the same version.
- If you are moving your files, make sure that you move App_Data\Wikis.xml file as well.
This file is the storage file for the Wiki module.
- If you have dynamic modules and controls, that have references to Sitefinity CMS assemblies, you must rebuild them referencing the new assemblies. Your projects must be rebuilt targeting the .NET 4.0 framework.