本文档主要介绍，在参考快速入门（极速型 L3）完成客户端挂载后，如需对客户端进行升级或回滚，可按照本文档的步骤安全、规范地完成升级与回滚操作。

适用范围

仅适用于极速型L3

获取最新的 pfs_mount.sh

下载最新版 pfs_mount.sh 替换旧脚本，必须要放在原来的位置，可直接覆盖老版本脚本：

示例：

1wget -O /opt/pfs_mount.sh -nv https://su-pfs-client-bucket.su.bcebos.com/pfs_mount.sh?authorization=bce-auth-v1/ALTAKHlK9LpHdrzobnY6YBMQcF/2026-07-06T06:35:12Z/-1/host/f415d4122134701d39ae39988b505c9247696c9bf83a2beccf9ea26402472d87
2chmod +x /opt/pfs_mount.sh

注意：如果pfs_mount.sh脚本没有下载到原来的位置，执行升级会失败。

执行升级

1./pfs_mount.sh upgrade

• 自动下载当前地域的最新安装包并校验 md5，然后替换 pfs_client/ 下的 bin、conf、supervise。
• 替换前，旧文件会备份到 pfs_client/backup/<时间戳>/。conf 有变化时会打印 diff。
• 已经是最新版本时，输出 pfs client is already up to date.，不做任何改动。

• 正在运行的挂载不受影响，继续使用旧版本，业务无感。

  • 执行结果会显示 still running the replaced binary 的实例，需要按第 3 节重新挂载后才会切换到新版本，按需等业务窗口切换。

• 如果pfs_mount.sh下载位置非预期，则会升级失败：

  • [ERROR] pfs client not installed in <脚本所在目录>, use mount instead

回滚

先查看有哪些备份，以及默认会回滚到哪个：

1./pfs_mount.sh rollback --list

输出示例：

1  20261105100000_pre_rollback
2  20261104120000 <- default rollback target
3  20261101090000 [same pfs_client as installed]

• <- default rollback target：直接执行 rollback 时会回到这个备份。
• [same pfs_client as installed]：这个备份里的二进制与当前安装的相同。
• _pre_rollback：某次回滚前自动保存的版本，用于撤销那次回滚。

回滚到上一个版本：

1./pfs_mount.sh rollback

回滚到指定备份（名字取自 --list 的输出）：

1./pfs_mount.sh rollback --backup 20261104120000

说明：

• 连续执行 rollback 会一次退一个版本。没有更早的版本时报错 No older version to rollback to。
• 回滚前，当前文件会先保存到 pfs_client/backup/<时间戳>_pre_rollback/。撤销回滚：./pfs_mount.sh rollback --backup <时间戳>_pre_rollback。
• 和升级一样，正在运行的挂载不受影响，需要重新挂载才会切换。

让升级或回滚生效（重新挂载）

重新挂载会中断该挂载点上的业务，请在业务低峰期逐个操作：

1${PfsMountScriptPath}/pfs_mount.sh umount --local_path ${LocalPath}
2${PfsMountScriptPath}/pfs_mount.sh mount --mount_point ${MountPoint} --pfs_path ${PFSRemotePath} --local_path ${LocalPath} [--mode RWMode] [--o Options] [--install_dir ${PfsClientPath}] 

• mount 时使用与原来相同的参数（--pfs_path、--mode、-o 等）。

注意事项

• upgrade、rollback 与 mount、umount 互斥，同时执行时后者会等待，最长 600 秒。
• 每个备份约 255MB，不会自动清理。确认不再需要后，可手动删除 pfs_client/backup/ 下较旧的目录。
• 默认 rollback 只根据 bin/pfs_client 判断版本。如果某次升级只改了配置、没有换二进制，请用 --list 确认后再用 --backup 指定。
• 升级&回滚日志：pfs_client_install.log（与 pfs_client 目录同级）。

命令速查