Doc: add caution to use -D option with pgpool.
authorTatsuo Ishii <ishii@sraoss.co.jp>
Wed, 19 Apr 2023 03:40:48 +0000 (12:40 +0900)
committerTatsuo Ishii <ishii@sraoss.co.jp>
Wed, 19 Apr 2023 03:41:49 +0000 (12:41 +0900)
doc.ja/src/sgml/ref/pgpool.sgml
doc/src/sgml/ref/pgpool.sgml

index 941f70ea6904d12cd6a5e33d3358f525fc576824..b64df228a535ede14bbd5fdb3c33b19fe00ecc72 100644 (file)
@@ -255,6 +255,12 @@ Pgpool-II documentation
        -->
        <filename>pgpool_status</filename>ファイルを破棄し、以前の状態を復元しません。
       </para>
+      <caution>
+       <para>
+       このオプションは開発者向けテスト用の機能であり、それ以外の用途には使用しないでください。
+       <filename>pgpool_status</filename>ファイルを不用意に削除すると、<productname>Pgpool-II</productname>を再起動した時にsplit-brain状(primaryサーバが複数存在する状態)になることがあります。
+       </para>
+      </caution>
      </listitem>
     </varlistentry>
    </variablelist>
index 16653032ccef0b63e9b4619398e1c00c547dcb3b..d65674e20ace87019887d7027dc1ecd0360cecec 100644 (file)
@@ -184,6 +184,15 @@ Pgpool-II documentation
        Discard <filename>pgpool_status</filename> file and do not
        restore previous status.
       </para>
+      <caution>
+       <para>
+       This option is testing purpose only for developers and you
+       should not use it for other purposes.
+       If <filename>pgpool_status</filename> is accidentally
+       removed, <productname>Pgpool-II</productname> may go into
+       split-brain (there are multiple primary servers exist).
+       </para>
+      </caution>
      </listitem>
     </varlistentry>
    </variablelist>