Difference between revisions of "BOINC"

From ArchWiki
Jump to: navigation, search
m
m (+link to the french wiki page)
(44 intermediate revisions by 23 users not shown)
Line 1: Line 1:
[[Category:Other desktop user's resources (English)]]
+
[[Category:Mathematics and science]]
{{i18n_links_start}}
+
[[de:BOINC]]
{{i18n_entry|Italian|BOINC_(Italiano)}}
+
[[fr:BOINC]]
{{i18n_links_end}}
+
[[it:BOINC]]
 +
[[ja:BOINC]]
 +
[[sk:BOINC]]
 +
[http://boinc.berkeley.edu/ BOINC website]: ''"Use the idle time on your computer (Windows, Mac, or Linux) to cure diseases, study global warming, discover pulsars, and do many other types of scientific research. It's safe, secure, and easy."''
  
== What is BOINC ==
+
[[Wikipedia:BOINC|Wikipedia]]: ''"The Berkeley Open Infrastructure for Network Computing (BOINC) is a non-commercial middleware system for volunteer and grid computing. It was originally developed to support the SETI@home project before it became useful as a platform for other distributed applications in areas as diverse as mathematics, medicine, molecular biology, climatology, and astrophysics. The intent of BOINC is to make it possible for researchers to tap into the enormous processing power of personal computers around the world."''
BOINC website: ''"Use the idle time on your computer (Windows, Mac, or Linux) to cure diseases, study global warming, discover pulsars, and do many other types of scientific research. It's safe, secure, and easy."''
+
  
Wikipedia: ''"The Berkeley Open Infrastructure for Network Computing (BOINC) is a non-commercial middleware system for volunteer and grid computing. It was originally developed to support the SETI@home project before it became useful as a platform for other distributed applications in areas as diverse as mathematics, medicine, molecular biology, climatology, and astrophysics. The intent of BOINC is to make it possible for researchers to tap into the enormous processing power of personal computers around the world."''
+
== Installation ==
 +
[[Pacman|Install]] the package {{Pkg|boinc}} from the [[Official Repositories]].
  
== Install BOINC ==
+
The name of the daemon is {{ic|boinc.service}}. Start it and configure to autostart on boot. Read [[Daemons]] for details.
=== Overview ===
+
BOINC is installed as a daemon and for security reasons will be run under the newly created ''boinc'' user. We will add ourself to the ''boinc'' group and create a link to the password file so that we can manage it via the GUI.
+
  
=== Instructions ===
+
BOINC is installed as a daemon and for security reasons will be run under the newly created ''boinc'' user. We will add ourself to the ''boinc'' group and create a link to the password file so that we can manage it via the GUI.
Install BOINC via pacman:
+
# pacman -S boinc
+
  
 +
=== Headless Servers ===
  
BOINC runs as a daemon, to run at start up add it to the daemons section in /etc/rc.conf:
+
If you're planning to run BOINC on a headless server, and would like to avoid installing wkWidgets and GTK for a GUI that you won't use anyway, consider installing {{Pkg|boinc-nox}}.
DAEMONS=(... boinc ...)
+
 
+
 
+
Add your user to the ''boinc'' group. You will need to log out and in again for it to take effect.
+
# gpasswd -a username boinc
+
 
+
 
+
If you want, you can easily check if you are now part of the ''boinc'' group by using the groups command:
+
$ groups
+
 
+
 
+
Start the BOINC daemon:
+
# /etc/rc.d/boinc start
+
 
+
 
+
Check if BOINC is running:
+
$ ps aux | grep boinc
+
  
 
== Using BOINC ==
 
== Using BOINC ==
 
=== BOINC via the GUI ===
 
=== BOINC via the GUI ===
By default, a password is created in /var/lib/boinc/gui_rpc_auth.cfg for
+
By default, a password is created in {{ic|/var/lib/boinc/gui_rpc_auth.cfg}} for connecting to the daemon. To simplify connection of the GUI to the daemon, cd to your home directory, create a link to the file, and change permissions to allow read access to boinc group members.
connecting to the daemon. To simplify connection of the GUI to the
+
daemon, cd to your home directory, create a link to the file, and change
+
permissions to allow read access to boinc group members.
+
  
  $ cd
+
  $ cd ~/
 
  $ ln -s /var/lib/boinc/gui_rpc_auth.cfg gui_rpc_auth.cfg
 
  $ ln -s /var/lib/boinc/gui_rpc_auth.cfg gui_rpc_auth.cfg
 
  # chmod 640 gui_rpc_auth.cfg
 
  # chmod 640 gui_rpc_auth.cfg
  
If you prefer a different password, or none at all, you can edit /var/lib/gui_rpc_auth.cfg.
+
If you prefer a different password, or none at all, you can edit {{ic|/var/lib/boinc/gui_rpc_auth.cfg}}. Then restart BOINC daemon.
  
If you don't like the idea of having this file in your home directory, there is an alternative approach.  Boinc Manager will also look for a readable gui_rpc_auth.cfg file in the current working directory.  If you make the file readable by the '''boinc''' group and ensure that the manager is run with '''/var/lib/boinc''' as the working directory, you should find that the client connects to the daemon automatically, as desired.  This can usually be achieved via the menu editor in your desktop environment of choice.
+
If you do not like the idea of having this file in your home directory, there is an alternative approach.  BOINC Manager will also look for a readable gui_rpc_auth.cfg file in the current working directory.  If you make the file readable by the '''boinc''' group and ensure that the manager is run with {{ic|/var/lib/boinc}} as the working directory, you should find that the client connects to the daemon automatically, as desired.  This can usually be achieved via the menu editor in your desktop environment of choice.
  
To start the GUI, use the ''boinc_gui'' command
+
To start the GUI, use the ''boincmgr'' command
  $ boinc_gui
+
  $ boincmgr
  
 
BOINC should now take you through the process of attaching to a project. NB, some projects will let you create an account remotely via the GUI while some may require you to first create an account via their website. You can attach to multiple projects if you have the resources (disk space, time, CPU power). Do this via menu option ''Tools / Attach to project''.
 
BOINC should now take you through the process of attaching to a project. NB, some projects will let you create an account remotely via the GUI while some may require you to first create an account via their website. You can attach to multiple projects if you have the resources (disk space, time, CPU power). Do this via menu option ''Tools / Attach to project''.
  
If BOINC didn't ask you to connect to a project, then make sure you are connected to the daemon. Go to menu option ''Advanced / Select computer'', choose your machine's name and enter the password. (To avoid this, make sure the above steps regarding gui_rpc_auth.cfg have been done.)
+
If BOINC did not ask you to connect to a project, then make sure you are connected to the daemon. Go to menu option ''Advanced / Select computer'', choose your machine's name and enter the password. (To avoid this, make sure the above steps regarding gui_rpc_auth.cfg have been done.)
  
==== .desktop file sample ====
+
==== Projects using GPU ====
The following is a sample of .desktop file. In order to use this sample, you have to put a password file or the symlink in your home directory (see above).
+
If you want to use your GPU, you need the proprietary nvidia or amd drivers. For ATI/AMD Cards you also need [https://aur.archlinux.org/packages.php?ID=21933 Catalyst driver for stock kernel] which you can get from AUR. For Nvidia, you also need the package {{Pkg|opencl-nvidia}} located in extra.
*file name: boinc_gui.desktop
+
*path: ${XDG_DATA_HOME}/applications/ (default: ~/.local/share/applications/) or /usr/share/applications/
+
[Desktop Entry]
+
Type=Application
+
Name=BOINC Manager
+
GenericName=BOINC client manager
+
Comment=Configure and monitor a BOINC client
+
Icon=/usr/share/boinc/boincmgr.48x48.png
+
Exec=boinc_gui
+
Terminal=false
+
Categories=System;Monitor;GTK;
+
"BOINC Manager" menu item appears under [System] menu.
+
  
=== BOINC via the command line ===
+
In addition, the boinc user should be in the video group:
As of writing (version 2.6.15), the man pages (and references within) and the CLI commands aren't consistent with each other.
+
  # gpasswd -a boinc video
 
+
The boinc user also needs to have access to your X session. Use this command to accomplish this:
  '''Man Page CLI equivalent'''
+
  xhost local:boinc
boinc boinc_client
+
You may want to add that to a startup script.
  boinccmd boinc_cmd
+
boincmgr boinc_gui
+
  
 
== Log files ==
 
== Log files ==
NB, BOINC places log files in /var/lib/boinc/
+
NB, BOINC places log files in {{ic|/var/lib/boinc/}}
 
  /var/lib/boinc/stderrdae.txt
 
  /var/lib/boinc/stderrdae.txt
 
  /var/lib/boinc/stdoutdae.txt
 
  /var/lib/boinc/stdoutdae.txt
  
 
== Considerations when choosing a project ==
 
== Considerations when choosing a project ==
Projects have different minimum hardware requirements (CPU, disk space), and different times to taken to run each work unit. If you don't finish a work unit before the deadline it will sent out to someone else, but it is better to look around to see what projects suit your machine and your uptime patterns to avoid this happening.   
+
Projects have different minimum hardware requirements (CPU, disk space), and different times to taken to run each work unit. If you do not finish a work unit before the deadline it will sent out to someone else, but it is better to look around to see what projects suit your machine and your uptime patterns to avoid this happening.   
  
 
Also, if it is important to you, check if the project makes the data and results publicly available.
 
Also, if it is important to you, check if the project makes the data and results publicly available.
   
+
 
== Links ==
+
=== Running on Arch64 ===
 +
Some projects provide only 32bit applications which may require 32bit libraries to run work units or show graphics. You will find most of these libraries in the [multilib] repository.
 +
 
 +
;To run WUs (e.g. Climateprediction)
 +
:{{Pkg|lib32-glibc}}, {{Pkg|lib32-glib2}}
 +
;To show graphics (e.g. Several projects of WCG, Climateprediction)
 +
:{{Pkg|lib32-pango}}, {{Pkg|lib32-libxdamage}}, {{Pkg|lib32-libxi}}, {{Pkg|lib32-libgl}}, {{AUR|lib32-libjpeg6}} (AUR), and {{Pkg|lib32-libxmu}}
 +
 
 +
==Troubleshooting==
 +
=== GPU missing ===
 +
If you get this error :
 +
{{bc|GPU Missing}}
 +
and the Work Unit does not start, you should [[Daemons|restart]] the {{ic|boinc.service}} daemon.
 +
 
 +
This will happen if the BOINC daemon starts before the an X session is fully initialized.
 +
 
 +
===Laptop overheating and battery duration reduction===
 +
If you run BIONC on a laptop with the ondemand governor (the default), it will keep the CPUs at their maximum frequencies (over)heating them and decreasing battery duration. The best way to fix this is to tell the ondemand to not rise the CPU frequencies for BIONC:
 +
{{bc|# echo 1 >/sys/devices/system/cpu/cpufreq/ondemand/ignore_nice_load}}
 +
 
 +
To do this on boot, create the following tmpfiles.d config:
 +
{{hc|/etc/tmpfiles.d/ondemand-ignore-nice.conf|
 +
w /sys/devices/system/cpu/cpufreq/ondemand/ignore_nice_load - - - - 1}}
 +
 
 +
=== Unable to download with World Community Grid ===
 +
If you're unable to download new work units for the World Community Grid project, the problem comes from openssl, so we need to rebuild a package with a small fix in it to allow downloads.
 +
 
 +
First, we're going to get the sources for openssl using git:
 +
$ git clone git://projects.archlinux.org/svntogit/packages.git --single-branch --branch packages/openssl
 +
 
 +
This will give you four files in ./packages/trunk/, including a PKGBUILD. The PKGBUILD is not the right one, so we need to get the correct one which you can get [http://pastebin.com/pYcYf4dr here].
 +
 
 +
Now we just have to create the package:
 +
$ makepkg
 +
 
 +
This sould give you a file ending in *.pkg.tar.xz, all that's left is to install it, and restart the boinc service:
 +
 
 +
# pacman -U openssl-1.0.1.c-1-x86_64.pkg.tar.xz
 +
# systemctl restart boinc
 +
 
 +
Your new work units should now be able to download. If you have any trouble, the original thread on the forum can be seen [https://bbs.archlinux.org/viewtopic.php?pid=1160393#p1160393 here].
 +
 
 +
== See also ==
 
* [http://boinc.berkeley.edu/ BOINC homepage]
 
* [http://boinc.berkeley.edu/ BOINC homepage]
 
* [http://boinc.berkeley.edu/projects.php List of BOINC projects]
 
* [http://boinc.berkeley.edu/projects.php List of BOINC projects]
* [http://en.wikipedia.org/wiki/BOINC Wikipedia entry]
+
* [[Wikipedia:BOINC|Wikipedia entry]]

Revision as of 07:25, 29 July 2013

BOINC website: "Use the idle time on your computer (Windows, Mac, or Linux) to cure diseases, study global warming, discover pulsars, and do many other types of scientific research. It's safe, secure, and easy."

Wikipedia: "The Berkeley Open Infrastructure for Network Computing (BOINC) is a non-commercial middleware system for volunteer and grid computing. It was originally developed to support the SETI@home project before it became useful as a platform for other distributed applications in areas as diverse as mathematics, medicine, molecular biology, climatology, and astrophysics. The intent of BOINC is to make it possible for researchers to tap into the enormous processing power of personal computers around the world."

Installation

Install the package boinc from the Official Repositories.

The name of the daemon is boinc.service. Start it and configure to autostart on boot. Read Daemons for details.

BOINC is installed as a daemon and for security reasons will be run under the newly created boinc user. We will add ourself to the boinc group and create a link to the password file so that we can manage it via the GUI.

Headless Servers

If you're planning to run BOINC on a headless server, and would like to avoid installing wkWidgets and GTK for a GUI that you won't use anyway, consider installing boinc-nox.

Using BOINC

BOINC via the GUI

By default, a password is created in /var/lib/boinc/gui_rpc_auth.cfg for connecting to the daemon. To simplify connection of the GUI to the daemon, cd to your home directory, create a link to the file, and change permissions to allow read access to boinc group members.

$ cd ~/
$ ln -s /var/lib/boinc/gui_rpc_auth.cfg gui_rpc_auth.cfg
# chmod 640 gui_rpc_auth.cfg

If you prefer a different password, or none at all, you can edit /var/lib/boinc/gui_rpc_auth.cfg. Then restart BOINC daemon.

If you do not like the idea of having this file in your home directory, there is an alternative approach. BOINC Manager will also look for a readable gui_rpc_auth.cfg file in the current working directory. If you make the file readable by the boinc group and ensure that the manager is run with /var/lib/boinc as the working directory, you should find that the client connects to the daemon automatically, as desired. This can usually be achieved via the menu editor in your desktop environment of choice.

To start the GUI, use the boincmgr command

$ boincmgr

BOINC should now take you through the process of attaching to a project. NB, some projects will let you create an account remotely via the GUI while some may require you to first create an account via their website. You can attach to multiple projects if you have the resources (disk space, time, CPU power). Do this via menu option Tools / Attach to project.

If BOINC did not ask you to connect to a project, then make sure you are connected to the daemon. Go to menu option Advanced / Select computer, choose your machine's name and enter the password. (To avoid this, make sure the above steps regarding gui_rpc_auth.cfg have been done.)

Projects using GPU

If you want to use your GPU, you need the proprietary nvidia or amd drivers. For ATI/AMD Cards you also need Catalyst driver for stock kernel which you can get from AUR. For Nvidia, you also need the package opencl-nvidia located in extra.

In addition, the boinc user should be in the video group:

# gpasswd -a boinc video

The boinc user also needs to have access to your X session. Use this command to accomplish this:

xhost local:boinc

You may want to add that to a startup script.

Log files

NB, BOINC places log files in /var/lib/boinc/

/var/lib/boinc/stderrdae.txt
/var/lib/boinc/stdoutdae.txt

Considerations when choosing a project

Projects have different minimum hardware requirements (CPU, disk space), and different times to taken to run each work unit. If you do not finish a work unit before the deadline it will sent out to someone else, but it is better to look around to see what projects suit your machine and your uptime patterns to avoid this happening.

Also, if it is important to you, check if the project makes the data and results publicly available.

Running on Arch64

Some projects provide only 32bit applications which may require 32bit libraries to run work units or show graphics. You will find most of these libraries in the [multilib] repository.

To run WUs (e.g. Climateprediction)
lib32-glibc, lib32-glib2
To show graphics (e.g. Several projects of WCG, Climateprediction)
lib32-pango, lib32-libxdamage, lib32-libxi, lib32-libgl, lib32-libjpeg6AUR (AUR), and lib32-libxmu

Troubleshooting

GPU missing

If you get this error :

GPU Missing

and the Work Unit does not start, you should restart the boinc.service daemon.

This will happen if the BOINC daemon starts before the an X session is fully initialized.

Laptop overheating and battery duration reduction

If you run BIONC on a laptop with the ondemand governor (the default), it will keep the CPUs at their maximum frequencies (over)heating them and decreasing battery duration. The best way to fix this is to tell the ondemand to not rise the CPU frequencies for BIONC:

# echo 1 >/sys/devices/system/cpu/cpufreq/ondemand/ignore_nice_load

To do this on boot, create the following tmpfiles.d config:

/etc/tmpfiles.d/ondemand-ignore-nice.conf
w /sys/devices/system/cpu/cpufreq/ondemand/ignore_nice_load - - - - 1

Unable to download with World Community Grid

If you're unable to download new work units for the World Community Grid project, the problem comes from openssl, so we need to rebuild a package with a small fix in it to allow downloads.

First, we're going to get the sources for openssl using git:

$ git clone git://projects.archlinux.org/svntogit/packages.git --single-branch --branch packages/openssl

This will give you four files in ./packages/trunk/, including a PKGBUILD. The PKGBUILD is not the right one, so we need to get the correct one which you can get here.

Now we just have to create the package:

$ makepkg 

This sould give you a file ending in *.pkg.tar.xz, all that's left is to install it, and restart the boinc service:

# pacman -U openssl-1.0.1.c-1-x86_64.pkg.tar.xz
# systemctl restart boinc

Your new work units should now be able to download. If you have any trouble, the original thread on the forum can be seen here.

See also