doc: add note to online recovery doc.
authorTatsuo Ishii <ishii@sraoss.co.jp>
Wed, 10 Oct 2018 04:05:39 +0000 (13:05 +0900)
committerTatsuo Ishii <ishii@sraoss.co.jp>
Wed, 10 Oct 2018 04:05:39 +0000 (13:05 +0900)
This warns that client_idle_limit_in_recovery must be smaller than
recovery_timeout.

doc.ja/src/sgml/online-recovery.sgml
doc/src/sgml/online-recovery.sgml

index 4394694f22cd92e6e6a1f8dc4516bc320e728ea9..e33881ad2cdb717a26e7a99c6bdd0ea039c9792c 100644 (file)
@@ -579,6 +579,23 @@ rsync used in the command is killed by signal 2 for example.
 -->
 これは、だらしないクライアントや<productname>Pgpool-II</productname>の間のTCP/IPコネクションの不調(例えばケーブルの切断など)によって、<productname>Pgpool-II</productname>のリカバリが邪魔されるのを防止するのに役立ちます。
         </para>
+
+        <note>
+          <para>
+<!--
+           <varname>client_idle_limit_in_recovery</varname> must be smaller than
+           <xref linkend="guc-recovery-timeout">.
+              Otherwise, <xref linkend="guc-recovery-timeout"> comes
+              first and you will see following error while executing online recovery:
+-->
+<varname>client_idle_limit_in_recovery</varname>は、<xref linkend="guc-recovery-timeout">よりも小さな値でなければなりません。
+さもないと、<xref linkend="guc-recovery-timeout">のタイムアウトが先に起こり、オンラインリカバリを実行中に以下のエラーとなります。
+               <programlisting>
+ERROR:  node recovery failed, waiting connection closed in the other pgpools timeout
+               </programlisting>
+          </para>
+        </note>
+
         <para>
 <!--
           If set to -1, all clients get immediately disconnected when the second
index 1d271c698da50bdf9fed3f56a35f292ab758558c..f1c9d33790a9ad258f3ca11a46dd1bbfb270642e 100644 (file)
@@ -389,12 +389,26 @@ rsync used in the command is killed by signal 2 for example.
           connection between the client and <productname>Pgpool-II</productname>
           is accidentally down (a cut cable for instance).
         </para>
+
+        <note>
+          <para>
+           <varname>client_idle_limit_in_recovery</varname> must be smaller than
+           <xref linkend="guc-recovery-timeout">.
+              Otherwise, <xref linkend="guc-recovery-timeout"> comes
+              first and you will see following error while executing online recovery:
+               <programlisting>
+ERROR:  node recovery failed, waiting connection closed in the other pgpools timeout
+               </programlisting>
+          </para>
+        </note>
+
         <para>
           If set to -1, all clients get immediately disconnected when the second
           stage of online recovery starts.
           The default is 0, which turns off the feature.
         </para>
 
+
         <para>
           This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
                                        You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of