From 1376cc4adfae13f447e96d538bb5798fa0aa3aab Mon Sep 17 00:00:00 2001 From: Takuma Hoshiai Date: Wed, 19 Sep 2018 09:57:51 +0900 Subject: [PATCH] Doc: Add Japanese release-note for Pgpool-II 4.0, and change some documents about authentication. --- doc.ja/src/sgml/client-auth.sgml | 14 +- doc.ja/src/sgml/connection-settings.sgml | 52 +- doc.ja/src/sgml/filelist.sgml | 1 + doc.ja/src/sgml/healthcheck.sgml | 12 + doc.ja/src/sgml/online-recovery.sgml | 12 + doc.ja/src/sgml/release-4.0.sgml | 904 +++++++++++++++++++++++ doc.ja/src/sgml/release.sgml | 1 + doc.ja/src/sgml/stream-check.sgml | 12 + doc.ja/src/sgml/watchdog.sgml | 11 + 9 files changed, 1012 insertions(+), 7 deletions(-) create mode 100644 doc.ja/src/sgml/release-4.0.sgml diff --git a/doc.ja/src/sgml/client-auth.sgml b/doc.ja/src/sgml/client-auth.sgml index 2ad9f5760..330774bef 100644 --- a/doc.ja/src/sgml/client-auth.sgml +++ b/doc.ja/src/sgml/client-auth.sgml @@ -748,12 +748,24 @@ host postgres all 192.168.12.10/32 md5 Authentication file format --> 認証ファイル形式 - + + +md5認証を使用するには、認証ファイルに平文、md5またはAES暗号化形式のいずれかのユーザのパスワード +が含まれている必要があります。 + pool_passwdファイルは以下の形式の行を含みます。 + + "username:plain_text_passwd" + "username:encrypted_passwd" diff --git a/doc.ja/src/sgml/connection-settings.sgml b/doc.ja/src/sgml/connection-settings.sgml index a3ec5b02c..e66f2250c 100644 --- a/doc.ja/src/sgml/connection-settings.sgml +++ b/doc.ja/src/sgml/connection-settings.sgml @@ -382,16 +382,56 @@ max_pool*num_init_children*2 <= (max_connections - superuser_reserved_connect -md5 認証で用いるパスワードのファイルのファイル名を指定します。 +認証に用いるパスワードファイルのファイル名を指定します。 デフォルト値は"pool_passwd"です。 ''（空文字列）を指定すると パスワードファイルの使用は無効になります。 -詳細はを参照してください。 + + +パスワードは、3つの形式でpool_passwdファイルに保存できます。 +AES256暗号化形式、平文形式、md5形式です。 +Pgpool-IIは接頭辞によってパスワードの形式を確認するため、pool_passwd内の各パスワードのエントリはパスワードの形式を接頭語として付ける必要があります。 + + + +平文形式のパスワードを保存するためには、TEXT接頭辞を使用します。 +例として、pool_passwd内にクリアテキストパスワード文字列"mypassword"を保存する場合、パスワード文字列の先頭にTEXT接頭辞を追加します。 +例えば、TEXTmypasswordとなります。 + + + +同様に、md5ハッシュパスワードはmd5接頭辞、AES256暗号化パスワード形式はAES接頭辞を使って保存することができます。 +AES256暗号化パスワードの詳細は、を参照してください。 + + + + +有効な接頭辞がない場合、Pgpool-IIは平文のパスワードとして文字列を見なします。 + +暗号化されていないクリアテキストパスワードを指定するためには、TEXTをパスワード文字列の前に付けます。 +例えば、パスワードとしてmypassを設定したい場合、パスワードフィールドにTEXTmypassと指定すべきです。 +有効な接頭辞がない場合、Pgpool-IIは平文のパスワードとして文字列を見なします。 + +暗号化されていないクリアテキストパスワードを指定するためには、TEXTをパスワード文字列の前に付けます。 +例えば、パスワードとしてmypassを設定したい場合、パスワードフィールドにTEXTmypassと指定すべきです。 +有効な接頭辞がない場合、Pgpool-IIは平文のパスワードとして文字列を見なします。 + + + リリース 4.0 + + + リリース日 + 2018-xx-xx + + + + + 概要 + + +このバージョンでは、SCRAM認証および証明書認証に対応し、ロードバランスの制御が向上しており、PostgreSQL11の新しいSQLパーサを取り込んでいます。 + + + +Pgpool-II4.0の主な改善点は以下のとおりです。 + + + + + + + + +SCRAM認証および証明書認証の対応 + + + + + +PostgreSQLの偽のプライマリサーバ検出 + + + + + + +ロードバランスの改善: + + + + +更新を伴うクエリ実行後の更に細かい負荷分散の制御 + + + + + +特定クエリに対する負荷分散の制御 + + + + + +パラメータによる負荷分散の重み指定 + + + + + + + + + + + に最終更新時刻のタイムスタンプ追加 + + + + + + +PostgreSQL11のSQLパーサの取込 + + + + + + +クライアントメッセージのログ出力の追加 + + + + + + + + バージョン4.0への移行 + + +バージョン4.0には、以前のバージョンとの互換性に影響する多数の変更点が含まれています。 +以下の非互換性に注意してください。 + + + + + + +1st/2nd ステージのオンラインリカバリコマンドにリカバリされるノードの番号を取得するためのパラメータを追加しました。(Tatsuo Ishii) + + + +オンラインリカバリスクリプトは4つではなく5つのパラメータを受け取るようになりました（5番目のパラメータはリカバリされるノードの番号です）。 +5番目のパラメータの情報を必要としない場合、既存の4つのパラメータの形式でリカバリスクリプト使用することが出来ます。 + + + +詳細は、とを参照してください。 + + + + + + +パラメータfail_over_on_backend_errorは、に変更されました。(Muhammad Usama) + + + +の代わりに古いパラメータ名fail_over_on_backend_errorが使われた場合、警告メッセージを出力します。 + + + + + + +pgpool.conf内でAESで暗号化されたパスワードを指定できます。(Muhammad Usama) + + + +4.0以降では、pgpool.confファイル内のおよび、、でAESで暗号化されたパスワードを指定することができます。 + + + +パスワード文字列の先頭にTEXTを付与した暗号化されていないクリアテキストパスワードを指定します。 +有効な接頭辞が無い場合、Pgpool-IIは文字列を平文のパスワードと見なします。 + + + +pgpool.confファイル内のおよび、、で指定された空のパスワード文字列は、が特定のパスワードを含まない場合だけ使われます。 +もし、これらのパラメータが空白だった場合、Pgpool-IIは空のパスワードを使用する前に最初にファイルから特定のユーザのパスワードの取得を試みます。 + + + + + + + +主要な改善点 + + + + + +SCRAM認証および証明書認証に対応しました。(Muhammad Usama) + + + + +SCRAM認証方式に対応しました。 + + + +pool_passwd認証ファイルを使用したSCRAM認証に対応しました。 + + + +詳細はを参照してください。 + + + + + +Pgpool-IIとフロントエンドの間でCERT認証を使用できます。 + + + +この認証方法を使用する場合、Pgpool-IIはクライアントが有効な証明書を提供することを必要とします。 + + + +詳細はを参照してください。 + + + + + +フロントエンド/バックエンドで異なる認証方式を利用できます。 + + + +これはクライアントとPgpool-II、およびPgpool-IIとバックエンド間で異なる認証方式を利用できます。 + + + + + + + +は、3つの形式でパスワードを保存できるようになりました。 +AES256暗号化形式、平文形式、md5形式です。 + + + +Pgpool-IIは接頭辞によってパスワードの形式を確認するため、pool_passwd内の各パスワードのエントリはパスワードの形式を接頭語として付ける必要があります。 + + + +md5ハッシュパスワードはmd5接頭辞、AES256暗号化パスワード形式はAES接頭辞を使って保存することができます。 +平文形式のパスワードの保存のためには、TEXT接頭辞を使用できます。 + + + +有効な接頭辞がない場合、Pgpool-IIは文字列を平文のパスワードとして見なします。 + + + +例: + +username1:AESIFwI86k+ZbVdf6C+t3qpGA== +username2:md59c6583185ba6a85bdcd1f129ec8cabb4 +username3:TEXTmypassword + + + + + + + + +を用いずにデータベースへの接続にMD5認証およびSCRAM認証方式を使えます。 + + + +新しい設定パラメータを追加しました。 +このパラメータは接続するユーザのパスワードがファイルに含まれていない、かつ（クライアントから提供された）パスワードがバックエンドのMD5もしくはSCRAM認証で使われる場合、Pgpool-IIがクライアントとのクリアテキストのパスワード認証を行うことを許可します。 + + + + + + + +新しいコマンドは、暗号化されたパスワードを生成します。 + + + +AESで暗号化されたパスワードを作成できるコマンドを追加しました。 + + + + + + + +詳細は、を参照してください。 + + + + + + + +新しいパラメータを追加しました。 (Tatsuo Ishii) + + + +detach_false_primary = onの場合、偽のプライマリノードを切り離します。 +デフォルトはoffです。pg_stat_wal_receiverを使用しているため、このパラメータはストリーミングレプリケーションモードかつPostgreSQL9.6以降でのみ有効です。 +PostgreSQL9.5以前のバージョンの場合、エラーは発生せずこの機能は無視されます。 + + + + + + +更新を含むクエリ実行後の負荷分散の振る舞いを指定するを追加しました。(Tatsuo Ishii) + + + +このパラメータは、更新クエリ実行後の振る舞いを指定できます。 + + + + + + +パラメータとして負荷分散の重みの割合を指定できるようになりました。(Bo Peng) + + + +新しい機能としておよびに対して負荷分散の重みを指定できます。 + + + + +特定のデータベース接続およびバックエンドノードに対して、指定した負荷分散の比でSELECTクエリを送るためのリスト"database-name:node id(ratio)"を指定できます。 + + + +特定のアプリケーション接続およびバックエンドノードに対して、指定した負荷分散の比でSELECTクエリを送るためのリスト"application-name:node id(ratio)"を指定できます。 + + + +この負荷分散の比は 0から1の間の値を指定できます。 +デフォルトは1.0です。 + + + + + + + +負荷分散すべきではないSQLパターンのリストを指定できる を追加しました。(Bo Peng) + + + +プライマリノードだけに送るSQLのパターンをセミコロンで区切られたリストで指定できます。 +SQLのパターンには正規表現を使用することができます。 +この機能はマスタースレーブモードのみサポートします。 + + + + + + + +クライアントのメッセージに関するログ出力を許可するを追加しました。(Takuma Hoshiai, Tatsuo Ishii) + + + +log_client_messages = onを設定すると, デバックメッセージなしでクライアントのメッセージをログ出力できます。 + + + + + + + コマンドにlast_status_change列を追加しました。 + + + +新しい列はstatusもしくはroleが変更された時刻を示します。 + + + +列を追加した理由に関しては[pgpool-hackers: 2822]を参照してください。 + + + + + + +PostgreSQL11のSQLパーサを取り込みました。(Bo Peng) + + + +Pgpool-IIはPostgreSQL11で新しく追加されたSQLの構文を完全に理解できます。 +たとえば、CREATE/ALTER/DROP PROCEDUREや{ RANGE | ROWS | GROUPS } frame_start [ frame_exclusion ]などです。 + + + + + + + + 他の改善点 + + + + + +pgpool_setupコマンドにpg_rewindを使用するための"-r"オプションを追加しました。(Tatsuo Ishii) + + + +pgpool_setupのオンラインリカバリスクリプトbasebackup.shでは、最初にpg_rewindを試します。 +pg_rewindが失敗した場合、rsyncを使用します。 + + + +また、pgpool_setupに新しい環境変数"USE_PG_REWIND"を追加しました。 +これは"-r"オプションと同様の効果があります。 + + + + + + + +pgpool_setupコマンドにレプリケーションスロットを使用するための"-s"オプションを追加しました。(Tatsuo Ishii) + + + +これはスタンバイを昇格する際の問題を解消します。 +スタンバイが昇格するときPITRアーカイブ中にタイムラインが変更されるため、他のスタンバイとアーカイブディレクトリを共有している場合他のスタンバイが停止していました。 + + + +また、pgpool_setupに新しい環境変数"USE_REPLICATION_SLOT"を追加しました。 +これは"-s"オプションと同様の効果があります。 + + + +"USE_REPLICATION_SLOT=true"の場合、ストリーミングレプリケーションでアーカイブの代わりにレプリケーションスロットを使用できます。 + + + +USE_REPLICATION_SLOT 環境変数を設定することにより、現在全てのテスト内のpgpool_setupでレプリケーションスロットが使われています。 +これはsrc/test/regression配下のディスクスペースを6.3GBから5.1GB減らします（1.2GBの節約）。 + + + + + + +Pgpool-IIにを導入しました。(Takuma Hoshiai) + + + +新しく追加したコマンドは、PostgreSQLもしくはフロントエンド/バックエンドプロトコルを理解するその他のサーバをテストします。 + + + + + + +内でPgpool-IIの子プロセスIDとPostgreSQLのバックエンドIDを表示できます。(Tatsuo Ishii) + + + +全ての子プロセスと利用可能な接続スロットが表示される--all オプション追加しました。 + + + + + + +にreplication_delayとlast_status_changeを追加しました。(Tatsuo Ishii) + + + + + + +pgpool_admのにrole、replication_delay、last_status_change列を追加しました。(Tatsuo Ishii) + + + + + + + + 変更点 + + + + + +大半のDBUG1のメッセージをDEBUG5に変更しました。(Tatsuo Ishii) + + + +Pgpool-IIを"-d"オプションで起動した場合のpgpoolログのサイズを大きく減らします。 +（これは = debug1と同等です）。 + + + + +[pgpool-hackers: 2794]の議論の結果です。 + + + + + + + + + 不具合修正 + + + + + +HAVE_ASPRINTFが定義されていない場合のコンパイラのエラーを修正しました。(Tatsuo Ishii) + + + + + + + +生成されるsrc/sql/pgpool_adm/Makefile.inを削除するためconfigure.acを修正しました。(Tatsuo Ishii) + + + + + + + +PostgreSQL 9.5を使っている場合、Pgpoolのメインプロセスがセグフォルトするのを修正しました。(Tatsuo Ishii) + + + +pgpool_setup -n 3（またはそれ以上）の場合にバグが発生します。 +ノード2のリカバリをしている間、バックエンド#2が稼働していない場合であってもバージョン情報を取得しようとしていました。 +これは接続がまだ確立されてないためセグフォルトを引き起こします。 +PostgreSQL 9.6以降で発生しない理由は、PostgreSQLのバージョンが9.5以降の場合すぐにループが終了していたためです。 +これを修正するため、VALID_BACKENDマクロを呼ぶ処理を追加しました。 + + + + + + + +pgpool_setupにを追加しました。(Tatsuo Ishii) + + + +ノード毎のhealth_check_timeoutが抜けていました。 +これはノード毎のヘルスチェックのパラメータをサポートした際に追加したはずでした。 + + + + + + + +Test: リグレッションテスト 006.memcacheが失敗する可能性を減らしました。(Tatsuo Ishii) + + + +不定期にテストが失敗するのはレプリケーションラグが原因だと思われます。 +スクリプトはスタンバイからテーブルの読み込みを試しますが、まだテーブルが存在しないためエラーが返ってきます。 +そのため、テーブルの作成後pg_sleep()を挿入します。 + + + + + + + +Test: リグレッションテスト 055.backend_all_downのエラーを修正しました。(Bo Peng) + + + + + + + +Doc: オンラインリカバリのドキュメントを改善しました。(Tatsuo Ishii) + + + +2nd stage コマンドはネイティブレプリケーションモードのみで必要であることを明確にしました。 + + + + + + + +Test: ノード0がプライマリではない場合を想定した新しいリグレッションテスト 017.node_0_is_downを追加しました。(Tatsuo Ishii) + + + + + diff --git a/doc.ja/src/sgml/release.sgml b/doc.ja/src/sgml/release.sgml index d7bdca17c..40a4aa7c4 100644 --- a/doc.ja/src/sgml/release.sgml +++ b/doc.ja/src/sgml/release.sgml @@ -92,6 +92,7 @@ For new features, add links to the documentation sections. subsets can easily be copied into back branches. --> +&release-4.0; &release-3.7; &release-3.6; &release-3.5; diff --git a/doc.ja/src/sgml/stream-check.sgml b/doc.ja/src/sgml/stream-check.sgml index c044ce5a8..f722bec70 100644 --- a/doc.ja/src/sgml/stream-check.sgml +++ b/doc.ja/src/sgml/stream-check.sgml @@ -139,6 +139,18 @@ AESで暗号化されたパスワードを指定するためには、パスワード文字列は暗号化（aes-256-cbcアルゴリズムを使用）およびbase64でエンコードした後、AESを接頭辞として付けなければいけません。 + +暗号化されていないクリアテキストパスワードを指定するためには、TEXTをパスワード文字列の前に付けます。 +例えば、パスワードとしてmypassを設定したい場合、パスワードフィールドにTEXTmypassと指定すべきです。 +有効な接頭辞がない場合、Pgpool-IIは平文のパスワードとして文字列を見なします。 + + +暗号化されていないクリアテキストパスワードを指定するためには、TEXTをパスワード文字列の前に付けます。 +例えば、パスワードとしてmypassを設定したい場合、パスワードフィールドにTEXTmypassと指定すべきです。 +