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