Radio UserLand Kick Start: Backing Up Data

This is part of Chapter 9 of the book Radio UserLand Kick Start by Rogers Cadenhead, published by Sams Publishing

Restoring a Weblog from an XML Backup

If Radio is left running in the evening, the software saves all weblog entries, articles, templates, and preferences as XML files in the www\backups folder once per night between midnight and 1 a.m.

You can also perform backups manually. Visit the desktop site backup page and click Backup Now.

These files can be upstreamed to the server hosting the site, making it possible to restore the weblog from the most recent server backup.

Backups are set with the Nightly Backups preference (click Prefs on any desktop Web page, and then click Nightly Backups). When Radio is installed, backups are saved in the backups folder but are not upstreamed.

You can use these backup files to restore a Radio weblog that has been lost because of database corruption, hard drive failure, or other problems.

If you are hosting your weblog on a Radio Community Server and upstreaming backups to that server, you can view the backup folder: Simply add /backups to the weblog's home page URL, as in

If you need to restore Radio from a server backup and you can view the backups folder on that folder, save a copy of all files in that folder. They could be overwritten inadvertently as you attempt to restore the site, leaving you without any backup files.

In order to restore a Radio weblog from an XML backup, you must know your Radio user number and password.

To restore the site, follow these steps:

  1. If you still have a Radio UserLand folder on your computer, save a backup copy of it somewhere else and delete the original folder.

  2. Download a new copy of Radio from UserLand's Web site at

  3. Install the software in the same location as before. Launch it.

    The "It Worked!" page opens in a Web browser to indicate that the software has been installed successfully.

  4. If you can't remember your password, try this:

    • In the "Forgot your usernum and password?" section, type your email address in the Email address field.

    • Click the Submit button below the Email address field.

    UserLand mails the user number and password to your email address.

  5. Scroll down to the "Are you re-installing Radio?" section and fill out the Usernum and Password fields. Click the adjacent Submit button.

    Radio will be set up with the correct account information, but none of your old weblog entries or other data will be present yet.

    At this point, Radio still needs to upgrade the main Radio.root database with several updates that were released after the installation program.

  6. If you're using Windows, open the Radio application (right-click the Radio icon in the System tray). It's already open on MacOS.

  7. Choose the menu command File, Update Radio.root.

  8. A dialog box opens asking whether Radio should connect to and download updates to Radio.root. Confirm this by clicking OK.

    The About Radio UserLand window displays the progress of the software update and any other activity (see Figure 9.3).

    When an update completes successfully, Radio displays a count of the number of parts that have been installed. If an update fails, Radio might not display anything in response.

    Monitoring an attempt to update Radio.root.

    Figure 9.3.

    Monitoring an attempt to update Radio.root. (Enlarge)

  9. Repeat steps 7-8 until Radio finishes an update by displaying the message: "0 new parts loaded from ''." This indicates that there are no more updates left to install.

    At this point, there will now be a www\backups folder on your computer. The files in this folder will prevent the weblog from being restored using the server backup.

    Caution: Radio displays error messages if it cannot install a part of the upgrade. You can disregard these errors: Click Continue installation to dismiss the error dialogs and to continue setting up the database.

  10. Delete the backups folder.

  11. Visit the desktop backup page.

  12. Click the Restore Now button and confirm the choice on the next page.

    A Web page displays the current status of the restore procedure, refreshing as more parts of the weblog are restored on your computer.

    When it's done, you'll see the message: "Your preferences, weblog posts, templates, stories and aggregator subscriptions have been restored."

If the weblog and all of its files were restored successfully, you'll be able to see your most recent entries on the desktop home page. Look around the desktop site for stories, theme templates, and navigator links.

Chapter 9:

  1. Introduction
  2. Running the Radio Application
  3. Backing Up a Weblog
  4. Restoring a Weblog from an XML Backup
  5. Summary

Radio UserLand Kick Start home page