WHAT IS THIS WEB PAGE ABOUT?
If you are interested in upgrading BOINC to the latest stable version to make use of added features and improvements, then this web page shows you how you can upgrade without having to re-install BOINC. The steps shown are appropriate for Mandriva, but many steps shown here can be done on other linux distributions.
If you are installing BOINC using a package manager such as RPM, apt-get, yum, or another manager which comes with your linux distribution, you may wish to use that method instead of this How-To since many of the steps shown below are already done for you by your linux distro (The steps shown below are more for your own educational use).
If you prefer to install BOINC manually, under a different user, under a different location, or settings, then these steps allow you to install the latest stable BOINC in an existing location of your own choice, the user you chose, while also allowing you to maintain your current Higher MSEC security settings and also any existing calculations currently in progress without requiring you to do a re-install.
This How-To guide is long, so to keep this guide as short as possible, the following steps here assume you followed the steps in How To Install BOINC On Mandriva Linux and have BOINC running in directory "/opt/BOINC". If you have it located elsewhere, or under your own account, just substitute the appropriate information and locations where necessary.
You may skip or modify some steps shown below to match your existing setup.
SWITCH TO USER BOINC
If you are running BOINC under your own user account, then skip this step about switching to user BOINC.
If you followed recommendations to run BOINC under it's own user account instead of your own account, then the quickest and easiest way to do this is to do all the steps as user BOINC.
Log out of your user account and log into the BOINC user account (skip the steps shown below).
Alternatively, this may be a bit confusing to novice users, but if you are an experienced Linux user, you may understand this and choose to be user BOINC in a Command-line Shell instead (see steps below):
1. 2. 3. 4.
GO GET THE LATEST BOINC
Open up an Internet web browser and Download the latest stable BOINC file to your "~/DeskTop".
RUN THE SCRIPT TO EXPAND BOINC INTO THE TEMPORARY DIRECTORY
The latest version of BOINC at the time this How-To was originally written was version 5.10.45, the steps appear identical with later versions, and this How-To will use 6.4.5 as the example for the following steps (NOTE: large version changes such as 5 to 6 are best to do as a fresh re-install versus an update. You may want to do further checks along the way at your own discretion if you decide to do an upgrade instead).
In this section, you will create a "~/temp_boinc/" directory to expand the downloaded files into before copying the updated files to your "/opt/BOINC/" directory.
The reason for expanding the files into a temporary directory is so that you can modify permissions (if you run BOINC in a Higher MSEC server security level) and so that you only import the files needed since you do not need to copy all the files.
1. 2. 3. 4. 5.
CHANGE PERMISSIONS FOR GROUP ACCESS AND HIGHER MSEC
If you followed the steps in How To Install BOINC On Mandriva Linux then you will want to adjust the permissions to these files before you copy them to your "/opt/BOINC" directory.
You may skip this step if you did not modify permission levels to a Higher MSEC level or if you are running BOINC as yourself from your own user account.
If you decide to do this step, this step may appear optional and unnecessary since files are expected to gain existing permissions of older existing files, however, this is a precaution for setting proper permissions for any new files which do not yet exist on your older version setup.
You may note that later versions of BOINC may already have some desirable permissions already set for you, so some of the steps shown below may also be skipped, for example versions of BOINC such as 6.4.5 have tighter permissions so that only the BOINC user is permitted to run anything (see only the 1st 3 "rwx" are enabled).
1. 2. 3. 4. 5. 6. 7.
STOP THE OLD BOINC, COPY OVER, START THE NEW BOINC
After following the steps above, you now have new BOINC binaries which can be overwritten over the old binaries. For existing files, the permissions you changed are not important since they will take the existing permissions. For new files, you will have the permissions already set to match your existing BOINC setup (if you opted for the Higher MSEC level).
First, if you are running the BOINC manager right now. Stop and exit the manager since you will be updating the manager.
Next, if you installed BOINC to automatically run when your computer boots up, you will need to stop the BOINC client daemon. If you are using Mandriva, you will use the service command in super user mode. For linux distros without the service command, you will need to use an alternative method.
Now that BOINC is stopped, copy the new files over the old files. If you want to clean up, you may want to first delete old files before adding the new files. The additional deletion steps are shown below so that you do not accidently delete too much.
Once the new files are in place, you are ready to restart the BOINC client and continue processing. All the required steps are shown below.
1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
|binstall.sh||no||This script was used for install. Once BOINC is installed, this script is no longer needed. You will NOT want to update this file especially since this updated file script refers to a temporary "~/temp_boinc/BOINC" directory you will remove in a later step below.|
|boinc||yes||BOINC core client. This program will be run as a daemon and you do want to update this with this latest version.|
|boinccmd||yes||Most users may prefer to use the graphical manager, but this program allows you to set BOINC using the command line, you will want to copy this file since it is an updated program.|
|boincmgr||yes||BOINC manager. This program manages the client program, shows stats and is used for choosing projects and you will want to update with this latest version.|
|boincmgr.*.png||yes||The graphical BOINC manager will have several picture PNG files. Some remain the same while others may be updated. Copy all PNG picture files.|
|ca-bundle.crt||yes||This is a certificate used by BOINC to access the BOINC website(s). This file occassionally gets updated, so it is best to always copy the latest version in case the certificate is updated to a new version.|
|libcudart.so||yes||BOINC library. This library is used by the BOINC executable binary programs.|
|locale||--||The options specified in copy did not include directories, so you may note this was skipped.|
|run_client||no||A script that cd's into the BOINC directory and runs the core client. You will NOT want to update this file since this updated version refers to the temporary "~/temp_boinc/BOINC" directory. Keep the old file since the old file points to your existing "/opt/BOINC" directory.|
|run_manager||no||A script that cd's into the BOINC directory and runs the manager. You will NOT want to update this file since this updated version refers to the temporary "~/temp_boinc/BOINC" directory. Keep the old file since the old file points to your existing "/opt/BOINC" directory.|
CHECK IF THE NEW BOINC WORKS WELL
After you restart the BOINC client daemon in the step above, you may want to look at the new BOINC manager by clicking on the shortcut link on the desktop. If you look in the advanced screens, you may note one of the messages showing a version change, for example this update went okay from 5.10.45 to 6.4.5.
If you want to start the BOINC manager using the command line, you can use the following steps:
1. 2. 3.
CLEANUP THE TEMPORARY DIRECTORIES AND FILES
If BOINC works well now, you may want to cleanup all the miscellaneous files created but no longer needed now.
1. 2. 3. 4.
You are done.
|Links To Sections Of This BOINC How To|
|Top Of Page||Switch To BOINC||Get BOINC||Expand In Temp|
|Change Permissions||Stop, Copy, Start||Does BOINC Run?||Cleanup|
|Other Pages On This Web Site|
|Home Page||Install BOINC On Linux||Backup With Tar||Disk Image Backup||Java On Linux|
|android.rules For adb Server||Remove Duplicate Files||Remove Spaces In File Names||Ship Arcade||PicDis Disassembler|