Installing BOINC on Fedora
Installs BOINC Client as a daemon (autostarts the BOINC client at boot time) and puts a BOINC Manager icon on the applications menu. To install it, open a terminal, enter:
su -c 'yum install boinc-client boinc-manager'
Give the root password when prompted and be patient while the BOINC package downloads and installs.
Alternately, fetch the
boinc-manager rpm packages (using for instance
rpm.pbone.net), and open them with the Package Installer. You'll be prompted for the root password as appropriate.
Optional: if you want to have Linux auto-start boinc-client daemon at boot time, enter
/sbin/chkconfig boinc-client on (in Fedora 16), or
systemctl enable boinc-client.service (in Fedora 17). (See Stop or start BOINC daemon after boot page for helpful commands for managing the daemon)
What the installer does
- Creates the daemon script. In F16:
/etc/init.d/boinc-client. In F17:
- Places the BOINC binaries (
/var/lib/boinc/for BOINC data files and the
- Names the daemon
- Creates a user named
boinc. For security,
boincowns the BOINC data directory (
/var/lib/boinc/) and all the data files and sub-directories it creates in the data directory.
Verify the installation
- If you elected to have Linux start the daemon at boot time (see step 3 in section Basic installation), logout and reboot Linux now and login under your normal user account.
- If you elected to not have Linux start the daemon at boot time, start the daemon manually with in F16
/sbin/service boinc-client start, in F17
systemctl start boinc-client.service
- Open a terminal and enter
ps aux | grep boincto print a partial list of running processes. You should see
boinc_client --daemonin that list; if not, then something went wrong in the steps above.
Or alternatively in F17
systemctl status boinc-client.servicewill display the status of the boinc-client service.
pgrep -l boincwill display the procid and daemon name, that is "2298 boinc_client".
Set up your accounts
To use the GUI to set up your accounts and monitor progress:
boincmgron the command line or select
Applications -> System Tools -> Boinc Managerfrom the GNOME menu.
Advanced -> Select computer...from the Boinc Manager menu.
localhostin for "Host name" and the contents of
/var/lib/boinc/gui_rpc_auth.cfgfor "Password" and hit "OK".
If you do only the basic installation as described above, BOINC manager will not be able to automatically connect to the client. To connect the client you will be required to give the GUI RPC password every time you start BOINC manager. That is not a bug, it is a security feature to prevent other users from using the manager to manipulate the client, change your projects, etc.
If you don't want to put the password every time you run the BOINC manager, you can:
- disable the password [not recommended]
To make the GUI passwordless, do
echo > /var/lib/boinc/gui_rpc_auth.cfg(which replaces the contents of the file with a newline) and then restart boinc-client (with e.g. in F16:
/sbin/service boinc-client restart, in F17:
systemctl restart boinc-client.service).
- use the recommended procedure
Boinc (the user named
/var/lib/boinc/and all the files and directories in it, so you will not be able to edit those files easily from your regular user account. The steps below add your username to the
boincgroup and adjust some permissions so that BOINC manager will automatically connect to BOINC client whenever you start the manager from your regular Linux user account. Also, you will be able to edit files in the BOINC directory without becoming
root. As you type in each command below, substitute your Linux username wherever you see
username. Enter the following commands in a terminal, as
/usr/sbin/usermod -G boinc -a username
chmod g+rw /var/lib/boinc
chmod g+rw /var/lib/boinc/*.*
ln -s /var/lib/boinc/gui_rpc_auth.cfg /home/username/gui_rpc_auth.cfg
- Finally, logout and login again so that your new group membership takes effect.
If you want to use Cuda, install it as described here: https://fedoraproject.org/wiki/Cuda , and install xorg-x11-drv-nvidia-libs (to avoid
libcuda.so.1: cannot open shared object file error message) with this:
su -c 'yum install xorg-x11-drv-nvidia-libs'
You will also need to disable SELinux:
su -c 'setenforce 0'
Optional setup hints
For more information about configuring BOINC in Linux, see Linux file permissions.
Since Fedora such as version 13 has a firewall switched on by default it is necessary to configure exceptions allowing BOINC to communicate via the localhost IP 127.0.0.1 and port 31416.
In a terminal, enter:
su -c 'yum remove boinc-client boinc-manager'
boinc-client sometimes has problems connecting to the network, if the network connection comes up after the client has already started. This is a known BOINC bug, which is filed as #707.
In the meantime, you can fix this by restarting
boinc-client. On the command line, as
/sbin/service boinc-client restart. Alternately, from the GNOME menu, you can choose
System -> Administration -> Services and then stop and start the