Doc: unify watchdog leader terms.
authorTatsuo Ishii <ishii@postgresql.org>
Wed, 23 Jul 2025 06:51:56 +0000 (15:51 +0900)
committerTatsuo Ishii <ishii@postgresql.org>
Wed, 23 Jul 2025 06:51:56 +0000 (15:51 +0900)
Previously terms "leader", "active" and "coordinator" were used to
mean the leader watchdog node.  This brought enough confusion. So this
commit unifies them to "leader"."

Backpatch-trhough: v4.2

doc.ja/src/sgml/watchdog.sgml
doc/src/sgml/watchdog.sgml

index b4eff8db640561d25474125053934a9c00b5de0b..1f314020eff71ea7b130a38e31d70c38cace05ca 100644 (file)
       Default is <literal>''</literal>(empty): which means virtual
       IP will never be brought up.
       -->
-      (アプリケーションサーバなど)クライアントサーバから接続される<productname>Pgpool-II</productname>の仮想IP(VIP) アドレスを指定します。
-      <productname>Pgpool-II</productname>ã\81\8cã\82¹ã\82¿ã\83³ã\83\90ã\82¤ã\81\8bã\82\89ã\82¢ã\82¯ã\83\86ã\82£ã\83\96に切り替わった時、<productname>Pgpool-II</productname>はこのVIPを引き継ぎます。
+      (アプリケーションサーバなど)クライアントサーバから接続される<productname>Pgpool-II</productname>の仮想IP(VIP)アドレスを指定します。
+      <productname>Pgpool-II</productname>ã\81\8cã\82¹ã\82¿ã\83³ã\83\90ã\82¤ã\81\8bã\82\89ã\83ªã\83¼ã\83\80ã\83¼に切り替わった時、<productname>Pgpool-II</productname>はこのVIPを引き継ぎます。
       <emphasis>クォーラムが存在しなければVIPは立ち上がりません</emphasis>。
       デフォルトは<literal>''</literal>(空文字)で、この場合仮想IPは決して立ち上がりません。
      </para>
    Configuration about behavior when <productname>Pgpool-II</productname>
    escalates to active (virtual IP holder)
    -->
-   <productname>Pgpool-II</productname>ã\81\8cã\82¢ã\82¯ã\83\86ã\82£ã\83\96(仮想IPを保持しているステータス)に昇格した時の振る舞いを指定します。
+   <productname>Pgpool-II</productname>ã\81\8cã\83ªã\83¼ã\83\80ã\83¼(仮想IPを保持しているステータス)に昇格した時の振る舞いを指定します。
   </para>
 
   <variablelist>
       when pgpool-II escalates to active. This prevents the new active <productname>Pgpool-II</productname>
       from using old query caches inconsistences to the old active.
       -->
-      ã\81\93ã\81®ã\82ªã\83\97ã\82·ã\83§ã\83³ã\81\8conã\81®å ´å\90\88ã\80\81pgpool-II ã\81\8cã\82¢ã\82¯ã\83\86ã\82£ã\83\96に昇格した時に、共有メモリ上のクエリキャッシュを全て削除します。
-      ã\81\93ã\82\8cã\81«ã\82\88ã\82\8aã\80\81æ\96°ã\81\97ã\81\84ã\82¢ã\82¯ã\83\86ã\82£ã\83\96ã\81®<productname>Pgpool-II</productname>ã\81\8cæ\97§ã\82¢ã\82¯ã\83\86ã\82£ã\83\96と非整合な古いクエリキャッシュを使うことを防止します。
+      ã\81\93ã\81®ã\82ªã\83\97ã\82·ã\83§ã\83³ã\81\8conã\81®å ´å\90\88ã\80\81pgpool-II ã\81\8cã\83ªã\83¼ã\83\80ã\83¼に昇格した時に、共有メモリ上のクエリキャッシュを全て削除します。
+      ã\81\93ã\82\8cã\81«ã\82\88ã\82\8aã\80\81æ\96°ã\81\97ã\81\84ã\83ªã\83¼ã\83\80ã\83¼ã\81®<productname>Pgpool-II</productname>ã\81\8cæ\97§ã\83ªã\83¼ã\83\80ã\83¼と非整合な古いクエリキャッシュを使うことを防止します。
      </para>
      <para>
       <!--
      </para>
 
      <para>
