You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/getting-started/setup/upgrades/suggested-upgrade-path/index.md
+39-37Lines changed: 39 additions & 37 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
uid: setup-upgrades-suggested-upgrade-path
3
3
locale: en
4
4
title: DNN Platform Suggested Upgrade Path
5
-
dnnversion: 10.01.02
5
+
dnnversion: 10.02.03
6
6
---
7
7
8
8
# DNN Platform Suggested Upgrade Path
@@ -13,45 +13,47 @@ Following is the recommended upgrade path for **DNN Platform** based on the expe
13
13
14
14
The below is, of course, subject to change. If your current version of DNN Platform is between any of the versions listed below, first upgrade to the closest listed version. For instance, if you are starting with version 09.02.00, you should upgrade first to version 09.03.02.
> If you are in a situation where you are unable to make the 09.13.09 -> 10.x upgrade, there is a hot-fix release [09.13.10](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.10). This was a special release that contains security patches through the DNN 10.02.00 release and can be used during periods when a 10.x upgrade is not possible. For a successful upgrade, it is NOT necessary to stop at 09.13.10 prior to upgrading to 10.x. There is NO guarantee that any future 9.13.x releases will be made, therefore it is suggested to try to prepare for a 10.x upgrade as soon as practical.
37
+
> If you are in a situation where you are unable to make the 09.13.09 -> 10.x upgrade, there is a hot-fix release [09.13.10](https://github.com/dnnsoftware/Dnn.Platform/releases/tag/v9.13.10). This was a special release that contains security patches through the DNN 10.02.00 release and can be used during periods when a 10.x upgrade is not yet possible. For a successful upgrade, it is NOT necessary to stop at 09.13.10 prior to upgrading to 10.x. There is NO guarantee that any future 9.13.x releases will be made, therefore it is suggested to try to prepare for a 10.x upgrade as soon as practical.
38
+
39
+
> [!NOTE]
40
+
> If upgrading from DNN 10.02.x and later, it is strongly recommended to follow the new upgrade process outlined in the [Post-10.2.0 Upgrade Guide](xref:setup-upgrades-post-10.2.0)
38
41
39
42
> [!TIP]
40
-
> **Upgrade Notes:** DotNetNuke has been around since 2002, and in that time has had a number of changes which can complicate matters during the process of upgrading through different versions. These include:
43
+
> **Upgrade Notes:** DotNetNuke has been around since 2002, and in that time has had a number of changes which can complicate matters during the process of upgrading through different versions. Please review the list below carefully:
41
44
42
-
> [!NOTE]
43
-
> If upgrading from DNN 10.02.02 and later, it is strongly recommended to follow the new upgrade process outlined in the [Post-10.2.0 Upgrade Guide](xref:setup-upgrades-post-10.2.0)
44
-
45
-
## Requirements Changes & Prerequisites
46
-
- The changeover from DNN 3.x to DNN 4.x - DNN 3.x used ASP.NET 1.1, whereas DNN 4.x and above require ASP.NET 2.0.
47
-
- 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.
48
-
- 3.02.02 - 4.03.07 - Please refer to the Detailed installation guide "[Upgrade to DotNetNuke 4.x chapter](https://www.dnnsoftware.com/LinkClick.aspx?fileticket=gOZGbvrVKJw%3d&tabid=478&mid=857)". This blog post also contains information about upgrading from 3.2.2. to 4.x: [Preparing for an upgrade](https://www.dnnsoftware.com/community-blog/cid/135317/preparing-for-an-upgrade)
49
-
- DotNetNuke 5.2 - This version introduced the requirement for SQL 2005 and ASP.NET 3.5 SP1.
50
-
- 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 at [DNN.XML Module on GitHub](https://github.com/DNNCommunity/DNN.XML).
51
-
- With the 7.0 release DotNetNuke has some additional changed pre-requisites, please see the [DNN 7 Developer Quick Start](https://www.dnnsoftware.com/wiki/dotnetnuke-70-developer-quick-start#Pre-requisites_0) for further details.
52
-
- In DNN 9.2.0, multiple APIs were removed that were marked deprecated in DNN 7 and before. Most of the core modules have been updated since and you can find them at [https://github.com/dnncommunity](https://github.com/dnncommunity). If you have other modules installed, please check for updates before upgrading to DNN 9.2.0 or later.
53
-
- DNN 9.4.0 introduced a minimum requirement of ASP.NET 4.7.2.
54
-
- DNN 9.8.0 (and above for the 9.x series releases) brings the OPTIONAL (but HIGHLY RECOMMENDED) [Telerik Removal](xref:setup-telerik-removal).
55
-
- DNN 10.0.0 introduced minimum requirements for ASP.NET 4.8 and SQL Server 2017. In addition, it will force-remove DNN-Provided Telerik versions.
56
-
- DNN 10.1.1 new installs use SHA256 as the default password hashing algorithm. This only affect new installs, if you want to migrate an upgraded site to SHA256, please read [the documentation for membership provider changes](xref:security-membership-providers).
45
+
## Notes, Requirements, Changes, and Prerequisites
57
46
- DNN 10.2.0 introduced a new simplified upgrade process, see [Post-10.2.0 Upgrade Guide](xref:setup-upgrades-post-10.2.0).
47
+
- DNN 10.2.0 introduced a [new CDF replacement](https://github.com/dnnsoftware/Dnn.Platform/issues/6643) (affects themes/skins) and removed CSS/JS bundling and minification
48
+
- DNN 10.1.1 new installs use SHA256 as the default password hashing algorithm. This only affect new installs, if you want to migrate an upgraded site to SHA256, please read [the documentation for membership provider changes](xref:security-membership-providers).
49
+
- DNN 10.0.0 introduced minimum requirements for ASP.NET 4.8 and SQL Server 2017. In addition, it will force-remove DNN-Provided Telerik versions.
50
+
- DNN 10.0.0 is a significant release with both [Breaking Changes and New Features](https://dnncommunity.org/blogs/Post/20257).
51
+
- DNN 9.8.0 (and above for the 9.x series releases) brings the OPTIONAL (but HIGHLY RECOMMENDED) [Telerik Removal](xref:setup-telerik-removal).
52
+
- DNN 9.4.0 introduced a minimum requirement of ASP.NET 4.7.2.
53
+
- DNN 9.2.0 multiple APIs were removed that were marked deprecated in DNN 7 and before. Most of the core modules have been updated since and you can find them at [https://github.com/dnncommunity](https://github.com/dnncommunity). If you have other modules installed, please check for updates before upgrading to DNN 9.2.0 or later.
54
+
- DNN 7.0.0 has some additional changed pre-requisites, please see the [DNN 7 Developer Quick Start](https://www.dnnsoftware.com/wiki/dotnetnuke-70-developer-quick-start#Pre-requisites_0) for further details.
55
+
- DNN 5.3.0 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 at [DNN.XML Module on GitHub](https://github.com/DNNCommunity/DNN.XML).
56
+
- DotNetNuke 5.2.0 introduced the requirement for SQL 2005 and ASP.NET 3.5 SP1.
57
+
- DotNetNuke 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.
58
+
- DotNetNuke 3.2.2 to 4.3.7 please refer to the Detailed installation guide "[Upgrade to DotNetNuke 4.x chapter](https://www.dnnsoftware.com/LinkClick.aspx?fileticket=gOZGbvrVKJw%3d&tabid=478&mid=857)". This blog post also contains information about upgrading from 3.2.2. to 4.x: [Preparing for an upgrade](https://www.dnnsoftware.com/community-blog/cid/135317/preparing-for-an-upgrade)
59
+
- DotNetNuke 3.x to 4.x changeover - DNN 3.x used ASP.NET 1.1, whereas DNN 4.x and above require ASP.NET 2.0.
0 commit comments