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

单机模式配置

单机模式配置

单机模式适合本地学习和功能验证。本节会建立可写的数据目录,配置客户端端口与 tickTime,再启动 ZooKeeper 并确认服务以 standalone 模式运行。

学习目标

  • 能写出最小可用的 zoo.cfg,理解 dataDir、clientPort 与 tickTime 的职责
  • 能启动单机 ZooKeeper,并通过官方脚本确认运行模式
  • 能识别目录权限、端口占用和配置文件缺失这三类常见启动问题

准备数据目录与配置文件

ZooKeeper 默认由 bin/zkServer.sh 读取 conf/zoo.cfg。单机模式不需要配置 server.1 等成员列表;最小配置只需准备时间基准、数据目录和客户端端口。dataDir 必须是 ZooKeeper 进程可写的目录,正式环境还应放在持久化磁盘上。

先把 <PATH> 替换为 ZooKeeper 安装目录;本地实验把数据放在其 zk-data 子目录:

bash
cd <PATH>
mkdir -p <PATH>/zk-data
cat > conf/zoo.cfg <<'EOF'
tickTime=2000
dataDir=<PATH>/zk-data
clientPort=2181
EOF

grep -E '^(tickTime|dataDir|clientPort)=' conf/zoo.cfg

预期输出

text
tickTime=2000
dataDir=<PATH>/zk-data
clientPort=2181

tickTime 的单位是毫秒,它是 ZooKeeper 内部超时计算的基础时间单位。这里设为 2000 ms 足以用于常规实验。initLimit 和 syncLimit 主要约束集群成员之间的初始化与同步,单机模式不依赖它们,因此不必为了“配置完整”而额外添加。

启动并验证单机服务

配置完成后,用官方脚本启动服务,再查询状态。status 会读取同一份配置并连接客户端端口,因此既能检查进程是否存在,也能验证服务是否真正响应。

bash
bin/zkServer.sh start
bin/zkServer.sh status

预期结果(关键行)

text
Starting zookeeper ... STARTED
Mode: standalone

不同 ZooKeeper 版本可能额外输出 JMX、配置文件路径或客户端地址,因此中间行会有差异;关键验收信号是启动结果为 STARTED,状态中出现 Mode: standalone。

处理启动失败

如果脚本没有进入 STARTED,先按“配置、目录、端口”的顺序排查。配置文件缺失或语法错误时,日志通常会直接指出 zoo.cfg 或具体参数;dataDir 不可写会导致快照、事务日志或 PID 文件创建失败;2181 被占用则会在绑定客户端端口时失败。

可以先做三项快速检查:

bash
test -f conf/zoo.cfg && echo "config ok"
test -w <PATH>/zk-data && echo "dataDir writable"
ss -ltn | grep ':2181 ' || echo "2181 is free"

预期输出

text
config ok
dataDir writable
2181 is free

如果第三行显示的是监听记录而不是 2181 is free,说明已有进程占用了该端口,应停止冲突进程或修改 clientPort。完成修正后重新执行 bin/zkServer.sh start 和 bin/zkServer.sh status,直到状态明确为 standalone。

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

目录与阅读设置

阅读设置

17

记录一个想法

单机模式配置

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

登录哪都通