Doc: fix doc mistakes.
authorBo Peng <pengbo@sraoss.co.jp>
Wed, 15 Apr 2020 05:37:54 +0000 (14:37 +0900)
committerBo Peng <pengbo@sraoss.co.jp>
Wed, 15 Apr 2020 05:37:54 +0000 (14:37 +0900)
doc.ja/src/sgml/example-cluster.sgml
doc/src/sgml/example-cluster.sgml

index 178618a131f2f12261b24b782a8ca00955985364..e92da1e3a3a1ec22526cadc830507d241c9d30b2 100644 (file)
      <row>
       <entry>Pgpool-II起動ユーザ</entry>
       <entry>postgres (Pgpool-II 4.1以降)</entry>
-         <entry>Pgpool-II 4.0 及び 4.0 以前のバージョンでは、デフォルトではrootでPgpool-IIを起動する</entry>
+         <entry>Pgpool-II 4.0 以前のバージョンでは、デフォルトではrootでPgpool-IIを起動する</entry>
      </row>
      <row>
       <entry>Pgpool-II動作モード</entry>
@@ -948,20 +948,22 @@ exit 0
    </note>
    <para>
     <productname>Pgpool-II</productname>のクライアント認証で用いるデフォルトのパスワードファイル名はpool_passwdです。
-    <literal>scram-sha-256</literal>認証を利用する場合、<productname>Pgpool-II</productname>はそれらのパスワードを復号化するために復号鍵が必要となります。全サーバで復号鍵ファイルをrootユーザのホームディレクトリ配下に作成します。
+    <literal>scram-sha-256</literal>認証を利用する場合、<productname>Pgpool-II</productname>はそれらのパスワードを復号化するために復号鍵が必要となります。全サーバで復号鍵ファイルを<productname>Pgpool-II</productname>の起動ユーザ<literal>postgres</literal>(<productname>Pgpool-II</productname> 4.1以降)のホームディレクトリ配下に作成します。(<productname>Pgpool-II</productname> 4.0 以前のバージョンでは、デフォルトでは<literal>root</literal>ユーザで<productname>Pgpool-II</productname>を起動する)
    </para>
    <programlisting>
-    [全サーバ]# echo '任意の文字列' > ~/.pgpoolkey 
-    [全サーバ]# chmod 600 ~/.pgpoolkey
+    [全サーバ]# su - postgres
+    [全サーバ]$ echo '任意の文字列' > ~/.pgpoolkey 
+    [全サーバ]$ chmod 600 ~/.pgpoolkey
    </programlisting>
    <para>
     「pg_enc -m -k /path/to/.pgpoolkey -u ユーザ名 -p」 コマンドを実行すると、ユーザ名と<literal>AES256</literal>で暗号化したパスワードのエントリが<xref linkend="GUC-POOL-PASSWD">に登録されます。 
      <xref linkend="GUC-POOL-PASSWD"> がまだ存在しなければ、<filename>pgpool.conf</filename>と同じディレクトリ内に作成されます。
    </para>
    <programlisting>
-    [全サーバ]# pg_enc -m -k /root/.pgpoolkey -u pgpool -p
+    [全サーバ]# su - postgres
+    [全サーバ]$ pg_enc -m -k ~/.pgpoolkey -u pgpool -p
     db password: [pgpoolユーザのパスワード]
-    [全サーバ]# pg_enc -m -k /root/.pgpoolkey -u postgres -p
+    [全サーバ]$ pg_enc -m -k ~/.pgpoolkey -u postgres -p
     db password: [postgresユーザのパスワード]
 
     # cat /etc/pgpool-II/pool_passwd 
index badfd83d45439e65b2da5d0d4e8221134838ac6b..f14753d4f378289135802454bdcfc49599baddd0 100644 (file)
@@ -992,22 +992,27 @@ exit 0
    <para>
     The default password file name for authentication is <xref linkend="GUC-POOL-PASSWD">.
      To use <literal>scram-sha-256</literal> authentication, the decryption key to decrypt the passwords
-     is required. We create the .pgpoolkey file in root user's home directory.
+     is required. We create the <literal>.pgpoolkey</literal> file in <productname>Pgpool-II</productname>
+     start user <literal>postgres</literal>'s (<productname>Pgpool-II</productname> 4.1 or later) home directory.
+     (<productname>Pgpool-II</productname> 4.0 or before, by default <productname>Pgpool-II</productname>
+     is started as <literal>root</literal>)
      <programlisting>
-      [all servers]# echo 'some string' > ~/.pgpoolkey 
-      [all servers]# chmod 600 ~/.pgpoolkey
+      [all servers]# su - postgres
+      [all servers]$ echo 'some string' > ~/.pgpoolkey
+      [all servers]$ chmod 600 ~/.pgpoolkey
      </programlisting>
    </para>
    <para>
     Execute command <command>pg_enc -m -k /path/to/.pgpoolkey -u username -p</command> to regist user 
-    name and <literal>AES</literal> encrypted password in file <filename>pool_passwd</filename>. 
+    name and <literal>AES</literal> encrypted password in file <filename>pool_passwd</filename>.
     If <filename>pool_passwd</filename> doesn't exist yet, it will be created in the same directory as
     <filename>pgpool.conf</filename>.
    </para>
    <programlisting>
-    [all servers]# pg_enc -m -k /root/.pgpoolkey -u pgpool -p
+    [all servers]# su - postgres
+    [all servers]$ pg_enc -m -k ~/.pgpoolkey -u pgpool -p
     db password: [pgpool user's password]
-    [all servers]# pg_enc -m -k /root/.pgpoolkey -u postgres -p
+    [all servers]$ pg_enc -m -k ~/.pgpoolkey -u postgres -p
     db password: [postgres user's passowrd]
 
     # cat /etc/pgpool-II/pool_passwd