Doc: Add Japanese release-note for Pgpool-II 4.0, and change some documents about...
authorTakuma Hoshiai <hoshiai@sraoss.co.jp>
Wed, 19 Sep 2018 00:57:51 +0000 (09:57 +0900)
committerTakuma Hoshiai <hoshiai@sraoss.co.jp>
Wed, 19 Sep 2018 00:57:51 +0000 (09:57 +0900)
doc.ja/src/sgml/client-auth.sgml
doc.ja/src/sgml/connection-settings.sgml
doc.ja/src/sgml/filelist.sgml
doc.ja/src/sgml/healthcheck.sgml
doc.ja/src/sgml/online-recovery.sgml
doc.ja/src/sgml/release-4.0.sgml [new file with mode: 0644]
doc.ja/src/sgml/release.sgml
doc.ja/src/sgml/stream-check.sgml
doc.ja/src/sgml/watchdog.sgml

index 2ad9f5760acc96f5a3b807f0482623f1f3b6b41f..330774befc1747e41fb0b096847d43bbaaed0c9e 100644 (file)
@@ -748,12 +748,24 @@ host    postgres        all             192.168.12.10/32        md5
     <title>Authentication file format</title>
 -->
     <title>認証ファイル形式</title>
-
+    <para>
+<!--
+           To use the <literal>md5</literal> authentication
+      <xref linkend="guc-pool-passwd"> authentication file
+      must contain the user password in either plain text
+      <literal>md5</literal> or <literal>AES</literal> encrypted format.
+-->
+<literal>md5</literal>認証を使用するには、<xref linkend="guc-pool-passwd">認証ファイルに平文、<literal>md5</literal>または<literal>AES</literal>暗号化形式のいずれかのユーザのパスワード
+が含まれている必要があります。
+    </para>
     <para>
 <!--
         The <xref linkend="guc-pool-passwd"> file should contain lines in the following format:
 -->
 <literal>pool_passwd</literal>ファイルは以下の形式の行を含みます。
+    <programlisting>
+        "username:plain_text_passwd"
+    </programlisting>
     <programlisting>
         "username:encrypted_passwd"
     </programlisting>
