Do you know how to upgrade DNN to the latest version?

Last updated by Igor Goldobin 13 days ago.See history

This rule has been archived
Archived Reason: outdated

If there is an upgrade available (see "Have you installed the latest DNN version?", follow the following steps to perform the upgrade.

In Preparation:

  1. Back up the DNN database
  2. Back up all website files
  3. Check your database and website backups!
  4. Download the latest DotNetNuke upgrade package:

    A. From the site. You may need login credentials if you are using a non-community version of DNN or B. Click the "Upgrade Available" button that appears when you are not running the latest version.

  5. Create a basic html document called appoffline.htm. This page will be shown on the site while you are doing the upgrade. ::: bad
    Figure: Bad example - No maintenance page. Users may see errors while the site is partially upgraded
    ::: ::: good ![Figure: Good example - HTML page to let users know the site is offline to perform the Upgrade](2024-04-20
    13-29-45.png) :::

To Perform the Upgrade:

  1. Upload the app_offline.htm file to the root web folder for the site.
  2. Navigate to the site in a web browser and check that the app_offline.htm file is shown instead of the usual default page.
  3. Copy the contents of the latest DotNetNuke upgrade package over the top of the existing files. All files should be copied because the package should only contain generic files ?no configuration files.
  4. When the copy is complete, rename the appoffline.htm file to When you navigate to the site, you will see a new construction page: ::: good
    Figure: Good example - Latest version has been copied and site is unavailable (suggestion to DNN team: remove the underline from the non-link)
  5. Access the /install/install.aspx?mode=upgrade page ( using a web browser. The site will begin an automatic upgrade process: ::: good
    Figure: Good example - Automatic upgrade running
  6. On completion of the upgrade, you will see the following message at the bottom of the page. Click on the link to return to the site. ::: good
    Figure: Good example - Automatic upgrade completed (suggestion to DNN team: put an underline under the link)
  7. Click through the newly upgraded site to perform a smoke test.
  8. Log in to the DNN site and navigate to "Host", then "Host Settings". You will see that the site is running the newest version of DNN and that there are no upgrades available. ::: good
    Figure: Good example - Latest version and no upgrades available
We open source. Powered by GitHub