pgpool2.git / summary / log / commit / refs
commit 6173bf38934a5c76e487ccafc4ebdabf07e97503
Author: Yugo Nagata <nagata@sraoss.co.jp>
Date: Wed Feb 06 10:39:19 2013 +0000
Modify descriptions of restrictions on watchdog.
doc/pgpool-en.html | 25 +++++++++++++++++++------
doc/pgpool-ja.html | 21 ++++++++++++++++-----
2 files changed, 35 insertions(+), 11 deletions(-)
diff --git a/doc/pgpool-en.html b/doc/pgpool-en.html
index c6424b8cf..c5abe6847 100644
--- a/doc/pgpool-en.html
+++ b/doc/pgpool-en.html
@@ -4062,14 +4062,27 @@ All following options are required to be specified in watchdog process.
</dd>
</dl>
-<h2 id="MEMORY_CACHE_RESTRICTIONS">Restrictions</h2>
+<h2 id="WATCHDOG_RESTRICTIONS">Restrictions on watchdog</h2>
<ul>
<li>
-When all the DB nodes are detached from pgpool-IIs due to PostgreSQL failure and so on,
-watchdog considers all the pgpool-II service are down. Thereafter, after DB node
-is returned to each pgpool-II by using pcp_attach_node command, it comes to be
-<i>split-brain</i> situation; there are multiple active pgpool-II.
-To avoid this problem, you have to restart the pgpool-IIs that are down.
+When all the DB nodes are detached from a pgpool-II due to PostgreSQL server failure or
+pcp_detach_node issued, watchdog regards that the pgpool-II service is in down status and
+brings the virtual IP assigned to watchdog down. Thus clients of pgpool cannot connect to
+pgpool-II using the virtual IP any more. This is neccessary to avoid <i>split-brain</i>,
+that is, situations where there are multiple active pgpool-II.
+</li>
+<li>
+Don't connect to pgpool-II in down status using the real IP. Because a pgpool-II in down status
+can't receive information from watchdog, its backend status may be different from other pgpool-II.
+</li>
+<li>
+pgpool-II in down status can't become active nor standby pgpool-II.
+Recovery from down status requires restart of pgpool-II.
+</li>
+<li>
+Please note that after the active pgpool-II stops, it will take a few seconds until the
+standby pgpool-II promote to new active, to make sure that the former virtual IP is brought
+down before a down notification packet is sent to other pgpool-IIs.
</li>
</ul>
<p class="top_link"><a href="#Top">back to top</a></p>
diff --git a/doc/pgpool-ja.html b/doc/pgpool-ja.html
index 1a84f9a84..08897b782 100644
--- a/doc/pgpool-ja.html
+++ b/doc/pgpool-ja.html
@@ -4177,11 +4177,22 @@ pgpoolが生きていて PostgreSQLと繋がっている場合でも、
<h2 id="WATCHDOG_RESTRICTIONS">watchdog の制限事項</h2>
<ul>
<li>
- 全ての PostgreSQL がダウンしたなどにより pgpool-II から全ての DB ノードが切り離された場合、
- watchdog は全 pgpool-II のサービスがダウンしたとみなします。
- その後、各 pgpool-II で pcp_attach_node コマンドにより DB ノードの復帰をおこなった場合、
- アクティブの pgpool-II が複数できてしまう「スプリットブレイン」状況になってしまいます。
- この問題を回避するために、ダウン状態の pgpool-II を復帰させるには再起動を行う必要があります。
+ PostgreSQL サーバのダウンや pcp_detach_node の実行により pgpool-II から全ての DB ノードが切り離された場合、
+ watchdog は pgpool-II のサービスがダウンした状態とみなし、watchdog に割り当てられていた仮想 IP は停止されます。
+ そのため、クライアントは仮想 IP を使って pgpool-II への接続することは出来なくなります。
+ これは、アクティブの pgpool-II が複数できてしまう「スプリットブレイン」状況を避けるための仕様です。
+ </li>
+ <li>
+ ダウン状態の pgpool-II へ 実 IP を使った接続はしないでください。ダウン状態の pgpool-II は watchdog からの
+ 情報を受け取ることが出来ないため、バックエンドの状態が他のpgpool-II と異なっている場合があります。
+ </li>
+ <li>
+ ダウン状態の pgpool-II はアクティブまたはスタンバイになることはできません。ダウン状態から復帰するためには
+ pgpool-II を再起動する必要があります。
+ </li>
+ <li>
+ アクティブな pgpool-II の停止後、スタンバイ pgpool-II が新しいアクティブに昇格するまでには数秒の時間がかかることに注意してください。
+ これは、アクティブ pgpool-II の停止を他の pgpool-II に通知する前に、仮想 IP が停止されたことの確認を行っているためです。
</li>
</ul>
[parent: 67dccc4cc1e2]