Doc: enhance failover document.

Clarify the condition on failover when failover_on_backend_shutdown is
enabled.

diff --git a/doc.ja/src/sgml/failover.sgml b/doc.ja/src/sgml/failover.sgml
index 4e25902a8f2177d3ff4dc646e3e9a355b64b8404..a3bd62274b7442091af2fc740dff422cd7e9e7ec 100644 (file)
--- a/doc.ja/src/sgml/failover.sgml
+++ b/doc.ja/src/sgml/failover.sgml
@@ -29,7 +29,10 @@
 
    <listitem>
     <para>
-     クライアントが<productname>Pgpool-II</productname>に接続済みであり、<productname>PostgreSQL</productname>においてシャットダウン処理が実施された場合（クライアントがまったく<productname>Pgpool-II</productname>に接続していない場合は、<productname>PostgreSQL</productname>がシャットダウンされてもフェイルオーバしないことに注意してください）。
+     <xref linkend="guc-failover-on-backend-shutdown">がonかつ、クライアントが<productname>Pgpool-II</productname>に接続済みであり、<productname>PostgreSQL</productname>においてシャットダウン処理が実施された場合（クライアントがまったく<productname>Pgpool-II</productname>に接続していない場合は、<productname>PostgreSQL</productname>がシャットダウンされてもフェイルオーバしないことに注意してください）。
+    </para>
+    <para>
+     なお、ストリーミングレプリケーションモードでは、シャットダウン処理が行われた<productname>PostgreSQL</productname>がスタンバイノードで、かつロードバランスノードでない場合は、<xref linkend="guc-failover-on-backend-shutdown">がonでもフェイルオーバしません。
     </para>
    </listitem>
   </itemizedlist>
@@ -697,6 +700,12 @@ if (we need to executed follow primary command)
       onに設定した場合、<productname>Pgpool-II</productname>は確立したクライアントとバックエンドのセッション上で特定のエラーコード：<literal>57P01</literal>と<literal>57P02</literal>をチェックすることにより、バックエンドのシャットダウンイベントを検出します。
       それらのエラーコードを検出すると、そのノードでフェイルオーバが起動されます。
       offに設定した場合、そのようなエラーの場合でも<productname>Pgpool-II</productname>は単にエラーをレポートしセッションが切断するのみです。
+     </para>
+     <para>
+      なお、ストリーミングレプリケーションモードでは、シャットダウン処理が行われた<productname>PostgreSQL</productname>がスタンバイノードで、かつロードバランスノードでない場合は、このパラメータがonでもフェイルオーバしません。
+      現在のセッションでどのノードがロードバランスなのかは、<xref linkend="SQL-SHOW-POOL-NODES">または<xref linkend="PCP-PROC-INFO">で確認できます。
+     </para>
+     <para>
       デフォルトはoffです。
      </para>
      <para>

diff --git a/doc/src/sgml/failover.sgml b/doc/src/sgml/failover.sgml
index c925881251290e3e5f4c8542087263214e327f93..6fb4593e9a0796034d83b3b3a5efaf090fb57283 100644 (file)
--- a/doc/src/sgml/failover.sgml
+++ b/doc/src/sgml/failover.sgml
@@ -55,6 +55,13 @@
      down of <productname>PostgreSQL</productname> does not
      trigger a failover).
     </para>
+    <para>
+     In addition, in the streaming replication mode, shutting down
+     of <productname>PostgreSQL</productname> does not trigger a
+     failover, if the node is a standby node and is not the load
+     balance node even
+     if <xref linkend="guc-failover-on-backend-shutdown"> is on.
+    </para>
    </listitem>
   </itemizedlist>
 
@@ -540,6 +547,17 @@ if (we need to executed follow primary command)
       <productname>Pgpool-II</productname> will not detect the event
       even if the parameter is on.
      </para>
+     <para>
+      In addition, in the streaming replication mode, shutting down
+      of <productname>PostgreSQL</productname> does not trigger a
+      failover, if the node is a standby node and is not the load
+      balance node even
+      if <xref linkend="guc-failover-on-backend-shutdown"> is on.  In
+      order to find which node is the load balance node, you can
+      use <xref linkend="SQL-SHOW-POOL-NODES">
+      or <xref linkend="PCP-PROC-INFO">.
+     </para>
+
      <para>
       Please note that <literal>57P01</literal> is not only sent at a
       shutdown event, but also sent when the backend currently