PostgreSql集群安装 Pgpool-II以及服务器设置和操作

2 .安装 Pgpool-II

2.1. 规划

由于 Pgpool-II 是一个管理 PostgreSQL 的工具，我们需要决定如何首先部署它们。此外，还可以有多个 Pgpool-II 安装数量达到增强 Pgpool-II 本身的可用性。我们需要提前计划需要多少次 Pgpool-II 安装。在本章我们首先讨论 PostgreSQL 的运行模式，然后是 Pgpool-II 的部署。

2.1.1. PostgreSQL 的集群模式

可以有多个或等于一个 PostgreSQL 安装，通常有更多的而不是 2 次安装，因为如果只有一个安装后，如果 PostgreSQL 不可用，则整个数据库系统都会宕机。当我们使用两个或多个 PostgreSQL 服务器，它对于以某种方式同步数据库是必需的。我们调用将数据库同步为 "clustering running mode" 的方法。这有史以来最流行的模式是 "流复制模式"。除非有必要有特别的考虑，否则它是推荐使用流式复制模式。有关运行模式的更多详细信息，请参见 Section 3.3.2 。

接下来我们需要考虑的是我们需要多少个 PostgreSQL 安装。如果有两个，我们可以继续操作数据库系统。但是，如果您想使用 read ，使用两个以上的 PostgreSQL 并不少见通过对多个 read quires 运行多个 read quire 来查询负载平衡服务器。Pgpool-II 提供丰富的用于调整负载均衡的各种选项。有关更多详细信息，请参阅 Section 5.8 。

由于稍后可以在 Pgpool-II 中添加 PostgreSQL 服务器，因此两个 PostgreSQL 可以是一个很好的起点你。

2.1.2. 部署 Pgpool-II

虽然可以只使用一个 Pgpool-II，但我们建议使用更多比 1 个 Pgpool-II 避免整个由于 Pgpool-II 宕机而导致的数据库不可用。多个 Pgpool-II 协同工作并监控彼此。其中一个称为"leader"，它有一个虚拟的 IP 的 IP 文件。客户端不需要知道有多个 Pgpool-II，因为它们总是访问同一个 VIP。（参见第 4.1 节 watchdog）的如果 Pgpool-II 中的一个 down，其他 Pgpool-II 接管 leader 角色。

由于不允许有多个 leader，因此 watchdog 投票给决定新的领导者。如果 Pgpool-II 的数量为偶数，则无法决定通过投票成为新的领导人。因此，我们建议部署大于或等于 3 个奇数的 Pgpool-II。

请注意，Pgpool-II 和 PostgreSQL 可以在同一台服务器上。为例如，你只能有 3 个服务器来运行 Pgpool-II 和 PostgreSQL。

您可以在流式复制中找到使用三个 Pgpool-II 和两个 PostgreSQL 的生产级详细示例 mode 为那些想要今天有一个生产级别的 Pgpool-II 安装。

2.2. 安装 Pgpool-II

本章介绍安装 Pgpool-II 的。首先，安装解释了源代码分发。然后从 RPM 安装 packages 的

2.3. 要求

一般来说，一个现代的 Unix 兼容平台应该能够运行 Pgpool-II。不支持 Windows。

构建 Pgpool-II 需要以下软件包：

需要 GNU make 版本 3.80 或更高版本;其他 make 程序或较旧的 GNU make 版本将不起作用。（GNU make 有时安装在名称 gmake。要测试 GNU make enter：

复制代码

   make --version

您需要一个 ISO/ANSI C 编译器（至少符合 C89 标准）。最近推荐使用 GCC 版本，但已知 Pgpool-II 使用各种各样的来自不同供应商的编译器。

需要 tar 来解压缩源发行版。

需要多个 PostgreSQL 软件包才能安装 Pgpool-II。您安装 postgresql-libs 和 PostgreSQL-devel 软件包。

