From 5abb77f1eaa87955afff125cceea266c55a9f63e Mon Sep 17 00:00:00 2001
From: Tatsuo Ishii <ishii@sraoss.co.jp>
Date: Fri, 22 Mar 2019 11:45:42 +0900
Subject: [PATCH] Doc: enhance watchdog/Pgpool-II example so that it mentions
 about pg_monitor role.

Per bug 469.
---
 doc.ja/src/sgml/examples.sgml | 13 +++++++++++++
 doc/src/sgml/examples.sgml    | 14 ++++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/doc.ja/src/sgml/examples.sgml b/doc.ja/src/sgml/examples.sgml
index 28fc95ccb..c8430d8b4 100644
--- a/doc.ja/src/sgml/examples.sgml
+++ b/doc.ja/src/sgml/examples.sgml
@@ -1263,6 +1263,8 @@ Pgpool-IIのヘルスチェック及びレプリケーションの遅延チェ
 また、<productname>PostgreSQL</productname>プライマリサーバ<literal>server1</literal>でレプリケーション専用ユーザ<literal>repl</literal>を作成します。
 <productname>Pgpool-II</productname>4.0からSCRAM認証を利用できるようになりました。この設定例では、<literal>scram-sha-256</literal>認証方式を利用します。
 まず、<literal>password_encryption = 'scram-sha-256'</literal>に変更してから、ユーザを登録します。
+	</para>
+
     <table id="example-cluster-user">
       <title>ユーザ</title>
       <tgroup cols="3">
@@ -1303,6 +1305,17 @@ postgres=# \password repl
 postgres=# \password postgres
           </programlisting>
 
+	  <note>
+	    <para>
+<xref linkend="guc-detach-false-primary">を利用する予定がある場合、"pgpool" ロールは<productname>PostgreSQL</productname>のスーパーユーザーであるか、"pg_monitor" グループに所属する必要があります。
+"pgpool"ユーザをそのグループに所属させるには以下のようにします。
+          <programlisting>
+GRANT pg_monitor TO pgpool;
+	  </programlisting>
+	    </para>
+	  </note>
+
+	  <para>
 <productname>Pgpool-II</productname>サーバと<productname>PostgreSQL</productname>バックエンドサーバが<literal>192.168.137.0/24</literal>のネットワークにあることを想定し、各ユーザが<literal>scram-sha-256</literal>認証方式で接続できるように、<filename>pg_hba.conf</filename>を編集しておきます。
           </para>
           <programlisting>
diff --git a/doc/src/sgml/examples.sgml b/doc/src/sgml/examples.sgml
index 2081c97cb..4f00a56ff 100644
--- a/doc/src/sgml/examples.sgml
+++ b/doc/src/sgml/examples.sgml
@@ -965,6 +965,20 @@ postgres=# \password repl
 postgres=# \password postgres
           </programlisting>
 
+	  <note>
+	    <para>
+	      If you plan to
+	      use <xref linkend="guc-detach-false-primary">, role
+	      "pgpool" needs to
+	      be <productname>PostgreSQL</productname> super user or
+	      or in "pg_monitor" group to use this feature. To let
+	      "pgpool" role be in the group, you can do:
+          <programlisting>
+GRANT pg_monitor TO pgpool;
+	  </programlisting>
+	    </para>
+	  </note>
+
           <para>
 Assuming that all the <productname>Pgpool-II</productname> servers and the 
 <productname>PostgreSQL</productname> servers are in the network of 
-- 
2.39.5