DeutschNetNuke - DotNetNuke in German About DotnetNuke * V3 & V4 Tipps & Tricks * Upgrade durchführen

DotNetNuke Upgrade Procedure
  • If you use 3rd party modules, check the developers site for compatibility and necessary updates. 
  • Backup your DotNetNuke database and installation folder in file system, where DotNetNuke resides 
  • create a copy of your web.config file
  • download the appropriate package from
    • Source= core framework with souce code and all current core module versions (install versions, if available)
    • Installation = same as Source, but without source code 
    • Upgrade = core framework without source or module packages
  • Check the forums at for issues reported
  • Stop your web site in IIS, if possible 
  • If upgrading from DotNetNuke 3 to DotNetNuke 4:
    • delete all .vb files in the DNN installation directory and subfolders except for 3rd party modules and providers
    • delete all DotNetNuke dll files in folder /bin löschen (Attention: not files of any modules!)
    • use install instead of upgrade package 
  • Unzip the package into the installation directory, make sure, that existing files with same name get replaces (pay attention: source version of DNN 4 has an addition root level with library and website folders, website constains the runtime files.
  • when upgrading from a DNN version prior to DNN 4.6.2:
    • rename release.config into web.config
    • from previously used web.config copy the following entried into the new web.config
      • both datenbase connection strings 
      • both encryption keys 
      • code Subdirectories
      • in section SQLDataprovider copy keys
        • DataBaseOwner
        • ObjectQualifier
      • any modifications, made manually or by 3rd party components
    • save web.config file
  • check folder /install/modules for module packages, you do not want to install/upgrade. Since DotNetNuke 4.4.0, modules with appendix .resources don't get installed, but are made available for quick installation via menu item Host :: Module Definitions.
  • If upgrading from DotNetNuke 3 to DotNetNuke 4 alter IIS settings for your Web Site or virtual directory
    • switch ASP.Net version from 1.1 to 2.0 
    • make sure, that applications using ASP.Net 1.1 do not share an app pool with ASP.Net 2.0 applications. If necessary, create a new pool. 
  • start your web site in IIS 
  • call your web site in your browser, this will start upgrade process and module installation. if AutoUpgrade is set to false in web.config file, you need to browse /install/install.aspx?mode=upgrade
  • install additional or updated modules either using Host menu item Module Definitions (DNN4, use Install Available Extensions in Host :: Extensions Menu Item of DNN 5) or copy the packages to /install/module and call /install/install.aspx?mode=installResources
  • install updates language pack(s) either interactively using Host :: Languages menu item or copy the packages to /install/language and call /install/install.aspx?mode=installResources

Good Luck!

   © 2004-2005 gamma concept mbH - Alle Rechte vorbehalten!