Upgrading DNN Platform Print

  • upgrade dnn, upgrade dotnetnuke
  • 0

DNN Platform Upgrade Guide for Plesk Windows Hosting

Overview

This guide provides step-by-step instructions for upgrading your existing DNN Platform installation on Plesk Windows hosting. Upgrading DNN Platform ensures you have the latest features, security patches, and performance improvements.

Professional Upgrade Service

Need assistance with your upgrade? AWH offers professional DNN Platform upgrade services for $99. This service includes:

  • Complete backup of your current site and database
  • Professional upgrade execution following best practices
  • Post-upgrade testing and configuration
  • Troubleshooting any upgrade issues
  • Ensuring all modules and themes remain functional

Contact AWH support to schedule your professional upgrade service.

Before You Begin: Important Considerations

Check Your Current Version

  1. Log into your DNN admin panel
  2. Go to Settings > Site Settings
  3. Click "Site Info" tab to view your current DNN version
  4. Note your current version for upgrade path planning

Multi-Language Site Warning

⚠️ CRITICAL: If your site uses multiple languages (localization), there are known upgrade issues with DNN v10.x.x. We strongly recommend waiting before upgrading to DNN v10.x.x if you have a multi-language site, or contact AWH for professional upgrade assistance.

Recommended Upgrade Path

Depending on your current version, you may need to upgrade incrementally:

From DNN 9.x.x to 10.x.x:

  • Direct upgrade possible (for English-only sites)
  • Multi-language sites: Contact AWH for assistance

From DNN 8.x.x or earlier:

  • Upgrade to DNN 9.11.x first
  • Then upgrade to DNN 10.x.x
  • Strongly recommended: Use AWH's professional service for complex upgrades

From very old versions (7.x.x or earlier):

  • Multiple intermediate upgrades required
  • Highly recommended: Use AWH's professional upgrade service

Prerequisites for Upgrade

System Requirements Verification

Ensure your hosting account supports:

  • .NET Framework 4.8.0+ (for DNN 10.x.x)
  • Microsoft SQL Server 2017+ compatibility
  • Sufficient disk space (at least 2x your current site size)

Module and Theme Compatibility

  1. Review installed modules: Some third-party modules may not be compatible with newer DNN versions
  2. Check theme compatibility: Older skins may need updates
  3. Document customizations: Note any custom code or configurations

Critical: Pre-Upgrade Preparation

1. Create Complete Backup in Plesk

⚠️ ESSENTIAL: Always create a full backup before upgrading. This is your safety net if anything goes wrong.

Database Backup:

  1. Log into Plesk control panel
  2. Go to Websites & Domains
  3. Click "Databases"
  4. Click your DNN database name
  5. Click "Export Dump"
  6. Choose "Download to local computer"
  7. Save the database backup file securely

Files Backup:

  1. In Plesk, go to Websites & Domains
  2. Click "Backup Manager"
  3. Click "Back Up"
  4. Select "Full backup"
  5. Include:
    • ✅ Configuration
    • ✅ Content (files)
    • ✅ Databases
  6. Choose storage location (preferably download to local computer)
  7. Click "OK" and wait for backup completion

2. Disable Web Application Firewall (WAF)

⚠️ REQUIRED: Disable WAF during the upgrade process to prevent interference.

  1. In Plesk, go to Websites & Domains
  2. Click your domain name
  3. Go to Web Application Firewall (ModSecurity)
  4. Set WAF to "Off" or "Detection Only"
  5. Click "Apply"

3. Enable Maintenance Mode (Optional but Recommended)

  1. Log into your DNN admin panel
  2. Go to Settings > Site Settings
  3. Under "Advanced Settings" find "Site Offline"
  4. Check "Take Site Offline"
  5. Add a maintenance message for visitors
  6. Save settings

Upgrade Process

Step 1: Download Upgrade Package

  1. Visit https://github.com/dnnsoftware/Dnn.Platform/releases
  2. Download the DNN_Platform_x.x.x_Upgrade.zip file (not Install.zip)
  3. Extract the zip file to your local computer

Step 2: Upload Upgrade Files

  1. In Plesk File Manager, navigate to your DNN installation directory (usually httpdocs)
  2. Important: Do NOT delete existing files first
  3. Click "Upload Files"
  4. Upload the DNN_Platform_x.x.x_Upgrade.zip file
  5. After upload, click the zip file and select "Extract Files"
  6. Choose "Extract and replace existing files" when prompted
  7. Confirm extraction

