[vhffs-dev] [668] New documentation is comming ( does someone know how to autotoolize docbook ?).

[ Thread Index | Date Index | More vhffs.org/vhffs-dev Archives ]


Revision: 668
Author:   beuss
Date:     2007-07-05 18:55:56 +0000 (Thu, 05 Jul 2007)

Log Message:
-----------
New documentation is comming (does someone know how to autotoolize docbook ?).

Modified Paths:
--------------
    trunk/vhffs-doc/Makefile.am

Added Paths:
-----------
    trunk/vhffs-doc/part1/
    trunk/vhffs-doc/part1/mirror.xml
    trunk/vhffs-doc/part1/mydns.xml
    trunk/vhffs-doc/vhffs-doc.xml

Removed Paths:
-------------
    trunk/vhffs-doc/Architecture-fr
    trunk/vhffs-doc/CONVENTION-fr
    trunk/vhffs-doc/Files-fr
    trunk/vhffs-doc/HOWTO-Contribute
    trunk/vhffs-doc/HOWTO-Robots
    trunk/vhffs-doc/HOWTO-ServiceACL-fr
    trunk/vhffs-doc/README-fr
    trunk/vhffs-doc/VHFFS4-auth1024.png
    trunk/vhffs-doc/VHFFS4-auth2048.png
    trunk/vhffs-doc/api/
    trunk/vhffs-doc/debian/


Deleted: trunk/vhffs-doc/Architecture-fr
===================================================================
--- trunk/vhffs-doc/Architecture-fr	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/Architecture-fr	2007-07-05 18:55:56 UTC (rev 668)
@@ -1,44 +0,0 @@
-Sch\xE9ma global de Vhffs par sod`
---------------------
-
-Vhffs se d\xE9compose en plusieurs modules Perl. Le mod\xE8le de conception
-est r\xE9solument orient\xE9 objet. Une API globale est utilis\xE9e par les
-Robots et autre panel.
-
-Voici le sch\xE9ma global :
-
- _____________________________________________
-|                                             |
-|          A P I  centrale                    |
-|                   _____________________     |
-|  _____________   |                     |    |
-| |             |  | API Panel           |    |
-| | R O B O T S |  |     _____________   |    |
-| |             |  |    |             |  |    |
-| |_____________|  |    |  P A N E L  |  |    |
-|                  |    |_____________|  |    |
-|                  |_____________________|    |
-|_____________________________________________|
-
-- API Centrale
-  L'API centrale contient les modules perl de base. Ils permettent
-  de cr\xE9er des utilisateurs ainsi que des services.
-  On retrouvera les fichiers Users.pm, Group.pm, Subversion.pm,
-  Main.pm, Conf.pm, ACL.pm, ...
-
-- Robots
-  Les robots de Vhffs seront de simples binaires qui s'appuieront
-  sur l'API d\xE9velopp\xE9e pr\xE9c\xE9demment pour ex\xE9cuter quelques t\xE2ches
-  triviales (cr\xE9ation des utilisateurs, cr\xE9ation des r\xE9pertoires, 
-  modifications des droits, v\xE9rification de l'int\xE9grit\xE9 du syst\xE8me, ...)
-
-- API Panel
-  L'API panel sera une mini API contenue dans un gros fichier
-  Panel.pm. Celui ci permettra de cr\xE9er des classes \xE0 partir de 
-  l'API de base et de manipuler ces objets avec des donn\xE9es atomiques
-  fournis par le panel (par exemple, l'uid d'un user).
-
-- Le panel
-  Le panel sera \xE9crit en perl, et s'appuiera sur la petite API d\xE9crite 
-  pr\xE9c\xE9demment
-

Deleted: trunk/vhffs-doc/CONVENTION-fr
===================================================================
--- trunk/vhffs-doc/CONVENTION-fr	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/CONVENTION-fr	2007-07-05 18:55:56 UTC (rev 668)
@@ -1,7 +0,0 @@
-- Chaque table doit avoir un identifiant qui s'appelle AUTREMENT que id
-  Donc, un identifiant NON GENERIQUE.
-  Le mieux est de faire un identifiant qui sera li\xE9 au nom du service.
-- Toujours envoyer ses changements si vous n'avez pas d'acc\xE8s cvs. Envoyez
-  pour le moment \xE0  : julien AT gunnm DOT org. Si vous avez un acces CVS,
-  committez, sans quoi, vous aurez une fess\xE9e
-

Deleted: trunk/vhffs-doc/Files-fr
===================================================================
--- trunk/vhffs-doc/Files-fr	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/Files-fr	2007-07-05 18:55:56 UTC (rev 668)
@@ -1,25 +0,0 @@
-Description des diff\xE9rents fichiers de Vhffs par sod`
-----------------------
-
-*.sql : scripts de cr\xE9ation des bases
-
-Main.pm : module pour diverses fonctions de Vhffs (connexion
-          \xE0 la base de donn\xE9es, ...)
-
-Conf.pm : gestion du fichier de configuration de Vhffs. Ce fichier
-          est disponible en tant que vhffs dans le module vhffs-backend
-
-User.pm : gestion des utilisateurs
-
-Group.pm : gestion des groupes
-
-Object.pm : gestion des objets de bases de Vhffs. Chaque entit\xE9 est un objet
-            (utilisateurs, groupes, services, ...), et sera soumis au syst\xE8me
-	    d'ACL. Chaque classe de l'API h\xE9rite de cette classe.
-
-Httpd.pm : gestion du service d'h\xE9bergement WEB
-
-Panel.pm : sous API utilis\xE9e par le panel de Vhffs
-
-ACL.pm : API pour g\xE9rer les ACL sous Vhffs
-

