pgpool2.git / summary / log / commit / refs
commit baa683ad0c3286e69a106ea1660e21b4335513df
Author: Tatsuo Ishii <ishii@sraoss.co.jp>
Date: Sat Sep 12 11:52:04 2020 +0000
Add Pgpool-II 4.2 English release notes.
doc/src/sgml/filelist.sgml | 1 +
doc/src/sgml/release-4.2.sgml | 974 ++++++++++++++++++++++++++++++++++++++++++
doc/src/sgml/release.sgml | 1 +
3 files changed, 976 insertions(+)
diff --git a/doc/src/sgml/filelist.sgml b/doc/src/sgml/filelist.sgml
index 202434d23..a35e242bb 100644
--- a/doc/src/sgml/filelist.sgml
+++ b/doc/src/sgml/filelist.sgml
@@ -187,6 +187,7 @@
<!ENTITY sourcerepo SYSTEM "sourcerepo.sgml">
<!ENTITY release SYSTEM "release.sgml">
+<!ENTITY release-4.2 SYSTEM "release-4.2.sgml">
<!ENTITY release-4.1 SYSTEM "release-4.1.sgml">
<!ENTITY release-4.0 SYSTEM "release-4.0.sgml">
<!ENTITY release-3.7 SYSTEM "release-3.7.sgml">
diff --git a/doc/src/sgml/release-4.2.sgml b/doc/src/sgml/release-4.2.sgml
new file mode 100644
index 000000000..1e103aa04
--- /dev/null
+++ b/doc/src/sgml/release-4.2.sgml
@@ -0,0 +1,974 @@
+<!-- doc/src/sgml/release-4.2.sgml -->
+<!-- See header comment in release.sgml about typical markup -->
+
+<sect1 id="release-4-2-0">
+ <title>Release 4.2.0</title>
+ <note>
+ <title>Release Date</title>
+ <simpara>2020-10-xx</simpara>
+ </note>
+
+ <sect2>
+ <title>Overview</title>
+ <para>
+ This version implements long awaited features including
+ <xref linkend="guc-statement-level-load-balance">
+ and <xref linkend="guc-auto-failback">. Also it enhances number
+ of areas related to performance. Finally it
+ imports <productname>PostgreSQL</productname> 12's new SQL
+ parser.
+ </para>
+
+ <para>
+ Below are major enhancements.
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ Some tems in the configuration file
+ <filename>pgpool.conf</filename> are vastly enhanced for easier
+ configuration and administration.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Implement <xref linkend="guc-logging-collector"> for easier log
+ management.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Implement <xref linkend="guc-log-disconnections"> to collect
+ disconnection logs.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Implement <xref linkend="PG-ENC"> and <xref linkend="PG-MD5"> to
+ allow to register multiple passwords at once.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Allow to show statistics of health check by using <xref
+ linkend="SQL-SHOW-POOL-HEALTH-CHECK-STATS"> command, and also
+ allow to show statistics of issued SQL by using <xref
+ linkend="SQL-SHOW-POOL-BACKEND-STATS"> command.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ New PCP command <xref linkend="PCP-RELOAD-CONFIG"> is added.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Now it is possible to omit <xref
+ linkend="guc-black-function-list"> and <xref
+ linkend="guc-white-function-list"> by looking at system catalog
+ information.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add new clustering mode <xref
+ linkend="guc-snapshot-isolation-mode"> which gurantees not only
+ data modifications to multiple
+ <productname>PostgreSQL</productname> but read consistency.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Support LDAP authentication between clients and
+ <productname>Pgpool-II</productname>.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add <xref linkend="guc-ssl-crl-file"> and <xref
+ linkend="guc-ssl-passphrase-command"> to SSL configuration.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Import PostgreSQL 13's SQL parser.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ </sect2>
+
+ <sect2>
+ <title>Migration to Version 4.2</title>
+
+ <itemizedlist>
+
+ <listitem>
+<!--
+Author: Tatsuo Ishii <ishii@sraoss.co.jp>
+2020-03-09 [f0fe8fe9] Unify master_slave_mode, master_slave_sub_mode and replication_mode into backend_clustering_mode.
+-->
+ <para>
+ master_slave_mode, master_slave_sub_mode and replication_mode are
+ deprecated and replaced by <xref
+ linkend="guc-backend-clustering-mode">. Please change them as
+ follows.
+ <itemizedlist>
+
+ <listitem>
+ <para>
+ master_slave_mode = 'on', master_slave_sub_mode = 'stream' → backend_clustering_mode = 'streaming_replication'
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ master_slave_mode = 'on', master_slave_sub_mode = 'logical' → backend_clustering_mode = 'logical_replication'
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ master_slave_mode = 'on', master_slave_sub_mode = 'slony' → backend_clustering_mode = 'slony'
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ replication_mode = 'on' → backend_clustering_mode = 'native_replication'
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ replication_mode = 'off', master_slave_mode = 'off' → backend_clustering_mode = 'raw'
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ </para>
+ </listitem>
+
+ <listitem>
+<!--
+Author: Bo Peng <pengbo@sraoss.co.jp>
+2020-08-11 [a840ecb2] New feature: Simplify Watchdog related configuration parameters.
+-->
+ <para>
+ Watchdog parameters below are deprecated.
+ <programlisting>
+ - wd_hostname
+ - wd_port
+ - wd_heartbeat_port
+ - heartbeat_device
+ - heartbeat_destination0
+ - heartbeat_destination_port0
+ - heartbeat_destination1
+ - heartbeat_destination_port1
+ - other_pgpool_hostname0
+ - other_pgpool_port0
+ - other_wd_port0
+ - other_pgpool_hostname1
+ - other_pgpool_port1
+ - other_wd_port1
+ </programlisting>
+ Use below parameters instead.
+ See <xref linkend="config-communication-watchdog"> for more details.
+ <programlisting>
+ hostname0 = 'server1'
+ wd_port0 = 9000
+ pgpool_port0 = 9999
+
+ hostname1 = 'server2'
+ wd_port1 = 9000
+ pgpool_port1 = 9999
+
+ hostname2 = 'server3'
+ wd_port2 = 9000
+ pgpool_port2 = 9999
+
+ heartbeat_hostname0 = 'server1'
+ heartbeat_port0 = 9694
+ heartbeat_device0 = ''
+
+ heartbeat_hostname1 = 'server2'
+ heartbeat_port1 = 9694
+ heartbeat_device1 = ''
+
+ heartbeat_hostname2 = 'server3'
+ heartbeat_port2 = 9694
+ heartbeat_device2 = ''
+ </programlisting>
+ Unlike 4.1 or before, now all watchdog parameters are identical
+ on all hosts. To distingusish which host is which, create a file
+ <filename>pgpool_node_id</filename> and put number 0, 1, 2
+ etc. to identify host.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ <xref linkend="guc-black-function-list"> and <xref
+ linkend="guc-white-function-list"> are now both empty.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </sect2>
+
+ <sect2>
+ <title>Bug fixes</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ In this release same bug fixes as <productname>Pgpool-II</productname> 4.1.3 are
+ already applied. See <xref linkend="release-4-1-3"> for more details of those fixes.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
+ <sect2>
+ <title>Major Enhancements</title>
+ <itemizedlist>
+
+ <listitem>
+ <!--
+ 2020-03-09 [f0fe8fe9]
+ 2020-09-01 [82d77612]
+ -->
+ <para>
+ Unify master_slave_mode, master_slave_sub_mode and
+ replication_mode into <xref
+ linkend="guc-backend-clustering-mode">. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-11 [a840ecb2]
+ -->
+ <para>
+ Simplify Watchdog related configuration parameters. (Bo Peng)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-06-20 [b0f976be]
+ -->
+ <para>
+ Allow units to be specified with configuration settings. (Muhammad Usama)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-03 [3996850a]
+ 2020-06-29 [d2888d59]
+ 2020-06-27 [35037bcd]
+ -->
+ <para>
+ Add <xref linkend="guc-logging-collector">. (Muhammad Usama, Japanese doc by Tatsuo Ishii)
+ </para>
+ <para>
+ Import PostgreSQL's logging collector.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-24 [86778775]
+ -->
+ <para>
+ Allow to collect disconnection log by <xref linkend="guc-log-disconnections">. (Takuma Hoshiai)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-06-25 [37772c5b]
+ 2020-04-07 [d8434662]
+ -->
+ <para>
+ Allow to set application name parameter of <xref
+ linkend="guc-log-line-prefix"> in more cases. (Tatsuo Ishii)
+ </para>
+ <para>
+ %a in <xref linkend="guc-log-line-prefix"> was only be set if
+ application_name is specified in startup message. Now it is
+ possible to set application_name if it is set in the connection
+ parameter or SET command.
+ </para>
+ <para>
+ Also set hard coded application_name in various internal process so
+ that admins can easily recognize each log line belonging to which
+ process.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-03 [afbcff6f]
+ -->
+ <para>
+ Change <xref linkend="PGPOOL-SETUP"> so that <xref
+ linkend="guc-log-line-prefix"> includes application name. (Tatsuo
+ Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-03-18 [78c217cd]
+ -->
+ <para>
+ Add support for an user/password input file to <xref
+ linkend="PG-ENC">. (Umar Hayat, Japanese doc by Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-04-06 [68d66a66]
+ -->
+ <para>
+ Add support for an user/password input file to <xref
+ linkend="PG-MD5">. (Umar Hayat, Japanese doc by Bo Peng)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-14 [9f74a228]
+ 2020-08-14 [689a8fcc]
+ 2020-08-14 [f04ef82b]
+ 2020-08-14 [d23f0af7]
+ 2020-08-14 [1afc6431]
+ 2020-08-17 [644c0898]
+ 2020-08-17 [241ff0f2]
+ 2020-08-18 [4b512891]
+ -->
+ <para>
+ Add <xref linkend="SQL-SHOW-POOL-BACKEND-STATS">. (Tatsuo Ishii)
+ </para>
+ <para>
+ The new command shows the number of SQL commands executed and
+ errors returned from backend since
+ <productname>Pgpool-II</productname> started.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-01-27 [c36a2804]
+ 2020-01-26 [cb35c9b8]
+ 2020-01-26 [154d826b]
+ -->
+ <para>
+ Add <xref linkend="SQL-SHOW-POOL-HEALTH-CHECK-STATS"> to show
+ health check statistics (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-02-24 [42919f2e]
+ -->
+ <para>
+ Add new PCP command <xref linkend="PCP-HEALTH-CHECK-STATS">. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-02-25 [dfc56868]
+ -->
+ <para>
+ Add new pgpool_adm function <xref linkend="pgpool-adm-pcp-health-check-stats">. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-06-04 [c13a630f]
+ 2020-06-03 [9e979b7f]
+ 2020-05-21 [987b6994]
+ -->
+ <para>
+ New PCP command <xref linkend="PCP-RELOAD-CONFIG"> for reloading
+ the pgpool configuration (Jianshen Zhou, Muhammad Usama, Japanese
+ doc by Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-05-04 [87e6e11c]
+ 2020-05-06 [b859969c]
+ -->
+ <para>
+ Allow to stop whole pgpool cluster by using <xref
+ linkend="PCP-STOP-PGPOOL"> command. (Muhammad Usama, Japanese doc
+ by Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-02 [b7f902d9]
+ -->
+ <para>
+ Implement automatic writing function detection by checking volatile property. (Tatsuo Ishii, Hou, Zhijie)
+ </para>
+ <para>
+ If a function included in SELECT/WITH has volatile property by
+ checking system catalog, regard it a writing function. This
+ feature is available only when the <xref
+ linkend="guc-black-function-list"> and the <xref
+ linkend="guc-white-function-list"> are both empty. The default of
+ the black_function_list and the white_function_list are now empty
+ string so that this feature is enabled by default.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-26 [fc9fa8db]
+ -->
+ <para>
+ Enhance the way getting function names in multiple places. (Hou, Zhijie)
+ </para>
+ <para>
+ With query cache enabled, <productname>Pgpool-II</productname>
+ examines function calls in SELECTs. However if a function were
+ called with schema qualification, it was not recognized. This
+ commit fix to allow schema qualifications in the case.
+ </para>
+ <para>
+ Also now schema qualified function names in <xref
+ linkend="guc-black-function-list"> and <xref
+ linkend="guc-white-function-list"> are allowed. Note that if you
+ want to register schema qualified function names, you have to
+ register function names without schema qualification as well.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-21 [761d30a1]
+ -->
+ <para>
+ Add dml object level load balance support in <xref
+ linkend="guc-disable-load-balance-on-write"> .(Subiao, Muhammad
+ Usama)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-07 [cb34604d]
+ -->
+ <para>
+ Allow to use argument names in pgpool_adm functions. (Hou, Zhijie)
+ </para>
+ <para>
+ Example:
+ <programlisting>
+ SELECT * FROM pcp_node_count(host => 'localhost', port => 11001, username => 't-ishii', password => 't-ishii');
+ </programlisting>
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-02 [537a2c1d]
+ -->
+ <para>
+ Add public API to invalidate query cache by table/database oid. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-06-26 [c18c12f8]
+ -->
+ <para>
+ Add support for LDAP authentication between client and pgpool. (Takuma Hoshiai)
+ See <xref linkend="auth-ldap"> for more details.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-05-23 [5bc38fe1]
+ -->
+ <para>
+ Enhance scram/md5 auth regression test to use AES256 encrypted password. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-01 [3f9a0a3d]
+ 2020-06-27 [d8f5c20d]
+ 2020-06-26 [8b472278]
+ 2020-06-22 [6f35af74]
+ 2020-06-20 [ff76762c]
+ 2020-06-20 [91e39bb0]
+ 2020-06-19 [22930861]
+ -->
+ <para>
+ Add new <xref linkend="guc-backend-clustering-mode"> "snapshot
+ isolation mode". (Tatsuo Ishii)
+ </para>
+ <para>
+ This mode is similar to existing native replication mode except
+ it provides more strict read consistency among backends (so
+ called "atomic visibility") and will give a illusion that a
+ cluster consisting with multiple backends seems to be a single
+ <productname>PostgreSQL</productname> server.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-05-22 [859080bd]
+ -->
+ <para>
+ Add mention about hostssl/hostnossl to
+ <filename>pool_hba.conf</filename> sample file. (Tatsuo Ishii)
+ </para>
+ <para>
+ Although hostssl/hostnossl are supported,
+ <filename>pool_hba.conf</filename> comment did not mention about
+ it.
+ </para>
+ </listitem>
+ <listitem>
+ <!--
+ 2020-04-01 [6ea15445]
+ 2020-03-31 [9ee3d93c]
+ 2020-03-30 [eb0c7c2c]
+ 2020-03-30 [a01c37d8]
+ -->
+ <para>
+ Add support for <xref
+ linkend="guc-ssl-passphrase-command">. (Umar Hayat, Japanese doc
+ by Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-03-14 [dc3116c7]
+ -->
+ <para>
+ Add support for <xref linkend="guc-ssl-crl-file"> (CRL:
+ Certificate Revocation List). (Umar Hayat, Japanese doc by Tatsuo
+ Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-05-18 [fc9e9d37]
+ -->
+ <para>
+ Change relative path of SSL files to configuration
+ directory. (Umar Hayat, Japanese doc by Bo Peng)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-04-28 [eee4c86c]
+ -->
+ <para>
+ Allow to show appropriate process status by ps command with
+ extend queries. (Takuma Hoshiai)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-04-26 [a2a6005d]
+ -->
+ <para>
+ Downgrade too verbose authentication logs. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-30 [ef3d830f]
+ -->
+ <para>
+ Display more informative error message in authentication process. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-02-10 [6222cb3a]
+ -->
+ <para>
+ Suppress unnecessary error message when there's no standby
+ server. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-01-28 [20baad9d]
+ -->
+ <para>
+ Check if socket file exists at startup and remove them if PID
+ file doesn't exist. (Bo Peng)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-01-10 [1062b805]
+ -->
+ <para>
+ Teach <command>pgproto</command> notification response message. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-09-07 [86778775]
+ -->
+ <para>
+ Import PostgreSQL 13 beta3 new parser.
+ Major changes of PostgreSQL 13 parser include:
+ <itemizedlist>
+ <listitem>
+ <para>
+ Remove an object's dependency on an extension
+ <programlisting>
+ ALTER TRIGGER ... NO DEPENDS ON EXTENSION ...
+ ALTER FUNCTION ... NO DEPENDS ON EXTENSION ...
+ </programlisting>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Allow FETCH FIRST to use WITH TIES.
+ <programlisting>
+ FETCH FIRST ... WITH TIES
+ </programlisting>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add ALTER TABLE clause DROP EXPRESSION
+ <programlisting>
+ ALTER TABLE ... DROP EXPRESSION
+ </programlisting>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Allow setting statistics target for extended statistics
+ <programlisting>
+ ALTER STATISTICS ... SET STATISTICS
+ </programlisting>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Allow ALTER VIEW to rename view columns
+ <programlisting>
+ ALTER VIEW ... RENAME COLUMN ... TO ...
+ </programlisting>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add CREATE DATABASE clause LOCALE option
+ <programlisting>
+ CREATE DATABASE ... LOCALE
+ </programlisting>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add DROP DATABASE clause WITH FORCE option
+ <programlisting>
+ DROP DATABASE ... WITH (force)
+ </programlisting>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Add VACUUM clause PARALLEL option
+ <programlisting>
+ VACUUM (PARALLEL 1) ...
+ </programlisting>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-19 [51293488]
+ 2020-08-19 [7fecd5cd]
+ -->
+ <para>
+ and <command>watchdog_setup</command> with PostgreSQL's bin path
+ and lib path. (Bo Peng)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-17 [9c7c3047]
+ -->
+ <para>
+ Use <command>pg_config</command> to get
+ <productname>PostgreSQL</productname> lib path and add this path
+ to LD_LIBRARY_PATH environment paramater in regress.sh. (Bo Peng)
+ </para>
+ <para>
+
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-11 [88a72578]
+ -->
+ <para>
+ Make RPMs to include <filename>pcp.conf</filename> and
+ <filename>pool_hba.conf</filename> sample files. (Bo Peng)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-31 [d7c75781]
+ -->
+ <para>
+ Change PCP UNIX_DOMAIN_PATH of RPM package to "/var/run/postgresql". (Bo Peng)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-27 [680e4d67]
+ -->
+ <para>
+ Rename src/redhat/pgpool_rhel7.sysconfig to
+ src/redhat/pgpool_rhel.sysconfig to make this file available on
+ RHEL8/CentOS8. (Bo Peng)
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ </sect2>
+
+ <sect2>
+ <title>Major Documentation Enhancements</title>
+ <itemizedlist>
+
+ <listitem>
+ <!--
+ 2020-09-01 [9d5bb1c6]
+ -->
+ <para>
+ Add Pgpool-II/PostgreSQL start/stop etc. documents. (Tatsuo Ishii)
+ </para>
+ <para>
+ See <xref linkend="server-start"> etc. for more details.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-18 [c5a51428]
+ -->
+ <para>
+ Mention that <xref linkend="PGPOOL-SETUP"> needs to be configured
+ to log into localhost using ssh without password. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-17 [28351775]
+ -->
+ <para>
+ Change sample scripts and yum repository urls. (Bo Peng)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-28 [d362cb5d]
+ -->
+ <para>
+ Clarify what <xref linkend="PCP-PROMOTE-NODE"> actually does. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-07-10 [19cbe75d]
+ -->
+ <para>
+ Update "Installation from RPM" section. (Bo Peng)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-06-23 [02d75774]
+ -->
+ <para>
+ Add note about <xref linkend="guc-auto-failback">. (Takuma Hoshiai)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-05-23 [d1330ae3]
+ -->
+ <para>
+ Add explanation about <filename>.pgpoolkey</filename>. (Tatsuo
+ Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-05-22 [06632468]
+ -->
+ <para>
+ Improve the description of <xref linkend="guc-wd-priority">. (Kenichiro Tanaka)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-05-10 [f4d6b41b]
+ -->
+ <para>
+ Add note about <xref linkend="guc-if-up-cmd"> and
+ <xref linkend="guc-if-down-cmd"> command. (Bo Peng)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-03-02 [3c2eba0d]
+ -->
+ <para>
+ Enhance installation documents. (Tatsuo Ishii)
+ </para>
+ <para>
+ Add "Planning" section (see <xref linkend="planning">) so that
+ users can grasp a big picture of installation.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-02-27 [b439c147]
+ -->
+ <para>
+ Explicitly mention that <productname>Pgpool-II</productname>
+ needs 3 nodes to avoid split brain. (Tatsuo Ishii)
+ </para>
+ <para>
+ See <xref linkend="intro-whatis"> for more details.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-02-27 [52ec89ce]
+ -->
+ <para>
+ Enhance description of failover. (Tatsuo Ishii)
+ </para>
+ <para>
+ See <xref linkend="guc-failover-command"> for more details.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-02-18 [13b5a290]
+ -->
+ <para>
+ Clarify the session disconnection conditions while
+ failover. (Tatsuo Ishii)
+ </para>
+ <para>
+ See <xref linkend="guc-failover-command"> for more details.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-02-12 [ee597b3a]
+ -->
+ <para>
+ Enhance description of <xref
+ linkend="guc-enable-shared-relcache"> parameter. (Tatsuo Ishii)
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-08-11 [a6a15205]
+ -->
+ <para>
+ Add sample script links in configuration example. (Bo Peng)
+ </para>
+ <para>
+ See <xref linkend="example-cluster"> for more details.
+ </para>
+ </listitem>
+
+ <listitem>
+ <!--
+ 2020-05-23 [249d2955]
+ -->
+ <para>
+ Mention about environment variable PGPOOLKEYFILE in <xref
+ linkend="PG-ENC"> command. (Tatsuo Ishii)
+ </para>
+ <para>
+ <command>pg_enc</command> command actually recognizes the
+ environment variable.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
+</sect1>
diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml
index ce2ab3119..ce0314e3e 100644
--- a/doc/src/sgml/release.sgml
+++ b/doc/src/sgml/release.sgml
@@ -72,6 +72,7 @@ For new features, add links to the documentation sections.
subsets can easily be copied into back branches.
-->
+ &release-4.2;
&release-4.1;
&release-4.0;
&release-3.7;
[parent: ea2442bffa30]