Repairing a BOINC Client Software Installation With The Windows Installer Program
From Unofficial BOINC Wiki
Contents |
[edit] General
Though it should not happen, there are times when it seems that a program does not function correctly. This may be because of the installation of another program interferes with a program already installed on the computer, errors in the shut-down of the computer, or just plain bad luck ...
In those cases, as a simple matter we may be able to cure these problems with some simple steps.
[edit] Preconditions
In order to complete the procedure outlined in this guide, you must meet the following preconditions:
- You must have an operational computer.
- The BOINC Client Software does not appear to be operating correctly. For example:
- The program does not start-up
- You have program "crashes" and the diagnostic information seems to indicate that the fault lies within the BOINC Client Software.
[edit] Set-Up for the Repair Process
[edit] Explanation
You must do some initial steps to set the stage for the repair process, and stop the BOINC Client Software.
In theory it is possible to install or repair an installation of the BOINC Client Software without stopping the BOINC Daemon and the currently running Science Applications. However, I don't recommend the practice.
[edit] Locate the "Installer" program
If you followed the advice we gave you for preserving the "Installer" Package, it will be available on one or more of your computers. Locate the "Installer" and copy it to a location on the computer that you wish to repair.
[edit] Stop the BOINC Client Software
Because the BOINC Client Software makes continuous updates to the BOINC Client Directory, many processes we want to do can cause corruption of the "state" files. To prevent this, all we have to do is stop the BOINC Daemon.
[edit] Single-User or Shared Installations
Open the Pop-Up Menu or the BOINC Manager's File Menu and select "Exit" ("Quit" in OS-X). This will shut down the BOINC Manager and the BOINC Daemon.
Goto Verify All BOINC Processes Have Stopped.
[edit] Services Installation
Perform the following:
- Click on the "Start" Button.
- Click on "Control Panel".
- Double-Click on "Administrative Tools" to open the tools folder.
- Double Click on "Services" (Two gears).
In the "Services" window, locate the entry "BOINC" which is the BOINC Daemon. Right-click on the name and select "Properties" from the pop-up menu.
With the "General" tab selected on the "Properties" window, click on the "Stop" button.
A message window with a progress bar will appear and will show the progress of the stop action. It is possible that the BOINC Daemon will not stop. This is usually indicative of more serious problems in Microsoft Windows® than the BOINC Client Software.
[edit] Verify All BOINC Processes Have Stopped
Depress the CTRL-ALT-DEL keys to bring up the "Task Manager".
Click on the column heading "CPU" twice to sort the column from top to bottom use.
When the BOINC Client Software is running you will see activity on one or more processes. In the example shown here this is for a computer with an Intel Pentium 4 processor with Hyper-Threading and so it shows two processes with 50% each.
On a single threaded CPU you will see one process with time varying up to about 99% which should be the currently executing Science Application.
| Project | Known Process Names |
|---|---|
| BOINC | boinc boincmgr |
| Climateprediction.net | hadsm3 hadsm3um sulphur_cycle |
| Einstein@Home | albert einstein |
| LHC@Home | sixtrack |
| Predictor@Home | mfoldB Charmm |
| PrimeGrid | rsa |
| Rosetta@Home | rosetta |
| SETI@Home | setiathome |
| SIMAP@Home | simap |
| SZTAKI Desktop Grid | search |
| World Community Grid | rosetta |
- Note:
- Some of these Application names may be followed by a version number.
- Note:
- Both Rosetta@Home and World Community Grid use an Application named "rosetta", but in almost all cases the version numbers will be different.
If you have been successful in stopping the BOINC Client Software you will see that the "System Idle Process" has most of the available CPU Time.
[edit] Performing the Repair
[edit] Explanation
At this point we should be ready to perform the actual repair process on the BOINC Client Software.
[edit] Running The Windows® "Installer"
Now we can run the "Installer" to perform an installation, update, repair, or removal of the BOINC Client Software on the computer.
[edit] "Installer" Icon
At this point you should have an installer Program" icon like this on your Desktop (or in the location you saved the "Installer" file).
[edit] "Security Warning" Screen
Depending on the version of Microsoft Windows® that you are running you may see this run time warning after you start the "Installer Program".
Click the "Run" button.
[edit] "Splash" Screen
You should see a "Splash" screen like this example as the installer starts the installation process.
[edit] "Welcome" Screen
This is a "Welcome" screen that tells you what program you are going to install.
Click the "Next >" button.
[edit] "Upgrading BOINC" Screen
This screen indicates that the "Installer" program has detected a previous installation of the BOINC Client Software of the same version as is contained within the current "Installer" Package.
Click the "Next >" button.
[edit] "Repair or Remove" Screen
Click on the "Repair" radio button put a green "dot" in it.
Click the "Next >" button.
[edit] "Ready to Install the Program" Screen
The moment of truth. If you are not sure about your settings, use the "< Back" to go back and review your settings.
If you are sure you want to attempt the repair, then ...
Click the "Install" button.
[edit] "In Progress" Screen
After you have started the install, you will see a screen like this example.
[edit] "Finish" Screen
We suggest that you leave the check mark "set" (the default).
Click the "Finish" button.
[edit] Clean Up
Ok, the BOINC Client Software should be installed and operational. Time for a break!
[edit] BOINC "How-To" Guides Related To Installation
The list that follows contains the BOINC "How-To" Guides, in rough order of use, that are used in the installation and set-up of the BOINC Client Software.
- Note:
- Don't panic! I have pictures and everything!
- Installing the BOINC Client Software And Participating In A BOINC Powered Project (Master Guide)
- Choosing a BOINC Powered Project
- Joining a BOINC Powered Project
- Installing:
- Installing The BOINC Client Software on Microsoft Windows® (all versions).
- Installing The BOINC Client Software on Apple Macintosh OS-X (only; do not attempt to install or run the BOINC Client Software on OS-9)
- Installing The BOINC Client Software on Linux (x86 versions only)
- Installing The BOINC Client Software on SPARC/Solaris
- BOINC and SETI@Home Quick Install Guide for HPUX
- Attaching The BOINC Client Software To A BOINC Powered Project
- Updating or Repairing the BOINC Client Software:
- Updating a BOINC Client Software Installation With The Windows Installer Program
- Repairing a BOINC Client Software Installation With The Windows Installer Program
- Detaching The BOINC Client Software From A BOINC Powered Project
- Uninstalling the BOINC Client Software:
- Miscellaneous Installation Related Tasks
- Deprecated Procedures