Deleted: trunk/vhffs-doc/HOWTO-Contribute
===================================================================
--- trunk/vhffs-doc/HOWTO-Contribute	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/HOWTO-Contribute	2007-07-05 18:55:56 UTC (rev 668)
@@ -1,42 +0,0 @@
-HOW TO Contribute to Vhffs ?
----------------------
-
-
-SVN Access
-----------
-Vhffs has a SVN server hosted by naquadah network.
-SVN access is given to persons who are involved in Vhffs.
-In other words, you will not have an access as soon as you
-send patches, but if you contribute often to the project, a 
-SVN access will be given.
-
-
-Conventions
-----------
-1 - The identation model is the emacs model. Vhffs is written
-under emacs, so you have the choice for indentation, but you
-have to choose ours :-)
-
-2 - All methods or functions MUST return a value (a reference
-or an integer). So, you HAVE TO respect this way of programming.
-A successful execution will return a positive value, often 1, 
-otherwise, the method will return a negative value.
-
-3 - You have to make an OO code. The oriented object method is
-more clear than others, and current Vhffs modules are in this way.
-So, you have to respect this rule. This implies that you will
-create new method in each module, ... Of course, class method
-are allowed, as in Vhffs::User module with get_all method.
-
-
-Send patches
-----------
-You can send patch to the list vhffs-dev@xxxxxxxxx. If you prefer
-send a patch and have informations about it, you can send it to soda
- ( soda AT gunnm DOT org)
-
-
-Put your name on your products and complete Changelog and TODO
------------
-You MUST put your name on your code. More, you have to 
-update Changelog and TODO files when you finished your work :)

