如何更新Ubuntu上的Zookeeper

如何在Ubuntu上更新Zookeeper

1. 备份现有数据与配置

升级前必须备份Zookeeper的数据目录和配置文件，避免操作失误导致数据丢失。默认路径如下：

• 数据目录：/var/lib/zookeeper
• 配置文件目录：/etc/zookeeper/conf

使用以下命令完成备份：

sudo cp -R /var/lib/zookeeper /var/lib/zookeeper-backup
sudo cp -R /etc/zookeeper /etc/zookeeper-backup

2. 停止当前Zookeeper服务

通过systemctl命令安全停止正在运行的Zookeeper服务：

sudo systemctl stop zookeeper

3. 卸载旧版本（可选但推荐）

若当前Zookeeper通过APT包管理器安装，建议先卸载旧版本以清理残留文件：

sudo apt-get remove --purge zookeeper zookeeperd

4. 下载新版本二进制包

前往Apache ZooKeeper官方网站（https://zookeeper.apache.org/releases.html）下载目标版本的二进制包（如apache-zookeeper-3.8.0-bin.tar.gz），推荐使用wget命令：

wget https://downloads.apache.org/zookeeper/zookeeper-3.8.0/apache-zookeeper-3.8.0-bin.tar.gz

5. 解压并安装新版本

将下载的二进制包解压至/opt目录（常用软件安装路径），并重命名文件夹以便管理：

sudo tar -xzf apache-zookeeper-3.8.0-bin.tar.gz -C /opt
sudo mv /opt/apache-zookeeper-3.8.0-bin /opt/zookeeper

6. 迁移数据与配置

• 迁移数据目录：将旧版本数据复制到新版本的data子目录（需确保新版本目录结构存在）：

  sudo mkdir -p /opt/zookeeper/data
  sudo mv /var/lib/zookeeper/* /opt/zookeeper/data/
  

• 迁移配置文件：检查新版本conf目录下的zoo.cfg是否有新增配置项（如autopurge.snapRetainCount、autopurge.purgeInterval等），合并旧配置与新配置：

  sudo cp /etc/zookeeper/conf/zoo.cfg /opt/zookeeper/conf/
  

7. 更新系统服务配置（可选）

若需通过systemctl管理新版本服务，需创建或修改服务文件（如/etc/systemd/system/zookeeper.service），内容参考以下模板：

[Unit]
Description=Apache ZooKeeper Server
After=network.target

[Service]
Type=forking
ExecStart=/opt/zookeeper/bin/zkServer.sh start
ExecStop=/opt/zookeeper/bin/zkServer.sh stop
Restart=on-failure
User=zookeeper
Group=zookeeper

[Install]
WantedBy=multi-user.target

然后重新加载systemd并启动服务：

sudo systemctl daemon-reload
sudo systemctl start zookeeper
sudo systemctl enable zookeeper  # 设置开机自启

8. 验证升级结果

• 检查服务状态：

  sudo systemctl status zookeeper
  

  正常输出应显示“active (running)”。
• 连接ZooKeeper节点： 使用echo stat命令向ZooKeeper发送状态请求，确认版本信息：

  echo stat | nc localhost 2181
  

  输出中应包含新版本号（如Znode version: 3.8.0）。

注意事项

• 版本兼容性：升级前需确认新版本与旧版本的数据格式兼容性（如ZooKeeper 3.5+与3.4-的数据格式不兼容），建议参考官方升级指南。
• 依赖检查：确保系统满足新版本的依赖要求（如Java版本，ZooKeeper 3.8+需Java 11及以上）。
• 回滚方案：若升级失败，可通过备份快速恢复旧版本：

  sudo systemctl stop zookeeper
  sudo rm -rf /opt/zookeeper /var/lib/zookeeper /etc/zookeeper
  sudo cp -R /opt/zookeeper-backup /opt/zookeeper
  sudo cp -R /etc/zookeeper-backup /etc/zookeeper
  sudo systemctl start zookeeper