pgpool2.git / summary / log / commit / refs
commit e65044b452b428c5b0bfceb1ba1f91e8abd04814
Author: Bo Peng <pengbo@sraoss.co.jp>
Date: Wed Apr 15 05:37:54 2020 +0000
Doc: fix doc mistakes.
doc.ja/src/sgml/example-cluster.sgml | 14 ++++++++------
doc/src/sgml/example-cluster.sgml | 17 +++++++++++------
2 files changed, 19 insertions(+), 12 deletions(-)
diff --git a/doc.ja/src/sgml/example-cluster.sgml b/doc.ja/src/sgml/example-cluster.sgml
index 178618a13..e92da1e3a 100644
--- a/doc.ja/src/sgml/example-cluster.sgml
+++ b/doc.ja/src/sgml/example-cluster.sgml
@@ -151,7 +151,7 @@
<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
diff --git a/doc/src/sgml/example-cluster.sgml b/doc/src/sgml/example-cluster.sgml
index badfd83d4..f14753d4f 100644
--- a/doc/src/sgml/example-cluster.sgml
+++ b/doc/src/sgml/example-cluster.sgml
@@ -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
[parent: 21958d9f2404]