Changeset 1087

Show
Ignore:
Timestamp:
07/03/08 11:08:14 (3 months ago)
Author:
daamien
Message:

Slony : slonik_ref.xml : traduction en cours (1/3)

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • traduc/trunk/slony/slonik_ref.xml

    r969 r1087  
    66 
    77<article id="slonikref"> 
    8 <title>Slonik Command Summary</title> 
     8<title>Tour d'horizon des commandes Slonik</title> 
    99   <sect1><title>Introduction</title> 
    1010     
    1111    <para> 
    12      <application>Slonik</application> is a command line utility designed 
    13      specifically to setup and modify configurations of the 
    14      &slony1; replication system. 
     12     <application>Slonik</application> est un utilitaire en ligne de commande 
     13     conçu spécifiquement pour mettre en place et modifier la configuration  
     14     d'un systÚme de réplication &slony1;. 
    1515    </para> 
    1616    
    1717   <sect2 id="outline"> 
    18     <title>General outline</title> 
    19      
    20     <para> 
    21      The <application>slonik</application> commandline utility is 
    22      supposed to be used embedded into shell scripts and reads 
    23      commands from files or stdin (via here documents for 
    24      example). Nearly all of the <emphasis>real</emphasis> 
    25      configuration work is done by calling stored procedures after 
    26      loading the &slony1; support base into 
    27      a database.  You may find documentation for those procedures in 
    28      the <ulink url="schemadoc">&slony1; 
    29      Schema Documentation</ulink>, as well as in comments associated 
    30      with them in the database. 
    31     </para> 
    32  
    33     <para> 
    34      <application>Slonik</application> was created because: 
     18    <title>Considérations générales</title> 
     19     
     20    <para> 
     21     L'utilitaire en ligne de commande <application>slonik</application> 
     22     est suppposé être intégré dans des scripts shell et lit  
     23     les commandes à partir d'un fichier ou de stdin ( voir plus  
     24     bas pour des exemples ). Presque tout le travail de configuration 
     25      <emphasis>réel</emphasis> est effectué en appelant des procédures 
     26      stockées aprÚs avoir chargé la base de support &slony1; dans  
     27      la base de données. Vous pouvez trouver de la documentation sur 
     28      ces procédures dans le chapitre <ulink url="schemadoc">&slony1; 
     29     Documentation du Schéma</ulink>, ainsi que dans les commentaires 
     30     qui sont associé aux procédures dans la base de données. 
     31    </para> 
     32 
     33    <para> 
     34     <application>Slonik</application> a été créé car: 
    3535     <itemizedlist> 
    3636       
    37       <listitem><para>The stored procedures have special requirements 
    38         as to on which particular node in the replication system they 
    39         are called,</para></listitem> 
     37      <listitem><para>Les procédures stockées ont des besoin d'informations 
     38          spécifiques telles que l'identifiant du noeud de réplication  
     39          sur lequel elles sont appelées;</para></listitem> 
    4040       
    41       <listitem><para>The lack of named parameters for stored 
    42         procedures makes it rather difficult to do this from the 
    43         <application>psql</application> prompt, and</para></listitem> 
     41      <listitem><para>L'absence de paramÚtres nommés dans les  
     42          procédures stocées rend difficile de faire cela depuis 
     43          l'invite de commande  <application>psql</application>; 
     44          </para></listitem> 
    4445       
    45       <listitem><para><application>psql</application>lacks the ability 
    46         to maintain multiple connections with open 
    47         transactions.</para></listitem> 
     46      <listitem><para><application>psql</application>n'a pas la possibilité 
     47          de maintenir plusieurs connexions avec des transactions ouvertes. 
     48          </para></listitem> 
    4849     </itemizedlist> 
    4950    </para> 
    …… 
    5152      
    5253    </para> 
    53     <sect3><title>Commands</title> 
     54    <sect3><title>Commandes</title> 
    5455     <para> 
    55       The slonik command language is format free. Commands begin with 
    56       keywords and are terminated with a semicolon. Most commands have 
    57       a list of parameters, some of which have default values and are 
    58       therefore optional. The parameters of commands are enclosed in 
    59       parentheses. Each option consists of one or more keywords, 
    60       followed by an equal sign, followed by a value. Multiple options 
    61       inside the parentheses are separated by commas. All keywords are 
    62       case insensitive.  The language should remind the reader of SQL. 
     56      Le format du langage de commande slonik est libre. 
     57      Les commandes commence par des mots-clefs et sont terminées 
     58      par un point-virgule. La pluspart des commande ont une liste de  
     59      paramÚtres, certains ont une valeur par défaut et sont donc  
     60      facultatifs. Les paramÚtres de commandes sont entourés par des 
     61      parenthÚses. Chaque option est constituée d'un ou plusieurs 
     62      mots-clefs, suivis d'un symbole égal, suivi d'une valeur. Les  
     63      optons multiples à l'intérieur de parenthÚses sont séparées par 
     64      des virgules. Tous les mot-clefs sont sensibles à la casse. Le 
     65      langage devrait rappeler le SQL. 
    6366     </para> 
    6467     <para> 
    65       Option values may be: 
     68      Les valeurs d'option peuvent être : 
    6669      <itemizedlist> 
    67        <listitem><para>integer values</para></listitem> 
    68        <listitem><para>string literals enclosed in single quotes</para></listitem> 
    69        <listitem><para>boolean values {TRUE|ON|YES} or {FALSE|OFF|NO}</para></listitem> 
    70        <listitem><para>keywords for special cases</para></listitem> 
     70       <listitem><para>des entiers;</para></listitem> 
     71       <listitem><para>des chaines caractÚres entourés de quotes;</para></listitem> 
     72       <listitem><para>des valeurs booléennes  {TRUE|ON|YES} ou {FALSE|OFF|NO};</para></listitem> 
     73       <listitem><para>des mots-clefs dans des cas spécifiques</para></listitem> 
    7174      </itemizedlist> 
    7275     </para></sect3> 
    73     <sect3><title>Comments</title> 
     76    <sect3><title>Commentaires</title> 
    7477     <para> 
    75       Comments begin at a hash sign (#) and extend to the end of the line. 
     78      Les commentaires commencent par un diÚse (#) et vont jusqu'à la fin de la ligne. 
    7679     </para></sect3> 
    77     <sect3><title>Command groups</title> 
     80    <sect3><title>Groupes de commandes</title> 
    7881     <para> 
    79       Commands can be combined into groups of commands with optional 
    80       <command>on error</command> and <command>on success</command> conditionals. 
    81       The syntax for this is: 
     82      Les commandes peuvent être combinées par groupes de commandres avec une  
     83      éventuellement une condition <command>on error</command> et  
     84      <command>on success</command>.  
     85      La syntaxe est la suivante : 
    8286      <programlisting> 
    8387       try { 
    …… 
    8892      </programlisting></para> 
    8993 
    90      <para> Those commands are grouped together into one transaction 
    91       per participating node. </para> 
     94     <para> Ces commandes sont regroupées ensemble au sein d'une transaction 
     95      pour chaque noeud participant.</para> 
    9296<!-- ************************************************************ --></sect3></sect2></sect1></article> 
    9397 
    9498 <reference id="metacmds"> 
    95   <title>Slonik Meta Commands</title> 
     99  <title>Meta-commandes Slonik</title> 
    96100  <partintro> 
    97101   <para> 
    98      The following commands may be used to somewhat abstract the 
    99      definitions of components of Slonik scripts; <xref 
    100      linkend="stmtinclude"/> grouping configuration into central files 
    101      that may be reused, and <xref linkend="stmtdefine"/> allowing 
    102      mnemonic identifiers to replace cryptic numeric object IDs. 
     102     Les commandes suivantes sont utilisées pour séparer 
     103     les définitions des composants des scripts Slonik; 
     104      <xref linkend="stmtinclude"/> regroupe la configuration  
     105      dans des fichiers centraux qui peuvent être réutilisés, et  
     106      <xref linkend="stmtdefine"/> permet de remplacer les identifiants 
     107      numérique et esotérique des objets par des identifiants mnémotechniques. 
    103108   </para> 
    104109  </partintro> 
    …… 
    109114   <refnamediv><refname>INCLUDE</refname> 
    110115     
    111     <refpurpose> pulling in slonik code from another file </refpurpose> 
     116    <refpurpose> insérer du code slonik à partir d'un autre fichier </refpurpose> 
    112117   </refnamediv> 
    113118   <refsynopsisdiv> 
    114119    <cmdsynopsis> 
    115120     <command>include </command> 
    116      <arg><replaceable class="parameter"> &lt;pathname&gt;</replaceable></arg> 
    117     </cmdsynopsis> 
    118    </refsynopsisdiv> 
    119    <refsect1> 
    120     <title>Description</title> 
    121     <para> 
    122       This draws the specified slonik script inline into the present 
    123       script.  If the <option>pathname</option> specifies a relative 
    124       path, <xref linkend="slonik"/> will search relative to the 
    125       current working directory. 
    126     </para> 
    127  
    128     <para> 
    129       Nested include files are supported.  The scanner and parser 
    130       report the proper file names and line numbers when they run into 
    131       an error. </para> 
    132    </refsect1> 
    133    <refsect1><title>Example</title> 
     121     <arg><replaceable class="parameter"> &lt;chemin&gt;</replaceable></arg> 
     122    </cmdsynopsis> 
     123   </refsynopsisdiv> 
     124   <refsect1> 
     125    <title>Description</title> 
     126    <para> 
     127      Ceci injecte le script slonik spécifié à l'intérieur du script actuel. 
     128      Si le <option>chemin</option> est relatif, <xref linkend="slonik"/>  
     129      cherchera à partir du répertoire de travail. 
     130    </para> 
     131 
     132    <para> 
     133      Les inclusions imbriquées sont supportées. Le scanner et l'analyser 
     134      retourne le bon nom de fichier et le numéro ligne correcten cas 
     135      d'erreur. 
     136      </para> 
     137   </refsect1> 
     138   <refsect1><title>Exemple</title> 
    134139    <programlisting> 
    135140     include &lt;/tmp/preamble.slonik&gt;; 
    136141    </programlisting> 
    137142   </refsect1> 
    138    <refsect1> <title> Version Information </title> 
    139     <para> This command was introduced in &slony1; 1.1 </para> 
     143   <refsect1> <title> Note de version </title> 
     144    <para> Cette commande fut introduite dans &slony1; 1.1 </para> 
    140145   </refsect1> 
    141146  </refentry> 
    …… 
    146151   <refnamediv><refname>DEFINE</refname> 
    147152     
    148     <refpurpose> Defining a named symbol </refpurpose> 
     153    <refpurpose> Définir un nom symbolique </refpurpose> 
    149154   </refnamediv> 
    150155   <refsynopsisdiv> 
    151156    <cmdsynopsis> 
    152157     <command>define </command> 
    153      <arg><replaceable class="parameter"> name </replaceable></arg> 
    154      <arg><replaceable class="parameter"> value </replaceable></arg> 
    155     </cmdsynopsis> 
    156    </refsynopsisdiv> 
    157    <refsect1> 
    158     <title>Description</title> 
    159     <para> 
    160       This defines a named symbol.  Symbol names must follow the 
    161       slonik rules for constructing identifiers, by starting with a 
    162       letter, followed by letters, numbers, and underscores. 
    163     </para> 
    164  
    165     <para> 
    166       Symbol values may contain spaces and may recursively contain 
    167       symbol references. 
    168     </para> 
    169  
    170     <para> 
    171       Symbols are referenced by using a <quote>@</quote> followed by 
    172       the symbol name.  Note that symbol referencing is suppressed 
    173       inside string literals. 
    174     </para> 
    175    </refsect1> 
    176    <refsect1><title>Example</title> 
    177     <programlisting> 
    178 define    cluster movies; 
     158     <arg><replaceable class="parameter"> nom </replaceable></arg> 
     159     <arg><replaceable class="parameter"> valeur </replaceable></arg> 
     160    </cmdsynopsis> 
     161   </refsynopsisdiv> 
     162   <refsect1> 
     163    <title>Description</title> 
     164    <para> 
     165      Ceci définit un nom symbolique. Les noms symboliques doivent 
     166      respecter les rÚgles de slonik en matiÚre de construction d'identifiant, 
     167      en commençant par une lettre, suivie de lettres, de nombres et de soulignés ("_"). 
     168    </para> 
     169 
     170    <para> 
     171      Les valeurs des noms symboliques peuvent contenir des espaces et peuvent contenir 
     172      des références à des noms symboliques, de maniÚre récursive. 
     173    </para> 
     174 
     175    <para> 
     176      Les symboles sont réferencés en utilisant une arobase <quote>@</quote> suivi 
     177      du nom symbolique. Notons que le référencement d'un symbole est annulé 
     178      à l'intérieur des chaines de caractÚres. 
     179    </para> 
     180   </refsect1> 
     181   <refsect1><title>Exemple</title> 
     182    <programlisting> 
     183define    cluster films; 
    179184define    sakai   1; 
    180185define    chen    2; 
    …… 
    184189node @sakai admin conninfo = 'service=sakai-replication'; 
    185190node @chen  admin conninfo = 'service=chen-replication'; 
    186 define setMovies    id = 1; 
    187 define sakaiMovies  @setMovies, origin = @sakai; 
    188  
    189 create set ( @sakaiMovies, comment = 'movies' ); 
    190  
    191 set add table( set @sakaiMovies, id = 1, @fqn = 'public.customers',  
     191define setFilms    id = 1; 
     192define sakaiFilms  @setFilms, origin = @sakai; 
     193 
     194create set ( @sakaiFilms, comment = 'films' ); 
     195 
     196set add table( set @sakaiFilms, id = 1, @fqn = 'public.clients',  
    192197               comment = 'sakai customers' ); 
    193 set add table( set @sakaiMovies, id = 2, @fqn = 'public.tapes',      
    194                comment = 'sakai tapes' ); 
    195 echo 'But @sakaiMovies will display as a string, and is not expanded'; 
    196     </programlisting> 
    197    </refsect1> 
    198  
    199    <refsect1> <title> Version Information </title> 
    200     <para> This command was introduced in &slony1; 1.1 </para> 
     198set add table( set @sakaiFilms, id = 2, @fqn = 'public.cassettes',      
     199               comment = 'sakai cassettes' ); 
     200echo '@sakaiFilms sera affiché comme une chaine, et ne sera pas interprété'; 
     201    </programlisting> 
     202   </refsect1> 
     203 
     204   <refsect1> <title> Note de version </title> 
     205    <para> Cette commande fut introduite dans &slony1; 1.1 </para> 
    201206   </refsect1> 
    202207  </refentry> 
    …… 
    207212 
    208213 <reference id="hdrcmds">  
    209   <title>Slonik Preamble Commands</title> 
     214  <title>Commandes slonik préliminaires</title> 
    210215  <partintro> 
    211216   <para> 
    212     The following commands must appear as a <quote>preamble</quote> at 
    213     the beginning of each <application>slonik</application> command 
    214     script. They do not cause any direct action on any of the nodes in 
    215     the replication system, but affect the execution of the entire 
    216     script. 
     217    Les commandes suivantes doivent apparaître en <quote>préambule</quote> au 
     218    de chaque script de commande <application>slonik</application>.  
     219    Ils ne provoque aucune action directement sur les noeuds du  
     220    systÚme de réplication, mais affecte l'exécution du script tout entier. 
    217221   </para> 
    218222  </partintro> 
    …… 
    224228   <refnamediv><refname>CLUSTER NAME</refname> 
    225229     
    226     <refpurpose> preamble - identifying &slony1; cluster </refpurpose> 
     230    <refpurpose> préambule - identifier le cluster &slony1; </refpurpose> 
    227231   </refnamediv> 
    228232   <refsynopsisdiv> 
    229233    <cmdsynopsis> 
    230234     <command>CLUSTER NAME = </command> 
    231      <arg><replaceable class="parameter"> clustername;</replaceable></arg> 
    232     </cmdsynopsis> 
    233    </refsynopsisdiv> 
    234    <refsect1> 
    235     <title>Description</title> 
    236     <para> 
    237      Must be the very first statement in every 
    238      <application>slonik</application> script. It defines the 
    239      namespace in which all &slony1; 
    240      specific functions, procedures, tables and sequences are 
    241      defined. The namespace name is built by prefixing the given 
    242      string literal with an underscore. This namespace will be 
    243      identical in all databases that participate in the same 
    244      replication group. 
    245     </para> 
    246      
    247     <para> 
    248      No user objects are supposed to live in this namespace, and the 
    249      namespace is not allowed to exist prior to adding a database to 
    250      the replication system.  Thus, if you add a new node using 
    251      <command> pg_dump -s </command> on a database that is already in 
    252      the cluster of replicated databases, you will need to drop the 
    253      namespace via the SQL command <command> DROP SCHEMA _testcluster 
    254      CASCADE; </command>. 
    255     </para> 
    256    </refsect1> 
    257    <refsect1><title>Example</title> 
     235     <arg><replaceable class="parameter"> nom;</replaceable></arg> 
     236    </cmdsynopsis> 
     237   </refsynopsisdiv> 
     238   <refsect1> 
     239    <title>Description</title> 
     240    <para> 
     241     Ceci doit être la toute premiÚre ligne de chaque script 
     242     <application>slonik</application>. Elle définit l'espace 
     243     de nom dans lequel toutes les fonctions spécifiques, les procédures, 
     244     les tables et les séquences de &slony1; sont déclarées. 
     245     Le nom de l'espace de nom est construit en préfixant le chaine 
     246     de caractÚre fournie par un souligné. Ce nom d'espace sera  
     247     identique sur toutes les bases de données qui participent  
     248     aux même groupe de réplication. 
     249    </para> 
     250     
     251    <para> 
     252     Aucun objet utilisateur n'est supposé être placé dans cet espace de nom, 
     253     et l'espace de nom ne doit exister avant l'ajout de la base de données 
     254     dans le systÚme de réplication. Ainsi, si vous ajouter un nouveau noeud 
     255     en utilisant <command> pg_dump -s </command> sur une base qui est déjà  
     256     dans le cluster de réplication, vous devrez supprimer l'espace de nom 
     257     avec la commande SQL<command> DROP SCHEMA _testcluster CASCADE; </command>. 
     258    </para> 
     259   </refsect1> 
     260   <refsect1><title>Exemple</title> 
    258261    <programlisting> 
    259262     CLUSTER NAME = testcluster; 
    260263    </programlisting> 
    261264   </refsect1> 
    262    <refsect1> <title> Version Information </title> 
    263     <para> This command was introduced in &slony1; 1.0 </para> 
     265   <refsect1> <title> Note de version </title> 
     266    <para> Cette commande fut introduite dans &slony1; 1.0 </para> 
    264267   </refsect1> 
    265268  </refentry> 
    …… 
    272275    
    273276   <refnamediv><refname>ADMIN CONNINFO</refname> 
    274     <refpurpose> preamble - identifying &postgres; database </refpurpose> 
     277    <refpurpose> preambule - identifier la base &postgres;</refpurpose> 
    275278   </refnamediv> 
    276279   <refsynopsisdiv> 
    …… 
    284287    <title>Description</title> 
    285288    <para> 
    286      Describes how the <application>slonik</application> utility can 
    287      reach a nodes database in the cluster from where it is run 
    288      (likely the DBA's workstation). The conninfo string is the string 
    289      agrument given to the <function>PQconnectdb()</function> libpq 
    290      function. The user used to connect must be the special 
    291      replication superuser, as some of the actions performed later may 
    292      include operations that are strictly reserved for database 
    293      superusers by &postgres;. 
    294     </para> 
    295  
    296     <para> 
    297      The <application>slonik</application> utility will not try to 
    298      connect to a given database unless some subsequent command 
    299      requires the connection. 
     289     Décrit comment l'utilitaire <application>slonik</application> peut 
     290     atteindre les bases des noeuds du cluster à partir du l'endroit 
     291     où il se trouve (en général le poste de travail de l'administrateur) 
     292     La chaine connifo est l'argument passé à la fonction  
     293     libpq <function>PQconnectdb()</function>. L'utlisateur qui se connecter 
     294     doit être un super-utilisateur spécifique à la réplication, car certaines 
     295     actions réalisées par la suite comprennent des opérations strictement réservées 
     296     aux super-utilisateurs du serveur  &postgres;. 
     297    </para> 
     298 
     299    <para> 
     300     L'utilitaire <application>slonik</application> n'essaie pas de se connecter 
     301     Ã  une base de donnnée que si un commande nécessite une connexion. 
    300302    </para> 
    301303 
    302304   <note> <para> 
    303      As mentioned in the original documents, 
    304      &slony1; is designed as an enterprise 
    305      replication system for data centers. It has been assumed 
    306      throughout the entire development that the database servers and 
    307      administrative workstations involved in replication and/or setup 
    308      and configuration activities can use simple authentication 
    309      schemes like <quote>trust</quote>.  Alternatively, libpq can read 
    310      passwords from <filename> .pgpass </filename>. 
     305     Comme indique dans les document originaux, &slony1; est conçu comme  
     306     une systÚme de réplication d'entreprises pour datacenters. Lors du développement 
     307     du logiciel, on présuppose que les serveurs de bases de données et les postes 
     308     de travail impliqués dans la réplication et/ou dans les activités de mise en place et  
     309     de configuration peuvent utiliser des méthodes simples d'authentification telle que 
     310     <quote>trust</quote>.  Cependant, libpq peut lire les mots de passe dans le fichier 
     311     <filename> .pgpass </filename>. 
    311312    </para> 
    312313   </note> 
    313314   <note> 
    314315    <para> 
    315     If you need to change the DSN information for a node, as would 
    316     happen if the IP address for a host were to change, you must 
    317     submit the new information using the <xref 
    318     linkend="stmtstorepath"/> command, and that configuration will be 
    319     propagated.  Existing <application> slon </application> processes 
    320     may need to be restarted in order to become aware of the 
    321     configuration change. 
     316    Si vous devez changer les informations DSN pour un noeud, par exemple si  
     317    l'adresse IP d'un hÃŽte est modifiée, vous devez soumettre cette nouvelle 
     318    information avec la commande  <xref linkend="stmtstorepath"/>, 
     319    et la configuration sera propagée. Certains processus  
     320     <application> slon </application> existant devront être relancés afin qu'il  
     321     soient avertis de ce changement de configuration. 
    322322    </para> 
    323323   </note> 
    324324 
    325    <para> For more details on the distinction between this and <xref 
    326    linkend="stmtstorepath"/>, see &rplainpaths;.</para> 
    327  
    328    </refsect1> 
    329    <refsect1><title>Example</title> 
     325   <para>Pour plus de détails sur la distinction entre ceci et <xref 
     326   linkend="stmtstorepath"/>, consultez le chapitre &rplainpaths;.</para> 
     327 
     328   </refsect1> 
     329   <refsect1><title>Exemple</title> 
    330330    <programlisting> 
    331331     NODE 1 ADMIN CONNINFO = 'dbname=testdb host=server1 user=slony'; 
    332332    </programlisting> 
    333333   </refsect1> 
    334    <refsect1> <title> Version Information </title> 
    335     <para> This command was introduced in &slony1; 1.0 </para> 
     334   <refsect1> <title> Note de version </title> 
     335    <para> Cette commande fut introduite dans &slony1; 1.0 </para> 
    336336   </refsect1> 
    337337  </refentry> 
    …… 
    341341<!-- **************************************** --> 
    342342 <reference id="cmds"> 
    343   <title>Configuration and Action commmands</title> 
     343  <title>Commande de configuration et d'action</title> 
    344344<!-- **************************************** --> 
    345345   
    …… 
    349349   <refnamediv><refname>ECHO</refname> 
    350350     
    351     <refpurpose> Generic output tool </refpurpose> 
     351    <refpurpose> Outil générique de sortie </refpurpose> 
    352352   </refnamediv> 
    353353   <refsynopsisdiv> 
    354354    <cmdsynopsis> 
    355355     <command>echo </command> 
    356      <arg><replaceable class="parameter"> 'string'</replaceable></arg> 
    357     </cmdsynopsis> 
    358    </refsynopsisdiv> 
    359    <refsect1> 
    360     <title>Description</title> 
    361     <para> 
    362      Prints the string literal on standard output. 
     356     <arg><replaceable class="parameter"> 'message'</replaceable></arg> 
     357    </cmdsynopsis> 
     358   </refsynopsisdiv> 
     359   <refsect1> 
     360    <title>Description</title> 
     361    <para> 
     362     Affiche un message litéral sur la sortie standard. 
    363363    </para> 
    364364   </refsect1> 
    365365   <refsect1><Title>Example</Title> 
    366366    <programlisting> 
    367      ECHO 'Node 1 initialized successfully'; 
    368     </programlisting> 
    369    </refsect1> 
    370    <refsect1> <title> Version Information </title> 
    371     <para> This command was introduced in &slony1; 1.0 </para> 
     367     ECHO 'Noeud 1 initialisé correctement'; 
     368    </programlisting> 
     369   </refsect1> 
     370   <refsect1> <title> Note de version </title> 
     371    <para> Cette commande fut introduite dans &slony1; 1.0 </para> 
    372372   </refsect1> 
    373373  </refentry> 
    …… 
    380380   <refnamediv><refname>EXIT</refname> 
    381381     
    382     <refpurpose> Terminate Slonik script with signal </refpurpose> 
     382    <refpurpose> Termine un script Slonik avec un signal </refpurpose> 
    383383   </refnamediv> 
    384384   <refsynopsisdiv> 
    …… 
    391391    <title>Description</title> 
    392392    <para> 
    393      Terminates script execution immediately, rolling back every 
    394      open transaction on all database connections. The 
    395      <application>slonik</application> utility 
    396      will return the given value as its program termination code. 
     393     termine immédiatement un script d'éxecution, annulant toute 
     394     les transaction ouverte (roll back) sur toutes les bases de données 
     395     connectées. L'utilitaire <application>slonik</application> retournera 
     396     la valeur indiquée comme code de terminaison du programme. 
    397397    </para> 
    398398   </refsect1> 
    …… 
    402402    </programlisting> 
    403403   </refsect1> 
    404    <refsect1> <title> Version Information </title> 
    405     <para> This command was introduced in &slony1; 1.0 </para> 
     404   <refsect1> <title> Note de version </title> 
     405    <para> Cette commande fut introduite dans &slony1; 1.0 </para> 
    406406   </refsect1> 
    407407  </refentry> 
    …… 
    415415   <refnamediv> 
    416416    <refname>INIT CLUSTER</refname> 
    417     <refpurpose>Initialize &slony1; cluster</refpurpose></refnamediv> 
     417    <refpurpose>Initialise le cluster &slony1;</refpurpose></refnamediv> 
    418418   <refsynopsisdiv> 
    419419    <cmdsynopsis> 
    420420     <command>INIT CLUSTER</command>  
    421      <arg>ID = <replaceable class="parameter">integer</replaceable></arg> 
    422      <arg>COMMENT = <replaceable class="parameter">'string'</replaceable></arg> 
     421     <arg>ID = <replaceable class="parameter">entier</replaceable></arg> 
     422     <arg>COMMENT = <replaceable class="parameter">'chaine'</replaceable></arg> 
    423423    </cmdsynopsis> 
    424424   </refsynopsisdiv> 
    …… 
    426426    <title>Description</title>  
    427427 
    428     <para> Initialize the first node in a new &slony1; replication 
    429     cluster.  The initialization process consists of creating the 
    430     cluster namespace, loading all the base tables, functions, 
    431     procedures and initializing the node, using 
    432     &funinitializelocalnode; and &funenablenode;. 
     428    <para> Initialise le premier noeud d'un nouveau cluster de réplication &slony1;. 
     429    Le processus d'initialisation consiste à créer l'espace de nom du cluster, 
     430    charger toutes les tables, les functions, les procédures et initialiser le noeud 
     431    avec  &funinitializelocalnode; and &funenablenode;. 
    433432      
    434433     <variablelist> 
    435434      <varlistentry><term><literal>ID</literal></term> 
    436        <listitem><para>The unique, numeric ID number of the node.</para></listitem> 
     435       <listitem><para>L'identifiant numérique et unique du noeud.</para></listitem> 
    437436      </varlistentry> 
    438437       
    439       <varlistentry><term><literal>COMMENT = 'comment 
    440       text'</literal></term> <listitem><para> A descriptive text added 
    441       to the node entry in the table &slnode;.  
     438      <varlistentry><term><literal>COMMENT = 'commentaire'</literal></term>  
     439        <listitem><para> Un texte descriptif ajouté à la ligne du  noeud dans 
     440           la table &slnode;.  
    442441      </para></listitem> 
    443442      </varlistentry> 
    …… 
    446445    </para> 
    447446     
    448     <para> For this process to work, the SQL scripts of the 
    449     &slony1; system must be installed on the 
    450     DBA workstation (the computer currently executing the 
    451     <application>slonik</application> utility), while on the system 
    452     where the node database is running the shared objects of the 
    453     &slony1; system must be installed in the 
    454     &postgres; library directory. Also the procedural language 
    455     PL/pgSQL is assumed to already be installed in the target 
    456     database.</para> 
    457    </refsect1> 
    458    <refsect1> 
    459     <title>Example</title> 
     447    <para> Pour que ce processus fonctionne, les scripts SQL du systÚme  
     448      &slony1; doivent être installés sur le poste de travail de l'administrateur 
     449      (l'ordinateur utilisé pour exécuter l'utilitaire <application>slonik</application>), 
     450      tandis que sur le serveur qui héberge le noeud de base de donnée contenant les 
     451      objets partagés, &slony1; doit être installé dans le répertoire qui contient  
     452      les librairies de &postgres;. De plus le langage procédural 
     453    PL/pgSQL dit être installé au préalable sur la base de données cible. 
     454    </para> 
     455   </refsect1> 
     456   <refsect1> 
     457    <title>Exemple</title> 
    460458    <programlisting> 
    461459INIT CLUSTER ( 
    462460   ID = 1, 
    463    COMMENT = 'Node 1' 
     461   COMMENT = 'Noeud 1' 
    464462); 
    465463    </programlisting> 
    466464 
    467    <note> <para> This command functions very similarly to <xref 
    468    linkend="stmtstorenode"/>, the difference being that <command>INIT 
    469    CLUSTER </command> does not need to draw configuration from other 
    470    existing nodes. 
    471  
     465   <note> <para> Cette commande fonctionne de maniÚre similaire à  
     466       <xref linkend="stmtstorenode"/>, la différence étant que <command>INIT 
     467   CLUSTER </command> n'a pas besoin de récupérer la configuration des autres noeuds. 
    472468   </para> </note> 
    473    <note> <para> Be aware that some objects are created that contain 
    474    the cluster name as part of their name.  (Notably, partial indexes 
    475    on <envar>sl_log_1</envar> and <envar>sl_log_2</envar>.)  As a 
    476    result, <emphasis>really long</emphasis> cluster names are a bad 
    477    idea, as they can make object names <quote>blow up</quote> past the 
    478    typical maximum name length of 63 characters. </para> </note>  
    479    </refsect1> 
    480    <refsect1> <title> Locking Behaviour </title> 
    481  
    482     <para> This command creates a new namespace and configures tables 
    483     therein; no public objects should be locked during the duration of 
    484     this.</para> 
    485    </refsect1> 
    486    <refsect1> <title> Version Information </title> 
    487     <para> This command was introduced in &slony1; 1.0 </para> 
     469   <note> <para> Soyez conscients que certains objets qui sont créés contiennet 
     470       le nom du cluster à l'intérieur de leur nom  (Notamment, les index 
     471       partiels sur <envar>sl_log_1</envar> et <envar>sl_log_2</envar>). 
     472       Ceci implique que les noms de cluster <emphasis>trÚs longs</emphasis> 
     473       sont une mauvaise idée, car ils entrainent un dépassement des noms  
     474       d'objets au delà de la limite de 63 caractÚres. 
     475     </para> </note>  
     476   </refsect1> 
     477   <refsect1> <title> Utilisation de verrous </title> 
     478 
     479    <para> Cette commande crée un nouvel espace de noms et configure les 
     480      tables à l'intérieur; aucun objets public ne doit être verrouiller 
     481      pendant l'exécution de cette commade.</para> 
     482   </refsect1> 
     483   <refsect1> <title> Note de version </title> 
     484    <para> Cette commande fut introduite dans &slony1; 1.0 </para> 
    488485   </refsect1> 
    489486  </refentry> 
    …… 
    495492    
    496493   <refnamediv><refname>STORE NODE</refname> 
    497     <refpurpose> Initialize &slony1; node </refpurpose> 
     494    <refpurpose> Initialis un noeud &slony1;</refpurpose> 
    498495   </refnamediv> 
    499496   <refsynopsisdiv> 
    …… 
    505502    <title>Description</title> 
    506503     
    507     <para> Initialize a new node and add it to the configuration of an 
    508     existing cluster.</para> 
    509  
    510     <para> The initialization process consists of creating the cluster 
    511     namespace in the new node (the database itself must already 
    512     exist), loading all the base tables, functions, procedures and 
    513     initializing the node.  The existing configuration of the rest of 
    514     the cluster is copied from the <quote>event node</quote>. 
     504    <para> Initialise un nouveau noeud et l'ajoute dans la configuation du  
     505      cluster existant.</para> 
     506 
     507    <para> Le processus d'initialisation consiste à la création de l'espace 
     508      de noms sur le nouveau noeud ( la base elle-même doit déjà exister ), 
     509      charger les tables, les fonctions, les procédures et initialiser le  
     510      noeud. La configuration existante du reste du noeud est copiée à  
     511      partir d'un <quote>node d'événement</quote>. 
    515512      
    516513     <variablelist> 
    517514      <varlistentry><term><literal>ID = ival</literal></term> 
    518       <listitem><para> The unique, numeric ID number of the new 
    519       node.</para></listitem> 
     515      <listitem><para> L'identifiant numérique et unique du nouveau noeud.</para></listitem> 
    520516      </varlistentry> 
    521517       
    522518      <varlistentry><term><literal> COMMENT = 'description' </literal></term> 
    523        <listitem><para> A descriptive text added to the node entry in the table &slnode;</para></listitem> 
     519       <listitem><para> Un texte descriptif ajouté à la ligne du noeud dans 
     520           la table &slnode;</para></listitem> 
    524521      </varlistentry> 
    525522       
    526       <varlistentry><term><literal> SPOOLNODE = boolean </literal></term> 
    527         
    528        <listitem><para>Specifies that the new node is a virtual spool 
    529        node for file archiving of replication log.  If true, 
    530        <application>slonik</application> will not attempt to 
    531        initialize a database with the replication 
    532        schema.</para></listitem> 
     523      <varlistentry><term><literal> SPOOLNODE = booléen </literal></term> 
     524        
     525       <listitem><para>Spécifie qu'un noeud est un noeud virtuel de récupération 
     526           pour l'archivage de journaux de réplication. Si ce paramÚtre est à true 
     527           <application>slonik</application> n'essaiera pas d'initialiser la base de  
     528           donnée avec le schéma de réplication.</para></listitem> 
    533529        
    534530      </varlistentry> 
    535531      <varlistentry><term><literal> EVENT NODE = ival </literal></term> 
    536532        
    537        <listitem><para> The ID of the node used to create the configuration 
    538          event that tells all existing nodes about the new node. Default 
    539          value is 1.</para></listitem> 
     533       <listitem><para> L'identifiant du noeud utilisé pour créer l'évenement de configuration, 
     534           qui prévient tous les noeuds existants de l'arrivée du nouveau noeud. 
     535           La valeur par défaut est 1.</para></listitem> 
    540536      </varlistentry> 
    541537     </variablelist> 
    542538    </para> 
    543539 
    544     <para> This uses &funinitializelocalnode; and &funenablenode;. </para> 
     540    <para> Ceci utilise &funinitializelocalnode; et &funenablenode;. </para> 
    545541     
    546542   </refsect1> 
    547543   <refsect1><Title>Example</Title> 
    548544    <programlisting> 
    549      STORE NODE ( ID = 2, COMMENT = 'Node 2'); 
    550     </programlisting> 
    551    </refsect1> 
    552    <refsect1> <title> Locking Behaviour </title> 
    553  
    554     <para> This command creates a new namespace and configures tables 
    555     therein; no public objects should be locked during the duration of 
    556     this.</para> 
    557    </refsect1> 
    558    <refsect1> <title> Version Information </title> <para> This command 
    559    was introduced in &slony1; 1.0.  The <envar>SPOOLNODE</envar> 
    560    parameter was introduced in version 1.1, but was vestigal in that 
    561    version.  The described functionality for <envar>SPOOLNODE</envar> 
    562    arrives in version 1.2. </para> 
     545     STORE NODE ( ID = 2, COMMENT = 'Noeud 2'); 
     546    </programlisting> 
     547   </refsect1> 
     548   <refsect1> <title> Utilisation de verrous </title> 
     549 
     550    <para> Cette commande crée un nouvel espace de nom et configure les tables 
     551      à l'intérieur;aucun objets public ne doit être verrouiller 
     552      pendant l'exécution de cette commade.</para> 
     553   </refsect1> 
     554 
     555   <refsect1> <title> Note de version </title>  
     556     <para> Cette commande fut intorduite dans &slony1; 1.0.  La paramÚtre <envar>SPOOLNODE</envar> 
     557     fut intrduit dans la version 1.1, mais n'était pas implémentée dans cette version. 
     558     La fonctionnalité <envar>SPOOLNODE</envar> est arrivée dans la 
     559   version 1.2. </para> 
    563560   </refsect1> 
    564561  </refentry> 
    …… 
    570567   <refnamediv><refname>DROP NODE</refname> 
    571568     
    572     <refpurpose> Remove the node from participating in the replication </refpurpose></refnamediv> 
     569    <refpurpose> Supprime un noeud de la réplication </refpurpose></refnamediv> 
    573570   <refsynopsisdiv> 
    574571    <cmdsynopsis> 
    …… 
    580577     
    581578    <para> 
    582      Drop a node. This command removes the specified node entirely 
    583      from the replication systems configuration. If the replication 
    584      daemon is still running on that node (and processing events), it 
    585      will attempt to uninstall the replication system and terminate 
    586      itself. 
     579     Supprime un noeud. Cette commande retire complÚtement le noeud spécifié  
     580     de la configuration du systÚme de réplication. 
     581     Si le démon de réplication est toujours en fonctionnement sur ce noeud 
     582     (et qu'ils traitent les événements), il tentera de désinstaller le systÚme 
     583     de réplication et s'arrêtera de lui-même. 
    587584 
    588585     <variablelist> 
    589586      <varlistentry><term><literal> ID  = ival </literal></term> 
    590        <listitem><para> Node ID of the node to remove.</para></listitem> 
     587       <listitem><para> L'indentifiant du noeud à supprimer.</para></listitem> 
    591588      </varlistentry> 
    592589      <varlistentry><term><literal> EVENT NODE = ival </literal></term> 
    593        <listitem><para> Node ID of the node to generate the event; default is 1. 
     590       <listitem><para> L'identifiant du noeud qui génÚre l'événement. La valeur par défaut est 1. 
    594591       </para></listitem> 
    595592      </varlistentry> 
    …… 
    597594    </para> 
    598595 
    599     <para> This uses &fundropnode;. </para> 
    600  
    601     <para> When you invoke <command>DROP NODE</command>, one of the 
    602     steps is to run <command>UNINSTALL NODE</command>.</para> 
    603  
    604    </refsect1> 
    605    <refsect1><title>Example</title> 
     596    <para> Cette commande utilise &fundropnode;. </para> 
     597 
     598    <para> Quand vous invoquez <command>DROP NODE</command>, une des étapes 
     599      consiste à lancer <command>UNINSTALL NODE</command>.</para> 
     600 
     601   </refsect1> 
     602   <refsect1><title>Exemple</title> 
    606603    <programlisting> 
    607604     DROP NODE ( ID = 2 ); 
    608605    </programlisting> 
    609606   </refsect1> 
    610    <refsect1> <title> Locking Behaviour </title> 
    611  
    612     <para> When dropping triggers off of application tables, this will 
    613     require exclusive access to each replicated table on the node 
    614     being discarded.</para> 
    615    </refsect1> 
    616    <refsect1><title>Dangerous/Unintuitive Behaviour</title> 
    617    <para> If you are using connections that cache query plans 
    618    (this is particularly common for Java application frameworks with 
    619    connection pools), the connections may cache query plans that 
    620    include the pre-<command>DROP NODE</command> state of things, and 
    621    you will get &rmissingoids;.</para> 
    622  
    623    <para>After dropping a node, you may also need to recycle 
    624    connections in your application.</para> 
    625  
    626    <para> You cannot submit this to an <command>EVENT 
    627    NODE</command> that is the number of the node being dropped; the 
    628    request must go to some node that will remain in the 
    629    cluster. </para> 
    630    </refsect1> 
    631  
    632    <refsect1> <title> Version Information </title> 
    633     <para> This command was introduced in &slony1; 1.0 </para> 
     607   <refsect1> <title> Utilisation de verrous </title> 
     608 
     609    <para> Lorsqu'on supprime des triggers d'une table de l'application, 
     610      cela nécessite un accÚs exclusif à chaque table répliquée sur le noeud 
     611      que l'on supprime.</para> 
     612   </refsect1> 
     613   <refsect1><title>Comportement dangereux ou non-intuitif</title> 
     614   <para> Si vous utiliser des connexions qui cachent les plans d'éxécution 
     615   (ce qui est particuliÚrement commun pour framework applicatifs Java utilisant 
     616   de pools de connexion pools), les connexions peuvent cacher des plans 
     617   de reques qui se base sur une vision pré-<command>DROP NODE</command>, 
     618   ce qui implique que vous obtiendrez des &rmissingoids;.</para> 
     619 
     620   <para>Ainsi aprÚs avoir supprimé un noeud, il est préférable de réinitialiser 
     621     les connexions de votre applications.</para> 
     622 
     623   <para> Vous ne pouvez pas soumettre cela à un <command>EVENT 
     624   NODE</command> ayant le même numéro que le noeud que vous supprimez; 
     625   la requête doit aller vers un noeud qui restera dans le cluster. 
     626   </para> 
     627   </refsect1> 
     628 
     629   <refsect1> <title> Note de version </title> 
     630    <para> Cette commande fut introduite dans &slony1; 1.0 </para> 
    634631   </refsect1> 
    635632  </refentry> 
    …… 
    641638   <refnamediv><refname>UNINSTALL NODE</refname> 
    642639     
    643     <refpurpose> Decommission &slony1; node </refpurpose></refnamediv> 
     640    <refpurpose> Désinstaller un noeud &slony1; </refpurpose></refnamediv> 
    644641   <refsynopsisdiv> 
    645642    <cmdsynopsis> 
    …… 
    650647    <title>Description</title> 
    651648     
    652     <para> Restores all tables to the unlocked state, with all 
    653      original user triggers, constraints and rules, eventually added 
    654      &slony1; specific serial key columns 
    655      dropped and the &slony1; schema 
    656      dropped. The node becomes a standalone database. The data is left 
    657      untouched. 
    658       
     649    <para> Restaure toutes les tables dans leur état non ver