From 5485b9bd815ccac6e85cf412379f2c526e17aada Mon Sep 17 00:00:00 2001
From: Tatsuo Ishii <ishii@postgresql.org>
Date: Tue, 20 Dec 2016 10:13:55 +0900
Subject: [PATCH] Enhance documentation.

Add "Tips for Installation" section added.
---
 doc/src/sgml/filelist.sgml          |  1 +
 doc/src/sgml/installation-tips.sgml | 47 +++++++++++++++++++++++++++++
 doc/src/sgml/installation.sgml      |  2 ++
 3 files changed, 50 insertions(+)
 create mode 100644 doc/src/sgml/installation-tips.sgml

diff --git a/doc/src/sgml/filelist.sgml b/doc/src/sgml/filelist.sgml
index 2b56ad831..c21a06ef1 100644
--- a/doc/src/sgml/filelist.sgml
+++ b/doc/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/src/sgml/installation-tips.sgml b/doc/src/sgml/installation-tips.sgml
new file mode 100644
index 000000000..43d504ebc
--- /dev/null
+++ b/doc/src/sgml/installation-tips.sgml
@@ -0,0 +1,47 @@
+<!-- doc/src/sgml/installation-tips.sgml -->
+
+ <sect1 id="installation-tips">
+  <title>Tips for Installation</title>
+   <para>
+     This chapter gathers random tips for installing <productname>Pgpool-II</productname>.
+   </para>
+
+   <sect2 id="firewall">
+     <title>Firewalls</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.
+     </para>
+
+     <para>
+       Here is an example for CentOS/RHEL7 when access
+       to <productname>PostgreSQL</productname> is required.
+       <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:
+       <programlisting>
+ firewall-cmd --get-services
+       </programlisting>
+       Note that you can define your own service name in
+       /usr/lib/firewalld/services/.
+     </para>
+
+     <para>
+       If <productname>PostgreSQL</productname> is listening on 11002
+       port, rather than the standard 5432 port, you can do:
+       <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/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 88f70c588..915316213 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -426,4 +426,6 @@ $ psql -f pgpool-regclass.sql template1
 
 &installation-rpm;
 
+&installation-tips;
+
 </chapter>
-- 
2.39.5