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

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
Gravatar

Re: Upgrading DotNetNuke

it works perfect! thanks!!

By svargas on   5/4/2010 12:08 AM
Attend A Webinar
Free Demo Site
Download DotNetNuke Professional Edition Trial
Have Someone Contact Me
Have Someone Contact Me
Charlotte DoDNN

Like Us on Facebook Join our Network on LinkedIn Follow DNN Corporate on Twitter Follow DNN on Twitter

Advertisers

Telerik JustCode Free
Exact Target Exec Alert
PowerDNN

Sponsors

DotNetNuke Corporation

DotNetNuke Corp. is the steward of the DotNetNuke open source project, the most widely adopted Web Content Management Platform for building web sites and web applications on Microsoft. Organizations use DotNetNuke to quickly develop and deploy interactive and dynamic web sites, intranets, extranets and web applications. The DotNetNuke platform is available in a free Community and subscription-based Professional and Enterprise Editions with an Elite Support option. DotNetNuke Corp. also operates the DotNetNuke Store where users purchase third party apps for the platform.