# BOINC

From the 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.

From Wikipedia:BOINC:

  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 either the boinc or the boinc-nox package. The latter omits Xorg dependencies, and is therefore suited for use on headless servers.

Both packages install a unit file named `boinc.service`.

You will also need to add yourself to the `boinc` group in order for the manager to connect:

    # usermod -a -G boinc $(whoami)

To generate the necessary files referenced in the next section, make sure to start `boinc.service`.

## 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. To prevent computing errors on x86_64 you most likely need the OpenGL (Multilib) package listed in Xorg#Driver installation.

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.

### BOINC via the CLI

Install boinc-nox to use BOINC on a headless system. Two command-line management tools are available: `boinccmd` and `boinc`. `boinccmd` is recommended. To use `boinccmd`, you must:

1. Start the BOINC service.
2. Provide `boinccmd` with a password for communicating with the service's RPC API.

To start the BOINC service, use the provided `boinc.service` unit file. (For more information, see Systemd#Using units.) The first time BOINC starts, it will generate a password and save it to `/var/lib/boinc/gui_rpc_auth.cfg`. To provide `boinccmd` with this password, consider one of the following:

- Provide the password as a command-line flag, e.g. `boinccmd --passwd abc123 --get_host_info`.
- Ensure a file named `gui_rpc_auth.cfg` is present in the current directory.

That done, you can register with a project and attach BOINC to the project.

To register with a project, you may be able to use the command-line client, or you may need to register with a separate website. To register with a project from the command-line, pick a project from BOINC Wiki Project List, and execute a command like `boinccmd --passwd abc123 --create_account ${project_url} ${my_email} ${project_password} ${project_username}` . Regardless of how you register, you must obtain a key for each project you'd like BOINC to attach to. To attach BOINC to a project, execute a command like `boinccmd --passwd abc123 --project_attach ${project_url} ${project_key}` .

## 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-mesa-libgl, lib32-libjpeg6-turbo, 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 BOINC:

    # 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

The factual accuracy of this article or section is disputed.

Reason: Pointing to modified PKGBUILD without explaining the differences from the official one is just wrong. (Discuss in Talk:BOINC#)

This article or section needs language, wiki syntax or style improvements.

Reason: Modified PKGBUILD should be in AUR (Discuss in Talk:BOINC#)

If you are unable to download new work units for the World Community Grid project, makepkg openssl using a modified PKGBUILD. Then restart `boinc.service`.

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

- BOINC homepage
- List of BOINC projects
- Wikipedia entry

Category:

- Mathematics and science

Hidden categories:

- Pages or sections flagged with Template:Accuracy
- Pages or sections flagged with Template:Style