| 9 | | * Quit BOINC if it's running, and uninstall BOINC using '''Start/Control Panel/Add and remove programs'''. Install the new version again. |
| 10 | | * If that fails, reinstall the version of BOINC you were previously running (you can get an older version from the [/download_all.php download page]). Uninstall it, then install the new version. |
| 11 | | * If that fails, download the [http://support.microsoft.com/kb/290301 Windows Install Clean Up] utility from Microsoft and run it. The old BOINC version shows up as either BOINC.msi or as a corrupt icon .msi (it'll be the top option). Click on it to select, then click Remove and Exit. Reboot your computer. Install the new version. (Warning: leave all other .msi files as they are, otherwise you will have problems uninstalling other programs). |
| | 12 | == BOINC isn't running properly == |
| 13 | | == Problems attaching to a project == #attaching |
| | 14 | If BOINC isn't working properly, there are two places to look for problems: |
| | 15 | |
| | 16 | === Preferences === |
| | 17 | |
| | 18 | Often, BOINC will be working as expected, but simply not doing what you want. Some preference settings will stop BOINC from doing work entirely. Check the [#Messages messages] if this is the case. Otherwise, [GlobalPrefs review your preferences] looking for settings that may cause the problem you see. As a last resort, reset your preferences to the defaults. |
| | 19 | |
| | 20 | === Messages === |
| | 21 | |
| | 22 | BOINC logs many messages informing you what is happening. If BOINC isn't running properly, there should be an error message shown in the message log. |
| | 23 | |
| | 24 | Use the [ErrorReference error reference] to diagnose and fix the problem based on the error message. |
| | 25 | |
| | 26 | === Problems attaching to a project === #attaching |
| | 27 | |
| | 28 | * '''Check your account name and password and try again''' |
| | 29 | * If your account name contains unusual characters, you may get this error even though you typed the name correctly. Rename your account to use ASCII only, then try again. Once you have attached successfully, you can reset the account name to the original value. |
| 47 | | === Workaround for AOL problem === #aol-bug |
| 48 | | On 20 December 2006 we investigated a problem with the following symptoms: |
| 49 | | |
| 50 | | * The BOINC client connects to some projects but scheduler requests return an error message saying |
| 51 | | {{{ |
| 52 | | Project encountered internal error: shared memory |
| 53 | | }}} |
| 54 | | * The BOINC client fails to attach to other projects, giving the error message: |
| 55 | | {{{ |
| 56 | | The URL you supplied is not that of a BOINC-based project. |
| 57 | | }}} |
| 58 | | |
| 59 | | We believe that this problem only affects people connected to the Internet using AOL, and that it is caused by the AOL software. |
| 60 | | We were able to work around the problem as follows: |
| 61 | | * Reinstall BOINC. When asked what directory to install in, select |
| 62 | | {{{ |
| 63 | | C:\Program Files\BOINC2 |
| 64 | | }}} |
| 65 | | (or any name other than BOINC). |
| 66 | | |
| 67 | | '''Note:''' you must install to a new directory. It doesn't work to rename BOINC to BOINC2, then install. |
| 77 | | == Problems while running BOINC (all platforms) == #running-all |
| 78 | | |
| 79 | | * If you get repeated 'bad checksum' or 'wrong size' errors on downloaded JPEG image files, check the 'Skip image file verification' checkbox in your [GlobalPrefs General Preferences]. Typically this means your ISP is using something called UMTS, which does extra compression of JPEG files. |
| 80 | | * If you have a problem with a particular project, go to the 'Questions and Answers' area of the project's web site. You may find the solution to your problem. If not, post it there, and you'll get help from other users. If the problem persists, use the BOINC Manager to 'reset' that project. This will erase any jobs in progress and start from scratch. |
| 81 | | * If you see an error like |
| 82 | | {{{ |
| 83 | | 2007-06-08 14:33:56 [---] Can't delete previous state file; The file or directory is corrupted and unreadable. (0x570) |
| 84 | | }}} |
| 85 | | then back up your BOINC directory and run chkdsk (Windows) or fsck (Unix) on the drive containing it. If files are irretrievably lost, create a new BOINC directory and reattach all projects. |
