pgbackrest-release-2.52 编译安装

pgbackrest-release-2.52 安装配置

目录

• pgbackrest-release-2.52 安装配置
  • 🔧 不同安装方式详解
    • 使用系统包管理器（最便捷）
    • 源码编译安装（最详尽的通用方法）
    • 使用Meson构建系统（新方式）

pgBackRest 2.52版本有多个安装方式。它已在2.51版本后引入了新的Meson构建系统，但搜索结果显示传统源码编译仍是最普遍、最详细的教程来源

下面这张图汇总了主要的安装路径，你可以根据自己的情况选择：

🔧 不同安装方式详解

使用系统包管理器（最便捷）

对于Ubuntu/Debian系统，可以通过添加PostgreSQL全球开发组（PGDG）的官方仓库来安装较新版本。

# 示例：Ubuntu系统添加PGDG源并安装（具体源地址请查阅官方文档）
sudo apt-get update
sudo apt-get install pgbackrest

注意：部分Linux发行版自带的软件仓库版本可能较旧。

源码编译安装（最详尽的通用方法）

这是大多数教程采用的方法，步骤清晰：

安装依赖：需要编译工具和开发库。以CentOS/RHEL为例：

sudo yum install make gcc postgresql-devel openssl-devel libxml2-devel lz4-devel libzstd-devel bzip2-devel libyaml-devel

下载并编译：

wget -O - https://github.com/pgbackrest/pgbackrest/archive/release/2.52.tar.gz | tar zx -C /opt
cd /opt/pgbackrest-release-2.52/src
./configure && make
sudo make install

设置目录与权限：

sudo mkdir -p -m 770 /var/log/pgbackrest
sudo chown postgres:postgres /var/log/pgbackrest
sudo mkdir -p /etc/pgbackrest
sudo touch /etc/pgbackrest/pgbackrest.conf
sudo chmod 640 /etc/pgbackrest/pgbackrest.conf
sudo chown postgres:postgres /etc/pgbackrest/pgbackrest.conf

使用Meson构建系统（新方式）

从2.51版本开始，pgBackRest引入了Meson构建系统。

确保已安装Meson和Ninja。

使用Meson配置和编译：

meson setup builddir --prefix=/usr
ninja -C builddir
cd builddir && sudo ninja install

注意：根据提示，Meson方式可能需要手动配置安装规则，且社区教程目前较少，建议初学者优先使用传统源码编译。

基础配置与验证
安装完成后，需要进行基础配置才能使用。

1.配置PostgreSQL：编辑postgresql.conf，启用归档。

archive_mode = on
archive_command = 'pgbackrest --stanza=demo archive-push %p'
wal_level = replica
max_wal_senders = 3

2.修改后需要重启PostgreSQL服务。

配置pgBackRest：编辑/etc/pgbackrest/pgbackrest.conf。

[global]
repo1-path=/var/lib/pgbackrest
repo1-retention-full=2

[demo]
pg1-path=/var/lib/postgresql/12/data  # 请替换为你的实际数据目录

3.初始化与检查：以postgres用户执行以下命令来创建存储空间并检查配置。

sudo -u postgres pgbackrest --stanza=demo stanza-create
sudo -u postgres pgbackrest --stanza=demo check

编译报错处理：
报错：

meson.build:159:0: ERROR: Dependency "libpq" not found, tried pkgconfig

libpq依赖包的位置：
/data/postgresql/pg16//lib/pkgconfig/libpq.pc

export PKG_CONFIG_PATH=/data/postgresql/pg16/lib/pkgconfig:$PKG_CONFIG_PATH
export PATH=/data/postgresql/pg16/bin:$PATH
meson setup builddir \
  -Dpkg_config_path=/data/postgresql/pg16//lib/pkgconfig