Changes between Version 3 and Version 4 of EncapReadme


Ignore:
Timestamp:
02/25/07 19:26:43 (15 years ago)
Author:
dclark
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • EncapReadme

    v3 v4  
    1515 * bcfg2 itself 
    1616 * ostiary to kick off bcfg2 client runs remotely 
    17  * daemontools to run bcfg2 client as a periodic service with logging 
     17 * runit to run bcfg2 client as a periodic service with logging 
    1818 * all with site-specific configuration parameters, set at build time in a 
    1919   single unified build-time configuration file, site-settings.conf 
     
    8989}}} 
    9090 
    91 == About daemontools integration == 
     91== About runit integration == 
    9292In order to avoid a lot of platform/distribution-specific code, the encap 
    93 bcfg2 distribution includes and uses [http://cr.yp.to/daemontools.html 
    94 daemontools] (with some common patches) instead of init scripts and cron. 
     93bcfg2 distribution includes and uses [http://smarden.org/runit/useinit.html 
     94runit] instead of init scripts and cron. 
    9595 
    96 The bcfg2 client (.run) distribution uses daemontools to run ostiary, and to 
    97 run the bcfg2 client periodically. 
     96The bcfg2 client (.run) distribution uses runit to run ostiary, and to run  
     97the bcfg2 client periodically. 
    9898 
    9999On the server, edit `/usr/local/etc/default/bcfg2-server/env/OPTIONS` to 
    100100include the options you want to start up the bcfg2 server with, and then do 
    101101{{{ 
    102 ln -s /usr/local/var/svc.d/bcfg2-server /service/ 
     102ln -s /usr/local/etc/sv/bcfg2-server /usr/local/var/service/ 
    103103}}} 
    104104to enable the service. 
    105105 
    106 You can use `/command/svstat /service/bcfg2-server` to see the status, and 
    107 `/command/svrm /service/bcfg2-server` to remove it. 
     106You can use `sv status /usr/local/var/service/bcfg2-server` to see the  
     107status, and `rm /usr/local/var/service/bcfg2-server` to remove it. 
    108108 
    109 Logs for all daemontools services are under `/usr/local/var/multilog`. 
    110 They use a highly precise time format; to translate into a readable format, 
    111 pipe the logs through `/command/tai64nlocal`. 
     109Logs for all runit services are under `/usr/local/var/svlogd`. 
    112110 
    113111== About ostiary integration == 
     
    126124 * `<password>-bcfg2-vq` : Run `bcfg2-client -v -q` 
    127125 * `<password>-bcfg2-v` : Run `bcfg2-client -v` 
    128  * `<password>-bcfg2-restart` : Restart the bcfg2-client daemontools service 
     126 * `<password>-bcfg2-restart` : Restart the bcfg2-client runit service 
    129127 
    130128There are plans for the future for a bcfg2 plugin that will set per-machine 
     
    143141 
    144142Logs of bcfg2-client runs kicked off via ostiary are in 
    145 `/usr/local/var/multilog/bcfg2-client-ostiary` 
     143`/usr/local/var/svlogd/bcfg2-client-ostiary` 
    146144 
    147145== Supported Platforms == 
     
    149147this code. 
    150148 
    151 || OS        || Vendor || Version || Arch  || GCC     || By || Bcfg2 || 
    152 || AIX       || IBM    || 5.2     || POWER || 3.3.2   || dc || 0.8.5 || 
    153 || AIX       || IBM    || 5.3     || POWER || 4.1.1   || dc || 0.8.5 || 
    154 || GNU/Linux || Debian || Sarge   || i386  || 3.3.5   || dc || 0.8.5 || 
    155 || GNU/Linux || Debian || Sid     || i386  || 4.1.2   || dc || 0.8.5 || 
    156 || GNU/Linux || Redhat || 7.2     || i386  || 2.96    || dc || 0.8.5 || 
    157 || GNU/Linux || SuSE   || SLES8   || i386  || 3.2.2   || dc || 0.8.5 || 
    158 || GNU/Linux || SuSE   || SLES10  || i386  || 4.1.0   || dc || 0.8.5 || 
    159 || GNU/Linux || Ubuntu || Dapper  || i386  || 4.0.3   || dc || 0.8.5 || 
    160 || Solaris   || Sun    || 10      || i386  || 3.4.3   || dc || 0.8.5 || 
    161 || Solaris   || Sun    || 10      || Sparc || 3.4.3   || dc || 0.8.5 || 
     149|| OS        || Vendor || Version || Arch   || GCC     || By || Bcfg2 || 
     150|| AIX       || IBM    || 5.2     || POWER  || 3.3.2   || dc || 0.8.5 || 
     151|| AIX       || IBM    || 5.3     || POWER  || 4.1.1   || dc || 0.8.5 || 
     152|| GNU/Linux || Debian || Sarge   || i386   || 3.3.5   || dc || 0.8.5 || 
     153|| GNU/Linux || Debian || Etch    || x86_64 || 4.1.2   || dc || 0.9.2 || 
     154|| GNU/Linux || Debian || Sid     || i386   || 4.1.2   || dc || 0.8.5 || 
     155|| GNU/Linux || SuSE   || SLES8   || i386   || 3.2.2   || dc || 0.8.5 || 
     156|| GNU/Linux || SuSE   || SLES10  || i386   || 4.1.0   || dc || 0.8.5 || 
     157|| GNU/Linux || Ubuntu || Dapper  || i386   || 4.0.3   || dc || 0.8.5 || 
    162158 
    163159dc: "Daniel Clark" <mailto:dclark@member.fsf.org> 
     
    189185 
    190186== Documentation Version == 
    191  * This is a copy of: $Id: README 2393 2006-10-06 04:13:07Z dclark $ 
     187 * This is a copy of: $Id: README 2856 2007-02-20 03:08:47Z dclark $ 
    192188 * Most recent version: http://www.bcfg2.org/browser/trunk/bcfg2/encap/README