-->
<part id="appendixes">
+ <!--
<title>Appendixes</title>
+ -->
+ <title>付録</title>
<partintro>
<para>
<refnamediv>
<refname>pcp_attach_node</refname>
<refpurpose>
+ <!--
attaches the given node to Pgpool-II.</refpurpose>
+ -->
+ <productname>Pgpool-II</productname> のノードを復帰させる</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-PCP-ATTACH-NODE-1">
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
<command>pcp_attach_node</command>
+ <!--
attaches the given node to Pgpool-II.
+ -->
+ は <productname>Pgpool-II</productname> のノードを復帰させます。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
<variablelist>
<term><option>--node_id=<replaceable class="parameter">node_id</replaceable></option></term>
<listitem>
<para>
+ <!--
The index of backend node to attach.
+ -->
+ 復帰させるバックエンドノードのインデックスを指定します。
</para>
</listitem>
</varlistentry>
<varlistentry>
+ <!--
<term><option>Other options </option></term>
+ -->
+ <term><option>その他 </option></term>
<listitem>
<para>
+ <!--
See <xref linkend="pcp-common-options">.
+ -->
+ <xref linkend="pcp-common-options"> を参照してください。
</para>
</listitem>
</varlistentry>
<refnamediv>
<refname>pcp_detach_node</refname>
<refpurpose>
+ <!--
detaches the given node from Pgpool-II. Exisiting connections to Pgpool-II are forced to be disconnected.</refpurpose>
+ -->
+ <productname>Pgpool-II</productname> のノードを切り離す</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-PCP-DETACH-NODE-1">
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
<command>pcp_detach_node</command>
+ <!--
detaches the given node from Pgpool-II. Exisiting connections to Pgpool-II are forced to be disconnected.
+ -->
+ は <productname>Pgpool-II</productname> のノードを切り離します。すでに <productname>Pgpool-II</productname> に接続しているセッションは強制的に切断されます。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
<variablelist>
<term><option>--node_id=<replaceable class="parameter">node_id</replaceable></option></term>
<listitem>
<para>
+ <!--
The index of backend node to detach.
+ -->
+ 切り離すバックエンドノードのインデックスを指定します。
</para>
</listitem>
</varlistentry>
<term><option>--gracefully</option></term>
<listitem>
<para>
+ <!--
wait until all clients are disconnected (unless client_idle_limit_in_recovery is -1 or recovery_timeout is expired).
+ -->
+ すべてのクライアントが接続を終了するまでノードを復帰しません。
+ （ただし、<xref linkend="guc-client-idle-limit-in-recovery"> が -1 あるいは、<xref linkend="guc-recovery-timeout"> が設定されている場合を除く）
</para>
</listitem>
</varlistentry>
<varlistentry>
+ <!--
<term><option>Other options </option></term>
+ -->
+ <term><option>その他 </option></term>
<listitem>
<para>
+ <!--
See <xref linkend="pcp-common-options">.
+ -->
+ <xref linkend="pcp-common-options"> を参照してください。
</para>
</listitem>
</varlistentry>
displays the total number of database nodes</refpurpose>
-->
<refpurpose>
- <productname>pgpool-II</productname> の <filename>pgpool.conf</filename> で定義されたノードの総数を表示します。</refpurpose>
+ <productname>Pgpool-II</productname> の <filename>pgpool.conf</filename> で定義されたノードの総数を表示する</refpurpose>
</refnamediv>
<refsynopsisdiv>
displays the total number of database nodes defined in <filename>pgpool.conf</filename>. It does
not distinguish between nodes status, ie attached/detached. ALL nodes are counted.
-->
- <productname>pgpool-II</productname> の <filename>pgpool.conf</filename>
+ は <productname>Pgpool-II</productname> の <filename>pgpool.conf</filename>
で定義されたノードの総数を表示します。 切り離されているノードの区別はしません。
</para>
</refsect1>
<!--
<title>Example</title>
-->
- <title>出力例</title>
+ <title>例</title>
<para>
<!--
Here is an example output:
-->
- ここでは，出力例を示します。
+ ここでは例を示します。
<programlisting>
$ pcp_node_count -p 11001
Password:
<!--
displays the information on the given node ID</refpurpose>
-->
- æ\8c\87å®\9aã\81\95ã\82\8cã\81\9fã\83\8eã\83¼ã\83\89ã\81®æ\83\85å ±ã\82\92表示ã\81\97ã\81¾ã\81\99ã\80\82</refpurpose>
+ æ\8c\87å®\9aã\81\95ã\82\8cã\81\9fã\83\8eã\83¼ã\83\89ã\81®æ\83\85å ±ã\82\92表示ã\81\99ã\82\8b</refpurpose>
</refnamediv>
<refsynopsisdiv>
<!--
<title>Example</title>
-->
- <title>出力例</title>
+ <title>例</title>
<para>
<!--
Here is an example output:
-->
- ここでは，出力例を示します。
+ ここでは例を示します。
<programlisting>
$ pcp_node_info -h localhost -U postgres 0
host1 5432 1 1073741823.500000
<refnamediv>
<refname>pcp_pool_status</refname>
<refpurpose>
+ <!--
displays the parameter values as defined in <filename>pgpool.conf</filename></refpurpose>
+ -->
+ <filename>pgpool.conf</filename> のパラメータ設定値を取得する</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-PCP-POOL-STATUS-1">
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
<command>pcp_pool_status</command>
+ <!--
displays the parameter values as defined in <filename>pgpool.conf</filename>.
+ -->
+ は <filename>pgpool.conf</filename> のパラメータ設定値を表示します。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
+ <!--
See <xref linkend="pcp-common-options">.
+ -->
+ <xref linkend="pcp-common-options"> を参照してください。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Example</title>
+ -->
+ <title>例</title>
<para>
+ <!--
Here is an example output:
+ -->
+ ここでは例を示します。
<programlisting>
$ pcp_pool_status -h localhost -U postgres
name : listen_addresses
<refnamediv>
<refname>pcp_proc_count</refname>
<refpurpose>
+ <!--
displays the list of Pgpool-II children process IDs</refpurpose>
+ -->
+ <productname>Pgpool-II</productname> の子プロセスのプロセス ID を一覧表示する</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-PCP-PROC-COUNT-1">
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
<command>pcp_proc_count</command>
+ <!--
displays the list of Pgpool-II children process IDs. If there is more than one process, IDs will be delimited by a white space.
+ -->
+ は <productname> Pgpool-II</productname> の子プロセスのプロセス ID を一覧表示します。複数ある場合は空白文字で区切られます。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
+ <!--
See <xref linkend="pcp-common-options">.
+ -->
+ <xref linkend="pcp-common-options"> を参照してください。
</para>
</refsect1>
<refnamediv>
<refname>pcp_proc_info</refname>
<refpurpose>
+ <!--
displays the information on the given Pgpool-II child process ID</refpurpose>
+ -->
+ <productname>Pgpool-II</productname> の子プロセス情報を表示する</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-PCP-PROC-INFO-1">
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
<command>pcp_proc_info</command>
+ <!--
displays the information on the given Pgpool-II child process ID.
+ -->
+ は <productname>Pgpool-II</productname> の子プロセス情報を表示します。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
<variablelist>
<term><option>--process-id=<replaceable class="parameter">PID</replaceable></option></term>
<listitem>
<para>
+ <!--
PID of Pgpool-II child process.
+ -->
+ Pgpool-II 子プロセスの PID を指定します。
</para>
</listitem>
</varlistentry>
<varlistentry>
+ <!--
<term><option>Other options </option></term>
+ -->
+ <term><option>その他</option></term>
<listitem>
<para>
- See <xref linkend="pcp-common-options">.
+ <!--
+ See <xref linkend="pcp-common-options">.
+ -->
+ <xref linkend="pcp-common-options"> を参照してください。
</para>
</listitem>
</varlistentry>
</refsect1>
<refsect1>
+ <!--
<title>Example</title>
+ -->
+ <title>例</title>
<para>
+ <!--
Here is an example output:
+ -->
+ ここでは例を示します。
<programlisting>
$ pcp_proc_info -h localhost -p 9898 -U postgres 3815
postgres_db postgres 1150769932 1150767351 3 0 1 1467 1
</programlisting>
</para>
<para>
+ <!--
The result is in the following order:
+ -->
+ 結果は以下の順のとおりです。
<literallayout class="monospaced">
1. connected database name
2. connected user name
</literallayout>
</para>
<para>
+ <!--
If there is no connection to the backends, nothing will be displayed.
If there are multiple connections, one connection's information will be displayed on each line multiple times.
Timestamps are displayed in EPOCH format.
+ -->
+ コネクションがバックエンドに対して張られていない場合、データは表示されません。 コネクション情報が複数ある場合、複数行に 1 行 1 コネクション情報で表示されます。 時刻は EPOCH タイムからの秒数で表わされます。
</para>
<para>
- The <option>--verbose</option> option can help understand the output. For example:
+ <!--
+ The <option>verbose</option> option can help understand the output. For example:
+ -->
+ <option>--verbose</option> オプションは出力内容を理解するのに役に立ちます。例：
</para>
<programlisting>
$ pcp_proc_info --verbose -U postgres 3815
<refnamediv>
<refname>pcp_promote_node</refname>
<refpurpose>
+ <!--
promotes the given node as new master to Pgpool-II</refpurpose>
+ -->
+ <productname>Pgpool-II</productname> のノードをマスターに昇格させる</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-PCP-PROMOTE-NODE-1">
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
<command>pcp_promote_node</command>
+ <!--
promotes the given node as new master to Pgpool-II. In master/slave streaming replication only. Please note that this command does not actually promote standby PostgreSQL backend: it just changes the internal status of Pgpool-II and trigger failover and users have to promote standby PostgreSQL outside Pgpool-II.
+ -->
+ は <productname>Pgpool-II</productname> のノードをマスターに昇格させます。
+ これは、マスタースレーブモードで ストリーミングレプリケーション構成の場合のみ使用できます。
+ このコマンドは実際に <productname>PostgreSQL</productname> のスタンバイサーバを昇格するわけではないことに注意してください。
+ 単に <productname>Pgpool-II</productname> の内部ステータスを変更し、フェイルオーバするだけです。
+ ですので、ユーザはこのコマンドを使う際には自分で <productname>PostgreSQL</productname> のスタンバイを昇格させるようにしてください。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
<variablelist>
<term><option>--node-id=<replaceable class="parameter">node_id</replaceable></option></term>
<listitem>
<para>
+ <!--
The index of backend node to promote as new master.
+ -->
+ マスターに昇格させるバックエンドノードのインデックスを指定します。
</para>
</listitem>
</varlistentry>
<term><option>--gracefully</option></term>
<listitem>
<para>
+ <!--
Wait until all clients are disconnected (unless client_idle_limit_in_recovery is -1 or recovery_timeout is expired).
+ -->
+ すべてのクライアントが接続を終了するまでノードを復帰しません。
+ （ただし、<xref linkend="guc-client-idle-limit-in-recovery"> が -1 あるいは、
+ <xref linkend="guc-recovery-timeout"> が設定されている場合を除く）
</para>
</listitem>
</varlistentry>
<varlistentry>
+ <!--
<term><option>Other options </option></term>
+ -->
+ <term><option>その他 </option></term>
<listitem>
<para>
+ <!--
See <xref linkend="pcp-common-options">.
+ -->
+ <xref linkend="pcp-common-options"> を参照してください。
</para>
</listitem>
</varlistentry>
<refnamediv>
<refname>pcp_recovery_node</refname>
<refpurpose>
+ <!--
attaches the given backend node with recovery</refpurpose>
+ -->
+ <productname>Pgpool-II</productname> のノードのデータを再同期させた上で復帰させる</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-PCP-RECOVERY-NODE-1">
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
<command>pcp_node_info</command>
+ <!--
attaches the given backend node with recovery.
+ -->
+ は <productname>Pgpool-II</productname> のノードのデータを再同期させた上で復帰させます。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
<variablelist>
<term><option>--node-id=<replaceable class="parameter">node_id</replaceable></option></term>
<listitem>
<para>
- The index of backend node.
+ <!--
+ The index of backend node.
+ -->
+ バックエンドノードのインデックスを指定します。
</para>
</listitem>
</varlistentry>
<varlistentry>
+ <!--
<term><option>Other options </option></term>
+ -->
+ <term><option>その他 </option></term>
<listitem>
<para>
- See <xref linkend="pcp-common-options">.
+ <!--
+ See <xref linkend="pcp-common-options">.
+ -->
+ <xref linkend="pcp-common-options"> を参照してください。
</para>
</listitem>
</varlistentry>
<refnamediv>
<refname>pcp_stop_pgpool</refname>
<refpurpose>
+ <!--
terminates the Pgpool-II process</refpurpose>
+ -->
+ <productname>Pgpool-II</productname> を指定されたモードでシャットダウンする</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-PCP-STOP-PGPOOL-1">
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
<command>pcp_stop_pgpool</command>
+ <!--
terminates the Pgpool-II process.
+ -->
+ は <productname>Pgpool-II</productname> を指定されたモードでシャットダウンします。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
<variablelist>
<term><option>--mode=<replaceable class="parameter">mode</replaceable></option></term>
<listitem>
<para>
+ <!--
Shutdown mode for terminating the Pgpool-II process.
+ -->
+ シャットダウンモードを指定します。
</para>
<para>
+ <!--
The available modes are as follows:
+ -->
+ 指定できるモードは以下のとおりです。
<itemizedlist>
+ <!--
<listitem><para>s, smart : smart mode </para></listitem>
<listitem><para>f, fast : fast mode </para></listitem>
<listitem><para>i, immediate : immediate mode </para></listitem>
+ -->
+ <listitem><para>s, smart : smart モード </para></listitem>
+ <listitem><para>f, fast : fast モード </para></listitem>
+ <listitem><para>i, immediate : immediate モード </para></listitem>
</itemizedlist>
</para>
+ <para>
+ ※ 現在は fast モードと immediate シャットダウンの処理に区別はありません。 命令を送った時点でクライアントがいる・いないに関わらずシャットダウン処理を即座に行います。
+ </para>
</listitem>
</varlistentry>
<varlistentry>
+ <!--
<term><option>Other options </option></term>
+ -->
+ <term><option>その他 </option></term>
<listitem>
<para>
+ <!--
See <xref linkend="pcp-common-options">.
+ -->
+ <xref linkend="pcp-common-options"> を参照してください。
</para>
</listitem>
</varlistentry>
<refnamediv>
<refname>pg_md5</refname>
<refpurpose>
+ <!--
produces encrypted password in md5</refpurpose>
+ -->
+ md5 暗号化したパスワードを生成する</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-PG-MD5-1">
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
<command>pg_md5</command>
+ <!--
produces encrypted password in md5.
+ -->
+ md5 暗号化したパスワードを生成します。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
<variablelist>
<term><option>--prompt</option></term>
<listitem>
<para>
- Prompt password using standard input.
+ <!--
+ Prompt password using standard input.
+ -->
+ パスワードを引数に渡したくない場合は <command>pg_md5 -p</command> を実行すると標準入力からパスワードを読み込みます。
</para>
</listitem>
</varlistentry>
<term><option>--md5auth</option></term>
<listitem>
<para>
- Produce md5 authentication password.
+ <!--
+ Produce md5 authentication password.
+ -->
+ md5 認証パスワードを生成します。
</para>
</listitem>
</varlistentry>
<term><option>--username=<replaceable class="parameter">your_username</replaceable></option></term>
<listitem>
<para>
+ <!--
When producing a md5 authentication password, create the pool_passwd entry for <literal>your_username</literal>.
+ -->
+ md5 認証パスワードを生成し、<filename>pool_hba.conf</filename> に <literal>your_username</literal> の md5 認証のエントリを作成します。
</para>
</listitem>
</varlistentry>
</refsect1>
<refsect1>
+ <!--
<title>Example</title>
+ -->
+ <title>例</title>
<para>
+ <!--
Here is an example output:
+ -->
+ ここでは例を示します。
<programlisting>
pg_md5 -p
password: [your password]
</programlisting>
</para>
<para>
- or
+ または
</para>
<programlisting>
./pg_md5 foo
<refnamediv>
<refname>PGPOOL RESET</refname>
+ <!--
<refpurpose>restore the value of a configuration parameter to the default value</refpurpose>
+ -->
+ <refpurpose>設定パラメータの値をデフォルト値に戻す</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
+ <!--
<command>PGPOOL RESET</command> command restores the value of
<productname>Pgpool-II</productname> configuration parameters to
the default value.
<command>RESET</command></ulink> command in PostgreSQL with an addition
of <acronym>PGPOOL</acronym> keyword to distinguish it from the
PostgreSQL RESET command.
+ -->
+ <command>PGPOOL RESET</command> は<productname>Pgpool-II</productname> のパラメータの値をデフォルト値に戻します。
+ デフォルト値とは、現行セッション内で <command>PGPOOL SET</command>
+ コマンドが発行されなかった場合に変数が保持していた値として定義されます。
+ このコマンドは <productname>PostgreSQL</productname> の
+ <ulink url="http://www.postgresql.jp/document/9.5/html/sql-reset.html">
+ <command>RESET</command></ulink> コマンドと似っていますが、
+ <productname>PostgreSQL</productname> の <command>RESET</command> コマンドと区別するために、
+ <acronym>PGPOOL</acronym> というキーワードが追加されました。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Parameters</title>
+ -->
+ <title>パラメータ</title>
<variablelist>
<varlistentry>
<term><replaceable class="PARAMETER">configuration_parameter</replaceable></term>
<listitem>
<para>
+ <!--
Name of a settable <productname>Pgpool-II</productname> configuration parameter.
Available parameters are
documented in <xref linkend="runtime-config">.
+ -->
+ 設定可能な <productname>Pgpool-II</productname> パラメータの名前です。
+ 設定できるパラメータについては <xref linkend="runtime-config"> で説明します。
</para>
</listitem>
</varlistentry>
<term><literal>ALL</literal></term>
<listitem>
<para>
+ <!--
Resets all settable <productname>Pgpool-II</productname> configuration parameters to default values.
+ -->
+ 設定可能な全ての <productname>Pgpool-II</productname> のパラメータをデフォルト値に戻します。
</para>
</listitem>
</varlistentry>
</refsect1>
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>例</title>
<para>
- Reset the value of client_idle_limit parameter:
+ <!--
+ Reset the value of client_idle_limit parameter:
+ -->
+ <xref linkend="guc-client-idle-limit"> 設定変数をデフォルト値に設定します。
<screen>
PGPOOL RESET client_idle_limit;
</screen></para>
<para>
+ <!--
Reset the value of all parameter to default:
+ -->
+ 全パラメータの設定値をデフォルト値に戻します。
<screen>
PGPOOL RESET ALL;
</screen></para>
<refsect1>
+ <!--
<title>See Also</title>
+ -->
+ <title>関連項目</title>
<simplelist type="inline">
<member><xref linkend="SQL-PGPOOL-SET"></member>
<refnamediv>
<refname>PGPOOL SET</refname>
+ <!--
<refpurpose>change a configuration parameter</refpurpose>
+ -->
+ <refpurpose>実行時パラメータの設定を変更する</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
+ <!--
The <command>PGPOOL SET</command> command changes the value of
<productname>Pgpool-II</productname> configuration parameters for the current session.
<xref linkend="runtime-config"> can be changed on-the-fly with
<command>PGPOOL SET</command> and it only affects the value used by the current
session.
+ -->
+
+ <command>PGPOOL SET</command> は現行セッションで <productname>Pgpool-II</productname> の設定パラメータを変更します。
+ このコマンドは <productname>PostgreSQL</productname> の
+ <ulink url="http://www.postgresql.jp/document/9.5/html/sql-set.html">
+ <command>SET</command></ulink> コマンドと似っていますが、
+ <productname>PostgreSQL</productname> の <command>SET</command> コマンドと区別するために、
+ <acronym>PGPOOL</acronym> というキーワードが追加されました。
+ <xref linkend="runtime-config"> に列挙されているパラメータの多くは <command>PGPOOL SET</command> で変更ですますが、
+ 現行セッションで使用される値にのみ影響することにご注意ください。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>例</title>
<para>
+ <!--
Change the value of client_idle_limit parameter:
+ -->
+ パラメータ <xref linkend="guc-client-idle-limit"> の設定値を変更する:
+
<programlisting>
PGPOOL SET client_idle_limit = 350;
</programlisting>
</para>
<para>
- Reset the value of client_idle_limit parameter to default:
+ <!--
+ Reset the value of client_idle_limit parameter to default:
+ -->
+ パラメータ <xref linkend="guc-client-idle-limit"> の値をデフォルトの設定にリセットする:
<programlisting>
PGPOOL SET client_idle_limit TO DEFAULT;
</programlisting>
</para>
<para>
+ <!--
Change the value of log_min_messages parameter:
+ -->
+ パラメータ <xref linkend="guc-log-min-messages"> の値を変更する:
<programlisting>
PGPOOL SET log_min_messages TO INFO;
</programlisting>
</refsect1>
<refsect1>
+ <!--
<title>See Also</title>
+ -->
+ <title>関連項目</title>
<simplelist type="inline">
<member><xref linkend="SQL-PGPOOL-RESET"></member>
<refnamediv>
<refname>pgpool_setup</refname>
<refpurpose>
+ <!--
Create a temporary installation of Pgpool-II cluster</refpurpose>
+ -->
+ <productname>Pgpool-II</productname> クラスタのテスト環境を構築するツール</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-PGPOOL-SETUP-1">
- <title>
- Description
- </title>
+ <!--
+ <title>Description</title>
+ -->
+ <title>説明</title>
<para>
- <application>pgpool_setup</application> creates a temporary
+ <application>pgpool_setup</application>
+ <!--
+ creates a temporary
installation of <productname>Pgpool-II</productname> cluster, which
includes a <productname>Pgpool-II</productname> installation and
specified number of <productname>PostgreSQL</productname>
installations under current directory.
Current directory must be empty before running <application>pgpool_setup</application>.
+ -->
+ はカレントディレクトリで <productname>Pgpool-II</productname>
+ とノード数が指定できる複数の <productname>PostgreSQL</productname>
+ のクラスタテスト環境を構築するツールです。
+ カレントディレクトリは空である必要があります。
</para>
<para>
+ <!--
<application>pgpool_setup</application> is for testing purpose
only and should not be used to create production installations.
+ -->
+ <application>pgpool_setup</application> はテストのために使うツールなので、
+ 実際の業務システムで利用することはおすすめしません。
</para>
<para>
+ <!--
Currently <application>pgpool_setup</application> supports streaming replication mode, native replication mode and raw mode.
Watchdog is not supported yet.
+ -->
+ 現在、「ストリーミングレプリケーションモード」、「ネイティブレプリケーションモード」及び「raw モード」に対応しています。
+ Watchdog の対応については <xref linkend="WATCHDOG-SETUP"> をご参照下さい。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
+ <!--
<application>pgpool_setup</application> accepts the following command-line arguments:
+ -->
+ <application>pgpool_setup</application> 以下のコマンドライン引数を受け付けます:
<variablelist>
<term><option>-m <replaceable class="parameter">mode</replaceable></option></term>
<listitem>
<para>
+ <!--
Specifies the running mode. <replaceable>mode</replaceable>
can be <literal>r</literal> (native replication mode), <literal>s</literal> (streaming replication mode), or
<literal>n</literal> (raw mode).
- If this is omitted, <literal>s</literal> is used.
+ If this is omitted, <literal>s</literal> is used.
+ -->
+ 動作モードを指定します。<replaceable>mode</replaceable>は
+ <literal>r</literal> (ネイティブレプリケーションモード), <literal>s</literal> (ストリーミングレプリケーションモード)、または
+ <literal>n</literal> (raw モード)を指定できます。
+ 指定しない場合は、<literal>s</literal> (ストリーミングレプリケーションモード) です。
</para>
</listitem>
</varlistentry>
<term><option>-n <replaceable class="parameter">num_clusters</replaceable></option></term>
<listitem>
<para>
+ <!--
Specifies the number of PostgreSQL installations.
- If this is omitted, <literal>2</literal> is used.
+ If this is omitted, <literal>2</literal> is used.
+ -->
+ PostgreSQL のノード数を指定します。指定しない場合は、ノード数が 2 です。
</para>
</listitem>
</varlistentry>
<term><option>-p <replaceable class="parameter">base_port</replaceable></option></term>
<listitem>
<para>
- Specify the base port number used by Pgpool-II and PostgreSQL.
- Pgpool-II port is base_port. pcp port is base_port + 1. The
- first PostgreSQL node's port is base_port + 2, second
- PostgreSQL node's port is base_port + 3 and so on.
+ <!--
+ Specify the base port number used by Pgpool-II and PostgreSQL.
+ Pgpool-II port is base_port. pcp port is base_port + 1. The
+ first PostgreSQL node's port is base_port + 2, second
+ PostgreSQL node's port is base_port + 3 and so on.
+ ベースとなるポート番号を指定します。
+ -->
+ ベースとなるポート番号を指定します。
+ Pgpool-II のポートは base_port、pcp のポートは base_port + 1、
+ 最初の PostgreSQL ノードのポートは base_port + 2、
+ 2 番目の PostgreSQL ノードのポートは base_port + 3 というようになります。
</para>
<para>
- If -pg option is specified, the first PostgreSQL node's port is
- assigned to pg_base_port, the second PostgreSQL node's port is
- pg_base_port + 1 and so on.
+ <!--
+ If -pg option is specified, the first PostgreSQL node's port is
+ assigned to pg_base_port, the second PostgreSQL node's port is
+ pg_base_port + 1 and so on.
+ -->
+ -pg オプションを指定した場合、 最初の PostgreSQL ノードのポートは pg_base_port、
+ 2 番目の PostgreSQL ノードのポートは pg_base_port + 1 というように割り当てていきます。
+
</para>
<para>
- If this is omitted, <literal>11000</literal> is used.
+ <!--
+ If this is omitted, <literal>11000</literal> is used.
+ -->
+ 指定しない場合、ベースとなるポート番号は 11000 です。
</para>
</listitem>
</varlistentry>
<term><option>-pg <replaceable class="parameter">pg_base_port</replaceable></option></term>
<listitem>
<para>
- Specify the base port number used by PostgreSQL.
- The first PostgreSQL node's port is base_port + 2, second
- PostgreSQL node's port is base_port + 3 and so on.
+ <!--
+ Specify the base port number used by PostgreSQL.
+ The first PostgreSQL node's port is base_port + 2, second
+ PostgreSQL node's port is base_port + 3 and so on.
+ -->
+ PostgreSQL のベースとなるポート番号を指定します。
+ 最初の PostgreSQL ノードのポートは base_port + 2、
+ 2 番目の PostgreSQL ノードのポートは base_port + 3 というようになります。
</para>
<para>
- If this is omitted, <literal>base_port</literal>+2 is used.
+ <!--
+ If this is omitted, <literal>base_port</literal>+2 is used.
+ -->
+ 省略した場合は、 <literal>base_port</literal>+2 が使われます。
</para>
</listitem>
<term><option>--no-stop</option></term>
<listitem>
<para>
- Do not stop pgpool and PostgreSQL after the work.
+ <!--
+ Do not stop pgpool and PostgreSQL after the work.
+ -->
+ セットアップ終了後に <productname>Pgpool-II</productname>, PostgreSQL を終了しません。
</para>
</listitem>
</varlistentry>
<term><option>-d</option></term>
<listitem>
<para>
- Start pgpool with debug mode.
+ <!--
+ Start pgpool with debug mode.
+ -->
+ デバッグモードで <productname>Pgpool-II</productname> を起動します。
</para>
</listitem>
</varlistentry>
</refsect1>
<refsect1>
+ <!--
<title>Environment variables</title>
+ -->
+ <title>環境変数</title>
<para>
+ <!--
<application>pgpool_setup</application> recognizes following environment variables:
+ -->
+ <application>pgpool_setup</application> 以下の環境変数を使用します:
<variablelist>
<term><option>PGPOOL_INSTALL_DIR</option></term>
<listitem>
<para>
+ <!--
Specifies the Pgpool-II installation directory. Pgpool-II
binaries is expected to be placed under PGPOOL_INSTALL_DIR/bin
and pgpool.conf and pool_hba.conf etc. are expected to be placed under
PGPOOL_INSTALL_DIR/etc. The default is /usr/local.
+ -->
+ <productname>Pgpool-II</productname> のインストールディレクトリを指定します。
+ <productname>Pgpool-II</productname> バイナリーは PGPOOL_INSTALL_DIR/bin ディレクトリ以下、
+ <filename>pgpool.conf</filename> と <filename>pool_hba.conf</filename>
+ などは PGPOOL_INSTALL_DIR/etc ディレクトリ以にインストールされます。
+ デフォルトでは /usr/local ディレクトリ以下にインストールされます。
</para>
</listitem>
</varlistentry>
<term><option>PGPOOLDIR</option></term>
<listitem>
<para>
+ <!--
Specifies the path to Pgpool-II configuration files.
The default is PGPOOL_INSTALL_DIR/etc.
+ -->
+ <productname>Pgpool-II</productname> 設定ファイルへのパスを指定します。
+ デフォルトでは PGPOOL_INSTALL_DIR/etc です。
</para>
</listitem>
</varlistentry>
<term><option>PGBIN</option></term>
<listitem>
<para>
+ <!--
Specifies the path to PostgreSQL commands such as initdb, pg_ctl and psql.
The default is /usr/local/pgsql/bin.
+ -->
+ initdb、pg_ctl と psql など <productname>PostgreSQL</productname> コマンドへのパスを指定します。
+ デフォルトでは、/usr/local/pgsql/bin です。
</para>
</listitem>
</varlistentry>
<term><option>PGLIB</option></term>
<listitem>
<para>
+ <!--
Specifies the path to PostgreSQL shared libraries.
The default is /usr/local/pgsql/lib.
+ -->
+ <productname>PostgreSQL</productname> の共有ライブラリへのパスを指定します。
+ デフォルトでは、/usr/local/pgsql/lib です。
</para>
</listitem>
</varlistentry>
<term><option>PGSOCKET_DIR</option></term>
<listitem>
<para>
+ <!--
Specifies the path to Unix socket directory.
The default is /tmp.
+ -->
+ Unixソケットのディレクトリへのパスを指定します。
+ デフォルトでは /tmp です。
</para>
</listitem>
</varlistentry>
<term><option>INITDBARG</option></term>
<listitem>
<para>
- Specifies the arguments for initdb command.
- The default is "--no-locale -E UTF_8".
+ <!--
+ Specifies the arguments for initdb command.
+ The default is "no-locale -E UTF_8".
+ -->
+ initdb コマンドの引数を指定します。
+ デフォルトでは "--no-locale -E UTF_8" です。
</para>
</listitem>
</varlistentry>
</refsect1>
<refsect1>
+ <!--
<title>Example</title>
+ -->
+ <title>出力例</title>
<para>
<screen>
$ pgpool_setup
temporarily start data0 cluster to create extensions
temporarily start pgpool-II to create standby nodes
INFO: unrecognized configuration parameter "debug_level"
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 11002 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 11003 | down | 0.500000 | standby | 0 | false | 0
done.
creating follow master script
Pager usage is off.
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 11002 | up | 0.500000 | primary | 0 | false | 0
1 | /tmp | 11003 | up | 0.500000 | standby | 0 | true | 0
README.port bashrc.ports data1 log pgpool_reload run startall
archivedir data0 etc pcppass pgpool_setup.log shutdownall
-$ ./startall
+$ ./startall
waiting for server to start....11840 2016-08-18 13:08:51 JST LOG: redirecting log output to logging collector process
11840 2016-08-18 13:08:51 JST HINT: Future log output will appear in directory "pg_log".
done
Type "help" for help.
test=# show pool_nodes;
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 11002 | up | 0.500000 | primary | 0 | false | 0
1 | /tmp | 11003 | up | 0.500000 | standby | 0 | true | 0
<refnamediv>
<refname>PGPOOL SHOW</refname>
+ <!--
<refpurpose>show the value of a configuration parameter</refpurpose>
+ -->
+ <refpurpose>パラメータの設定値を表示する</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
+ <!--
<command>PGPOOL SHOW</command> will display the current value of
<productname>Pgpool-II</productname> configuration parameters.
<command>SHOW</command></ulink> command in PostgreSQL with an addition
of <acronym>PGPOOL</acronym> keyword to distinguish it from the
PostgreSQL SHOW command.
+ -->
+
+ <command>PGPOOL SHOW</command> は 実行時 <productname>Pgpool-II</productname> のパラメータの設定値を表示します。
+ このコマンドは PostgreSQL の
+ <ulink url="http://www.postgresql.jp/document/9.5/html/sql-show.html">
+ <command>SHOW</command></ulink> コマンドと似ていますが、
+ <productname>PostgreSQL</productname> の <command>SHOW</command> コマンドと区別するために、
+ <acronym>PGPOOL</acronym> というキーワードが追加されました。
+
</para>
</refsect1>
<refsect1>
+<!--
<title>Parameters</title>
+ -->
+ <title>パラメータ</title>
<variablelist>
<term><replaceable class="PARAMETER">configuration_parameter</replaceable></term>
<listitem>
<para>
+ <!--
The name of a <productname>Pgpool-II</productname> configuration parameter.
Available parameters are documented in <xref linkend="runtime-config">
+ -->
+ <productname>Pgpool-II</productname> の設定パラメータ名です。指定可能なパラメータ名は
+ <xref linkend="runtime-config"> をご参照ください。
</para>
</listitem>
</varlistentry>
<term><replaceable class="PARAMETER">configuration_parameter_group</replaceable></term>
<listitem>
<para>
+ <!--
The name of the <productname>Pgpool-II</productname> configuration parameter group.
Currently there are three parameter groups.
+ -->
+ <productname>Pgpool-II</productname> の設定パラメータのグループ名です。
+ 現在、指定可能なパラメータグループは以下の 3つです。
</para>
<variablelist>
<varlistentry>
<term><literal>backend</literal></term>
<listitem>
<para>
+ <!--
Configuration group of all backend config parameters.
+ -->
+ すべてのバックエンドグループのパラメータの設定値。
</para>
</listitem>
</varlistentry>
<term><literal>other_pgpool</literal></term>
<listitem>
<para>
+ <!--
Configuration group of all watchdog node config parameters.
+ -->
+ すべての watchdog ノードのパラメータの設定値。
</para>
</listitem>
</varlistentry>
<term><literal>heartbeat</literal></term>
<listitem>
<para>
+ <!--
configuration group of all watchdog heartbeat node config parameters.
+ -->
+ すべての watchdog heartbeat ノードのパラメータの設定値。
</para>
</listitem>
</varlistentry>
<term><literal>ALL</literal></term>
<listitem>
<para>
+ <!--
Show the values of all configuration parameters, with descriptions.
+ -->
+ すべてのパラメータの設定値と説明を表示します。
</para>
</listitem>
</varlistentry>
</refsect1>
<refsect1>
+ <!--
<title>Examples</title>
+ -->
+ <title>例</title>
<para>
+ <!--
Show the current setting of the parameter <varname>port</varname>:
+ -->
+ パラメータ <varname>port</varname> の現在の設定値を表示:
<programlisting>
PGPOOL SHOW port;
</para>
<para>
+ <!--
Show the current setting of the parameter <varname>black_function_list</varname>:
+ -->
+ パラメータ <xref linkend="guc-black-function-list"> の現在の設定値を表示:
<programlisting>
PGPOOL SHOW black_function_list;
black_function_list
</para>
<para>
+ <!--
Show the current settings of all the configuration parameters belonging to backend group:
+ -->
+ バックエンドグループのすべてのパラメータの設定値を表示する:
<programlisting>
PGPOOL SHOW backend;
item | value | description
</programlisting></para>
<para>
+ <!--
Show all settings:
+ -->
+ 全設定を表示:
<programlisting>
PGPOOL SHOW ALL;
item | value | description
</refsect1>
<refsect1>
+ <!--
<title>See Also</title>
+ -->
+ <title>関連項目</title>
<simplelist type="inline">
<member><xref linkend="SQL-PGPOOL-SET"></member>
<refnamediv>
<refname>SHOW POOL_CACHE</refname>
<refpurpose>
+ <!--
displays cache storage statistics
+ -->
+ クエリキャッシュのヒット率や、キャッシュストレージの状況を表示する
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
- SHOW POOL_CACHE
+SHOW POOL_CACHE
</synopsis>
</refsynopsisdiv>
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
<command>SHOW POOL_CACHE</command>
+ <!--
displays <link linkend="runtime-in-memory-query-cache">in memory
query cache </link> statistics if in memory query cache is
enabled. Here is an example session:
+ -->
+ は <link linkend="runtime-in-memory-query-cache"> インメモリクエリキャッシュ</link> が有効である場合に、
+ クエリキャッシュのヒット率や、キャッシュストレージの状況を表示します。 例を示します。
<programlisting>
test=# \x
\x
<refnamediv>
<refname>SHOW POOL_NODES</refname>
<refpurpose>
+ <!--
sends back a list of all configured nodes
+ -->
+ DB ノードのリストを表示する
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
- SHOW POOL_NODES
+SHOW POOL_NODES
</synopsis>
</refsynopsisdiv>
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
+ <!--
<command>SHOW POOL_NODES</command> displays the node id, the
hostname, the port, the status, the weight (only meaningful if
you use the load balancing mode), the role, the SELECT query
reset to zero upon starting up of pgpool-II. displays the
current value of
<productname>Pgpool-II</productname> configuration parameters.
+ -->
+
+ <command>SHOW POOL_NODES</command> はホスト名、ポート番号、状態、
+ 重み(ロードバランスモードで運用しているときにのみ意味があります)、
+ ノードの役割、発行された SELECT の数、ロードバランスノードであるかどうか、
+ レプリケーション遅延 (ストリーミングレプリケーションモードのみ) が表示されます。
+ 状態(status)の意味については、 <xref linkend="pcp-node-info"> リファレンスで説明されています。
+ ホスト名が "/tmp" のように表示される場合、UNIX ドメインソケットを使用して
+ <productname>Pgpool-II</productname> が <productname>PostgreSQL</productname> に接続していることを意味します。
+ SELECT の数には、<productname>Pgpool-II</productname> 内部で発行されるクエリの数は含まれません。
+ また、このカウンタは <productname>Pgpool-II</productname> がスタートした時に 0にリセットされます。
</para>
<para>
+ <!--
Here is an example session:
+ -->
+ ここでは例を示します。
<programlisting>
test=# show pool_nodes;
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 11002 | up | 0.500000 | primary | 0 | false | 0
1 | /tmp | 11003 | up | 0.500000 | standby | 0 | true | 0
<refnamediv>
<refname>SHOW POOL_POOLS</refname>
<refpurpose>
+ <!--
sends back a list of pools handled
by <productname>Pgpool-II</productname>.
+ -->
+ <productname>Pgpool-II</productname> のコネクションプールの状態を表示する
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
- SHOW POOL_POOLS
+SHOW POOL_POOLS
</synopsis>
</refsynopsisdiv>
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
- <command>SHOW pool_pools</command> sends back a list of pools
- handled by
- <productname>Pgpool-II</productname>
+ <command>SHOW pool_pools</command>
+ <!--
+ sends back a list of pools handled by <productname>Pgpool-II</productname>
+ -->
+ は <productname>Pgpool-II</productname> のコネクションプールの状態を表示します。
</para>
<para>
+ <!--
It has 11 columns:
+ -->
+ 11のカラムがあります。
<itemizedlist>
<listitem>
<para>
+ <!--
<literal>pool_pid</literal> is the PID of the
displayed <productname>Pgpool-II</productname> process.
+ -->
+ <literal>pool_pid</literal> は <productname>Pgpool-II</productname> プロセスのプロセス ID です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>start_time</literal> is the timestamp of when
this process was launched.
+ -->
+ <literal>start_time</literal> はこのプロセスが起動された時刻です (1970年1月1日からの経過秒で表示されます)。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>pool_id</literal> is the pool identifier (should
be between 0 and <xref linkend="guc-max-pool"> - 1)
+ -->
+ <literal>pool_id</literal> はコネクションプール ID です。(0 から <xref linkend="guc-max-pool"> - 1 の値です)
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>backend_id</literal> is the backend identifier (should
be between 0 and the number of configured backends minus one)
+ -->
+ <literal>backend_id</literal> は <productname>PostgreSQL</productname>
+ バックエンドの識別子です(0 からバックエンド数 - 1 の値です)
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>database</literal> is the database name for this
process's pool id connection.
+ -->
+ <literal>database</literal> はこのプロセスが接続しているデータベース名です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>username</literal> is the user name for this
process's pool id connection.
+ -->
+ <literal>username</literal> はこのプロセスの接続で使用しているユーザ名です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>create_time</literal> is the creation time and
date of the connection.
+ -->
+ <literal>create_time</literal> はこの接続が作成された時刻です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>majorversion</literal>
and <literal>minorversion</literal> are the protocol
version numbers used in this connection.
+ -->
+ <literal>majorversion</literal> と <literal>minorversion</literal>
+ はこの接続で使用されているプロトコルバージョン番号です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>pool_counter</literal> counts the number of times
this pool of connections (process) has been used by
clients.
+ -->
+ <literal>pool_counter</literal> はこの接続が使用された回数です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>pool_backendpid</literal> is the PID of the
PostgreSQL process.
+ -->
+ <literal>pool_backendpid</literal> は <productname>PostgreSQL</productname>
+ のバックエンドプロセスのプロセス ID です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>pool_connected</literal> is true (1) if a
frontend is currently using this backend.
+ -->
+ <literal>pool_connected</literal> は真偽値で、0 ならフロントエンドからの接続無し、1 なら接続ありを表します。
</para>
</listitem>
</itemizedlist>
</para>
<para>
+ <!--
It'll always return <xref linkend="guc-num-init-children"> * <xref linkend="guc-max-pool"> *
number_of_backends lines. Here is an example session:
+ -->
+ 返却行数は常に <xref linkend="guc-num-init-children"> * <xref linkend="guc-max-pool"> * 「バックエンドの数」になります。
+ ここでは例を示します。
<programlisting>
test=# show pool_pools;
- pool_pid | start_time | pool_id | backend_id | database | username | create_time | majorversion | minorversion | pool_counter | pool_backendpid | pool_connected
+ pool_pid | start_time | pool_id | backend_id | database | username | create_time | majorversion | minorversion | pool_counter | pool_backendpid | pool_connected
----------+---------------------+---------+------------+----------+----------+---------------------+--------------+--------------+--------------+-----------------+----------------
19696 | 2016-10-17 13:24:17 | 0 | 0 | postgres | t-ishii | 2016-10-17 13:35:12 | 3 | 0 | 1 | 20079 | 1
19696 | 2016-10-17 13:24:17 | 0 | 1 | postgres | t-ishii | 2016-10-17 13:35:12 | 3 | 0 | 1 | 20080 | 1
<refnamediv>
<refname>SHOW POOL_PROCESSES</refname>
<refpurpose>
+ <!--
sends back a list of all <productname>Pgpool-II</productname>
processes waiting for connections and dealing with a connection
+ -->
+ 接続待ち、あるいは接続中 <productname>Pgpool-II</productname> の子プロセスの状態を表示する
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
- SHOW POOL_PROCESSES
+SHOW POOL_PROCESSES
</synopsis>
</refsynopsisdiv>
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
+ <!--
<command>SHOW pool_processes</command> sends back a list of all
<productname>Pgpool-II</productname> processes waiting for
connections and dealing with a connection.
+ -->
+ <command>SHOW POOL_PROCESSES</command> は接続待ち、あるいは接続中
+ <productname>Pgpool-II</productname> の子プロセスの状態を表示します。
</para>
<para>
+ <!--
It has 6 columns:
+ -->
+ 6つのカラムがあります。
<itemizedlist>
<listitem>
<para>
+ <!--
<literal>pool_pid</literal> is the PID of the
displayed <productname>Pgpool-II</productname> process.
+ -->
+ <literal>pool_pid</literal> は <productname>Pgpool-II</productname> プロセスのプロセス ID です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>start_time</literal> is the timestamp of when
this process was launched.
+ -->
+ <literal>start_time</literal> はこのプロセスが起動された時刻です (1970年1月1日からの経過秒で表示されます)。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>database</literal> is the database name of the
currently active backend for this process.
+ -->
+ <literal>database</literal> はこのプロセスが接続しているデータベース名です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>username</literal> is the user name used in the
connection of the currently active backend for this
process.
+ -->
+ <literal>username</literal> はこのプロセスの接続で使用しているユーザ名です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>create_time</literal> is the creation time and
date of the connection.
+ -->
+ <literal>create_time</literal> はこの接続が作成された時刻です。
</para>
</listitem>
<listitem>
<para>
+ <!--
<literal>pool_counter</literal> counts the number of times
this pool of connections (process) has been used by
clients.
+ -->
+ <literal>pool_counter</literal> はこの接続が使用された回数です。
</para>
</listitem>
</itemizedlist>
</para>
<para>
+ <!--
Here is an example session:
+ -->
+ ここでは例を示します。
+
<programlisting>
test=# show pool_processes;
- pool_pid | start_time | database | username | create_time | pool_counter
+ pool_pid | start_time | database | username | create_time | pool_counter
----------+---------------------+----------+----------+---------------------+--------------
19696 | 2016-10-17 13:24:17 | postgres | t-ishii | 2016-10-17 13:35:12 | 1
- 19697 | 2016-10-17 13:24:17 | | | |
- 19698 | 2016-10-17 13:24:17 | | | |
- 19699 | 2016-10-17 13:24:17 | | | |
- 19700 | 2016-10-17 13:24:17 | | | |
- 19701 | 2016-10-17 13:24:17 | | | |
- 19702 | 2016-10-17 13:24:17 | | | |
- 19703 | 2016-10-17 13:24:17 | | | |
- 19704 | 2016-10-17 13:24:17 | | | |
- 19705 | 2016-10-17 13:24:17 | | | |
- 19706 | 2016-10-17 13:24:17 | | | |
- 19707 | 2016-10-17 13:24:17 | | | |
- 19708 | 2016-10-17 13:24:17 | | | |
- 19709 | 2016-10-17 13:24:17 | | | |
- 19710 | 2016-10-17 13:24:17 | | | |
- 19711 | 2016-10-17 13:24:17 | | | |
- 19712 | 2016-10-17 13:24:17 | | | |
- 19713 | 2016-10-17 13:24:17 | | | |
- 19714 | 2016-10-17 13:24:17 | | | |
- 19715 | 2016-10-17 13:24:17 | | | |
- 19716 | 2016-10-17 13:24:17 | | | |
- 19717 | 2016-10-17 13:24:17 | | | |
- 19718 | 2016-10-17 13:24:17 | | | |
- 19719 | 2016-10-17 13:24:17 | | | |
- 19720 | 2016-10-17 13:24:17 | | | |
- 20024 | 2016-10-17 13:33:46 | | | |
+ 19697 | 2016-10-17 13:24:17 | | | |
+ 19698 | 2016-10-17 13:24:17 | | | |
+ 19699 | 2016-10-17 13:24:17 | | | |
+ 19700 | 2016-10-17 13:24:17 | | | |
+ 19701 | 2016-10-17 13:24:17 | | | |
+ 19702 | 2016-10-17 13:24:17 | | | |
+ 19703 | 2016-10-17 13:24:17 | | | |
+ 19704 | 2016-10-17 13:24:17 | | | |
+ 19705 | 2016-10-17 13:24:17 | | | |
+ 19706 | 2016-10-17 13:24:17 | | | |
+ 19707 | 2016-10-17 13:24:17 | | | |
+ 19708 | 2016-10-17 13:24:17 | | | |
+ 19709 | 2016-10-17 13:24:17 | | | |
+ 19710 | 2016-10-17 13:24:17 | | | |
+ 19711 | 2016-10-17 13:24:17 | | | |
+ 19712 | 2016-10-17 13:24:17 | | | |
+ 19713 | 2016-10-17 13:24:17 | | | |
+ 19714 | 2016-10-17 13:24:17 | | | |
+ 19715 | 2016-10-17 13:24:17 | | | |
+ 19716 | 2016-10-17 13:24:17 | | | |
+ 19717 | 2016-10-17 13:24:17 | | | |
+ 19718 | 2016-10-17 13:24:17 | | | |
+ 19719 | 2016-10-17 13:24:17 | | | |
+ 19720 | 2016-10-17 13:24:17 | | | |
+ 20024 | 2016-10-17 13:33:46 | | | |
19722 | 2016-10-17 13:24:17 | test | t-ishii | 2016-10-17 13:34:42 | 1
- 19723 | 2016-10-17 13:24:17 | | | |
- 19724 | 2016-10-17 13:24:17 | | | |
- 19725 | 2016-10-17 13:24:17 | | | |
- 19726 | 2016-10-17 13:24:17 | | | |
- 19727 | 2016-10-17 13:24:17 | | | |
+ 19723 | 2016-10-17 13:24:17 | | | |
+ 19724 | 2016-10-17 13:24:17 | | | |
+ 19725 | 2016-10-17 13:24:17 | | | |
+ 19726 | 2016-10-17 13:24:17 | | | |
+ 19727 | 2016-10-17 13:24:17 | | | |
(32 rows)
</programlisting>
</para>
Pgpool-II documentation
-->
-<refentry id="SQL-SHOW-PGPOOL-STATUS">
- <indexterm zone="sql-show-pgpool-status">
+<refentry id="SQL-SHOW-POOL-STATUS">
+ <indexterm zone="sql-show-pool-status">
<primary>SHOW</primary>
</indexterm>
<refmeta>
- <refentrytitle>SHOW PGPOOL STATUS</refentrytitle>
+ <refentrytitle>SHOW POOL STATUS</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo>SQL - Language Statements</refmiscinfo>
</refmeta>
<refnamediv>
- <refname>SHOW PGPOOL STATUS</refname>
+ <refname>SHOW POOL STATUS</refname>
<refpurpose>
+ <!--
sends back the list of configuration parameters with their name,
value, and description
+ -->
+ 設定パラメータの名前と値、説明を表示する
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
- SHOW POOL_STATUS
+SHOW POOL_STATUS
</synopsis>
</refsynopsisdiv>
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
- <command>SHOW POOL_STATUS</command> displays the current value of
+ <command>SHOW POOL_STATUS</command>
+ <!--
+ displays the current value of
<productname>Pgpool-II</productname> configuration parameters.
+ -->
+ は <productname>Pgpool-II</productname> の設定パラメータの名前と値、説明を表示します。
</para>
<para>
+ <!--
This command is similar to the
<xref linkend="SQL-PGPOOL-SHOW"> command, but this is the older
version of it. It is recommended to
use <xref linkend="SQL-PGPOOL-SHOW"> instead.
+ -->
+ このコマンドは<xref linkend="SQL-PGPOOL-SHOW"> と似っていますが、
+ 古いバージョンのコマンドです。<command>SHOW POOL_STATUS</command> の代わりに、
+ <xref linkend="SQL-PGPOOL-SHOW"> を使うことを推奨します。
</para>
</refsect1>
<refsect1>
+ <!--
<title>See Also</title>
+ -->
+ <title>関連項目</title>
<simplelist type="inline">
<member><xref linkend="SQL-PGPOOL-SHOW"></member>
<refnamediv>
<refname>SHOW POOL_VERSION</refname>
<refpurpose>
+ <!--
displays a string containing
- the <productname>Pgpool-II</productname> release number.
+ the <productname>Pgpool-II</productname> release number
+ -->
+ <productname>Pgpool-II</productname> のバージョン情報を表示する
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
- SHOW POOL_VERSION
+SHOW POOL_VERSION
</synopsis>
</refsynopsisdiv>
<refsect1>
+ <!--
<title>Description</title>
+ -->
+ <title>説明</title>
<para>
- <command>SHOW pool_version</command> displays a string
+ <command>SHOW POOL_VERSION</command>
+ <!--
+ displays a string
containing the <productname>Pgpool-II</productname> release
number. Here is an example session:
+ -->
+ は <productname>Pgpool-II</productname> のバージョン情報を表示します。
+ ここでは例を示します。
<programlisting>
test=# show pool_version;
- pool_version
+ pool_version
--------------------------
3.6.0 (subaruboshi)
(1 row)
<refnamediv>
<refname>watchdog_setup</refname>
<refpurpose>
+ <!--
Create a temporary installation of Pgpool-II clusters with watchdog</refpurpose>
+ -->
+ watchdog 機能を有効にした <productname>Pgpool-II</productname> クラスタのテスト環境を構築するツール</refpurpose>
</refnamediv>
<refsynopsisdiv>
</refsynopsisdiv>
<refsect1 id="R1-WATCHDOG-SETUP-1">
- <title>
- Description
- </title>
+ <!--
+ <title>Description</title>
+ -->
+ <title>説明</title>
<para>
- <application>watchdog_setup</application> creates a temporary
+ <application>watchdog_setup</application>
+ <!--
+ creates a temporary
installation of <productname>Pgpool-II</productname> clusters with watchdog enabled, which
includes a <productname>Pgpool-II</productname> installation and
specified number of <productname>PostgreSQL</productname>
installations under current directory.
Current directory must be empty before running <application>watchdog_setup</application>.
+ -->
+ はカレントディレクトリで、watchdog 機能を有効にした <productname>Pgpool-II</productname>
+ とノード数が指定できる複数の <productname>PostgreSQL</productname>
+ のクラスタテスト環境を構築するツールです。
+ カレントディレクトリは空である必要があります。
</para>
<para>
+ <!--
<application>watchdog_setup</application> is for testing purpose
only and should not be used to create production installations.
Also please note that heartbeat is not used.
+ -->
+ <application>watchdog_setup</application> はテストのために使うツールなので、
+ 実際の業務システムで利用することはおすすめしません。また、heartbeat が使用されていないことにもご注意ください。
</para>
<para>
+ <!--
<application>watchdog_setup</application>
uses <xref linkend="pgpool-setup"> as a workhorse.
+ -->
+ <application>watchdog_setup</application> が <xref linkend="pgpool-setup"> をベースとしたツールです。
</para>
<para>
+ <!--
Currently <application>watchdog_setup</application> supports streaming replication mode, native replication mode and raw mode.
Watchdog is not supported yet.
+ -->
+ 現在、<application>watchdog_setup</application> は「ストリーミングレプリケーションモード」、「ネイティブレプリケーションモード」及び「raw モード」に対応しています。
</para>
</refsect1>
<refsect1>
+ <!--
<title>Options</title>
+ -->
+ <title>オプション</title>
<para>
+ <!--
<application>watchdog_setup</application> accepts the following command-line arguments:
+ -->
+ <application>watchdog_setup</application> 以下のコマンドライン引数を受け付けます:
<variablelist>
<term><option>-wn <replaceable class="parameter">num_pgpool</replaceable></option></term>
<listitem>
<para>
+ <!--
Specifies the number of Pgpool-II installations.
- If this is omitted, <literal>3</literal> is used.
+ If this is omitted, <literal>3</literal> is used.
+ -->
+ <productname>Pgpool-II</productname> の数を指定します。
+ 指定しない場合は 3 です。
</para>
</listitem>
</varlistentry>
<term><option>-wp <replaceable class="parameter">watchdog_base_port</replaceable></option></term>
<listitem>
<para>
- Specify the starting base port number used by Pgpool-II and
- PostgreSQL. For the first Pgpool-II, Pgpool-II port is
- watchdog_base_port. pcp port is u watchdog port is
- watchdog_base_port + 2. wd_heartbeat_port is
- watchdog_base_port + 3 (though heartbeat is not used). The
- first PostgreSQL node's port is watchdog_base_port + 4,
- second PostgreSQL node's port is watchdog_base_port + 5 and
- so on.
+ <!--
+ Specify the starting base port number used by Pgpool-II and
+ PostgreSQL. For the first Pgpool-II, Pgpool-II port is
+ watchdog_base_port. pcp port is u watchdog port is
+ watchdog_base_port + 2. wd_heartbeat_port is
+ watchdog_base_port + 3 (though heartbeat is not used). The
+ first PostgreSQL node's port is watchdog_base_port + 4,
+ second PostgreSQL node's port is watchdog_base_port + 5 and
+ so on.
+ -->
+ <productname>Pgpool-II</productname> と <productname>PostgreSQL</productname> のベースとなるポート番号を指定します。
+ 最初の Pgpool-II のポートは watchdog_base_port となります。
+ pcp のポートは u、watchdog のポートは watchdog_base_port + 2 となります。wd_heartbeat_port は watchdog_base_port + 3 (heartbeat が使われていない場合でも)。
+ 1 番目の PostgreSQL ノードのポートは watchdog_base_port + 4、
+ 2 番目の PostgreSQL ノードのポートは watchdog_base_port + 5 というようになります。
</para>
<para>
If this is omitted, <literal>50000</literal> is used.
<term><option>-m <replaceable class="parameter">mode</replaceable></option></term>
<listitem>
<para>
+ <!--
Specifies the running mode. <replaceable>mode</replaceable>
can be <literal>r</literal> (native replication mode), <literal>s</literal> (streaming replication mode), or
<literal>n</literal> (raw mode).
- If this is omitted, <literal>s</literal> is used.
+ If this is omitted, <literal>s</literal> is used.
+ -->
+ 動作モードを指定します。<replaceable>mode</replaceable>は
+ <literal>r</literal> (ネイティブレプリケーションモード), <literal>s</literal> (ストリーミングレプリケーションモード)、または
+ <literal>n</literal> (raw モード)を指定できます。
+ 指定しない場合は、<literal>s</literal> (ストリーミングレプリケーションモード) が使われます。
</para>
</listitem>
</varlistentry>
<term><option>-n <replaceable class="parameter">num_clusters</replaceable></option></term>
<listitem>
<para>
+ <!--
Specifies the number of PostgreSQL installations.
- If this is omitted, <literal>2</literal> is used.
+ If this is omitted, <literal>2</literal> is used.
+ -->
+ <productname>PostgreSQL</productname> のノード数を指定します。指定しない場合は、ノード数が 2 です。
</para>
</listitem>
</varlistentry>
<term><option>--no-stop</option></term>
<listitem>
<para>
- Do not stop pgpool and PostgreSQL after the work.
+ <!--
+ Do not stop pgpool and PostgreSQL after the work.
+ -->
+ セットアップ終了後に <productname>Pgpool-II</productname>, PostgreSQL を終了しません。
</para>
</listitem>
</varlistentry>
<term><option>-d</option></term>
<listitem>
<para>
- Start pgpool with debug mode.
+ <!--
+ Start pgpool with debug mode.
+ -->
+ デバッグモードで <productname>Pgpool-II</productname> を起動します。
</para>
</listitem>
</varlistentry>
</refsect1>
<refsect1>
+ <!--
<title>Environment variables</title>
+ -->
+ <title>環境変数</title>
<para>
+ <!--
<application>watchdog_setup</application> recognizes following environment variables:
+ -->
+ <application>pgpool_setup</application> 以下の環境変数を使用します:
<variablelist>
<term><option>PGPOOL_SETUP</option></term>
<listitem>
<para>
+ <!--
Specifies the path to pgpool_setup command. The default is
- "pgpool_setup", thus it is assumed that pgpool_setup is in the
- command search path.
+ "pgpool_setup", thus it is assumed that pgpool_setup is in the
+ command search path.
+ -->
+ <command>pgpool_setup</command> コマンドへのパスを指定します。
+ デフォルトでは "pgpool_setup" であり、
+ <command>pgpool_setup</command> がコマンドサーチパスに入っていなければなりません。
</para>
</listitem>
</varlistentry>
<term><option>PGPOOL_INSTALL_DIR</option></term>
<listitem>
<para>
+ <!--
Specifies the Pgpool-II installation directory. Pgpool-II
binaries is expected to be placed under PGPOOL_INSTALL_DIR/bin
and pgpool.conf and pool_hba.conf etc. are expected to be placed under
PGPOOL_INSTALL_DIR/etc. The default is /usr/local.
+ -->
+ <productname>Pgpool-II</productname> のインストールディレクトリを指定します。
+ <productname>Pgpool-II</productname> バイナリーは PGPOOL_INSTALL_DIR/bin ディレクトリ以下、
+ <filename>pgpool.conf</filename> と <filename>pool_hba.conf</filename>
+ などは PGPOOL_INSTALL_DIR/etc ディレクトリ以にインストールされます。
+ デフォルトでは /usr/local ディレクトリ以下にインストールされます。
</para>
</listitem>
</varlistentry>
<term><option>PGPOOLDIR</option></term>
<listitem>
<para>
+ <!--
Specifies the path to Pgpool-II configuration files.
The default is PGPOOL_INSTALL_DIR/etc.
+ -->
+ <productname>Pgpool-II</productname> 設定ファイルへのパスを指定します。
+ デフォルトでは PGPOOL_INSTALL_DIR/etc です。
</para>
</listitem>
</varlistentry>
<term><option>PGBIN</option></term>
<listitem>
<para>
+ <!--
Specifies the path to PostgreSQL commands such as initdb, pg_ctl and psql.
The default is /usr/local/pgsql/bin.
+ -->
+ initdb、pg_ctl と psql など <productname>PostgreSQL</productname> コマンドへのパスを指定します。
+ デフォルトでは、/usr/local/pgsql/bin です。
</para>
</listitem>
</varlistentry>
<term><option>PGLIB</option></term>
<listitem>
<para>
+ <!--
Specifies the path to PostgreSQL shared libraries.
The default is /usr/local/pgsql/lib.
+ -->
+ <productname>PostgreSQL</productname> の共有ライブラリへのパスを指定します。
+ デフォルトでは、/usr/local/pgsql/lib です。
</para>
</listitem>
</varlistentry>
<term><option>PGSOCKET_DIR</option></term>
<listitem>
<para>
+ <!--
Specifies the path to Unix socket directory.
The default is /tmp.
+ -->
+ Unix ソケットのディレクトリへのパスを指定します。
+ デフォルトでは /tmp です。
</para>
</listitem>
</varlistentry>
<term><option>INITDBARG</option></term>
<listitem>
<para>
- Specifies the arguments for initdb command.
- The default is "--no-locale -E UTF_8".
+ <!--
+ Specifies the arguments for initdb command.
+ The default is "no-locale -E UTF_8".
+ -->
+ initdb コマンドの引数を指定します。
+ デフォルトでは "--no-locale -E UTF_8" です。
</para>
</listitem>
</varlistentry>
</refsect1>
<refsect1>
+ <!--
<title>Example</title>
+ -->
+ <title>出力例</title>
<para>
<screen>
-$ watchdog_setup
-Satrting set up
+$ watchdog_setup
+Satrting set up
============= setting up pgpool 0 =============
Satrting set up in streaming replication mode
creating startall and shutdownall
temporarily start data0 cluster to create extensions
temporarily start pgpool-II to create standby nodes
INFO: unrecognized configuration parameter "debug_level"
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 51001 | down | 0.500000 | standby | 0 | false | 0
done.
creating follow master script
Pager usage is off.
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | false | 0
1 | /tmp | 51001 | up | 0.500000 | standby | 0 | true | 0
temporarily start data0 cluster to create extensions
temporarily start pgpool-II to create standby nodes
INFO: unrecognized configuration parameter "debug_level"
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 51001 | down | 0.500000 | standby | 0 | false | 0
done.
creating follow master script
Pager usage is off.
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 51001 | up | 0.500000 | standby | 0 | false | 0
temporarily start data0 cluster to create extensions
temporarily start pgpool-II to create standby nodes
INFO: unrecognized configuration parameter "debug_level"
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 51001 | down | 0.500000 | standby | 0 | false | 0
done.
creating follow master script
Pager usage is off.
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 51001 | up | 0.500000 | standby | 0 | false | 0
$ ls
pgpool0 pgpool1 pgpool2 shutdownall startall
-$ sh startall
+$ sh startall
waiting for server to start....16123 2016-08-18 16:26:53 JST LOG: redirecting log output to logging collector process
16123 2016-08-18 16:26:53 JST HINT: Future log output will appear in directory "pg_log".
done
test=# \q
$ pcp_watchdog_info -p 50001 -v
-Password:
-Watchdog Cluster Information
+Password:
+Watchdog Cluster Information
Total Nodes : 3
Remote Nodes : 2
Quorum state : QUORUM EXIST
Master Node Name : Linux_tishii-CF-SX3HE4BP_50004
Master Host Name : localhost
-Watchdog Node Information
+Watchdog Node Information
Node Name : Linux_tishii-CF-SX3HE4BP_50000
Host Name : localhost
Delegate IP : Not_Set
Please note that the parameter format for all PCP commands has been changed since pgpool-II 3.5.
-->
ここには <productname>Pgpool-II</productname> の PCP コマンドのリファレンス情報があります。
- PCP コマンドはネットワーク経由で複数の <productname>pgpool-II</productname> を操作する UNIX コマンドです。
- 注意：<productname>pgpool-II</productname> 3.5 より、全ての PCP コマンドのパラメータ書式が変更されています。
+ PCP コマンドはネットワーク経由で複数の <productname>Pgpool-II</productname> を操作する UNIX コマンドです。
+ 注意：<productname>Pgpool-II</productname> 3.5 より、全ての PCP コマンドのパラメータ書式が変更されています。
</para>
<sect1 id="pcp-connection-authentication">
-->
PCP ユーザ名とパスワードが <filename>$prefix/etc</filename> ディレクトリ内の <filename>pcp.conf</filename>
で宣言されている必要があります。<filename>pcp.conf</filename> が他の場所にある場合には、
- <productname>pgpool-II</productname> の起動時に <option>-F</option> オプションで指定することができます。
+ <productname>Pgpool-II</productname> の起動時に <option>-F</option> オプションで指定することができます。
</para>
</sect1>
最初の３つのフィールドはそれぞれリテラル値か、任意のものにマッチする * を指定します。
現在の接続パラメータにマッチした最初の行の password フィールドが使用されます。
（したがって、ワイルドーカードを使用する場合には、具体的なエントリーの方を先に書きます。）
- エントリーの中に : か \ を含む必要がある場合には、その文字を \ をつかってエスケープしてください。
+ エントリーの中に 「:」 か 「\」 を含む必要がある場合には、その文字を 「\」 をつかってエスケープしてください。
ホスト名 localhost はローカルマシンからの TCP と Unix ドメインソケットの両方の接続にマッチします。
</para>
-->
<appendix id="release">
+<!--
<title>Release Notes</title>
+ -->
+ <title>リリースノート</title>
<para>
The release notes contain the significant changes in each
<title>Examples</title>
<para>
- Reset the value of client_idle_limit parameter:
+ Reset the value of <xref linkend="guc-client-idle-limit"> parameter:
<screen>
PGPOOL RESET client_idle_limit;
</screen></para>
<title>Examples</title>
<para>
- Change the value of client_idle_limit parameter:
+ Change the value of <xref linkend="guc-client-idle-limit"> parameter:
<programlisting>
PGPOOL SET client_idle_limit = 350;
</programlisting>
</para>
<para>
- Reset the value of client_idle_limit parameter to default:
+ Reset the value of <xref linkend="guc-client-idle-limit"> parameter to default:
<programlisting>
PGPOOL SET client_idle_limit TO DEFAULT;
</programlisting>
</para>
<para>
- Change the value of log_min_messages parameter:
+ Change the value of <xref linkend="guc-log-min-messages"> parameter:
<programlisting>
PGPOOL SET log_min_messages TO INFO;
</programlisting>
<para>
Currently <application>pgpool_setup</application> supports streaming replication mode, native replication mode and raw mode.
- Watchdog is not supported yet.
+ To support watchdog, see <xref linkend="WATCHDOG-SETUP"> for details.
</para>
</refsect1>
temporarily start data0 cluster to create extensions
temporarily start pgpool-II to create standby nodes
INFO: unrecognized configuration parameter "debug_level"
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 11002 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 11003 | down | 0.500000 | standby | 0 | false | 0
done.
creating follow master script
Pager usage is off.
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 11002 | up | 0.500000 | primary | 0 | false | 0
1 | /tmp | 11003 | up | 0.500000 | standby | 0 | true | 0
README.port bashrc.ports data1 log pgpool_reload run startall
archivedir data0 etc pcppass pgpool_setup.log shutdownall
-$ ./startall
+$ ./startall
waiting for server to start....11840 2016-08-18 13:08:51 JST LOG: redirecting log output to logging collector process
11840 2016-08-18 13:08:51 JST HINT: Future log output will appear in directory "pg_log".
done
Type "help" for help.
test=# show pool_nodes;
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 11002 | up | 0.500000 | primary | 0 | false | 0
1 | /tmp | 11003 | up | 0.500000 | standby | 0 | true | 0
</para>
<para>
- Show the current setting of the parameter <varname>black_function_list</varname>:
+ Show the current setting of the parameter <xref linkend="guc-black-function-list">:
<programlisting>
PGPOOL SHOW black_function_list;
black_function_list
<refsynopsisdiv>
<synopsis>
- SHOW POOL_CACHE
+SHOW POOL_CACHE
</synopsis>
</refsynopsisdiv>
<refsynopsisdiv>
<synopsis>
- SHOW POOL_NODES
+SHOW POOL_NODES
</synopsis>
</refsynopsisdiv>
using UNIX domain sockets. The SELECT count does not include
internal queries used
by <productname>Pgoool-II</productname>. Also the counters are
- reset to zero upon starting up of pgpool-II. displays the
- current value of
- <productname>Pgpool-II</productname> configuration parameters.
+ reset to zero upon starting up of <productname>Pgpool-II</productname>.
</para>
<para>
Here is an example session:
<programlisting>
test=# show pool_nodes;
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 11002 | up | 0.500000 | primary | 0 | false | 0
1 | /tmp | 11003 | up | 0.500000 | standby | 0 | true | 0
<refsynopsisdiv>
<synopsis>
- SHOW POOL_POOLS
+SHOW POOL_POOLS
</synopsis>
</refsynopsisdiv>
<title>Description</title>
<para>
- <command>SHOW pool_pools</command> sends back a list of pools
+ <command>SHOW POOL_POOLS</command> sends back a list of pools
handled by
<productname>Pgpool-II</productname>
</para>
number_of_backends lines. Here is an example session:
<programlisting>
test=# show pool_pools;
- pool_pid | start_time | pool_id | backend_id | database | username | create_time | majorversion | minorversion | pool_counter | pool_backendpid | pool_connected
+ pool_pid | start_time | pool_id | backend_id | database | username | create_time | majorversion | minorversion | pool_counter | pool_backendpid | pool_connected
----------+---------------------+---------+------------+----------+----------+---------------------+--------------+--------------+--------------+-----------------+----------------
19696 | 2016-10-17 13:24:17 | 0 | 0 | postgres | t-ishii | 2016-10-17 13:35:12 | 3 | 0 | 1 | 20079 | 1
19696 | 2016-10-17 13:24:17 | 0 | 1 | postgres | t-ishii | 2016-10-17 13:35:12 | 3 | 0 | 1 | 20080 | 1
<refsynopsisdiv>
<synopsis>
- SHOW POOL_PROCESSES
+SHOW POOL_PROCESSES
</synopsis>
</refsynopsisdiv>
<title>Description</title>
<para>
- <command>SHOW pool_processes</command> sends back a list of all
+ <command>SHOW POOL_PROCESSES</command> sends back a list of all
<productname>Pgpool-II</productname> processes waiting for
connections and dealing with a connection.
</para>
Here is an example session:
<programlisting>
test=# show pool_processes;
- pool_pid | start_time | database | username | create_time | pool_counter
+ pool_pid | start_time | database | username | create_time | pool_counter
----------+---------------------+----------+----------+---------------------+--------------
19696 | 2016-10-17 13:24:17 | postgres | t-ishii | 2016-10-17 13:35:12 | 1
- 19697 | 2016-10-17 13:24:17 | | | |
- 19698 | 2016-10-17 13:24:17 | | | |
- 19699 | 2016-10-17 13:24:17 | | | |
- 19700 | 2016-10-17 13:24:17 | | | |
- 19701 | 2016-10-17 13:24:17 | | | |
- 19702 | 2016-10-17 13:24:17 | | | |
- 19703 | 2016-10-17 13:24:17 | | | |
- 19704 | 2016-10-17 13:24:17 | | | |
- 19705 | 2016-10-17 13:24:17 | | | |
- 19706 | 2016-10-17 13:24:17 | | | |
- 19707 | 2016-10-17 13:24:17 | | | |
- 19708 | 2016-10-17 13:24:17 | | | |
- 19709 | 2016-10-17 13:24:17 | | | |
- 19710 | 2016-10-17 13:24:17 | | | |
- 19711 | 2016-10-17 13:24:17 | | | |
- 19712 | 2016-10-17 13:24:17 | | | |
- 19713 | 2016-10-17 13:24:17 | | | |
- 19714 | 2016-10-17 13:24:17 | | | |
- 19715 | 2016-10-17 13:24:17 | | | |
- 19716 | 2016-10-17 13:24:17 | | | |
- 19717 | 2016-10-17 13:24:17 | | | |
- 19718 | 2016-10-17 13:24:17 | | | |
- 19719 | 2016-10-17 13:24:17 | | | |
- 19720 | 2016-10-17 13:24:17 | | | |
- 20024 | 2016-10-17 13:33:46 | | | |
+ 19697 | 2016-10-17 13:24:17 | | | |
+ 19698 | 2016-10-17 13:24:17 | | | |
+ 19699 | 2016-10-17 13:24:17 | | | |
+ 19700 | 2016-10-17 13:24:17 | | | |
+ 19701 | 2016-10-17 13:24:17 | | | |
+ 19702 | 2016-10-17 13:24:17 | | | |
+ 19703 | 2016-10-17 13:24:17 | | | |
+ 19704 | 2016-10-17 13:24:17 | | | |
+ 19705 | 2016-10-17 13:24:17 | | | |
+ 19706 | 2016-10-17 13:24:17 | | | |
+ 19707 | 2016-10-17 13:24:17 | | | |
+ 19708 | 2016-10-17 13:24:17 | | | |
+ 19709 | 2016-10-17 13:24:17 | | | |
+ 19710 | 2016-10-17 13:24:17 | | | |
+ 19711 | 2016-10-17 13:24:17 | | | |
+ 19712 | 2016-10-17 13:24:17 | | | |
+ 19713 | 2016-10-17 13:24:17 | | | |
+ 19714 | 2016-10-17 13:24:17 | | | |
+ 19715 | 2016-10-17 13:24:17 | | | |
+ 19716 | 2016-10-17 13:24:17 | | | |
+ 19717 | 2016-10-17 13:24:17 | | | |
+ 19718 | 2016-10-17 13:24:17 | | | |
+ 19719 | 2016-10-17 13:24:17 | | | |
+ 19720 | 2016-10-17 13:24:17 | | | |
+ 20024 | 2016-10-17 13:33:46 | | | |
19722 | 2016-10-17 13:24:17 | test | t-ishii | 2016-10-17 13:34:42 | 1
- 19723 | 2016-10-17 13:24:17 | | | |
- 19724 | 2016-10-17 13:24:17 | | | |
- 19725 | 2016-10-17 13:24:17 | | | |
- 19726 | 2016-10-17 13:24:17 | | | |
- 19727 | 2016-10-17 13:24:17 | | | |
+ 19723 | 2016-10-17 13:24:17 | | | |
+ 19724 | 2016-10-17 13:24:17 | | | |
+ 19725 | 2016-10-17 13:24:17 | | | |
+ 19726 | 2016-10-17 13:24:17 | | | |
+ 19727 | 2016-10-17 13:24:17 | | | |
(32 rows)
</programlisting>
</para>
Pgpool-II documentation
-->
-<refentry id="SQL-SHOW-PGPOOL-STATUS">
- <indexterm zone="sql-show-pgpool-status">
+<refentry id="SQL-SHOW-POOL-STATUS">
+ <indexterm zone="sql-show-pool-status">
<primary>SHOW</primary>
</indexterm>
<refmeta>
- <refentrytitle>SHOW PGPOOL STATUS</refentrytitle>
+ <refentrytitle>SHOW POOL STATUS</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo>SQL - Language Statements</refmiscinfo>
</refmeta>
<refnamediv>
- <refname>SHOW PGPOOL STATUS</refname>
+ <refname>SHOW POOL STATUS</refname>
<refpurpose>
sends back the list of configuration parameters with their name,
value, and description
<refsynopsisdiv>
<synopsis>
- SHOW POOL_STATUS
+SHOW POOL_STATUS
</synopsis>
</refsynopsisdiv>
<refsynopsisdiv>
<synopsis>
- SHOW POOL_VERSION
+SHOW POOL_VERSION
</synopsis>
</refsynopsisdiv>
<title>Description</title>
<para>
- <command>SHOW pool_version</command> displays a string
+ <command>SHOW POOL_VERSION</command> displays a string
containing the <productname>Pgpool-II</productname> release
number. Here is an example session:
<programlisting>
test=# show pool_version;
- pool_version
+ pool_version
--------------------------
3.6.0 (subaruboshi)
(1 row)
<para>
Currently <application>watchdog_setup</application> supports streaming replication mode, native replication mode and raw mode.
- Watchdog is not supported yet.
</para>
</refsect1>
<title>Example</title>
<para>
<screen>
-$ watchdog_setup
-Satrting set up
+$ watchdog_setup
+Satrting set up
============= setting up pgpool 0 =============
Satrting set up in streaming replication mode
creating startall and shutdownall
temporarily start data0 cluster to create extensions
temporarily start pgpool-II to create standby nodes
INFO: unrecognized configuration parameter "debug_level"
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 51001 | down | 0.500000 | standby | 0 | false | 0
done.
creating follow master script
Pager usage is off.
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | false | 0
1 | /tmp | 51001 | up | 0.500000 | standby | 0 | true | 0
temporarily start data0 cluster to create extensions
temporarily start pgpool-II to create standby nodes
INFO: unrecognized configuration parameter "debug_level"
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 51001 | down | 0.500000 | standby | 0 | false | 0
done.
creating follow master script
Pager usage is off.
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 51001 | up | 0.500000 | standby | 0 | false | 0
temporarily start data0 cluster to create extensions
temporarily start pgpool-II to create standby nodes
INFO: unrecognized configuration parameter "debug_level"
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 51001 | down | 0.500000 | standby | 0 | false | 0
done.
creating follow master script
Pager usage is off.
- node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
+ node_id | hostname | port | status | lb_weight | role | select_cnt | load_balance_node | replication_delay
---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
0 | /tmp | 51000 | up | 0.500000 | primary | 0 | true | 0
1 | /tmp | 51001 | up | 0.500000 | standby | 0 | false | 0
$ ls
pgpool0 pgpool1 pgpool2 shutdownall startall
-$ sh startall
+$ sh startall
waiting for server to start....16123 2016-08-18 16:26:53 JST LOG: redirecting log output to logging collector process
16123 2016-08-18 16:26:53 JST HINT: Future log output will appear in directory "pg_log".
done
test=# \q
$ pcp_watchdog_info -p 50001 -v
-Password:
-Watchdog Cluster Information
+Password:
+Watchdog Cluster Information
Total Nodes : 3
Remote Nodes : 2
Quorum state : QUORUM EXIST
Master Node Name : Linux_tishii-CF-SX3HE4BP_50004
Master Host Name : localhost
-Watchdog Node Information
+Watchdog Node Information
Node Name : Linux_tishii-CF-SX3HE4BP_50000
Host Name : localhost
Delegate IP : Not_Set
projects / pgpool2.git / commitdiff