PolarDB-for-PostgreSQL 服务管理：解决 systemd 启动失败问题

在部署 PolarDB-for-PostgreSQL 数据库时，很多用户会遇到使用 systemd 管理服务启动失败的问题。本文将深入分析这个常见问题的原因，并提供完整的解决方案。

问题现象分析

当用户通过 systemd 配置 PolarDB-for-PostgreSQL 服务时，经常会遇到服务无法正常启动的情况，但手动切换到 polardb 用户执行相同的启动命令却能成功。这种不一致的行为通常表明 systemd 服务配置存在问题。

根本原因

经过分析，问题的核心在于 systemd 服务文件中的 Type 参数配置不当。在初始配置中，用户可能将 Type 设置为 simple，这是 systemd 服务的默认类型。然而，对于 PostgreSQL 及其衍生版本（如 PolarDB）这类数据库服务，正确的 Type 应该是 forking。

systemd 服务类型详解

理解 systemd 的不同服务类型对于正确配置数据库服务至关重要：

1. simple：默认类型，服务由 ExecStart 指定的程序直接启动，程序常驻内存
2. forking：服务通过 spawns 产生子进程来运行，父进程随后退出（这正是 PostgreSQL 的工作方式）
3. oneshot：程序执行完成后即退出，不常驻内存
4. dbus：需要获取 D-Bus 名称后才能继续运行
5. idle：在所有其他任务完成后才执行
6. notify：需要收到 sd_notify() 消息后才能继续运行

正确的服务配置方案

以下是经过验证的正确 systemd 服务配置模板：

[Unit]
Description=polardb postgres 15
After=network.target

[Service]
Type=forking
User=polardb
Group=polardb
ExecStart=/u01/polardb_pg/bin/pg_ctl -D /data/polardb-postgres-15 -l /data/polardb-postgres-15/polar-run.log start -s -w
ExecStop=/u01/polardb_pg/bin/pg_ctl -D /data/polardb-postgres-15 -l /data/polardb-postgres-15/polar-run.log stop -s -m fast
ExecReload=/u01/polardb_pg/bin/pg_ctl -D /data/polardb-postgres-15 -l /data/polardb-postgres-15/polar-run.log reload -s
TimeoutStartSec=5
RestartSec=5
Restart=on-failure

[Install]
WantedBy=multi-user.target

配置说明与最佳实践

1. Type=forking：必须设置为 forking，因为 pg_ctl 会派生(postgres)子进程后退出
2. -s 参数：使 pg_ctl 在静默模式下运行，减少不必要的输出
3. -w 参数：等待操作完成，确保服务完全启动
4. Restart=on-failure：服务异常退出时自动重启
5. After=network.target：确保网络服务就绪后再启动数据库

完整的部署流程

1. 创建专用用户和组：

   groupadd polardb
   useradd -m -s /bin/bash -g polardb polardb
   

2. 设置目录权限：

   mkdir -p /data/polardb-postgres-15
   chown -R polardb:polardb /data/polardb-postgres-15
   chmod -R 0700 /data/polardb-postgres-15
   

3. 初始化数据库：

   su - polardb -c "/u01/polardb_pg/bin/initdb -D /data/polardb-postgres-15 -E UTF8 --locale=C --data-checksums -U polardb"
   

4. 应用服务配置并启动：

   systemctl daemon-reload
   systemctl enable polarpg.service
   systemctl start polarpg.service
   systemctl status polarpg.service
   

总结

正确配置 systemd 服务对于 PolarDB-for-PostgreSQL 的稳定运行至关重要。通过将服务类型设置为 forking，并添加适当的启动参数，可以确保数据库服务能够正常启动和管理。本文提供的配置模板和部署流程已经过验证，可以作为生产环境部署的参考标准。