Doc: add the note about using pcp_promote_node when two postgres
authorMasaya Kawamoto <masaya.0328.k@gmail.com>
Wed, 27 Mar 2024 08:11:41 +0000 (08:11 +0000)
committerMasaya Kawamoto <masaya.0328.k@gmail.com>
Wed, 27 Mar 2024 08:11:41 +0000 (08:11 +0000)
Even if there are two postgres, there are cases that
follow_primary_command is required to be set.

doc.ja/src/sgml/example-cluster.sgml
doc/src/sgml/example-cluster.sgml

index dcc9012c1237bbd902a68228f03bca12049ba62d..fbfd504a0117cd22b64c36a27a8bbd60824b5021 100644 (file)
@@ -727,6 +727,14 @@ backend_application_name2 = 'server3'
     <xref linkend="GUC-FOLLOW-PRIMARY-COMMAND">はプライマリノードのフェイルオーバ後に実行されます。
     <productname>PostgreSQL</productname>サーバが2台の場合、<xref linkend="GUC-FOLLOW-PRIMARY-COMMAND">の設定は不要です。
    </para>
+   <note>
+    <para>
+     <productname>Pgpool-II</productname> 4.3で追加された<xref linkend="PCP-PROMOTE-NODE">の
+     <option>switchover</option>オプションでスイッチオーバを行う時に、
+     古いプライマリを自動でスタンバイにする場合は<productname>PostgreSQL</productname>サーバが2台であっても、
+     <xref linkend="GUC-FOLLOW-PRIMARY-COMMAND">の設定が必要になります。
+    </para>
+   </note>
    <para>
     それぞれの実行スクリプトの引数は、それぞれ実行時に<productname>Pgpool-II</productname>
     によってバックエンドの具体的な情報に置き換えられます。
index c4785af41133461270d7cdf5d21a0fb083c5e6d4..af5caed2741d02a78e0d6ec0334fc4df6223fb48 100644 (file)
@@ -761,6 +761,15 @@ backend_application_name2 = 'server3'
     with the new primary. In case of two PostgreSQL servers, the setting of
     <xref linkend="GUC-FOLLOW-PRIMARY-COMMAND"> is not required.
    </para>
+   <note>
+    <para>
+     When performing a switchover using <xref linkend="PCP-PROMOTE-NODE">
+     with <option>switchover</option> option added in <productname>Pgpool-II</productname> 4.3,
+     if you want to turn the former primary into standby automatically,
+     <xref linkend="GUC-FOLLOW-PRIMARY-COMMAND"> is required to be set
+     even if there are two PostgreSQL servers.
+    </para>
+   </note>
    <para>
     <productname>Pgpool-II</productname> replaces the following special characters with the backend specific
     information while executing the scripts.