doc/www/backups.html

   1 <html>
   2
   3 <head>
   4         <title>Barry Documentation</title>
   5         <link rel="stylesheet" type="text/css" href="default.css">
   6
   7 </head>
   8
   9 <body>
  10
  11
  12 <div class='pageHeader'>Backing up your BlackBerry Data</div><img src='nothing.jpg' width='100%' height='5' alt=''><br><div class='linearNav'>
  13
  14 <div class="subHeader">Introduction</div>
  15 <p>Backups are currently performed using the Barry Backup GUI program, located
  16 in the gui/ directory of the source tarball.  Instructions for building the
  17 GUI can be found on the <a href="install.html">Install</a>
  18  and
  19 <a href="cvs.html">CVS</a>
  20  pages.</p>
  21
  22
  23 <div class="subHeader">GTK+ Themes</div>
  24 <p>The Barry Backup GUI program is written using the GTK+ library.  If you
  25 do not use the Gnome desktop, then the default theme for GTK+ applications
  26 often looks terrible.</p>
  27
  28 <p>Themes can be chosen for GTK+ apps without Gnome's settings
  29 or daemons interfering with your desktop of choice.</p>
  30
  31 <p>Search under the /usr/share/themes directory for 'gtkrc' files.  Pick
  32 the one you like best, and then include it by reference in your .gtkrc-2.0
  33 config file in your home directory.</p>
  34
  35 <p>For example, suppose you want to use the GTK+ Clearlooks theme.
  36 Your .gtkrc-2.0 file would contain:</p>
  37
  38 <pre>
  39         include "/usr/share/themes/Clearlooks/gtk-2.0/gtkrc"
  40 </pre>
  41
  42
  43 <div class="subHeader">Main Screen</div>
  44
  45 <p>When Backup starts, it scans the USB bus for all the Blackberry devices
  46 it can find and lists them in the main screen.  The first device listed
  47 is automatically connected and highlighted.</p>
  48
  49 <p>You can connect to different devices on the fly by selecting the
  50 desired device in the list.  The currently highlighted device determines
  51 what device the buttons to the right will operate on.</p>
  52
  53 <p>When connecting to a device for the first time, you are prompted to
  54 give the device a name.  This will be linked to the device's PIN number
  55 for easy identification later.</p>
  56
  57 <p>The main screen presents you with a number of options.</p>
  58
  59 <img src="backup.png"/>
  60
  61
  62 <div class="subHeader">Backup Button</div>
  63 <p>The Backup button initiates the backup process for the currently selected
  64 device.  Multiple backups and restores can be run at once.</p>
  65
  66 <p>When backing up your device, your data is saved by default in a
  67 compressed tar file in your home directory, under ~/.barry, organized by
  68 PIN number.  Each tar backup file is given a timestamp in its filename.
  69 The destination directory can be changed per device, using the Config...
  70 button.</p>
  71
  72 <p>When the backup starts, you are prompted to give the backup an optional
  73 name.  If you specify a name, it will be used as part of the tar filename.</p>
  74
  75
  76
  77 <div class="subHeader">Restore Button</div>
  78 <p>Pressing the Restore button will show a File Open dialog, pointing
  79 to your ~/.barry directory, for the current device PIN.</p>
  80
  81 <img src="restore.png"/>
  82 <p>You are not limited to the tar files in this directory, nor are you
  83 limited to backup files from the same device.  You can use this tool
  84 to copy data from one device to another.</p>
  85
  86 <p>The restore is governed by your current configuration, which determines
  87 what databases are restored.  Any database that is restored will be
  88 completely erased before the backup data is re-written.  If the source
  89 backup file contains no data for that database, then the database
  90 will merely be erased.</p>
  91
  92 <p>There are some databases that are read-only on the BlackBerry.
  93 In addition, if your device is connected to a BES, you may not be
  94 able to restore your data.  If you get errors when trying to
  95 restore a certain read-only database, disable that database in
  96 the Restore Configuration dialog, as described below.</p>
  97
  98
  99
 100 <div class="subHeader">Config Button</div>
 101 <p>Pressing the Config button opens the config options dialog as shown
 102 below.</p>
 103
 104 <img src="config.png"/>
 105 <p>You can rename your device here, set a different backup target directory,
 106 and select whether backups should have labels or not.  If this checkbox
 107 is selected, you will be prompted for an optional label each time you
 108 create a new backup.</p>
 109
 110 <img src="label.png"/>
 111 <p>Both backup and restore operations have their own database filters
 112 which can be configured here.  For the backup filter, only the enabled
 113 databases will be saved.  For the restore filter, only the enabled
 114 databases will be restored, even if the backup file contains more data.</p>
 115
 116 <p>Each filter configure button provides essentially the same dialog,
 117 containing a list of databases available on your device, as well as
 118 checkboxes to enable them.</p>
 119
 120 <img src="config-backup.png"/>
 121 <p>This configuration is saved per device PIN.  If you backup a different
 122 device, you will need to configure its backup strategy again.  You can only
 123 change the configuration for the current device with these dialogs.</p>
 124
 125
 126
 127 <div class="subHeader">Disconnect Buttons</div>
 128 <p>The Disconnect and Disconnect All buttons let you escape the device's
 129 Desktop mode while keeping the program running.  It is possible to disconnect
 130 during a backup or restore, but this may leave your device data in an
 131 unknown state.</p>
 132
 133 <div class="subHeader">Rescan Button</div>
 134 <p>This button refreshes the device list, which is useful when a new device
 135 has been plugged in.</p>
 136
 137
 138 <div class="Copyright">Copyright &copy; 2011 - Net Direct Inc.</div>
 139
 140 </body>
 141 </html>
 142