pgpool2.git / summary / log / commit / refs
commit a3eb155f3f265ddcc813690ea9f28df2e4e7f8d5
Author: Yugo Nagata <nagata@sraoss.co.jp>
Date: Wed Nov 02 01:36:59 2016 +0000
Translate SGML into Japanese
- failover.sgml
- memcache.sgml
- misc-config.sgml
- online-recovery.sgml
- ssl.sgml
- stream-check.sgml
- watchdog.sgml
doc.ja/src/sgml/connection-pooling.sgml | 24 +--
doc.ja/src/sgml/failover.sgml | 274 ++++++++++++++++++++++++++------
doc.ja/src/sgml/memcache.sgml | 264 ++++++++++++++++++++++++++++--
doc.ja/src/sgml/misc-config.sgml | 92 ++++++++++-
doc.ja/src/sgml/online-recovery.sgml | 247 +++++++++++++++++++++++-----
doc.ja/src/sgml/ssl.sgml | 63 ++++++++
doc.ja/src/sgml/stream-check.sgml | 118 ++++++++++++--
doc.ja/src/sgml/watchdog.sgml | 23 ++-
doc/src/sgml/failover.sgml | 83 +++++-----
doc/src/sgml/memcache.sgml | 30 ++--
doc/src/sgml/misc-config.sgml | 16 +-
doc/src/sgml/online-recovery.sgml | 75 ++++-----
doc/src/sgml/stream-check.sgml | 26 +--
doc/src/sgml/watchdog.sgml | 2 +-
14 files changed, 1080 insertions(+), 257 deletions(-)
diff --git a/doc.ja/src/sgml/connection-pooling.sgml b/doc.ja/src/sgml/connection-pooling.sgml
index 1c21d77a5..54b93efd5 100644
--- a/doc.ja/src/sgml/connection-pooling.sgml
+++ b/doc.ja/src/sgml/connection-pooling.sgml
@@ -52,7 +52,7 @@ onに設定されるとバックエンドへの接続をキャッシュします
You need to restart <productname>Pgpool-II</productname>
if you change this value.
-->
-このパラメータを変更した時には<productname>Pgpool-II</productname>を再起動してください。
+このパラメータを変更した時には<productname>Pgpool-II</productname>を再起動してください。
</para>
</listitem>
</varlistentry>
@@ -70,7 +70,7 @@ onに設定されるとバックエンドへの接続をキャッシュします
<para>
<!--
The maximum number of cached connections
- in each <productname>Pgpool-II</productname> child
+ in each <productname>Pgpool-II</productname> child
process. <productname>Pgpool-II</productname> reuses the
cached connection if an incoming connection is connecting
to the same database with the same user name. If not,
@@ -131,7 +131,7 @@ onに設定されるとバックエンドへの接続をキャッシュします
See <xref linkend="guc-num-init-children"> for more details.
-->
システムのよっては<literal>listen()</literal>システムコールの<literal>backlog</literal>パラメータに上限が設定されています。
-詳細は<xref linkend="guc-num-init-children">の項を参照してください。
+詳細は<xref linkend="guc-num-init-children">の項を参照してください。
</para>
</note>
<para>
@@ -171,7 +171,7 @@ onに設定されるとバックエンドへの接続をキャッシュします
-->
onに設定することで、<productname>Pgpool-II</productname>は受け付けるクライアント接続のシリアライズを有効にします。
シリアライズを行わない場合、OSカーネルは<literal>accept()</literal>を実行するために全ての<productname>Pgpool-II</productname>子プロセスを起こし、実際にはそのうちの１つのみが入ってきた接続を処理します。
-ここでの問題は、子プロセスが一度に起こされるために重いコンテキストスイッチングが起こり、性能に影響がでることです。
+ここでの問題は、子プロセスが一度に起こされるために重いコンテキストスイッチングが起こり、性能に影響がでることです。
</para>
<para>
<!--
@@ -207,7 +207,7 @@ onに設定することで、<productname>Pgpool-II</productname>は受け付け
of <xref linkend="guc-num-init-children"> and <varname>serialize_accept</varname>
can be different on different environments.
-->
-<xref linkend="guc-num-init-children">と<varname>serialize_accept</varname>の相関は環境によって異なるので、<varname>serialize_accept</varname>を使うかどうか決める前にベンチマークテストを行ってみることをおすすめします。
+<xref linkend="guc-num-init-children">と<varname>serialize_accept</varname>の相関は環境によって異なるので、<varname>serialize_accept</varname>を使うかどうか決める前にベンチマークテストを行ってみることをおすすめします。
</para>
</note>
@@ -253,7 +253,7 @@ pgbench -n -S -p 9999 -c 32 -C -S -T 300 test
なお、<xref linkend="guc-child-life-time"> が有効だと、<varname>serialize_accept</varname>は効果がありません。
<varname>serialize_accept</varname>をonにしたい場合は、<xref linkend="guc-child-life-time">が0であることを確認してください。
<productname>Pgpool-II</productname>プロセスのメモリーリークなどの潜在的な問題を気にする場合は、代わりに<xref linkend="guc-child-max-connections">を使ってください。
-この制限は純粋に実装上の問題であり、将来はなくなるかもしれません。
+この制限は純粋に実装上の問題であり、将来はなくなるかもしれません。
</para>
</note>
@@ -354,7 +354,7 @@ pgbench -n -S -p 9999 -c 32 -C -S -T 300 test
<varname>client_idle_limit</varname> is ignored in
the second stage of online recovery.
-->
-<varname>client_idle_limit</varname>はオンラインリカバリのセカンドステージでは無視されます。
+<varname>client_idle_limit</varname>はオンラインリカバリのセカンドステージでは無視されます。
</para>
</note>
<para>
@@ -595,7 +595,7 @@ pgbench -n -S -p 9999 -c 32 -C -S -T 300 test
The default is to log to <literal>stderr</literal>.
-->
<productname>Pgpool-II</productname>は、<literal>stderr</literal>および<literal>syslog</literal>を含めて、サーバメッセージのログ取得に対し数種類の方法を提供します
-デフォルトでは<literal>stderr</literal>にログが出力されます。
+デフォルトでは<literal>stderr</literal>にログが出力されます。
</para>
<note>
<para>
@@ -613,7 +613,7 @@ pgbench -n -S -p 9999 -c 32 -C -S -T 300 test
<varname>log_destination</varname>でsyslogオプションを使用できるようにするために、いくつかのシステムではシステムの<application>syslog</application>デーモンの設定を変更しなければならないでしょう。
<productname>Pgpool-II</productname>ではログを<literal>LOCAL0</literal>から<literal>LOCAL7</literal>までの<application>syslog</application>ファシリティで記録することができます（<xref linkend="guc-syslog-facility">を参照してください）。
しかし、ほとんどのプラットフォームのデフォルトの<application>syslog</application>設定ではこれらのメッセージはすべて破棄されます。
-うまく動作させるために<application>syslog</application>デーモンの設定に以下のようなものを追加しなければならないでしょう。
+うまく動作させるために<application>syslog</application>デーモンの設定に以下のようなものを追加しなければならないでしょう。
<programlisting>
local0.* /var/log/pgpool.log
</programlisting>
@@ -837,7 +837,7 @@ onに設定されている場合、全てのSQL文をログ出力します。
replication or load-balancing is working.
-->
<xref linkend="guc-log-statement">と似ていますが、DBノード単位でログが出力されます。
-レプリケーションや負荷分散が動いていることを確認するのに便利です。
+レプリケーションや負荷分散が動いていることを確認するのに便利です。
</para>
<para>
<!--
@@ -892,7 +892,7 @@ onに設定されている場合、<command>ps</>コマンドの結果、およ
<!--
Setting to on, prints all client connections from to the log.
-->
-onに設定されている場合、全てのクライアント接続をログへ出力します。
+onに設定されている場合、全てのクライアント接続をログへ出力します。
</para>
<para>
<!--
@@ -964,7 +964,7 @@ onに設定されている場合、全てのクライアント接続をログへ
認識できないエスケープは無視されます。
他の文字はそのままログ行に出力されます。
デフォルトは '%t: pid %p: 'で、タイムスタンプとプロセスIDを印字します。
-これは、<productname>Pgpool-II</productname> <emphasis>V3.4</emphasis>より前のバージョンとの互換性を保つためです。
+これは、<productname>Pgpool-II</productname> <emphasis>V3.4</emphasis>より前のバージョンとの互換性を保つためです。
</para>
<table id="log-line-prefix-table">
diff --git a/doc.ja/src/sgml/failover.sgml b/doc.ja/src/sgml/failover.sgml
index cb964a2f7..738040cab 100644
--- a/doc.ja/src/sgml/failover.sgml
+++ b/doc.ja/src/sgml/failover.sgml
@@ -1,77 +1,124 @@
<!-- doc/src/sgml/config.sgml -->
<sect1 id="runtime-config-failover">
+<!--
<title>Failover and Failback</title>
+-->
+ <title>フェイルオーバとフェイルバック</title>
<variablelist>
<varlistentry id="guc-failover-command" xreflabel="failover_command">
<term><varname>failover_command</varname> (<type>string</type>)
<indexterm>
- <primary><varname>failover_command</varname> configuration parameter</primary>
+ <primary><varname>failover_command</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
- Specifies a user command to run when a PostgreSQL backend node detaches.
+<!--
+ Specifies a user command to run when a <productname>PostgreSQL</> backend node gets detached.
<productname>Pgpool-II</productname> replaces the following special characters
- with the backend specific information.
+ with the backend specific information before excuting the command.
+-->
+<productname>PostgreSQL</>バックエンドノードが切り離される時に実行するユーザコマンドを指定します。
+<productname>Pgpool-II</productname>はコマンド実行の前に、以下の特殊文字をバックエンドの具体的な情報に置き換えます。
</para>
<table id="failover-command-table">
+<!--
<title>failover command options</title>
+-->
+ <title>フェイルオーバコマンドオプション</title>
<tgroup cols="2">
<thead>
<row>
+<!--
<entry>Special character</entry>
<entry>Description</entry>
+-->
+ <entry>特殊文字</entry>
+ <entry>説明</entry>
</row>
</thead>
<tbody>
<row>
<entry>%d</entry>
- <entry>Backend ID of a detached node</entry>
+<!--
+ <entry>DB node ID of the detached node</entry>
+-->
+ <entry>切り離されたノードのDBノードID</entry>
</row>
<row>
<entry>%h</entry>
- <entry>Hostname of a detached node</entry>
+<!--
+ <entry>Hostname of the detached node</entry>
+-->
+ <entry>切り離されたノードのホスト名</entry>
</row>
<row>
<entry>%p</entry>
- <entry>Port number of a detached node</entry>
+<!--
+ <entry>Port number of the detached node</entry>
+-->
+ <entry>切り離されたノードのポート番号</entry>
</row>
<row>
<entry>%D</entry>
- <entry>Database cluster directory of a detached node</entry>
+<!--
+ <entry>Database cluster directory of the detached node</entry>
+-->
+ <entry>切り離されたノードのデータベースクラスタパス</entry>
</row>
<row>
<entry>%M</entry>
+<!--
<entry>Old master node ID</entry>
+-->
+ <entry>古いマスターノードのID</entry>
</row>
<row>
<entry>%m</entry>
+<!--
<entry> New master node ID</entry>
+-->
+ <entry>新しいマスターノードのID</entry>
</row>
<row>
<entry>%H</entry>
+<!--
<entry>Hostname of the new master node</entry>
+-->
+ <entry>新しいマスターノードのホスト名</entry>
</row>
<row>
<entry>%P</entry>
+<!--
<entry> Old primary node ID</entry>
+-->
+ <entry>古いプライマリノードのID</entry>
</row>
<row>
<entry>%r</entry>
- <entry>New master port number</entry>
+<!--
+ <entry>Port number of the new master node</entry>
+-->
+ <entry>新しいマスターノードのポート番号</entry>
</row>
<row>
<entry>%R</entry>
- <entry>New master database cluster directory</entry>
+<!--
+ <entry>Database cluster directory of the new master node</entry>
+-->
+ <entry>新しいマスターノードのデータベースクラスタパス</entry>
</row>
<row>
<entry>%%</entry>
+<!--
<entry> '%' character</entry>
+-->
+ <entry> '%'文字</entry>
</row>
</tbody>
@@ -80,16 +127,24 @@
<note>
<para>
+<!--
When a failover is performed, <productname>Pgpool-II</productname> kills all
its child processes, which will in turn terminate all the active sessions to
<productname>Pgpool-II</productname>. After that <productname>Pgpool-II</productname>
invokes the <command>failover_command</command> and after the command completion
<productname>Pgpool-II</productname> starts new child processes
which makes it ready again to accept client connections.
+-->
+フェイルオーバーが実行されると、<productname>Pgpool-II</productname>は子プロセスを切断します。
+これにより、<productname>Pgpool-II</productname>への全てのアクティブセッションが終了されます。
+その後、<productname>Pgpool-II</productname>は<command>failover_command</command>を実行し、コマンドが完了した後に<productname>Pgpool-II</productname>はクライアントからの接続を再び受け付ける準備のため新しい子プロセスを起動します。
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -97,14 +152,19 @@
<varlistentry id="guc-failback-command" xreflabel="failback_command">
<term><varname>failback_command</varname> (<type>string</type>)
<indexterm>
- <primary><varname>failback_command</varname> configuration parameter</primary>
+ <primary><varname>failback_command</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
- Specifies a user command to run when a PostgreSQL backend node gets attached to
- <productname>Pgpool-II</productname>, <productname>Pgpool-II</productname>
+<!--
+ Specifies a user command to run when a <productname>PostgreSQL</> backend node gets attached to
+ <productname>Pgpool-II</productname>. <productname>Pgpool-II</productname>
replaces the following special characters with the backend specific information.
+ before excuting the command.
+-->
+<productname>PostgreSQL</>バックエンドノードが<productname>Pgpool-II</productname>に復帰された時に実行するユーザコマンドを指定します。
+<productname>Pgpool-II</productname>はコマンド実行の前に、以下の特殊文字をバックエンドの具体的な情報に置き換えます。
</para>
<table id="ffailback-command-table">
@@ -112,55 +172,92 @@
<tgroup cols="2">
<thead>
<row>
+<!--
<entry>Special character</entry>
<entry>Description</entry>
+-->
+ <entry>特殊文字</entry>
+ <entry>説明</entry>
</row>
</thead>
<tbody>
<row>
<entry>%d</entry>
- <entry>Backend ID of a detached node</entry>
+<!--
+ <entry>DB node ID of the attached node</entry>
+-->
+ <entry>復帰したノードのDBノードID</entry>
</row>
<row>
<entry>%h</entry>
- <entry>Hostname of a detached node</entry>
+<!--
+ <entry>Hostname of the attached node</entry>
+-->
+ <entry>復帰したノードのホスト名</entry>
</row>
<row>
<entry>%p</entry>
- <entry>Port number of a detached node</entry>
+<!--
+ <entry>Port number of the attached node</entry>
+-->
+ <entry>復帰したノードのポート番号</entry>
</row>
<row>
<entry>%D</entry>
- <entry>Database cluster directory of a detached node</entry>
+<!--
+ <entry>Database cluster directory of the attached node</entry>
+-->
+ <entry>復帰したノードのデータベースクラスタパス</entry>
</row>
<row>
<entry>%M</entry>
+<!--
<entry>Old master node ID</entry>
+-->
+ <entry>古いマスターノードのID</entry>
</row>
<row>
<entry>%m</entry>
+<!--
<entry> New master node ID</entry>
+-->
+ <entry>新しいマスターノードのID</entry>
</row>
<row>
<entry>%H</entry>
+<!--
<entry>Hostname of the new master node</entry>
+-->
+ <entry>新しいマスターノードのホスト名</entry>
</row>
<row>
<entry>%P</entry>
+<!--
<entry> Old primary node ID</entry>
+-->
+ <entry>古いプライマリノードのID</entry>
</row>
<row>
<entry>%r</entry>
- <entry>New master port number</entry>
+<!--
+ <entry>Port number of the new master node</entry>
+-->
+ <entry>新しいマスターノードのポート番号</entry>
</row>
<row>
<entry>%R</entry>
- <entry>New master database cluster directory</entry>
+<!--
+ <entry>Database cluster directory of the new master node</entry>
+-->
+ <entry>新しいマスターノードのデータベースクラスタパス</entry>
</row>
<row>
<entry>%%</entry>
+<!--
<entry> '%' character</entry>
+-->
+ <entry> '%'文字</entry>
</row>
</tbody>
@@ -168,7 +265,10 @@
</table>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -176,16 +276,22 @@
<varlistentry id="guc-follow-master-command" xreflabel="follow_master_command">
<term><varname>follow_master_command</varname> (<type>string</type>)
<indexterm>
- <primary><varname>follow_master_command</varname> configuration parameter</primary>
+ <primary><varname>follow_master_command</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
- Specifies a user command to run in master/slave streaming replication mode
- after the master backend node failover.
- <productname>Pgpool-II</productname>, <productname>Pgpool-II</productname>
- replaces the following special characters with the backend specific information.
+<!--
+ Specifies a user command to run after failover on the primary node failover.
+ This works only in Master Replication mode with streaming replication.
+ <productname>Pgpool-II</productname> replaces the following special characters
+ with the backend specific information before excuting the command.
+-->
+プライマリノードのフェイルオーバー後に実行するユーザコマンドを指定します。
+この機能は、マスタースレーブモードでストリーミングレプリケーション構成の場合のみ有効です。
+<productname>Pgpool-II</productname>はコマンド実行の前に、以下の特殊文字をバックエンドの具体的な情報に置き換えます。
+
</para>
<table id="follow-master-command-table">
@@ -193,75 +299,124 @@
<tgroup cols="2">
<thead>
<row>
+<!--
<entry>Special character</entry>
<entry>Description</entry>
+-->
+ <entry>特殊文字</entry>
+ <entry>説明</entry>
</row>
</thead>
<tbody>
<row>
<entry>%d</entry>
- <entry>Backend ID of a detached node</entry>
+<!--
+ <entry>DB node ID of the detached node</entry>
+-->
+ <entry>切り離されたノードのDBノードID</entry>
</row>
<row>
<entry>%h</entry>
- <entry>Hostname of a detached node</entry>
+<!--
+ <entry>Hostname of the detached node</entry>
+-->
+ <entry>切り離されたノードのホスト名</entry>
</row>
<row>
<entry>%p</entry>
- <entry>Port number of a detached node</entry>
+<!--
+ <entry>Port number of the detached node</entry>
+-->
+ <entry>切り離されたノードのポート番号</entry>
</row>
<row>
<entry>%D</entry>
- <entry>Database cluster directory of a detached node</entry>
+<!--
+ <entry>Database cluster directory of the detached node</entry>
+-->
+ <entry>切り離されたノードのデータベースクラスタパス</entry>
</row>
<row>
<entry>%M</entry>
+<!--
<entry>Old master node ID</entry>
+-->
+ <entry>古いマスターノードのID</entry>
</row>
<row>
<entry>%m</entry>
+<!--
<entry> New master node ID</entry>
+-->
+ <entry>新しいマスターノードのID</entry>
</row>
<row>
<entry>%H</entry>
+<!--
<entry>Hostname of the new master node</entry>
+-->
+ <entry>新しいマスターノードのホスト名</entry>
</row>
<row>
<entry>%P</entry>
+<!--
<entry> Old primary node ID</entry>
+-->
+ <entry>古いプライマリノードのID</entry>
</row>
<row>
<entry>%r</entry>
- <entry>New master port number</entry>
+<!--
+ <entry>Port number of the new master node</entry>
+-->
+ <entry>新しいマスターノードのポート番号</entry>
</row>
<row>
<entry>%R</entry>
- <entry>New master database cluster directory</entry>
+<!--
+ <entry>Database cluster directory of the new master node</entry>
+-->
+ <entry>新しいマスターノードのデータベースクラスタパス</entry>
</row>
<row>
<entry>%%</entry>
+<!--
<entry> '%' character</entry>
+-->
+ <entry> '%'文字</entry>
</row>
</tbody>
</tgroup>
</table>
+ <note>
<para>
- If <xref linkend="guc-follow-master-command"> is not left out empty, then when
- a master node failover gets completed in master/slave streaming replication mode,
- <productname>Pgpool-II</productname> degenerates all nodes excepted the new master
+<!--
+ If <varname>follow_master_command</varname>> is not empty, then after failover
+ on the primary node gets completed in Master Slave mode with streaming replication,
+ <productname>Pgpool-II</productname> degenerates all nodes excepted the new primary
and starts new child processes to be ready again to accept connections from the clients.
After this, <productname>Pgpool-II</productname> executes the command configured
- in the <xref linkend="guc-follow-master-command"> for each degenerated backend nodes.
+ in the <varname>follow_master_command</varname> for each degenerated backend nodes.
+-->
+<varname>follow_master_command</varname>が空文字列でない場合、ストリーミングレプリケーションによるマスタースレーブでプライマリノードのフェイルオーバーが完了した後に、<productname>Pgpool-II</productname>は新しいプライマリ以外のすべてのノードを切り離し、クライアントから再び接続を受け付ける準備のため再度新しい子プロセスを起動します。
+その後、<productname>Pgpool-II</productname>は切り離されたそれぞれのノードに対して<varname>follow_master_command</varname>に設定したコマンドを実行します。
</para>
+ </note>
<para>
- Typically <xref linkend="guc-follow-master-command"> command is used to recover
- the slave from the new master by calling the pcp_recovery_node command.
+<!--
+ Typically <varname>follow_master_command</varname>> command is used to recover
+ the slave from the new primary by calling the pcp_recovery_node command.
+-->
+通常は、<varname>follow_master_command</varname>コマンドは<xref linkend="PCP-RECOVERY-NODE">コマンドを呼んで新しいプライマリからスレーブをリカバリするために使用します。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -269,29 +424,40 @@
<varlistentry id="guc-fail-over-on-backend-error" xreflabel="fail_over_on_backend_error">
<term><varname>fail_over_on_backend_error</varname> (<type>boolean</type>)
<indexterm>
- <primary><varname>fail_over_on_backend_error</varname> configuration parameter</primary>
+ <primary><varname>fail_over_on_backend_error</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
When set to on, <productname>Pgpool-II</productname> considers the reading/writing
- errors on the PostgreSQL backend connection as the backend node failure and trigger the
+ errors on the <productname>PostgreSQL</> backend connection as the backend node failure, and trigger the
failover on that node after disconnecting the current session.
When this is set to off, <productname>Pgpool-II</productname> only report an error
and disconnect the session in case of such errors.
+-->
+onに設定した場合、<productname>Pgpool-II</productname>は<productname>PostgreSQL</>バックエンド接続からの読み出し、書き込みのエラーをバックエンドノードの故障と見なし、現在のセッションを切断した後にそのノードをフェイルオーバします。
+offに設定した場合、そのようなエラーの場合でも<productname>Pgpool-II</productname>は単にエラーをレポートしセッションが切断するのみです。
</para>
<note>
<para>
+<!--
It is recommended to turn on the backend health checking
(see <xref linkend="runtime-config-health-check">)
- when <xref linkend="guc-fail-over-on-backend-error"> is set to off.
- However, <productname>Pgpool-II</productname> still triggers the
+ when <varname>fail_over_on_backend_error</varname> is set to off.
+ Note, however, that <productname>Pgpool-II</productname> still triggers the
failover when it detects the administrative shutdown of
- PostgreSQL backend server.
+ <productname>PostgreSQL</> backend server.
+-->
+<varname>fail_over_on_backend_error</varname>をoffにする場合は、バックエンドのヘルスチェックを有効にすることをお勧めします（<xref linkend="runtime-config-health-check">をご覧ください）。
+なお、<productname>PostgreSQL</>バックエンドサーバが管理コマンドでシャットダウンされたことを<productname>Pgpool-II</productname>が検知した場合には依然としてフェイルオーバが起こることに注意してください。
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -299,22 +465,34 @@
<varlistentry id="guc-search-primary-node-timeout" xreflabel="search_primary_node_timeout">
<term><varname>search_primary_node_timeout</varname> (<type>integer</type>)
<indexterm>
- <primary><varname>search_primary_node_timeout</varname> configuration parameter</primary>
+ <primary><varname>search_primary_node_timeout</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the maximum amount of time in seconds to search for the
primary node when a failover scenario occurs.
<productname>Pgpool-II</productname> will give up looking for the primary
node if it is not found with-in this configured time.
- Default is 10 and Setting this parameter to 0 means keep trying forever.
+ Default is 300. Setting this parameter to 0 means keep trying forever.
+-->
+フェイルオーバが起きた時にプライマリノードを検索するための最大時間を秒単位で指定します。
+<productname>Pgpool-II</productname>は、ここで設定したした時間の間にプライマリノードを見つけられなかった場合、探すのを諦めます。
+デフォルト値は300です。
+0を指定すると、永久に検索し続けます。
</para>
<para>
- This parameter is only applicable in the streaming replication mode.
+<!--
+ This parameter is only applicable in Master Slave mode with streaming replication.
+-->
+このパラメータはストリーミングレプリケーションによるマスタースレーブモードの場合のみ有効です。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
diff --git a/doc.ja/src/sgml/memcache.sgml b/doc.ja/src/sgml/memcache.sgml
index 8be0fd9f1..9213af256 100644
--- a/doc.ja/src/sgml/memcache.sgml
+++ b/doc.ja/src/sgml/memcache.sgml
@@ -1,36 +1,56 @@
<!-- doc/src/sgml/config.sgml -->
<sect1 id="runtime-in-memory-query-cache">
+<!--
<title>In Memory Query Cache</title>
+-->
+ <title>インメモリキャッシュ</title>
<para>
+<!--
In memory query cache can be used with all modes of
<productname>Pgpool-II</productname>. It is different
- from the query cache on the point that in memory query
+ from the query cache on disk that In memory query
cache is faster because of the in memory nature of the storage.
Moreover <productname>Pgpool-II</productname> does not
need a restart when the cache gets outdated because of
the underlying table updates.
+-->
+<productname>Pgpool-II</productname>の全てのモードでインメモリクエリキャッシュを利用することができます。
+ディスク上のクエリキャッシュと違い、メモリ上にキャッシュが置かれる特性上高速です。
+また、テーブルが更新によりキャッシュが古くなっても、<productname>Pgpool-II</>の再起動の必要がありません。
</para>
<para>
+<!--
In memory cache saves the pair of SELECT statement
and its result
(along with the Bind parameters, if the SELECT is an
extended query). If the same SELECTs comes in,
<productname>Pgpool-II</productname> returns the value
from cache. Since no <acronym>SQL</acronym> parsing nor
- access to PostgreSQL are involved, the serving of results
+ access to <productname>PostgreSQL</> are involved, the serving of results
from the in memory cache is extremely fast.
+-->
+インメモリクエリキャッシュは、SELECT文(拡張問い合わせの場合は更にバインドパラメータ)と 検索結果をペアで記録します。
+同じSELECT文が発行された場合に、<productname>Pgpool-II</productname>はキャッシュから結果を返します。
+<acronym>SQL</acronym>の解析も<productname>PostgreSQL</>へのアクセスも行われないため、インメモリキャッシュからの結果の提供は非常に高速です。
+
</para>
<para>
+<!--
On the other hand, it might be slower than the normal path
in some cases, because it adds some overhead to store cache.
Moreover when a table is updated, <productname>Pgpool-II
</productname> automatically deletes all the caches related
- to the table. So the performance will be degraded by a system
+ to the table. Therefore, the performance will be degraded by a system
with a lot of updates.
If the cache_hit_ratio is lower than 70%, you might want
to disable in memory cache.
+-->
+反面、キャッシュをストアするオーバヘッドが生じるので、通常の方法より遅くなる場合も有ります。
+また、あるテーブルが更新された場合、<productname>Pgpool-II</productname>は自動的にそのテーブルに関係する全てのキャッシュを削除します。
+そのため、更新が多いシステムではパフォーマンスが悪くなります。
+キャッシュのヒット率が70%以下の場合は、インメモリクエリキャッシュ無効にしたほうがいいかもしれません。
</para>
<sect2 id="runtime-in-memory-query-cache-enabling">
@@ -41,16 +61,26 @@
<varlistentry id="guc-memory-cache-enabled" xreflabel="memory_cache_enabled">
<term><varname>memory_cache_enabled</varname> (<type>boolean</type>)
<indexterm>
+<!--
<primary><varname>memory_cache_enabled</varname> configuration parameter</primary>
+-->
+ <primary><varname>memory_cache_enabled</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Setting to on enables the memory cache.
Default is off.
+-->
+onにするとメモリキャッシュが有効になります。
+デフォルトはoffです。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -58,20 +88,30 @@
</sect2>
<sect2 id="runtime-in-memory-query-cache-choose-storage">
+<!--
<title>Choosing cache storage</title>
+-->
+ <title>キャッシュストレージの選択</title>
<variablelist>
<varlistentry id="guc-memqcache-method" xreflabel="memqcache_method">
<term><varname>memqcache_method</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>memqcache_method</varname> configuration parameter</primary>
+-->
+ <primary><varname>memqcache_method</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the storage type to be used for the cache.
Below table contains the list of all valid values for the parameter.
+-->
+キャッシュに用いるストレージのタイプを指定します。
+このパラメータで有効な全ての値のリストを以下の表に示します。
</para>
<table id="memqcache-method-table">
@@ -79,20 +119,30 @@
<tgroup cols="2">
<thead>
<row>
+<!--
<entry>Value</entry>
<entry>Description</entry>
+-->
+ <entry>値</entry>
+ <entry>説明</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>'shmem'</literal></entry>
+<!--
<entry>Use shared memory</entry>
+-->
+ <entry>共有メモリを使用</entry>
</row>
<row>
<entry><literal>'memcached'</literal></entry>
+<!--
<entry>Use <ulink url="http://memcached.org/">memcached</ulink></entry>
+-->
+ <entry><ulink url="http://memcached.org/">memcached</ulink>を使用</entry>
</row>
</tbody>
@@ -100,11 +150,17 @@
</table>
<para>
+<!--
Default is <literal>'shmem'</literal>.
+-->
+デフォルトは<literal>'shmem'</literal>です。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
@@ -112,33 +168,52 @@
</sect2>
<sect2 id="runtime-in-memory-query-cache-config">
+<!--
<title>Common configurations</title>
+-->
+ <title>共通設定</title>
<para>
+<!--
These below parameter are valid for both <literal>shmem</literal>
and <literal>memcached</literal> type query cache.
+-->
+以下は<literal>shmem</literal>と<literal>memcached</literal>の両タイプのクエリキャッシュで有効なパラメータです。
</para>
<variablelist>
<varlistentry id="guc-memqcacheexpire" xreflabel="memqcache_expire">
<term><varname>memqcache_expire</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>memqcache_expire</varname> configuration parameter</primary>
+-->
+ <primary><varname>memqcache_expire</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the life time of query cache in seconds.
Default is 0. which means no cache expiration and cache remains
valid until the table is updated.
+-->
+クエリキャッシュの寿命を秒単位で設定します。
+デフォルト0で、キャッシュの期限はなくなり、関連テーブルが更新されるまではキャッシュが有効になります。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
<note>
<para>
- This parameters <xref linkend="guc-memqcacheexpire"> and
+<!--
+ <varname>memqcache_expire</varname> and
<xref linkend="guc-memqcache-auto-cache-invalidation"> are orthogonal to each other.
+-->
+<varname>memqcache_expire</varname>と<xref linkend="guc-memqcache-auto-cache-invalidation">は互いに独立です。
</para>
</note>
@@ -148,25 +223,41 @@
<varlistentry id="guc-memqcache-auto-cache-invalidation" xreflabel="memqcache_auto_cache_invalidation">
<term><varname>memqcache_auto_cache_invalidation</varname> (<type>boolean</type>)
<indexterm>
+<!--
<primary><varname>memqcache_auto_cache_invalidation</varname> configuration parameter</primary>
+-->
+ <primary><varname>memqcache_auto_cache_invalidation</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Setting to on, automatically deletes the cache related to the updated tables.
When off, cache is not deleted.
+-->
+onに設定した場合、更新されたテーブルに関連するキャッシュを自動で削除します。
+offならばキャッシュは削除されません。
</para>
<para>
+<!--
Default is on.
+-->
+デフォルト値はonです。
</para>
<note>
<para>
- This parameters <xref linkend="guc-memqcache-auto-cache-invalidation">
+<!--
+ <varname>memqcache_auto_cache_invalidation</varname>
and <xref linkend="guc-memqcacheexpire"> are orthogonal to each other.
+-->
+<varname>memqcache_auto_cache_invalidation</varname>と<xref linkend="guc-memqcacheexpire">は互いに独立です。
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -174,30 +265,44 @@
<varlistentry id="guc-memqcache-maxcache" xreflabel="memqcache_maxcache">
<term><varname>memqcache_maxcache</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>memqcache_maxcache</varname> configuration parameter</primary>
+-->
+ <primary><varname>memqcache_maxcache</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the maximum size in bytes of the SELECT query result to be cached.
The result with data size larger than this value will not be cached by
<productname>Pgpool-II</productname>.
- And when the caching of data is rejected because of the size constraint the following
+ When the caching of data is rejected because of the size constraint the following
message is shown.
+-->
+キャッシュされるSELECTクエリ結果の最大サイズをバイト数で指定します。
+この値より大きいサイズのデータの結果は<productname>Pgpool-II</productname>にキャッシュされません。
+サイズの制約によりデータのキャッシュができなかった場合、以下のメッセージが表示されます。
<programlisting>
LOG: pid 13756: pool_add_temp_query_cache: data size exceeds memqcache_maxcache. current:4095 requested:111 memq_maxcache:4096
</programlisting>
</para>
<note>
<para>
+<!--
For the shared memory query(<literal>'shmem'</literal>) cache the
<varname>memqcache_maxcache</varname> must be set lower than
<xref linkend="guc-memqcache-cache-block-size"> and for <literal>'memcached'</literal>
it must be lower than the size of slab (default is 1 MB).
+-->
+共有メモリによるクエリキャッシュ（<literal>'shmem'</literal>）の場合は、<varname>memqcache_maxcache</varname>は<xref linkend="guc-memqcache-cache-block-size">を超えないように、<literal>'memcached'</literal>を使用する場合は、slabのサイズ(デフォルトで1MB)を超えないようにしてください。
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -205,26 +310,38 @@ LOG: pid 13756: pool_add_temp_query_cache: data size exceeds memqcache_maxcach
<varlistentry id="guc-white-memqcache-table-list" xreflabel="white_memqcache_table_list">
<term><varname>white_memqcache_table_list</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>white_memqcache_table_list</varname> configuration parameter</primary>
+-->
+ <primary><varname>white_memqcache_table_list</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies a comma separated list of table names whose SELECT
results should be cached by the <productname>Pgpool-II</productname>.
+-->
+SELECT結果が<productname>Pgpool-II</productname>にキャッシュされるべきテーブル名のリストをカンマ区切りで指定します。
</para>
<para>
+<!--
You can use regular expression into the list to match table name
- (to which ^ and $ are automatically added),
+ (to which ^ and $ are automatically added).
+-->
+テーブル名のマッチングには正規表現も利用できます （指定した各表現に ^ と $ をつけた形で使われます）。
</para>
<note>
<para>
+<!--
If the queries can refer the table with and without the schema
qualification then you must add both entries(with and without
schema name) in the list.
+-->
+スキーマ名を付けないテーブル名とスキーマ名を付けた形の両方をクエリの中で使う場合は、両方共リストに登録してください。
<programlisting>
#For example:
#If the queries sometime use "table1" and other times "public.table1"
@@ -239,12 +356,18 @@ white_memqcache_table_list = "table1,public.table1"
</note>
<note>
<para>
- <varname>white_memqcache_table_list</varname> white_memqcache_table_list takes
+<!--
+ <varname>white_memqcache_table_list</varname> takes
precedence over <xref linkend="guc-black-memqcache-table-list">
+-->
+<varname>white_memqcache_table_list</varname>は<xref linkend="guc-black-memqcache-table-list">より優先されます。
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -252,26 +375,38 @@ white_memqcache_table_list = "table1,public.table1"
<varlistentry id="guc-black-memqcache-table-list" xreflabel="black_memqcache_table_list">
<term><varname>black_memqcache_table_list</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>black_memqcache_table_list</varname> configuration parameter</primary>
+-->
+ <primary><varname>black_memqcache_table_list</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies a comma separated list of table names whose SELECT
results should <emphasis>NOT</emphasis> be cached by the <productname>
Pgpool-II</productname>.
+-->
+SELECT結果が<productname>Pgpool-II</productname>にキャッシュされる<emphasis>べきでない</emphasis>テーブル名のリストをカンマ区切りで指定します。
</para>
<para>
+<!--
You can use regular expression into the list to match table name
(to which ^ and $ are automatically added),
+-->
+テーブル名のマッチングには正規表現も利用できます （指定した各表現に ^ と $ をつけた形で使われます）。
</para>
<note>
<para>
+<!--
If the queries can refer the table with and without the schema
qualification then you must add both entries(with and without
schema name) in the list.
+-->
+スキーマ名を付けないテーブル名とスキーマ名を付けた形の両方をクエリの中で使う場合は、両方共リストに登録してください。
<programlisting>
#For example:
#If the queries sometime use "table1" and other times "public.table1"
@@ -285,7 +420,10 @@ black_function_list = "table1,public.table1"
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -293,30 +431,50 @@ black_function_list = "table1,public.table1"
<varlistentry id="guc-memqcache-oiddir" xreflabel="memqcache_oiddir">
<term><varname>memqcache_oiddir</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>memqcache_oiddir</varname> configuration parameter</primary>
+-->
+ <primary><varname>memqcache_oiddir</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the full path to the directory for storing the
<literal>oids</literal> of tables used by SELECT queries.
+-->
+SELECTクエリが使用するテーブルに<literal>OID</literal>を格納するディレクトリへのフルパスで指定します。
+
</para>
<para>
+<!--
<varname>memqcache_oiddir</varname> directory contains the sub directories
- for the databases. The directory name is the OID of the database, And each
+ for the databases. The directory name is the OID of the database. In addition, each
database directory contains the files for each table used by SELECT statement.
Again the name of the file is the OID of the table.
These files contains the pointers to query cache which are used as key for
deleting the caches.
+-->
+<varname>memqcache_oiddir</varname>には、各データベースのためのディレクトリが格納されます。
+そのディレクトリ名はデータベースのOIDです。
+更に、各データベースディレクトリその下には各テーブルの「ためのファイルが格納されます。
+そのファイル名は同じくテーブルのOIDです。
+これらのファイルの中にはクエリキャッシュへのポインタが格納されており、 キャッシュを削除する際のキーとして使われます。
</para>
<note>
<para>
+<!--
Normal restart of <productname>Pgpool-II</productname> does not clear the
contents of <varname>memqcache_oiddir</varname>.
+-->
+<productname>Pgpool-II</productname>の通常の再起動では<varname>memqcache_oiddir</varname>の中身はクリアされません。
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -325,10 +483,16 @@ black_function_list = "table1,public.table1"
</sect2>
<sect2 id="runtime-in-memory-query-cache-shmem-config">
+<!--
<title>Configurations to use shared memory</title>
+-->
+ <title>共有メモリ使用時の設定</title>
<para>
+<!--
These are the parameters used with shared memory as the cache storage.
+-->
+これらはキャッシュストレージとして共有メモリを使用した場合に使われるパラメーターです。
</para>
<variablelist>
@@ -336,15 +500,24 @@ black_function_list = "table1,public.table1"
<varlistentry id="guc-memqcache-total-size" xreflabel="memqcache_total_size">
<term><varname>memqcache_total_size</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>memqcache_total_size</varname> configuration parameter</primary>
+-->
+ <primary><varname>memqcache_total_size</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the shared memory cache size in bytes.
+-->
+共有メモリのキャッシュサイズをバイト単位で指定します。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
@@ -352,23 +525,38 @@ black_function_list = "table1,public.table1"
<varlistentry id="guc-memqcache-max-num-cache" xreflabel="memqcache_max_num_cache">
<term><varname>memqcache_max_num_cache</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>memqcache_max_num_cache</varname> configuration parameter</primary>
+-->
+ <primary><varname>memqcache_max_num_cache</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the number of cache entries. This is used to define the size of cache management space.
+-->
+キャッシュエントリの数を指定します。
+この設定項目は、キャッシュの管理領域の大きさを決めるために使用します。
</para>
<note>
<para>
+<!--
The management space size can be calculated by:
<varname>memqcache_max_num_cache</varname> * 48 bytes.
Too small number will cause an error while registering cache.
On the other hand too large number will just waste space.
+-->
+管理領域の大きさは、<varname>memqcache_max_num_cache</varname> * 48バイトで計算できます。
+少なすぎるとキャッシュを登録することができずにエラーになります。
+逆に多すぎると単に空間の無駄になります。
</para>
</note>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
@@ -376,24 +564,39 @@ black_function_list = "table1,public.table1"
<varlistentry id="guc-memqcache-cache-block-size" xreflabel="memqcache_cache_block_size">
<term><varname>memqcache_cache_block_size</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>memqcache_cache_block_size</varname> configuration parameter</primary>
+-->
+ <primary><varname>memqcache_cache_block_size</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the cache block size. <productname>Pgpool-II</productname> uses the
cache memory arranged in <varname>memqcache_cache_block_size</varname> blocks.
SELECT result is packed into the block and must fit in a single block.
- And the results larger than <varname>memqcache_cache_block_size</varname> are
+ Therefore, the results larger than <varname>memqcache_cache_block_size</varname> are
not cached.
+-->
+キャッシュのブロックサイズを指定します。
+<productname>Pgpool-II</productname>は<varname>memqcache_cache_block_size</varname>のブロックで管理されたキャッシュメモリを利用します。
+SELECT結果はこのブロックに詰め込まれ、１つのブロックに収まらなければなりません。
+従って、<varname>memqcache_cache_block_size</varname>を検索結果が超えると、キャッシュされません。。
</para>
<para>
+<!--
<varname>memqcache_cache_block_size</varname> must be set to atleast 512.
+-->
+<varname>memqcache_cache_block_size</varname>は、512以上の値でなければなりません。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
@@ -402,10 +605,16 @@ black_function_list = "table1,public.table1"
</sect2>
<sect2 id="runtime-in-memory-query-cache-memcached-config">
+<!--
<title>Configurations to use memcached</title>
+-->
+ <title>memcached使用時の設定</title>
<para>
+<!--
These are the parameters used with memcached as the cache storage.
+-->
+これらはキャッシュストレージとしてmemcachedを使用した場合に使われるパラメーターです。
</para>
<variablelist>
@@ -413,17 +622,27 @@ black_function_list = "table1,public.table1"
<varlistentry id="guc-memqcache-memcached-host" xreflabel="memqcache_memcached_host">
<term><varname>memqcache_memcached_host</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>memqcache_memcached_host</varname> configuration parameter</primary>
+-->
+ <primary><varname>memqcache_memcached_host</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the host name or the IP address on which <literal>memcached</literal>
works. You can use <literal>'localhost'</literal> if <literal>memcached</literal>
and <productname>Pgpool-II</productname> resides on same server.
+-->
+<literal>memcached</literal>が動いているホスト名またはIPアドレスを指定します。
+<productname>Pgpool-II</productname>と同じマシンで<literal>memcached</literal>を動かす場合は、<literal>'localhost'</literal>が使えます。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
@@ -431,16 +650,27 @@ black_function_list = "table1,public.table1"
<varlistentry id="guc-memqcache-memcached-port" xreflabel="memqcache_memcached_port">
<term><varname>memqcache_memcached_port</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>memqcache_memcached_port</varname> configuration parameter</primary>
+-->
+ <primary><varname>memqcache_memcached_port</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the port number of <acronym>memcached</acronym>.
Default is 11211.
+-->
+<acronym>memcached</acronym>のポート番号を指定します。
+デフォルトは 11211 です。
+
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
diff --git a/doc.ja/src/sgml/misc-config.sgml b/doc.ja/src/sgml/misc-config.sgml
index 36080d94a..ec0406c8b 100644
--- a/doc.ja/src/sgml/misc-config.sgml
+++ b/doc.ja/src/sgml/misc-config.sgml
@@ -1,22 +1,29 @@
<!-- doc/src/sgml/config.sgml -->
<sect1 id="runtime-misc">
+<!--
<title>Misc Configuration Parameters</title>
+-->
+ <title>その他の設定パラメータ</title>
<variablelist>
<varlistentry id="guc-relcache-expire" xreflabel="relcache_expire">
<term><varname>relcache_expire</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>relcache_expire</varname> configuration parameter</primary>
+-->
+ <primary><varname>relcache_expire</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the relation cache expiration time in seconds.
The relation cache is used for caching the query result of
- PostgreSQL system catalogs that is used by <productname>Pgpool-II
+ <productname>PostgreSQL</> system catalogs that is used by <productname>Pgpool-II
</productname> to get various informations including the table
structures and to check table types(e.g. To check if the referred
table is a temporary table or not). The cache is maintained in
@@ -27,10 +34,20 @@
For this purpose, <varname>relcache_expire</varname> controls
the life time of the cache.
Default is 0, which means the cache never expires.
+-->
+リレーションキャッシュの寿命を秒単位で指定します。
+リレーションキャッシュは、<productname>Pgpool-II</productname>がテーブルの構造を含む様々な情報を取得したり、テーブルのタイプ（たとえば、参照されているテーブルが一時テーブルかどうかなど）をチェックするために使う<productname>PostgreSQL</>のシステムカタログの問い合わせ結果を保存しておくものです。
+キャッシュはpgpoolの子プロセスのローカルメモリ空間に保管されています。
+もし<command>ALTER TABLE</command>でテーブルが変更された場合などは、リレーションキャッシュと一致しなくなります。
+そのため、<varname>relcache_expire</varname>がキャッシュの寿命をコントロールしています。
+デフォルトは0で、キャッシュの期限が切れることはありません。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータは、サーバ起動時にのみ設定できます。
</para>
</listitem>
@@ -39,27 +56,40 @@
<varlistentry id="guc-relcache-size" xreflabel="relcache_size">
<term><varname>relcache_size</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>relcache_size</varname> configuration parameter</primary>
+-->
+ <primary><varname>relcache_size</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the number of relcache entries.
Default is 256.
+-->
+リレーションキャッシュのサイズを指定します。
+デフォルトは256です。
</para>
<note>
<para>
+<!--
If the below message frequently appears in the
- <productname>Pgpool-II</productname> log, You may need to
+ <productname>Pgpool-II</productname> log, you may need to
increase the <varname>relcache_size</varname> for better performance.
+-->
+もし以下のようなメッセージが<productname>Pgpool-II</productname>ログに頻繁に出る場合は、パフォーマンス向上のため<varname>relcache_size</varname>を大きくしてください。
<programlisting>
"pool_search_relcache: cache replacement happened"
</programlisting>
</para>
</note>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータは、サーバ起動時にのみ設定できます。
</para>
</listitem>
@@ -68,25 +98,38 @@
<varlistentry id="guc-check-temp-table" xreflabel="check_temp_table">
<term><varname>check_temp_table</varname> (<type>boolean</type>)
<indexterm>
+<!--
<primary><varname>check_temp_table</varname> configuration parameter</primary>
+-->
+ <primary><varname>check_temp_table</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Setting to on, enables the temporary table check in the <acronym>SELECT</acronym>
statements. To check the temporary table <productname>Pgpool-II</productname>
- queries the system catalog of primary/master PostgreSQL backend which increases
+ queries the system catalog of primary/master <productname>PostgreSQL</> backend, which increases
the load on the primary/master server.
If you are absolutely sure that your system never uses temporary tables, then
you can safely turn off the <varname>check_temp_table</varname>.
Default is on.
+-->
+onに設定されたとき、<acronym>SELECT</acronym>に含まれるテーブルが一時テーブルかどうかのチェックを行います。
+一時テーブルをチェックするため<productname>Pgpool-II</productname>はプライマリ/マスター<productname>PostgreSQL</>バックエンドのシステムカタログに問い合わせ、プライマリ/マスタサーバの負荷を上げます。
+もしシステムが決して一時テーブルを使用しないことが確かならば、安全に<varname>check_tmp_table</varname>をoffにすることができます。
+デフォルトはonです。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
this parameter for a current session.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
+現在のセッションでのパラメータ値は、<xref linkend="SQL-PGPOOL-SET">コマンドで変更することもできます。
</para>
</listitem>
@@ -95,26 +138,39 @@
<varlistentry id="guc-check-unlogged-table" xreflabel="check_unlogged_table">
<term><varname>check_unlogged_table</varname> (<type>boolean</type>)
<indexterm>
+<!--
<primary><varname>check_unlogged_table</varname> configuration parameter</primary>
+-->
+ <primary><varname>check_unlogged_table</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Setting to on, enables the unlogged table check in the <acronym>SELECT</acronym>
statements. To check the unlogged table <productname>Pgpool-II</productname>
- queries the system catalog of primary/master PostgreSQL backend which increases
+ queries the system catalog of primary/master <productname>PostgreSQL</> backend which increases
the load on the primary/master server.
If you are absolutely sure that your system never uses the unlogged tables
- (for example, you are using 9.0 or earlier version of PostgreSQL) then you
- can safely turn off the <varname>check_unlogged_table</varname>..
+ (for example, you are using 9.0 or earlier version of <productname>PostgreSQL</>) then you
+ can safely turn off the <varname>check_unlogged_table</varname>.
Default is on.
+-->
+onに設定されたとき、<acronym>SELECT</acronym>に含まれるテーブルがunloggedテーブルかどうかのチェックを行います。
+unloggedテーブルをチェックするため<productname>Pgpool-II</productname>はプライマリ/マスター<productname>PostgreSQL</>バックエンドのシステムカタログに問い合わせ、プライマリ/マスタサーバの負荷を上げます。
+もしシステムが決してunloggedテーブルを使用しないことが確かならば（たとえば、9.0 以前のバージョンの<productname>PostgreSQL</>を使っている）、安全に<varname>check_unlogged_table</varname>をoffにすることができます。
+デフォルトはonです。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
this parameter for a current session.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
+現在のセッションでのパラメータ値は、<xref linkend="SQL-PGPOOL-SET">コマンドで変更することもできます。
</para>
</listitem>
@@ -123,19 +179,29 @@
<varlistentry id="guc-pid-file-name" xreflabel="pid_file_name">
<term><varname>pid_file_name</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>pid_file_name</varname> configuration parameter</primary>
+-->
+ <primary><varname>pid_file_name</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the full path to a file to store the <productname>Pgpool-II
</productname> process id.
Default is <literal>"/var/run/pgpool/pgpool.pid"</literal>.
+-->
+<productname>Pgpool-II</productname>のプロセスIDを格納するファイルのフルパスを指定します。
+デフォルトは<literal>'/var/run/pgpool/pgpool.pid'</literal>です。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータは、サーバ起動時にのみ設定できます。
</para>
</listitem>
@@ -144,18 +210,28 @@
<varlistentry id="guc-logdir" xreflabel="logdir">
<term><varname>logdir</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>logdir</varname> configuration parameter</primary>
+-->
+ <primary><varname>logdir</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the full path to a directory to store the <literal>pool_status</literal>.
Default is <literal>"/tmp"</literal>.
+-->
+<literal>pool_status</literal>ファイルが書かれます。を格納するディレクトリのフルパスを指定します。
+デフォルトは<literal>"/tmp"</literal>です。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータは、サーバ起動時にのみ設定できます。
</para>
</listitem>
diff --git a/doc.ja/src/sgml/online-recovery.sgml b/doc.ja/src/sgml/online-recovery.sgml
index 08cd056d3..76532290b 100644
--- a/doc.ja/src/sgml/online-recovery.sgml
+++ b/doc.ja/src/sgml/online-recovery.sgml
@@ -1,47 +1,73 @@
<!-- doc/src/sgml/config.sgml -->
<sect1 id="runtime-online-recovery">
+<!--
<title>Online Recovery</title>
+-->
+ <title>オンラインリカバリ</title>
<para>
- <productname>Pgpool-II</productname>, when in replication mode,
- can sync a database and attach a node while still servicing the clients.
+<!--
+ <productname>Pgpool-II</productname> can synchronize database nodes and attach
+ a node without stopping the service.
This feature is called <acronym>"online recovery"</acronym>.
+-->
+<productname>Pgpool-II</productname> はサービスを止めることなくデータベースノード同期させ、ノードを復帰させることができます。
+この機能は「<acronym>オンラインリカバリ</acronym>」と呼ばれます。
</para>
<para>
- For online recovery, a recovery target node must be in the detached state.
- And if you wish to add a PostgreSQL server dynamically, reload the
+<!--
+ For online recovery, the recovery target node must be detached from <productname>Pgpool-II</>.
+ If you wish to add a <productname>PostgreSQL</> server node dynamically, reload the
<filename>pgpool.conf</filename> after adding the
<xref linkend="guc-backend-hostname"> and its associated parameters.
- This is how the <productname>Pgpool-II</productname> will register this
- new node as a detached backend node.
+ This will register the new server to <productname>Pgpool-II</productname> as a detached backend node.
+-->
+オンラインリカバリを実施するためには、リカバリ対象のノードは<productname>Pgpool-II</>から切り離されている必要があります。
+新しい<productname>PostgreSQL</>サーバを動的に追加したい場合には、<xref linkend="guc-backend-hostname">および関連パラメータを追加した後に<filename>pgpool.conf</filename>を再読み込みします。
+これにより新しいサーバが切り離された状態のバックエンドノードとして<productname>Pgpool-II</productname>に登録されます。
</para>
+<!--
<caution>
<para>
Make sure that <command>autovacuum</command> is stopped on the
master node (the first node which is up and running) before starting the
online recovery. Autovacuum can change the contents of the database which
can cause the inconsistency after the online recovery.
+オンラインリカバリを実行する前に、マスタノード(稼働中のノードのうち、一番番号が若いノード)上での<command>autovacuum</command>を停止してください。
+オンラインリカバリ中に<command>autovacuum</command>が動作すると、データベースの内容が変化する可能性があるため、ノード間の同期がきちんと取れなくなる可能性があります。
</para>
<para>
This applies only if you're recovering with a simple copy mechanism,
such as the <command>rsync</command> and doesn't apply when using
the PostgreSQL's PITR mechanism.
+この制限は、<command>rsync</command>などの単純なコピー方法を使っている場合にのみ適用されます。
+PostgreSQLのPITRを使っている場合は適用されません。
</para>
</caution>
+-->
<note>
<para>
- The target PostgreSQL server must not be running for performing the online recovery.
- If the target PostgreSQL server has already started, you must shut it down before
+<!--
+ The recovery target <productname>PostgreSQL</> server must not be running for performing the online recovery.
+ If the target <productname>PostgreSQL</> server has already started, you must shut it down before
starting the online recovery.
+-->
+オンラインリカバリ実行のためには、対象となる<productname>PostgreSQL</>サーバは稼働していてはいけません。
+対象の<productname>PostgreSQL</>がすでに動作中であれば、オンラインリカバリを開始する前にシャットダウンしておいてください。
</para>
</note>
<para>
- online recovery is performed in two phases, and client connections are
- not allowd only in second phase of online recovery while the data can be
+<!--
+ Online recovery is performed in two phases. Connections from cliens are
+ not allowd in second phase of online recovery while the data can be
updated or retrieved during the first phase.
<productname>Pgpool-II</productname> performs the follows steps in online recovery:
+-->
+オンラインリカバリは2段階に分けて実施されます。
+ファーストステージではデータの更新や読み取りができますが、セカンドステージではクライアントからの接続は許されていません。
+オンラインリカバリでは<productname>Pgpool-II</productname>は以下の手順を実施します。
</para>
<itemizedlist>
@@ -52,12 +78,18 @@
</listitem>
<listitem>
<para>
+<!--
First stage of online recovery.
+-->
+オンラインリカバリのファーストステージ。
</para>
</listitem>
<listitem>
<para>
- Wait until all clients have disconnected.
+<!--
+ Wait until all client connections have disconnected.
+-->
+全てのクライアント接続が切断されるまで待機
</para>
</listitem>
<listitem>
@@ -67,31 +99,45 @@
</listitem>
<listitem>
<para>
+<!--
Second stage of online recovery.
+-->
+オンラインリカバリのセカンドステージ。
</para>
</listitem>
<listitem>
<para>
+<!--
Start up postmaster (perform <literal>pgpool_remote_start</literal>)
+-->
+postmasterの起動（<literal>pgpool_remote_start</literal>の実施）
</para>
</listitem>
<listitem>
<para>
+<!--
Node attach
+-->
+ノードの復帰
</para>
</listitem>
</itemizedlist>
<note>
<para>
+<!--
There is a restriction in the online recovery. If
<productname>Pgpool-II</productname> itself is installed
on multiple hosts, online recovery does not work correctly,
because <productname>Pgpool-II</productname> has to stop all
the clients during the 2nd stage of online recovery.
If there are several <productname>Pgpool-II</productname> hosts,
- only one will have received the online recovery command and will
- block the connections.
+ only one of them will have received the online recovery command and will
+ block the connections from clients.
+-->
+オンラインリカバリには制限事項があります。
+<productname>Pgpool-II</productname>が複数のホストにインストールされている場合、<productname>Pgpool-II</productname>はオンラインリカバリの2ndステージの間全てのクライアントを止める必要があるため、オンラインリカバリは正しく動作しません。
+複数の<productname>Pgpool-II</productname>ホストがある場合、そのうちの１台のみがオンラインリカバコマンドを受け取り、クライアントからの接続をブロックします。
</para>
</note>
<variablelist>
@@ -99,15 +145,24 @@
<varlistentry id="guc-recovery-user" xreflabel="recovery_user">
<term><varname>recovery_user</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>recovery_user</varname> configuration parameter</primary>
+-->
+ <primary><varname>recovery_user</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
- Specifies the PostgreSQL user name to perform online recovery.
+<!--
+ Specifies the <productname>PostgreSQL</> user name to perform online recovery.
+-->
+オンラインリカバリを行うための<productname>PostgreSQL</>ユーザ名です。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -115,16 +170,25 @@
<varlistentry id="guc-recovery-password" xreflabel="recovery_password">
<term><varname>recovery_password</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>recovery_password</varname> configuration parameter</primary>
+-->
+ <primary><varname>recovery_password</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
- Specifies the password for the PostgreSQL user name configured in
+<!--
+ Specifies the password for the <productname>PostgreSQL</> user name configured in
+-->
+オンラインリカバリを行うための PostgreSQL ユーザパスワードです。
<xref linkend="guc-recovery-user"> to perform online recovery.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -132,65 +196,98 @@
<varlistentry id="guc-recovery-1st-stage-command" xreflabel="recovery_1st_stage_command">
<term><varname>recovery_1st_stage_command</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>recovery_1st_stage_command</varname> configuration parameter</primary>
+-->
+ <primary><varname>recovery_1st_stage_command</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
- Specifies a command to be run by master(primary) PostgreSQL server at the
+<!--
+ Specifies a command file to be run by master(primary) node at the
first stage of online recovery. The command file must be placed in the
database cluster directory for security reasons.
For example, if <varname>recovery_1st_stage_command</varname> = <literal>
'sync-command'</literal>, then <productname>Pgpool-II</productname> will
look for the command scrit in <literal>$PGDATA</literal> directory and will
try to execute <command>$PGDATA/sync-command</command>.
+-->
+オンラインリカバリのファーストステージでマスタ（プライマリ）ノードで実行されるコマンドを指定します。
+コマンドファイルはセキュリティ上の観点からデータベースクラスタ内に配置される必要があります。
+例えば、<varname>recovery_1st_stage_command</varname> = <literal>'sync-command'</literal>となっている場合、<productname>Pgpool-II</productname>はコマンドスクリプトを<literal>$PGDATA</literal>ディレクトリの中で探し、<command>$PGDATA/sync-command</command>を起動しようとします。
</para>
<para>
+<!--
<varname>recovery_1st_stage_command</varname> receives following 4 parameters:
+-->
+<varname>recovery_1st_stage_command</varname>は次の4つの引数を受けとります。
</para>
<itemizedlist>
<listitem>
<para>
- Path to master(primary) database cluster.
+<!--
+ Path to the database cluster of the master(primary) node.
+-->
+マスター（プライマリ）ノードのデータベースクラスタへのパス
</para>
</listitem>
<listitem>
<para>
- PostgreSQL host name to be recovered.
+<!--
+ Hostname of the backend node to be recovered.
+-->
+リカバリされるバックエンドノードのホスト名
</para>
</listitem>
<listitem>
<para>
- Path to database cluster to be recovered.
+<!--
+ Path to the database cluster of the node to be recovered.
+-->
+リカバリされるノードのデータベースクラスタへのパス
</para>
</listitem>
<listitem>
<para>
- Master database port number.
+<!--
+ Port number of database to be recovered.
+-->
+リカバリーされるノードのポート番号
</para>
</listitem>
</itemizedlist>
<note>
<para>
+<!--
<productname>Pgpool-II</productname> accept connections and queries
- while <varname>recovery_1st_stage command</varname> is executed.
- So You can retrieve and update data during this stage.
+ while <varname>recovery_1st_stage command</varname> is executed,
+ so you can retrieve and update data.
+-->
+<varname>recovery_1st_stage_command</varname>の実行中は<productname>Pgpool-II</productname>は接続やクエリを受け付けており、データの参照や更新を行うことができます。
</para>
</note>
<caution>
<para>
+<!--
<varname>recovery_1st_stage command</varname> runs as a <acronym>SQL</acronym>
- command from PostgreSQL's point of view. So <varname>recovery_1st_stage command
- </varname> can get prematuraly killed by PostgreSQL if the PostgreSQL's
- <varname>statement_time_out</varname> is configured with the value that is
+ command from <productname>PostgreSQL</>'s point of view. Therefore, <varname>recovery_1st_stage_command
+ </varname> can get prematuraly killed by <productname>PostgreSQL</> if
+ <varname>statement_timeout</varname> is configured with the value that is
smaller than the time <varname>recovery_1st_stage_command</varname> takes for
completion.
+-->
+<varname>recovery_1st_stage_command</varname>は、<productname>PostgreSQL</>から見ると、一つの<acronym>SQL</acronym>として実行されます。
+そのため、<productname>PostgreSQL</>の<varname>statement_timeout</varname>が<varname>recovery_1st_stage_command</varname>の完了にかかる時間よりも短く設定されていると、<varname>recovery_1st_stagecommand</varname>コマンドの実行が途中でキャンセルされます。
</para>
<para>
+<!--
Typical error in such case is
+-->
+典型的なエラーは以下のようなものです。
<programlisting>
rsync used in the command is killed by signal 2 for example.
</programlisting>
@@ -198,7 +295,10 @@ rsync used in the command is killed by signal 2 for example.
</caution>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -206,72 +306,107 @@ rsync used in the command is killed by signal 2 for example.
<varlistentry id="guc-recovery-2nd-stage-command" xreflabel="recovery_2nd_stage_command">
<term><varname>recovery_2nd_stage_command</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>recovery_2nd_stage_command</varname> configuration parameter</primary>
+-->
+ <primary><varname>recovery_2nd_stage_command</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
- Specifies a command to be run by master(primary) PostgreSQL server at the
+<!--
+ Specifies a command file to be run by master(primary) node at the
second stage of online recovery. The command file must be placed in the
database cluster directory for security reasons.
For example, if <varname>recovery_2nd_stage_command</varname> = <literal>
'sync-command'</literal>, then <productname>Pgpool-II</productname> will
look for the command scrit in <literal>$PGDATA</literal> directory and will
try to execute <command>$PGDATA/sync-command</command>.
+-->
+オンラインリカバリのセカンドステージでマスタ（プライマリ）ノードで実行されるコマンドを指定します。
+コマンドファイルはセキュリティ上の観点からデータベースクラスタ内に配置される必要があります。
+例えば、<varname>recovery_2nd_stage_command</varname> = <literal>'sync-command'</literal>となっている場合、<productname>Pgpool-II</productname>はコマンドスクリプトを<literal>$PGDATA</literal>ディレクトリの中で探し、<command>$PGDATA/sync-command</command>を起動しようとします。
</para>
<para>
+<!--
<varname>recovery_2nd_stage_command</varname> receives following 4 parameters:
+-->
+<varname>recovery_2nd_stage_command</varname>は次の4つの引数を受けとります。
</para>
<itemizedlist>
<listitem>
<para>
- Path to master(primary) database cluster.
+<!--
+ Path to the database cluster of the master(primary) node.
+-->
+マスター（プライマリ）ノードのデータベースクラスタへのパス
</para>
</listitem>
<listitem>
<para>
- PostgreSQL host name to be recovered.
+<!--
+ Hostname of the backend node to be recovered.
+-->
+リカバリされるバックエンドノードのホスト名
</para>
</listitem>
<listitem>
<para>
- Path to database cluster to be recovered.
+<!--
+ Path to the database cluster of the node to be recovered.
+-->
+リカバリされるノードのデータベースクラスタへのパス
</para>
</listitem>
<listitem>
<para>
- Port number of database to be recovered.
+<!--
+ Port number of the master(primary) node.
+-->
+マスター（プライマリ）ノードのポート番号
</para>
</listitem>
</itemizedlist>
<note>
<para>
+<!--
<productname>Pgpool-II</productname> <emphasis>does not</emphasis>
accept client connections and queries during the execution
- of <varname>recovery_2nd_stage command</varname> command, and waits
+ of <varname>recovery_2nd_stage_command</varname> command, and waits
for the existing clients to close their connections before executing the
command.
- So the <varname>recovery_2nd_stage command</varname> may not execute
+ Therefore, the <varname>recovery_2nd_stage_command</varname> may not execute
if the client stays connected for a long time.
+-->
+<varname>recovery_2nd_stage_command</varname>の実行中は、<productname>Pgpool-II</productname>はクライアントからの接続およびクエリを<emphasis>受け付けません</emphasis>。
+また、コマンドを実行する前に既存のクライアントが接続を閉じるのを待ちます。
+そのため、長時間接続したままのクライアントがいる場合、<varname>recovery_2nd_stage_command</varname>は実行されない可能性があります。
</para>
</note>
<caution>
<para>
+<!--
<varname>recovery_2nd_stage command</varname> runs as a <acronym>SQL</acronym>
- command from PostgreSQL's point of view. So <varname>recovery_2nd_stage command
+ command from PostgreSQL's point of view. Therefore, <varname>recovery_2nd_stage command
</varname> can get prematuraly killed by PostgreSQL if the PostgreSQL's
<varname>statement_time_out</varname> is configured with the value that is
smaller than the time <varname>recovery_2nd_stage_command</varname> takes for
completion.
+-->
+<varname>recovery_2nd_stage_command</varname>は、<productname>PostgreSQL</>から見ると、一つの<acronym>SQL</acronym>として実行されます。
+そのため、<productname>PostgreSQL</>の<varname>statement_timeout</varname>が<varname>recovery_2nd_stage_command</varname>の完了にかかる時間よりも短く設定されていると、<varname>recovery_1st_stagecommand</varname>コマンドの実行が途中でキャンセルされます。
</para>
</caution>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -279,19 +414,29 @@ rsync used in the command is killed by signal 2 for example.
<varlistentry id="guc-recovery-timeout" xreflabel="recovery_timeout">
<term><varname>recovery_timeout</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>recovery_timeout</varname> configuration parameter</primary>
+-->
+ <primary><varname>recovery_timeout</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the timeout in seconds to cancel the online recovery if it
does not completes within this time.
Since <productname>Pgpool-II</productname> does not accepts the connections
- during the second stage of recovery so this parameter can be used to cancel
+ during the second stage of online recovery, this parameter can be used to cancel
the online recovery to manage the service down time during the online recovery.
+-->
+時間内にオンラインリカバリが完了しなかった場合に、これをキャンセルするためのタイムアウトを秒単位で指定します。
+<productname>Pgpool-II</productname>は、オンラインリカバリのセカンドステージの間は接続を受け付けけないので、このパラメータはオンラインリカバリの最中のサーバがダウンした時にオンラインリカバリをキャンセルするのに使えます。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
</varlistentry>
@@ -299,33 +444,51 @@ rsync used in the command is killed by signal 2 for example.
<varlistentry id="guc-client-idle-limit-in-recovery" xreflabel="client_idle_limit_in_recovery">
<term><varname>client_idle_limit_in_recovery</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>client_idle_limit_in_recovery</varname> configuration parameter</primary>
+-->
+ <primary><varname>client_idle_limit_in_recovery</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the time in seconds to disconnect a client if it remains idle
since the last query during the online recovery.
<varname>client_idle_limit_in_recovery</varname> is similar to the
<xref linkend="guc-client-idle-limit"> but only takes effect during the
second stage of online recovery.
+-->
+オンラインリカバリの最中で、クライアントが前回のクエリからアイドル状態のままでいるときに、それを切断するまでの時間を秒単位で指定します。
+<varname>client_idle_limit_in_recovery</varname>は<xref linkend="guc-client-idle-limit">と似ていますが、オンラインリカバリのセカンドステージでのみ効果を持ちます。
</para>
<para>
+<!--
This is useful for preventing the <productname>Pgpool-II</productname>
recovery from being disturbed by the lazy clients or if the TCP/IP
connection between the client and <productname>Pgpool-II</productname>
is accidentally down (a cut cable for instance).
+-->
+これは、だらしないクライアントや<productname>Pgpool-II</productname>の間のTCP/IPコネクションの不調（例えばケーブルの切断など）によって、<productname>Pgpool-II</productname>のリカバリが邪魔されるのを防止するのに役立ちます。
</para>
<para>
- If set to -1, All clients get immediately disconnected when the second
- stage of online recovery starts..
+<!--
+ If set to -1, all clients get immediately disconnected when the second
+ stage of online recovery starts.
The default is 0, which turns off the feature.
+-->
+-1に設定すると、オンラインリカバリのセカンドステージが始まると全てのクライアントは直ちに切断されます。
+デフォルト値は0で、この機能は無効です。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
this parameter for a current session.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
+現在のセッションでのパラメータ値は、<xref linkend="SQL-PGPOOL-SET">コマンドで変更することもできます。
</para>
</listitem>
</varlistentry>
diff --git a/doc.ja/src/sgml/ssl.sgml b/doc.ja/src/sgml/ssl.sgml
index 9daf9c5d4..7de6fc167 100644
--- a/doc.ja/src/sgml/ssl.sgml
+++ b/doc.ja/src/sgml/ssl.sgml
@@ -8,19 +8,29 @@
<varlistentry id="guc-ssl" xreflabel="ssl">
<term><varname>ssl</varname> (<type>boolean</type>)
<indexterm>
+<!--
<primary><varname>ssl</varname> configuration parameter</primary>
+-->
+ <primary><varname>ssl</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
When set to on, <productname>Pgpool-II</productname> enables the <acronym>SSL</acronym>
for both the frontend and backend communications.
Default is off.
+-->
+onに設定すると，<productname>Pgpool-II</productname>はフロントエンドとバックエンドの両方の通信での<acronym>SSL</acronym>が可能になります。
+デフォルトはoffです。
</para>
<note>
<para>
+<!--
<xref linkend="guc-ssl-key"> and <xref linkend="guc-ssl-cert"> must also be
configured in order for SSL to work with frontend connections.
+-->
+フロントエンド接続にSSLするには、<xref linkend="guc-ssl-key">と<xref linkend="guc-ssl-cert">が設定されてなければなりません。
</para>
</note>
<note>
@@ -28,10 +38,15 @@
For SSL to work <productname>Pgpool-II</productname> must be build with OpenSSL support.
See <xref linkend="install-pgpool"> for details on building the
<productname>Pgpool-II</productname>.
+SSLサポートを有効にするためには、<productname>Pgpool-II</productname>をOpenSSLサポート付きでビルドする必要があります。
+<productname>Pgpool-II</productname>のビルドついて詳細は<xref linkend="install-pgpool">をご覧ください。
</para>
</note>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
@@ -39,18 +54,29 @@
<varlistentry id="guc-ssl-key" xreflabel="ssl_key">
<term><varname>ssl_key</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>ssl_key</varname> configuration parameter</primary>
+-->
+ <primary><varname>ssl_key</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the path to the private key file to be used for
incoming frontend connections.
There is no default value for this option, and if left unset
<acronym>SSL</acronym> will be disabled for incoming frontend connections.
+-->
+フロントエンドとの接続に使用するプライベートキーファイルのパスを指定します。
+このオプションののデフォルト値はありません。
+設定がない場合は、フロントエンドとの接続で<acronym>SSL</acronym>が使用されなくなります。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
@@ -58,19 +84,30 @@
<varlistentry id="guc-ssl-cert" xreflabel="ssl_cert">
<term><varname>ssl_cert</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>ssl_cert</varname> configuration parameter</primary>
+-->
+ <primary><varname>ssl_cert</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the path to the public x509 certificate file to be used
for the incoming frontend connections.
There is no default value for this option, and if left unset
<acronym>SSL</acronym> will be disabled for incoming frontend connections.
+-->
+フロントエンドとの接続に使用する公開x509証明書のフルパスを指定します。
+このオプションののデフォルト値はありません。
+設定がない場合は、フロントエンドとの接続で<acronym>SSL</acronym>が使用されなくなります。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
@@ -78,20 +115,31 @@
<varlistentry id="guc-ssl-ca-cert" xreflabel="ssl_ca_cert">
<term><varname>ssl_ca_cert</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>ssl_ca_cert</varname> configuration parameter</primary>
+-->
+ <primary><varname>ssl_ca_cert</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the path to a <acronym>PEM</acronym>
format <acronym>CA</acronym> certificate files, which can be used
to verify the backend server certificates. This is analogous to
the <command>-CApath</command> option of the
<command>OpenSSL verify(1)</command> command.
+-->
+ <acronym>PEM</acronym>形式の<acronym>CA</acronym>ルート証明書のパスを指定します。
+ これはバックエンドサーバ証明書の検証に用いられます。
+ このオプションは<command>OpenSSL verify(1)</command>コマンドにおける<command>-CAfile</command>オプションと同様の機能を提供します。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
@@ -99,25 +147,40 @@
<varlistentry id="guc-ssl-ca-cert-dir" xreflabel="ssl_ca_cert_dir">
<term><varname>ssl_ca_cert_dir</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>ssl_ca_cert_dir</varname> configuration parameter</primary>
+-->
+ <primary><varname>ssl_ca_cert_dir</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the path to a directory containing <acronym>PEM</acronym>
format <acronym>CA</acronym> certificate files, which can be used
to verify the backend server certificates. This is analogous to
the <command>-CApath</command> option of the
<command>OpenSSL verify(1)</command> command.
+-->
+ <acronym>PEM</acronym>形式の<acronym>CA</acronym>ルート証明書ファイルが格納されているディレクトリへのパスを指定します。
+ これはバックエンドサーバ証明書の検証に用いられます。
+ このオプションは<command>OpenSSL verify(1)</command>コマンドにおける<command>-CAfile</command>オプションと同様の機能を提供します。
</para>
<para>
+<!--
The default value for this option is unset, which means no
verification takes place. Verification will still happen if
this option is not set but a value is provided for
<xref linkend="guc-ssl-ca-cert">.
+-->
+デフォルトでは値が設定されておらず検証は行われません。
+このオプションが設定されていない場合においても、<xref linkend="guc-ssl-ca-cert">オプションが設定されている場合には検証が行われます。
</para>
<para>
+<!--
This parameter can only be set at server start.
+-->
+このパラメータはサーバ起動時にのみ設定可能です。
</para>
</listitem>
</varlistentry>
diff --git a/doc.ja/src/sgml/stream-check.sgml b/doc.ja/src/sgml/stream-check.sgml
index b1b1396a9..8744d6f74 100644
--- a/doc.ja/src/sgml/stream-check.sgml
+++ b/doc.ja/src/sgml/stream-check.sgml
@@ -1,19 +1,30 @@
<!-- doc/src/sgml/config.sgml -->
<sect1 id="runtime-streaming-replication-check">
+<!--
<title>Streaming Replication Check</title>
+-->
+ <title>ストリーミングレプリケーションのチェック</title>
<para>
- <productname>Pgpool-II</productname> can work with PostgreSQL native
- Streaming Replication, that is available since PostgreSQL 9.0.
+<!--
+ <productname>Pgpool-II</productname> can work with <productname>PostgreSQL</> native
+ Streaming Replication, that is available since <productname>PostgreSQL</> 9.0.
To configure <productname>Pgpool-II</productname> with streaming
replication, enable <xref linkend="guc-master-slave-mode"> and set
<xref linkend="guc-master-slave-sub-mode"> to <literal>'stream'</literal>.
+-->
+<productname>Pgpool-II</productname>は<productname>PostgreSQL</> 9.0から利用可能になった<productname>PostgreSQL</>組み込みのストリーミングレプリケーション機能と一緒に動作することができます。
+ストリーミングレプリケーション向けに<productname>Pgpool-II</productname>を設定するには、<xref linkend="guc-master-slave-mode">を有効にして<xref linkend="guc-master-slave-sub-mode">を<literal>'stream'</literal>に設定します。
</para>
<para>
+<!--
<productname>Pgpool-II</productname> assumes that Streaming Replication
is configured with Hot Standby on PostgreSQL, which means that the
standby database can handle read-only queries.
+-->
+<productname>Pgpool-II</productname>ではストリーミングレプリケーションととHot Standbyを併用することを前提にしています。
+すなわちスタンバイデータベースでは参照クエリのみを扱うことができます。
</para>
<variablelist>
@@ -21,19 +32,29 @@
<varlistentry id="guc-sr-check-period" xreflabel="sr_check_period">
<term><varname>sr_check_period</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>sr_check_period</varname> configuration parameter</primary>
+-->
+ <primary><varname>sr_check_period</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the time interval in seconds to check the streaming
replication delay.
Default is 0, which means the check is disabled.
+-->
+ストリーミングレプリケーションの遅延チェックの間隔を秒単位で指定します。
+デフォルト値は0で、これはチェックを行わないことを意味します
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
@@ -42,25 +63,38 @@
<varlistentry id="guc-sr-check-user" xreflabel="sr_check_user">
<term><varname>sr_check_user</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>sr_check_user</varname> configuration parameter</primary>
+-->
+ <primary><varname>sr_check_user</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
- Specifies the PostgreSQL user name to perform streaming replication check.
- The user must exist on all the PostgreSQL backends.
+<!--
+ Specifies the <productname>PostgreSQL</> user name to perform streaming replication check.
+ The user must exist on all the <productname>PostgreSQL</> backends.
+-->
+ストリーミングレプリケーションのチェックを行う<productname>PostgreSQL</>ユーザ名を指定します。
+このユーザは、すべてのバックエンドに存在しなければなりません。
</para>
<note>
<para>
- <xref linkend="guc-sr-check-user"> and <xref linkend="guc-sr-check-password">
+<!--
+ <varname>sr_check_user</varname>> and <xref linkend="guc-sr-check-password">
are used even when <xref linkend="guc-sr-check-period"> is set to 0 (disabled)
for the identification of the primary server.
+-->
+<varname>sr_check_user</varname>と<xref linkend="guc-sr-check-password">は、<xref linkend="guc-sr-check-period">が0（無効）であっても、プライマリサーバの特定に使用されます。
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
@@ -69,19 +103,29 @@
<varlistentry id="guc-sr-check-password" xreflabel="sr_check_password">
<term><varname>sr_check_password</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>sr_check_password</varname> configuration parameter</primary>
+-->
+ <primary><varname>sr_check_password</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
- Specifies the password of the <xref linkend="guc-sr-check-user"> PostgreSQL user
+<!--
+ Specifies the password of the <xref linkend="guc-sr-check-user"> <productname>PostgreSQL</> user
to perform the streaming replication checks.
Use <literal>''</literal> (empty string) if the user does not requires a password.
+-->
+ストリーミングレプリケーションのチェックを行う<xref linkend="guc-sr-check-user"> <productname>PostgreSQL</>ユーザのパスワードをを指定します。
+ユーザがパスワードが必要としなければ空文字('')を使用します。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
@@ -90,17 +134,27 @@
<varlistentry id="guc-sr-check-database" xreflabel="sr_check_database">
<term><varname>sr_check_database</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>sr_check_database</varname> configuration parameter</primary>
+-->
+ <primary><varname>sr_check_database</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the database to perform streaming replication delay checks.
The default is <literal>"postgres"</literal>.
+-->
+ストリーミングレプリケーションの遅延チェックを行うデータベース名を指定します。
+デフォルトは「<literal>postgres</literal>」です。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
@@ -109,12 +163,16 @@
<varlistentry id="guc-delay-threshold" xreflabel="delay_threshold">
<term><varname>delay_threshold</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>delay_threshold</varname> configuration parameter</primary>
+-->
+ <primary><varname>delay_threshold</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the maximum tolerance level of replication delay in
<acronym>WAL</acronym> bytes on the standby server against the
primary server. If the delay exceeds this configured level,
@@ -122,13 +180,22 @@
SELECT</acronym> queries to the standby server and starts routing
everything to the primary server even if <xref linkend="guc-load-balance-mode">
is enabled, until the standby catches-up with the primary.
- Setting this parameter to 0 disables, the delay checking.
+ Setting this parameter to 0 disables the delay checking.
This delay threshold check is performed every <xref linkend="guc-sr-check-period">.
Default is 0.
+-->
+プラマリサーバに対するスタンバイサーバのレプリケーション遅延の許容度を<acronym>WAL</acronym>バイト単位で指定します。
+<productname>Pgpool-II</productname>は、スタンバイサーバの遅延がこの設定レベルを超えた場合には、 <xref linkend="guc-load-balance-mode">が有効であっても、プライマリに追いつくまでそのスタンバイノードには<acronym>SELECT</acronym>クエリを送信せず、全てプライマリサーバに送るようにします。
+このパラメータが0の場合は、遅延のチェックを行ないません。
+この遅延閾値のチェックは<xref linkend="guc-sr-check-period">毎に行われます。
+デフォルト値は0です。
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
@@ -137,14 +204,22 @@
<varlistentry id="guc-log-standby-delay" xreflabel="log_standby_delay">
<term><varname>log_standby_delay</varname> (<type>string</type>)
<indexterm>
+<!--
<primary><varname>log_standby_delay</varname> configuration parameter</primary>
+-->
+ <primary><varname>log_standby_delay</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies when to log the replication delay. Below table contains the list
of all valid values for the parameter.
+-->
+レプリケーションの遅延状況をログ出力する条件を指定します。
+以下の表にこのパラメータでとることができる値のリストを示します。
+'none'を指定すると、ログを出力しません。 'always'ならレプリケーションの遅延チェックを実行するたびに必ず出力します。 'if_over_threshold'を指定すると、delay_thresholdを超えたときだけ ログが出力されます。 デフォルト値は'none'です。
</para>
<table id="log-standby-delay-table">
@@ -152,32 +227,47 @@
<tgroup cols="2">
<thead>
<row>
+<!--
<entry>Value</entry>
<entry>Description</entry>
+-->
+ <entry>値</entry>
+ <entry>説明</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>'none'</literal></entry>
+<!--
<entry>Never log the standby delay</entry>
+-->
+ <entry>スタンバイの遅延はログ出力されない</entry>
</row>
<row>
<entry><literal>'always'</literal></entry>
+<!--
<entry>Log the standby delay, every time the replication delay is checked</entry>
+-->
+ <entry>レプリケーション遅延がチェックされる度に、スタンバイの遅延がログ出力される</entry>
</row>
<row>
+<!--
<entry><literal>'if_over_threshold'</literal></entry>
- <entry>Only log the standby delay, when it exceeds <xref linkend="guc-delay-threshold"> value</entry>
+-->
+ <entry><xref linkend="guc-delay-threshold">の値を超えた時だけ、スタンバイの遅延がログ出力される</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+<!--
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
+-->
+このパラメータは<productname>Pgpool-II</>の設定を再読み込みすることで変更可能です。
</para>
</listitem>
diff --git a/doc.ja/src/sgml/watchdog.sgml b/doc.ja/src/sgml/watchdog.sgml
index 96decc86c..51f09bcca 100644
--- a/doc.ja/src/sgml/watchdog.sgml
+++ b/doc.ja/src/sgml/watchdog.sgml
@@ -57,7 +57,10 @@ onならwatchdogを有効にします。
</sect2>
<sect2 id="config-communication-watchdog">
+<!--
<title>Watchdog communication</title>
+-->
+ <title>Watchdog通信</title>
<variablelist>
@@ -92,13 +95,20 @@ onならwatchdogを有効にします。
<varlistentry id="guc-wd-port" xreflabel="wd_port">
<term><varname>wd_port</varname> (<type>integer</type>)
<indexterm>
+<!--
<primary><varname>wd_port</varname> configuration parameter</primary>
+-->
+ <primary><varname>wd_port</varname> 設定パラメータ</primary>
</indexterm>
</term>
<listitem>
<para>
+<!--
Specifies the port number to be used by watchdog
- process to listen for connections. Default is 9999.
+ process to listen for connections. Default is 9000.
+-->
+watchdogが接続を受け付けるために監視するポート番号です。
+デフォルト値は9000です。
</para>
<para>
<!--
@@ -163,7 +173,10 @@ wachdog間通信で用いられる認証キーを指定します。
</sect2>
<sect2 id="config-watchdog-upstream-connections">
+<!--
<title>Upstream server connection</title>
+-->
+ <title>上流サーバへの接続</title>
<variablelist>
@@ -804,7 +817,10 @@ watchdogプロセスがネットワークリンクの状態を監視するネッ
</sect2>
<sect2 id="config-watchdog-lifecheck-heartbeat">
+<!--
<title>Lifecheck Heartbeat mode configuration</title>
+-->
+ <title>死活監視：ハートビートモードの設定</title>
<variablelist>
<varlistentry id="guc-wd-heartbeat-port" xreflabel="wd_heartbeat_port">
@@ -1013,7 +1029,7 @@ heartbeat_destinationX:heartbeat_destination_portXで指定されるハートビ
</sect2>
<sect2 id="config-watchdog-lifecheck-query">
- <title>Lifecheck Query mode configuration</title>
+ <title>死活監視：クエリモードの設定</title>
<variablelist>
<varlistentry id="guc-wd-life-point" xreflabel="wd_life_point">
@@ -1193,7 +1209,10 @@ heartbeat_destinationX:heartbeat_destination_portXで指定されるハートビ
</sect2>
<sect2 id="config-watchdog-server-configuration">
+<!--
<title>Watchdog servers configurations</title>
+-->
+ <title>Watchdogサーバの設定</title>
<variablelist>
<varlistentry id="guc-other-pgpool-hostname" xreflabel="other_pgpool_hostname">
diff --git a/doc/src/sgml/failover.sgml b/doc/src/sgml/failover.sgml
index cb964a2f7..b629fb9bd 100644
--- a/doc/src/sgml/failover.sgml
+++ b/doc/src/sgml/failover.sgml
@@ -13,7 +13,7 @@
</term>
<listitem>
<para>
- Specifies a user command to run when a PostgreSQL backend node detaches.
+ Specifies a user command to run when a <productname>PostgreSQL</> backend node gets detached.
<productname>Pgpool-II</productname> replaces the following special characters
with the backend specific information.
</para>
@@ -31,19 +31,19 @@
<tbody>
<row>
<entry>%d</entry>
- <entry>Backend ID of a detached node</entry>
+ <entry>DB node ID of the detached node</entry>
</row>
<row>
<entry>%h</entry>
- <entry>Hostname of a detached node</entry>
+ <entry>Hostname of the detached node</entry>
</row>
<row>
<entry>%p</entry>
- <entry>Port number of a detached node</entry>
+ <entry>Port number of the detached node</entry>
</row>
<row>
<entry>%D</entry>
- <entry>Database cluster directory of a detached node</entry>
+ <entry>Database cluster directory of the detached node</entry>
</row>
<row>
<entry>%M</entry>
@@ -63,11 +63,11 @@
</row>
<row>
<entry>%r</entry>
- <entry>New master port number</entry>
+ <entry>Port number of the new master node</entry>
</row>
<row>
<entry>%R</entry>
- <entry>New master database cluster directory</entry>
+ <entry>Database cluster directory of the new master node</entry>
</row>
<row>
<entry>%%</entry>
@@ -89,7 +89,7 @@
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -102,9 +102,10 @@
</term>
<listitem>
<para>
- Specifies a user command to run when a PostgreSQL backend node gets attached to
- <productname>Pgpool-II</productname>, <productname>Pgpool-II</productname>
+ Specifies a user command to run when a <productname>PostgreSQL</> backend node gets attached to
+ <productname>Pgpool-II</productname>. <productname>Pgpool-II</productname>
replaces the following special characters with the backend specific information.
+ before excuting the command.
</para>
<table id="ffailback-command-table">
@@ -120,19 +121,19 @@
<tbody>
<row>
<entry>%d</entry>
- <entry>Backend ID of a detached node</entry>
+ <entry>DB node ID of the attached node</entry>
</row>
<row>
<entry>%h</entry>
- <entry>Hostname of a detached node</entry>
+ <entry>Hostname of the attached node</entry>
</row>
<row>
<entry>%p</entry>
- <entry>Port number of a detached node</entry>
+ <entry>Port number of the attached node</entry>
</row>
<row>
<entry>%D</entry>
- <entry>Database cluster directory of a detached node</entry>
+ <entry>Database cluster directory of the attached node</entry>
</row>
<row>
<entry>%M</entry>
@@ -152,11 +153,11 @@
</row>
<row>
<entry>%r</entry>
- <entry>New master port number</entry>
+ <entry>Port number of the new master node</entry>
</row>
<row>
<entry>%R</entry>
- <entry>New master database cluster directory</entry>
+ <entry>Database cluster directory of the new master node</entry>
</row>
<row>
<entry>%%</entry>
@@ -168,7 +169,7 @@
</table>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -182,10 +183,10 @@
<listitem>
<para>
- Specifies a user command to run in master/slave streaming replication mode
- after the master backend node failover.
- <productname>Pgpool-II</productname>, <productname>Pgpool-II</productname>
- replaces the following special characters with the backend specific information.
+ Specifies a user command to run after failover on the primary node failover.
+ This works only in Master Replication mode with streaming replication.
+ <productname>Pgpool-II</productname> replaces the following special characters
+ with the backend specific information before excuting the command.
</para>
<table id="follow-master-command-table">
@@ -201,19 +202,19 @@
<tbody>
<row>
<entry>%d</entry>
- <entry>Backend ID of a detached node</entry>
+ <entry>DB node ID of the detached node</entry>
</row>
<row>
<entry>%h</entry>
- <entry>Hostname of a detached node</entry>
+ <entry>Hostname of the detached node</entry>
</row>
<row>
<entry>%p</entry>
- <entry>Port number of a detached node</entry>
+ <entry>Port number of the detached node</entry>
</row>
<row>
<entry>%D</entry>
- <entry>Database cluster directory of a detached node</entry>
+ <entry>Database cluster directory of the detached node</entry>
</row>
<row>
<entry>%M</entry>
@@ -233,11 +234,11 @@
</row>
<row>
<entry>%r</entry>
- <entry>New master port number</entry>
+ <entry>Port number of the new master node</entry>
</row>
<row>
<entry>%R</entry>
- <entry>New master database cluster directory</entry>
+ <entry>Database cluster directory of the new master node</entry>
</row>
<row>
<entry>%%</entry>
@@ -248,20 +249,22 @@
</tgroup>
</table>
+ <note>
<para>
- If <xref linkend="guc-follow-master-command"> is not left out empty, then when
- a master node failover gets completed in master/slave streaming replication mode,
- <productname>Pgpool-II</productname> degenerates all nodes excepted the new master
+ If <varname>follow_master_command</varname>> is not empty, then after failover
+ on the primary node gets completed in Master Slave mode with streaming replication,
+ <productname>Pgpool-II</productname> degenerates all nodes excepted the new primary
and starts new child processes to be ready again to accept connections from the clients.
After this, <productname>Pgpool-II</productname> executes the command configured
- in the <xref linkend="guc-follow-master-command"> for each degenerated backend nodes.
+ in the <varname>follow_master_command</varname> for each degenerated backend nodes.
</para>
+ </note>
<para>
- Typically <xref linkend="guc-follow-master-command"> command is used to recover
- the slave from the new master by calling the pcp_recovery_node command.
+ Typically <varname>follow_master_command</varname>> command is used to recover
+ the slave from the new primary by calling the pcp_recovery_node command.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -284,14 +287,14 @@
<para>
It is recommended to turn on the backend health checking
(see <xref linkend="runtime-config-health-check">)
- when <xref linkend="guc-fail-over-on-backend-error"> is set to off.
- However, <productname>Pgpool-II</productname> still triggers the
+ when <varname>fail_over_on_backend_error</varname> is set to off.
+ Note, however, that <productname>Pgpool-II</productname> still triggers the
failover when it detects the administrative shutdown of
- PostgreSQL backend server.
+ <productname>PostgreSQL</> backend server.
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -308,13 +311,13 @@
primary node when a failover scenario occurs.
<productname>Pgpool-II</productname> will give up looking for the primary
node if it is not found with-in this configured time.
- Default is 10 and Setting this parameter to 0 means keep trying forever.
+ Default is 300 and Setting this parameter to 0 means keep trying forever.
</para>
<para>
This parameter is only applicable in the streaming replication mode.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
diff --git a/doc/src/sgml/memcache.sgml b/doc/src/sgml/memcache.sgml
index 8be0fd9f1..6b45d0dc7 100644
--- a/doc/src/sgml/memcache.sgml
+++ b/doc/src/sgml/memcache.sgml
@@ -6,7 +6,7 @@
<para>
In memory query cache can be used with all modes of
<productname>Pgpool-II</productname>. It is different
- from the query cache on the point that in memory query
+ from the query cache on disk that In memory query
cache is faster because of the in memory nature of the storage.
Moreover <productname>Pgpool-II</productname> does not
need a restart when the cache gets outdated because of
@@ -19,7 +19,7 @@
extended query). If the same SELECTs comes in,
<productname>Pgpool-II</productname> returns the value
from cache. Since no <acronym>SQL</acronym> parsing nor
- access to PostgreSQL are involved, the serving of results
+ access to <productname>PostgreSQL</> are involved, the serving of results
from the in memory cache is extremely fast.
</para>
<para>
@@ -27,7 +27,7 @@
in some cases, because it adds some overhead to store cache.
Moreover when a table is updated, <productname>Pgpool-II
</productname> automatically deletes all the caches related
- to the table. So the performance will be degraded by a system
+ to the table. Therefore, the performance will be degraded by a system
with a lot of updates.
If the cache_hit_ratio is lower than 70%, you might want
to disable in memory cache.
@@ -50,7 +50,7 @@
Default is off.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -132,12 +132,12 @@
valid until the table is updated.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
<note>
<para>
- This parameters <xref linkend="guc-memqcacheexpire"> and
+ <varname>memqcache_expire</varname> and
<xref linkend="guc-memqcache-auto-cache-invalidation"> are orthogonal to each other.
</para>
</note>
@@ -166,7 +166,7 @@
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -182,7 +182,7 @@
Specifies the maximum size in bytes of the SELECT query result to be cached.
The result with data size larger than this value will not be cached by
<productname>Pgpool-II</productname>.
- And when the caching of data is rejected because of the size constraint the following
+ When the caching of data is rejected because of the size constraint the following
message is shown.
<programlisting>
LOG: pid 13756: pool_add_temp_query_cache: data size exceeds memqcache_maxcache. current:4095 requested:111 memq_maxcache:4096
@@ -197,7 +197,7 @@ LOG: pid 13756: pool_add_temp_query_cache: data size exceeds memqcache_maxcach
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -217,7 +217,7 @@ LOG: pid 13756: pool_add_temp_query_cache: data size exceeds memqcache_maxcach
<para>
You can use regular expression into the list to match table name
- (to which ^ and $ are automatically added),
+ (to which ^ and $ are automatically added).
</para>
<note>
@@ -239,12 +239,12 @@ white_memqcache_table_list = "table1,public.table1"
</note>
<note>
<para>
- <varname>white_memqcache_table_list</varname> white_memqcache_table_list takes
+ <varname>white_memqcache_table_list</varname>
precedence over <xref linkend="guc-black-memqcache-table-list">
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -285,7 +285,7 @@ black_function_list = "table1,public.table1"
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -303,7 +303,7 @@ black_function_list = "table1,public.table1"
</para>
<para>
<varname>memqcache_oiddir</varname> directory contains the sub directories
- for the databases. The directory name is the OID of the database, And each
+ for the databases. The directory name is the OID of the database. In addition, each
database directory contains the files for each table used by SELECT statement.
Again the name of the file is the OID of the table.
These files contains the pointers to query cache which are used as key for
@@ -316,7 +316,7 @@ black_function_list = "table1,public.table1"
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
diff --git a/doc/src/sgml/misc-config.sgml b/doc/src/sgml/misc-config.sgml
index 36080d94a..e155b4faf 100644
--- a/doc/src/sgml/misc-config.sgml
+++ b/doc/src/sgml/misc-config.sgml
@@ -16,7 +16,7 @@
<para>
Specifies the relation cache expiration time in seconds.
The relation cache is used for caching the query result of
- PostgreSQL system catalogs that is used by <productname>Pgpool-II
+ <productname>PostgreSQL</> system catalogs that is used by <productname>Pgpool-II
</productname> to get various informations including the table
structures and to check table types(e.g. To check if the referred
table is a temporary table or not). The cache is maintained in
@@ -51,7 +51,7 @@
<note>
<para>
If the below message frequently appears in the
- <productname>Pgpool-II</productname> log, You may need to
+ <productname>Pgpool-II</productname> log, you may need to
increase the <varname>relcache_size</varname> for better performance.
<programlisting>
"pool_search_relcache: cache replacement happened"
@@ -76,7 +76,7 @@
<para>
Setting to on, enables the temporary table check in the <acronym>SELECT</acronym>
statements. To check the temporary table <productname>Pgpool-II</productname>
- queries the system catalog of primary/master PostgreSQL backend which increases
+ queries the system catalog of primary/master <productname>PostgreSQL</> backend, which increases
the load on the primary/master server.
If you are absolutely sure that your system never uses temporary tables, then
you can safely turn off the <varname>check_temp_table</varname>.
@@ -84,7 +84,7 @@
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
this parameter for a current session.
</para>
@@ -103,16 +103,16 @@
<para>
Setting to on, enables the unlogged table check in the <acronym>SELECT</acronym>
statements. To check the unlogged table <productname>Pgpool-II</productname>
- queries the system catalog of primary/master PostgreSQL backend which increases
+ queries the system catalog of primary/master <productname>PostgreSQL</> backend which increases
the load on the primary/master server.
If you are absolutely sure that your system never uses the unlogged tables
- (for example, you are using 9.0 or earlier version of PostgreSQL) then you
- can safely turn off the <varname>check_unlogged_table</varname>..
+ (for example, you are using 9.0 or earlier version of <productname>PostgreSQL</>) then you
+ can safely turn off the <varname>check_unlogged_table</varname>.
Default is on.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
this parameter for a current session.
</para>
diff --git a/doc/src/sgml/online-recovery.sgml b/doc/src/sgml/online-recovery.sgml
index 08cd056d3..3cb329bf7 100644
--- a/doc/src/sgml/online-recovery.sgml
+++ b/doc/src/sgml/online-recovery.sgml
@@ -4,18 +4,18 @@
<title>Online Recovery</title>
<para>
- <productname>Pgpool-II</productname>, when in replication mode,
- can sync a database and attach a node while still servicing the clients.
+ <productname>Pgpool-II</productname> can synchronize database nodes and attach
+ a node without stopping the service.
This feature is called <acronym>"online recovery"</acronym>.
</para>
<para>
- For online recovery, a recovery target node must be in the detached state.
- And if you wish to add a PostgreSQL server dynamically, reload the
+ For online recovery, the recovery target node must be detached from <productname>Pgpool-II</>.
+ If you wish to add a <productname>PostgreSQL</> server node dynamically, reload the
<filename>pgpool.conf</filename> after adding the
<xref linkend="guc-backend-hostname"> and its associated parameters.
- This is how the <productname>Pgpool-II</productname> will register this
- new node as a detached backend node.
+ This will register the new server to <productname>Pgpool-II</productname> as a detached backend node.
</para>
+<!--
<caution>
<para>
Make sure that <command>autovacuum</command> is stopped on the
@@ -29,16 +29,17 @@
the PostgreSQL's PITR mechanism.
</para>
</caution>
+-->
<note>
<para>
- The target PostgreSQL server must not be running for performing the online recovery.
- If the target PostgreSQL server has already started, you must shut it down before
+ The recovery target <productname>PostgreSQL</> server must not be running for performing the online recovery.
+ If the target <productname>PostgreSQL</> server has already started, you must shut it down before
starting the online recovery.
</para>
</note>
<para>
- online recovery is performed in two phases, and client connections are
+ Online recovery is performed in two phases. Connections from cliens are
not allowd only in second phase of online recovery while the data can be
updated or retrieved during the first phase.
<productname>Pgpool-II</productname> performs the follows steps in online recovery:
@@ -57,7 +58,7 @@
</listitem>
<listitem>
<para>
- Wait until all clients have disconnected.
+ Wait until all client connections have disconnected.
</para>
</listitem>
<listitem>
@@ -90,8 +91,8 @@
because <productname>Pgpool-II</productname> has to stop all
the clients during the 2nd stage of online recovery.
If there are several <productname>Pgpool-II</productname> hosts,
- only one will have received the online recovery command and will
- block the connections.
+ only one of them will have received the online recovery command and will
+ block the connections from clients.
</para>
</note>
<variablelist>
@@ -104,10 +105,10 @@
</term>
<listitem>
<para>
- Specifies the PostgreSQL user name to perform online recovery.
+ Specifies the <productname>PostgreSQL</> user name to perform online recovery.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -120,11 +121,11 @@
</term>
<listitem>
<para>
- Specifies the password for the PostgreSQL user name configured in
+ Specifies the password for the <productname>PostgreSQL</> user name configured in
<xref linkend="guc-recovery-user"> to perform online recovery.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -137,7 +138,7 @@
</term>
<listitem>
<para>
- Specifies a command to be run by master(primary) PostgreSQL server at the
+ Specifies a command to be run by master(primary) node at the
first stage of online recovery. The command file must be placed in the
database cluster directory for security reasons.
For example, if <varname>recovery_1st_stage_command</varname> = <literal>
@@ -152,22 +153,22 @@
<itemizedlist>
<listitem>
<para>
- Path to master(primary) database cluster.
+ Path to the database cluster of the master(primary) node.
</para>
</listitem>
<listitem>
<para>
- PostgreSQL host name to be recovered.
+ Hostname of the backend node to be recovered.
</para>
</listitem>
<listitem>
<para>
- Path to database cluster to be recovered.
+ Path to the database cluster of the node to be recovered.
</para>
</listitem>
<listitem>
<para>
- Master database port number.
+ Port number of the master(primary) node.
</para>
</listitem>
</itemizedlist>
@@ -175,8 +176,8 @@
<note>
<para>
<productname>Pgpool-II</productname> accept connections and queries
- while <varname>recovery_1st_stage command</varname> is executed.
- So You can retrieve and update data during this stage.
+ while <varname>recovery_1st_stage command</varname> is executed,
+ so you can retrieve and update data.
</para>
</note>
@@ -198,7 +199,7 @@ rsync used in the command is killed by signal 2 for example.
</caution>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -212,7 +213,7 @@ rsync used in the command is killed by signal 2 for example.
<listitem>
<para>
- Specifies a command to be run by master(primary) PostgreSQL server at the
+ Specifies a command to be run by master(primary) node at the
second stage of online recovery. The command file must be placed in the
database cluster directory for security reasons.
For example, if <varname>recovery_2nd_stage_command</varname> = <literal>
@@ -227,17 +228,17 @@ rsync used in the command is killed by signal 2 for example.
<itemizedlist>
<listitem>
<para>
- Path to master(primary) database cluster.
+ Path to the database cluster of the master(primary) node.
</para>
</listitem>
<listitem>
<para>
- PostgreSQL host name to be recovered.
+ Hostname of the backend node to be recovered.
</para>
</listitem>
<listitem>
<para>
- Path to database cluster to be recovered.
+ Path to the database cluster of the node to be recovered.
</para>
</listitem>
<listitem>
@@ -251,10 +252,10 @@ rsync used in the command is killed by signal 2 for example.
<para>
<productname>Pgpool-II</productname> <emphasis>does not</emphasis>
accept client connections and queries during the execution
- of <varname>recovery_2nd_stage command</varname> command, and waits
+ of <varname>recovery_2nd_stage_command</varname> command, and waits
for the existing clients to close their connections before executing the
command.
- So the <varname>recovery_2nd_stage command</varname> may not execute
+ Therefore, the <varname>recovery_2nd_stage_command</varname> may not execute
if the client stays connected for a long time.
</para>
</note>
@@ -262,7 +263,7 @@ rsync used in the command is killed by signal 2 for example.
<caution>
<para>
<varname>recovery_2nd_stage command</varname> runs as a <acronym>SQL</acronym>
- command from PostgreSQL's point of view. So <varname>recovery_2nd_stage command
+ command from PostgreSQL's point of view. Therefore, <varname>recovery_2nd_stage command
</varname> can get prematuraly killed by PostgreSQL if the PostgreSQL's
<varname>statement_time_out</varname> is configured with the value that is
smaller than the time <varname>recovery_2nd_stage_command</varname> takes for
@@ -271,7 +272,7 @@ rsync used in the command is killed by signal 2 for example.
</caution>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -287,11 +288,11 @@ rsync used in the command is killed by signal 2 for example.
Specifies the timeout in seconds to cancel the online recovery if it
does not completes within this time.
Since <productname>Pgpool-II</productname> does not accepts the connections
- during the second stage of recovery so this parameter can be used to cancel
+ during the second stage of online recovery, this parameter can be used to cancel
the online recovery to manage the service down time during the online recovery.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
</varlistentry>
@@ -317,13 +318,13 @@ rsync used in the command is killed by signal 2 for example.
is accidentally down (a cut cable for instance).
</para>
<para>
- If set to -1, All clients get immediately disconnected when the second
- stage of online recovery starts..
+ If set to -1, all clients get immediately disconnected when the second
+ stage of online recovery starts.
The default is 0, which turns off the feature.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
You can also use <xref linkend="SQL-PGPOOL-SET"> command to alter the value of
this parameter for a current session.
</para>
diff --git a/doc/src/sgml/stream-check.sgml b/doc/src/sgml/stream-check.sgml
index b1b1396a9..403e86f94 100644
--- a/doc/src/sgml/stream-check.sgml
+++ b/doc/src/sgml/stream-check.sgml
@@ -4,8 +4,8 @@
<title>Streaming Replication Check</title>
<para>
- <productname>Pgpool-II</productname> can work with PostgreSQL native
- Streaming Replication, that is available since PostgreSQL 9.0.
+ <productname>Pgpool-II</productname> can work with <productname>PostgreSQL</> native
+ Streaming Replication, that is available since <productname>PostgreSQL</> 9.0.
To configure <productname>Pgpool-II</productname> with streaming
replication, enable <xref linkend="guc-master-slave-mode"> and set
<xref linkend="guc-master-slave-sub-mode"> to <literal>'stream'</literal>.
@@ -33,7 +33,7 @@
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
@@ -48,19 +48,19 @@
<listitem>
<para>
- Specifies the PostgreSQL user name to perform streaming replication check.
- The user must exist on all the PostgreSQL backends.
+ Specifies the <productname>PostgreSQL</> user name to perform streaming replication check.
+ The user must exist on all the <productname>PostgreSQL</> backends.
</para>
<note>
<para>
- <xref linkend="guc-sr-check-user"> and <xref linkend="guc-sr-check-password">
+ <varname>sr_check_user</varname>> and <xref linkend="guc-sr-check-password">
are used even when <xref linkend="guc-sr-check-period"> is set to 0 (disabled)
for the identification of the primary server.
</para>
</note>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
@@ -75,13 +75,13 @@
<listitem>
<para>
- Specifies the password of the <xref linkend="guc-sr-check-user"> PostgreSQL user
+ Specifies the password of the <xref linkend="guc-sr-check-user"> <productname>PostgreSQL</> user
to perform the streaming replication checks.
Use <literal>''</literal> (empty string) if the user does not requires a password.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
@@ -100,7 +100,7 @@
The default is <literal>"postgres"</literal>.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
@@ -122,13 +122,13 @@
SELECT</acronym> queries to the standby server and starts routing
everything to the primary server even if <xref linkend="guc-load-balance-mode">
is enabled, until the standby catches-up with the primary.
- Setting this parameter to 0 disables, the delay checking.
+ Setting this parameter to 0 disables the delay checking.
This delay threshold check is performed every <xref linkend="guc-sr-check-period">.
Default is 0.
</para>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II conf</>igurations.
</para>
</listitem>
@@ -177,7 +177,7 @@
</table>
<para>
- This parameter can be changed by reloading the pgpool configurations.
+ This parameter can be changed by reloading the <productname>Pgpool-II</> configurations.
</para>
</listitem>
diff --git a/doc/src/sgml/watchdog.sgml b/doc/src/sgml/watchdog.sgml
index 48400e5f2..09549af60 100644
--- a/doc/src/sgml/watchdog.sgml
+++ b/doc/src/sgml/watchdog.sgml
@@ -68,7 +68,7 @@
<listitem>
<para>
Specifies the port number to be used by watchdog
- process to listen for connections. Default is 9999.
+ process to listen for connections. Default is 9000.
</para>
<para>
This parameter can only be set at server start.
[parent: 370ec11830d9]