Download DOWNLOAD
Forums FORUMS
Blogs BLOGS
Forge FORGE
Help HELP
Marketplace MARKETPLACE
DotNetNuke Home
You are here >   Community > Blogs
Register  |  Login

DNN Blog

Jun 12

Posted by: Erik van Ballegoij
6/12/2007 8:09 PM  RssIcon

A frequent question in the  forums is "How to upgrade my DotNetNuke install".. I thought i'd post a brief guide here for easy ref

  • download the upgrade package of the version you wish to upgrade to
  • unzip or copy or ftp all files in the zip file to the root of your dnn application
  • rename web.config to something like web.config.[date].resources (you can use any other name, but the date will make it easy to keep track of older webconfigs, the .resources extension makes sure the file cannot be downloaded)
  • rename release.config to web.config
  • change the following things (copy from old web.config file):
    • 2 sql connection strings
    • machinekey (under system.web)
    • optionally objectQualifier and/or DBO (under  <data defaultProvider="SqlDataProvider"> )
    • optionally make any other custom changes you had in your old web.config
    • save the new web.config
  • browse to your site, upgrade will start automatically

if you want to prevent visits to your site while you are upgrading, you can do the following:

  • before copying the upgrade files to your site, put a file called "App_Offline.htm" in the root of your dnn installation, this will take the application offline (see here for more info: http://weblogs.asp.net/scottgu/archive/2005/10/06/426755.aspx )
  • Change the AutoUpgrade value to False (under appsettings in web.config). This will prevent the dnn autoupgrade feature.
  • You can manually start the upgrade by browsing to this url: http://[yourdomain]/install/install.aspx?mode=install

Comments on this are welcome, but please no discussion!

Tags:
Categories:

10 comment(s) so far...


Re: Upgrading DotNetNuke

please see also my upgrade checklist at http://www.dotnetnuke.com/tabid/616/Default.aspx

By leupold on   6/13/2007 8:41 AM

Re: Upgrading DotNetNuke

not sure if this a comment or discussion...

First Step: turn off/disable "keep-alive" services

By jyjohnson on   7/19/2007 10:21 AM

Re: Upgrading DotNetNuke

Just perfect !!

By Declic Video on   7/19/2007 10:21 AM

Re: Upgrading DotNetNuke

Thanks it worked great in my case

By arvychile on   5/28/2008 9:52 AM

Re: Upgrading DotNetNuke

I appreciate this is how dotnetnuke is updated but surely dnn can introduce better mechanisms for upgrading that is potential less error prone and provide a better audit trail of changes and potential conflicts.

By Joe_Kennington on   6/26/2008 8:40 AM

Re: Upgrading DotNetNuke

One item that is extremely helpful during an upgrade is an XML editor with diffing. Text diffing is useful, but a smart xml diff is more useful to find config keys that have changed. A good xml editor will show changes on the xml *logical* level, rather than on the text *physical* level (e.g. whitespace/indent formatting, differences in node order, etc are irrelevant -- or at least secondary -- in an XML diff).

For serious work, I prefer Altova XMLSpy. However, for those on a shoestring, the free (and open-source, although originally developed by Microsoft) XMLNotepad can also do XML diffs:
http://www.codeplex.com/xmlnotepad
http://www.microsoft.com/downloads/details.aspx?familyid=72d6aa49-787d-4118-ba5f-4f30fe913628&displaylang=en

- Erik

By EJSawyer on   6/26/2008 8:40 AM

Re: Upgrading DotNetNuke

100 upgrades further, still thankfull this overview exists

By ojooris on   6/26/2008 8:40 AM
Gravatar

Re: Upgrading DotNetNuke

it works perfect! thanks!!

By svargas on   5/4/2010 12:08 AM
Gravatar

Re: Upgrading DotNetNuke

Thank you for the instructions.

By Michael on   8/13/2009 6:44 PM
Gravatar

Re: Upgrading DotNetNuke

You might wanna add two steps before upgrading:
Backup the DB, and Backup the Site!!!

By Josh Pocius on   9/3/2010 11:52 PM

Networks

Follow DNNCorp on Twitter Follow DNN Community on Twitter

LinkedIn

Sponsors

DotNetNuke®, DNN®, and the DotNetNuke logo are trademarks of DotNetNuke Corporation

Hosted by MaximumASP