Doc: enhance the explanation on sr_check_user.
authorTatsuo Ishii <ishii@postgresql.org>
Wed, 5 Mar 2025 10:55:11 +0000 (19:55 +0900)
committerTatsuo Ishii <ishii@postgresql.org>
Wed, 5 Mar 2025 10:55:11 +0000 (19:55 +0900)
It must be a superuser or in the pg_monitor group.

Backpatch-through: v4.2.

doc.ja/src/sgml/stream-check.sgml
doc/src/sgml/stream-check.sgml

index ea064e132a6eeec424c19a3179426d4feaf1f4c7..7295faef944fd0d51d45cad9ba12f619b948d30e 100644 (file)
      ストリーミングレプリケーションのチェックを行う<productname>PostgreSQL</>ユーザ名を指定します。
      デフォルトは<literal>''</literal>(空文字)です。
      このユーザはLOGIN権限を持ち、すべてのバックエンドに存在しなければなりません。
+     更にこのユーザは、<productname>PostgreSQL</productname>のスーパーユーザか、"pg_monitor"グループに所属していなければなりません。
+     <note>
+      <para>
+       <xref linkend="guc-sr-check-user">をpg_monitorグループに所属させるには、以下のSQLコマンドを<productname>PostgreSQL</productname>スーパーユーザーで実行してください("sr_check_user"を<xref linkend="guc-sr-check-user">の設定値で置き換えてください)
+       <programlisting>
+GRANT pg_monitor TO sr_check_user;
+       </programlisting>
+       <productname>PostgreSQL</productname> 9.6にはpg_monitorグループがないので、<xref linkend="guc-sr-check-user">は<productname>PostgreSQL</productname>のスーパーユーザーでなければなりません。
+    </para>
+   </note>
     </para>
     <para>
      <!--
index e44dae93fa7d256b657e2a07caa40d0edf784375..8515b6510a8bacd3519673ace886d7d8a02bbd9f 100644 (file)
      Default is <literal>''</literal>(empty).
      The user must have LOGIN privilege and exist on all the
      <productname>PostgreSQL</> backends.
+     Moreover the user must be a <productname>PostgreSQL</productname>
+     super user or in "pg_monitor" group.
+   <note>
+    <para>
+     To make <xref linkend="guc-sr-check-user"> in pg_monitor
+     group, execute following SQL command
+     by <productname>PostgreSQL</productname> super user (replace
+     "sr_check_user" with the setting of <xref linkend="guc-sr-check-user">):
+     <programlisting>
+GRANT pg_monitor TO sr_check_user;
+     </programlisting>
+     For <productname>PostgreSQL</productname> 9.6, there's no
+     pg_monitor group and <xref linkend="guc-sr-check-user"> must
+     be <productname>PostgreSQL</productname> super user.
+    </para>
+   </note>
+
     </para>
     <para>
      If <link linkend="runtime-ssl">SSL</link> is enabled, the