Skip to content

Commit 2744d6b

Browse files
committed
Mise à jour en version 2.0.3.
Reste encore le fichier faq.xml qui n'est pas entièrement traduit.
1 parent 3f66c06 commit 2744d6b

9 files changed

+453
-193
lines changed

slony/adminscripts.xml

+13
Original file line numberDiff line numberDiff line change
@@ -250,6 +250,18 @@ pour les outils Perl</primary></indexterm>
250250

251251
</sect3>
252252

253+
<sect3 id="slonik-drop-sequence">
254+
<title>slonik_drop_sequence</title>
255+
256+
<para>
257+
Cette commande produit un script Slonik pour supprimer une séquence de la
258+
réplication. Est requis en entrée l'identifiant de la séquence (disponible à
259+
partir de la table <envar>sl_table</envar>) qui est à supprimer et
260+
l'identifiant de l'ensemble auquel elle est attachée.
261+
</para>
262+
263+
</sect3>
264+
253265
<sect3>
254266
<title>slonik_execute_script</title>
255267

@@ -1396,4 +1408,5 @@ abonnements doivent être appliqués.
13961408
</para>
13971409

13981410
</sect2>
1411+
13991412
</sect1>

slony/dropthings.xml

+10-7
Original file line numberDiff line numberDiff line change
@@ -113,20 +113,23 @@
113113
</sect2>
114114

115115
<sect2>
116-
<title> Retirer une table de la réplication</title>
116+
<title>Retirer une table de la réplication</title>
117117
<indexterm><primary>retirer une table de la réplication</primary></indexterm>
118118

119119
<sect3>
120120
<title>En utilisant les outils altperl</title>
121121

122122
<para>
123123
Si les outils <link linkend="altperl">altperl</link> sont installés, vous
124-
pouvez utiliser le script d'aide <link
125-
linkend="slonik-drop-table">slonik_drop_table</link> pour supprimer une table
126-
dans un ensemble de réplication. Lancez simplement
127-
<command>slonik_drop_table</command> sans arguments pour afficher la méthode
128-
d'utilisation du script. Après avoir retiré la table, vous devez également la
129-
retirer du fichier <filename>slon_tools.conf</filename>.
124+
pouvez utiliser les scripts d'aide <link
125+
linkend="slonik-drop-table">slonik_drop_table</link> et <link
126+
linkend="slonik-drop-sequence">slonik_drop_sequence</link> pour supprimer
127+
une table ou une séquence de la réplication. Exécutez simplement
128+
<command>slonik_drop_table</command> (ou
129+
<command>slonik_drop_sequence</command>) sans arguments pour afficher
130+
la syntaxe d'exécution du script. Après avoir supprimé la table, vous devez
131+
aussi la supprimer du fichier de configuration
132+
<filename>slon_tools.conf</filename>.
130133
</para>
131134

132135
</sect3>

slony/faq.xml

+94
Original file line numberDiff line numberDiff line change
@@ -421,6 +421,28 @@ server: Error 0</screen>
421421
</para>
422422
</answer>
423423
</qandaentry>
424+
425+
<qandaentry>
426+
427+
<question> <para> I found conflicting types for <envar>yyleng</envar>
428+
between <filename>parser.c</filename> and <filename>scan.c</filename>.
429+
In one case, it used type <type>int</type>, conflicting with
430+
<type>yy_size_t</type>. What shall I do?</para> </question>
431+
432+
<answer><para> This has been observed on <application>MacOS</application>,
433+
where <application>flex</application> (which generates
434+
<filename>scan.c</filename>) and <application>bison</application>
435+
(which generates <filename>parser.c</filename>) diverged in their
436+
handling of this variable. </para>
437+
<itemizedlist>
438+
<listitem><para> You might might <quote>hack</quote> <filename>scan.c</filename> by hand to use the matching type. </para> </listitem>
439+
<listitem><para> You might select different versions of <application>bison</application> or <application>flex</application> so as to get versions whose data types match. </para> </listitem>
440+
<listitem><para> Note that you may have multiple versions of <application>bison</application> or <application>flex</application> around, and might need to modify <envar>PATH</envar> in order to select the appropriate one.</para></listitem>
441+
</answer>
442+
443+
444+
445+
</qandaentry>
424446
</qandadiv>
425447

