doc/www/backups.php

   1 <? createHeader("Backing up your BlackBerry Data"); ?>
   2
   3 <? include ("barry.inc"); ?>
   4
   5
   6 <div class="subHeader">Introduction</div>
   7
   8 <p>Backups are currently performed using the Barry Backup GUI program, located
   9 in the gui/ directory of the source tarball.  Instructions for building the
  10 GUI can be found on the <? createLink("install", "Install"); ?> page.</p>
  11
  12
  13 <div class="subHeader">Backup Interface</div>
  14
  15
  16 <p>When Backup starts, it scans the USB bus for Blackberry devices.  If it
  17 finds one, it assumes that is the device you want to work with.  If it
  18 finds two, it prompts you to select the device to backup.</p>
  19
  20 <p>The main screen presents you with two options: Backup and Restore.</p>
  21
  22 <img src="backup.png" border=1 />
  23
  24 <p>When backing up your device, your data is saved in a compressed tar file
  25 in your home directory, under ~/.barry, organized by PIN number.  Each tar
  26 backup file is given a timestamp in its filename.</p>
  27
  28
  29
  30 <div class="subHeader">Restore</div>
  31
  32 <p>Pressing the Restore button will show a File Open dialog, pointing
  33 to your ~/.barry directory, for the current device PIN.</p>
  34
  35 <img src="restore.png" border=1 />
  36
  37 <p>You are not limited to the tar files in this directory, nor are you
  38 limited to backup files from the same device.  You can use this tool
  39 to copy data from one device to another.</p>
  40
  41 <p>The restore is governed by your current configuration, which determines
  42 what databases are restored.  Any database that is restored will be
  43 completely erased before the backup data is re-written.</p>
  44
  45 <p>There are some databases that are read-only on the BlackBerry.
  46 In addition, if your device is connected to a BES, you may not be
  47 able to restore your data.  If you get errors when trying to
  48 restore a certain read-only database, disable that database in
  49 the Restore Configuration dialog, as described below.</p>
  50
  51
  52
  53 <div class="subHeader">Configuration</div>
  54
  55 <p>Configuration is performed via the Edit menu, and provides two
  56 filters for determining what databases are accessed during backup and
  57 restore operations.</p>
  58
  59 <img src="config.png" border=1 />
  60
  61 <p>Each button provides essentially the same dialog, containing a list
  62 of databases available on your device, as well as checkboxes to
  63 enable them.</p>
  64
  65 <p>For the backup filter, only the enabled databases will be saved.
  66 For the restore filter, only the enabled databases will be restored,
  67 even if the backup file contains more data.</p>
  68
  69 <img src="config-backup.png" border=1 />
  70
  71 <p>This configuration is saved per device PIN.  If you backup a different
  72 device, you will need to configure its backup strategy again.  You can only
  73 change the configuration for the current device with these dialogs.</p>
  74