如果你从 Git 树而不是 Git 树构建使用已发布的源码包，或者如果您想进行服务器开发，您还需要以下软件包：

需要 Flex 和 Bison 才能从 Git 签出进行构建，或者如果您更改了实际的 scanner 和 parser 定义文件。如果您需要它们，请确保以获取 Flex 2.5.31 或更高版本以及 Bison 1.875 或更高版本。不能使用其他 lex 和 yacc 程序。

如果你需要获取 GNU 软件包，你可以找到它位于您本地的 GNU 镜像站点（参见 http://www.gnu.org/order/ftp.html 的列表）或 ftp://ftp.gnu.org/gnu/。

还要检查您是否有足够的磁盘空间。您将需要大约编译期间源代码树为 40 MB，编译期间源代码树约为 20 MB 安装目录。如果你要运行回归测试，您暂时需要最多一个额外的 4 GB。使用 df 命令检查可用磁盘空间。

2.4. 获取源码

Pgpool-II 4.5.5 源码可以获取从我们的网站： http://www.pgpool.net。您应该获取文件命名 pgpool-II-4.5.5.tar.gz。在您之后获取到文件后，解压：

复制代码

tar xf pgpool-II-4.5.5.tar.gz

这将在当前目录下创建一个目录 pgpool-II-4.5.5 与 Pgpool-II 源码一起使用。更改为该目录以获取其余部分的安装过程。

2.5. 安装 Pgpool-II

解压源 tarball 后，按照以下步骤构建源代码并安装 Pgpool-II。

从 Pgpool-II 4.5 开始，由 autoconf/autoreconf 生成的 configure 等文件已经从仓库中删除，因此首先运行 autoreconf -fi 来生成 configure。

复制代码

dnf install libtool

cd pgpool-II-4.5.5
autoreconf -fi

接下来，执行 configure 脚本。

复制代码

./configure

您可以通过提供一个或以下更多命令行选项进行配置：

--prefix=路径

指定 Pgpool-II 二进制文件和相关将安装 docs 等文件。默认值为 /usr/local。

--with-pgsql=路径

指定 PostgreSQL 的客户端库所在的顶级目录安装。默认值是pg_config命令提供的路径。

--带有 openssl

将构建 Pgpool-II 二进制文件支持 OpenSSL。如果您打算使用 AES256 加密加密密码，您需要此选项太。有关更多信息，请参见 Section 6.4 详。OpenSSL 支持是默认情况下处于禁用状态。

--enable-sequence-lock

使用 insert_lock 兼容带 Pgpool-II 3.0 系列（3.0.4 之前）。Pgpool-II 锁针对序列中的一行桌子。PostgreSQL 8.2 或更高版本在 2011 年 6 月之后发布的 API 不能使用此锁方法。

--enable-table-lock

使用 insert_lock 兼容使用 Pgpool-II 2.2 和 2.3 系列。Pgpool-II 锁针对 Insert Target 表。这种锁定方式是已弃用，因为它会导致锁冲突带真空。

--with-memcached=路径

Pgpool-II 二进制文件将在 memory query cache 的 CACHE 查询。您必须安装 libmemcached。

--带 pam

Pgpool-II 二进制文件将构建 PAM 身份验证支持。默认情况下，PAM 身份验证支持处于禁用状态。

编译源文件。

复制代码

make

安装 pgpool-II。

复制代码

make install

这将安装 Pgpool-II。（如果您使用 Solaris 或 FreeBSD，请将 make 替换为 gmake)

2.6. 安装 pgpool_recovery

Pgpool-II 需要、和、的函数当您使用描述后者的 Online Recovery 时。还有管理工具的 pgpoolAdmin，通过使用停止、重启或重新加载屏幕上的 PostgreSQL。如果这些函数先安装在 template1 中就足够了。这些不需要在所有数据库中安装的功能。pgpool_recoverypgpool_remote_startpgpool_switch_xlogpgpool_pgctl

