安装部署

硬件需求

安装PolarDB PostgreSQL轻量版应具备基本的硬件要求。在此基础上，您可以根据实际业务需求、数据规模以及期望的数据库响应速度规划硬件配置。

软件需求

strings /lib64/libc.so.6 | grep "^GLIBC_2."

预配置操作系统

关闭操作系统的透明大页功能。请执行以下语句以检查当前透明大页的配置：

cat /sys/kernel/mm/transparent_hugepage/enabled

如返回结果为always madvise [never]则表示已关闭透明大页。否则，请执行以下操作以关闭透明大页。

echo never > /sys/kernel/mm/transparent_hugepage/enabled

配置文件检查

pdbcli配置文件包括主机存储、端口配置和数据库参数等内容，是安装数据库的重要配置文件。默认使用的配置文件为polarflex-${version}/文件夹下的config.yaml。

为便于您选择config.yaml的配置，在相同目录下提供了不同场景的配置文件模板。

如果使用一键部署脚本polarflex-deploy.sh搭建一主两备集群并需要修改参数时，请修改config_template.yaml模板文件中的参数。同理，使用该脚本搭建单节点集群，请修改config_single_node.yaml模板文件中的参数。polarflex-deploy.sh脚本运行中会自动根据模板生成config.yaml。

需要注意的是，以下两个参数必须在创建集群之前完成配置，创建集群后将无法进行修改。

• 兼容模式

  PolarDB PostgreSQL轻量版包括Postgres兼容与Oracle兼容两种兼容模式。

  默认为Postgres兼容模式。如需启用Oracle兼容模式，必须在配置文件模板的末尾设置compatibility_mode: ora。

• 文件目录

  数据库文件目录默认位于/var/lib/thirdDB的子目录。您可以通过配置文件中的polardb_data_root_dir参数进行修改。由于默认目录的磁盘空间可能较小，强烈建议根据主机的磁盘容量和预计的数据库文件数量选择合适的目录。

# 以下配置文件示例展示了如何搭建一个由三台主机构建的集群，主机IP分别为10.XX.XX.1、
# 10.XX.XX.2、10.XX.XX.3。请您根据实际情况进行配置。
all:
  children:
    cm:
      hosts:
        host01: null
        host02: null
        host03: null
      var: null
    db:
      hosts:
        host01:
          polardb_polar_hostid: 1
        host02:
          polardb_polar_hostid: 2
          polardb_node_type: standby
        host03:
          polardb_polar_hostid: 3
          polardb_node_type: standby
      vars:
        polardb_custom_params:
        - max_standby_streaming_delay = 900000
        - max_connections = 3300
        - superuser_reserved_connections = 15
        - polar_max_super_conns = 1500
        polardb_service_restart_sec: 5
        hugepage_enabled: off
    proxy:
      hosts:
        host01: null
        host02: null
      var: null
  hosts:
    host01:
      ansible_host: 10.XX.XX.1 # HOST01_IP 【必填】
    host02:
      ansible_host: 10.XX.XX.2 # HOST02_IP 【必填】
    host03:
      ansible_host: 10.XX.XX.3 # HOST03_IP 【必填】
  vars:
    ansible_group_priority: 99
    ansible_python_interpreter: /usr/bin/{{python}}
    cluster_id: polardb1
    cm_consensus_port: 7001
    cm_service_port: 5001
    cm_tls_service_port: 6001
    cm_db_sync_mode: SYNC
    polardb_data_root_dir: /var/lib/thirdDB
    polardb_enable_direct_io: false
    polardb_multi_instance_per_host: true
    polardb_polar_enable_pfs_mode: false
    polardb_port: 1523 # 数据库直连端口
    polardb_proxy_port: 12369 # 代理强一致性端口
    polardb_proxy_port_rwlb: 12370 # 代理读写分离端口
    polardb_proxy_admin_port: 12371
    polardb_storage_mode: local_filesystem_mode
    polardb_user: polar1
    primary_db_host: host01
    ue_node_driver_service_port: 12355
    compatibility_mode: pg # 如果需要使用Oracle兼容模式，需要在安装之前把pg改为ora

安装并创建集群

polarflex目录下提供了一键安装脚本polarflex-deploy.sh。根据需要创建的集群节点数量执行以下命令：

• 创建一主两备集群，默认使用config_template.yaml配置文件。

  bash polarflex-deploy.sh -m "10.XX.XX.1" -p 'password' -m "10.XX.XX.2" -p 'password' -m "10.XX.XX.3" -p 'password'

• 创建一主一备集群，默认使用config_master_slave.yaml配置文件。

  bash polarflex-deploy.sh -m "10.XX.XX.1" -p 'password' -m "10.XX.XX.2" -p 'password'

