Enhance documentation.

"Tips for Installation" section added.

diff --git a/doc.ja/src/sgml/filelist.sgml b/doc.ja/src/sgml/filelist.sgml
index 2b56ad831d8b21d71113996c11dd41ae673aa511..c21a06ef1d28f29394936cae2c17ac428b34cab8 100644 (file)
--- a/doc.ja/src/sgml/filelist.sgml
+++ b/doc.ja/src/sgml/filelist.sgml
@@ -41,6 +41,7 @@
 <!ENTITY high-availability      SYSTEM "high-availability.sgml">
 <!ENTITY installation  SYSTEM "installation.sgml">
 <!ENTITY installation-rpm  SYSTEM "installation-rpm.sgml">
+<!ENTITY installation-tips  SYSTEM "installation-tips.sgml">
 <!ENTITY installw      SYSTEM "install-windows.sgml">
 <!ENTITY maintenance   SYSTEM "maintenance.sgml">
 <!ENTITY manage-ag     SYSTEM "manage-ag.sgml">

diff --git a/doc.ja/src/sgml/installation-tips.sgml b/doc.ja/src/sgml/installation-tips.sgml
new file mode 100644 (file)
index 0000000..8318c1a
--- /dev/null
+++ b/doc.ja/src/sgml/installation-tips.sgml
@@ -0,0 +1,72 @@
+<!-- doc/src/sgml/installation-tips.sgml -->
+
+ <sect1 id="installation-tips">
+<!--
+  <title>Tips for Installation</title>
+-->
+  <title>インストールのヒント</title>
+   <para>
+<!--
+     This chapter gathers random tips for installing <productname>Pgpool-II</productname>.
+-->
+この章では、<productname>Pgpool-II</productname>をインストールする際の様々なヒントを集めました。
+   </para>
+
+   <sect2 id="firewall">
+<!--
+     <title>Firewalls</title>
+-->
+     <title>ファイアーウォール</title>
+     <para>
+<!--
+       When <productname>Pgpool-II</productname> connects to
+       other <productname>Pgpool-II</productname> servers
+       or <productname>PostgreSQL</productname> servers, the target port
+       must be accessible by enabling firewall management softwares.
+-->
+<productname>Pgpool-II</productname>が他の<productname>Pgpool-II</productname>サーバや<productname>PostgreSQL</productname>サーバに接続する際には、ファイアーウォールの管理ソフトによって目的のポートが開けられていなければなりません。
+     </para>
+
+     <para>
+<!--
+       Here is an example for CentOS/RHEL7 when access
+       to <productname>PostgreSQL</productname> is required.
+-->
+CentOS/RHEL7において、<productname>PostgreSQL</productname>にアクセスが必要な場合の例を示します。
+       <programlisting>
+firewall-cmd --permanent --zone=public --add-service=postgresql
+firewall-cmd --reload
+       </programlisting>
+<!--
+       "postgresql" is the service name assigned
+       to <productname>PostgreSQL</productname>. The list of service
+       names can be obtained by:
+-->
+"postgresql"は<productname>PostgreSQL</productname>に割り当てられたサービス名です。
+サービス名の一覧は、以下のようにして得られます。
+       <programlisting>
+ firewall-cmd --get-services
+       </programlisting>
+<!--
+       Note that you can define your own service name in
+       /usr/lib/firewalld/services/.
+-->
+/usr/lib/firewalld/services/にあなた好みのサービス名を定義することもできることに注意してください。
+     </para>
+
+     <para>
+<!--
+       If <productname>PostgreSQL</productname> is listening on 11002
+       port, rather than the standard 5432 port, you can do:
+-->
+<productname>PostgreSQL</productname>が標準の5432ポートではなく、11002をリッスン指定場合は以下のように設定できます。
+       <programlisting>
+ firewall-cmd --zone=public --remove-service=popstgresql --permanent
+ firewall-cmd --zone=public --add-port=11002/tcp --permanent
+ firewall-cmd --reload
+       </programlisting>
+     </para>
+
+   </sect2>
+
+ </sect1>

diff --git a/doc.ja/src/sgml/installation.sgml b/doc.ja/src/sgml/installation.sgml
index cf8366e2942746a8b0288461fb97e8e47b6b1960..f7eaeef26ec1f55787bde279f7f4a640e97e2fe1 100644 (file)
--- a/doc.ja/src/sgml/installation.sgml
+++ b/doc.ja/src/sgml/installation.sgml
@@ -625,4 +625,6 @@ $ psql -f pgpool-regclass.sql template1
 
 &installation-rpm;
 
+&installation-tips;
+
 </chapter>