-      <productname>Pgpool-II </productname><emphasis>V4.1</emphasis>以å¾\8cã\81§ã\81¯ã\80\81ã\83\97ã\83©ã\82¤ã\83\9eã\83ªã\83\8eã\83¼ã\83\89ã\81®ã\83\95ã\82§ã\82¤ã\83«ã\82ªã\83¼ã\83\90ã\81«é\96¢ã\81\97ã\81¦watchdogã\81®ã\83ªã\83¼ã\83\80ã\83\8eã\83¼ã\83\89ã\81\8cå\90\88æ\84\8få½¢æ\88\90ã\81«å¤±æ\95\97ã\81\97ã\80\81ã\81\9dã\81®çµ\90æ\9e\9cã\83\97ã\83©ã\82¤ã\83\9eã\83ªã\83\90ã\83\83ã\82¯ã\82¨ã\83³ã\83\89ã\81\8cé\9a\94é\9b¢ç\8a¶æ\85\8bã\81«ã\81ªã\81£ã\81\9få ´å\90\88ã\80\81ã\81\9dã\81®ã\83ªã\83¼ã\83\80ã\83\8eã\83¼ã\83\89ã\81¯ã\83ªã\83¼ã\83\80\82³ã\83¼ã\83\87ã\82£ã\83\8dã\83¼ã\82¿ã\81®å½¹å\89²ã\82\92è¾\9eé\80\80ã\81\97ã\80\81次ã\81®ã\83ªã\83¼ã\83\80ã\81®é\81¸æ\8c\99ã\81®é\9a\9bã\81«wd_priorityã\82\92å¼\95ã\81\8dä¸\8bã\81\92ã\82\8bã\81\93ã\81¨ã\81«ã\82\88ã\82\8aã\80\81ã\82¯ã\83©ã\82¹ã\82¿ã\81\8cæ\96°ã\81\97ã\81\84ã\83ªã\83¼ã\83\80を選ぶように仕向けます。
+      <productname>Pgpool-II </productname><emphasis>V4.1</emphasis>以å¾\8cã\81§ã\81¯ã\80\81ã\83\97ã\83©ã\82¤ã\83\9eã\83ªã\83\8eã\83¼ã\83\89ã\81®ã\83\95ã\82§ã\82¤ã\83«ã\82ªã\83¼ã\83\90ã\81«é\96¢ã\81\97ã\81¦watchdogã\81®ã\83ªã\83¼ã\83\80ã\83¼ã\83\8eã\83¼ã\83\89ã\81\8cå\90\88æ\84\8få½¢æ\88\90ã\81«å¤±æ\95\97ã\81\97ã\80\81ã\81\9dã\81®çµ\90æ\9e\9cã\83\97ã\83©ã\82¤ã\83\9eã\83ªã\83\90ã\83\83ã\82¯ã\82¨ã\83³ã\83\89ã\81\8cé\9a\94é\9b¢ç\8a¶æ\85\8bã\81«ã\81ªã\81£ã\81\9få ´å\90\88ã\80\81ã\81\9dã\81®ã\83ªã\83¼ã\83\80ã\83¼ã\83\8eã\83¼ã\83\89ã\81¯ã\83ªã\83¼ã\83\80ã\83¼ã\81®å½¹å\89²ã\82\92è¾\9eé\80\80ã\81\97ã\80\81次ã\81®ã\83ªã\83¼ã\83\80ã\83¼ã\81®é\81¸æ\8c\99ã\81®é\9a\9bã\81«wd_priorityã\82\92å¼\95ã\81\8dä¸\8bã\81\92ã\82\8bã\81\93ã\81¨ã\81«ã\82\88ã\82\8aã\80\81ã\82¯ã\83©ã\82¹ã\82¿ã\81\8cæ\96°ã\81\97ã\81\84ã\83ªã\83¼ã\83\80ã\83¼を選ぶように仕向けます。
       <note>
        <para>
