文档中心

文件存储 vePFS

最佳实践

配置客户端节点 pagepool

本文介绍如何配置客户端节点 pagepool。

pagepool 的作用与影响

vePFS 客户端节点上，通过挂载服务访问文件系统，文件的数据、元数据部分均会缓存在 pagepool 中。

在客户端负载比较重的业务场景下，pagepool 调大后访问文件系统的性能有提升。例如，客户端节点大量创建或者随机删除 vePFS 中的文件时，需要访问较多的元数据，调大 pagepool，可以缓存更多元数据，从而使得创建或者删除性能更好。

在业务负载大，而 pagepool 设置过小时，如 pagepool 4GB，workerThreads 为 1024 的场景下，1024 个并发同时下发，申请的内存会超过 pagepool 设置的 4GB 内存，从而导致申请不到内存，访问 vePFS 变慢或者卡顿，可能进一步导致 vePFS 客户端节点守护进程 crash，继而导致业务 IO 返错。

默认 pagepool

在添加客户端节点时，系统会根据被添加的客户端节点类型进行默认 pagepool 值设置。例如，客户端通过 VPC 网络访问存储时，使用vepfs add password {ECS IP 地址}添加节点的 pagepool 默认设置为 4GB；客户端通过 RDMA 网络访问存储时，使用vepfs -r add password {ECS IP 地址}添加节点的 pagepool 默认设置为 16GB。

修改默认配置

对于需要缓存更多数据、元数据的场景，可以在客户端管理节点上调整默认Pagepool参数的大小，参数WorkerThreads、FilesToCache、StatCache保持默认值即可。修改默认配置后，新添加的客户端节点会采用修改后的配置文件中的数值，已经添加的客户端节点不会被修改。

注意

三台客户端管理节点都需要修改配置文件。

非 RDMA 客户端节点

执行以下命令，修改配置文件/opt/vepfs/user_vpc_cfg.sh。

#!/bin/bash
UserVPCPagepool=16g
UserVPCWorkerThreads=256
UserVPCFilesToCache=128k
UserVPCStatCache=512k

修改后执行以下命令。

chmod +x /opt/vepfs/user_vpc_cfg.sh

RDMA 客户端节点

执行以下命令，修改配置文件/opt/vepfs/user_rdma_cfg.sh。

#!/bin/bash
UserRDMAPagepool=16g
UserRDMAWorkerThreads=256
UserRDMAFilesToCache=128k
UserRDMAStatCache=512k

修改后执行以下命令。

chmod +x /opt/vepfs/user_vpc_cfg.sh

修改已添加客户端节点配置

对于已经添加了的客户端节点，您可以执行以下命令调整参数。该命令执行后，调整增加 pagepool 在线生效，调整减小 pagepool 需重启对应节点上的 vePFS 服务后生效。

注意

pagepool 为预占，调整过大可能会占完整机内存，请参考节点的 free 内存进行合理调整。

例如，修改 IP 为10.10.10.10节点的 pagepool 为 16G，登录任意客户端管理节点执行以下命令。

最近更新时间：2026.05.20 15:50:18

这个页面对您有帮助吗？

有用

无用