426448
<qandadiv id="faqhowto"> <title> &slony1; FAQ: How Do I? </title>
@@ -1933,6 +1955,78 @@ CONTEXT: PL/pgSQL function "setaddtable_int" line 71 at SQL statement</screen>
19331955
</para>
19341956
</answer>
19351957
</qandaentry>
1958+
1959+
<qandaentry>
1960+
1961+
<question> <para>As of version 8.3, &postgres; offers a
1962+
<envar>synchronous_commit</envar> parameter which may be set either
1963+
via GUC or <filename>postgresql.conf</filename> which can provide some
1964+
performance gains by not logging results in WAL. Would it be sensible
1965+
to turn off synchronous commit on a subscriber node? </para>
1966+
</question>
1967+
1968+
<answer><para> Unfortunately, there is an unpleasant failure case
1969+
which this would introduce. </para>
1970+
1971+
<para>Consider...</para>
1972+
1973+
<itemizedlist>
1974+
1975+
<listitem><para> Node #2 claims to have committed up to transaction
1976+
T5, but the WAL only really has records up to T3.</para></listitem>
1977+
1978+
<listitem><para> Node #1, the "master", got the report back that #2 is
1979+
up to date to T5.</para></listitem>
1980+
1981+
<listitem><para> Node #2 experiences a failure (e.g. - power
1982+
outage).</para></listitem>
1983+
1984+
</itemizedlist>
1985+
1986+
<para>There are two possible outcomes, now, one OK, and one not so OK...</para>
1987+
1988+
<itemizedlist>
1989+
1990+
<listitem><para> OK </para>
1991+
1992+
<para> Node #2 gets restarted, replays WAL, knows it's only got data
1993+
up to T3, and heads back to node #1, asking for transaction T4 and
1994+
others.</para>
1995+
1996+
<para> No problem.</para></listitem>
1997+
1998+
<listitem><para> Not so OK.</para>
1999+
2000+
<para> Before node #2 gets back up, node #1 has run an iteration of
2001+
the cleanup thread, which trims out all the data up to T5, because the
2002+
other nodes confirmed up to that point.</para>
2003+
2004+
<para> Node #2 gets restarted, replays WAL, knows it's only got data
2005+
up to T3, and heads back to node #1, asking for transaction T4 and
2006+
T5.</para>
2007+
2008+
<para> Oops. Node #1 just trimmed those log entries
2009+
out.</para></listitem>
2010+
</itemizedlist>
2011+
2012+
<para>The race condition here is quite easy to exercise - you just
2013+
need to suppress the restart of node 2 for a while, long enough for
2014+
node 1 to run the cleanup thread.</para>
2015+
2016+
<para>You might evade the problem somewhat by setting the &lslon; parameter
2017+
<xref linkend="slon-config-cleanup-interval"/> to a larger value.</para>
2018+
2019+
<para>Unfortunately, any time the outage of node 2 could exceed that
2020+
interval, the risk of losing log data inexorably emerges.</para>
2021+
2022+
</answer>
2023+
2024+
<answer><para> As a result, it cannot be recommended that users run
2025+
&slony1; in a fashion where it suppresses WAL writing via
2026+
<envar>synchronous_commit</envar>. </para> </answer>
2027+
2028+
</qandaentry>
2029+
19362030
</qandadiv>
19372031

19382032
<qandadiv id="faqperformance">

slony/intro.xml

