Main Menu

How to upgrade to Umbraco 4.5.2 - brought to you by sdesign1 - Umbraco specialists

This article will give an overview of upgrading Umbraco version 4.x to version 4.5.2. You will need access to your Windows server and you may also need FTP access. You will also need knowledge of the Windows server and Umbraco.

1. To start with you should back up your files and database. Simply make a copy of all of your files and store these in a seperate directory on your computer. You should also perform a backup of your database and keep this file safe. The following upgrade instructions are written from the perspective of having direct access to your Windows server.
2. Now you need to download the latest version of Umbraco. This tutorial will use version 4.5.2. It is important to remember to use a program such as WinRAR when extracting the files. If you are using the Windows utility to unzip the files, ensure that you unblock the zip-file so windows security doesn't remove any files.
3. Now copy the following folders and paste them into your website directory:
   • App_Browsers
   • App_Data
   • bin
   • install
   • umbraco
   • umbraco_client
   • web.config (ensure you copy appropriate code from <appSettings> over to the new web.config
4. Open your web.config and find the 2 instances of:

passwordFormat="Hashed"

You now need to change this to:

passwordFormat="Clear"


The upgraded version of Umbraco will use "Hashed" passwords your Users (back-end) and Members (front-end) however, the database has already stored these passwords as "Clear Text" so you need to change the setting in web.config.

5. Save your web.config file.
6. Next you should go into your /config folder and compare in contrast with your newly downloaded version of Umbraco. You should copy over any config files that are not already present in your current website directory. These are usually:
   • scripting.config
   • ClientDependency.config
   • ExamineIndex.config
   • ExamineSettings.config

However, it is best to ensure you closely compare to the two directories to ensure all the correct config files are included.

7. To ensure that your XSLT will not cause any errors, you need to now open /config/umbracoSettings.config and add the following line of code:

<!-- <settings>, <content> and <imaging> are already used in your config file and just displayed to show you where to place the new line -->

<settings>
<content>
<UseLegacyXmlSchema>true</UseLegacyXmlSchema> <!-- this line here -->
<imaging>

8. The last step is to locate the file "umbraco.config" that is found in the /data folder. Cut this file and place it in the App_Data folder. This often resolves buggy issues to do with content being displayed after upgrading.
9. Before finishing, you need to ensure that your permissions are correct on your directories. After replacing folders in the earlier stages of the upgrade, you will need to apply the correct permissions to your folders. You should give NETWORK SERVICE full control over the following:
   • app_code
   • app_browsers
   • app_data
   • bin
   • config
   • css
   • data
   • masterpages
   • media
   • python
   • scripts
   • umbraco
   • usercontrols
   • xslt
   • web.config
10. Now open your browser and enter your url for your website. Run through the entire installation process (which is the same as the upgrade process) and your website should now be upgraded to Umbraco 4.5.2.

• Privacy Policy
• Terms of Use
• A5 Leaflets
• Login

© 2006-2009 - sdesign1 Ltd