本文将深度解析Proxmox VE官方升级检查工具pve8to9-check，涵盖其核心功能、高级用法与实战技巧，助你顺利完成从PVE 8到PVE 9的平稳升级。
为什么大部分升级故障可以提前规避？
在Proxmox社区中，从版本8升级到版本9时，常会遇到诸如系统无法启动、集群状态异常或存储池导入失败等问题。官方分析指出，绝大多数升级故障的隐患在升级操作执行前就已经存在于系统中。
为此，PVE 9的安装镜像内置了一个名为pve8to9-check的升级前检查工具。它能系统性地扫描你的环境，提前暴露潜在风险。
核心检查：一条命令生成全景报告
在任意集群节点上，执行以下命令即可进行完整检查：
pve8to9-check --full
命令执行后，会生成一份清晰的彩色报告，将所有检查项分为 ✅通过、⚠️警告 和 ❌失败 三类。失败项必须修复后才能进行升级。
高级实战技巧
1. 模拟升级与状态快照
通过--dry-run参数可以进行零风险的模拟扫描，并结合调试日志和JSON输出，生成一份可追溯的系统状态“快照”。
pve8to9-check --dry-run --log-level=debug \
--output=/var/tmp/pre-upgrade.json
此报告可用于升级前后的状态比对，精准定位升级过程中被修改的配置项。
2. 集群批量并行检查
逐一登录每个节点执行检查效率低下。你可以利用简单的Shell脚本和SSH免密登录，实现对整个集群的并行巡检。
for n in $(pvesh get /nodes --output-format json | jq -r .[].node); do
ssh $n “pve8to9-check --quiet --output /tmp/$n.json” &
done
wait
通过Shell脚本与Linux系统管理技巧，可以快速汇总所有节点的检查结果，全局风险一目了然。
3. 定义自定义检查规则
工具支持扩展规则。你可以在/etc/pve8to9/myrules.yaml中创建自定义规则，将内部运维规范（如禁止使用的特定内核参数）转化为自动检查项。
id: 501
desc: “生产环境禁用的内核参数”
type: kernel_cmdline
pattern: “elevator=deadline”
level: fail
随后使用--ruleset参数指定该规则文件运行检查，使工具更贴合你的实际运维与DevOps环境。
4. 自动修复可处理项
对于标记为警告（WARN）且提供自动修复方案的项目，可以使用--auto-fix参数进行一键处理。通过--whitelist可以精确控制修复项，避免误操作。
pve8to9-check --auto-fix --whitelist 1003,1007
工具在执行自动修复前会为相关存储（LVM/ZFS）创建快照，确保操作安全可回滚。
常见失败项及修复命令速查
下表列举了升级检查中常见的失败项及其官方推荐的一键修复命令：
| 错误码 |
含义 |
一键修复命令 |
| 1001 |
软件源仍指向企业订阅库 |
sed -i ‘s/pve-enterprise/pve-no-subscription/’ /etc/apt/sources.list.d/pve-enterprise.list |
| 1002 |
corosync令牌超时设置过短 |
pvecm expected 1 && pvecm set totem.token=2000 |
| 1005 |
ZFS工具版本过低 |
apt install zfsutils-linux=2.3.* |
| 1010 |
内核参数包含已废弃的audit=0 |
sed -i ‘/audit=0/d’ /etc/default/grub && update-grub |
| 1013 |
LVM快照链层数超过8层 |
pve8to9-check --auto-fix --whitelist 1013 |
| 1016 |
节点UUID重复 |
rm /etc/pve/.members && systemctl restart pve-cluster |
| 1020 |
未配置NTP时间同步 |
apt install chrony && systemctl enable --now chrony |
升级操作清单
在执行最终的apt dist-upgrade之前，请按此清单完成最后确认：
- 在所有集群节点上执行
pve8to9-check --full，确保结果为零失败。
- 备份关键目录：
/etc/pve 和 /var/lib/pve-cluster。
- 为Ceph、ZFS等关键存储创建快照或使用
pve-zsync备份。
- 配置APT优先级，锁定
proxmox-ve软件包版本为9.*。
- 执行升级：
apt update && apt dist-upgrade。
- 升级完成后，再次运行检查工具，对比升级前后的报告，确认没有引入新的问题。
总结
pve8to9-check工具能系统性地识别并指导修复PVE 8升级至9版本前的绝大多数已知兼容性问题。熟练掌握其基础与高级用法，能将升级过程从“冒险”变为“可预测、可管控”的标准操作，极大提升升级的成功率与安全性。
发表于 3 天前
|
查看: 8|
回复: 0