index a3ec5b02c6714efb7ad7acf56639144fb0e95c52..e66f2250cf02ce1eef5304e782962510369ee626 100644 (file)
@@ -382,16 +382,56 @@ max_pool*num_init_children*2 &lt;= (max_connections - superuser_reserved_connect
                                <listitem>
                                        <para>
 <!--
-                                               Specify the password file name for md5 authentication.
-                                               Default value is <literal>"pool_passwd"</literal>.
-                                               Specifying <literal>''</literal> (empty) disables the use of password file.
-                                               See <xref linkend="auth-md5"> for more details.
+        Specify the password file name for authentication.
+        Default value is <literal>"pool_passwd"</literal>.
+        Specifying <literal>''</literal> (empty) disables the use
+        of password file.
 -->
-md5 認証で用いるパスワードのファイルのファイル名を指定します。
+認証に用いるパスワードファイルのファイル名を指定します。
 デフォルト値は<literal>"pool_passwd"</literal>です。
 <literal>''</literal>(空文字列)を指定すると パスワードファイルの使用は無効になります。
-詳細は<xref linkend="auth-md5">を参照してください。
                                        </para>
+      <para>
+<!--
+        Passwords can be stored in the pool_passwd file using three formats.
+        AES256 encrypted format, plain text format and md5 format.
+        <productname>Pgpool-II</productname> identifies the password format type
+        by it's prefix, so each password entry in the pool_passwd must be prefixed
+        as per the password format.
+-->
+パスワードは、3つの形式でpool_passwdファイルに保存できます。
+AES256暗号化形式、平文形式、md5形式です。
+<productname>Pgpool-II</productname>は接頭辞によってパスワードの形式を確認するため、pool_passwd内の各パスワードのエントリはパスワードの形式を接頭語として付ける必要があります。
+      </para>
+      <para>
+<!--
+        To store the password in the plain text format use <literal>TEXT</literal> prefix.
+        For example. to store clear text password string <literal>"mypassword"</literal>
+        in the pool_passwd, prepend the password string with <literal>TEXT</literal> prefix.
+        e.g. <literal>TEXTmypassword</literal>
+-->
+平文形式のパスワードを保存するためには、<literal>TEXT</literal>接頭辞を使用します。
+例として、pool_passwd内にクリアテキストパスワード文字列<literal>"mypassword"</literal>を保存する場合、パスワード文字列の先頭に<literal>TEXT</literal>接頭辞を追加します。
+例えば、<literal>TEXTmypassword</literal>となります。
+      </para>
+      <para>
+<!--
+        similarly md5 hashed passwords must be prefixed with <literal>md5</literal> and
+        AES256 encrypted password types can be stored using <literal>AES</literal> prefix.
+        see <xref linkend="auth-aes-encrypted-password"> for more details on using
+        AES256 encrypted passwords.
+-->
+同様に、md5ハッシュパスワードは<literal>md5</literal>接頭辞、AES256暗号化パスワード形式は<literal>AES</literal>接頭辞を使って保存することができます。
+AES256暗号化パスワードの詳細は、<xref linkend="auth-aes-encrypted-password">を参照してください。
+      </para>
+
+      <para>
+<!--
+        In the absence of a valid prefix, <productname>Pgpool-II</productname> will
+        be considered the string as a plain text password
+-->
+有効な接頭辞がない場合、<productname>Pgpool-II</productname>は平文のパスワードとして文字列を見なします。
+      </para>
                                        <para>
 <!--
                                                This parameter can only be set at server start.
index f7e1e74053476a501d13598e40d8ac683b10f8e9..a7efd6a7a80dde53cd8105d06aed53e223da34a9 100644 (file)
 <!ENTITY sourcerepo SYSTEM "sourcerepo.sgml">
 
 <!ENTITY release    SYSTEM "release.sgml">
+<!ENTITY release-4.0    SYSTEM "release-4.0.sgml">
 <!ENTITY release-3.7    SYSTEM "release-3.7.sgml">
 <!ENTITY release-3.6    SYSTEM "release-3.6.sgml">
 <!ENTITY release-3.5    SYSTEM "release-3.5.sgml">
index 0b380b3793335ab5acf43e0b9744d043e00ae2ef..0305b847fc8fec237bc4b46c1a2908cf1e61a43d 100644 (file)
@@ -185,6 +185,18 @@ TCP接続が時間内に成功せずにバックエンドの<productname>Postgre
 <varname>health_check_password</varname>にAES256-CBCで暗号化されたパスワードも指定することができます。
 <literal>AES</literal>で暗号化されたパスワードを指定するためには、パスワード文字列は暗号化(<literal>aes-256-cbc</literal>アルゴリズムを使用)および<literal>base64</literal>でエンコードした後、<literal>AES</literal>を接頭辞として付けなければいけません。
       </para>
+        <para>
+<!--
+            To specify the unencrypted clear text password, prefix the password string with
+            <literal>TEXT</literal>. For example if you want to set <literal>mypass</literal> as
+            a password, you should specify <literal>TEXTmypass</literal> in the password field.
+            In the absence of a valid prefix, <productname>Pgpool-II</productname> will considered
+            the string as a plain text password.
+-->
+暗号化されていないクリアテキストパスワードを指定するためには、<literal>TEXT</literal>をパスワード文字列の前に付けます。
+例えば、パスワードとして<literal>mypass</literal>を設定したい場合、パスワードフィールドに<literal>TEXTmypass</literal>と指定すべきです。
+有効な接頭辞がない場合、<productname>Pgpool-II</productname>は平文のパスワードとして文字列を見なします。
+        </para>
       <para>
 <!--
         You can also use <xref linkend="PG-ENC"> utility to create the correctly formatted
index 31b8c10635a5f951542bd926688b07203028d04a..4394694f22cd92e6e6a1f8dc4516bc320e728ea9 100644 (file)
@@ -245,6 +245,18 @@ postmasterの起動(<literal>pgpool_remote_start</literal>の実施)
 <literal>AES</literal>で暗号化されたパスワードを指定するためには、パスワード文字列は暗号化(<literal>aes-256-cbc</literal>アルゴリズムを使用)および<literal>base64</literal>でエンコードした後、<literal>AES</literal>を接頭辞として付けなければいけません。
         </para>
         <para>
+<!--
+            To specify the unencrypted clear text password, prefix the password string with
+            <literal>TEXT</literal>. For example if you want to set <literal>mypass</literal> as
+            a password, you should specify <literal>TEXTmypass</literal> in the password field.
+            In the absence of a valid prefix, <productname>Pgpool-II</productname> will considered
+            the string as a plain text password.
+-->
+暗号化されていないクリアテキストパスワードを指定するためには、<literal>TEXT</literal>をパスワード文字列の前に付けます。
+例えば、パスワードとして<literal>mypass</literal>を設定したい場合、パスワードフィールドに<literal>TEXTmypass</literal>と指定すべきです。
+有効な接頭辞がない場合、<productname>Pgpool-II</productname>は平文のパスワードとして文字列を見なします。
+        </para>
+        <para>
 <!--
             You can also use <xref linkend="PG-ENC"> utility to create the correctly formatted
             <literal>AES</literal> encrypted password strings.
diff --git a/doc.ja/src/sgml/release-4.0.sgml b/doc.ja/src/sgml/release-4.0.sgml
new file mode 100644 (file)
index 0000000..4f826b7
--- /dev/null
@@ -0,0 +1,904 @@
+<sect1 id="release-4-0">
+<!--
+  <title>Release 4.0</title>
+-->
+  <title>リリース 4.0</title>
+  <note>
+<!--
+    <title>Release Date</title>
+-->
+    <title>リリース日</title>
+    <simpara>2018-xx-xx</simpara>
+  </note>
+
+    <sect2>
+<!--
+    <title>Overview</title>
+-->
+    <title>概要</title>
+    <para>
+<!--
+      This version addes support for SCRAM and CERT authentication,
+      improves load balancing control and import PostgreSQL 11
+      new SQL parser.
+-->
+このバージョンでは、<acronym>SCRAM</acronym>認証および証明書認証に対応し、ロードバランスの制御が向上しており、<productname>PostgreSQL</productname>11の新しい<literal>SQL</literal>パーサを取り込んでいます。
+    </para>
+    <para>
+<!--
+      Major enhancements in <productname>Pgpool-II</productname> 4.0 include:
+-->
+<productname>Pgpool-II</productname>4.0の主な改善点は以下のとおりです。
+    </para>
+
+    <!-- Items in this list summarize one or more items below -->
+
+    <itemizedlist>
+      <listitem>
+        <para>
+<!--
+          Add <acronym>SCRAM</acronym> and Certificate authentication support.
+-->
+<acronym>SCRAM</acronym>認証および証明書認証の対応
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+<!--
+          Detecting "false" primary server of <productname>PostgreSQL</productname>.
+-->
+<productname>PostgreSQL</productname>の偽のプライマリサーバ検出
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+<!--
+          Improvements to load balancing:
+-->
+ロードバランスの改善:
+          <itemizedlist>
+          <listitem>
+              <para>
+<!--
+                More load balancing fine control after write queries.
+-->
+更新を伴うクエリ実行後の更に細かい負荷分散の制御
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+<!--
+               Load balancing control for specific queries.
+-->
+特定クエリに対する負荷分散の制御
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+<!--
+                Allow to specify load balance weight ratio for load balance parameters.
+-->
+パラメータによる負荷分散の重み指定
+
+              </para>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+<!--
+          Add last state change timestamp to <xref linkend="SQL-SHOW-POOL-NODES">.
+-->
+<xref linkend="SQL-SHOW-POOL-NODES"> に最終更新時刻のタイムスタンプ追加
+        </para>
+      </listitem>
+
+<listitem>
+        <para>
+<!--
+          Import PostgreSQL 11 SQL parser.
+-->
+PostgreSQL11のSQLパーサの取込
+        </para>
+      </listitem>
+
+      <listitem>
+        <para>
+<!--
+          Logging client messages.
+-->
+クライアントメッセージのログ出力の追加
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+
+  <sect2>
+<!--
+   <title>Migration to Version 4.0</title>
+-->
+   <title>バージョン4.0への移行</title>
+   <para>
+<!--
+    Version 4.0 contains a number of changes that may affect compatibility with
+    previous releases. Observe the following incompatibilities:
+-->
+バージョン4.0には、以前のバージョンとの互換性に影響する多数の変更点が含まれています。
+以下の非互換性に注意してください。
+   </para>
+   <itemizedlist>
+    <listitem>
+<!--
+2018-04-16 [3d63b8a]
+2018-05-04 [2e41451]
+-->
+     <para>
+<!--
+      Add 1st/2nd stage online recovery commands parameter to get the node number to be recovered. (Tatsuo Ishii)
+-->
+1st/2nd ステージのオンラインリカバリコマンドにリカバリされるノードの番号を取得するためのパラメータを追加しました。(Tatsuo Ishii)
+     </para>
+     <para>
+<!--
+      Online recovery script now accepts 5 parameters, rather than 4 (the 5th
+      parameter is node number to be recovered). Existing
+      4-parameter-style recovery scripts can be used if you don't care
+      about information provided by the 5th parameter.
+-->
+オンラインリカバリスクリプトは4つではなく5つのパラメータを受け取るようになりました(5番目のパラメータはリカバリされるノードの番号です)。
+5番目のパラメータの情報を必要としない場合、既存の4つのパラメータの形式でリカバリスクリプト使用することが出来ます。
+     </para>
+     <para>
+<!--
+      See <xref linkend="guc-recovery-1st-stage-command"> and
+      <xref linkend="guc-recovery-2nd-stage-command"> for more details.
+-->
+詳細は、<xref linkend="guc-recovery-1st-stage-command">と<xref linkend="guc-recovery-2nd-stage-command">を参照してください。
+     </para>
+    </listitem>
+    <listitem>
+<!--
+2018-08-19 [e47f8a3]
+-->
+     <para>
+<!--
+      <varname>fail_over_on_backend_error</varname> parameter is renamed to
+      <xref linkend="guc-failover-on-backend-error">. (Muhammad Usama)
+-->
+パラメータ<varname>fail_over_on_backend_error</varname>は、<xref linkend="guc-failover-on-backend-error">に変更されました。(Muhammad Usama)
+     </para>
+     <para>
+<!--
+      Now we throw a warning message when old config name <varname>fail_over_on_backend_error</varname>
+      is used instead of <xref linkend="guc-failover-on-backend-error">.
+      Using the old config variable name will have no effect.
+-->
+<xref linkend="guc-failover-on-backend-error">の代わりに古いパラメータ名<varname>fail_over_on_backend_error</varname>が使われた場合、警告メッセージを出力します。
+     </para>
+    </listitem>
+    <listitem>
+      <!--
+      2018-08-17 [2644612]
+      -->
+        <para>
+<!--
+         Allow to specify the AES encrypted password in the <filename>pgpool.conf</filename>. (Muhammad Usama)
+-->
+<filename>pgpool.conf</filename>内でAESで暗号化されたパスワードを指定できます。(Muhammad Usama)
+        </para>
+        <para>
+<!--
+         Since 4.0, you can specify the AES encrypted password in the
+         <filename>pgpool.conf</filename> file for <xref linkend="guc-health-check-password">,
+         <xref linkend="guc-sr-check-password">, <xref linkend="guc-wd-lifecheck-password"> and
+         <xref linkend="guc-recovery-password">.
+-->
+4.0以降では、<filename>pgpool.conf</filename>ファイル内の<xref linkend="guc-health-check-password">および<xref linkend="guc-sr-check-password">、<xref linkend="guc-wd-lifecheck-password">、<xref linkend="guc-recovery-password">でAESで暗号化されたパスワードを指定することができます。
+        </para>
+        <para>
+<!--
+         To specify the unencrypted clear text password, prefix the password string with <literal>TEXT</literal>.
+         In the absence of a valid prefix, <productname>Pgpool-II</productname> will considered the string as a plain text password.
+-->
+パスワード文字列の先頭に<literal>TEXT</literal>を付与した暗号化されていないクリアテキストパスワードを指定します。
+有効な接頭辞が無い場合、<productname>Pgpool-II</productname>は文字列を平文のパスワードと見なします。
+        </para>
+        <para>
+<!--
+         The empty password string specified in the
+         <filename>pgpool.conf</filename> file for <xref linkend="guc-health-check-password">,
+         <xref linkend="guc-sr-check-password">, <xref linkend="guc-wd-lifecheck-password"> and
+         <xref linkend="guc-recovery-password"> will only be used when the <xref linkend="GUC-pool-passwd">
+         does not contain the password for that specific user.
+         If these parameters are left blank, <productname>Pgpool-II</productname> will first try to
+         get the password for that specific user from <xref linkend="GUC-pool-passwd"> file before
+         using the empty password.
+-->
+<filename>pgpool.conf</filename>ファイル内の<xref linkend="guc-health-check-password">および<xref linkend="guc-sr-check-password">、<xref linkend="guc-wd-lifecheck-password">、<xref linkend="guc-recovery-password">で指定された空のパスワード文字列は、<xref linkend="GUC-pool-passwd">が特定のパスワードを含まない場合だけ使われます。
+もし、これらのパラメータが空白だった場合、<productname>Pgpool-II</productname>は空のパスワードを使用する前に最初に<xref linkend="GUC-pool-passwd">ファイルから特定のユーザのパスワードの取得を試みます。
+        </para>
+     </listitem>
+   </itemizedlist>
+  </sect2>
+
+  <sect2>
+<!--
+    <title>Major Enhancements</title>
+-->
+<title>主要な改善点</title>
+    <itemizedlist>
+      <listitem>
+<!--
+2018-09-05 [536b155]
+2018-08-19 [ccc9280]
+2018-08-17 [2644612]
+-->
+        <para>
+<!--
+          Add support for <acronym>SCRAM</acronym> and Certificate
+          based authentication methods. (Muhammad Usama)
+-->
+<acronym>SCRAM</acronym>認証および証明書認証に対応しました。(Muhammad Usama)
+          <itemizedlist>
+            <listitem>
+              <para>
+<!--
+               Add support for <acronym>SCRAM</acronym> authentication method.
+-->
+<acronym>SCRAM</acronym>認証方式に対応しました。
+              </para>
+              <para>
+<!--
+               SCRAM authentication is supported using the pool_passwd authentication file.
+-->
+pool_passwd認証ファイルを使用したSCRAM認証に対応しました。
+              </para>
+              <para>
+<!--
+               See <xref linkend="AUTH-SCRAM"> for more details.
+-->
+詳細は<xref linkend="AUTH-SCRAM">を参照してください。
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+<!--
+               Allow to use <acronym>CERT</acronym> authentication between <productname>Pgpool-II</productname> and frontend.
+-->
+<productname>Pgpool-II</productname>とフロントエンドの間で<acronym>CERT</acronym>認証を使用できます。
+              </para>
+              <para>
+<!--
+               To use this authentication method, Pgpool-II will require that the client provide a valid certificate.
+-->
+この認証方法を使用する場合、Pgpool-IIはクライアントが有効な証明書を提供することを必要とします。
+              </para>
+              <para>
+<!--
+               See <xref linkend="AUTH-CERT"> for more details.
+-->
+詳細は<xref linkend="AUTH-CERT">を参照してください。
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+<!--
+              Able to use different auth methods for frontend and backend.
+-->
+フロントエンド/バックエンドで異なる認証方式を利用できます。
+              </para>
+              <para>
+<!--
+                Now it is possible to use different authentication methods between
+                client to <productname>Pgpool-II</productname> and <productname>Pgpool-II</productname> to backend.
+-->
+これはクライアントと<productname>Pgpool-II</productname>、および<productname>Pgpool-II</productname>とバックエンド間で異なる認証方式を利用できます。
+              </para>
+            </listitem>
+          </itemizedlist>
+          <itemizedlist>
+            <listitem>
+              <para>
+<!--
+               Now <xref linkend="GUC-POOL-PASSWD"> can store three format passwords. AES256 encrypted format, plain text format and md5 format.
+-->
+<xref linkend="GUC-POOL-PASSWD">は、3つの形式でパスワードを保存できるようになりました。
+AES256暗号化形式、平文形式、md5形式です。
+               </para>
+               <para>
+<!--
+                <productname>Pgpool-II</productname> identifies the password format type by it's prefix,
+                so each password entry in the pool_passwd must be prefixed as per the password format.
+-->
+<productname>Pgpool-II</productname>は接頭辞によってパスワードの形式を確認するため、pool_passwd内の各パスワードのエントリはパスワードの形式を接頭語として付ける必要があります。
+               </para>
+               <para>
+<!--
+                md5 hashed passwords will be prefixed with <literal>md5</literal> and AES256 encrypted password types
+                will be stored using <literal>AES</literal> prefix.
+                To store the password in the plain text format <literal>TEXT</literal> prefix can be used.
+-->
+md5ハッシュパスワードは<literal>md5</literal>接頭辞、AES256暗号化パスワード形式は<literal>AES</literal>接頭辞を使って保存することができます。
+平文形式のパスワードの保存のためには、<literal>TEXT</literal>接頭辞を使用できます。
+               </para>
+               <para>
+<!--
+                In the absence of a valid prefix, Pgpool-II will be considered the string as a plain text password.i
+-->
+有効な接頭辞がない場合、Pgpool-IIは文字列を平文のパスワードとして見なします。
+               </para>
+               <para>
+<!--
+                For example:
+-->
+例:
+<programlisting>
+username1:AESIFwI86k+ZbVdf6C+t3qpGA==
+username2:md59c6583185ba6a85bdcd1f129ec8cabb4
+username3:TEXTmypassword
+</programlisting>
+               </para>
+            </listitem>
+          </itemizedlist>
+          <itemizedlist>
+            <listitem>
+              <para>
+<!--
+                Able to use <acronym>MD5</acronym> and <acronym>SCRAM</acronym> authentication methods
+                to connect to database without <xref linkend="GUC-pool-passwd">.
+-->
+<xref linkend="GUC-pool-passwd">を用いずにデータベースへの接続に<acronym>MD5</acronym>認証および<acronym>SCRAM</acronym>認証方式を使えます。
+              </para>
+              <para>
+<!--
+                A new configuration parameter <xref linkend="guc-allow-clear-text-frontend-auth"> is added.
+                This parameter enables this config allows the <productname>Pgpool-II</productname>
+                to use clear-text-password authentication with frontend clients when
+                <xref linkend="GUC-pool-passwd"> file does not contains the password for the connecting user,
+                and use that password (provided by client) to authenticate with the backend
+                using <acronym>MD5</acronym> and/or <acronym>SCRAM</acronym> authentication.
+-->
+新しい設定パラメータ<xref linkend="guc-allow-clear-text-frontend-auth">を追加しました。
+このパラメータは接続するユーザのパスワードが<xref linkend="GUC-pool-passwd">ファイルに含まれていない、かつ(クライアントから提供された)パスワードがバックエンドの<acronym>MD5</acronym>もしくは<acronym>SCRAM</acronym>認証で使われる場合、<productname>Pgpool-II</productname>がクライアントとのクリアテキストのパスワード認証を行うことを許可します。
+              </para>
+            </listitem>
+          </itemizedlist>
+          <itemizedlist>
+            <listitem>
+              <para>
+<!--
+                New <xref linkend="PG-ENC"> utility to create encrypted passwords.
+-->
+新しい<xref linkend="PG-ENC">コマンドは、暗号化されたパスワードを生成します。
+              </para>
+              <para>
+<!--
+                A new utility <xref linkend="PG-ENC"> is added to create AES encrypted passwords.
+-->
+AESで暗号化されたパスワードを作成できる<xref linkend="PG-ENC">コマンドを追加しました。
+
+              </para>
+            </listitem>
+          </itemizedlist>
+        </para>
+        <para>
+<!--
+          See <xref linkend="client-authentication"> for more details.
+-->
+詳細は、<xref linkend="client-authentication">を参照してください。
+        </para>
+      </listitem>
+
+      <listitem>
+        <!--
+        2018-04-09 [f0631a6]
+        2018-04-17 [bbc270f]
+        -->
+        <para>
+<!--
+          Add new parameter <xref linkend="guc-detach-false-primary">. (Tatsuo Ishii)
+-->
+新しいパラメータ<xref linkend="guc-detach-false-primary">を追加しました。 (Tatsuo Ishii)
+        </para>
+        <para>
+<!--
+          If set <literal>detach_false_primary = on</literal>, detach false primary node.
+          The default is off. This parameter is only valid in streaming replication mode
+          and for <productname>PostgreSQL</productname> 9.6 or after since this feature
+          uses <structname>pg_stat_wal_receiver</structname>.
+          If <productname>PostgreSQL</productname> 9.5.x or older version is used, no
+          error is raised, just the feature is ignored.
+-->
+<literal>detach_false_primary = on</literal>の場合、偽のプライマリノードを切り離します。
+デフォルトはoffです。<structname>pg_stat_wal_receiver</structname>を使用しているため、このパラメータはストリーミングレプリケーションモードかつ<productname>PostgreSQL</productname>9.6以降でのみ有効です。
+<productname>PostgreSQL</productname>9.5以前のバージョンの場合、エラーは発生せずこの機能は無視されます。
+        </para>
+      </listitem>
+      <listitem>
+        <!--
+        2018-04-23 [33e52ba]
+        2018-04-19 [ba19a38]
+        -->
+        <para>
+<!--
+          Add <xref linkend="guc-disable-load-balance-on-write"> parameter to specify
+          load balance behavior after write queries appear. (Tatsuo Ishii)
+-->
+更新を含むクエリ実行後の負荷分散の振る舞いを指定する<xref linkend="guc-disable-load-balance-on-write">を追加しました。(Tatsuo Ishii)
+        </para>
+        <para>
+<!--
+          This parameter allows to specify the behavior when a write query issued.
+-->
+このパラメータは、更新クエリ実行後の振る舞いを指定できます。
+        </para>
+      </listitem>
+      <listitem>
+        <!--
+        2018-08-07 [5108031]
+        -->
+        <para>
+<!--
+          Allow to specify load balance weight ratio for load balance parameters. (Bo Peng)
+-->
+パラメータとして負荷分散の重みの割合を指定できるようになりました。(Bo Peng)
+        </para>
+        <para>
+<!--
+          Add a new feature to allow to specify load balance weight ratio for
+          <xref linkend="guc-database-redirect-preference-list"> and
+          <xref linkend="guc-app-name-redirect-preference-list"> parameters.
+-->
+新しい機能として<xref linkend="guc-database-redirect-preference-list">および<xref linkend="guc-app-name-redirect-preference-list">に対して負荷分散の重みを指定できます。
+
+        </para>
+        <para>
+<!--
+          You can specify the list of "database-name:node id(ratio)" pairs to
+          send SELECT queries to a particular backend node for a particular
+          database connection at a specified load balance ratio.
+-->
+特定のデータベース接続およびバックエンドノードに対して、指定した負荷分散の比でSELECTクエリを送るためのリスト"database-name:node id(ratio)"を指定できます。
+        </para>
+        <para>
+<!--
+          Also you can specify list of "application-name:node id(ratio)" pairs to
+          send SELECT queries to a particular backend node for a particular client
+          application connection at a specified load balance ratio.
+-->
+特定のアプリケーション接続およびバックエンドノードに対して、指定した負荷分散の比でSELECTクエリを送るためのリスト"application-name:node id(ratio)"を指定できます。
+        </para>
+        <para>
+<!--
+          This load balance ratio specifies a value between 0 and 1,
+          and the default is 1.0.
+-->
+この負荷分散の比は 0から1の間の値を指定できます。
+デフォルトは1.0です。
+        </para>
+      </listitem>
+
+      <listitem>
+        <!--
+        2018-06-14 [83906d1]
+        -->
+        <para>
+<!--
+          Add new parameter <xref linkend="guc-black-query-pattern-list"> to enable
+          specifying SQL patterns lists that should not be load-balanced. (Bo Peng)
+-->
+負荷分散すべきではないSQLパターンのリストを指定できる<xref linkend="guc-black-query-pattern-list"> を追加しました。(Bo Peng)
+        </para>
+        <para>
+<!--
+          Specify a semicolon separated list of SQL patterns that
+          should be sent to primary node only. Regular expression can be
+          used in SQL patterns. Only Maste Slave mode is supported.
+-->
+プライマリノードだけに送るSQLのパターンをセミコロンで区切られたリストで指定できます。
+SQLのパターンには正規表現を使用することができます。
+この機能はマスタースレーブモードのみサポートします。
+        </para>
+      </listitem>
+
+      <listitem>
+        <!--
+        2018-07-27 [54503f4]
+        2018-08-02 [dac5573]
+        2018-08-01 [8745853]
+        -->
+        <para>
+<!--
+          Add new parameter <xref linkend="guc-log-client-messages"> to allow logging client message. (Takuma Hoshiai, Tatsuo Ishii)
+-->
+クライアントのメッセージに関するログ出力を許可する<xref linkend="guc-log-client-messages">を追加しました。(Takuma Hoshiai, Tatsuo Ishii)
+        </para>
+        <para>
+<!--
+          Set <varname>log_client_messages = on</varname>, any client messages will be logged without debugging messages.
+-->
+<varname>log_client_messages = on</varname>を設定すると, デバックメッセージなしでクライアントのメッセージをログ出力できます。
+        </para>
+      </listitem>
+      <listitem>
+        <!--
+        2018-06-12 [0312dc5]
+        -->
+        <para>
+<!--
+          Add <literal>last_status_change</literal> column to <xref linkend="SQL-SHOW-POOL-NODES"> command. (Tatsuo Ishii)
+-->
+          <xref linkend="SQL-SHOW-POOL-NODES">コマンドに<literal>last_status_change</literal>列を追加しました。
+        </para>
+        <para>
+<!--
+          The new column indicates the time when <literal>status</literal> or <literal>role</literal> has been changed.
+-->
+新しい列は<literal>status</literal>もしくは<literal>role</literal>が変更された時刻を示します。
+        </para>
+        <para>
+<!--
+          See <ulink url="http://www.sraoss.jp/pipermail/pgpool-hackers/2018-June/002822.html">
+          [pgpool-hackers: 2822]</ulink> for the reasoning to add the column.
+-->
+列を追加した理由に関しては<ulink url="http://www.sraoss.jp/pipermail/pgpool-hackers/2018-June/002822.html">[pgpool-hackers: 2822]</ulink>を参照してください。
+        </para>
+      </listitem>
+      <listitem>
+        <!--
+        2018-08-28 [8b43ac3]
+        -->
+        <para>
+<!--
+         Import <productname>PostgreSQL</productname> 11's SQL  parser. (Bo Peng)
+-->
+<productname>PostgreSQL</productname>11のSQLパーサを取り込みました。(Bo Peng)
+        </para>
+        <para>
+<!--
+         Now <productname>Pgpool-II</productname> can fully understand the newly added SQL syntax
+         in <productname>PostgreSQL</productname> 11,
+         such as <literal>CREATE/ALTER/DROP PROCEDURE</literal>,
+         <literal>{ RANGE | ROWS | GROUPS } frame_start [ frame_exclusion ]</literal>, etc.
+-->
+<productname>Pgpool-II</productname>は<productname>PostgreSQL</productname>11で新しく追加されたSQLの構文を完全に理解できます。
+たとえば、<literal>CREATE/ALTER/DROP PROCEDURE</literal>や<literal>{ RANGE | ROWS | GROUPS } frame_start [ frame_exclusion ]</literal>などです。
+        </para>
+      </listitem>
+      </itemizedlist>
+    </sect2>
+
+    <sect2>
+<!--
+    <title>Other Enhancements</title>
+-->
+    <title>他の改善点</title>
+    <itemizedlist>
+      <listitem>
+        <!--
+        2018-05-09 [719fbaa]
+        2018-05-10 [edd10f6]
+        -->
+        <para>
+<!--
+          Add "-r" option to <command>pgpool_setup</command> to allow use of <application>pg_rewind</application>. (Tatsuo Ishii)
+-->
+<command>pgpool_setup</command>コマンドに<application>pg_rewind</application>を使用するための"-r"オプションを追加しました。(Tatsuo Ishii)
+        </para>
+        <para>
+<!--
+          With this option, <command>pgpool_setup</command> creates <filename>basebackup.sh</filename> which tries
+          <application>pg_rewind</application> first.  If it fails, falls back to rsync.
+-->
+<command>pgpool_setup</command>のオンラインリカバリスクリプト<filename>basebackup.sh</filename>では、最初に<application>pg_rewind</application>を試します。
+<application>pg_rewind</application>が失敗した場合、rsyncを使用します。
+        </para>
+        <para>
+<!--
+          Also a new environment variable "USE_PG_REWIND" to <application>pgpool_setup</application> is added.
+          This brings the same effect as "-r" option is specified.
+-->
+また、<application>pgpool_setup</application>に新しい環境変数"USE_PG_REWIND"を追加しました。
+これは"-r"オプションと同様の効果があります。
+        </para>
+      </listitem>
+
+      <listitem>
+        <!--
+        2018-04-16 [3d63b8a]
+        2018-04-15 [4867cf2]
+        2018-04-18 [1c9a5dd]
+        2018-05-05 [50b4d27]
+        2018-04-26 [b3a361c]
+        2018-04-18 [1c9a5dd]
+        2018-04-18 [1c9a5dd]
+        -->
+        <para>
+<!--
+          Add "-s" option to <application>pgpool_setup</application> to support for replication slot. (Tatsuo Ishii)
+-->
+<application>pgpool_setup</application>コマンドにレプリケーションスロットを使用するための"-s"オプションを追加しました。(Tatsuo Ishii)
+        </para>
+        <para>
+<!--
+          This eliminates the problem when standby is promoted. When a standby
+          is promoted, it changes the time line in PITR archive, which will stop
+          other standby if any because of shared archive directory.
+-->
+これはスタンバイを昇格する際の問題を解消します。
+スタンバイが昇格するときPITRアーカイブ中にタイムラインが変更されるため、他のスタンバイとアーカイブディレクトリを共有している場合他のスタンバイが停止していました。
+        </para>
+        <para>
+<!--
+          Also a new environment variable "USE_REPLICATION_SLOT" to <application>pgpool_setup</application> is added.
+          This brings the same effect as "-s" option is specified.
+-->
+また、<application>pgpool_setup</application>に新しい環境変数"USE_REPLICATION_SLOT"を追加しました。
+これは"-s"オプションと同様の効果があります。
+        </para>
+        <para>
+<!--
+          If "USE_REPLICATION_SLOT=true", in streaming replication mode,
+          use replication slot instead of archive.
+-->
+"USE_REPLICATION_SLOT=true"の場合、ストリーミングレプリケーションでアーカイブの代わりにレプリケーションスロットを使用できます。
+        </para>
+        <para>
+<!--
+          By setting USE_REPLICATION_SLOT environment variable,
+          now <application>pgpool_setup</application> in all tests uses replication slots.
+          This reduces disk space under <filename>src/test/regression</filename> from
+          6.3GB to 5.1GB (1.2GB savings).
+-->
+USE_REPLICATION_SLOT 環境変数を設定することにより、現在全てのテスト内の<application>pgpool_setup</application>でレプリケーションスロットが使われています。
+これは<filename>src/test/regression</filename>配下のディスクスペースを6.3GBから5.1GB減らします(1.2GBの節約)。
+        </para>
+      </listitem>
+      <listitem>
+        <!--
+        2018-08-17 [3b51aa7]
+        -->
+        <para>
+<!--
+          Introduce <xref linkend="PGPROTO"> to <productname>Pgpool-II</productname>. (Takuma Hoshiai)
+-->
+<productname>Pgpool-II</productname>に<xref linkend="PGPROTO">を導入しました。(Takuma Hoshiai)
+        </para>
+        <para>
+<!--
+         A new utility <xref linkend="PGPROTO"> is added to test <productname>PostgreSQL</productname>
+         or any other servers that understand the frontend/backend protocol.
+-->
+新しく追加した<xref linkend="PGPROTO">コマンドは、<productname>PostgreSQL</productname>もしくはフロントエンド/バックエンドプロトコルを理解するその他のサーバをテストします。
+        </para>
+      </listitem>
+      <listitem>
+        <!--
+        2018-07-09 [62bd296]
+        -->
+        <para>
+<!--
+          Allow to display <productname>Pgpool-II</productname> child process id and
+          <productname>PostgreSQL</productname> backend id in <xref linkend="PCP-PROC-INFO">. (Tatsuo Ishii)
+-->
+<xref linkend="PCP-PROC-INFO">内で<productname>Pgpool-II</productname>の子プロセスIDと<productname>PostgreSQL</productname>のバックエンドIDを表示できます。(Tatsuo Ishii)
+        </para>
+        <para>
+<!--
+          Add &#045;&#045;all option to display all child processes and their available connection slots.
+-->
+全ての子プロセスと利用可能な接続スロットが表示される--all オプション追加しました。
+        </para>
+      </listitem>
+      <listitem>
+        <!--
+                     2018-07-03 [a8a666a]
+        -->
+        <para>
+<!--
+          Add <literal>replication_delay</> and <literal>last_status_change</> to
+          <xref linkend="PCP-NODE-INFO">. (Tatsuo Ishii)
+-->
+<xref linkend="PCP-NODE-INFO">に<literal>replication_delay</>と<literal>last_status_change</>を追加しました。(Tatsuo Ishii)
+        </para>
+      </listitem>
+      <listitem>
+        <!--
+                     2018-07-05 [c47ac16]
+        -->
+        <para>
+<!--
+          Add <literal>role</>, <literal>replication_delay</> and <literal>last_status_change</> columns to pgpool_adm's
+          <xref linkend="PGPOOL-ADM-PCP-NODE-INFO">. (Tatsuo Ishii)
+-->
+pgpool_admの<xref linkend="PGPOOL-ADM-PCP-NODE-INFO">に<literal>role</>、<literal>replication_delay</>、<literal>last_status_change</>列を追加しました。(Tatsuo Ishii)
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+
+  <sect2>
+<!--
+    <title>Changes</title>
+-->
+    <title>変更点</title>
+    <itemizedlist>
+      <listitem>
+      <!--
+      2018-05-07 [05c9297]
+      -->
+      <para>
+<!--
+        Downgrade most of DEBUG1 messages to DEBUG5. (Tatsuo Ishii)
+-->
+大半のDBUG1のメッセージをDEBUG5に変更しました。(Tatsuo Ishii)
+      </para>
+      <para>
+<!--
+        This significantly reduces the size of pgpool log when pgpool starts
+        with -d option (this is equivalent to setting <xref linkend="guc-client-min-messages"> to debug1).
+-->
+Pgpool-IIを"-d"オプションで起動した場合のpgpoolログのサイズを大きく減らします。
+(これは<xref linkend="guc-client-min-messages"> = debug1と同等です)。
+      </para>
+      <para>
+<!--
+        Per discussion <ulink url="http://www.sraoss.jp/pipermail/pgpool-hackers/2018-May/002794.html">
+        [pgpool-hackers: 2794]</ulink>.
+-->
+<ulink url="http://www.sraoss.jp/pipermail/pgpool-hackers/2018-May/002794.html">
+[pgpool-hackers: 2794]</ulink>の議論の結果です。
+
+      </para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+
+  <sect2>
+<!--
+    <title>Bug fixes</title>
+-->
+    <title>不具合修正</title>
+    <itemizedlist>
+      <listitem>
+        <!--
+        2018-07-31 [0f45b8d]
+        -->
+        <para>
+<!--
+          Fix compiler error if HAVE_ASPRINTF is not defined. (Tatsuo Ishii)
+-->
+HAVE_ASPRINTFが定義されていない場合のコンパイラのエラーを修正しました。(Tatsuo Ishii)
+        </para>
+      </listitem>
+
+      <listitem>
+      <!--
+      2018-07-31 [24973c0]
+      -->
+      <para>
+<!--
+        Fix <filename>configure.ac</> to remove generating <filename>src/sql/pgpool_adm/Makefile.in</>. (Tatsuo Ishii)
+-->
+生成される<filename>src/sql/pgpool_adm/Makefile.in</>を削除するため<filename>configure.ac</>を修正しました。(Tatsuo Ishii)
+      </para>
+      </listitem>
+
+      <listitem>
+        <!--
+        2018-05-24 [d2b8efd]
+        -->
+        <para>
+<!--
+          Fix pgpool main process segfault when <productname>PostgreSQL</productname> 9.5 is used. (Tatsuo Ishii)
+-->
+<productname>PostgreSQL</productname> 9.5を使っている場合、Pgpoolのメインプロセスがセグフォルトするのを修正しました。(Tatsuo Ishii)
+        </para>
+        <para>
+<!--
+          pgpool_setup -n 3 (or greater) triggers the bug. While recovering node
+          2, pgpool main process tried to retrieve version info from backend #2
+          even if it's not running. This causes the sefault because connection
+          was not established yet. The reason why <productname>PostgreSQL 9.6</productname>
+          or later was not suffered from the bug was, <productname>PostgreSQL</productname>
+          exited the loop as soon as the server version is higher than 9.5. To fix this,
+          call to VALID_BACKEND macro was added.
+-->
+pgpool_setup -n 3(またはそれ以上)の場合にバグが発生します。
+ノード2のリカバリをしている間、バックエンド#2が稼働していない場合であってもバージョン情報を取得しようとしていました。
+これは接続がまだ確立されてないためセグフォルトを引き起こします。
+<productname>PostgreSQL 9.6</productname>以降で発生しない理由は、<productname>PostgreSQL</productname>のバージョンが9.5以降の場合すぐにループが終了していたためです。
+これを修正するため、VALID_BACKENDマクロを呼ぶ処理を追加しました。
+        </para>
+      </listitem>
+
+      <listitem>
+        <!--
+        2018-05-04 [4621577]
+        -->
+        <para>
+<!--
+          Add missing <xref linkend="guc-health-check-timeout"> in pgpool_setup. (Tatsuo Ishii)
+-->
+pgpool_setupに<xref linkend="guc-health-check-timeout">を追加しました。(Tatsuo Ishii)
+        </para>
+        <para>
+<!--
+          Per node health_check_timeout was missing and this should had been
+          there since the per node health check parameter support was added.
+-->
+ノード毎のhealth_check_timeoutが抜けていました。
+これはノード毎のヘルスチェックのパラメータをサポートした際に追加したはずでした。
+        </para>
+      </listitem>
+
+      <listitem>
+      <!--
+      2018-07-11 [27a0056]
+      -->
+      <para>
+<!--
+        Test: Try to reduce the chance of regression 006.memcache failure. (Tatsuo Ishii)
+-->
+Test: リグレッションテスト 006.memcacheが失敗する可能性を減らしました。(Tatsuo Ishii)
+      </para>
+      <para>
+<!--
+        It seems the occasional failure of the test is caused by replication
+        lag.  The script tries to read tables from standby but it returns a
+        table not existing error. So insert pg_sleep() after creation of
+        tables.
+-->
+不定期にテストが失敗するのはレプリケーションラグが原因だと思われます。
+スクリプトはスタンバイからテーブルの読み込みを試しますが、まだテーブルが存在しないためエラーが返ってきます。
+そのため、テーブルの作成後pg_sleep()を挿入します。
+      </para>
+      </listitem>
+
+      <listitem>
+        <!--
+        2018-05-21 [1d3ab38]
+        -->
+        <para>
+<!--
+        Test: Fix regression test 055.backend_all_down error. (Bo Peng)
+-->
+Test: リグレッションテスト 055.backend_all_downのエラーを修正しました。(Bo Peng)
+        </para>
+      </listitem>
+
+      <listitem>
+        <!--
+        2018-05-04 [1903325]
+        -->
+        <para>
+<!--
+          Doc: Enhance online recovery document. (Tatsuo Ishii)
+-->
+Doc: オンラインリカバリのドキュメントを改善しました。(Tatsuo Ishii)
+        </para>
+        <para>
+<!--
+          Clarify that 2nd stage command is only required in native replication mode.
+-->
+2nd stage コマンドはネイティブレプリケーションモードのみで必要であることを明確にしました。
+        </para>
+      </listitem>
+
+      <listitem>
+        <!--
+        2018-02-27 [4eabecb]
+        -->
+        <para>
+<!--
+          Test: Add new regression test <filename>017.node_0_is_down</> for node 0 not being primary. (Tatsuo Ishii)
+-->
+Test: ノード0がプライマリではない場合を想定した新しいリグレッションテスト <filename>017.node_0_is_down</>を追加しました。(Tatsuo Ishii)
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+</sect1>
index d7bdca17cecd0662ac5b5c078c268eb5e242c7ab..40a4aa7c46a24929c42800d47ed3d1d54e8d4bd3 100644 (file)
@@ -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;
index c044ce5a824c50b693d1898af745fd27aedab453..f722bec7005b34acc3e31032ed6bb1e334d7bbf3 100644 (file)
 <literal>AES</literal>で暗号化されたパスワードを指定するためには、パスワード文字列は暗号化(<literal>aes-256-cbc</literal>アルゴリズムを使用)および<literal>base64</literal>でエンコードした後、<literal>AES</literal>を接頭辞として付けなければいけません。
         </para>
         <para>
+<!--
+                 To specify the unencrypted clear text password, prefix the password string with
+            <literal>TEXT</literal>. For example if you want to set <literal>mypass</literal> as
+            a password, you should specify <literal>TEXTmypass</literal> in the password field.
+            In the absence of a valid prefix, <productname>Pgpool-II</productname> will considered
+            the string as a plain text password.
+-->
+暗号化されていないクリアテキストパスワードを指定するためには、<literal>TEXT</literal>をパスワード文字列の前に付けます。
+例えば、パスワードとして<literal>mypass</literal>を設定したい場合、パスワードフィールドに<literal>TEXTmypass</literal>と指定すべきです。
+有効な接頭辞がない場合、<productname>Pgpool-II</productname>は平文のパスワードとして文字列を見なします。
+        </para>
+        <para>
 <!--
             You can also use <xref linkend="PG-ENC"> utility to create the correctly formatted
             <literal>AES</literal> encrypted password strings.
index 942ce7ade23cf31d9eeeee34e21317cea195aa41..c04a798c968c82829fadf7fd954331dd2167d0ee 100644 (file)
@@ -1424,6 +1424,17 @@ heartbeat_destinationX:heartbeat_destination_portXで指定されるハートビ
 <varname>wd_lifecheck_password</varname>にAES256-CBCで暗号化されたパスワードも指定することができます。
 AESで暗号化されたパスワードを指定するためには、パスワード文字列は暗号化(<literal>aes-256-cbc</literal>アルゴリズムを使用)および<literal>base64</literal>でエンコードした後、<literal>AES</literal>を接頭辞として付けなければいけません。
    </para>
+        <para>
+<!--
+            To specify the unencrypted clear text password, prefix the password string with
+            <literal>TEXT</literal>. For example if you want to set <literal>mypass</literal> as
+            a password, you should specify <literal>TEXTmypass</literal> in the password field.
+            In the absence of a valid prefix, <productname>Pgpool-II</productname> will considered
+            the string as a plain text password.
+-->
+暗号化されていないクリアテキストパスワードを指定するためには、<literal>TEXT</literal>をパスワード文字列の前に付けます。
+例えば、パスワードとして<literal>mypass</literal>を設定したい場合、パスワードフィールドに<literal>TEXTmypass</literal>と指定すべきです。
+        </para>
    <para>
 <!--
         You can also use <xref linkend="PG-ENC"> utility to create the correctly formatted