Doc: enhance description in the memory requirement section.
authorTatsuo Ishii <ishii@sraoss.co.jp>
Tue, 26 Jul 2022 06:23:40 +0000 (15:23 +0900)
committerTatsuo Ishii <ishii@sraoss.co.jp>
Tue, 26 Jul 2022 06:25:57 +0000 (15:25 +0900)
Add explanation about memory usage while pgpool child process is running.

doc.ja/src/sgml/performance.sgml
doc/src/sgml/performance.sgml

index bb6f7a1e4e4332c583d04bf981b502787c394784..b9f32ca887d04254d89389c3f9b29aeefb7d9a19 100644 (file)
@@ -62,6 +62,8 @@
       合計必要プロセスメモリ(メガバイト単位) = <xref linkend="guc-num-init-children"> * 0.16
      </programlisting>
      たとえば<varname>num_init_children</varname> = 32 (デフォルト値です)なら、5.2 MBのメモリが必要です。
+     なお、このメモリ量は<productname>Pgpool-II</productname>子プロセス起動時の最低限の必要メモリで、プロセスが稼働するにしたがって、通信データの大きさなどに応じて更に使用するメモリが増えていきます。
+     実際に<productname>Pgpool-II</productname>を動かして、必要なメモリ量がどのくらいになるのか実運用に入る前に検証することをお勧めします。
     </para>
    </sect3>
   </sect2>
index 92ce013a502cfc6601d66a865947da691fd7208e..62068d72641a19921c13e53ede6b147d891f4fb2 100644 (file)
      <programlisting>
       Process memory requirement in total (in mega bytes) = <xref linkend="guc-num-init-children"> * 0.16
      </programlisting>
-     For example if you have <varname>num_init_children</varname> =
-     32 (the default), you will need 5.2MB.
+     For example if you have <varname>num_init_children</varname> = 32
+     (the default), you will need 5.2MB.  Please note that this is
+     minimum memory requirement
+     upon <productname>Pgpool-II</productname> child process starting
+     up. Once the process runs, it will consume more memory depending
+     on the message packet sizes and other factors. It is recommended
+     to measure the amount of memory actually used by the process
+     before starting production use.
     </para>
    </sect3>
   </sect2>