You are here >   Modules > DNNBackup > Documentation
  Search

DNNBackup Release Notes

4.3.9  (July 9, 2010)

  • ENH - New setting for database 'native' restores. You can now take advantage of the SQL Server 2008 feature which allows the creation of compressed .bak files.
  • CHG - Implemented a workaround to avoid the 'The specified path, file name, or both are too long. The fully qualified file name must be less than 260 characters' message on some installations.

4.3.7

  • ENH - New setting for database 'native' restores. You can now restore a native restore created in other server (the 'WITH MOVE' restore clause was implemented).

4.3.6

  • ENH - New Amazon S3 library. Now it works also at GoDaddy. In addition,  uppercase letter in bucket names are not a problem anymore.
  • ENH - Published and additional module version best suited when running SQL Server 2008 and 'Script database objects' setting can be enabled.
  • CHG - Now /App_Data is included by default in the Files backup. If you are using a SQL Express 'file instance' it is OK, expected and harmless to get two error notifications like:
    •  Error adding file App_Data\Database.mdf to zip file. Exception: The process cannot access the file '\App_Data\Database.mdf' because it is being used by another process.
    •  Error adding file App_Data\Database_log.ldf to zip file. Exception: The process cannot access the file '\App_Data\Database_log.ldf' because it is being used by another process
  • CHG - The documentation (downloadable PDF) was updated.
  • CHG - Some tokens in the email notifications were slightly updated.
  • FIX - Wrong databaseOwner restoring a database backup (script method). It was always DBO instead of the configured user.
  • FIX - Proper 'case' for 1st. level folder names within a Files backup ZIP file
  • FIX - 'Last Run' label  'XX time ago' was wrong on some installations.
  • FIX - Better handling of tables with very huge nvarchar columns.
  • FIX - Some small fixes and enhancements.

4.3.2

  • ENH - Added new Offsite backup option to Amazon S3 ('medium trust' is supported).
               Note: FTP offsite backups are still supported, but requires 'full trust'.
  • CHG - IMPORTANT: The module's name was changed to avoid conflicts with UrlScan (an IIS Server add-on) on some servers. YOU MUST UNINSTALL THE PREVIOUS VERSION BEFORE INSTALLING THIS ONE.
  • CHG - Many other small changes and enhancements.
  • FIX - SMO credentials with uppercase characters are now accepted.
  • FIX - Solved 'String was not recognized as a valid DateTime' error when performing a scheduled backup on some servers.

4.2.0

  • ENH - Improved Native restore support.
  • ENH - Added information in the DNN Event Log about different backup events (“Host Alert” / ‘DNNBackup Notice’).
  • ENH - Added new setting (Configuration > General Settings > Backup Run Threshold) to prevent multiple backups (manual or scheduled) running at the same time.
  • ENH - Improved prevention of duplicate scheduled tasks on DNN version < 5.2.
    In DNN 5.2+ the DNN Core scheduler bug was possible fixed: http://support.dotnetnuke.com/issue/ViewIssue.aspx?ID=10467&PROJID=2
  • CHG - DMO support was removed because it does not support some newer data types and it's too old. It was a lot faster than SMO but we should remove it.
    NOTE: Please browse to the Database Settings page, click on the new new 'Clear Cache' link, verify your settings and save the changes.

4.1.1

  • ENH - Updated to support some DNN 5.2 changes.
  • ENH - New 'with replace' (Overwrite the existing database) native restore setting.
  • ENH - Long timeout for shrink database and truncate DNN event log operations.
  • ENH - Added 8kb more for ‘in line’ scripting (missing PK proof).
  • ENH - The module will try to avoid running duplicated scheduled backups (DNN core bug, which could be solved in DNN 5.2). In addition, the module will not run a scheduled backup if another schedule was completed ten or fewer minutes ago. ADVICE: disable (left blank) the scheduled task's 'retry frequency'.
  • CHG - DMO automatically disabled for attached databases (SQL Server Express).
  • CHG - Shortened the script file names to help avoiding PathTooLongException on some servers ("The fully qualified file name must be less than 260 characters, and the directory name must be less than 248 characters").
  • CHG - Added a simplified 'Alternate Link' for 'Request License Assistance' which will work with email clients where the main link does not work (i.e. some Outlook Express versions).
  • FIX - 'safer' handling of binary data types ('script' backup).
  • FIX - Fixed 'Index and count must refer to a location within the string. Parameter name: count' error thrown on some installations when scripting some tables.
  • FIX - Fixed wrong backup path/folder reference for scheduled backups on some servers.
  • FIX - Fixed problem in some installations where the backup process simply stops running without any apparent reason.

4.0.8

  • ENH - some minor global enhancements and added more detailed information about the database in the configuration pages.
  • FIX - proper identification of 'local' database in some servers.

4.0.7

  • Public Official Release - Initial feature set.
  

Product Roadmap

Some ideas for future enhancements, in no particular order:

  • Add database information (recent native backups at the server site, which tables are huge?,etc.)
  • Add  more  maintenance tasks (i.e. offer truncate or delete also rows from ScheduleHistory and SiteLog  tables).
  • Automatically configure some httpruntime settings (to avoid manual editing).
  • Multiple schedules.
  • Allow manual updates to the next scheduled backup (manual change the "next run").
  • To save space, write the zip at the same time the files are being generated.
  • Amazon S3 (done!) and Rackspace's CloudFiles for backups storage.
  • Add some specific SQL Server 2008 features (i.e. when performing native backups).
  • New setting to delete the local backup file after it was uploaded to the FTP server.
  • Backup browser: additional features and bulk operations.
  • Allow wildcards when specifying folders to include/exclude from the backup.
  • Restore Wizard: provide a new operation to enable uploading of backup files (no need to previously upload them 'by hand')