这在所有 Pgpool-II 安装中都是必需的。

复制代码

$ cd pgpool-II-4.5.5/src/sql/pgpool-recovery
$ make
$ make install

在此之后：

复制代码

$ psql template1
=# CREATE EXTENSION pgpool_recovery;

或

复制代码

$ psql -f pgpool-recovery.sql template1

使用 Pgpool-II 3.3 或更高版本，你需要调整 postgresql.conf。假设路径 pg_ctl的是 /usr/local/pgsql/bin/pg_ctl。那么你将以下内容添加到 postgresql.conf 中。

复制代码

pgpool.pg_ctl = '/usr/local/pgsql/bin/pg_ctl'

可能您希望在此之后执行以下内容：

复制代码

$ pg_ctl reload -D /usr/local/pgsql/data

2.7. 安装 pgpool-regclass

如果您使用的是 PostgreSQL 9.4 或稍后，您可以跳过此部分。

如果您使用的是 PostgreSQL 8.0 到 PostgreSQL 9.3，在上安装强烈建议 Pgpool-II 访问所有 PostgreSQL，因为它被 Pgpool-II 内部使用。如果没有这个，在不同架构可能会导致麻烦（临时表不是问题）。如果您使用的是 PostgreSQL 9.4 或稍后，安装不是 necessary 的，因为等效的（）包含在 PostgreSQL 核心中。pgpool_regclasspgpool_regclassto_regclass

复制代码

$ cd pgpool-II-4.5.5/src/sql/pgpool-regclass
$ make
$ make install

在此之后：

复制代码

$ psql template1
=# CREATE EXTENSION pgpool_regclass;

或

复制代码

$ psql -f pgpool-regclass.sql template1

应执行 CREATE EXTENSION 或 pgpool-regclass.sql 在每个访问的数据库上通过 Pgpool-II。但是，您不需要对于在执行 CREATE EXTENSION 或 psql -f pgpool-regclass.sql template1 后创建的数据库，执行此操作。因为此模板数据库将被克隆以创建新数据库。

2.8. 创建 insert_lock 表

如果您不打算使用本机复制模式和快照隔离模式，您可以跳过此项部分。

如果您计划使用原生复制模式或快照隔离模式，并且insert_lock，创建 pgpool_catalog.insert_lock 表强烈建议进行互斥。没有这个，到目前为止，insert_lock有效。然而，在那个 case Pgpool-II 锁在插入物上目标表。此行为是相同的表锁冲突使用 VACUUM，因此 INSERT 处理可能会保持等待很长时间。

复制代码

$ cd pgpool-II-4.5.5/src/sql
$ psql -f insert_lock.sql template1

执行 insert_lock.sql 应该是对访问的每个数据库执行通过 Pgpool-II。您无需对于执行 psql -f insert_lock.sql template1 后创建的数据库执行此操作，如下所示模板数据库将被克隆以创建新数据库。

2.9. 编译和安装文档

2.9.1. 工具集

Pgpool-II 文档是用 SGML（更准确地说，DocBook，这是一种实现的语言使用 SGML）。要生成可读的 HTML 文档，您需要使用 Docbook 工具编译它们。要在上安装 Docbook 工具 RHEL 或类似系统，请使用：

复制代码

dnf install --enablerepo=powertools docbook-dtds docbook-style-dsssl docbook-style-xsl libxslt openjade

2.9.2. 编译文档

在系统上安装工具集后，您可以编译文档：

复制代码

$ cd doc
$ make
$ cd ..
$ cd doc.ja
$ make

您将在 doc/src/sgml/html 下看到英文 HTML 文档，在 sgml/man 下看到在线文档[1-8]。日文文档可以在 doc.ja/src/sgml/html 下找到，在线文档可以在 sgml/man 下找到[1-8]。

2.10. 从 RPM 安装

