| 1 | <?xml version="1.0" encoding="iso-8859-1"?> |
|---|
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
|---|
| 3 | <html xmlns="http://www.w3.org/1999/xhtml"> |
|---|
| 4 | <head> |
|---|
| 5 | <meta http-equiv="content-type" content="text/html;charset=iso-8859-1" /> |
|---|
| 6 | <title>Troubleshooting Box Backup</title> |
|---|
| 7 | <link rel="stylesheet" href="bbstyles.css" type="text/css" /> |
|---|
| 8 | </head> |
|---|
| 9 | <body> |
|---|
| 10 | <div align="center"> |
|---|
| 11 | <div id="header"> |
|---|
| 12 | <div id="logo"> |
|---|
| 13 | <img src="images/bblogo.png" alt="logo" height="65" width="331" border="0" vspace="5" align="middle" /> <img src="images/stepahead.png" alt="a step ahead in data security" width="182" height="11" hspace="10" vspace="20" border="0" align="middle" /></div> |
|---|
| 14 | </div> |
|---|
| 15 | <div id="page"> |
|---|
| 16 | |
|---|
| 17 | <h1>Troubleshooting Box Backup</h1> |
|---|
| 18 | |
|---|
| 19 | <p><ul><li><b>Note</b>: If you are trying to fix a store after your disc has been corrupted, see |
|---|
| 20 | <a href="serverfix.html">fixing problems with corruption on the server</a>.</ul></p> |
|---|
| 21 | |
|---|
| 22 | <p>Unfortunately, the error messages are not particularly helpful at the moment. This page lists |
|---|
| 23 | some of the common errors, and the most likely causes of them.</p> |
|---|
| 24 | |
|---|
| 25 | <p>When an error occurs, you will see a message like '<tt>Exception: RaidFile/OSFileError (2/8)</tt>' either |
|---|
| 26 | on the screen or in your log files. (it is recommended you set up another log file as recommended |
|---|
| 27 | in the <a href="server.html">server setup instructions</a>.)</p> |
|---|
| 28 | |
|---|
| 29 | <p>This error may not be particularly helpful, although some do have extra information about probable causes. |
|---|
| 30 | To get further information, check the <tt>ExceptionCodes.txt</tt> file in the root of the distribution. |
|---|
| 31 | This file is generated by the <tt>./configure</tt> script, so you will need to have run that first.</p> |
|---|
| 32 | |
|---|
| 33 | <p>Some common causes of exceptions are listed below.</p> |
|---|
| 34 | |
|---|
| 35 | <p>Please email me with any other codes you get, and I will let you know what they mean, and add |
|---|
| 36 | notes here.</p> |
|---|
| 37 | |
|---|
| 38 | |
|---|
| 39 | <h2>RaidFile (2/8)</h2> |
|---|
| 40 | |
|---|
| 41 | <p>This is found either when running <tt>bbstoreaccounts</tt> or in the <tt>bbstored</tt> logs.</p> |
|---|
| 42 | |
|---|
| 43 | <p><b>Problem:</b> The directories you specified in the raidfile.conf are not writable by the _bbstored user.</p> |
|---|
| 44 | |
|---|
| 45 | <p><b>Resolution:</b> Change permissions appropriately.</p> |
|---|
| 46 | |
|---|
| 47 | |
|---|
| 48 | <h2>Common (1/2)</h2> |
|---|
| 49 | |
|---|
| 50 | <p>This usually occurs when the configuration files can't be opened.</p> |
|---|
| 51 | |
|---|
| 52 | <p><b>Problem:</b> You created your configurations in non-standard locations, and the programs |
|---|
| 53 | cannot find them.</p> |
|---|
| 54 | |
|---|
| 55 | <p><b>Resolution:</b> Explicitly specify configuration file locations to daemons and programs. For example</p> |
|---|
| 56 | <pre> |
|---|
| 57 | /usr/local/bin/bbstored /some/other/dir/bbstored.config |
|---|
| 58 | /usr/local/bin/bbackupquery -c /some/other/dir/bbackupd.config |
|---|
| 59 | </pre> |
|---|
| 60 | <p>(daemons specify the name as the first argument, utility programs with the <tt>-c</tt> option.</p> |
|---|
| 61 | |
|---|
| 62 | <p><b>Problem:</b> <tt>bbstored</tt> can't find the <tt>raidfile.conf</tt> file specified in <tt>bbstored.conf</tt>.</p> |
|---|
| 63 | |
|---|
| 64 | <p><b>Resolution:</b> Edit <tt>bbstored.conf</tt> to point to the correct location of this additional configuration file.</p> |
|---|
| 65 | |
|---|
| 66 | |
|---|
| 67 | <h2>Server (3/16)</h2> |
|---|
| 68 | |
|---|
| 69 | <p>The server can't listen for connections on the IP address specified when you configured it.</p> |
|---|
| 70 | |
|---|
| 71 | <p><b>Problem:</b> This probably means you've specified the wrong hostname to bbstored-config -- |
|---|
| 72 | maybe your server is behind a NAT firewall?</p> |
|---|
| 73 | |
|---|
| 74 | <p><b>Resolution:</b> Edit <tt>bbstored.conf</tt> and correct the <tt>ListenAddresses</tt> line. You |
|---|
| 75 | should replace the server address with the IP address of your machine.</p> |
|---|
| 76 | |
|---|
| 77 | |
|---|
| 78 | <h2>Connection (7/x)</h2> |
|---|
| 79 | |
|---|
| 80 | <p>These errors all relate to connections failing -- you may see them during operation if there |
|---|
| 81 | are network failures or other problems between the client and server. The backup system will recover |
|---|
| 82 | from them automatically.</p> |
|---|
| 83 | |
|---|
| 84 | |
|---|
| 85 | <p> </p> |
|---|
| 86 | |
|---|
| 87 | <h1>Advanced troubleshooting</h1> |
|---|
| 88 | |
|---|
| 89 | <p>If this really doesn't help, then using the DEBUG builds of the system will give you much more |
|---|
| 90 | information -- a more descriptive exception message and the file and line number where the error occurred.</p> |
|---|
| 91 | |
|---|
| 92 | <p>For example, if you are having problems with <tt>bbstoreaccounts</tt>, build the debug version with</p> |
|---|
| 93 | |
|---|
| 94 | <pre> |
|---|
| 95 | cd boxbackup-0.0 |
|---|
| 96 | cd bin/bbstoreaccounts |
|---|
| 97 | make |
|---|
| 98 | </pre> |
|---|
| 99 | |
|---|
| 100 | <p>(within the module directories, <tt>make</tt> defaults to building the debug version. At the top level, |
|---|
| 101 | it defaults to release.)</p> |
|---|
| 102 | |
|---|
| 103 | <p>This will build an executable in <tt>debug/bin/bbstoreaccounts</tt> which you can then use instead |
|---|
| 104 | of the release version. It will give far more useful error messages.</p> |
|---|
| 105 | |
|---|
| 106 | <p>When you get an error message, use the file and line number to locate where the error occurs in the |
|---|
| 107 | code. There will be comments around that line to explain why the exception happened.</p> |
|---|
| 108 | |
|---|
| 109 | <p>If you are using a debug version of a daemon, these extended messages are found in the log files.</p> |
|---|
| 110 | |
|---|
| 111 | <p>Please get in touch if you need any help.</p> |
|---|
| 112 | |
|---|
| 113 | <p> </p> |
|---|
| 114 | <p>© Ben Summers, 2003, 2004</p> |
|---|
| 115 | <p> </p> |
|---|
| 116 | </div> |
|---|
| 117 | </div> |
|---|
| 118 | </body> |
|---|
| 119 | </html> |
|---|
| 120 | |
|---|
| 121 | |
|---|
| 122 | |
|---|
