doc: Add restriction about starting multiple pgpool simultaneously

diff --git a/doc/pgpool-en.html b/doc/pgpool-en.html
index b1212993c7e5eed3926844972e01b2c86d24dbf0..53875711df3502594f91e4c62c56987f041b9c06 100644 (file)
--- a/doc/pgpool-en.html
+++ b/doc/pgpool-en.html
@@ -4152,6 +4152,16 @@ Please note that after the active pgpool-II stops, it will take a few seconds un
 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>
+<li>
+Starting multiple pgpool-II simultaneously with too short interval causes
+the following problems. pgpool-II should be started up with enough intrevals.
+  <ul>
+  <li>watchdog fails to start up with log message like
+      "failed to initialize watchdog, delegate_IP "x.x.x.x" already exists".</li>
+  <li>Multiple pgpool-II are promoted to active.</li>
+  <li>watchdog status among the pgpool-II cluster gets inconsistent.</li>
+  </ul>
+</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 d242f8cc91e4f0ee6351f615acbc4408c0acd0a2..b939cf5923205b8a1cca9fc32bef2361db8534e8 100644 (file)
--- a/doc/pgpool-ja.html
+++ b/doc/pgpool-ja.html
@@ -4036,7 +4036,7 @@ watchdog プロセスは pgpool-II から自動的に起動・停止されます
 pgpool-II の起動は <font color="red">root 権限で</font> 行う必要があります。
 </p>
 <p>
-なお、他の pgpool および接続先の PostgreSQL が全て起動するのを待ってから、死活監視を開始します。
+なお、他の pgpool-II および接続先の PostgreSQL が全て起動するのを待ってから、死活監視を開始します。
 </p>
 
 <h2 id="config_watchdog">pgpool.conf の設定</h2>
@@ -4289,6 +4289,14 @@ pgpoolが生きていて PostgreSQLと繋がっている場合でも、
   アクティブな pgpool-II の停止後、スタンバイ pgpool-II が新しいアクティブに昇格するまでには数秒の時間がかかることに注意してください。
   これは、アクティブ pgpool-II の停止を他の pgpool-II に通知する前に、仮想 IP が停止されたことの確認を行っているためです。
   </li>
+  <li>
+  複数の pgpool-II を間隔を開けずに同時に起動すると以下のような現象が発生することがあります。十分な間隔を開けて pgpool-II を起動するようにしてください。
+      <ul>
+      <li>"failed to initialize watchdog, delegate_IP "x.x.x.x" already exists" といったメッセージが出力されて起動に失敗する。</li>
+      <li>アクティブ pgpool-II が複数存在する状態となる。</li>
+      <li>pgpool-II 間で watchdog 状態に一貫性がなくなる。</li>
+      </ul>
+  </li>
 </ul>
 
 <p class="top_link"><a href="#Top">△ back to top</a></p>