本章描述了从 RPM 安装 Pgpool-II。如果您打算从源代码安装，请查看 Section 2.2。

Pgpool-II 社区为 RHEL9/8/7 提供 RPM 软件包以及与 RHEL 兼容的操作系统。你可以从官方的 Pgpool-II 仓库下载包文件。

Pgpool-II 官方仓库包含以下软件包：

表 2-1.pgpool-II RPM 软件包

包	描述
pgpool-II-pgXX	运行 Pgpool-II 所需的库和二进制文件
pgpool-II-pgXX-extensions	必须在所有 PostgreSQL 服务器上安装此软件包才能使用在线恢复功能
pgpool-II-pgXX-debuginfo	用于调试的调试符号
pgpool-II-pgXX-debug源	仅适用于 RHEL8/9。用于调试的调试符号
pgpool-II-pgXX-extensions-debuginfo	仅适用于 RHEL8/9。用于调试的调试符号
pgpool-II-pgXX-devel	面向开发人员的头文件

Pgpool-II 需要 PostgreSQL 的 library 和 extensions 目录下。由于目录路径不同对于特定的 PostgreSQL 版本，Pgpool-II 为每个 PostgreSQL 版本提供了单独的软件包。上述包中的"XX"是一个两位数的数字，表示 PostgreSQL 的版本。选择与您的 PostgreSQL 版本对应的 Pgpool-II RPM。（例如，如果你正在使用 PostgreSQL 16，你需要安装 pgpool-II-pg16)

2.10.1. 安装前

由于 Pgpool-II 相关的包也包含在 PostgreSQL YUM 仓库中，如果已安装 PostgreSQL 存储库包，则将「排除」设定加入 /etc/yum.repos.d/pgdg-redhat-all.repo，这样 Pgpool-II 就不会从 PostgreSQL YUM 仓库安装。如果 Pgpool-II 和 PostgreSQL 安装在不同的服务器上，你可以跳过本节。

复制代码

vi /etc/yum.repos.d/pgdg-redhat-all.repo

以下是 /etc/yum.repos.d/pgdg-redhat-all.repo 的设置示例。

复制代码

[pgdg-common]
...
exclude=pgpool*

[pgdg16]
...
exclude=pgpool*

[pgdg15]
...
exclude=pgpool*

[pgdg14]
...
exclude=pgpool*

[pgdg13]
...
exclude=pgpool*

[pgdg12]
...
exclude=pgpool*

[pgdg11]
...
exclude=pgpool*

2.10.2. 安装 RPM

这里我们使用 Pgpool-II 官方的 YUM 仓库安装 Pgpool-II。

以下命令假设您在 RHEL8 上使用 Pgpool-II 4.5.x for PostgreSQL 16。如果您使用的是其他版本，请将 "pgXX" 替换为您的 PostgreSQL 版本。

首先，安装与你的 Pgpool-II 版本和发行版相对应的仓库。对于 REHL7/9，请参阅此处。

复制代码

dnf install https://www.pgpool.net/yum/rpms/4.5/redhat/rhel-8-x86_64/pgpool-II-release-4.5-1.noarch.rpm

然后，安装 Pgpool-II。

复制代码

dnf install pgpool-II-pg16

要使用在线恢复功能，请在所有 PostgreSQL 服务器上安装 pgpool-II-pg16-extensions。因为 pgpool-II-pgXX-extensions 依赖于 pgpool-II-pgXX 软件包，如果 pgpool-II 和 PostgreSQL 安装在不同的服务器上，pgpool-II-pgXX 也需要安装在 PostgreSQL 服务器上。

注意： pgpool-II-pgXX-extensions 需要安装在 PostgreSQL 服务器上。如果 Pgpool-II 和 PostgreSQL 安装在不同的服务器上，则不需要在运行 Pgpool-II 的服务器上安装它。

复制代码

dnf install pgpool-II-pg16-extensions pgpool-II-pg16

