From 33c0a0218a6f39d04d081f50840a4b61b5f2af5b Mon Sep 17 00:00:00 2001
From: Bo Peng <pengbo@sraoss.co.jp>
Date: Fri, 11 Nov 2022 23:15:00 +0900
Subject: [PATCH] Doc: add Japanese documentation of process management.

---
 doc.ja/src/sgml/connection-settings.sgml | 231 +++++++++++++++++++++++
 doc.ja/src/sgml/runtime.sgml             |  45 +++++
 doc/src/sgml/connection-settings.sgml    |  18 +-
 3 files changed, 285 insertions(+), 9 deletions(-)

diff --git a/doc.ja/src/sgml/connection-settings.sgml b/doc.ja/src/sgml/connection-settings.sgml
index 079bf4442..6a7ba8774 100644
--- a/doc.ja/src/sgml/connection-settings.sgml
+++ b/doc.ja/src/sgml/connection-settings.sgml
@@ -703,6 +703,237 @@
  </sect2>
 </sect1>
 
+<sect1 id="runtime-config-process-management">
+ <!--
+ <title>Process Management</title>
+ -->
+ <title>プロセス管理</title>
+
+  <para>
+  <variablelist>
+
+   <varlistentry id="guc-process-management-mode" xreflabel="process_management_mode">
+    <term><varname>process_management_mode</varname> (<type>enum</type>)
+     <indexterm>
+      <primary><varname>process_management_mode</varname> configuration parameter</primary>
+     </indexterm>
+    </term>
+    <listitem>
+     <para>
+      <!--
+      Specify the idle process management method for
+      <productname>Pgpool-II</productname> child processes.
+      Valid options:
+      -->
+      <productname>Pgpool-II</productname>アイドル状態の子プロセスの管理方法を指定します。
+      有効なオプション:
+      <table id="process-management-mode-table">
+      <!--
+      <title>Possible Process Management Modes</title>
+      -->
+      <title>指定可能なプロセス管理モード</title>
+
+      <tgroup cols="2">
+       <tbody>
+        <row>
+         <entry>static</entry>
+         <entry>
+          <!--
+          All children are pre-forked at startup.
+          -->
+          すべての子プロセスは起動時に事前にフォークされます。
+         </entry>
+        </row>
+
+       <row>
+         <entry>dynamic</entry>
+         <entry>
+          <!--
+          child processes are spawned on demand.
+          number of idle child processes at any time depends on
+          min_spare_children and max_spare_children
+          -->
+          子プロセスはオンデマンドで生成されます。
+          アイドル状態の子プロセスの数はmin_spare_childrenとmax_spare_childrenの設定値に基づいて増減していきます。
+         </entry>
+        </row>
+
+       </tbody>
+      </tgroup>
+     </table>
+     </para>
+     <para>
+       <!--
+       Default is Static, that is compatible with pre <emphasis>V4.4</emphasis>.
+       -->
+       デフォルトは<literal>static</literal>で、<emphasis>V4.4</emphasis>より以前のバージョンとの互換性があります。
+     </para>
+
+     <para>
+      <!--
+      <varname>process_management_mode</varname> is not available prior to
+      <productname>Pgpool-II </productname><emphasis>V4.4</emphasis>.
+      -->
+      <varname>process_management_mode</varname>は、<productname>Pgpool-II</productname><emphasis> V4.4</emphasis>より以前のバージョンでは使用できません。
+     </para>
+
+    </listitem>
+   </varlistentry>
+
+   <varlistentry id="guc-process-management-strategy" xreflabel="process_management_strategy">
+    <term><varname>process_management_strategy</varname> (<type>enum</type>)
+     <indexterm>
+      <primary><varname>process_management_strategy</varname> configuration parameter</primary>
+     </indexterm>
+    </term>
+    <listitem>
+     <para>
+      <!--
+      Specify the process management strategy to satisfy spare (idle) processes count
+      Valid options:
+      -->
+      アイドル状態のプロセスの数を満たすためのプロセス管理戦略を指定します。
+      有効なオプション:
+      <table id="process-management-strategy-table">
+      <!--
+      <title>Possible Process Management Strategies</title>
+      -->
+      <title>指定可能なプロセス管理戦略</title>
+
+      <tgroup cols="2">
+       <tbody>
+        <row>
+         <entry>lazy</entry>
+         <entry>
+          <!--
+          With this strategy the scale-down is performed gradually
+          and only gets triggered when excessive spare processes count
+          remains high for more than 5 mins
+          -->
+          この戦略では、スケールダウンが徐々に実行され、余分なアイドル状態のプロセスが5分以上残っている場合にのみトリガーされます。
+         </entry>
+        </row>
+
+       <row>
+         <entry>gentle</entry>
+         <entry>
+          <!--
+          With this strategy the scale-down is performed gradually
+          and only gets triggered when excessive spare processes count
+          remains high for more than 2 mins
+          -->
+          この戦略では、スケールダウンが徐々に実行され、余分なアイドル状態のプロセスが2分以上残っている場合にのみトリガーされます。
+         </entry>
+        </row>
+
+       <row>
+         <entry>aggressive</entry>
+         <entry>
+          <!--
+          With this strategy the scale-down is performed aggressively
+          and gets triggered more frequently in case of higher spare processes.
+          This mode uses faster and slightly less smart process selection criteria
+          to identify the child processes that can be serviced to satisfy
+          max_spare_children
+          -->
+          この戦略では、スケールダウンが積極的に実行され、アイドル状態のプロセスが多い場合により頻繁にトリガーされます。
+          このモードでは、<xref linkend="guc-max-spare-children">を満たすために、サービスを提供するための子プロセスの識別基準は、より高速でややスマートでないプロセス選択基準を使用します。
+         </entry>
+        </row>
+
+       </tbody>
+      </tgroup>
+     </table>
+     </para>
+     <para>
+      <!--
+      Default is Gentle.
+      -->
+      デフォルトは<literal>gentle</literal>です。
+     </para>
+     <para>
+      <!--
+      <varname>process_management_strategy</varname> is not available prior to
+      <productname>Pgpool-II </productname><emphasis>V4.4</emphasis>.
+      -->
+      <varname>process_management_strategy</varname>は、<productname>Pgpool-II</productname><emphasis>V4.4</emphasis>より以前のバージョンでは使用できません。
+     </para>
+
+    </listitem>
+   </varlistentry>
+
+ <varlistentry id="guc-min-spare-children" xreflabel="min_spare_children">
+    <term><varname>min_spare_children</varname> (<type>integer</type>)
+     <indexterm>
+      <primary><varname>min_spare_children</varname> configuration parameter</primary>
+     </indexterm>
+    </term>
+    <listitem>
+     <para>
+      <!--
+      Specify the minimum number of spare (idle) child processes to keep.
+      If the idle process count falls below min_spare_children,
+      Pgpool-II will spawn new child processes unless it hits the total allowed child process ceiling (num_init_children)
+      Default value is 5.
+      -->
+      保持する予備（アイドル状態）の子プロセスの最小個数を指定します。
+      予備（アイドル状態）の子プロセス数が<varname>min_spare_children</varname>を下回った場合、<productname>Pgpool-II</productname>は許容される子プロセスの合計上限（<xref linkend="guc-num-init-children">）に達しない限り、新しい子プロセスを生成します。
+      デフォルト値は5です。
+     </para>
+     <para>
+      <!--
+      This parameter can be changed by reloading
+      the <productname>Pgpool-II</productname> configurations.
+      -->
+      このパラメータは<productname>Pgpool-II</productname>の設定を再読み込みすることで変更可能です。
+     </para>
+     <para>
+      <!--
+      This parameter is only applicable for <emphasis>dynamic</emphasis> process management mode.
+      -->
+      このパラメーターは、動的プロセス管理モードが有効になっている場合にのみ適用されます。
+     </para>
+    </listitem>
+   </varlistentry>
+
+ <varlistentry id="guc-max-spare-children" xreflabel="max_spare_children">
+    <term><varname>max_spare_children</varname> (<type>integer</type>)
+     <indexterm>
+      <primary><varname>max_spare_children</varname> configuration parameter</primary>
+     </indexterm>
+    </term>
+    <listitem>
+     <para>
+      <!--
+      Specify the maximum number of spare (idle) child processes to keep.
+       If the idle process count increases from max_spare_children, Pgpool-II will kill the excessive child processes.
+      Default value is 10.
+      -->
+      保持する予備（アイドル状態）の子プロセスの最大個数を指定します。
+      予備（アイドル状態）の子プロセス数が<varname>max_spare_children</varname>を超えた場合、<productname>Pgpool-II</productname>は余分な子プロセスを強制終了します。
+      デフォルト値は10です。
+     </para>
+     <para>
+      <!--
+      This parameter can be changed by reloading
+      the <productname>Pgpool-II</productname> configurations.
+      -->
+      このパラメータは<productname>Pgpool-II</productname>の設定を再読み込みすることで変更可能です。
+     </para>
+     <para>
+      <!--
+      This parameter is only applicable for <emphasis>dynamic</emphasis> process management mode.
+      -->
+      このパラメーターは、動的プロセス管理モードが有効になっている場合にのみ適用されます。
+     </para>
+    </listitem>
+   </varlistentry>
+
+    </variablelist>
+
+ </para>
+</sect1>
+
 <sect1 id="runtime-config-running-mode">
  <title>クラスタリングモード</title>
 