-       スタンバイバックエンドの障害時にリーダノードが合意形成に失敗した場合は、特にアクションは起こしません。
-       watchdogリーダが管理する隔離されたスタンバイバックエンドは新しいリーダの選挙を引き起こしません。
+       ã\82¹ã\82¿ã\83³ã\83\90ã\82¤ã\83\90ã\83\83ã\82¯ã\82¨ã\83³ã\83\89ã\81®é\9a\9c害æ\99\82ã\81«ã\83ªã\83¼ã\83\80ã\83¼ã\83\8eã\83¼ã\83\89ã\81\8cå\90\88æ\84\8få½¢æ\88\90ã\81«å¤±æ\95\97ã\81\97ã\81\9få ´å\90\88ã\81¯ã\80\81ç\89¹ã\81«ã\82¢ã\82¯ã\82·ã\83§ã\83³ã\81¯èµ·ã\81\93ã\81\97ã\81¾ã\81\9bã\82\93ã\80\82
+       watchdogã\83ªã\83¼ã\83\80ã\81\8c管ç\90\86ã\81\99ã\82\8bé\9a\94é\9b¢ã\81\95ã\82\8cã\81\9fã\82¹ã\82¿ã\83³ã\83\90ã\82¤ã\83\90ã\83\83ã\82¯ã\82¨ã\83³ã\83\89ã\81¯æ\96°ã\81\97ã\81\84ã\83ªã\83¼ã\83\80ã\83¼ã\81®é\81¸æ\8c\99ã\82\92å¼\95ã\81\8dèµ·ã\81\93ã\81\97ã\81¾ã\81\9bã\82\93ã\80\82
        </para>
       </note>
      </para>
       このパラメータがオンのときは、split-brainが発生するリスクがあることに注意してください。
       たとえば、ノードA, B, C, Dからなる4ノードのクラスタでは、(A, B)と(C, D)の分断された2つのネットワークになる可能性があります。
       (A, B)と(C, D)にとっては、それぞれ生きた2つのノードが存在するので、クォーラムは依然として存在します。
-      各々のグループはそれぞれのリーダwatchdogを選び、これはすなわちsplit-brainです。
+      各々のグループはそれぞれのリーダwatchdogを選び、これはすなわちsplit-brainです。
      </para>
      <para>
       デフォルト値はオフです。
index 86812ce3271640978e0b3ac695e3514987b7208a..6c807498432a71affca5994b66e052c73f08be44 100644 (file)
@@ -283,7 +283,7 @@ pgpool_port2 = 9999
       <productname>Pgpool-II</productname> that is connected from
       client servers (application servers etc.).  When a
       <productname>Pgpool-II</productname> is switched from standby to
-      active, the <productname>Pgpool-II</productname> takes over this
+      leader, the <productname>Pgpool-II</productname> takes over this
       VIP. <emphasis>VIP will not be brought up in case the quorum
       does not exist</emphasis>. Default is <literal>''</literal>(empty): which
       means virtual IP will never be brought up.
@@ -449,7 +449,7 @@ pgpool_port2 = 9999
 
   <para>
    Configuration about behavior when <productname>Pgpool-II</productname>
-   escalates to active (virtual IP holder)
+   escalates to leader (virtual IP holder)
   </para>
 
   <variablelist>
@@ -463,8 +463,8 @@ pgpool_port2 = 9999
     <listitem>
      <para>
       When set to on, watchdog clears all the query cache in the shared memory
-      when pgpool-II escalates to active. This prevents the new active <productname>Pgpool-II</productname>
-      from using old query caches inconsistent to the old active.
+      when pgpool-II escalates to leader. This prevents the new leader <productname>Pgpool-II</productname>
+      from using old query caches inconsistent to the old leader.
      </para>
      <para>
       Default is on.
@@ -626,7 +626,7 @@ pgpool_port2 = 9999
      <para>
       From <productname>Pgpool-II </productname><emphasis>V4.1</emphasis> onward, if the watchdog-leader node
       fails to build the consensus for primary backend node failover and the primary backend node gets into a
-      quarantine state, then it resigns from its leader/coordinator responsibilities and lowers its wd_priority
+      quarantine state, then it resigns from its leader responsibilities and lowers its wd_priority
       for next leader election and let the cluster elect some different new leader.
       <note>
        <para>