[vhffs-dev] [668] New documentation is comming ( does someone know how to autotoolize docbook ?). |
[ Thread Index |
Date Index
| More vhffs.org/vhffs-dev Archives
]
- To: vhffs-dev@xxxxxxxxx
- Subject: [vhffs-dev] [668] New documentation is comming ( does someone know how to autotoolize docbook ?).
- From: subversion@xxxxxxxxx
- Date: Thu, 05 Jul 2007 20:55:57 +0200
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éplication</title>
+
+ <para>Dans le cadre d'une architecture distribuée, il peut être
+ souhaitable de répartir les services sur différentes machines.
+ Le problème des performances dues à l'accès à la
+ base de données distantes (celle directement alimentée par
+ VHFFS) peut alors se poser. Pour palier à cela il est possible de
+ répliquer certaines parties de la base principale sur les autres
+ machines. Cela permet d'alléger la charge du serveur de base de
+ données principal et d'améliorer les performances (puisque les
+ requêtes sont locales). La contrepartie est un certain décalage
+ possible entre les données du serveur principal et celles de la base
+ de données esclave (les scripts étant exécutés
+ à intervalle régulier).</para>
+
+ <section>
+ <title>Name Service Switch (NSS)</title>
+
+ <section>
+ <title>Introduction</title>
+
+ <para>Il s'agit du service bénéficiant du plus gros gain
+ de performances. le NSS est utilisé pour l'identification des
+ utilisateurs en SSH (utilisé notamment pour Subversion et CVS)
+ ainsi qu'en FTP. Les différentes requêtes permettent
+ d'afficher le propriétaire ou le groupe d'un fichier ainsi que de
+ savoir si un utilisateur peut accéder à tel ou tel fichier
+ (en obtenant ses UID/GID et en les comparant à ceux du fichier et
+ aux permissions).</para>
+
+ <para>Historiquement, il s'agissait de fichiers qui étaient
+ utilisés, aussi, les requêtes ne sont pas
+ spécialement adaptées à une base de données.
+ Le coût d'établissement d'une connexion peut être
+ important dans le cas d'une base de données distante.</para>
+
+ <para>La solution proposée par VHFFS est d'utiliser une
+ bibliothèque NSS basée sur SQLite (libnss-sqlite). La
+ partie de la base de données PostgreSQL concernant les
+ utilisateurs est dupliquée pour être utilisée par
+ libnss-sqlite.</para>
+ </section>
+
+ <section>
+ <title>Configuration</title>
+
+ <para>La configuration s'effectue de la même façon que
+ n'importe quelle bibliothèque NSS :</para>
+
+ <orderedlist>
+ <listitem>
+ <para>récupérez la dernière version de
+ libnss-sqlite sur <ulink
+ url="http://libnss-sqlite.tuxfamily.org">http://libnss-sqlite.tuxfamily.org</ulink> ;</para>
+ </listitem>
+
+ <listitem>
+ <para>si vous la compilez à partir des sources, utilisez les
+ classiques <command>./configure</command>, <command>make</command>
+ et <command>make install</command> (seule la dernière
+ commande doit être effectuée en root). Lancez
+ <command>./configure</command> <option>--help</option> pour une
+ liste des options disponibles. Vous aurez besoin des
+ bibliothèques de développement de sqlite ;</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> ;</para>
+ </listitem>
+
+ <listitem>
+ <para>créez la base de données esclave, dans laquelle
+ les données seront répliquées. Par
+ défaut, il s'agit de <filename>/var/db/auth.sqlite</filename>
+ (créez le répertoire <filename
+ class="directory">/var/db/</filename> s'il n'existe pas). Pour cela,
+ lancez la commande suivante depuis le répertoire des sources
+ de libnss-sqlite : <command>sqlite3</command> <option>-init
+ conf/schema.sql /var/db/auth.sqlite</option> (le fichier
+ devrait appartenir à <systemitem
+ class="username">root</systemitem> et être en mode
+ 644) ;</para>
+ </listitem>
+ </orderedlist>
+
+ <para>Le système est désormais prêt pour
+ l'utilisation de la base SQLite comme source de données
+ d'authentification. Vous pouvez insérer un utilisateur dans la
+ table <literal>shadow</literal> de la base de données SQLite et
+ vérifier qu'il est bien reconnu en utilisant la commande
+ <command>id</command> <option>nouvel_utilisateur</option>.</para>
+
+ <para>Il est maintenant nécessaire de configurer le script de
+ réplication. Celui-ci doit s'exécuter sur le serveur
+ esclave (celui disposant de la base de données SQLite) par le
+ biais de <systemitem class="daemon">cron</systemitem> (ou un outil
+ similaire).</para>
+
+ <para>Il se trouve dans le répertoire
+ /usr/lib/vhffs/mirror/nss-mirror.pl. Copiez ce fichier sur le serveur
+ esclave et éditez-le pour dé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 à votre
+ configuration (n'oubliez pas de configurer le serveur PostgreSQL
+ maître pour qu'il accepte les connexions de la part de
+ l'esclave<footnote>
+ <para>L'utilisateur défini dans le script n'a besoin que
+ d'accé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èges que nécessaire.</para>
+ </footnote>). Si besoin, modifiez la variable
+ <varname>$ST_DB_FILE</varname> pour qu'elle corresponde au fichier de
+ base de données SQLite précédemment
+ créé.</para>
+
+ <para>Ajoutez une entrée dans la <filename>crontab</filename>
+ pour lancer le script de manière régulière (toutes
+ les 5, 10 ou 15 minutes, ou n'importe quelle valeur acceptable pour
+ votre système). Il est conseillé de lancer une
+ première fois le script à la main pour vérifier
+ qu'il n'émet aucun message d'erreur, il est possible que vous
+ deviez installer le paquetage perl
+ <literal>DBD::SQLite</literal>.</para>
+
+ <para>Les utilisateurs enregistrés et actifs sur la plateforme
+ VHFFS peuvent désormais accé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éplication
+ partielle de la base pour éviter les interrogations trop
+ fréquentes vers le serveur principal. Contrairement au NSS cette
+ fois, la base esclave est également une base PostgreSQL. Les
+ données à répliquer sont pré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éplication est
+ décrite ici, la configuration de myDNS est dé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éplication sur le
+ serveur maître ou sur le serveur esclave. Les serveurs PostgreSQL
+ devront être configurés selon les choix effectués.
+ La configuration se ré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éfixées par <varname>$SLAVE_</varname>). Les variables
+ préfixées par <varname>$MASTER_</varname>
+ définissent les paramètres de connexion au serveur
+ maître (contenant la base de données VHFFS) tandis que
+ celles préfixées par <varname>$SLAVE_</varname>
+ définissent les paramètres de connexion au serveur
+ esclave.</para>
+
+ <para>Au niveau du serveur maître, le script a besoin
+ d'accéder à la <emphasis>vue</emphasis>
+ <literal>vhffs_dns_soa</literal> et à la
+ <emphasis>table</emphasis> <literal>vhffs_dns_rr</literal>. La base de
+ données esclave doit contenir au minimum deux tables,
+ <literal>vhffs_dns_soa</literal> et <literal>vhffs_dns_rr</literal> qui
+ ont le même schéma que la vue et la table sources des
+ données.</para>
+ </section>
+ </section>
+
+ <section>
+ <title>exim</title>
+
+ <section>
+ <title>Introduction</title>
+
+ <para>Le troisième service à disposer de script de
+ réplication livrés avec VHFFS est le serveur mail Exim.
+ Cela permet d'avoir un mx2, en particulier, avec un léger retard
+ sur la configuration principale mais n'effectuant aucune requê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>Équipe VHFFS</corpauthor>
+
+ <author>
+ <surname>Le Ray</surname>
+
+ <firstname>Sébastien</firstname>
+
+ <contrib>Création du document</contrib>
+ </author>
+ </authorgroup>
+ </bookinfo>
+
+ <part>
+ <title>Pour l'administrateur</title>
+
+ &__mydns__f3rg7ac0;
+
+ &__mirror__f3rb0jwd;
+ </part>
+
+ <part>
+ <title>Pour le développeur</title>
+ </part>
+</book>
\ No newline at end of file