root/traduc/trunk/slony/installation.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- DerniÚre modification
     le       $Date$
     par      $Author$
     révision $Revision$ -->

<sect1 id="installation">
<title>Installation de &slony1;</title>

<indexterm><primary>instructions d'installation</primary></indexterm>

<note> <para>Pour les utilisateurs de &windows; : À moins que 
    vous comptiez modifier le code de &slony1;, il est fortement
    recommandé de télécharger et d'installer une version 
    binaire précompilée et passer directement à la section
    configuration ci-dessous. Vous trouverez les liens et les 
    binaires officiels sur <ulink url="http://pgfoundry.org/projects/slony1/">
le site pgFoundry de &slony1;</ulink>, notamment la version version 1.2.0.  </para>

<para> Il existe également des binaires RPM disponibles pour les versions récentes
  de &slony1; et de &postgres;.
</para>
</note>

<warning><para> Si vous utilisez &slony1; pour remplacer une version
    antérieure de &postgres; par une version récente, ou si vous
    souhaitez une version issue du CVS, en dehors du contexte de la
    sortie d'une version majeure, alors préparez vous à compiler
    Ã  la fois  &postgres; et &slony1; Ã  partir des sources.
    Cette section est rédigé en supposant que vous lu cet avertissement...</para>
</warning>

<para>Vous devez avoir obtenu les sources de &slony1; à l'étape précédante. 
  Décompressez le paquet.</para>

<screen>
gunzip slony.tar.gz;
tar xf slony.tar
</screen>

<para> Ceci va créer un répertoire contenant les sources dans votre répertoire courant.
  Déplacez-vous dans ce répertoire et rester y pendant toute la procédure d'installation.
.</para>

<sect2>
<title>Version courte</title>

<indexterm><primary> installation : version courte</primary></indexterm>

<para>
<screen>
PGMAIN=/usr/local/pgsql746-freebsd-2005-04-01 \
./configure \
    --with-pgconfigdir=$PGMAIN/bin
gmake all; gmake install
</screen>
</para>
</sect2>

<sect2>
<title>Configuration</title>

<indexterm><primary>Instructions de configuration</primary></indexterm>

<para> Normalement &slony1; doit être compilé et installé avec le compte
  Unix &postgres;. La cible de l'installation doit être identique à 
  l'installation &postgres; existante, notamment parce que plusieurs
  composants de &slony1; sont des librairies et des scripts SQL
  qui doivent être dans les répertoires <filename>lib</filename> et
<filename>share</filename> &slony1;. </para>

<para>La premiÚre étape de la procédure d'installation est de configurer 
  l'arbre des sources pour votre systÚme. Ceci se fait en 
  lançant le script <application>configure</application>. Dans les
  versions précédantes, <application>configure</application> devait 
  savoir où se trouvait l'arbre des sources de &postgres;, ce 
  qui était renseigné avec l'option <option>--with-pgsourcetree=</option>.
  À partir de la version 1.1, ceci n'est plus nécessaire, car 
  &slony1; inclut dans son propre code applicatif certaines parties
  nécessaire pour la probabilité entre les différentes plates-formes.
  Désormais il suffit de faire référence à des composants de &postgres;
  qui font partie de l'installation. Ainsi, &slony1; est configuré 
  en pointant vers les différentes répertoire de &postgres; : 
  library, binary, et include. Pour une liste complÚte de ces options,
  utiliser la commande <command>./configure --help</command>.</para>

<para> <emphasis>Normalement,</emphasis> il est suffisant d'exécuter
  <command>configure <option>--with-pgconfigdir=/some/path/somewhere</option></command>,
où <filename>/some/path/somewhere</filename> est l'emplacement ou se situe le 
programme  <application>pg_config</application> de  &postgres;.
À partir de <application>pg_config</application>, le script
<filename>configure</filename> peut déterminer les divers emplacements
où les composants &postgres; se trouvent, ce qui permet de déduire où
les composants essentiels de &slony1; doivent être installé.</para>

