Jord: adding Installing BOINC on Gentoo copy from BOINC User Manual wiki

2016-09-05T14:30:59Z

adding Installing BOINC on Gentoo copy from BOINC User Manual wiki

New page

==Basic installation==
Installs BOINC Client as a daemon (autostarts the BOINC client at boot time) and puts a BOINC Manager icon on the "Start Menu" if you have a GUI Desktop installed. Open a terminal and become root. Then enter the following commands:

{{Template:Important
| text = '''BOINC is currently [http://dev.gentoo.org/~dang/masked.txt masked] in Portage.'''<br />
The first command will allow you to bypass the mask
}}

# <code>echo "sci-misc/boinc" >> /etc/portage/package.keywords</code>
# <code>emerge --sync</code>
# <code>emerge sci-misc/boinc</code> 
# Optional: after the installation is finished, enter <code>rc-update add boinc default</code> to have Linux auto-start the boinc-client daemon at boot time. (See [http://boinc.berkeley.edu/wiki/Stop_or_start_BOINC_daemon_after_boot Stop or start BOINC daemon after boot] in the BOINC User Manual Wiki for helpful commands for managing the daemon).

==What the installer does==
# Creates the daemon script at /etc/init.d/boinc
# Creates the daemon script configuration file at /etc/conf.d/boinc.
# Puts the BOINC binaries (boinc_client, boinc_cmd and boincmgr) in /usr/bin/boinc
# Creates /var/lib/boinc/ for BOINC data files and the slots and projects directories.
# Names the daemon <code>boinc</code>
# Creates a user named '''boinc'''. For security, '''boinc''' owns the BOINC data directory (/var/lib/boinc/) and all the data files and sub-directories it creates in the data directory.

==Verify the installation==
# Start the daemon with <code>/etc/init.d/boinc start</code>
# Open a terminal and enter <code>ps aux | grep boinc</code> to print a partial list of running processes. You should see <code>boinc_client</code> in that list, if not then something went wrong in the steps above.

==Set up your accounts==

To use the GUI to set up your accounts and monitor progress:
# Start "boincmgr" on the command line or select Applications -> System Tools -> Boinc Manager from the GNOME menu.
# Select Advanced -> Select computer... from the Boinc Manager menu.
# Put "localhost" in for "Host name" and the contents of /var/lib/boinc/gui_rpc_auth.cfg for "Password" and hit "OK".

To make the GUI passwordless instead, 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. "/etc/init.d/boinc restart").

Alternatively, you can use the command-line interface to set up your accounts. See "[http://boinc.berkeley.edu/wiki/Boinccmd_tool man boinc_cmd]" for instructions.

==Optional setup hints==
''For more information about configuring BOINC in Linux, see [http://boinc.berkeley.edu/wiki/Linux_file_permissions Linux file permissions] in the BOINC User Manual Wiki.''

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, changing your projects, etc. Another inconvenience is that boinc (the user named boinc) owns /var/lib/boinc/ and all the files and directories in it so you will not be able to edit those files from your regular user account unless you add your username to the boinc group and adjust some permissions as follows, substituting your username for <username>:
# As root, open /etc/group in a text editor.
# Look for the line starting with boinc:x:<group ID number>:
# Edit the line to look like <code>boinc:x:<group ID number>:<username></code> (<group ID number> will be a number, do not change it)
# Save the file and close the editor.
All the above can be done by: (sudo) gpasswd -a <username> boinc
# Open a terminal as root and enter the following commands, substitude your username for <username>:
## <code>ln -s /var/lib/boinc/gui_rpc_auth.cfg /home/<username>/gui_rpc_auth.cfg</code>

## <code>chown boinc:boinc /home/<username>/gui_rpc_auth.cfg</code>
## <code>chown boinc:boinc /var/lib/boinc/gui_rpc_auth.cfg</code>
## <code>chmod -R g+r /var/lib/boinc</code>



==Uninstallation==
As root, in a terminal, enter
emerge -C sci-misc/boinc

==Troubleshooting==
In case you get <code> SSL connection error</code>, this can be solved by re-emerging curl with gnutls USE flag disabled:
echo "net-misc/curl -gnutls" >> /etc/portage/package.use
emerge -1 net-misc/curl

Installing BOINC on Gentoo - Revision history

Jord: adding Installing BOINC on Gentoo copy from BOINC User Manual wiki