1<!-- doc/src/sgml/config.sgml -->
2
3<chapter id="runtime-config">
4 <!--
5 <title>Server Configuration</title>
6 -->
7 <title>サーバの設定</title>
8
9 <indexterm>
10  <!--
11  <primary>configuration</primary>
12  <secondary>of the server</secondary>
13  -->
14  <primary>設定</primary>
15  <secondary>サーバの</secondary>
16 </indexterm>
17
18 <para>
19  <!--
20  There are many configuration parameters that affect the behavior of
21  <productname>Pgpool-II</productname>. In the first section of this chapter we
22  describe how to interact with configuration parameters. The subsequent sections
23  discuss each parameter in detail.
24  -->
25  <productname>Pgpool-II</productname>の動作に影響を与える数多くのパラメータがあります。
26  この章の最初の節で、どのように設定パラメータを操作するのかについて説明します。
27  引き続く節で、それぞれのパラメータの詳細を説明します。
28 </para>
29
30 <sect1 id="config-setting">
31  <!--
32  <title>Setting Parameters</title>
33  -->
34  <title>パラメータの設定</title>
35
36  <sect2 id="config-setting-names-values">
37   <!--
38   <title>Parameter Names and Values</title>
39   -->
40   <title>パラメータ名とその値</title>
41
42   <para>
43    <!--
44    All parameter names are case-insensitive. Every parameter takes a
45    value of one of five types: boolean, string, integer, floating point,
46    or enumerated (enum).  The type determines the syntax for setting the
47    parameter:
48    -->
49    全てのパラメータの名前は大文字と小文字を区別しません。
50    それぞれのパラメータは、論理値、整数、浮動小数点、文字列、またはenum（列挙型）の5つの型のいずれかの値を取ります。
51    型はパラメータをセットするための記法を定義します。
52   </para>
53
54   <itemizedlist>
55    <listitem>
56     <para>
57      <!--
58      <emphasis>Boolean:</emphasis>
59      -->
60      <emphasis>論理型:</emphasis>
61      <!--
62      Values can be written as
63      -->
64      値は以下のいずれかを取ることができます。
65      <literal>on</literal>,
66      <literal>off</literal>,
67      <literal>true</literal>,
68      <literal>false</literal>,
69      <literal>yes</literal>,
70      <literal>no</literal>,
71      <literal>1</literal>,
72      <literal>0</literal>
73      <!--
74      (all case-insensitive) or any unambiguous prefix of one of these.
75      -->
76      (すべて大文字小文字の区別なし) あるいは、曖昧でなければこれらの先頭から数文字を省略して使うこともできます。
77     </para>
78    </listitem>
79
80    <listitem>
81     <para>
82      <!--
83      <emphasis>String:</emphasis>
84      -->
85      <emphasis>文字列型:</emphasis>
86      <!--
87      In general, enclose the value in single quotes, doubling any single
88      quotes within the value.  Quotes can usually be omitted if the value
89      is a simple number or identifier, however.
90      -->
91      一般に、単一引用符の中に値を入れます。
92      単一引用符を値として使う場合は単一引用符を重ねます。
93      なお、値が単純な数字や識別子である場合は、通常引用符は省略できます。
94     </para>
95    </listitem>
96
97    <listitem>
98     <para>
99      <!--
100      <emphasis>Numeric (integer and floating point):</emphasis>
101      -->
102      <emphasis>数値型(整数型と浮動小数点型):</emphasis>
103      <!--
104      A decimal point is permitted only for floating-point parameters.
105      Do not use thousands separators.  Quotes are not required.
106      -->
107      小数点は浮動小数点型のパラメータでのみ使用できます。
108      1000の位取りは使わないでください。
109      引用符は必要ありません。
110     </para>
111    </listitem>
112
113    <listitem>
114     <para>
115      <!--
116      <emphasis>Enumerated:</emphasis>
117      -->
118      <emphasis>列挙型:</emphasis>
119      <!--
120      Enumerated-type parameters are written in the same way as string
121      parameters, but are restricted to have one of a limited set of
122      values. Enum parameter values are case-insensitive.
123      -->
124      列挙型のパラメータは文字列パラメータと同じように記述します。
125      ただ、使用できる文字列の種類が決まっているだけです。
126      列挙型の値は大文字小文字を区別しません。
127     </para>
128    </listitem>
129   </itemizedlist>
130  </sect2>
131
132  <sect2 id="config-setting-configuration-file">
133   <!--
134   <title>Parameter Interaction via the Configuration File</title>
135   -->
136   <title>設定ファイルによるパラメータ操作</title>
137
138   <para>
139    <!--
140    The most fundamental way to set these parameters is to edit the file
141    <filename>pgpool.conf</><indexterm><primary>pgpool.conf</></>,
142    which is located in <literal>$prefix/etc/pgpool.conf</literal>.
143    An example of what this file might look like is:
144    -->
145    これらのパラメータを設定する最も基本的な方法は、<filename>pgpool.conf</><indexterm><primary>pgpool.conf</></>ファイルを編集することで、これは通常<literal>$prefix/ext/pgpool.conf</literal>に配置されています。
146    このファイルがどういったものかの例を示します。
147    <programlisting>
148     # This is a comment
149     listen_addresses = 'localhost'
150     port = 9999
151     serialize_accept = off
152     reset_query_list = 'ABORT; DISCARD ALL'
153    </programlisting>
154
155    <!--
156    One parameter is specified per line. The equal sign between name and
157    value is optional. Whitespace is insignificant (except within a quoted
158    parameter value) and blank lines are
159    ignored. Hash marks (<literal>#</literal>) designate the remainder
160    of the line as a comment.  Parameter values that are not simple
161    identifiers or numbers must be single-quoted.  To embed a single
162    quote in a parameter value, write either two quotes (preferred)
163    or backslash-quote.
164    -->
165    1つの行毎に1つのパラメータが指定されます。
166    名前と値の間の等号はオプションです。
167    引用符の中の空白（white space）を除き、空白は特に意味を持たず、何もない行は無視されます。
168    ハッシュ記号（<literal>#</literal>）はその行の後の表記がコメントであることを意味します。
169    単純でない識別子、または数値でないパラメータ値は単一引用符で括られなければなりません。
170    パラメータ値の中に単一引用符を埋め込む場合、二重引用符（推奨）もしくはバックスラッシュ-引用符で括ります。
171
172   </para>
173
174   <para>
175    <!--
176    Parameters set in this way provide default values for the cluster.
177    The settings seen by active sessions will be these values unless they
178    are overridden.  The following sections describe ways in which the
179    administrator or user can override these defaults.
180    -->
181    この方法によりクラスタに対してデフォルト値が設定されます。
182    上書きされない限り、アクティブなセッションが見るのはこの値です。
183    次の節では、管理者やユーザがこれらのデフォルト値を上書きする方法を説明します。
184   </para>
185
186   <para>
187    <indexterm>
188     <primary>SIGHUP</primary>
189    </indexterm>
190    <!--
191    The configuration file is reread whenever the main server process
192    receives a <systemitem>SIGHUP</> signal; this signal is most easily
193    sent by running <literal>pgpool reload</> from the command line. The main
194    pgpool process also propagates this signal to all its child
195    processes, so that existing sessions also adopt the new values.
196    Some parameters can only be set at server start; any changes to their
197    entries in the configuration file will be ignored until the server is restarted.
198    Invalid parameter settings in the configuration file are likewise
199    ignored (but logged) during <systemitem>SIGHUP</> processing.
200    -->
201    設定ファイルはメインサーバプロセスが<systemitem>SIGHUP</>信号を受け取ると何時でも 再読み込みされます。
202    手っ取り早く行なうには、コマンドラインから<literal>pgpool reload</>を実行します。
203    メインpgpoolプロセスは同時にこの信号を、現存のセッションが同様に新しい値を入手できるように、全ての子プロセスに伝播します。
204    いくつかのパラメータはサーバの起動時のみ設定されます;
205    設定ファイル中のそれらのエントリのいかなる変更も、サーバが再起動されるまで無視されます。
206    設定ファイル内で無効なパラメータが設定された場合は同様に（ログには残りますが）<systemitem>SIGHUP</>処理中に無視されます。
207   </para>
208  </sect2>
209
210  <sect2 id="config-setting-sql-command-interaction">
211   <!--
212   <title>Parameter Interaction via SQL Clients</title>
213   -->
214   <title>SQLを通じたパラメータ操作</title>
215
216   <para>
217    <!--
218    <productname>Pgpool-II</productname> also provides two SQL style
219    commands to interact with session-local configuration settings.
220    -->
221    <productname>Pgpool-II</productname>はまた2つのSQL形式のコマンドを使ってセッションローカルの設定の参照や変更を行うことができます。
222   </para>
223
224   <itemizedlist>
225    <listitem>
226     <para>
227      <!--
228      The <xref linkend="SQL-PGPOOL-SHOW"> command allows inspection of the
229      current value of all parameters.
230      -->
231      <xref linkend="SQL-PGPOOL-SHOW">コマンドを使ってすべてのパラメータの現在の値を調べることができます。
232     </para>
233    </listitem>
234
235    <listitem>
236     <para>
237      <!--
238      The <xref linkend="SQL-PGPOOL-SET"> command allows modification of the
239      current value of those parameters that can be set locally to a
240      session; it has no effect on other sessions.
241      -->
242      <xref linkend="SQL-PGPOOL-SET">コマンドを使ってセッション内でローカルに変更できるパラメータの値を変更することができます。
243       他のセッションには影響を与えません。
244     </para>
245    </listitem>
246   </itemizedlist>
247
248  </sect2>
249 </sect1>
250
251