<para>Sur  certaines plate-formes (AIX et Solaris sont connus pour cela;
mais pas Linux ), la compilation de &postgres; doit être expressement
configuré avec l'option <command>--enable-thread-safety</command>
pour fournir les librairies clients correctes. </para>

<para> La version 8 de &postgres; installe les fichiers d'en-tête
  <command>#include</command> par défaut. Avec la version 7.4 et
  antérieures, vous devez vous assurez que la compilation inclue
  la commande <command>make install-all-headers</command>, sinon 
  les en-tête du serveur ne seront pas installés, et &slony1; 
  ne sera pas capable de compiler.</para>

<para>AprÚs avoir lancé configure, vous pouvez ouvrir le fichier 
<filename>Makefile.global</filename> pour vous assurer qu'il 
recherche tous les composants dans les bons emplacements.
</para>


</sect2>

<sect2>
<title>Exemple</title>

<para> AprÚs avoir déterminé que l'instance &postgres; est installé dans
<filename>/opt/dbs/pgsql746-aix-2005-04-01</filename>:</para>

<screen>
PGMAIN=/opt/dbs/pgsql746-aix-2005-04-01 \
./configure \
    --with-pgconfigdir=$PGMAIN/bin 
</screen>

<para>Le script <application>configure</application> lancera de nombreux
tests pour deviner les valeurs de différentes variables et tente de
détecter certains particularités de votre systÚme.
&slony1; est connu pour avoir besoin d'une version modifiée de 
<application>libpq</application> sur des plate-formes spécifiques
telles que Solaris2.X sur SPARC.  Le correctif de la version 
7.4.2 de la libpq se trouvent à l'adresse <ulink id="threadpatch" url=
"http://developer.postgresql.org/~wieck/slony1/download/threadsafe-libpq-742.diff.gz">
http://developer.postgresql.org/~wieck/slony1/download/threadsafe-libpq-742.diff.gz
</ulink> Des correctifs similaires peuvent compilés pour d'autres versions;
voir l'entrée dans la FAQ intitulée <link linkend="threadsafety"> sécurité des threads
</link>. </para>

<para> Pour une liste de toutes les options de configuration, lancer la commande
<command>./configure --help</command>.</para>
</sect2>

<sect2>
<title>Compilation</title>

<para>Pour démarrer le processus de compilation, tapez :

<screen>
gmake all
</screen></para>

<para> Assurez d'utiliser GNU make; sur les systÚmes BSD, il est appelé
<application>gmake</application>; sur Linux, GNU make est généralement
le <application>make</application> <quote>natif</quote>, ainsi le
nom de la commande que vous devez taper peut être  <command>make</command> ou
<command>gmake</command>.  Sur d'autres plate-formes, vous aurez peut-être 
besoin de paquets supplémentaires ou même un installation complÚte de 
GNU make.  La compilation prend entre quelques secondes et 
2 minutes selon la rapidité de votre matériel. La derniÚre ligne affichée
devrait être :</para>

<para> <command> All of Slony-I is successfully made.  Ready to
install.  </command></para>
</sect2>

<sect2>
<title> Installer &slony1; une fois compilé</title>

<para> Pour installer &slony1;, tapez :

<command>
gmake install
</command></para>

<para>Ceci va installer les fichiers dans le répertoire d'installation
  de the PostgreSQL tel que spécifié par l'option <option>--prefix</option>
  de <command>configure</command> utilisé lors de l'installation de 
  &postgres;. Assurez-vous que vous avez les permissions adéquates pour écrire
  dans cette emplacement. En général, vous devez être soit root ou l'utilisateur
  postgres.
</para>

