forked from pool/boinc-client
Jan Engelhardt
36847e308a
- Use systemd-sysusers to create service user and group. - Add service user to "render" group to allow BOINC applications to use GPU devices for accelerated computation. DRM render nodes have been restricted in sr#1128161. - Remove unused SysV init script. - Update README.SUSE and the logrotate configuration file to use systemctl instead of the no longer relevant init script. OBS-URL: https://build.opensuse.org/request/show/1137157 OBS-URL: https://build.opensuse.org/package/show/network/boinc-client?expand=0&rev=114
124 lines
5.2 KiB
Plaintext
124 lines
5.2 KiB
Plaintext
|
|
#####################################################################################################################
|
|
Exported from http://boinc.berkeley.edu/wiki/Installing_BOINC on May 15, 2010, see current version online.
|
|
#####################################################################################################################
|
|
|
|
Installing BOINC on openSUSE
|
|
|
|
|
|
* 1 Basic installation
|
|
* 2 What the installer does
|
|
* 3 Verify the installation
|
|
* 4 Set up your accounts
|
|
* 5 Optional setup hints
|
|
* 6 Uninstallation
|
|
* 7 Known problems
|
|
|
|
Basic installation
|
|
|
|
Installs BOINC Client as a daemon (autostarts the BOINC client at boot
|
|
time) and puts a BOINC Manager icon on the applications menu. The steps
|
|
are:
|
|
|
|
1. Open a terminal, enter |su|, give the root password when prompted.
|
|
2. Enter |zypper install boinc-client boinc-manager|
|
|
(be patient while the BOINC package downloads and installs).
|
|
3. Optional: after the installation is finished, enter
|
|
|/usr/bin/systemctl enable boinc-client.service|
|
|
to have Linux auto-start the boinc-client daemon at boot time.
|
|
(See Stop or start BOINC daemon after boot
|
|
page for helpful
|
|
commands for managing the daemon)
|
|
|
|
|
|
What the installer does
|
|
|
|
1. Creates a systemd configuration file for boinc-client.service.
|
|
2. Places the BOINC binaries (boinc-client, boinccmd, boinc-gui
|
|
and boincmgr) in /usr/bin/.
|
|
3. Creates /var/lib/boinc/ for BOINC data files and the slots and
|
|
projects directories.
|
|
4. Names the daemon boinc-client.
|
|
5. 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
|
|
|
|
1. 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.
|
|
2. If you elected to not have Linux start the daemon at boot time,
|
|
start the daemon manually with |/usr/bin/systemctl start boinc-client.service |
|
|
3. Open a terminal and enter |ps aux | grep boinc| to print a partial
|
|
list of running processes. You should see |boinc-client --dir ...|
|
|
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".
|
|
|
|
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:
|
|
|
|
1. disable the password at all [*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.
|
|
"/sbin/service boinc-client restart").
|
|
2. *with boinc-client-6.4.7-1.r17542svn and newer* it is enough if
|
|
you just add your user account into the "boinc" group, e.g. by
|
|
typing |/usr/sbin/usermod -G boinc -a username|
|
|
3. *with older versions* the procedure is a bit more complicated:
|
|
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 easily from your regular user account. The steps below add
|
|
your username to the boinc group 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 root:
|
|
1. |/usr/sbin/usermod -A boinc username|
|
|
2. |chmod g+rw /var/lib/boinc|
|
|
3. |chmod g+rw /var/lib/boinc/*.*|
|
|
4. |ln -s /var/lib/boinc/gui_rpc_auth.cfg
|
|
/home/username/gui_rpc_auth.cfg|
|
|
5. |chown boinc:boinc /home/username/gui_rpc_auth.cfg|
|
|
|
|
|
|
Uninstallation
|
|
|
|
As root, in a terminal, enter
|
|
|
|
yum remove boinc-client boinc-manager
|
|
|
|
|
|
Known problems
|
|
|
|
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 root, do "/usr/bin/systemctl restart boinc-client.service".
|
|
Alternatively, from the GNOME menu, you can choose System ->
|
|
Administration -> Services and then stop and start the boinc-client
|
|
service.
|