Add Aurora setting documentation in Japanese.
authorTatsuo Ishii <ishii@postgresql.org>
Wed, 12 Jul 2017 08:35:18 +0000 (17:35 +0900)
committerTatsuo Ishii <ishii@postgresql.org>
Wed, 12 Jul 2017 08:35:18 +0000 (17:35 +0900)
doc.ja/src/sgml/connection-settings.sgml
doc.ja/src/sgml/examples.sgml

index 31eb1568b4cbe4ed71c141906c65ae523dab8804..4593c13da4d50566d559d034aa40a2b9f1c26efa 100644 (file)
@@ -1518,8 +1518,33 @@ backend_weight は新しく追加した行を設定ファイル再読み込み
                        ALLOW_TO_FAILOVERと同時には指定できません。
                        </entry>
                </row>
-                               </tbody>
-                       </tgroup>
+
+               <row>
+<!--
+                 <entry><literal>ALWAYS_MASTER</literal></entry>
+                 <entry>This is only useful in streaming replication
+                 mode. See <xref linkend="running-mode"> about
+                 streaming replication mode.  If this flag is set to
+                 one of
+                 backends, <productname>Pgpool-II</productname> will
+                 not find the primary node by inspecting
+                 backend. Instead, always regard the node which the
+                 flag is set as the primary node. This is useful for
+                 systems including <productname>Amazon Aurora for
+                 PostgreSQL Compatibility</productname> which has
+                 fixed master server name.
+                 </entry>
+-->
+                 <entry><literal>ALWAYS_MASTER</literal></entry>
+                 <entry>ストリーミングレプリケーションでのみ有効です。
+                 ストリーミングレプリケーションモードについては<xref linkend="running-mode">をご覧ください。
+                 このフラグがバックエンドのどれかにセットされていると、<productname>Pgpool-II</productname>はバックエンドにアクセスしてプライマリノードを探すのではなく、このフラグがセットされているノードをプライマリノードと見なします。
+                これは、<productname>Amazon Aurora for PostgreSQL Compatibility</productname>のような、マスターサーバに固定のホスト名が割り当てられるシステムで有用です。
+                 </entry>
+               </row>
+
+               </tbody>
+               </tgroup>
                </table>
                <para>
 <!--
index 415af3d35bf169b1ae5c319b1446737cc8604132..e4d1af898673ba7ae27b11044f8df4d9ed125094 100644 (file)
@@ -1433,5 +1433,110 @@ PING 35.163.178.3 (35.163.178.3) 56(84) bytes of data.
     </sect2>
   </sect1>
 
+    <sect1 id="example-Aurora">
+      <!--
+      <title>Aurora Configuration Example</title>
+      -->
+      <title>Auroraの設定例</title>
+      
+      <para>
+<!--
+       <productname>Amazon Aurora for PostgreSQL
+       Compatibility</productname> (Aurora) is a managed service for
+       <productname>PostgreSQL</productname>. From user's point of
+       view, <productname>Aurora</productname> can be regarded as a
+       streaming replication cluster with some exceptions. First,
+       fail over and online recovery are managed
+       by <productname>Aurora</productname>. So you don't need to
+       set <xref linkend="guc-failover-command">, <xref linkend="guc-follow-master-command">,
+       and recovery related parameters. In this section we explain
+       how to set up <productname>Pgpool-II</productname> for Aurora.
+-->
+       <productname>Amazon Aurora for PostgreSQL
+       Compatibility</productname> (Aurora) は、<productname>PostgreSQL</productname>用のマネージドサービスです。
+       ユーザから見ると、<productname>Aurora</productname>は、いくつか例外があるものの、ストリーミングレプリケーションのクラスタのように見えます。フェイルオーバやオンラインリカバリは<productname>Aurora</productname>によって管理されます。
+       ですから、<xref linkend="guc-failover-command">、<xref linkend="guc-follow-master-command">、
+           それにオンラインリカバリ関連のパラメータは設定の必要がありません。
+           この章では、Aurora用の<productname>Pgpool-II</productname>設定を説明します。
+      </para>
+
+      <sect2 id="example-Aurora-config">
+<!--
+       <title>Setting pgpool.conf for Aurora</title>
+-->
+       <title>Auroraのためにpgpool.confを設定する</title>
+       <para>
+         <itemizedlist>
+           <listitem>
+             <para>
+               <!--
+               Create <filename>pgpool.conf</filename>
+               from <filename>pgpool.conf.sample-stream</filename>.
+                 -->
+               <filename>pgpool.conf.sample-stream</filename>をコピーして<filename>pgpool.conf</filename>を作ります。
+             </para>
+           </listitem>
+           <listitem>
+             <para>
+               <!--
+               Set <xref linkend="guc-sr-check-period"> to 0 to
+                 disable streaming replication delay checking.
+                 -->
+               <xref linkend="guc-sr-check-period">を0にして、ストリーミングレプリケーション遅延チェックを無効にします。
+             </para>
+           </listitem>
+           <listitem>
+             <para>
+               <!--
+               Enable <xref linkend="guc-enable-pool-hba"> to on so
+                 that md5 authentication is enabled
+                 (<productname>Aurora</productname> always use md5
+                 authentication).
+                 -->
+               <xref linkend="guc-enable-pool-hba">をオンにし、md5認証を有効にします。
+                 (<productname>Aurora</productname>では常にmd5認証が有効になっています)
+             </para>
+           </listitem>
+           <listitem>
+             <para>
+               <!--
+               Create <filename>pool_password</filename>. See <xref linkend="auth-md5">
+                 for more details.
+                 -->
+               <filename>pool_password</filename>を作成します。
+               詳細は<xref linkend="auth-md5">をご覧ください。
+             </para>
+           </listitem>
+           <listitem>
+             <para>
+               <!--
+               Set <xref linkend="guc-backend-hostname">0 for the
+               Aurora writer node.  Set
+               other <xref linkend="guc-backend-hostname"> for the
+               Aurora reader node.  Set
+               appropreate <xref linkend="guc-backend-weight"> as
+               usual. You don't need to
+               set <xref linkend="guc-backend-data-directory">
+                 -->
+               <xref linkend="guc-backend-hostname">0をAuroraのwriterノードに設定します。
+                 他の<xref linkend="guc-backend-hostname">はAuroraのreaderノードに設定します。
+                   <xref linkend="guc-backend-data-directory">は設定の必要がありません。
+             </para>
+           </listitem>
+           <listitem>
+             <para>
+               <!--
+               Set <varname>ALWAYS_MASTER</varname> flag to
+               the <xref linkend="guc-backend-flag"> for the master
+               node.
+                 -->
+               マスタノードの<xref linkend="guc-backend-flag">の<varname>ALWAYS_MASTER</varname>をオンにします。
+             </para>
+           </listitem>
+         </itemizedlist>
+       </para>
+      </sect2>
+    </sect1>
+
   </chapter>
 </part>