Add neccessary setting for health check retry in the Aurora example.

diff --git a/doc.ja/src/sgml/connection-settings.sgml b/doc.ja/src/sgml/connection-settings.sgml
index 4593c13da4d50566d559d034aa40a2b9f1c26efa..25066adce43f90b55084a93d69cde54d7c48d7a8 100644 (file)
--- a/doc.ja/src/sgml/connection-settings.sgml
+++ b/doc.ja/src/sgml/connection-settings.sgml
@@ -1532,7 +1532,8 @@ backend_weight は新しく追加した行を設定ファイル再読み込み
                  flag is set as the primary node. This is useful for
                  systems including <productname>Amazon Aurora for
                  PostgreSQL Compatibility</productname> which has
-                 fixed master server name.
+                fixed master server name. See <xref linkend="example-Aurora">
+                for an example settings.
                  </entry>
 -->
                  <entry><literal>ALWAYS_MASTER</literal></entry>
@@ -1540,6 +1541,7 @@ backend_weight は新しく追加した行を設定ファイル再読み込み
                  ストリーミングレプリケーションモードについては<xref linkend="running-mode">をご覧ください。
                  このフラグがバックエンドのどれかにセットされていると、<productname>Pgpool-II</productname>はバックエンドにアクセスしてプライマリノードを探すのではなく、このフラグがセットされているノードをプライマリノードと見なします。
                 これは、<productname>Amazon Aurora for PostgreSQL Compatibility</productname>のような、マスターサーバに固定のホスト名が割り当てられるシステムで有用です。
+                 設定例については<xref linkend="example-Aurora">をご覧ください。
                  </entry>
                </row>
 

diff --git a/doc.ja/src/sgml/examples.sgml b/doc.ja/src/sgml/examples.sgml
index e4d1af898673ba7ae27b11044f8df4d9ed125094..a0e7fe0098bf310e739a32392986fa02fd6bf549 100644 (file)
--- a/doc.ja/src/sgml/examples.sgml
+++ b/doc.ja/src/sgml/examples.sgml
@@ -1480,9 +1480,13 @@ PING 35.163.178.3 (35.163.178.3) 56(84) bytes of data.
              <para>
                <!--
                Set <xref linkend="guc-sr-check-period"> to 0 to
-                 disable streaming replication delay checking.
+                 disable streaming replication delay checking.  This
+                 is because <productname>Aurora</productname> does
+                 not provide neccessary functions to check the
+                 replication delay.
                  -->
                <xref linkend="guc-sr-check-period">を0にして、ストリーミングレプリケーション遅延チェックを無効にします。
+                 <productname>Aurora</productname>では、ストリーミングレプリケーションの遅延をチェックするための関数が提供されないためです。
              </para>
            </listitem>
            <listitem>
@@ -1530,7 +1534,34 @@ PING 35.163.178.3 (35.163.178.3) 56(84) bytes of data.
                the <xref linkend="guc-backend-flag"> for the master
                node.
                  -->
-               マスタノードの<xref linkend="guc-backend-flag">の<varname>ALWAYS_MASTER</varname>をオンにします。
+               <xref linkend="guc-backend-hostname">0の<xref linkend="guc-backend-flag">の<varname>ALWAYS_MASTER</varname>をオンにします。
+             </para>
+           </listitem>
+           <listitem>
+             <para>
+               <!--
+               Enable health checking.
+               Set <xref linkend="guc-health-check-period"> to 5.
+               Set <xref linkend="guc-health-check-user">, <xref linkend="guc-health-check-password">,
+               <xref linkend="guc-health-check-user"> and
+                 <xref linkend="guc-health-check-database"> to appropriate values.
+               Enable health check retry.
+               <productname>Aurora</productname> shutdowns all DB nodes while switching
+               over or failover. If the retry is not performed,
+               <productname>Pgpool-II</productname> thinks that all DB nodes are in down status
+               so that it is required to restart <productname>Pgpool-II</productname>.
+               Set <xref linkend="guc-health-check-max-retries"> to 20.
+               Set <xref linkend="guc-health-check-retry-delay"> to 1 to avoid the problem.
+                   -->
+               ヘルスチェックを有効にします。
+               <xref linkend="guc-health-check-period">に5を設定します.
+                 <xref linkend="guc-health-check-user">、<xref linkend="guc-health-check-password">、
+                     <xref linkend="guc-health-check-user">、<xref linkend="guc-health-check-database">
+                 に適切な値を設定します。
+                 リトライを設定します。
+                 <productname>Aurora</productname>は、スィッチングオーバーやフェイルオーバーの際に、一時的に全DBノードを停止します。
+                 リトライを行わないと、<productname>Pgpool-II</productname>から見ると全DBノードがダウン状態になり、<productname>Pgpool-II</productname>の再起動が必要になります。
+                 <xref linkend="guc-health-check-max-retries">を20に、<xref linkend="guc-health-check-retry-delay">を1にして、そのような問題を回避してください。
              </para>
            </listitem>
          </itemizedlist>

diff --git a/doc/src/sgml/connection-settings.sgml b/doc/src/sgml/connection-settings.sgml
index 752775d3427a0e7153d399c67b0b93e6f8f45de2..89e4934754958aa571be91a3c21d621dbf2eee78 100644 (file)
--- a/doc/src/sgml/connection-settings.sgml
+++ b/doc/src/sgml/connection-settings.sgml
@@ -1053,7 +1053,8 @@
                  flag is set as the primary node. This is useful for
                  systems including <productname>Amazon Aurora for
                  PostgreSQL Compatibility</productname> which has
-                 fixed master server name.
+                 fixed master server name. See <xref linkend="example-Aurora">
+                 for an example settings.
                  </entry>
                </row>
 

diff --git a/doc/src/sgml/examples.sgml b/doc/src/sgml/examples.sgml
index 550e195828a1a2ed1dad06da128370308846cd7b..61cd9b72f1c6a7d9adb961c14c327efd48f45685 100644 (file)
--- a/doc/src/sgml/examples.sgml
+++ b/doc/src/sgml/examples.sgml
@@ -1030,7 +1030,10 @@
            <listitem>
              <para>
                Set <xref linkend="guc-sr-check-period"> to 0 to
-                 disable streaming replication delay checking.
+                 disable streaming replication delay checking.  This
+                 is because <productname>Aurora</productname> does
+                 not provide neccessary functions to check the
+                 replication delay.
              </para>
            </listitem>
            <listitem>
@@ -1061,8 +1064,24 @@
            <listitem>
              <para>
                Set <varname>ALWAYS_MASTER</varname> flag to
-               the <xref linkend="guc-backend-flag"> for the master
-               node.
+               the <xref linkend="guc-backend-flag">
+               for <xref linkend="guc-backend-hostname">0.
+             </para>
+           </listitem>
+           <listitem>
+             <para>
+               Enable health checking.
+               Set <xref linkend="guc-health-check-period"> to 5.
+               Set <xref linkend="guc-health-check-user">, <xref linkend="guc-health-check-password">,
+               <xref linkend="guc-health-check-user"> and
+                 <xref linkend="guc-health-check-database"> to appropriate values.
+               Enable health check retry.
+               <productname>Aurora</productname> shutdowns all DB nodes while switching
+               over or failover. If the retry is not performed,
+               <productname>Pgpool-II</productname> thinks that all DB nodes are in down status
+               so that it is required to restart <productname>Pgpool-II</productname>.
+               Set <xref linkend="guc-health-check-max-retries"> to 20.
+               Set <xref linkend="guc-health-check-retry-delay"> to 1 to avoid the problem.
              </para>
            </listitem>
          </itemizedlist>