• 创建单节点集群，默认使用config_single_node.yaml配置文件。

  bash polarflex-deploy.sh -m "10.XX.XX.1" -p 'password'

其中，-m为服务器主机地址，-p为对应服务器主机root密码。您可按需添加-w参数实现一键部署prometheus和grafana，访问执行polarflex-deploy.sh所在机器的3000端口即可查看集群监控。

bash polarflex-deploy.sh -m "10.XX.XX.1" -p 'password' -m "10.XX.XX.2" -p 'password' -m "10.XX.XX.3" -p 'password' -w

该脚本在运行时将执行以下步骤：

1. 根据指定的安装机器IP地址及其root密码，配置SSH免密登录。

2. 根据配置模板（例如config_template.yaml等）生成配置文件config.yaml。

3. 执行pdbcli install cluster安装集群所需的依赖。

4. 执行pdbcli create cluster创建数据库集群。

集群状态检查

执行pdbcli status检查集群状态。返回cluster_manager、master、standby和proxy节点状态均为RUNNING即安装成功，且work_path为配置文件中的文件目录。

Using config file: ./config.yaml
Cluster Status:
{
	"phase": "RunningPhase",
	"cluster_manager": [
		{
			"endpoint": "172.x.x.x:5001",
			"phase": "RUNNING"
		},
		{
			"endpoint": "172.x.x.x:5001",
			"phase": "RUNNING"
		},
		{
			"endpoint": "172.x.x.x:5001",
			"phase": "RUNNING"
		}
	],
	"master": {
		"endpoint": "172.x.x.x:1523",
		"cust_id": "0",
		"work_path": "/var/lib/thirdDB/clusters/polardb1",
		"phase": "RUNNING",
		"start_at": "2025-03-13 19:41:50"
	},
	"standby": [
		{
			"endpoint": "172.x.x.x:1523",
			"cust_id": "0",
			"work_path": "/var/lib/thirdDB/clusters/polardb1",
			"phase": "RUNNING",
			"start_at": "2025-03-13 19:42:02",
			"sync_status": "SYNC"
		},
		{
			"endpoint": "172.x.x.x:1523",
			"cust_id": "0",
			"work_path": "/var/lib/thirdDB/clusters/polardb1",
			"phase": "RUNNING",
			"start_at": "2025-03-13 19:42:02",
			"sync_status": "SYNC"
		}
	],
	"proxy": [
		{
			"endpoint": "172.x.x.x:12369",
			"phase": "RUNNING"
		},
		{
			"endpoint": "172.x.x.x:12369",
			"phase": "RUNNING"
		}
	],
	"plugins": [
		{
			"name": "golang-manager",
			"status": "Plugin run err topo is null errCount 2"
		}
	],
	"disk": {
		"state": "UNLOCK",
		"quota": "UNSET",
		"usage": ""
	}

数据库检查

在集群启动后，您可以通过PolarDB PostgreSQL轻量版内核二进制包中内置的psql客户端进行连通性测试。

创建集群时默认创建以下资源：

• 用户admin，密码为postgres。

• 数据库admin_db。

集群默认访问端口1523。执行以下命令检查集群连通性：

PGPASSWORD=postgres /u01/polardb_pg/bin/psql -h localhost -p1523 -U admin -d admin_db -c 'SHOW polardb_version'

如果返回PolarDB PostgreSQL轻量版集群内核小版本号，如PolarDB V2.0.14.13.26.0，则说明数据库安装成功，且数据库内核版本检查正常。

兼容性模式检查

在集群启动后，您可以通过PolarDB PostgreSQL轻量版内核二进制包中内置的psql客户端查询当前使用的PolarDB引擎兼容模式。

PGPASSWORD=postgres /u01/polardb_pg/bin/psql -h localhost -p1523 -U admin -d admin_db -c 'SHOW polar_compatibility_mode'

返回结果如下：

• pg：为Postgres兼容模式。

• ora：为Oracle兼容模式。

进程检查

PolarDB PostgreSQL轻量版集群成功启动后，将在数据库目录下生成一个名为postmaster.pid的文件。该文件的第一行内容为PolarDB引擎守护进程的进程ID（pid）。您可以通过执行命令ps -ef | grep <pid>来获取所有PolarDB PostgreSQL轻量版集群进程信息，常见的辅助进程如下：

• postgres: logger：PolarDB打印日志进程。

• postgres: checkpointer：PolarDB周期性检查点进程。

• postgres: background writer：PolarDB周期性刷脏进程。

• postgres: walwriter：PolarDB定期WAL 日志刷盘进程。

• postgres: autovacuum launcher：PolarDB自动清理调度进程。

• postgres: stats collector：PolarDB统计信息收集进程。