PolarDB for PostgreSQL 分布式文件系统 PFS 的格式化与挂载指南

PolarDB for PostgreSQL 分布式文件系统 PFS 的格式化与挂载指南

PolarDB-for-PostgreSQL 项目地址: https://gitcode.com/gh_mirrors/pol/PolarDB-for-PostgreSQL

前言

PolarDB File System（简称 PFS 或 PolarFS）是阿里云专为 PolarDB 数据库产品研发的高性能用户态分布式文件系统。作为 PolarDB for PostgreSQL 的核心组件之一，PFS 提供了类 POSIX 的文件系统接口，并确保在共享存储架构下，一个计算节点的写入操作能够立即对其他计算节点可见。

本文将详细介绍如何在 PolarDB for PostgreSQL 环境中准备和配置 PFS 文件系统，包括编译安装、设备重命名、格式化以及挂载等关键步骤。

PFS 的获取与安装

推荐方式：使用预编译镜像

对于大多数用户，我们建议直接使用官方提供的预编译 Docker 镜像，该镜像已包含完整的 PFS 工具链：

docker pull polardb/polardb_pg_binary
docker run -it \
    --cap-add=SYS_PTRACE \
    --privileged=true \
    --name polardb_pg \
    --shm-size=512m \
    polardb/polardb_pg_binary \
    bash

该镜像支持 x86_64 和 ARM64 两种架构，开箱即用，无需额外配置。

手动编译安装（高级用户）

如需从源码构建 PFS，可参考官方文档获取详细编译指南。手动编译主要涉及以下步骤：

1. 获取 PFS 源代码
2. 安装依赖的开发工具和库
3. 执行编译和安装
4. 配置环境变量

块设备准备与重命名

PFS 对块设备命名有特定要求，仅支持以下前缀的设备：

• /pangu-
• /sd
• /sf
• /vd
• /nvme
• /loop
• /mapper_

标准化设备命名的必要性：

1. 确保多节点访问同一设备时使用统一标识
2. 避免因设备名差异导致的挂载问题
3. 简化后续管理和维护

配置示例：

在服务端主机上：

sudo ln -s /dev/vdb /dev/nvme1n1

在客户端主机上：

sudo ln -s /dev/nbd0 /dev/nvme1n1

通过这种标准化命名，集群中的所有节点都能以相同路径 /dev/nvme1n1 访问共享存储设备。

PFS 文件系统格式化

格式化注意事项：

1. 只需在任意一个节点执行一次格式化操作
2. 格式化会清除设备上所有现有数据
3. 确保选择正确的设备名称

执行格式化命令：

sudo pfs -C disk mkfs nvme1n1

该命令会在指定的块设备上创建 PFS 文件系统结构，为后续数据库部署做好准备。

PFS 文件系统挂载

多节点挂载要点：

1. 需要在所有需要访问共享存储的节点上分别执行
2. 确保各节点使用相同的设备名称
3. 守护进程需要持续运行以维护文件系统状态

挂载命令：

sudo /usr/local/polarstore/pfsd/bin/start_pfsd.sh -p nvme1n1 -w 2

参数说明：

• -p：指定要挂载的块设备名称
• -w：设置工作线程数量，根据服务器CPU核心数调整

验证挂载状态

挂载完成后，可以通过以下方式验证：

1. 检查进程是否存在：

ps aux | grep pfsd

2. 查看挂载点：

mount | grep pfs

3. 测试基本文件操作：

sudo pfs -C disk touch /nvme1n1/testfile
sudo pfs -C disk ls /nvme1n1

后续步骤

成功挂载 PFS 后，即可在其上部署 PolarDB for PostgreSQL 数据库集群。PFS 为数据库提供了以下关键特性：

1. 数据一致性：确保多节点间的写入可见性
2. 高性能：优化的IO路径提升数据库吞吐量
3. 可靠性：内置的数据保护机制

关于在 PFS 上部署 PolarDB 数据库的具体步骤，请参考相关部署文档。

常见问题处理

1. 挂载失败：检查设备权限和名称是否符合要求
2. 性能问题：调整工作线程数量(-w参数)优化性能
3. 设备冲突：确保没有其他进程正在使用该块设备

通过以上步骤，您已经成功为 PolarDB for PostgreSQL 配置好了分布式文件系统基础环境，为构建高性能、高可用的数据库集群奠定了坚实基础。

PolarDB-for-PostgreSQL 项目地址: https://gitcode.com/gh_mirrors/pol/PolarDB-for-PostgreSQL