centos zookeeper版本升级注意事项

CentOS下Zookeeper版本升级注意事项

1. 数据备份：避免数据丢失的核心保障

升级前必须对ZooKeeper的数据目录（默认/var/lib/zookeeper）和配置文件（默认/etc/zookeeper/conf/zoo.cfg）进行完整备份。可使用以下命令：

systemctl stop zookeeper  # 停止服务
cp -r /var/lib/zookeeper /var/lib/zookeeper_backup  # 备份数据
cp -r /etc/zookeeper/conf /etc/zookeeper_conf_backup  # 备份配置

备份完成后重启服务，确保备份数据有效。

2. 版本兼容性：避免功能异常的关键检查

JDK版本：Zookeeper 3.5.5及以上版本要求最低支持JDK 8，升级前需确认系统JDK版本是否符合要求（可通过java -version查看）。
功能兼容性：查阅新版本发行说明（Release Notes），重点关注与现有系统（如客户端SDK、监控工具）或应用程序的兼容性变化（如API弃用、配置项调整）。

3. 配置文件适配：确保服务正常启动

新版本可能调整配置项（如autopurge.snapRetainCount、autopurge.purgeInterval等），需对比新旧版本的zoo.cfg文档，修改对应配置。
确认关键路径正确：dataDir（数据目录）、dataLogDir（日志目录）需指向有效存储位置，且目录权限设置为zookeeper用户所有（chown -R zookeeper:zookeeper /var/lib/zookeeper）。

4. 集群环境：逐节点升级保障稳定性

若为集群部署，需逐个节点升级（而非同时停止所有节点），步骤如下：

停止当前节点服务（systemctl stop zookeeper）；
按上述步骤完成该节点升级；
启动该节点（systemctl start zookeeper）并检查状态（systemctl status zookeeper）；
确认该节点加入集群（通过zkCli.sh执行ls /命令无报错）后，再升级下一个节点。

5. 环境变量与系统服务：确保服务可管理

环境变量：更新/etc/profile或/etc/zookeeper/conf/environment文件，确保ZOOKEEPER_HOME指向新版本安装目录（如export ZOOKEEPER_HOME=/opt/apache-zookeeper-3.8.0），并添加$ZOOKEEPER_HOME/bin到PATH中。
系统服务：修改新版本的zookeeper.service文件（通常位于/usr/lib/systemd/system/），更新Environment变量和ExecStart路径（指向新版本的zkServer.sh），然后执行以下命令重载服务：
```
systemctl daemon-reload
systemctl start zookeeper
systemctl status zookeeper  # 检查状态
```

6. 测试验证：确认升级效果

基础功能测试：使用zkCli.sh连接服务器，执行version命令确认版本号，ls /命令检查数据完整性。
性能测试：通过压力测试工具（如zkStress）验证升级后服务的吞吐量、延迟是否符合预期。
日志检查：查看/var/log/zookeeper/zookeeper.out或journalctl -u zookeeper日志，确认无报错信息。

7. 监控与回滚：应对潜在问题

监控：升级后启用ZooKeeper监控（如Prometheus+Granafa），重点关注znode数量、Watch数量、请求延迟等指标，及时发现异常。

回滚方案：若升级后出现严重问题（如无法启动、数据损坏），可快速恢复备份数据：

systemctl stop zookeeper
rm -rf /var/lib/zookeeper  # 删除新版本数据
cp -r /var/lib/zookeeper_backup /var/lib/zookeeper  # 恢复备份
systemctl start zookeeper