Doc: enhance follow primary command manual.
authorTatsuo Ishii <ishii@sraoss.co.jp>
Mon, 21 Aug 2023 07:05:40 +0000 (16:05 +0900)
committerTatsuo Ishii <ishii@sraoss.co.jp>
Mon, 21 Aug 2023 07:05:40 +0000 (16:05 +0900)
Mention that it is necessary to run pcp_attach_node if
pcp_recovery_node is not used.

doc.ja/src/sgml/failover.sgml
doc/src/sgml/failover.sgml

index 5a7022ae8373ff86befd1a3b6f86faf4e4e4ad5c..4e25902a8f2177d3ff4dc646e3e9a355b64b8404 100644 (file)
@@ -659,6 +659,9 @@ if (we need to executed follow primary command)
        たとえば、そのノードはハードウェア障害で停止しているかも知れませんし、管理者が保守のために停止しているのかも知れません。
        ノードが停止している場合は、そのノードをスキップしてください。
        ノードが動いている場合は、まずそのノードを停止してからリカバリしてください。
+       <xref linkend="PCP-RECOVERY-NODE">コマンドを呼ばずに、直接<command>pg_basebackup</command>などを呼び出してリカバリすることも可能ですが、その場合は、リカバリ後に<xref linkend="PCP-ATTACH-NODE">を呼び出して、スタンバイサーバが利用可能になったことを<productname>Pgpool-II</productname>に通知してください。
+       そうでないとそのスタンバイサーバはダウン状態のままになってしまいます。
+       (<xref linkend="PCP-RECOVERY-NODE">コマンドは内部で<xref linkend="PCP-ATTACH-NODE">を呼び出しているので、リカバリ後にスクリプトの中で<xref linkend="PCP-ATTACH-NODE">を呼び出す必要はありません。)
        <varname>follow_primary_command</varname>の完全な例は、<xref linkend="example-cluster">にあります。
      </para>
      <para>
index 747a088b43d27795a9baca941bcb4dbba3583bd2..c925881251290e3e5f4c8542087263214e327f93 100644 (file)
@@ -498,9 +498,19 @@ if (we need to executed follow primary command)
       reason to be stopped: for example, it's broken by hardware
       problems or administrator is maintaining the node.  If the
       node is stopped, skip the node. If the node is running, stop
-      the node first and recovery it.  A
-      complete <varname>follow_primary_command</varname> example
-      can be found in <xref linkend="example-cluster">.
+      the node first and recovery it.
+      Although it is possible to recover by directly
+      executing <command>pg_basebackup</command> or other commands
+      instead of <xref linkend="PCP-RECOVERY-NODE">, you need to
+      execute <xref linkend="PCP-ATTACH-NODE"> to
+      notice <productname>Pgpool-II</productname> that the standby
+      server is ready to use. Otherwise the standby server remains in
+      down status. (Since <xref linkend="PCP-RECOVERY-NODE">
+      internally executes <xref linkend="PCP-ATTACH-NODE">, you don't
+      need to execute <xref linkend="PCP-ATTACH-NODE"> after
+      recovering.
+      A complete <varname>follow_primary_command</varname> example can
+      be found in <xref linkend="example-cluster">.
      </para>
      <para>
       This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.