Fuji (mcsenow) Nguyen posted on March 19, 2008 14:08
In this blog, I document the procedures and issues found when upgrading a portal contains several custom modules that worked in DNN 3 but not in 4. Some will need upgrade and some are required replacement. The modules are:
Let's go over some of the issues related to the custom modules. First the ICPC-SsoXP version 2.2 was for DNN 3. DNN 4.5.5 uses aps.net 2.0 and it utilize a new membership library for asp.net 2.0. Thus the Sso module must be replaced with the one supporting aps.net 2. Since the site was setup to ICPC-SsoXP module as the login control (via Admin -> Site Settings page), I had to change the login page back to its default. Then uninstall SsoXP version 2.2 from the portal before the DNN upgrade. This way, I can login DNN after upgrade. The ICPC-SsoXP version 8.1.5 supports DNN 4.5.5.
The Speerio File Manager Pro 2.5 does not work on DNN 4.5.5. I have tried to contact vendor for upgrade without success. It appears that the vendor has stopped supporting development of this module. The potential replacement modules are Open-DocumentLibrary v3.0 or Document Exchange Professional 4. Open-DocumentLibrary supports SQL 2000 or higher. The Document Exchange Professional 4 only supports SQL 2005. Since my environment did not have SQL 2005, I chose the Open-DocumentLibrary.
Oxygen 2.0 skin did not display the search section properly in DNN 4.5. In DNN 4.5 the search has option to search local or the web (ex. Google) and the text appeared to overlap. There is a release of Oxygen skin 2.1 that fix the problem.
SQLGridSelectedView will require upgrade to work with DNN 4. Visit http://www.tressleworks.ca to get the latest version.
Prepare for the upgrade
Download the DNN 4.5.5 Installation version from www.dotnetnuke.com Backup DNN 3.3.7 and DNN database Document file path of Speerio File Manager Document settings for SQLGridSelectedView instances (sql statement, select criteria, etc.)
Steps to upgrade
- Change login page to default
- Un-install single sign-on module ICPC-SsoXP
- Un-install Speerio File Manger Pro (FMP) 2.5. Be sure to document the FMP settings so you can reapply then in the Open-DocumentLibrary before un-install FMP.
- Un-install SQLGridSelectedView. Be sure to document module settings before un-install.
- Modify dnn 4.5.5 web.config file and update the database connection string and machine key
- Copy the dnn 4.5.5 (including the update web.config) to dnn 3.3.7 folder
- Change the dnn virtual directory to use asp.net 2 instead of aps.net 1.1
- Browse the website and watch the upgrade status
- Login as Host and install ICPC-SsoXP version 8.1.5
- Setup Login page to point to a page containing ICPC-SsoXP control
- Install and setup Open-DocumentLibrary v3.0 to point to directory where Speerio File Manager Pro used to point to
- Install and setup SQLGridSelectedView
- Install Oxygen skin 2.1
Screenshots related to the upgrade
 | Sql script error from Step 8 - ignore them |