doc/www/troubleshooting.php

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