doc/www/troubleshooting.php

   1 <? include ("barry.inc"); ?>
   2
   3 <? createHeader("Troubleshooting"); ?>
   4
   5 <? createSubHeader("Common Issues When Working With Barry"); ?>
   6
   7
   8 <p><b>Q:</b> I have one of the newer Pearl devices, such as the 8120.
   9 When I try to run a backup using the GUI, the device resets itself.</p>
  10
  11 <p><b>A:</b> This is a known problem, and is likely a bug in the
  12 Blackberry firmware which gets triggered when both the usb_storage kernel
  13 module and Barry access the device at the same time.  When Barry closes
  14 its USB connection, the device gets confused and resets itself.</p>
  15
  16 <p>The only known workaround is to unload the usb_storage module when
  17 accessing the database (such as when syncing or doing backups).</p>
  18
  19
  20 <hr/>
  21
  22
  23 <p><b>Q:</b> When I run btool, it hangs for 30 seconds and then times out on
  24 the USB read call.</p>
  25
  26 <p><b>A:</b> From reports on the mailing list, this appears most likely to be
  27 a bug in the BlackBerry firmware.  Sometimes upgrading your
  28 Blackberry will fix this issue.</p>
  29
  30 <p>This is not conclusive, and may be a kernel issue as well.</p>
  31
  32 <p>To verify that you are experiencing the right issue, run
  33 "btool -vl" to get a verbose USB log.  At the beginning
  34 the USB configuration and endpoint information is printed.
  35 If the last set of endpoints have 0's in the values, you are
  36 experiencing the problem.  The proper set of endpoints will not
  37 be displayed with "lsusb -v" in this case either.</p>
  38
  39 <p>One workaround is to run bcharge twice like this:</p>
  40
  41 <pre>
  42         bcharge
  43         bcharge -o
  44 </pre>
  45
  46 <p>After the second bcharge, btool should work normally.</p>
  47
  48
  49 <hr/>
  50
  51
  52 <p><b>Q:</b> I've installed Barry, and bcharge is set to run automatically,
  53 but as soon as I plug my device into the USB port, the device reboots.</p>
  54
  55 <p><b>A:</b>This is a bug in the udev script, which causes the bcharge program
  56 to be run 7 to 10 times back to back.  This confuses the BlackBerry
  57 enough to reset it.  As of 2007/07/28, there is a corrected
  58 udev script example in Barry CVS.  This corrected script
  59 was included in the Barry 0.8 release, and newer versions.</p>
  60
  61 <p>Alternative issue: You may have the berry_charge kernel module
  62 running, in which case you need to choose which method you wish
  63 to use.  Do not run both berry_charge and bcharge.</p>
  64
  65
  66 <hr/>
  67
  68
  69 <p><b>Q:</b> btool is giving me errors, saying it can't find my device, or
  70 can't access it!</p>
  71
  72 <p><b>A:</b> If you have one of the newer BlackBerry devices, such as the Pearl
  73 or the Curve, these devices default to USB Mass Storage mode
  74 when you first plug them in.  The Linux kernel detects this,
  75 and on most systems loads the usb_storage module automatically,
  76 sometimes mounting the device as a drive.</p>
  77
  78 <p>If you are running an older version of Barry, please upgrade, as
  79 this issue has been fixed so usb_storage and database access can
  80 coexist in peace.</p>
  81
  82
  83 <hr/>
  84
  85
  86 <p><b>Q:</b> One of the Barry applications crashed, and now I keep getting
  87 a Desktop error message in hex.</p>
  88
  89 <p><b>A:</b> If a Barry application crashes, that means the Desktop mode was
  90 not shutdown properly.  Your device will likely appear to still
  91 be "busy" as well.  Currently the only way to fix this is to
  92 reset the device, either by unplugging/replugging it, or by
  93 running the program "breset".</p>
  94
  95
  96 <hr/>
  97
  98
  99 <p><b>Q:</b> Everytime I restore a backup with the backup GUI, the database
 100 I need does not get restored.  What gives?</p>
 101
 102 <p><b>A:</b> Both the backup and the restore are filtered based on your
 103 configuration.  Check your Edit | Config... settings and make
 104 sure the needed database is turned on in <i>both</i> backup and restore.</p>
 105
 106
 107 <hr/>
 108
 109
 110 <p><b>Q:</b> I ran the backup, but can't find my backup files!
 111 Where did they go?</p>
 112
 113 <p><b>A:</b> The backup program saves all backup files as gzip'd tarballs
 114 under your home directory:  ~/.barry/backup/pin_number/</p>
 115
 116 <p> Each backup session creates a new file, named with the
 117 pin number, date, and time.</p>
 118