Deleted: trunk/vhffs-doc/HOWTO-Robots
===================================================================
--- trunk/vhffs-doc/HOWTO-Robots	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/HOWTO-Robots	2007-07-05 18:55:56 UTC (rev 668)
@@ -1,27 +0,0 @@
-The VHFFS Robots should run with crontab.
-For example, you can call them every 2 minutes. They will create what you need.
-Be careful, they don't have lock files at this time, so 2 create_user.pl robots
-could run at the same time. You should leave at least one minute between the 
-execution of all robots.
-
-The robots will create what is specified in the panel.
-
-This is a crontab example.
-
-
-*/2 * * * *  root  /vhffs/vhffs-robots/src/create_cvs.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/create_dns.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/create_groups.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/create_homes.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/create_mail.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/create_mysql.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/create_pgsql.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/create_web.pl
-
-*/2 * * * *  root  /vhffs/vhffs-robots/src/delete_mail.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/delete_mysql.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/delete_pgsql.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/delete_web.pl
-
-*/2 * * * *  root  /vhffs/vhffs-robots/src/treat_refused.pl
-*/2 * * * *  root  /vhffs/vhffs-robots/src/user_group.pl

Deleted: trunk/vhffs-doc/HOWTO-ServiceACL-fr
===================================================================
--- trunk/vhffs-doc/HOWTO-ServiceACL-fr	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/HOWTO-ServiceACL-fr	2007-07-05 18:55:56 UTC (rev 668)
@@ -1,87 +0,0 @@
-HOWTO-ServiceACL par sod`
-----------------
-
-Ce document va essayer de poser quelques bases \xE0 propos de
-l'impl\xE9mentation des services sous Vhffs4 (d'ailleurs, faudrait
-penser \xE0 changer de nom un jour [1]).
-
-L'id\xE9e g\xE9n\xE9rale est de cr\xE9er une table g\xE9n\xE9rale pour chaque service.
-Typiquement, pour apache, on aura une table contenant :
-- le servername
-- la description
-- autres param\xE8tres \xE9tant propres aux services
-
-PLUS :
-- un \xE9tat : 0 = service \xE0 mettre en place (un robot le met en place.
-  En gros, mettre en place un service revient \xE0 cr\xE9er les dirs et cie
-  pour que le tout soit fonctionnel).
-            1 = service mis en place et fonctionnel
-	    2 = service \xE0 supprimer (un robot le supprime)
-
-
-Les services sont consid\xE9r\xE9s comme des objets de Vhffs. Dans le syst\xE8me
-d'ACL propre \xE0 Vhffs, on peut donc changer les modficateurs d'un objet \xE0 
-volont\xE9. Exemple :
-- On a un objet de type "http" h\xE9ritera du type Object de Vhffs
-- Dans les ACL propres \xE0 Vhffs, on dit que l'uid 1231 peut modifier 
-  cet objet de type "http". En revanche, seul le propri\xE9taire peut changer
-  le propri\xE9taire d'un objet. Par contre, on peut faire plusieurs niveaux
-  pour les acc\xE8s aux objets.
-
-Typiquement, on arriverait \xE0 plusieurs tables de ce genre :
-
-service_httpd (
- id,             # id du service 
- object_id,      # id de l'objet auquel il fait r\xE9f\xE9rence
- servername,
- etat,           # indique si l'on doit cr\xE9er le service ou non
-)
-
-acl
-(
- uid,            #
- object_id,      # identifiant de l'objet
- perms           # permissions que la personne a sur l'objet (read/write, ...)
-)
-
-object
-(
-  id,
-  owner_uid,
-  ...
-)
-
-On pourrait par exemple avoir les tuples suivants :
-
-pour service_httpd
- 1 , 1 , tuxfamily.org , 1
-
-pour object 
-1, 10001, ....
-
-
-pour acl
- 1004 , 1 , 700
- 1005 , 1 , 500
-
-Bien s\xFBr, ce syst\xE8me d'ACL serait propre \xE0 Vhffs et ne serait aucunement
-appliqu\xE9 sur le syst\xE8me de fichiers. Cela permet par contre \xE0 plusieurs
-personnes travaillant sur un m\xEAme projet de g\xE9rer les diff\xE9rents outils
-avec lesquels ils travaillent.
-Je pense que \xE7a peut \xEAtre int\xE9ressant, car trop de personnes vont \xE0 terme
-utiliser le SVN de "leur pote qui a perdu son pass et qui peut plus
-configurer tel ou tel service" ...
-
-De plus, les ACL ne sont clairement pas pr\xEAtes aujourd'hui pour qu'on les
-utilise sous Linux (et donc, avec Debian, qui est le syst\xE8me de r\xE9f\xE9rence
-pour Vhffs). N\xE9anmoins, les d\xE9velopper actuellement de mani\xE8re interne \xE0
-Vhffs nous permettra plus tard de pouvoir les impl\xE9menter facilement sur le
-syst\xE8me de fichiers. En tr\xE8s tr\xE8s ***gros***, apr\xE8s deux trois recompilations
-du kernel, trois robots et deux patches, on ***devrait*** pouvoir le faire
-(***touss touss***). Bien s\xFBr, tout cela n'est que th\xE9orique, et on sait
-tous tr\xE8s bien comment \xE7a finira ("mais heu, pourquoi tu as tout effac\xE9"
-;-)))
-
--------------------------
-
-[1] : petite d\xE9dicace \xE0 acid ;-)

Modified: trunk/vhffs-doc/Makefile.am
===================================================================
--- trunk/vhffs-doc/Makefile.am	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/Makefile.am	2007-07-05 18:55:56 UTC (rev 668)
@@ -1,15 +1,7 @@
-EXTRA_DIST = api config debian
+EXTRA_DIST = config
 docdir = @DOCDIR@
 
-doc_DATA = \
-	Architecture-fr \
-	CONVENTION-fr \
-	HOWTO-Contribute \
-	HOWTO-Robots \
-	HOWTO-ServiceACL-fr \
-	README-fr\
-	VHFFS4-auth1024.png \
-	VHFFS4-auth2048.png
+doc_DATA = 
 	
 nobase_doc_DATA = \
 	config/apache/panelconf

Deleted: trunk/vhffs-doc/README-fr
===================================================================
--- trunk/vhffs-doc/README-fr	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/README-fr	2007-07-05 18:55:56 UTC (rev 668)
@@ -1,62 +0,0 @@
-README-fr Vhffs (soda)
-
-Ce document a pour but de pr\xE9senter succintement Vhffs.
-
-
-Qu'est ce que Vhffs ?
----------------------
-Vhffs est une plate-forme d'h\xE9bergement massif. Historiquement, c'est
-la plate-forme d\xE9velopp\xE9e sp\xE9cialement pour Tuxfamily, afin de g\xE9rer
-tous les services. A l'heure actuelle, quelques soci\xE9t\xE9s utilisent
-le programme (Africa Computing, Lost-Oasis, Ouvaton, ...).
-La distribution standard inclut toutes les configurations des services,
-une API uniformis\xE9e pour les op\xE9rations dans les bases de donn\xE9es
-propres \xE0 Vhffs et un panel, v\xE9ritable interface entre l'utilisateur
-et les services.
-
-
-Quels sont les besoins mat\xE9riels pour faire fonctionner Vhffs ?
----------------------
-Si vous souhaitez faire de l'h\xE9bergement, massif, il vous faut alors
-des machines. :-) Objectivement, il n'y a pas de minimum requis. 
-N\xE9anmoins, la distribution standard de Vhffs est packag\xE9e uniquement
-pour Debian GNU/Linux. Cependant, des versions non-officielles peuvent
-exister, mais nous n'apporterons aucun support pour ces derni\xE8res.
-Il vous faut donc disposer de plusieurs machines fonctionnant avec
-Debian GNU/Linux. La version minimale requise est la Sarge.
-
-Une puissance minimum est tout de m\xEAme requise. Pour un petit serveur,
-un pentium II 350 me semble le minimum.
-
-Comment est d\xE9velopp\xE9 Vhffs ?
----------------------
-Toute l'API est d\xE9velopp\xE9e en perl, tout comme le panel.
-L'API est regroup\xE9e sous forme de module Perl au sein d'un m\xEAme r\xE9pertoire.
-Sinon, il est aussi d\xE9velopp\xE9e avec des machines, de la bi\xE8re, du pastis
-et de l'orangina.
-
-Comment installer Vhffs ?
---------------------
-Lisez le document INSTALL pr\xE9vu \xE0 cet effet. L'ajout de sources dans
-le fichier /etc/apt/sources.list est n\xE9anmoins n\xE9cessaire.
-
-
-Important
--------------------
-Les points suivants sont importants pour les futurs utilisateurs 
-et d\xE9veloppeurs de Vhffs :
-- Signalez les bogues. 
-            Un bogue rapport\xE9 est un bogue \xE0 moiti\xE9 corrig\xE9. Il est tr\xE8s
-	    important de pouvoir signaler les bogues aupr\xE8s des d\xE9veloppeurs
-	    de Vhffs afin d'am\xE9liorer le programme.
-
-- Prenez votre temps et lisez bien toute la documentation avant de poser
-  une question stupide. L'un des inconv\xE9nients de Vhffs2 a \xE9t\xE9 son manque
-  de documentation. Vhffs4 sera beaucoup fourni en terme de documentation.
-
-- COMMITTEZ vos changements. Si vous trouvez un bogue et que vous avez la
-  capacit\xE9 de le corriger, n'h\xE9sitez pas \xE0 le corriger. Cependant, vous
-  devez nous envoyer le correctif ou m\xEAme le committer sur le SVN si vous
-  avez un acc\xE8s \xE0 celui-ci.
-  
-

Deleted: trunk/vhffs-doc/VHFFS4-auth1024.png
===================================================================
(Binary files differ)

Deleted: trunk/vhffs-doc/VHFFS4-auth2048.png
===================================================================
(Binary files differ)

Added: trunk/vhffs-doc/part1/mirror.xml
===================================================================
--- trunk/vhffs-doc/part1/mirror.xml	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/part1/mirror.xml	2007-07-05 18:55:56 UTC (rev 668)
@@ -0,0 +1,206 @@
+<?xml version="1.0" encoding="US-ASCII"?>
+<chapter>
+  <title>Scripts de r&eacute;plication</title>
+
+  <para>Dans le cadre d'une architecture distribu&eacute;e, il peut &ecirc;tre
+  souhaitable de r&eacute;partir les services sur diff&eacute;rentes machines.
+  Le probl&egrave;me des performances dues &agrave; l'acc&egrave;s &agrave; la
+  base de donn&eacute;es distantes (celle directement aliment&eacute;e par
+  VHFFS) peut alors se poser. Pour palier &agrave; cela il est possible de
+  r&eacute;pliquer certaines parties de la base principale sur les autres
+  machines. Cela permet d'all&eacute;ger la charge du serveur de base de
+  donn&eacute;es principal et d'am&eacute;liorer les performances (puisque les
+  requ&ecirc;tes sont locales). La contrepartie est un certain d&eacute;calage
+  possible entre les donn&eacute;es du serveur principal et celles de la base
+  de donn&eacute;es esclave (les scripts &eacute;tant ex&eacute;cut&eacute;s
+  &agrave; intervalle r&eacute;gulier).</para>
+
+  <section>
+    <title>Name Service Switch (NSS)</title>
+
+    <section>
+      <title>Introduction</title>
+
+      <para>Il s'agit du service b&eacute;n&eacute;ficiant du plus gros gain
+      de performances. le NSS est utilis&eacute; pour l'identification des
+      utilisateurs en SSH (utilis&eacute; notamment pour Subversion et CVS)
+      ainsi qu'en FTP. Les diff&eacute;rentes requ&ecirc;tes permettent
+      d'afficher le propri&eacute;taire ou le groupe d'un fichier ainsi que de
+      savoir si un utilisateur peut acc&eacute;der &agrave; tel ou tel fichier
+      (en obtenant ses UID/GID et en les comparant &agrave; ceux du fichier et
+      aux permissions).</para>
+
+      <para>Historiquement, il s'agissait de fichiers qui &eacute;taient
+      utilis&eacute;s, aussi, les requ&ecirc;tes ne sont pas
+      sp&eacute;cialement adapt&eacute;es &agrave; une base de donn&eacute;es.
+      Le co&ucirc;t d'&eacute;tablissement d'une connexion peut &ecirc;tre
+      important dans le cas d'une base de donn&eacute;es distante.</para>
+
+      <para>La solution propos&eacute;e par VHFFS est d'utiliser une
+      biblioth&egrave;que NSS bas&eacute;e sur SQLite (libnss-sqlite). La
+      partie de la base de donn&eacute;es PostgreSQL concernant les
+      utilisateurs est dupliqu&eacute;e pour &ecirc;tre utilis&eacute;e par
+      libnss-sqlite.</para>
+    </section>
+
+    <section>
+      <title>Configuration</title>
+
+      <para>La configuration s'effectue de la m&ecirc;me fa&ccedil;on que
+      n'importe quelle biblioth&egrave;que NSS&nbsp;:</para>
+
+      <orderedlist>
+        <listitem>
+          <para>r&eacute;cup&eacute;rez la derni&egrave;re version de
+          libnss-sqlite sur <ulink
+          url="http://libnss-sqlite.tuxfamily.org";>http://libnss-sqlite.tuxfamily.org</ulink>&nbsp;;</para>
+        </listitem>
+
+        <listitem>
+          <para>si vous la compilez &agrave; partir des sources, utilisez les
+          classiques <command>./configure</command>, <command>make</command>
+          et <command>make install</command> (seule la derni&egrave;re
+          commande doit &ecirc;tre effectu&eacute;e en root). Lancez
+          <command>./configure</command> <option>--help</option> pour une
+          liste des options disponibles. Vous aurez besoin des
+          biblioth&egrave;ques de d&eacute;veloppement de sqlite&nbsp;;</para>
+        </listitem>
+
+        <listitem>
+          <para>modifiez le fichier <filename>/etc/nsswitch.conf</filename>
+          pour que les lignes <literal>passwd</literal>,
+          <literal>shadow</literal> et <literal>groups</literal> finissent par
+          <literal>sqlite</literal>&nbsp;;</para>
+        </listitem>
+
+        <listitem>
+          <para>cr&eacute;ez la base de donn&eacute;es esclave, dans laquelle
+          les donn&eacute;es seront r&eacute;pliqu&eacute;es. Par
+          d&eacute;faut, il s'agit de <filename>/var/db/auth.sqlite</filename>
+          (cr&eacute;ez le r&eacute;pertoire <filename
+          class="directory">/var/db/</filename> s'il n'existe pas). Pour cela,
+          lancez la commande suivante depuis le r&eacute;pertoire des sources
+          de libnss-sqlite&nbsp;: <command>sqlite3</command> <option>-init
+          conf/schema.sql /var/db/auth.sqlite</option>&nbsp;(le fichier
+          devrait appartenir &agrave; <systemitem
+          class="username">root</systemitem> et &ecirc;tre en mode
+          644)&nbsp;;</para>
+        </listitem>
+      </orderedlist>
+
+      <para>Le syst&egrave;me est d&eacute;sormais pr&ecirc;t pour
+      l'utilisation de la base SQLite comme source de donn&eacute;es
+      d'authentification. Vous pouvez ins&eacute;rer un utilisateur dans la
+      table <literal>shadow</literal> de la base de donn&eacute;es SQLite et
+      v&eacute;rifier qu'il est bien reconnu en utilisant la commande
+      <command>id</command> <option>nouvel_utilisateur</option>.</para>
+
+      <para>Il est maintenant n&eacute;cessaire de configurer le script de
+      r&eacute;plication. Celui-ci doit s'ex&eacute;cuter sur le serveur
+      esclave (celui disposant de la base de donn&eacute;es SQLite) par le
+      biais de <systemitem class="daemon">cron</systemitem> (ou un outil
+      similaire).</para>
+
+      <para>Il se trouve dans le r&eacute;pertoire
+      /usr/lib/vhffs/mirror/nss-mirror.pl. Copiez ce fichier sur le serveur
+      esclave et &eacute;ditez-le pour d&eacute;finir les variables
+      <varname>$PG_DB_HOST</varname>, <varname>$PG_DB_PORT</varname>,
+      <varname>$PG_DB_NAME</varname>, <varname>$PG_DB_USER</varname> et
+      <varname>$PG_DB_PASS</varname> pour les adapter &agrave; votre
+      configuration (n'oubliez pas de configurer le serveur PostgreSQL
+      ma&icirc;tre pour qu'il accepte les connexions de la part de
+      l'esclave<footnote>
+          <para>L'utilisateur d&eacute;fini dans le script n'a besoin que
+          d'acc&eacute;der aux tables <literal>vhffs_users</literal>,
+          <literal>vhffs_user_group</literal> et
+          <literal>vhffs_groups</literal> en lecture, il ne devrait pas
+          disposer de plus de privil&egrave;ges que n&eacute;cessaire.</para>
+        </footnote>). Si besoin, modifiez la variable
+      <varname>$ST_DB_FILE</varname> pour qu'elle corresponde au fichier de
+      base de donn&eacute;es SQLite pr&eacute;c&eacute;demment
+      cr&eacute;&eacute;.</para>
+
+      <para>Ajoutez une entr&eacute;e dans la <filename>crontab</filename>
+      pour lancer le script de mani&egrave;re r&eacute;guli&egrave;re (toutes
+      les 5, 10 ou 15 minutes, ou n'importe quelle valeur acceptable pour
+      votre syst&egrave;me). Il est conseill&eacute; de lancer une
+      premi&egrave;re fois le script &agrave; la main pour v&eacute;rifier
+      qu'il n'&eacute;met aucun message d'erreur, il est possible que vous
+      deviez installer le paquetage perl
+      <literal>DBD::SQLite</literal>.</para>
+
+      <para>Les utilisateurs enregistr&eacute;s et actifs sur la plateforme
+      VHFFS peuvent d&eacute;sormais acc&eacute;der au serveur esclave en
+      utilisant leur identifiants VHFFS.</para>
+    </section>
+  </section>
+
+  <section>
+    <title>myDNS</title>
+
+    <section>
+      <title>Introduction</title>
+
+      <para>Tout comme le NSS, myDNS peut profiter d'une r&eacute;plication
+      partielle de la base pour &eacute;viter les interrogations trop
+      fr&eacute;quentes vers le serveur principal. Contrairement au NSS cette
+      fois, la base esclave est &eacute;galement une base PostgreSQL. Les
+      donn&eacute;es &agrave; r&eacute;pliquer sont pr&eacute;sentes dans la
+      vue <literal>vhffs_dns_soa</literal> et la table
+      <literal>vhffs_dns_rr</literal>.</para>
+    </section>
+
+    <section>
+      <title>Configuration</title>
+
+      <para>Seule la mise en place du script de r&eacute;plication est
+      d&eacute;crite ici, la configuration de myDNS est d&eacute;crite dans le
+      <xref linkend="chap-mydns" /> (<xref endterm="title-mydns"
+      linkend="chap-mydns" />).</para>
+
+      <para>Il est possible de placer le script de r&eacute;plication sur le
+      serveur ma&icirc;tre ou sur le serveur esclave. Les serveurs PostgreSQL
+      devront &ecirc;tre configur&eacute;s selon les choix effectu&eacute;s.
+      La configuration se r&eacute;sume au positionnement des variables
+      <varname>$MASTER_DB_HOST</varname>, <varname>$MASTER_DB_PORT</varname>,
+      <varname>$MASTER_DB_NAME</varname>, <varname>$MASTER_DB_USER</varname>
+      et <varname>$MASTER_DB_USER</varname> (ainsi que leurs homologues
+      pr&eacute;fix&eacute;es par <varname>$SLAVE_</varname>). Les variables
+      pr&eacute;fix&eacute;es par <varname>$MASTER_</varname>
+      d&eacute;finissent les param&egrave;tres de connexion au serveur
+      ma&icirc;tre (contenant la base de donn&eacute;es VHFFS) tandis que
+      celles pr&eacute;fix&eacute;es par <varname>$SLAVE_</varname>
+      d&eacute;finissent les param&egrave;tres de connexion au serveur
+      esclave.</para>
+
+      <para>Au niveau du serveur ma&icirc;tre, le script a besoin
+      d'acc&eacute;der &agrave; la <emphasis>vue</emphasis>
+      <literal>vhffs_dns_soa</literal> et &agrave; la
+      <emphasis>table</emphasis> <literal>vhffs_dns_rr</literal>. La base de
+      donn&eacute;es esclave doit contenir au minimum deux tables,
+      <literal>vhffs_dns_soa</literal> et <literal>vhffs_dns_rr</literal> qui
+      ont le m&ecirc;me sch&eacute;ma que la vue et la table sources des
+      donn&eacute;es.</para>
+    </section>
+  </section>
+
+  <section>
+    <title>exim</title>
+
+    <section>
+      <title>Introduction</title>
+
+      <para>Le troisi&egrave;me service &agrave; disposer de script de
+      r&eacute;plication livr&eacute;s avec VHFFS est le serveur mail Exim.
+      Cela permet d'avoir un mx2, en particulier, avec un l&eacute;ger retard
+      sur la configuration principale mais n'effectuant aucune requ&ecirc;te
+      distante.</para>
+    </section>
+
+    <section>
+      <title>Configuration</title>
+
+      <para></para>
+    </section>
+  </section>
+</chapter>
\ No newline at end of file

Added: trunk/vhffs-doc/part1/mydns.xml
===================================================================
--- trunk/vhffs-doc/part1/mydns.xml	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/part1/mydns.xml	2007-07-05 18:55:56 UTC (rev 668)
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="US-ASCII"?>
+<chapter id="chap-mydns">
+  <title>Configuration de myDNS</title>
+
+  <titleabbrev id="title-mydns">Configuration de myDNS</titleabbrev>
+
+  <section>
+    <title></title>
+
+    <para></para>
+  </section>
+</chapter>
\ No newline at end of file

Added: trunk/vhffs-doc/vhffs-doc.xml
===================================================================
--- trunk/vhffs-doc/vhffs-doc.xml	2007-07-05 17:37:09 UTC (rev 667)
+++ trunk/vhffs-doc/vhffs-doc.xml	2007-07-05 18:55:56 UTC (rev 668)
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="US-ASCII"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [
+<!ENTITY __mydns__f3rg7ac0 SYSTEM "part1/mydns.xml">
+<!ENTITY __mirror__f3rb0jwd SYSTEM "part1/mirror.xml">
+]>
+<book lang="fr">
+  <title>Documentation de VHFFS</title>
+
+  <bookinfo>
+    <date>Juillet 2007</date>
+
+    <authorgroup>
+      <corpauthor>&Eacute;quipe VHFFS</corpauthor>
+
+      <author>
+        <surname>Le Ray</surname>
+
+        <firstname>S&eacute;bastien</firstname>
+
+        <contrib>Cr&eacute;ation du document</contrib>
+      </author>
+    </authorgroup>
+  </bookinfo>
+
+  <part>
+    <title>Pour l'administrateur</title>
+
+    &__mydns__f3rg7ac0;
+
+    &__mirror__f3rb0jwd;
+  </part>
+
+  <part>
+    <title>Pour le d&eacute;veloppeur</title>
+  </part>
+</book>
\ No newline at end of file


Mail converted by MHonArc 2.6.19+ http://listengine.tuxfamily.org/