[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=60&rev2=61

Comment:
substituted boincproject.sh with boinc_test.conf

  ==== Initialisation of the configuration ====
  
  For a first start of a project create the file that the project parameters shall be stored in. {{{
- echo > ~/.boincproject.sh
+ echo > ~/.boinc_test.conf
- chmod 600 ~/.boincproject.sh
+ chmod 600 ~/.boinc_test.conf
  }}}
  and whenever starting a shell, these settings should be set: {{{
  cat <<EOBASHRC
- if [ -r .boincproject.sh ]; then
+ if [ -r .boinc_test.conf ]; then
-    . .boincproject.sh
+    . .boinc_test.conf
  fi
  EOBASHRC
  }}}
  ==== Parameters for the MySQL database ====
  
  {{{
- cat << EODBCONFIG >> ~/.boincproject.sh
+ cat << EODBCONFIG >> ~/.boinc_test.conf
- # password for write access to your prject database
+ # password for write access to your project database
  pw=MYSQLPASSWORDFORBOINCUSER
  # name of the MySQL database
  dbprojectname=boinctest
@@ -83, +83 @@

  
  With the variables defined before, you can just copy and pasted the code below. The password asked is the password for the root user to access the database. {{{
  # read config if available
- [ -r ~/.boincproject.sh ] && . ~/.boincproject.sh
+ [ -r ~/.boinc_test.conf ] && . ~/.boinc_test.conf
  if ! echo "DROP USER 'boincadm'@'localhost'" | mysql -u root -p; then
     echo "If the removal of the previous user fails because the user is not existing, then this does not matter. Other errors would be required a manual removal."
  fi
@@ -104, +104 @@

  
  Please replace a.b.c.d with your full hostname or your server's IP address. If you only have dynamic IP addresses, then this is unfortunate, but investigate the service of dyndns.org to help out.
  {{{
- cat <<EOCONF >> ~/.boincproject.sh
+ cat <<EOCONF >> ~/.boinc_test.conf
  # address of host (via DNS or IP number) at which project server shall be reached
  hosturl=http://a.b.c.d
  # name of folder in which data shall be stored, also becomes part of project URL
@@ -116, +116 @@

  EOCONF
  }}}
  
- Again, please edit '~/.boincproject.sh' with a text editor if required. This example
+ Again, please edit '~/.boinc_test.conf' with a text editor if required. This example
  installroot is where you cannot harm anything. Some linux distributions may however
  have that directory cleaned at boot time. Please adjust.
  
@@ -162, +162 @@

  ==== Adjusting permissions for project directory ====
  
   1. Make sure the configuration variables are set {{{
- [ -r ~/.boincproject.sh ] && . ~/.boincproject.sh 
+ [ -r ~/.boinc_test.conf ] && . ~/.boinc_test.conf 
  }}}
   1. Change files and directories permission: {{{
  if [ -z "$installroot" -o -z "$fileprojectname" ]; then
@@ -320, +320 @@

  
  = Management of your own project =
  
- Each BOINC project has its own configuration variables, it is needed as long the project lives for updation. It is a good idea to store variables of each project in file like ~/.${fileprojectname}.conf
+ === Configuration - summary ===
  
+ Above, a series of environment variables was specified to separate the invariant instructions from those bits that are project specific. Truly,
+ each BOINC project needs its very own set of configuration variables. It is needed as long the project lives to allow for updates and routine maintenance. To avoid expensive typos, project-specific configurations are suggested, like ~/.boinc_projectname.conf.
+ 
- For our test project, the configuration file is ~/.boinctest.conf and this will look like,
+ For our test project, the configuration file is ~/.boinc_test.conf and this will look like,
  {{{
  # password for write access to your project database
  pw=MYSQLPASSWORDFORBOINCUSER
- 
  # name of the MySQL database
  dbprojectname=boinctest
- 
  # address of host (via DNS or IP number) at which project server shall be reached
  hosturl=http://a.b.c.d
- 
  # name of folder in which data shall be stored, also becomes part of project URL
  fileprojectname=$dbprojectname
- 
  # more human-compatible way to read the project name
  niceprojectname="BoincTestProject at Home"
- 
  # location at which sources shall be kept
  installroot=/var/tmp/boinc
  }}}
  
- So while maintaining the project all we have to do is 
+ So while maintaining the project all we have to do is {{{
+ source ~/.boinc_test.conf
- {{{
- source ~/.${fileprojectname}.conf
  }}}
  and execute the commands using the standard variables.