服务注册与分布式协调 / 系统课时

服务启动与停止

服务启动与停止

ZooKeeper 日常操作主要依赖发行包自带的 zkServer.sh。本节用同一套脚本完成启动、状态检查、重启、日志查看和停止,并建立“每次操作后立即验证”的习惯。

学习目标

  • 能使用官方脚本执行 start、status、restart 和 stop
  • 能通过状态、进程与日志判断服务是否真正可用
  • 能区分“脚本命令执行成功”和“ZooKeeper 已能响应客户端”这两个状态

启动后立即检查状态

在 ZooKeeper 安装目录执行启动命令。脚本会读取 conf/zoo.cfg,创建后台 Java 进程,并把启动信息写入日志。不要只看到 STARTED 就结束检查,应紧接着执行 status。

bash
cd <PATH>
bin/zkServer.sh start
bin/zkServer.sh status

预期结果(关键行)

text
Starting zookeeper ... STARTED
Mode: standalone

如果当前配置属于集群节点,Mode 可能是 leader、follower 或 observer;本章的单机配置应看到 standalone。某些版本还会打印 JMX、配置文件路径和客户端地址,这些附加行不影响判断。

重启并确认新进程接管

修改 zoo.cfg 后,已经运行的进程不会自动重新加载大多数服务器参数,通常需要重启。restart 会先停止当前实例,再按同一配置重新启动,适合本地实验和受控维护窗口。

bash
bin/zkServer.sh restart
bin/zkServer.sh status

预期结果(关键行)

text
Stopping zookeeper ... STOPPED
Starting zookeeper ... STARTED
Mode: standalone

查看进程与日志

当 status 失败、启动后立即退出或客户端连接异常时,需要同时检查 Java 进程和服务器日志。发行包通常把运行日志放在安装目录下的 logs 目录,具体文件名会包含用户或主机信息。

bash
jps -l | grep 'org.apache.zookeeper.server.quorum.QuorumPeerMain' || echo "ZooKeeper process not found"
ls -lt logs | head
tail -n 50 logs/zookeeper-*.out

预期结果(关键行)

text
<PID> org.apache.zookeeper.server.quorum.QuorumPeerMain

<PID>、日志文件名和日志时间都属于动态值,实际环境会不同。若第一行找不到进程,应优先阅读最新日志中的异常;常见原因包括端口占用、dataDir 无写权限、配置文件路径错误或 Java 环境不可用。

停止并验证服务退出

正常维护时优先使用 stop,让脚本根据 PID 文件结束 ZooKeeper 进程。停止后再次执行 status,应看到服务不可联系或未运行的信息,而不应继续显示 standalone。

bash
bin/zkServer.sh stop
bin/zkServer.sh status

预期结果(典型输出)

text
Stopping zookeeper ... STOPPED
Error contacting service. It is probably not running.

不同版本对“未运行”的提示文字可能略有差异。判断标准是 stop 完成后,status 不再返回运行角色。若脚本提示 PID 不存在但 Java 进程仍在,应先确认该进程是否属于当前安装目录和数据目录,再处理残留进程,避免误杀同机上的其他 ZooKeeper 实例。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

服务启动与停止

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通