Suggested Upgrade Path

Return to previous page

  • 4/7/2015



Suggested Upgrade Path

Last updated 8 months ago



(Enter the content of this article below)



Traditionally, the DNN Core has only suggested upgrading from version to version, without skipping any versions. This is because, in the past, this was the only use case that was effectively tested prior to subsequent releases was upgrades from the version immediately prior. This has changed recently, as you will see in the table below.

This listing is subject to change. All installation and upgrade files can be downloaded from CodePlex. If your current version falls between any of the versions listed below, first upgrade to the version closest to yours.

From VersionTo Version
07.03.02 08.03.00
08.03.00 09.00.00 through 09.01.00

IMPORTANT NOTE! This upgrade path has been tested and successfully used by numerous people and sites. However, that does not guarantee that your websites will upgrade error-free. You should always use best practices. Back-up your websites and databases the best that you can, and backup and test your websites on a test or staging instance.


This article was originally reprinted from The Mighty Blog, with permission.
Our thanks go to Will Strohl.

Upgrade Notes»

DotNetNuke has been around since 2002, and in that time has had a number of changes which can complicate matters. These include:

Changing pre-requisities»

  • the changeover from DNN 3.x to DNN 4.x - DNN 3.x used 1.1, whereas DNN 4.x and above require 2.0
  • editions prior to 4.6.2 - Prior to 4.6.2 site admins had to manually merge a number of key fields in web.config such as the machinekey and both connection strings. With 4.6.2 DotNetNuke introduced functionality known as xmlmerge which automatically does the web.config merging on your behalf.
  • DotNetNuke 5.2 - this version introduced the requirement for SQL 2005 and .net 3.5 SP1
  • With the 7.0 release DotNetNuke has some additional changed pre-requisites, please see here for further details.
  • 3.02.02 - 4.03.07 - please refer to the Detailed installation guide "Upgrade to DotNetNuke 4.x chapter". This blog post also contains information about upgrading from 3.2.2. to 4.x: Preparing for an upgrade
  • When upgrading from a version before 5.3.0 to after 5.3.0, you may encounter this error during the upgrade: “Type 'Web.HttpResponse' is not defined.” This error primarily occurs if an the XML module is already installed. To prevent this, please check PRIOR to upgrading if the XML module is installed in your DotNetNuke version. If it is installed, please upgrade it PRIOR to upgrading DotNetNuke to version 4.3.5, available from CodePlex
No sections defined
Subscribe to DNN Digest

DNN Digest is our monthly email newsletter. It highlights news and content from around the DNN ecosystem, such as new modules and themes, messages from leadership, blog posts and notable tweets. Keep your finger on the pulse of the ecosystem by subscribing.  

Copyright 2018 by DNN Corp Terms of Use Privacy
What is Liquid Content?
Find Out
What is Liquid Content?
Find Out
What is Liquid Content?
Find Out