+15-6
Original file line numberDiff line numberDiff line change
@@ -231,12 +231,15 @@
231231
jour sur les tables répliquées à l'exception de celles effectuées par le
232232
processus <xref linkend="slon"/>. De plus, tous les
233233
<emphasis>autres</emphasis> triggers et règles sur les tables répliquées sont
234-
<emphasis>supprimés</emphasis> sur les n&oelig;uds abonnés&nbsp;; ceci est
235-
réalisé en faisant pointer ces tables, dans le catalogue système, vers les
236-
index des clefs primaires plutôt que sur la table elle-même. Cela s'apparente
237-
à une <quote>corruption</quote> du dictionnaire de données, et cela explique
238-
pourquoi on ne peut pas utiliser directement <application>pg_dump</application>
239-
pour exporter le schéma sur les n&oelig;uds abonnés.
234+
<emphasis>supprimés</emphasis> sur les n&oelig;uds abonnés. Sur les versions
235+
de &slony1; antérieures à la 2.0, cela se fait en les pointant, dans la table
236+
système, vers l'index de la clé primaire au lieu de la table elle-même, ce
237+
qui représente une <quote>corruption</quote> du dictionnaire des données et
238+
qui explique pourquoi vous ne devez pas utiliser directement
239+
<application>pg_dump</application> pour sauvegarder les schémas sur les
240+
abonnés. En version 2.0, cette fonctionnalité est gérée via une fonctionnalité
241+
native de &postgres;. Du coup, avec &slony1; 2.0+,
242+
<application>pg_dump</application> doit fonctionner correctement.
240243
</para>
241244

242245
<para>
@@ -278,6 +281,12 @@
278281
</itemizedlist>
279282
</para>
280283

284+
<para>
285+
&slony1; ne détermine pas automatiquement les séquences devant être
286+
répliquées&nbsp;; vous devez les ajouter explicitement en utilisant <xref
287+
linkend="stmtsetaddsequence"/>.
288+
</para>
289+
281290
</sect2>
282291

283292
<sect2>

slony/legal.xml

+2-2
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@
55
révision $Revision$ -->
66

77
<copyright>
8-
<year>2004-2007</year>
8+
<year>2004-2009</year>
99
<holder>The PostgreSQL Global Development Group</holder>
1010
</copyright>
1111

1212
<legalnotice id="legalnotice">
1313
<title>Notice légale</title>
1414

1515
<para>
16-
<productname>PostgreSQL</productname> est sous le Copyright &amp;copy; 2004-2007
16+
<productname>PostgreSQL</productname> est sous le Copyright &amp;copy; 2004-2009
1717
du PostgreSQL Global Development Group et est distribué sous les termes
1818
de la licence de l'Université de Californie ci-dessous.
1919
</para>

slony/prerequisites.xml

+7-55
Original file line numberDiff line numberDiff line change
@@ -61,49 +61,9 @@
6161
<para>
6262
Vous avez également besoin d'une version <emphasis>source</emphasis>
6363
récente de &postgres;. &slony1; dépend du support des schémas, ce qui
64-
nécessite au minimum une version 7.3.3 de &postgres; pour pouvoir
65-
compiler et utiliser &slony1;.
64+
nécessite au minimum une version 8.3 de &postgres; pour pouvoir
65+
compiler et utiliser &slony1;.
6666
</para>
67-
68-
<para>
69-
Les versions antérieures de &postgres; <emphasis>ne sont pas</emphasis>
70-
supportées, mais notez qu'un utilisateur a réussi à <quote>forcer</quote>
71-
l'utilisation de &slony1; dans le cadre d'une migration d'une version
72-
7.2 vers une version 7.4&nbsp;; voir les <link linkend="v72upgrade">notes
73-
sur &postgres; 7.2</link>.
74-
</para>
75-
76-
<para>
77-
Les versions de &postgres; antérieures à la 7.4.8 peuvent rencontrer
78-
une requête sans fin conduisant à un problème de <link
79-
linkend="dupkey"><quote>duplicate keys</quote></link> (clés dupliquées),
80-
vous devrez alors envisager une mise à jour pour éviter ce type d'erreur.
81-
</para>
82-
83-
<para>
84-
Si vous utiliser une version de &postgres; antérieure à la version 8.0,
85-
vous devez vous assurer que les fichiers d'en-tête de serveur sont
86-
installés. Si vous installez depuis les sources, cela se fait par la
87-
commande <command>make install-all-headers</command>. Sinon, vous
88-
rencontrerez le problème <link linkend="missingheaders">missing headers
89-
for libpqserver</link> (en-têtes manquants pour libpqserver), comme
90-
décrit dans la FAQ.
91-
</para>
92-
93-
<para>
94-
Si vous utilisez les versions 8.1.0 à 8.1.3, un bogue (corrigé en
95-
8.1.4) empêche la fonction <xref linkend="stmtupdatefunctions"/>
96-
de s'exécuter correctement. Pour plus de détails, voir
97-
<xref linkend="faq" />, <link linkend="pg81funs">&postgres;
98-
8.1.[0-3]</link>.
99-
</para>
100-
101-
<para>
102-
Certaines versions de &postgres; ne sont pas compatibles avec certaines
103-
versions de &slony1;. Voir <xref linkend="installation"/> pour plus de
104-
détails.
105-
</para>
106-
10767
</listitem>
10868

