Doc: add the note about using pcp_promote_node when two postgres
authorMasaya Kawamoto <masaya.0328.k@gmail.com>
Wed, 27 Mar 2024 08:26:58 +0000 (08:26 +0000)
committerMasaya Kawamoto <masaya.0328.k@gmail.com>
Wed, 27 Mar 2024 08:26:58 +0000 (08:26 +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 ff2680bb214ba30965fd632b27861a6dae6e271d..ab3cf798eb12ef0fc850815a2d1aabf5c51d72e4 100644 (file)
@@ -707,6 +707,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 364a3e99cee570e68a235d42b84ef76b8532b98b..c4bdf9ae9ef664b6c2b994c8cba2a8c4827dd485 100644 (file)
@@ -690,6 +690,15 @@ backend_application_name2 = 'server3'
     If we use 3 PostgreSQL servers, we need to specify follow_primary_command to run after failover on the primary node failover.
     In case of two PostgreSQL servers, follow_primary_command setting is not necessary.
    </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.