diff --git a/doc.ja/src/sgml/runtime.sgml b/doc.ja/src/sgml/runtime.sgml
index 450894676..230320cbe 100644
--- a/doc.ja/src/sgml/runtime.sgml
+++ b/doc.ja/src/sgml/runtime.sgml
@@ -385,6 +385,51 @@ default_transaction_isolation = 'repeatable read'
     このモードでは負荷分散は<emphasis>できません</emphasis>。
    </para>
   </sect2>
+
+  <sect2 id="process-management-mode">
+   <!--
+   <title>Process management modes</title>
+   -->
+   <title>プロセス管理モード</title>
+
+   <indexterm zone="running-mode">
+    <primary>dynamic process management</primary>
+   </indexterm>
+
+   <indexterm zone="running-mode">
+    <primary>static process management</primary>
+   </indexterm>
+   <para>
+    <!--
+    <productname>Pgpool-II</> implements a multi-process architecture where
+    each child process can handle exactly one client connection at any time.
+    The total number of concurrent client connections <productname>Pgpool-II</>
+    can handle is configured by the
+    <link linkend="guc-num-init-children">num_init_children</link> config parameter.
+    <productname>Pgpool-II</> supports two child process management modes.
+    <firstterm>Dynamic</firstterm> and <firstterm>Static</firstterm>.
+    In static process management mode, <productname>Pgpool-II</> pre-forks the
+    num_init_children number of child
+    process at startup, and each child process keeps listening for incoming
+    client connection. While with dynamic process management mode,
+    <productname>Pgpool-II</> keeps track of idle processes and forks or kills
+    processes to keep this number within the specified boundaries.
+    -->
+    <productname>Pgpool-II</>は、各子プロセスが常に1つのクライアント接続を処理できるマルチプロセスアーキテクチャを実装しています。
+    <productname>Pgpool-II</>が処理できるクライアントの最大同時接続数は、<xref linkend="guc-num-init-children">設定パラメーターによって設定されます。
+    <productname>Pgpool-II</>は、2つの子プロセス管理モード<firstterm>dynamic</firstterm>および<firstterm>static</firstterm>をサポートしています。
+    静的（<literal>static</literal>）プロセス管理モードでは、<productname>Pgpool-II</>は起動時に<varname>num_init_children</varname>の設定値の数の子プロセスを事前にフォークし、各子プロセスは、クライアント接続をリッスンし続けます。
+    動的（<literal>dynamic</literal>）プロセス管理モードでは、<productname>Pgpool-II</>はアイドル状態のプロセスを追跡し、プロセスの数を指定された範囲内に維持するために、プロセスをforkまたはkillします。
+   </para>
+   <para>
+    <!--
+    <varname>process_management_mode</varname> is not available prior to
+    <productname>Pgpool-II </productname><emphasis>V4.4</emphasis>.
+    -->
+    <xref linkend="guc-process-management-mode">は、<productname>Pgpool-II</> <emphasis>V4.4</emphasis>より以前のバージョンでは使用できません。
+   </para>
+  </sect2>
+
  </sect1>
 
  <sect1 id="configuring-backend-info">