Please let us know your ideas (Contact Us).

  
DNNBackup Documentation

Detailed documentation is available on the downloads page

Backup & Restore in a null sheet

Install the module as any module (from Host > Module Definitions), with no special consideration and add it to a not publicly available page.

To backup

By default a ‘full backup’ (database and files) is configured. There is no need to ‘mandatory’ change any setting. If the module guesses that native backups can be performed, that would be the default choice.

The module will not allow you to enable settings that it guesses will not work in the current environment. I.e. “script database objects” or “ftp transfer” when not running in a Full-Trust hosting environment.

Note: We've designed the module to be as much self-explanatory as possible.

To restore:

This can be on the already running site (the same where the backup was created) or could be an empty web site (no DNN and blank database).

a) Running DNN: On the module’s main page, there is a button to trigger the Restore Wizard.

b) Blank (empty) web site: Decompress and upload the “Restore_Pack” to the (blank) web site’s root. Browse to http://my_site_url/backup/
If “default.aspx” was configured as a default document for the site you’ll be redirected to the restore wizard page. If “default.aspx” is not a default document for the web site you can manually browse to the restore wizard: http://my_site_url/backup/RestoreWizard.aspx or http://my_site_url/backup/default.aspx
Note: The restore pack includes a 'This web site is undergoing scheduled maintenance' default.aspx page for the web site's root.

The Restore Wizard will guide you on the steps needed to perform the chosen operation. It should allow you to perform only operations it thinks will be able to accomplish.

About database objects backup methods

There are three methods to get the database structure (the module supports all, but the running environment may not support some of them):

  • Native SQL Server Backup: this is the preferred method and you will get an exact 1:1 copy of the full database (structure and data). This method is available for “local” databases (web and database servers are the same box) and proper database access permissions are needed.
    - this will not work at GoDaddy -
     
  • Script Database Objects: this method will script all the database objects on the database, whether the DNN core, 3rd party module or any other means created them.
    Even if this method is available, it is recommended keep “Save DataProvider Files” enabled. “Save DataProvider Files” will backup and restore the objects a lot faster and it will enable change the “ObjectQualifier” in case is needed.
    - “Script Database Objects” will require “Full Trust” and it will not work at GoDaddy-
     
  • Save DataProvider Files: this method saves all the “SqlDataProvider” files (core and 3rd party) enabling the creation of all these objects at restore time. If there were other objects in the database that were not created by this standard and recommended method to create database objects in DNN, their structure will be missing. Note that the core 100% sure will be re-created and regarding 3rd party modules, every “well made” module will include all its database objects in “SqlDataProvider” files.
    By the way, this method enables changing the “ObjectQualifier”. If in the source server was defined i.e. a “dnn_” object qualifier, at restore time this can be changed to anything else (even leave it blank).
    - this will work on any ISP, including GoDaddy –
     

FAQ

Q: Sometimes the backup cancels with error "Thread was being aborted."
A: Please try this change in your web.config file:

<httpRuntime useFullyQualifiedRedirectUrl="true" 
maxRequestLength="88192" requestLengthDiskThreshold="88192" 
executionTimeout="108000" shutdownTimeout="108000" />

 

Q: Sometimes the backup schedule is duplicated (it runs many times).
A: This is a known DNN bug (versions < 5.2.3). In DNN Backup (4.2+) we've implemented a workaround for this problem. See: DNN Support (Gemini) - Scheduled Task Runs Twice.

 

Q: Can I backup a single portal on my DNN Instance and restore it in other already running DNN Instance?
A: Not at this time. However, you can backup your DNN instance, restore it (as a new ‘cloned’ instance) and delete the portals you do not want to keep. What it is not possible at this time is “insert” a restored portal into another already running DNN instance.

 

Q: Can I backup a DNN version x.x.x and restore it in a DNN version y.y.y?
A: DNNBackup is not a DNN upgrade tool. To upgrade DotNetNuke, use any of the standard and recommended methods available to upgrade a DotNetNuke site. However, DNNBackup is very valuable to get a snapshot of your site before trying an upgrade (to be able to rollback) or to clone your site and test the upgrade somewhere else (i.e. a development or test “localhost” site – no license key required –).

 

Please find more FAQ and troubleshooting information in the module's documentation.

Licensing / Editions

  FREE Edition Single License Enterprise Subscription
Private Assembly Yes Yes Yes
VB.Net Source Code No not included / can be requested not included / can be requested
Upgrade Policy
Within the maintenance period (which starts on the purchase date) you can download any latest release and upgrade your module for free.
Always available 6 months 12 months
Installation License Unlimited 'localhost' installations Perpetual key valid for one production DNN installation.
Unlimited 'localhost' installations.
Unlimited DNN installations (universal key
valid for any domain) for one year.
  • It includes all the module's updates
    within the licensed year.
  • Once it expires, it can be renewed (50% discount)
    or can be requested (no charge) to be turned into
    a perpetual single license key (for one domain of the owner's choice).
Redistribution Not permitted Not permitted Not permitted

 

Testimonials
5.0 review rating Ezra K says...

quote A much needed and excellent module with fast and knowledgeable support. I purchased BackupScript initially to down-grade a DNN install from SQL 2005 to 2000 and it worked perfectly. I’ve now made it a default install for all DNN sites I work on. The piece of mind and flexibility of the script far surpasses the purchase price.

more reviews...