pgpool2.git / summary / log / commit / refs
commit b439c147d3993a13bca9939d4bc949c4a2e602bb
Author: Tatsuo Ishii <ishii@sraoss.co.jp>
Date: Thu Feb 27 05:00:24 2020 +0000
Doc: explicitly mention that Pgpool-II needs 3 nodes to avoid split brain.
doc.ja/src/sgml/advanced.sgml | 2 +-
doc.ja/src/sgml/intro.sgml | 9 +--------
doc/src/sgml/advanced.sgml | 10 +++++-----
doc/src/sgml/intro.sgml | 1 +
4 files changed, 8 insertions(+), 14 deletions(-)
diff --git a/doc.ja/src/sgml/advanced.sgml b/doc.ja/src/sgml/advanced.sgml
index 27bdc801b..204109bd5 100644
--- a/doc.ja/src/sgml/advanced.sgml
+++ b/doc.ja/src/sgml/advanced.sgml
@@ -28,7 +28,7 @@
Watchdogは、最初に<productname>Pgpool-II</productname> <emphasis>V3.2</emphasis>で導入され、<productname>Pgpool-II</productname> <emphasis>V3.5</emphasis>で常にクォーラムを保つように大きく改善されました。
この機能追加により、watchdogはより対障害性が増し、スプリットブレイン障害とネットワーク分割に対する対処および防止が強固になりました。
また、<emphasis>V3.7</emphasis>ではクォーラムフェイルオーバ (<xref linkend="config-watchdog-failover-behavior">参照)が導入され、<productname>PostgreSQL</productname>サーバの故障誤検知によるフェイルオーバが起こりにくくなりました。
- クォーラム機構を正しく動かすためには、<productname>Pgpool-II</productname>ノードの数は奇数であり、かつ3以上でなければなりません。
+ <emphasis>クォーラム機構を正しく動かすためには、<productname>Pgpool-II</productname>ノードの数は奇数であり、かつ3以上でなければなりません。</emphasis>
</para>
<sect2 id="tutorial-watchdog-coordinating-nodes">
diff --git a/doc.ja/src/sgml/intro.sgml b/doc.ja/src/sgml/intro.sgml
index a69900946..8bbe566a9 100644
--- a/doc.ja/src/sgml/intro.sgml
+++ b/doc.ja/src/sgml/intro.sgml
@@ -259,15 +259,8 @@
<term>Watchdog</term>
<listitem>
<para>
- <!--
- Watchdog can coordinate multiple <productname>Pgpool-II</productname>,
- create a robust cluster system and avoid the single point of failure or split brain.
- Watchdog can perform lifecheck against other <productname>pgpool-II</productname> nodes,
- to detect a fault of <productname>Pgpoll-II</productname>.
- If active <productname>Pgpool-II</productname> goes down, standby
- <productname>Pgpool-II</productname> can be promoted to active, and take over Virtual IP.
- -->
Watchdogは、複数の<productname>Pgpool-II</productname>を協調させて動作させることにより、単一障害点やスプリットブレインの起きない堅牢なクラスタを運用することが可能です。
+ スプリットブレインを防ぐためには、少なくとも3台の<productname>Pgpool-II</productname>ノードが必要です。
他の<productname>Pgpool-II</productname>の死活監視を行い、障害を検出することができます。
稼働系の<productname>Pgpool-II</productname>がダウンしても、待機系の<productname>Pgpool-II</productname>が稼動系に昇格し、仮想IPを引き継ぐことができます。
</para>
diff --git a/doc/src/sgml/advanced.sgml b/doc/src/sgml/advanced.sgml
index 0e6bc0f58..3c947f85d 100644
--- a/doc/src/sgml/advanced.sgml
+++ b/doc/src/sgml/advanced.sgml
@@ -11,10 +11,10 @@
<productname>Pgpool-II</productname> to add high
availability. Watchdog is used to resolve the single point of
failure by coordinating multiple
- <productname>pgpool-II</productname> nodes. The watchdog was first
+ <productname>Pgpool-II</productname> nodes. The watchdog was first
introduced in <productname>pgpool-II</productname>
<emphasis>V3.2</emphasis> and is significantly enhanced in
- <productname>pgpool-II</productname> <emphasis>V3.5</emphasis>, to
+ <productname>Pgpool-II</productname> <emphasis>V3.5</emphasis>, to
ensure the presence of a quorum at all time. This new addition to
watchdog makes it more fault tolerant and robust in handling and
guarding against the split-brain syndrome and network
@@ -22,9 +22,9 @@
quorum failover (see <xref
linkend="config-watchdog-failover-behavior">) to reduce the false
positives of <productname>PostgreSQL</productname> server
- failures. To ensure the quorum mechanism properly works, the number
- of <productname>pgpool-II</productname> nodes must be odd in number
- and greater than or equal to 3.
+ failures. <emphasis>To ensure the quorum mechanism properly works, the number
+ of <productname>Pgpool-II</productname> nodes must be odd in number
+ and greater than or equal to 3.</emphasis>
</para>
<sect2 id="tutorial-watchdog-coordinating-nodes">
diff --git a/doc/src/sgml/intro.sgml b/doc/src/sgml/intro.sgml
index a0fa36289..76df592f6 100644
--- a/doc/src/sgml/intro.sgml
+++ b/doc/src/sgml/intro.sgml
@@ -182,6 +182,7 @@
<para>
Watchdog can coordinate multiple <productname>Pgpool-II</productname>,
create a robust cluster system and avoid the single point of failure or split brain.
+ To avoid the split brain, you need at least 3 <productname>Pgpool-II</productname> nodes.
Watchdog can perform lifecheck against other <productname>pgpool-II</productname> nodes,
to detect a fault of <productname>Pgpoll-II</productname>.
If active <productname>Pgpool-II</productname> goes down, standby
[parent: 52ec89ced539]