diff --git a/doc/src/sgml/connection-settings.sgml b/doc/src/sgml/connection-settings.sgml
index 189c86de3..fc47c8760 100644
--- a/doc/src/sgml/connection-settings.sgml
+++ b/doc/src/sgml/connection-settings.sgml
@@ -480,14 +480,14 @@
       <tgroup cols="2">
        <tbody>
         <row>
-         <entry>Static</entry>
+         <entry>static</entry>
          <entry>
           All children are pre-forked at startup.
          </entry>
         </row>
 
        <row>
-         <entry>Dynamic</entry>
+         <entry>dynamic</entry>
          <entry>child processes are spawned on demand.
          number of idle child processes at any time depends on
           min_spare_children and max_spare_children
@@ -499,7 +499,7 @@
      </table>
      </para>
      <para>
-       Default is Static, that is compatible with pre <emphasis>V4.4</emphasis>.
+       Default is <literal>static</literal>, that is compatible with pre <emphasis>V4.4</emphasis>.
      </para>
 
        <para>
@@ -526,7 +526,7 @@
       <tgroup cols="2">
        <tbody>
         <row>
-         <entry>Lazy</entry>
+         <entry>lazy</entry>
          <entry>With this strategy the scale-down is performed gradually
          and only gets triggered when excessive spare processes count
          remains high for more than 5 mins
@@ -534,7 +534,7 @@
         </row>
 
        <row>
-         <entry>Gentle</entry>
+         <entry>gentle</entry>
          <entry>With this strategy the scale-down is performed gradually
          and only gets triggered when excessive spare processes count
          remains high for more than 2 mins
@@ -542,7 +542,7 @@
         </row>
 
        <row>
-         <entry>Aggressive</entry>
+         <entry>aggressive</entry>
          <entry>With this strategy the scale-down is performed aggressively
          and gets triggered more frequently in case of higher spare processes.
          This mode uses faster and slightly less smart process selection criteria
@@ -556,10 +556,10 @@
      </table>
      </para>
      <para>
-       Default is Gentle.
+       Default is <literal>gentle</literal>.
      </para>
           <para>
-       <varname>process_management_mode</varname> is not available prior to
+       <varname>process_management_strategy</varname> is not available prior to
        <productname>Pgpool-II </productname><emphasis>V4.4</emphasis>.
       </para>
 
@@ -576,7 +576,7 @@
      <para>
       Specify the minimum number of spare (idle) child processes to keep.
       If the idle process count falls below min_spare_children,
-      Pgpool-II will spawn new child processes unless it hits the total allowed child process ceiling (num_init_children)
+      Pgpool-II will spawn new child processes unless it hits the total allowed child process ceiling (num_init_children).
       Default value is 5.
      </para>
      <para>
-- 
2.39.5