1<!-- doc.ja/src/sgml/installation.sgml -->
2
3<chapter id="installation">
4 <!--
5 <title>Installation of <productname>Pgpool-II</productname></title>
6 -->
7 <title><productname>Pgpool-II</productname>のインストール</title>
8 <indexterm zone="installation">
9  <!--
10  <primary>installation</primary>
11  -->
12  <primary>インストール</primary>
13 </indexterm>
14
15 <sect1 id="install-source">
16  <!--
17  <title>Installation of Pgpool-II</title>
18  -->
19  <title>Pgpool-IIのインストール</title>
20  <para>
21   <!--
22   This chapter describes the installation
23   of <productname>Pgpool-II</productname>.  First, installation from
24   source code distribution is explained. Then installation from RPM
25   packages is explained.
26   -->
27   この章は<productname>Pgpool-II</productname>のインストールについて書かれています。
28   最初に、ソースコード配布物からのインストールについて説明します。
29   その後、RPMパッケージからのインストールについて説明します。
30  </para>
31 </sect1>
32
33 <sect1 id="install-requirements">
34  <!--
35  <title>Requirements</title>
36  -->
37  <title>必要条件</title>
38
39  <para>
40   <!--
41   In general, a modern Unix-compatible platform should be able to run
42   <productname>Pgpool-II</>. Windows is not supported.
43   -->
44   通常、最近のUnix互換プラットフォームならば<productname>Pgpool-II</>を動作させることができるはずです。
45   Windows はサポートされてません。
46  </para>
47
48  <para>
49   <!--
50   The following software packages are required for building
51   <productname>Pgpool-II</>:
52   -->
53   <productname>Pgpool-II</>を構築するには以下のソフトウェアパッケージが必要です。
54   <itemizedlist>
55    <listitem>
56     <para>
57      <indexterm>
58       <primary>make</primary>
59      </indexterm>
60
61      <!--
62      <acronym>GNU</> <application>make</> version 3.80 or newer is required; other
63      <application>make</> programs or older <acronym>GNU</> <application>make</> versions will <emphasis>not</> work.
64      (<acronym>GNU</> <application>make</> is sometimes installed under
65      the name <filename>gmake</filename>.)  To test for <acronym>GNU</acronym>
66      <application>make</application> enter:
67      -->
68      <acronym>GNU</> <application>make</>のバージョン3.80以上が必要です。
69      他の<application>make</>や古い<acronym>GNU</> <application>make</>では<emphasis>動作しません</>。
70      (<acronym>GNU</> <application>make</>はときどき<filename>gmake</filename>という名前でインストールされます。)
71      <acronym>GNU</acronym> <application>make</>の試験を行うためには以下を実行してください。
72      <screen>
73       <userinput>make --version</userinput>
74      </screen>
75     </para>
76    </listitem>
77
78    <listitem>
79     <para>
80      <!--
81      You need an <acronym>ISO</>/<acronym>ANSI</> C compiler (at least
82      C89-compliant). Recent
83      versions of <productname>GCC</> are recommended, but
84      <productname>Pgpool-II</> is known to build using a wide variety
85      of compilers from different vendors.
86      -->
87      <acronym>ISO</>/<acronym>ANSI</> Cコンパイラ(最低限C89-準拠)が必要です。
88      <productname>GCC</> の最近のバージョンをお勧めしますが、<productname>Pgpool-II</>は異なるベンダの、様々なコンパイラを使用して構築できることで知られています。
89     </para>
90    </listitem>
91
92    <listitem>
93     <para>
94      <!--
95      <application>tar</> is required to unpack the source
96      distribution, in addition to <application>gzip</>.
97      -->
98      配布物を展開するために、<application>tar</>および<application>gzip</>が必要です。
99     </para>
100    </listitem>
101
102   </itemizedlist>
103  </para>
104
105  <para>
106   <!--
107   If you are building from a <productname>Git</productname> tree instead of
108   using a released source package, or if you want to do server development,
109   you also need the following packages:
110   -->
111   リリースされたソースパッケージではなく<productname>Git</productname>ツリーからの構築の場合、またはサーバ開発を行いたい場合には、以下のパッケージも必要となります。
112  </para>
113
114  <para>
115   <itemizedlist>
116    <listitem>
117     <para>
118      <indexterm>
119       <primary>flex</primary>
120      </indexterm>
121      <indexterm>
122       <primary>lex</primary>
123      </indexterm>
124      <indexterm>
125       <primary>bison</primary>
126      </indexterm>
127      <indexterm>
128       <primary>yacc</primary>
129      </indexterm>
130
131      <!--
132      <application>Flex</> and <application>Bison</>
133      are needed to build from a Git checkout, or if you changed the actual
134      scanner and parser definition files. If you need them, be sure
135      to get <application>Flex</> 2.5.31 or later and
136      <application>Bison</> 1.875 or later. Other <application>lex</>
137      and <application>yacc</> programs cannot be used.
138      -->
139      <application>Flex</>および<application>Bison</>は、Gitチェックアウトから構築する場合や、実際のスキャナとパーサの定義ファイルを変更した場合に必要となります。
140      それらが必要な場合は、<application>Flex</> 2.5.31以降と<application>Bison</> 1.875以降を使うようにしてください。
141      他の<application>lex</>と<application>yacc</>プログラムは使用できません。
142     </para>
143    </listitem>
144
145   </itemizedlist>
146  </para>
147
148  <para>
149   <!--
150   If you need to get a <acronym>GNU</acronym> package, you can find
151   it at your local <acronym>GNU</acronym> mirror site (see <ulink
152   url="http://www.gnu.org/order/ftp.html"></>
153   for a list) or at <ulink
154   url="ftp://ftp.gnu.org/gnu/"></ulink>.
155   -->
156   <acronym>GNU</acronym>パッケージの入手が必要な場合、近くの<acronym>GNU</acronym>ミラーサイトから探してください(ミラーサイトの一覧は<ulink url="http://www.gnu.org/order/ftp.html"></>にあります)。
157   または、<ulink url="ftp://ftp.gnu.org/gnu/"></ulink>から探してください。
158  </para>
159
160  <para>
161   <!--
162   Also check that you have sufficient disk space. You will need about
163   40 MB for the source tree during compilation and about 20 MB for
164   the installation directory. If you are going to
165   run the regression tests you will temporarily need up to an extra
166   4 GB. Use the <command>df</command> command to check free disk
167   space.
168   -->
169   また、十分なディスク領域があることも確認してください。
170   コンパイル中、ソースツリーのために40メガバイト、インストールディレクトリに20メガバイトほど必要となります。
171   リグレッションテストを実行する場合は、一時的に最大で4ギガバイトの領域がさらに必要になります。
172   ディスクの空き容量を確認するためには<command>df</command>コマンドを使います。
173  </para>
174 </sect1>
175
176 <sect1 id="install-getsource">
177  <!--
178  <title>Getting The Source</title>
179  -->
180  <title>ソースの入手</title>
181
182  <para>
183   <!--
184   The <productname>Pgpool-II</> &version; sources can be obtained
185   from the download section of our
186   website: <ulink url="http://www.pgpool.net"></ulink>.  You should
187   get a file
188   named <filename>pgpool-II-&version;.tar.gz</filename>. After you
189   have obtained the file, unpack it:
190   -->
191   <productname>Pgpool-II</>のソースは、Webサイト<ulink url="http://www.pgpool.net"></ulink>のダウンロードページから入手することができます。
192   <filename>pgpool-II-&version;.tar.gz</filename>という名前のファイルを入手してください。
193   ファイルを入手したら、展開します。
194   <screen>
195    <userinput>tar xf pgpool-II-&version;.tar.gz</userinput>
196   </screen>
197   <!--
198   This will create a directory
199   <filename>pgpool-II-&version;</filename> under the current directory
200   with the <productname>Pgpool-II</> sources.
201   Change into that directory for the rest
202   of the installation procedure.
203   -->
204   これにより、カレントディレクトリ以下に<filename>pgpool-II-&version;</filename>というディレクトリが作成され、<productname>Pgpool-II</productname>のソースが展開されます。
205   この後のインストール手順を行うために、このディレクトリに移動してください。
206  </para>
207
208 </sect1>
209
210 <sect1 id="install-pgpool">
211  <!--
212  <title>Installing Pgpool-II</title>
213  -->
214  <title>Pgpool-IIのインストール</title>
215  <para>
216   <!--
217   After extracting the source tarball, execute the <filename>configure</> script.
218   -->
219   ソースのtarballを展開したら、<filename>configure</>スクリプトを実行します。
220   <programlisting>
221    ./configure
222   </programlisting>
223  </para>
224
225  <para>
226   <!--
227   You can customize the build and installation process by supplying one
228   or more of the following command line options to
229   <filename>configure</filename>:
230   -->
231   <filename>configure</filename>に以下のコマンドラインオプションを1つ以上指定することで、構築処理やインストール処理を変更することができます。
232  </para>
233
234  <variablelist>
235
236   <varlistentry>
237    <term><option>--prefix=path</option></term>
238    <listitem>
239     <para>
240      <!--
241      Specifies the top directory where <productname>Pgpool-II</> binaries and related
242      files like docs will be installed in. Default value is <filename>/usr/local</filename>.
243      -->
244      <productname>Pgpool-II</>バイナリやドキュメントなどの関連ファイルがインストールされるトップディレクトリを指定します。
245      デフォルトは<filename>/usr/local</filename>です。
246     </para>
247    </listitem>
248   </varlistentry>
249
250   <varlistentry>
251    <term><option>--with-pgsql=path</option></term>
252    <listitem>
253     <para>
254      <!--
255      Specifies the top directory where <productname>PostgreSQL</>'s client libraries are
256      installed. Default value is the path provided by <command>pg_config</command> command.
257      -->
258      <productname>PostgreSQL</>のクライアントライブラリなどがインストールされているトップディレクトリを指定します。
259      デフォルト値は<command>pg_config</command>コマンドで取得できるパスです。
260     </para>
261    </listitem>
262   </varlistentry>
263
264   <varlistentry>
265    <term><option>--with-openssl</option></term>
266    <listitem>
267     <para>
268      <!--
269      <productname>Pgpool-II</productname> binaries will be built
270      with <productname>OpenSSL</productname>
271      support.  <productname>OpenSSL</productname> support is
272      disabled by default.
273      -->
274      <productname>Pgpool-II</productname>バイナリが<productname>OpenSSL</productname>サポート付で構築されます。
275      デフォルトでは<productname>OpenSSL</productname>サポートは無効です。
276     </para>
277    </listitem>
278   </varlistentry>
279
280   <varlistentry>
281    <term><option>--enable-sequence-lock</option></term>
282    <listitem>
283     <para>
284      <!--
285      Use insert_lock compatible
286      with <productname>Pgpool-II</productname> 3.0 series
287      (until 3.0.4).  <productname>Pgpool-II</productname> locks
288      against a row in the sequence
289      table. <productname>PostgreSQL</productname> 8.2 or later
290      which was released after June 2011 cannot use this lock
291      method.
292      -->
293      <productname>Pgpool-II</productname> 3.0シリーズ (3.0.4まで) 互換の insert_lock を使用します。
294      <productname>Pgpool-II</productname>は、シーケンステーブルの行に対してロックを行います。
295      2011年06月より後にリリースされた<productname>PostgreSQL</productname> 8.2以降ではこのロック方式は使用できません。
296     </para>
297    </listitem>
298   </varlistentry>
299
300   <varlistentry>
301    <term><option>--enable-table-lock</option></term>
302    <listitem>
303     <para>
304      <!--
305      Use insert_lock compatible
306      with <productname>Pgpool-II</productname> 2.2 and 2.3
307      series.  <productname>Pgpool-II</productname> locks
308      against the insert target table.  This lock method is
309      deprecated because it causes a lock conflict
310      with <command>VACUUM</command>.
311      -->
312      <productname>Pgpool-II</productname> 2.2と2.3シリーズ互換のinsert_lockを使用します。
313      <productname>Pgpool-II</productname>は、挿入対象のテーブルに対してロックを行ないます。
314      このロック方式は<command>VACUUM</command>とロック競合するため非推奨です。
315     </para>
316    </listitem>
317   </varlistentry>
318
319   <varlistentry>
320    <term><option>--with-memcached=path</option></term>
321    <listitem>
322     <para>
323      <!--
324      <productname>Pgpool-II</productname> binaries will use <productname>memcached</productname> for in
325      memory query cache.  You have to
326      install <ulink url="http://libmemcached.org/libMemcached.html">libmemcached</ulink>.
327      -->
328      <productname>Pgpool-II</productname>バイナリはインメモリクエリキャッシュのキャッシュストレージに<productname>memcached</productname>を利用します。
329      <ulink url="http://libmemcached.org/libMemcached.html">libMemcached</ulink>のインストールが必要です
330     </para>
331    </listitem>
332   </varlistentry>
333
334   <varlistentry>
335    <term><option>--with-pam</option></term>
336    <listitem>
337     <para>
338      <!--
339      <productname>Pgpool-II</productname> binaries will be built with PAM authentication support.
340      PAM authentication support is disabled by default.
341      -->
342      <productname>Pgpool-II</productname>バイナリがPAM認証サポート付で構築されます。
343      デフォルトでは、PAM認証サポートは無効です。
344     </para>
345    </listitem>
346   </varlistentry>
347
348  </variablelist>
349
350  <para>
351   <programlisting>
352    make
353    make install
354   </programlisting>
355   <!--
356   This will install <productname>Pgpool-II</>. (If you use <productname>Solaris</> or <productname>FreeBSD</>, replace make with gmake)
357   -->
358   これにより<productname>Pgpool-II</>がインストールされます。
359   (<productname>Solaris</>または<productname>FreeBSD</>を使用している場合は<command>make</>を<command>gmake</>で置き換えて下さい。)
360  </para>
361
362 </sect1>
363
364 <sect1 id="install-pgpool-recovery">
365  <!--
366  <title>Installing pgpool_recovery</title>
367  -->
368  <title>pgpool_recoveryのインストール</title>
369  <para>
370   <!--
371   This is required in all <productname>Pgpool-II</productname>
372   installation.
373   -->
374   これは全ての<productname>Pgpool-II</productname>のインストールで必要です。
375   <programlisting>
376    $ cd pgpool-II-x.x.x/src/sql/pgpool-recovery
377    $ make
378    $ make install
379   </programlisting>
380   <!--
381   After this:
382   -->
383   この後に以下か、
384   <programlisting>
385    $ psql template1
386    =# CREATE EXTENSION pgpool_recovery;
387   </programlisting>
388
389   <!--
390   or
391   -->
392   または
393   <programlisting>
394    $ psql -f pgpool-recovery.sql template1
395   </programlisting>
396   を実行します。
397
398  </para>
399
400  <para>
401   <!--
402   With <productname>Pgpool-II</productname> 3.3 or later, you need
403   to tweak <filename>postgresql.conf</filename>.  Suppose the path
404   to <command>pg_ctl</command>
405   is <filename>/usr/local/pgsql/bin/pg_ctl</filename>. Then you
406   add following to <filename>postgresql.conf</filename>.
407   -->
408   <productname>Pgpool-II</productname> 3.3 以降では、<filename>postgresql.conf</filename>を変更する必要があります。
409   <command>pg_ctl</command>へのパスが<filename>/usr/local/pgsql/bin/pg_ctl</filename>であるとします。
410   その場合、<filename>postgresql.conf</filename>に以下を追加してください。
411
412   <programlisting>
413    pgpool.pg_ctl = '/usr/local/pgsql/bin/pg_ctl'
414   </programlisting>
415
416   <!--
417   Probably you want to execute following after this:
418   -->
419   もしかするとその後に以下を実行する必要があるかもしれません。
420   <programlisting>
421    $ pg_ctl reload -D /usr/local/pgsql/data
422   </programlisting>
423
424  </para>
425 </sect1>
426
427 <sect1 id="install-pgpool-regclass">
428  <!--
429  <title>Installing pgpool-regclass</title>
430  -->
431  <title>pgpool-regclassのインストール</title>
432  <para>
433   <!--
434   If you are using <productname>PostgreSQL</productname> 9.4 or
435   later, you can skip this section.
436   -->
437   <productname>PostgreSQL</productname> 9.4以降を使用している場合には、本節は飛ばすことができます。
438  </para>
439
440  <para>
441   <!--
442   If you are using <productname>PostgreSQL</productname> 8.0
443   to <productname>PostgreSQL</productname> 9.3, installing
444   <function>pgpool_regclass</function> function on
445   all <productname>PostgreSQL</productname> to be accessed by
446   <productname>Pgpool-II</productname> is strongly recommended, as
447   it is used internally by <productname>Pgpool-II</productname>.
448   Without this, handling of duplicate table names in different
449   schema might cause trouble (temporary tables aren't a problem).
450   If you are using <productname>PostgreSQL</productname> 9.4 or
451   later, installing <function>pgpool_regclass</function> is not
452   necessary since an equivalent (<function>to_regclass</function>)
453   is included in the <productname>PostgreSQL</productname> core.
454   -->
455   <productname>PostgreSQL</productname> 8.0から<productname>PostgreSQL</productname> 9.3までを使用している場合は、<productname>Pgpool-II</productname> がアクセスする全ての<productname>PostgreSQL</productname>において<function>pgpool_regclass</function> 関数をインストールすることを強く推奨します。
456   <productname>Pgpool-II</productname>から内部的に使用されるからです。
457   これがないと、異なるスキーマの間で重複するテーブル名を扱う際の不具合の原因となります。
458   (一時テーブルの場合は問題となりません。)
459   <productname>PostgreSQL</productname> 9.4以降を使用している場合は、同等の関数(<function>to_regclass</function>)が<productname>PostgreSQL</productname>に含まれているため、<function>pgpool_regclass</function>のインストールは必要ありません。
460  </para>
461
462  <para>
463   <programlisting>
464    $ cd pgpool-II-x.x.x/src/sql/pgpool-regclass
465    $ make
466    $ make install
467   </programlisting>
468   <!--
469   After this:
470   -->
471   この後に以下か、
472
473   <programlisting>
474    $ psql template1
475    =# CREATE EXTENSION pgpool_regclass;
476   </programlisting>
477
478   <!--
479   or
480   -->
481   または
482
483   <programlisting>
484    $ psql -f pgpool-regclass.sql template1
485   </programlisting>
486
487   を実行します。
488
489   <!--
490   Executing <command>CREATE EXTENSION</command>
491   or <filename>pgpool-regclass.sql</filename> should be performed
492   on every databases accessed
493   via <productname>Pgpool-II</productname>.  However, you do not need to
494   do this for a database created after the execution of
495   <command>CREATE EXTENSION</command> or
496   <command>psql -f pgpool-regclass.sql template1</command>,
497   as this template database will be cloned to create new databases.
498   -->
499   <command>CREATE EXTENSION</command>または<filename>pgpool-regclass.sql</filename>の実行は、<productname>Pgpool-II</productname>経由でアクセスされる全てのデータベースで実行しなければなりません。
500   ただし、<command>CREATE EXTENSINON</command>または"psql -f pgpool-regclass.sql template1"の実行後に作成されたデータベースでは、新しいデータベース作成のためにテンプレートデータベースが複製されるため、これを実行する必要はありません。
501  </para>
502
503 </sect1>
504
505 <sect1 id="create-installlock-table">
506  <!--
507  <title>Creating insert_lock table</title>
508  -->
509  <title>insert_lockテーブルの作成</title>
510
511  <para>
512   <!--
513   If you are not going to use the native replication mode, you can skip this section.
514   -->
515   ネイティブレプリケーションモードを使う予定のない場合は、本節は飛ばすことができます。
516  </para>
517
518  <para>
519   <!--
520   If you plan to use native replication mode and insert_lock,
521   creating <structname>pgpool_catalog.insert_lock</structname>
522   table for mutual exclusion is strongly recommended.  Without
523   this, insert_lock works so far. However in that
524   case <productname>Pgpool-II</productname> locks against the
525   insert target table. This behavior is same
526   as <productname>Pgpool-II</productname> 2.2 and 2.3 series. The
527   table lock conflicts with <command>VACUUM</command>, so <command>INSERT</command>
528   processing may be thereby kept waiting for a long time.
529   -->
530   ネイティブレプリケーションモードでinsert_lockを利用したい場合は、排他制御用のテーブル<structname>pgpool_catalog.insert_lock</structname>を作成することを強く推奨します。
531   これがなくてもある程度はinsert_lock は動作します。
532   しかしその場合は、<productname>Pgpool-II</productname>は挿入対象のテーブルに対してロックを行います。
533   これは<productname>Pgpool-II</productname> 2.2と2.3 シリーズの動作と同じです。
534   このテーブルに対するロックは、<command>VACUUM</command>と競合するため、<command>INSERT</command>処理が長時間待たされ続ける可能性があります。
535
536   <programlisting>
537    $ cd pgpool-II-x.x.x/src/sql
538    $ psql -f insert_lock.sql template1
539   </programlisting>
540
541  </para>
542
543  <para>
544   <!--
545   Executing <filename>insert_lock.sql</filename> should be
546   performed on every databases accessed
547   via <productname>Pgpool-II</productname>.  You do not need to
548   do this for a database created after the execution of
549   <command>psql -f insert_lock.sql template1</command>, as this
550   template database will be cloned to create new databases.
551   -->
552   <filename>insert_lock.sql</filename>は、pgpool-II経由で利用するデータベース毎に必要になります。
553   ただし、"psql -f insert_lock.sql template1"の実行後に作成されたデータベースでは、新しいデータベース作成のためにテンプレートデータベースが複製されるため、これを実行する必要はありません。
554  </para>
555 </sect1>
556
557 <sect1 id="setting-up-pgpool-conf">
558  <!--
559  <title>Setting up pgpool.conf</title>
560  -->
561  <title>pgpool.confの設定</title>
562
563  <para>
564   <!--
565   For each <productname>Pgpool-II</productname> operation mode,
566   there are sample configurations.
567   -->
568   各<productname>Pgpool-II</productname>の動作モードについて設定のサンプルがあります。
569
570  </para>
571
572  <table id="pgpool-conf-samples-table">
573   <!--
574   <title>pgpool.conf samples</title>
575   -->
576   <title>pgpool.confのサンプル</title>
577
578   <tgroup cols="2">
579    <thead>
580     <row>
581      <!--
582      <entry>Operation mode</entry>
583      <entry>Configuration file name</entry>
584      -->
585      <entry>動作モード</entry>
586      <entry>設定ファイル名</entry>
587     </row>
588    </thead>
589
590    <tbody>
591     <row>
592      <!--
593      <entry>Streaming replication mode</entry>
594      -->
595      <entry>ストリーミングレプリケーションモード</entry>
596      <entry><literal>pgpool.conf.sample-stream</literal></entry>
597     </row>
598     <row>
599      <!--
600      <entry>Replication mode</entry>
601      -->
602      <entry>ネイティブレプリケーションモード</entry>
603      <entry><literal>pgpool.conf.sample-replication</literal></entry>
604     </row>
605     <row>
606      <!--
607      <entry>Master slave mode</entry>
608      -->
609      <entry>マスタースレーブモード</entry>
610      <entry><literal>pgpool.conf.sample-master-slave</literal></entry>
611     </row>
612     <row>
613      <!--
614      <entry>Raw mode</entry>
615      -->
616      <entry>Rawモード</entry>
617      <entry><literal>pgpool.conf.sample</literal> </entry>
618     </row>
619     <row>
620      <!--
621      <entry>Logical replication mode</entry>
622      -->
623      <entry>ロジカルレプリケーションモード</entry>
624      <entry><literal>pgpool.conf.sample-logical</literal> </entry>
625     </row>
626    </tbody>
627   </tgroup>
628  </table>
629
630  <para>
631   <!--
632   These configuration files are located at /usr/local/etc with
633   default installation from source code.
634   You can copy one of them as <filename>pgpool.conf</filename>.
635   (probably you need root privilege for this)
636   -->
637   これらの設定ファイルはデフォルトのソースコードからのインストールでは/usr/local/etcに配置されています。
638   これらを<filename>pgpool.conf</filename>としてコピーして使うことが可能です。
639   (もしかするとそのためにはroot権限が必要かもしれません。)
640   <programlisting>
641    # cd /usr/local/etc
642    # cp pgpool.conf.sample-stream pgpool.conf
643   </programlisting>
644  </para>
645 </sect1>
646
647 <sect1 id="install-docs">
648  <!--
649  <title>Compiling and installing documents</title>
650  -->
651  <title>ドキュメントのコンパイルとインストール</title>
652
653  <sect2 id="install-docs-tool-sets">
654   <!--
655   <title>Tool Sets</title>
656   -->
657   <title>ツールセット</title>
658
659   <para>
660    <!--
661    <productname>Pgpool-II</productname> documents are written in
662    SGML (more precisely, DocBook, which is a language implemented
663    using SGML). To generate readable HTML documents, you need to
664    compile them using docbook tools. To install Docbook tools on
665    RHEL or similar systems, use:
666    -->
667    <productname>Pgpool-II</productname>のドキュメントはSGML(より正確には、SGMLを使って実装された言語であるDocBook)で書かれています。
668    ユーザが読めるHTMLドキュメントを生成するには、docbookツールを使ってコンパイルする必要があります。
669    RHEL類似のシステムでツールをインストールするには、以下を実行します。
670    <programlisting>
671     yum install docbook-dtds docbook-style-dsssl docbook-style-xsl libxslt openjade
672    </programlisting>
673   </para>
674  </sect2>
675
676  <sect2 id="install-docs-make">
677   <!--
678   <title>Compiling docs</title>
679   -->
680   <title>ドキュメントのコンパイル</title>
681   <para>
682    <!--
683    Once the tool sets are installed on the system, you can compile the docs:
684    -->
685    ツールセットがインストールされたら、以下のようにコンパイルします。
686    <programlisting>
687     $ cd doc
688     $ make
689     $ cd ..
690     $ cd doc.ja
691     $ make
692    </programlisting>
693    <!--
694    You will see English HTML docs under doc/src/sgml/html, and online docs under sgml/man[1-8].
695    Japanese docs can be found under doc.ja/src/sgml/html, and online docs under sgml/man[1-8].
696    -->
697    HTMLドキュメントはdoc/src/sgml/htmlに、オンラインマニュアルはsgml/man[1-8]にあります。
698    日本語のドキュメントはdoc.ja/src/sgml/htmlに、オンラインマニュアルはsgml/man[1-8]にあります。
699   </para>
700  </sect2>
701 </sect1>
702
703 &installation-rpm;
704
705 &installation-tips;
706
707</chapter>
708