add manpage of metadb_backend_sync_commit_at_initialization

Author: n-soda

doc/docbook/en/ref/man5/gfarm2.conf.5.docbook

@@ -2650,6 +2650,29 @@ This parameter is only available in gfmd.conf.
 </listitem>
 </varlistentry>
 
+<varlistentry>
+<term><token>metadb_backend_sync_commit_at_initialization</token> <parameter moreinfo="none">validity</parameter></term>
+<listitem>
+<para>
+If metadb_replication is enabled, gfmd reflects the journal file contents
+to the backend database at startup,
+This directive controls whether or not synchronous commit is performed
+on the backend database side.
+If this setting is disable, asynchronous commit is performed,
+which speeds up gfmd startup.
+The default is <token>disable</token>.
+This directive is currently implemented only in the PostgreSQL backend.
+</para>
+<para>
+This parameter is only available in gfmd.conf.
+</para>
+<para>Example:</para>
+<literallayout format="linespecific" class="normal">
+	metadb_backend_sync_commit_at_initialization disable
+</literallayout>
+</listitem>
+</varlistentry>
+
 <varlistentry>
 <term><token>metadb_replica_remover_by_host_sleep_time</token> <parameter moreinfo="none">nanoseconds</parameter></term>
 <listitem>
@@ -3625,6 +3648,7 @@ The default for this parameter is determined at OpenSSL compile time.
 	&lt;metadb_journal_dir_statement&gt; |
 	&lt;metadb_journal_max_size_statement&gt; |
 	&lt;metadb_journal_recvq_size_statement&gt; |
+	&lt;metadb_backend_sync_commit_at_initialization_statement&gt; |
 	&lt;metadb_replica_remover_by_host_sleep_time_statement&gt; |
 	&lt;metadb_replica_remover_by_host_inode_step_statement&gt; |
 	&lt;replica_check_statement&gt; |
@@ -4346,6 +4370,11 @@ The default for this parameter is determined at OpenSSL compile time.
 <listitem><literallayout format="linespecific" class="normal">"metadb_journal_recvq_size" &lt;number&gt;</literallayout></listitem>
 </varlistentry>
 
+<varlistentry>
+<term>&lt;metadb_backend_sync_commit_at_initialization_statement&gt; ::=</term>
+<listitem><literallayout format="linespecific" class="normal">"metadb_backend_sync_commit_at_initialization" &lt;validity&gt;</literallayout></listitem>
+</varlistentry>
+
 <varlistentry>
 <term>&lt;metadb_replica_remover_by_host_sleep_time_statement&gt; ::=</term>
 <listitem><literallayout format="linespecific" class="normal">"metadb_replica_remover_by_host_sleep_time" &lt;number&gt;</literallayout></listitem>

doc/docbook/ja/ref/man5/gfarm2.conf.5.docbook

@@ -2575,6 +2575,29 @@ gfsd や gfmd は、gfarm2.conf や gfmd.conf 中のこの文を無視します
 </listitem>
 </varlistentry>
 
+<varlistentry>
+<term><token>metadb_backend_sync_commit_at_initialization</token> <parameter moreinfo="none">有効性</parameter></term>
+<listitem>
+<para>
+metadb_replication が enable の場合、gfmd は起動時にジャーナルファイルの
+内容をバックエンドデータベースへ反映しますが、
+この反映時にバックエンドデータベース側で同期コミットを行なうか否かを
+このディレクティブで制御します。
+この設定が disable だと非同期にコミットを行なうため gfmd の起動が
+高速化します。
+デフォルトは disable です。
+このディレクティブは現在 PostgreSQL バックエンドのみで実装されています。
+</para>
+<para>
+この文はgfmd.confのみで有効であり、gfarm2.confでは無視されます。
+</para>
+<para>Example:</para>
+<literallayout format="linespecific" class="normal">
+	metadb_backend_sync_commit_at_initialization disable
+</literallayout>
+</listitem>
+</varlistentry>
+
 <varlistentry>
 <term><token>metadb_replica_remover_by_host_sleep_time</token> <parameter moreinfo="none">ナノ秒</parameter></term>
 <listitem>
@@ -3571,6 +3594,7 @@ OpenSSL の security_level 機能の数値を指定します。
 	&lt;metadb_journal_dir_statement&gt; |
 	&lt;metadb_journal_max_size_statement&gt; |
 	&lt;metadb_journal_recvq_size_statement&gt; |
+	&lt;metadb_backend_sync_commit_at_initialization_statement&gt; |
 	&lt;metadb_replica_remover_by_host_sleep_time_statement&gt; |
 	&lt;metadb_replica_remover_by_host_inode_step_statement&gt; |
 	&lt;replica_check_statement&gt; |
@@ -4292,6 +4316,11 @@ OpenSSL の security_level 機能の数値を指定します。
 <listitem><literallayout format="linespecific" class="normal">"metadb_journal_recvq_size" &lt;number&gt;</literallayout></listitem>
 </varlistentry>
 
+<varlistentry>
+<term>&lt;metadb_backend_sync_commit_at_initialization_statement&gt; ::=</term>
+<listitem><literallayout format="linespecific" class="normal">"metadb_backend_sync_commit_at_initialization" &lt;validity&gt;</literallayout></listitem>
+</varlistentry>
+
 <varlistentry>
 <term>&lt;metadb_replica_remover_by_host_sleep_time_statement&gt; ::=</term>
 <listitem><literallayout format="linespecific" class="normal">"metadb_replica_remover_by_host_sleep_time" &lt;number&gt;</literallayout></listitem>