Doc: enhance online recovery documentation.
authorBo Peng <pengbo@sraoss.co.jp>
Tue, 27 Jun 2023 02:46:17 +0000 (11:46 +0900)
committerBo Peng <pengbo@sraoss.co.jp>
Tue, 27 Jun 2023 02:47:24 +0000 (11:47 +0900)
Mention that 2nd stage of online recovery does not work properly only for multiple pgpool nodes without watchdog enabled.

doc.ja/src/sgml/online-recovery.sgml
doc/src/sgml/online-recovery.sgml

index 728d541bb38220e3d52c2089a65feb92fca15a28..d6af8187c51e94182254546668a624443f81952f 100644 (file)
   <para>
    <!--
    There is a restriction in the online recovery in
-   <xref linkend="guc-replication-mode">. If
-   <productname>Pgpool-II</productname> itself is installed
-   on multiple hosts, online recovery does not work correctly,
+   <xref linkend="guc-replication-mode"> and <xref linkend="guc-snapshot-isolation-mode">.
+   If <productname>Pgpool-II</productname> itself is installed
+   on multiple hosts without enabling watchdog,
+   online recovery does not work correctly,
    because <productname>Pgpool-II</productname> has to stop all
    the clients during the 2nd stage of online recovery.
    If there are several <productname>Pgpool-II</productname> hosts,
    block the connections from clients.
    -->
    <xref linkend="guc-replication-mode">ใ‚ใ‚‹ใ„ใฏ<xref linkend="guc-snapshot-isolation-mode">ใงใฎใ‚ชใƒณใƒฉใ‚คใƒณใƒชใ‚ซใƒใƒชใซใฏๅˆถ้™ไบ‹้ …ใŒใ‚ใ‚Šใพใ™ใ€‚
-    <productname>Pgpool-II</productname>ใŒ่ค‡ๆ•ฐใฎใƒ›ใ‚นใƒˆใซใ‚คใƒณใ‚นใƒˆใƒผใƒซใ•ใ‚Œใฆใ„ใ‚‹ๅ ดๅˆใ€<productname>Pgpool-II</productname>ใฏใ‚ชใƒณใƒฉใ‚คใƒณใƒชใ‚ซใƒใƒชใฎ2ndใ‚นใƒ†ใƒผใ‚ธใฎ้–“ๅ…จใฆใฎใ‚ฏใƒฉใ‚คใ‚ขใƒณใƒˆใ‚’ๆญขใ‚ใ‚‹ๅฟ…่ฆใŒใ‚ใ‚‹ใŸใ‚ใ€ใ‚ชใƒณใƒฉใ‚คใƒณใƒชใ‚ซใƒใƒชใฏๆญฃใ—ใๅ‹•ไฝœใ—ใพใ›ใ‚“ใ€‚
-    ่ค‡ๆ•ฐใฎ<productname>Pgpool-II</productname>ใƒ›ใ‚นใƒˆใŒใ‚ใ‚‹ๅ ดๅˆใ€ใใฎใ†ใกใฎ๏ผ‘ๅฐใฎใฟใŒใ‚ชใƒณใƒฉใ‚คใƒณใƒชใ‚ซใƒใ‚ณใƒžใƒณใƒ‰ใ‚’ๅ—ใ‘ๅ–ใ‚Šใ€ใ‚ฏใƒฉใ‚คใ‚ขใƒณใƒˆใ‹ใ‚‰ใฎๆŽฅ็ถšใ‚’ใƒ–ใƒญใƒƒใ‚ฏใ—ใพใ™ใ€‚
+   Watchdogใ‚’ๆœ‰ๅŠนใซใ›ใšใซ<productname>Pgpool-II</productname>ใ‚’่ค‡ๆ•ฐใฎใƒ›ใ‚นใƒˆใซใ‚คใƒณใ‚นใƒˆใƒผใƒซใ—ใฆใ„ใ‚‹ๅ ดๅˆใ€<productname>Pgpool-II</productname>ใฏใ‚ชใƒณใƒฉใ‚คใƒณใƒชใ‚ซใƒใƒชใฎ2ndใ‚นใƒ†ใƒผใ‚ธใฎ้–“ๅ…จใฆใฎใ‚ฏใƒฉใ‚คใ‚ขใƒณใƒˆใ‚’ๆญขใ‚ใ‚‹ๅฟ…่ฆใŒใ‚ใ‚‹ใŸใ‚ใ€ใ‚ชใƒณใƒฉใ‚คใƒณใƒชใ‚ซใƒใƒชใฏๆญฃใ—ใๅ‹•ไฝœใ—ใพใ›ใ‚“ใ€‚
+   ่ค‡ๆ•ฐใฎ<productname>Pgpool-II</productname>ใƒ›ใ‚นใƒˆใŒใ‚ใ‚‹ๅ ดๅˆใ€ใใฎใ†ใกใฎ๏ผ‘ๅฐใฎใฟใŒใ‚ชใƒณใƒฉใ‚คใƒณใƒชใ‚ซใƒใ‚ณใƒžใƒณใƒ‰ใ‚’ๅ—ใ‘ๅ–ใ‚Šใ€ใ‚ฏใƒฉใ‚คใ‚ขใƒณใƒˆใ‹ใ‚‰ใฎๆŽฅ็ถšใ‚’ใƒ–ใƒญใƒƒใ‚ฏใ—ใพใ™ใ€‚
   </para>
  </note>
  <variablelist>
index 43bd42037b1b38779f6c5254f2737a46a08fb937..82ccdddcb4a1cf486a3c4354909143ec29142eb2 100644 (file)
  <note>
   <para>
    There is a restriction in the online recovery in
-   <xref linkend="guc-replication-mode">. If
-    <productname>Pgpool-II</productname> itself is installed
-    on multiple hosts, online recovery does not work correctly,
-    because <productname>Pgpool-II</productname> has to stop all
-    the clients during the 2nd stage of online recovery.
-    If there are several <productname>Pgpool-II</productname> hosts,
-    only one of them will have received the online recovery command and will
-    block the connections from clients.
+   <xref linkend="guc-replication-mode"> and <xref linkend="guc-snapshot-isolation-mode">.
+   If <productname>Pgpool-II</productname> itself is installed
+   on multiple hosts without enabling watchdog,
+   online recovery does not work correctly,
+   because <productname>Pgpool-II</productname> has to stop all
+   the clients during the 2nd stage of online recovery.
+   If there are several <productname>Pgpool-II</productname> hosts,
+   only one of them will have received the online recovery command and will
+   block the connections from clients.
   </para>
  </note>
  <variablelist>