10969
<listitem>
@@ -140,9 +100,9 @@
140100
<para>
141101
Sous &windows;, vous aurez aussi besoin de la boîte à outils <ulink
142102
url="http://www.postgresql.org/docs/faqs.FAQ_MINGW.html">MinGW/
143-
Msys</ulink> pour compiler les versions 8.0 et supérieures de
144-
&postgres;. De plus, vous devez installer <ulink
145-
url="http://sourceware.org/pthreads-win32/">pthreads-win32 2.x</ulink>.
103+
Msys</ulink> pour compiler les versions 8.3 et supérieures de
104+
&postgres;. De plus, vous devez installer <ulink
105+
url="http://sourceware.org/pthreads-win32/">pthreads-win32 2.x</ulink>.
146106
</para>
147107
</listitem>
148108
</itemizedlist>
@@ -156,9 +116,8 @@
156116

157117
<note>
158118
<para>
159-
À partir de la version 1.1 de &slony1;, il est possible de compiler &slony1;
160-
séparemment de &postgres;, rendant libres les distributions
161-
<productname>Linux</productname> et
119+
Il est possible de compiler &slony1; séparemment de &postgres;, rendant
120+
libres les distributions <productname>Linux</productname> et
162121
<productname>FreeBSD</productname> d'inclure des packages binaires
163122
précompilés pour &slony1;. Si de tels packages ne sont pas disponibles,
164123
vous devez vous préparer à compiler &slony1; par vous-même.
@@ -197,13 +156,6 @@
197156
entre ces différents encodages, vous pouvez ne jamais rencontrer de problème.
198157
</para>
199158

200-
<para>
201-
Dans la version 8.1 de &postgres;, des modifications ont été apportées à
202-
l'encodage <envar>UNICODE</envar> car les versions précédentes acceptaient
203-
des encodages invalides. Cela pouvait conduire à des <link
204-
linkend="faqunicode">problèmes de replication</link>.
205-
</para>
206-
207159
<para>
208160
Notez que si l'encodage client (configuré soit dans
209161
<filename>postgresql.conf</filename>, soit par le paramètre

slony/slonik_ref.xml

