Changes between Version 12 and Version 13 of UnixClientPackage


Ignore:
Timestamp:
Apr 12, 2008, 6:46:46 AM (17 years ago)
Author:
Eric Myers
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • UnixClientPackage

    v12 v13  
    22= Unix client package layout =
    33
    4 The purpose of this page is to describe the layout of files for installation of the BOINC client software on Unix machines.  It is desirable, as much as is possible, to keep things the same so that volunteers who are not Unix experts can still understand what is what and what is where an ask questions, without having to get into specifics of which distro they are using.
     4The purpose of this page is to describe the layout of files for installation of the BOINC client software on Unix machines.  That means various distros of Linux, but also FreeBSD, OpenBSD, Sun, HP, AIX, and any other Unix.   It is desirable, as much as is possible, to keep things the same so that volunteers who are not Unix experts can still understand what is what and what is where and ask questions, without having to get into specifics of which distro they are using.  It also helps when answering questions, as we don't have to preface a response with "if you have [flavor]..."
    55
    66Items we need to specify:
     
    88
    99This is `/var/lib/boinc` on Fedora, but `/var/lib/boinc-client` on Debian.  Can we agree on only one of these?
     10> I think changing to `/var/lib/boinc-client` is the right thing. -EAM
    1011
    1112=== Configuration files for the core client ===
     
    1314Debian, for example, puts these in /etc/boinc-client/ and has appropriate symlinks in the working directory
    1415
    15 >>>>WHY? -EAM
    16 >>>>
    17 >>>It is [http://www.debian.org/doc/debian-policy/ch-files.html#s10.7.2 policy in Debian] that all configuraton files must reside in `/etc` -FST
    18 >>>
    19 >>That makes sense only for files which the sysadmin would edit to change configuration (like `/etc/default/boinc-client`) but not these .xml files, which are basically only saved state.  They are not really "configuration" files in the Unix sense.  -EAM
    20 > I think this is wrong, they are configuration files. System administrators are supposed to edit them, they are not state files. Just have a look at ClientMessages and PrefsOverride, these pages will confirm this. -FST
     16>WHY? -EAM
     17>
     18>>It is [http://www.debian.org/doc/debian-policy/ch-files.html#s10.7.2 policy in Debian] that all configuraton files must reside in `/etc` -FST
     19>>
     20>That makes sense only for files which the sysadmin would edit to change configuration (like `/etc/default/boinc-client`) but not these .xml files, which are basically only saved state.  They are not really "configuration" files in the Unix sense.  -EAM
     21>> I think this is wrong, they are configuration files. System administrators are supposed to edit them, they are not state files. Just have a look at ClientMessages and PrefsOverride, these pages will confirm this. -FST
     22> Yup, I see what you mean.   So I'm wondering if it would not be better to have the CC check for these files in multiple places: use the file in the working directory, if it exists, else use the one in /etc/boinc-client, if it exists.  -EAM
     23 
     24
    2125
    2226== Executable files ==
     
    2731   * /usr/bin/boinc_cmd
    2832
     33> Rom suggests considering `boincd` for the client. -EAM
     34 
     35
    2936== init script to start/stop daemon ==
    3037
    3138   * `/etc/init.d/boinc`  or `/etc/init.d/boinc-client` ?
    3239
    33 Again, let's try to pick one name for all distros
     40Again, let's try to pick one name for all distros.
     41 
    3442
    3543=== config file read by the init script ===
     
    4149
    4250  Currently the Fedora package and the RPM's from Pirates@Home use `/etc/sysconfig/boinc`.   So future installers should look for that and rename it appropriately in the %pre install scriptlet.
     51
     52  In any case, the name should match the name of the init script.
    4353
    4454
     
    5363Change the names as needed to match any changes in command names.
    5464
     65
    5566== log rotation ==
    5667
     
    6071expects to find it.  I believe this is `/etc/logrotate.d`
    6172
     73
    6274== bash command completion script ==