[Debian Wiki] Update of "BOINC/ServerGuide" by SteffenMoeller

[Debian Wiki]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Debian Wiki" for change notification.

The "BOINC/ServerGuide" page has been changed by SteffenMoeller:
http://wiki.debian.org/BOINC/ServerGuide?action=diff&rev1=32&rev2=33

  
  This tutorial will help you create BOINC project with Debian server without using virtual images provide from BOINC. See [[BOINC/Server]] for an overview on BOINC-Server with Debian related issues. For an overview and guide on how to compile the BOINC package from the pkg-boinc git repository, see [[BOINC/Development/GitUsage]].
  
- '''Contents'''
  <<TableOfContents(2)>>
  
  To see more info about how to install and config BOINC server, please look at [[http://boinc.berkeley.edu/trac/wiki/ProjectMain|BOINC project wiki]] and 
@@ -128, +127 @@

  sudo /etc/init.d/apache2 reload
  }}}
   1. Start BOINC server 
-  Please stay in that project directory and bluntly perform {{{
+  Please stay in that project directory and just use the default configuration
+  as a start.
+   1. Read information from file 'project.xml' and put into the database {{{
  sudo bin/xadd
+ }}} The tool [[http://boinc.berkeley.edu/trac/wiki/XaddTool|xadd]] configures the project by parsing the 'project.xml' file. That 'project.xml' file initially only lists the most common platforms. Then it mentions the application that should be supported, which is 'uppercase'.
+   1. add the binary to be distributed to the clients. For the applications in 'project.xml', a folder in the 'apps' directory must be created and the respective binary be placed into that.{{{
+ to be written, this is just guesswork for the very moment.
+ sudo mkdir apps/uppercase
+ chown root:boincadm apps/uppercase
+ chmod 770 apps/uppercase
+ # works for the Debian boinc-server package
+ cp usr/lib/boinc-server/apps/upper_case apps/uppercase/uppercase_$(arch)-pc-linux-gnu
+ # copy it from your source directory if not running that package
+ }}} The $(arch) identifies the platform that this installation is performed on and consequently that the binary in /usr/lib/boinc-server is compiled for. The information on the availability of that binary needs to be communicated to the database by executing the [[http://boinc.berkeley.edu/trac/wiki/UpdateVersions|update_versions]] tool by a mere {{{
+ bin/update_versions
+ }}}. 
+   1. start the demons {{{
  sudo bin/start
+ }}} Running [[http://boinc.berkeley.edu/trac/wiki/StartTool|start]], this should show something like {{{
- }}}
- 
- This should show something like {{{
  Entering ENABLED mode
  Starting daemons
    Starting daemon: feeder -d 3
    Starting daemon: transitioner -d 3
    Starting daemon: file_deleter -d 3
- }}}
- and after some academic minute the shell prompt should return. "top" should just show your regular BOINC work units (assuming that your server remains a good client until it is busy). A "ps aux | tail -20" should list something like
+ }}} and after some academic minute the shell prompt should return. The UNIX tool {{{top}}} should just show your regular BOINC work units (assuming that your server remains a good client until it is busy). A "ps aux | tail -20" should list something like {{{
- {{{
  root      4551  0.4  2.1  46864 21776 ?        S    10:33   0:00 feeder -d 3
  root      4553  0.0  0.2  35312  3004 ?        S    10:33   0:00 transitioner -d 3
  root      4555  0.0  0.2  27336  2240 ?        S    10:33   0:00 file_deleter -d 3
- }}}
- Something lets me think that those processes should better run as "boincadm", but, well, let's be happy for now.
+ }}} Something lets me think that those processes should better run as "boincadm" than via 'sudo', but, well, let's be happy for now.
  
  == Test web interface ==
  
@@ -183, +192 @@

  
  === When starting from the Debian package ===
  
- The wrapper application is not compiled by default. A (very near) future version of the BOINC server package will redistribute that source code in /usr/share/doc/boinc-server . For the moment, please {{{apt-get source boinc}}} and proceed as described above.
+ The wrapper application is not compiled by default. A the current (6.12.8-2) version of the Debian BOINC server package will redistribute that source code in /usr/share/doc/boinc-server.
+ The Makefiles have been adjusted to all the direct compilation of that binary outside the source tree of BOINC.
+ 
  
  == Config clients ==
  
@@ -203, +214 @@

   *[[http://boinc.berkeley.edu/trac/wiki/ProjectMain|BOINC project wiki]]
    * [[http://boinc.berkeley.edu/trac/wiki/SoftwareDevelopment|BOINC Software Development Wiki]]
     * [[http://boinc.berkeley.edu/trac/wiki/SingleJob|SingleJob]] setup used for example
+    * [[http://boinc.berkeley.edu/trac/wiki/XaddTool|xadd]] - adding platforms and applications
+    * [[http://boinc.berkeley.edu/trac/wiki/UpdateVersions|update_versions]] - adding or updating versions of the application
+    * [[http://boinc.berkeley.edu/trac/wiki/StartTool|start]] - starting the demons
+    * [[http://boinc.berkeley.edu/trac/wiki/WrapperApp|wrapper]] application to boincify regular applications
    * [[http://boinc.berkeley.edu/trac/wiki/UnixProjectPackage|UNIX Project Package]] thoughts by upstream
   * [[http://www.spy-hill.net/~myers/help/boinc/Create_Project.html|spy-hill.net tutorial to create BOINC projects]]