<para>Voici la liste des fichiers principaux installés dans l'instance PostgreSQL :</para>
<itemizedlist>
<listitem><para><filename> $bindir/slon</filename></para></listitem>
<listitem><para><filename> $bindir/slonik</filename></para></listitem>
<listitem><para><filename> $libdir/slony1_funcs$(DLSUFFIX)</filename></para></listitem>
<listitem><para><filename> $libdir/xxid($DLSUFFIX)</filename></para></listitem>
<listitem><para><filename> $datadir/slony1_base.sql</filename></para></listitem>
<listitem><para><filename> $datadir/slony1_base.v73.sql</filename></para></listitem>
<listitem><para><filename> $datadir/slony1_base.v74.sql</filename></para></listitem>
<listitem><para><filename> $datadir/slony1_base.v80.sql</filename></para></listitem>
<listitem><para><filename> $datadir/slony1_funcs.sql</filename></para></listitem>
<listitem><para><filename> $datadir/slony1_funcs.v73.sql</filename></para></listitem>
<listitem><para><filename> $datadir/slony1_funcs.v74.sql</filename></para></listitem>
<listitem><para><filename> $datadir/slony1_funcs.v80.sql</filename></para></listitem>
</itemizedlist>

<para> (Notez qu'au fur et à mesure des versions, la liste des fichiers spécifiques à 
  une version va s'agrandir...) </para>

<para>Les fichiers <filename>.sql</filename> ne sont pas encore complÚtement
  installés. Les versions 7.3, 7.4 et 8.0 des fichiers sont installés
  sur chaque systÚmes, quelque soit la version de &postgres;.
  L'outil d'administration <xref linkend="slonik"/> effectue des substitutions
  d'espace de noms et de cluster dans ces fichiers, puis chargent les fichiers
  lors de la création d'un noeud de réplication. À cet instant, la base de donnée
  qui est initialisée peut être à distance ou utiliser une version différente
  de &postgres; par rapport à la version de l'hÎte local.</para>

<para> Pour terminer, les deux objets partagés installés dans le répertoire
  <filename>$libdir</filename> doivent être installés sur chaque
  ordinateur qui va devenir un noeud &slony1;. ( D'autres composants
  peuvent être chargés à distance à partir des autres noeuds.) </para>

</sect2>

<sect2> <title> Compiler la documentation: Guide d'administration </title>

<indexterm><primary> compiler la documentation &slony1; </primary></indexterm>

<para> Le document que vous êtes en train de lire est un <quote>guide d'administration</quote>
  trÚs complet qui contient toute la sagesse découverte lors de l'utilisation
  et la maintenance de &slony1;.</para>

<para> Cette documentation est compilé uniquement si vous spécifiez l'option 
  <command>--with-docs</command></para>

<para> Notez que vous pouvez rencontrer des difficultés pour compiler
  la documentation sur les systÚmes basés sur Red Hat à cause 
  de la valeut NAMELEN qui est trop faible.
  Havoc Pennington a déclaré ce bug au milieu de l'année 2001, à l'époque
  de Red Hat 7.1; La société Red Hat Software a reconnu ce bug, 
  mais il n'y a eu aucun progrÚs depuis. La seconde URL ci-dessous
  indique qu'il y a eu des tentatives de correction en élevant 
  la valeur de NAMELEN dans une future version de Red Hat Enterprise Linux,
  mais cela n'est pas le cas en 2008.  La distribution Fedora Core 4 
  devrait avoir corrigé ce problÚme plus tÎt. </para>

<para>
<ulink url=
"https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=36058"> Bug
36058 </ulink> </para>

<para>
<ulink url=
"https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=159382"> Bug
159382 (For RHEL) </ulink> </para>

<para>Une version  pré-compilée du "guide de l'admin" est disponible
  soit sous la forme de paquets tarball séparés, ou dans le répertoire
<filename>doc/adminguide/prebuilt</filename> </para>

<para> Voir le fichier <filename>INSTALL</filename> pour un contournement
  du problÚme sous Fedora...</para>

</sect2>

<sect2>
<title> Installer &slony1; Ã  partir des RPMs</title>

<para> Même si &slony1; peut être compilé et exécuté sur 
  la pluspart des distributions Linux, il est également possible
  d'installer &slony1; en utilisant des paquets binaires.
  L'équipe de développement de Slony ( NdT :"Slony Global Development Team")
  fournit des paquets RPMs et SRPMs officiels pour différentes versions
  de Red Hat et Fedora Core.</para>

<para>Les RPMs sont disponibles sur <ulink
url="http://pgfoundry.org/projects/slony1/"> le site &slony1; sur pgFoundry.org
</ulink>. Lisez le fichier <command> CURRENT_MAINTAINER</command> pour 
plus de détails sur les RPMs. Notez que ces RPMs rechercheront 
&postgres; tel qu'installé par RPM, donc si vous avez installé
&postgres; Ã  partir des sources, vous devez ignorer explicitement
les dépendances liées à &postgres;.</para>

<para>Installer &slony1; Ã  partir de ces RPMs est aussi facile
  qu'avec n'importe quel paquet RPM :</para>

<screen>rpm -ivh postgresql-slony1-engine-....rpm</screen>

<para>Si vous voulez mettre à jour une version antérieur, utilisez simplement
  la commande <command>rpm -Uvh</command>. Cependant n'oubliez pas de suivre 
  la procédure habituelle de mise à jour.</para>

<para>Le paquet RPM installe les fichiers à leur emplacements habituels.
  Les fichiers de configuration sont dans le répertoire <filename>/etc</filename>,
  les fichiers binaires sont installés dans <filename>/usr/bin</filename>,
  les librairies sont dans <filename>/usr/lib/pgsql</filename>, et enfin 
  la documentation est située dans <filename>/usr/share/doc/postgresql-slony1-engine</filename>.
</para>

</sect2>

<sect2>
<title> Installer le service &slony1; sur &windows;</title>

<indexterm><primary>installation &slony1; sur &windows;</primary></indexterm>

<para> Sur les systÚmes &windows;, au lieu de lancer un démon <xref
linkend="slon"/> par noeud, un service slon unique est installé
et peut alors être contrÎlé via le panneau de contrÎle des <command>Services</command>,
ou à partir de la console de commande en utilisant la commande
<command>net</command>.</para>

<screen>
C:\Program Files\PostgreSQL\8.0\bin> slon -regservice my_slon
Service registered.
Before you can run Slony, you must also register an engine!

WARNING! Service is registered to run as Local System. You are
encouraged to change this to a low privilege account to increase
system security. 
</screen>

<para> Une fois que le service est installé, les noeuds individuels peuvent
  être configurés en enregistrant les fichiers de configuration auprÚs du service :
</para>

<screen>
C:\Program Files\PostgreSQL\8.0\bin> slon -addengine c:\node1.conf
Engine added.
</screen>

<para>Les autres commandes sont équivoques : <command>slon -unregservice 
&lt;nom du service&gt;</command>, <command>slon -listengines 
&lt;nom du service&gt;</command> et <command>slon -delengine 
&lt;nom du service&gt; &lt;config file&gt;</command>.</para> 

<para> Pour plus d'informations à propos de la version &windows;, vous pouvez 
  consulter les pages suivantes : </para>

<itemizedlist>

<listitem><para> <ulink
url="http://developer.pgadmin.org/~hiroshi/Slony-I/"> Exemple d'installation de Slony-I sous Windows (en anglais)
</ulink> </para> </listitem>

<listitem><para> <ulink url=
"http://people.planetpostgresql.org/xzilla/index.php?/archives/200-Alpha-testing-Slony-on-win32-Crib-Notes.html">
Notes rapides suite à des tests de Slony sous Windows par xzilla (en anglais) </ulink> </para> </listitem>

</itemizedlist>

</sect2>

</sect1>