+34-4
Original file line numberDiff line numberDiff line change
@@ -505,8 +505,11 @@ INIT CLUSTER (
505505
</varlistentry>
506506
<varlistentry><term><literal>EVENT NODE = ival</literal></term>
507507

508-
<listitem><para>L'identifiant du n&oelig;ud utilisé pour créer l'événement de configuration,
509-
qui prévient tous les n&oelig;uds existants de l'arrivée du nouveau n&oelig;ud.
508+
<listitem>
509+
<para>L'identifiant du n&oelig;ud utilisé pour créer l'événement de configuration,
510+
qui prévient tous les n&oelig;uds existants de l'arrivée du nouveau
511+
n&oelig;ud. Ça doit être l'identifiant d'un n&oelig;ud pré-existant dans
512+
le cluster, pas l'identifiant du nouveau n&oelig;ud.
510513
</para></listitem>
511514
</varlistentry>
512515
</variablelist>
@@ -517,7 +520,7 @@ INIT CLUSTER (
517520
</refsect1>
518521
<refsect1><title>Exemple</title>
519522
<programlisting>
520-
STORE NODE ( ID = 2, COMMENT = 'N&oelig;ud 2');
523+
STORE NODE ( ID = 2, COMMENT = 'Node 2', EVENT NODE = 1 );
521524
</programlisting>
522525
</refsect1>
523526
<refsect1> <title>Utilisation de verrous</title>
@@ -2058,6 +2061,27 @@ n&oelig;uds. Tout n&oelig;ud qui a pour but d'être un candidat pour le
20582061
FAILOVER <emphasis>doit</emphasis> avoir <command>FORWARD = yes</command>.</para></listitem>
20592062

20602063
</varlistentry>
2064+
<varlistentry><term><literal> OMIT COPY = boolean </literal></term>
2065+
2066+
<listitem><para>Indique si le processus d'abonnement doit omettre la
2067+
commande <command>COPY</command> pour les données pré-existante dans
2068+
l'ensemble. En effet, utiliser cette option indique clairement
2069+
<quote>Faites-moi confiance, les données sont déjà synchronisées&nbsp;!</quote>
2070+
</para>
2071+
2072+
<para>Ceci est particulièrement utile dans les cas suivants&nbsp;:
2073+
</para>
2074+
2075+
<itemizedlist>
2076+
<listitem><para>Une mise à jour de version majeure (par exemple de &slony1;
2077+
1.2 à 2.0) pourra être beaucoup plus rapide. </para> </listitem>
2078+
<listitem><para>Cloner un <quote>n&oelig;ud maître</quote>.
2079+
<xref linkend="stmtcloneprepare"/>/<xref linkend="stmtclonefinish"/> </para> </listitem>
2080+
<listitem><para> </para> </listitem>
2081+
</itemizedlist>
2082+
</listitem>
2083+
2084+
</varlistentry>
20612085
</variablelist>
20622086
<para>Cette commande utilise &funsubscribeset;.</para>
20632087
</refsect1>
@@ -2143,6 +2167,10 @@ recopiant les données à partir d'un n&oelig;ud existant, il peut <quote>paraî
21432167
l'ancien contenu est détruit et le n&oelig;ud est re-peupler <emphasis>à partir
21442168
de zéro</emphasis>.</para> </listitem>
21452169

2170+
<listitem><para> L'option <command>OMIT COPY</command> est un très gros
2171+
risque car il permet à l'administrateur d'avoir des ensembles de réplication
2172+
non synchronisés. </para>
2173+
</listitem>
21462174
</itemizedlist>
21472175

21482176
</refsect1>
@@ -2161,6 +2189,8 @@ qu'une activité le demande, ce qui laisse une possibilité d'inter-blocage
21612189
</refsect1>
21622190
<refsect1> <title>Note de version</title>
21632191
<para>Cette commande fut introduite dans &slony1; 1.0.</para>
2192+
<para>L'option <command>OMIT COPY</command> a été introduit dans &slony1;
2193+
2.0.3.</para>
21642194
</refsect1>
21652195
</refentry>
21662196

@@ -3025,7 +3055,7 @@ REPAIR CONFIG (
30253055
<refsect1>
30263056
<title>Description</title>
30273057
<para>
3028-
Cette commande prépare le clonage d'un n&oelig;ud donné.
3058+
Cette commande prépare le clonage d'un n&oelig;ud abonné donné.
30293059
</para>
30303060

30313061
<para>

0 commit comments

Comments
 (0)