pgpool2.git / summary / log / commit / refs
commit d8d288776a72be49badbbea111edba0223d597c0
Author: Tatsuo Ishii <ishii@sraoss.co.jp>
Date: Mon Aug 21 07:05:40 2023 +0000
Doc: enhance follow primary command manual.
Mention that it is necessary to run pcp_attach_node if
pcp_recovery_node is not used.
doc.ja/src/sgml/failover.sgml | 3 +++
doc/src/sgml/failover.sgml | 16 +++++++++++++---
2 files changed, 16 insertions(+), 3 deletions(-)
diff --git a/doc.ja/src/sgml/failover.sgml b/doc.ja/src/sgml/failover.sgml
index 5a7022ae8..4e25902a8 100644
--- a/doc.ja/src/sgml/failover.sgml
+++ b/doc.ja/src/sgml/failover.sgml
@@ -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>
diff --git a/doc/src/sgml/failover.sgml b/doc/src/sgml/failover.sgml
index 747a088b4..c92588125 100644
--- a/doc/src/sgml/failover.sgml
+++ b/doc/src/sgml/failover.sgml
@@ -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.
[parent: 885716e5f5de]