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 ea87a45f5ccd6aabb02efce5114b3b47182be75b..00e0384f018a276c69af4e9ac50da34a386c722f 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 2160e655b2527cd61f827297f0b8761cd0cd8485..ea620e435f91e49bc536c18a0bac010922c6cfbb 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