服务注册与分布式协调 / 系统课时
服务启动与停止
服务启动与停止
ZooKeeper 日常操作主要依赖发行包自带的 zkServer.sh。本节用同一套脚本完成启动、状态检查、重启、日志查看和停止,并建立“每次操作后立即验证”的习惯。
学习目标
- 能使用官方脚本执行
start、status、restart和stop - 能通过状态、进程与日志判断服务是否真正可用
- 能区分“脚本命令执行成功”和“ZooKeeper 已能响应客户端”这两个状态
启动后立即检查状态
在 ZooKeeper 安装目录执行启动命令。脚本会读取 conf/zoo.cfg,创建后台 Java 进程,并把启动信息写入日志。不要只看到 STARTED 就结束检查,应紧接着执行 status。
cd <PATH>
bin/zkServer.sh start
bin/zkServer.sh status预期结果(关键行)
Starting zookeeper ... STARTED
Mode: standalone如果当前配置属于集群节点,Mode 可能是 leader、follower 或 observer;本章的单机配置应看到 standalone。某些版本还会打印 JMX、配置文件路径和客户端地址,这些附加行不影响判断。
重启并确认新进程接管
修改 zoo.cfg 后,已经运行的进程不会自动重新加载大多数服务器参数,通常需要重启。restart 会先停止当前实例,再按同一配置重新启动,适合本地实验和受控维护窗口。
bin/zkServer.sh restart
bin/zkServer.sh status预期结果(关键行)
Stopping zookeeper ... STOPPED
Starting zookeeper ... STARTED
Mode: standalone查看进程与日志
当 status 失败、启动后立即退出或客户端连接异常时,需要同时检查 Java 进程和服务器日志。发行包通常把运行日志放在安装目录下的 logs 目录,具体文件名会包含用户或主机信息。
jps -l | grep 'org.apache.zookeeper.server.quorum.QuorumPeerMain' || echo "ZooKeeper process not found"
ls -lt logs | head
tail -n 50 logs/zookeeper-*.out预期结果(关键行)
<PID> org.apache.zookeeper.server.quorum.QuorumPeerMain<PID>、日志文件名和日志时间都属于动态值,实际环境会不同。若第一行找不到进程,应优先阅读最新日志中的异常;常见原因包括端口占用、dataDir 无写权限、配置文件路径错误或 Java 环境不可用。
停止并验证服务退出
正常维护时优先使用 stop,让脚本根据 PID 文件结束 ZooKeeper 进程。停止后再次执行 status,应看到服务不可联系或未运行的信息,而不应继续显示 standalone。
bin/zkServer.sh stop
bin/zkServer.sh status预期结果(典型输出)
Stopping zookeeper ... STOPPED
Error contacting service. It is probably not running.不同版本对“未运行”的提示文字可能略有差异。判断标准是 stop 完成后,status 不再返回运行角色。若脚本提示 PID 不存在但 Java 进程仍在,应先确认该进程是否属于当前安装目录和数据目录,再处理残留进程,避免误杀同机上的其他 ZooKeeper 实例。