[boinc-client] updated USAGE_FEDORA
Miloš Jakubíček
mjakubicek at fedoraproject.org
Tue Jul 10 06:31:17 UTC 2012
commit 1706eb2cf928144f83b9c8f2ac6cbd07716805e7
Author: Milos Jakubicek <xjakub at fi.muni.cz>
Date: Sat Jun 23 15:21:23 2012 +0200
updated USAGE_FEDORA
USAGE_FEDORA | 386 ++++++++++++++++++++++++++++++++++++++++------------------
1 files changed, 266 insertions(+), 120 deletions(-)
---
diff --git a/USAGE_FEDORA b/USAGE_FEDORA
index 89e6ff4..863c10b 100644
--- a/USAGE_FEDORA
+++ b/USAGE_FEDORA
@@ -1,123 +1,269 @@
-
#####################################################################################################################
-Exported from http://boinc.berkeley.edu/wiki/Installing_BOINC_on_Fedora on July 22, 2009, see current version online.
+Exported from http://boinc.berkeley.edu/wiki/Installing_BOINC_on_Fedora on June 23, 2012, see current version online.
#####################################################################################################################
-Installing BOINC on Fedora
-
-
- * 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 |yum install boinc-client boinc-manager|
- (be patient while the BOINC package downloads and installs).
- 3. Optional: after the installation is finished, enter
- |/sbin/chkconfig boinc-client on|
- 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 the daemon script at /etc/init.d/boinc-client.
- 2. Places the BOINC binaries (boinc_client, boinc_cmd 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 |/sbin/service boinc-client start|
- 3. Open a terminal and enter |ps aux | grep boinc| to print a partial
- list of running processes. You should see |boinc_client --daemon|
- 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 -G boinc -a 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 "/sbin/service boinc-client restart".
-Alternatively, from the GNOME menu, you can choose System ->
-Administration -> Services and then stop and start the boinc-client
-service.
+ Installing BOINC on Fedora
+
+ From BOINC
+
+ Jump to: [5]navigation, [6]search
+
+ Contents
+
+ * [7]1 Basic installation
+ * [8]2 What the installer does
+ * [9]3 Verify the installation
+ * [10]4 Set up your accounts
+ * [11]5 Cuda
+ * [12]6 Optional setup hints
+ * [13]7 Uninstallation
+ * [14]8 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. 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-client and 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 [15]Stop or start BOINC
+ daemon after boot page for helpful commands for managing the daemon)
+
+What the installer does
+
+ 1. Creates the daemon script. In F16: /etc/init.d/boinc-client. In F17:
+ /usr/lib/systemd/system/boinc-client.service.
+ 2. Places the BOINC binaries (boinc_client, boinc_cmd 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 in F16 /sbin/service boinc-client start, in
+ F17 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 --daemon in that
+ list; if not, then something went wrong in the steps above.
+ Or alternatively in F17 system status boinc-client.service will
+ display the status of the boinc-client service.
+ Or 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:
+
+ * 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 [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).
+ 2. use the recommended procedure
+ 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 -G boinc -a 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
+
+Cuda
+
+ If you want to use Cuda, install it as described here:
+ [16]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 [17]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.
+
+Uninstallation
+
+ In a terminal, enter:
+
+ su -c '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 [18]#707.
+
+ In the meantime, you can fix this by restarting boinc-client. On the
+ command line, as root, do /sbin/service boinc-client restart. Alternately,
+ from the GNOME menu, you can choose System -> Administration -> Services
+ and then stop and start the boinc-client service.
+
+ Retrieved from
+ "[19]http://boinc.berkeley.edu/wiki/Installing_BOINC_on_Fedora"
+
+ Views
+
+ * [20]Page
+ * [21]Discussion
+ * [22]View source
+ * [23]History
+
+ Personal tools
+
+ * [24]Log in
+
+ Resources
+
+ * [25]BOINC home
+ * [26]User Manual
+ * [27]Help
+ * [28]download
+ * [29]Message boards
+ * [30]Web sites
+ * [31]Add-on software
+ * [32]Other ways to help
+
+ Contents
+
+ * [33]Recent changes
+ * [34]Categories
+ * [35]All Articles
+
+ Search
+
+ [36]_____________________ [37][ Go ] [38][ Search ]
+
+ Toolbox
+
+ * [39]What links here
+ * [40]Related changes
+ * [41]Special pages
+ * [42]Permanent link
+
+ [43]Powered by MediaWiki
+ [44]GNU Free Documentation License 1.2
+
+ * This page was last modified on 9 June 2012, at 12:25.
+ * This page has been accessed 30,935 times.
+ * Content is available under [45]GNU Free Documentation License 1.2.
+ * [46]Privacy policy
+ * [47]About BOINC
+ * [48]Disclaimers
+
+References
+
+ Visible links
+ 1. file:///w/opensearch_desc.php
+ 2. file:///w/?title=Installing_BOINC_on_Fedora&action=creativecommons
+ 3. http://www.gnu.org/copyleft/fdl.html
+ 4. file:///w/?title=Special:RecentChanges&feed=atom
+ 5. file:///tmp/Installing%20BOINC%20on%20Fedora%20-%20BOINC.html#column-one
+ 6. file:///tmp/Installing%20BOINC%20on%20Fedora%20-%20BOINC.html#searchInput
+ 7. file:///tmp/Installing%20BOINC%20on%20Fedora%20-%20BOINC.html#Basic_installation
+ 8. file:///tmp/Installing%20BOINC%20on%20Fedora%20-%20BOINC.html#What_the_installer_does
+ 9. file:///tmp/Installing%20BOINC%20on%20Fedora%20-%20BOINC.html#Verify_the_installation
+ 10. file:///tmp/Installing%20BOINC%20on%20Fedora%20-%20BOINC.html#Set_up_your_accounts
+ 11. file:///tmp/Installing%20BOINC%20on%20Fedora%20-%20BOINC.html#Cuda
+ 12. file:///tmp/Installing%20BOINC%20on%20Fedora%20-%20BOINC.html#Optional_setup_hints
+ 13. file:///tmp/Installing%20BOINC%20on%20Fedora%20-%20BOINC.html#Uninstallation
+ 14. file:///tmp/Installing%20BOINC%20on%20Fedora%20-%20BOINC.html#Known_problems
+ 15. Stop or start BOINC daemon after boot
+ file:///wiki/Stop_or_start_BOINC_daemon_after_boot
+ 16. https://fedoraproject.org/wiki/Cuda
+ 17. Linux file permissions
+ file:///wiki/Linux_file_permissions
+ 18. http://boinc.berkeley.edu/trac/ticket/707
+ 19. http://boinc.berkeley.edu/wiki/Installing_BOINC_on_Fedora
+ 20. View the content page [c]
+ file:///wiki/Installing_BOINC_on_Fedora
+ 21. Discussion about the content page [t]
+ file:///wiki/Talk:Installing_BOINC_on_Fedora
+ 22. This page is protected.
+You can view its source [e]
+ file:///w/?title=Installing_BOINC_on_Fedora&action=edit
+ 23. Past revisions of this page [h]
+ file:///w/?title=Installing_BOINC_on_Fedora&action=history
+ 24. You are encouraged to log in; however, it is not mandatory [o]
+ file:///w/?title=Special:UserLogin&returnto=Installing_BOINC_on_Fedora&returntoquery=printable%3Dyes
+ 25. http://boinc.berkeley.edu/
+ 26. file:///wiki/User_manual
+ 27. The place to find out
+ file:///wiki/BOINC_Help
+ 28. http://boinc.berkeley.edu/download.php
+ 29. http://boinc.berkeley.edu/dev/
+ 30. http://boinc.berkeley.edu/links.php
+ 31. http://boinc.berkeley.edu/addons.php
+ 32. file:///wiki/Other_ways_to_volunteer
+ 33. file:///wiki/Special:RecentChanges
+ 34. file:///wiki/Special:Categories
+ 35. file:///wiki/Special:AllPages
+ 39. List of all wiki pages that link here [j]
+ file:///wiki/Special:WhatLinksHere/Installing_BOINC_on_Fedora
+ 40. Recent changes in pages linked from this page [k]
+ file:///wiki/Special:RecentChangesLinked/Installing_BOINC_on_Fedora
+ 41. List of all special pages [q]
+ file:///wiki/Special:SpecialPages
+ 42. Permanent link to this revision of the page
+ file:///w/?title=Installing_BOINC_on_Fedora&oldid=3685
+ 43. http://www.mediawiki.org/
+ 44. http://www.gnu.org/copyleft/fdl.html
+ 45. http://www.gnu.org/copyleft/fdl.html
+ 46. BOINC:Privacy policy
+ file:///wiki/BOINC:Privacy_policy
+ 47. BOINC:About
+ file:///wiki/BOINC:About
+ 48. BOINC:General disclaimer
+ file:///wiki/BOINC:General_disclaimer
More information about the scm-commits
mailing list