（可选）如有必要，您可以为开发人员安装 debuginfo 和 devel 软件包。

复制代码

dnf install pgpool-II-pg16-debuginfo pgpool-II-pg16-devel

2.10.3. 配置 pgpool-II

所有 Pgpool-II 配置文件安装在 /etc/pgpool-II 中。请参考到 Section 3.3 了解如何设置配置文件。

2.10.4. 启动/停止 Pgpool-II

在 RHEL9/8/7 上，如果设置了 Pgpool-II 的自动启动，请执行一次。

复制代码

systemctl enable pgpool.service

在此之后，要启动 Pgpool-II，运行以下命令或重新启动整个系统。请注意，在此之前必须启动 PostgreSQL 服务器。

复制代码

systemctl start pgpool.service

要停止 Pgpool-II，请执行一次。请注意，Pgpool-II 必须停止在停止 PostgreSQL 之前。

复制代码

systemctl stop pgpool.service

在此之后，您可以停止 PostgreSQL 服务器。

2.11. 安装提示

本章收集了安装 Pgpool-II 的随机技巧。

2.11.1. 防火墙

当 Pgpool-II 连接到其他 Pgpool-II 服务器或 PostgreSQL 服务器，则目标端口必须通过启用防火墙管理软件来访问。

首先，允许访问 Pgpool-II 使用的端口。在下面的例子中，让 Pgpool-II 监听端口号为 9999，PCP 侦听端口号为 9898，看门狗 listen port number 为 9000 和 heartbeat listen port number 为 9694. 请注意，只有心跳端口使用 UDP，而其他端口使用 TCP。

复制代码

firewall-cmd --permanent --zone=public --add-port=9999/tcp --add-port=9898/tcp --add-port=9000/tcp
firewall-cmd --permanent --zone=public --add-port=9694/udp
firewall-cmd --reload

以下是 CentOS/RHEL7 在设置为 PostgreSQL。

复制代码

firewall-cmd --permanent --zone=public --add-service=postgresql
firewall-cmd --reload

"PostgreSQL" 是分配的服务名称到 PostgreSQL。服务一览名称可以通过以下方式获得：

复制代码

firewall-cmd --get-services

请注意，您可以在 /usr/lib/firewalld/services/ 中。

如果 PostgreSQL 正在侦听 11002 port 而不是标准的 5432 端口，您可以执行以下操作：

复制代码

firewall-cmd --zone=public --remove-service=postgresql --permanent
firewall-cmd --zone=public --add-port=11002/tcp --permanent
firewall-cmd --reload

3.服务器设置和操作

3.1. Pgpool-II 用户账户

与任何可供外部世界访问的服务器守护程序一样，建议在单独的用户帐户。此用户帐户应仅拥有数据由服务器管理，不应与其他守护进程。（例如，使用用户 nobody 是不好的想法。不建议安装此公司拥有的可执行文件用户，因为受感染的系统可以修改自己的二进制文件。

要将 Unix 用户帐户添加到系统，请查找命令 useradd 或 adduser。用户名称 pgpool 经常被使用，并且是假定的在本书中，但如果您愿意，您可以使用其他名称。

3.2. 配置 pcp.conf

Pgpool-II 提供了一个接口供管理员执行管理操作，例如获取 Pgpool-II 状态或终止 Pgpool-II 进程远程。pcp.conf 是用户/密码文件用于此接口的身份验证。所有操作模式需要设置 pcp.conf 文件。将创建一个 $prefix/etc/pcp.conf.sample 文件安装期间 Pgpool-II 的。将文件复制为$ prefix/etc/pcp.conf 并添加您的用户名和密码到它。

复制代码

$ cp $prefix/etc/pcp.conf.sample $prefix/etc/pcp.conf

空行或以 # 开头的行被视为注释，将被忽略。用户名及其关联的密码必须使用以下格式写成一行：

复制代码

username:[md5 encrypted password]