Step 3: Start Upgrade Process

  1. Open your web browser
  2. Navigate to your domain (e.g., https://yourdomain.com)
  3. You should be automatically redirected to the upgrade wizard
  4. If not redirected, try accessing: https://yourdomain.com/Install/Install.aspx

Step 4: Complete Upgrade Wizard

Database Upgrade

  1. The wizard will detect your existing database
  2. Review the database connection information
  3. Click "Next" to begin database upgrade
  4. Do not close the browser during this process (can take 10-30 minutes)
  5. Wait for "Upgrade Complete" message

File System Upgrade

  1. The wizard will process file system changes
  2. Update web.config if prompted
  3. Clear cache and temporary files
  4. Complete any additional configuration steps

Step 5: Post-Upgrade Tasks

Verify Upgrade Success

  1. Navigate to Settings > Site Settings > Site Info
  2. Confirm the new DNN version is displayed
  3. Test core functionality:
    • Page creation/editing
    • Module functionality
    • User login/registration
    • File uploads

Clean Up Upgrade Files

  1. Return to Plesk File Manager
  2. Navigate to your DNN directory
  3. Delete the upgrade zip file
  4. Delete the Install folder (if present after upgrade)

Re-enable Security Features

  1. Re-enable WAF:
    • Go to Web Application Firewall (ModSecurity) in Plesk
    • Set back to "On"
    • Click "Apply"
  2. Disable Maintenance Mode:
    • Log into DNN admin panel
    • Go to Settings > Site Settings
    • Uncheck "Take Site Offline"
    • Save settings

Update Modules and Themes

  1. Check for module updates in Settings > Extensions
  2. Update any modules that have newer versions available
  3. Test all critical functionality
  4. Update themes/skins if necessary

Troubleshooting Common Upgrade Issues

Upgrade Wizard Won't Start

  • Clear browser cache and cookies
  • Ensure WAF is disabled in Plesk
  • Check file permissions in Plesk File Manager
  • Try accessing upgrade URL directly: /Install/Install.aspx

Database Upgrade Errors

  • Verify database backup was successful before proceeding
  • Check database permissions in Plesk
  • Contact AWH support if SQL errors occur

Module Compatibility Issues

  • Check DNN Store for module updates
  • Disable incompatible modules temporarily
  • Contact module vendors for updated versions

Performance Issues After Upgrade

  • Clear DNN cache: Settings > Site Settings > Performance > Clear Cache
  • Restart application in Plesk (if available)
  • Monitor site performance and contact AWH if issues persist

Website Not Loading After Upgrade

  1. Check for errors in Plesk error logs
  2. Verify web.config syntax in Plesk File Manager
  3. Restore from backup if critical issues occur
  4. Contact AWH support immediately

Version-Specific Upgrade Notes

Upgrading to DNN 10.x.x

  • Telerik Removal: DNN 10.x automatically removes old Telerik libraries
  • API Changes: Some deprecated APIs have been removed
  • Module Updates: Many modules may require updates for compatibility

Upgrading from DNN 9.x.x

  • Generally straightforward upgrade path
  • Review module compatibility before upgrading
  • Test thoroughly in staging environment if possible

Upgrading from DNN 8.x.x or Earlier

  • Multi-step upgrade required
  • Significant changes in file structure and database schema
  • Strongly recommended: Use AWH's professional upgrade service

Post-Upgrade Best Practices

Regular Maintenance

  1. Schedule Regular Backups: Use Plesk backup tools
  2. Monitor Performance: Check site speed and functionality
  3. Update Extensions: Keep modules and themes current
  4. Security Updates: Apply DNN patches promptly

Testing Checklist

  • All pages load correctly
  • User registration/login works
  • Contact forms function properly
  • File uploads work
  • Search functionality operates
  • E-commerce features (if applicable)
  • Custom modules operate correctly
  • Mobile responsiveness maintained

When to Contact AWH Support

Technical Issues

  • Database upgrade errors
  • File permission problems
  • Server configuration issues
  • Performance problems after upgrade

Professional Services

  • Complex upgrade scenarios (old versions)
  • Multi-language site upgrades
  • Custom module compatibility issues
  • Peace of mind with professional handling ($99 service)

Support Resources

AWH Support

  • Hosting Issues: Contact AWH technical support
  • Professional Upgrade Service ($99): Contact AWH sales/support
  • Emergency Issues: Use priority support channels

DNN Community Resources

Recovery Procedures

If Upgrade Fails

  1. Stop immediately - don't attempt further changes
  2. Contact AWH support for assistance
  3. Prepare for restore from backup if necessary
  4. Document error messages for support team

Backup Restoration Process

  1. Contact AWH support for backup restoration assistance
  2. Provide backup files created in pre-upgrade steps
  3. Allow AWH technical team to restore your site
  4. Test functionality after restoration

Last Updated: September 2025
Applies To: DNN Platform Upgrades on Plesk Windows Hosting
Service: Professional Upgrade Available for $99

 

Remember: When in doubt, use AWH's professional upgrade service. The $99 investment can save hours of troubleshooting and potential data loss.


Was this answer helpful?

« Back