2.2 单机模式安装与配置

2.2 单机模式安装与配置

第二章：Zookeeper 安装与配置

2.2 单机模式安装与配置

在本章节中，我们将深入探讨Zookeeper的单机模式安装与配置。单机模式是Zookeeper最简单的部署方式，非常适合开发、测试和学习环境。虽然它不具备高可用性和容错性，但在理解Zookeeper的基础架构和功能方面，单机模式是一个理想的起点。

2.2.1 单机模式概述

在深入安装配置之前，我们先来理解一下Zookeeper单机模式的核心概念。

• 单节点部署: 顾名思义，单机模式下，我们只需要在一台服务器上安装和运行一个Zookeeper服务实例。这个实例同时承担了Server角色和Leader/Follower角色（尽管在单节点中，Leader和Follower的概念并没有实际的区分，因为它只有一个节点）。

• 简化配置: 单机模式的配置相对简单，只需要最基本的参数设置即可启动Zookeeper服务。

• 适用场景: 单机模式主要应用于以下场景：

  • 本地开发环境: 方便开发者在本地快速搭建Zookeeper环境进行应用开发和调试。

  • 学习和演示: 用于学习Zookeeper的基本原理、API使用和功能特性。

  • 非关键业务测试环境: 在对高可用性要求不高的测试环境中，可以使用单机模式进行功能测试。

需要强调的是，单机模式不适用于生产环境。 一旦单节点发生故障，整个Zookeeper服务将不可用，从而影响依赖于Zookeeper的应用。生产环境应当采用集群模式部署，以保证高可用性和容错性。

2.2.2 环境准备

在开始Zookeeper单机模式安装之前，我们需要确保满足以下环境要求：

• 操作系统: Zookeeper可以在多种操作系统上运行，包括Linux、macOS和Windows。本教程以Linux系统为例进行讲解，其他系统安装过程类似。

• Java环境: Zookeeper是使用Java语言开发的，因此需要安装Java Development Kit (JDK)。 Zookeeper 3.5.x 及以上版本推荐使用 Java 8 或更高版本。

2.2.2.1 检查Java环境

在Linux系统中，可以通过以下命令检查是否已安装Java以及Java版本：

java -version
​

如果已经安装Java，命令会输出Java的版本信息，例如：

java version "1.8.0_291"
Java(TM) SE Runtime Environment (build 1.8.0_291-b10)
Java HotSpot(TM) 64-Bit Server VM (build 25.291-b10, mixed mode)
​

如果未安装Java或者版本过低，你需要安装或升级Java。 你可以从Oracle官网或者OpenJDK官网下载JDK安装包，并按照官方文档进行安装配置。 这里不再赘述Java的安装过程，请自行查阅相关资料。

2.2.3 下载Zookeeper

访问Apache Zookeeper官方网站的下载页面：https://zookeeper.apache.org/releases.html

在下载页面中，找到最新的稳定版本（Stable Release）。建议下载以 .tar.gz 结尾的二进制包（Binary）。 例如，apache-zookeeper-x.x.x-bin.tar.gz，其中 x.x.x 代表版本号。

使用 wget 命令或者通过浏览器下载到你的服务器上。 例如：

wget https://dlcdn.apache.org/zookeeper/zookeeper-3.8.2/apache-zookeeper-3.8.2-bin.tar.gz
​

(请将链接替换为最新的稳定版本下载链接)

2.2.4 安装Zookeeper

下载完成后，我们需要将Zookeeper安装包解压到指定目录。 通常，我们会选择 /opt 目录作为软件安装目录。

1. 创建安装目录 (可选): 如果你希望将Zookeeper安装在 /opt/zookeeper 目录下，可以先创建该目录：

   sudo mkdir /opt/zookeeper
   ​

2. 解压安装包: 使用 tar 命令解压下载的 .tar.gz 文件到安装目录。假设你将安装包下载到了 /home/user/Downloads 目录，可以执行以下命令：

   sudo tar -zxvf apache-zookeeper-3.8.2-bin.tar.gz -C /opt/zookeeper
   ​

   这条命令会将 apache-zookeeper-3.8.2-bin.tar.gz 解压到 /opt/zookeeper 目录下，并在该目录下创建一个名为 apache-zookeeper-3.8.2-bin 的文件夹。 为了方便后续操作，我们可以将解压后的文件夹重命名为 zookeeper：

   sudo mv /opt/zookeeper/apache-zookeeper-3.8.2-bin /opt/zookeeper/zookeeper
   ​

   现在，Zookeeper的安装目录就应该是 /opt/zookeeper/zookeeper。

2.2.5 配置Zookeeper

Zookeeper的配置文件位于安装目录下的 conf 文件夹中。 在单机模式下，我们需要配置的主要文件是 zoo.cfg。

1. 复制配置文件模板: 进入Zookeeper的 conf 目录：

   cd /opt/zookeeper/zookeeper/conf
   ​

   该目录下有一个名为 zoo_sample.cfg 的示例配置文件。 我们需要将其复制一份并重命名为 zoo.cfg，Zookeeper服务启动时会默认加载 zoo.cfg 文件。

   cp zoo_sample.cfg zoo.cfg
   ​

2. 编辑 zoo.cfg 文件: 使用文本编辑器（如 vi, nano 等）打开 zoo.cfg 文件：

   vi zoo.cfg
   ​

   zoo.cfg 文件中包含了很多配置项，在单机模式下，我们需要关注以下几个关键配置项：

   • tickTime: Zookeeper服务器之间或客户端与服务器之间维持心跳的时间间隔，单位是毫秒。 默认值是 3000 (3秒)。 可以根据网络状况适当调整，但一般默认值即可。

   • initLimit: Follower节点启动后与Leader节点进行数据同步的最大时间，以 tickTime 的倍数表示。 如果Follower节点在这个时间内未能完成同步，则会被Leader节点移除。 默认值是 10，即 10 * tickTime。 在单机模式下，这个配置项通常不需要修改。

   • syncLimit: Leader节点与Follower节点之间消息同步的最大时间，以 tickTime 的倍数表示。 如果Follower节点在这个时间内未能与Leader节点完成同步，则会被Leader节点移除。 默认值是 5，即 5 * tickTime。 在单机模式下，这个配置项通常不需要修改。

   • dataDir: Zookeeper服务器存储数据的目录。 这是非常重要的配置项，必须配置正确。 Zookeeper会将数据快照（snapshot）和事务日志（transaction log）都存储在这个目录下。 默认情况下，示例配置文件中 dataDir 的值是 /tmp/zookeeper。 强烈建议修改为更合适的目录，例如在Zookeeper安装目录下创建一个 data 目录，并将其路径配置为 dataDir 的值。 这样做可以避免数据存储在临时目录 /tmp 下，防止系统重启或清理临时文件时数据丢失。

   • clientPort: Zookeeper服务器监听客户端连接的端口。 默认值是 2181。 客户端应用程序需要连接到这个端口才能与Zookeeper服务器进行通信。 如果端口没有冲突，通常不需要修改。

   修改 dataDir 配置: 在 zoo.cfg 文件中找到 dataDir=/tmp/zookeeper 这一行，将其修改为你希望的数据存储目录。 例如，在Zookeeper安装目录下创建 data 目录：

   sudo mkdir /opt/zookeeper/zookeeper/data
   ​

   然后将 zoo.cfg 文件中的 dataDir 修改为：

   dataDir=/opt/zookeeper/zookeeper/data
   ​

   修改后的 zoo.cfg 文件关键配置项可能如下所示 (其他配置项可以保持默认值):

   tickTime=3000
   initLimit=10
   syncLimit=5
   dataDir=/opt/zookeeper/zookeeper/data
   clientPort=2181
   ​

   保存并关闭 zoo.cfg 文件。

2.2.6 启动Zookeeper服务

配置完成后，我们就可以启动Zookeeper单机服务了。

1. 进入 bin 目录: 切换到Zookeeper安装目录的 bin 目录：

   cd /opt/zookeeper/zookeeper/bin
   ​

2. 启动Zookeeper服务: 执行 zkServer.sh 脚本启动Zookeeper服务：

   ./zkServer.sh start
   ​

   启动过程中，会输出一些日志信息。 如果启动成功，你会在日志中看到类似 STARTED 的字样。

   你也可以使用 status 命令检查Zookeeper服务的运行状态：

   ./zkServer.sh status
   ​

   如果Zookeeper服务正常运行，状态会显示 Mode: standalone。

   ZooKeeper JMX enabled by default
   Using config: /opt/zookeeper/zookeeper/bin/../conf/zoo.cfg
   Client port found: 2181. Client address: localhost. Client SSL: false.
   Mode: standalone
   ​

2.2.7 连接Zookeeper客户端

Zookeeper自带了一个简单的命令行客户端工具 zkCli.sh，可以用来连接到Zookeeper服务器并进行交互。

1. 进入 bin 目录: 同样，切换到Zookeeper安装目录的 bin 目录：

   cd /opt/zookeeper/zookeeper/bin
   ​

2. 启动客户端: 执行 zkCli.sh 脚本启动客户端并连接到本地Zookeeper服务器 (默认连接到 localhost:2181)：

   ./zkCli.sh
   ​

   如果连接成功，你会看到类似以下的输出，并进入 zkCli 的命令行界面：

   Connecting to localhost:2181
   ...
   WATCHER::
   WatchedEvent state:SyncConnected type:None path:null
   [zk: localhost:2181(CONNECTED) 0]
   ​

   [zk: localhost:2181(CONNECTED) 0] 表示你已经成功连接到Zookeeper服务器。

3. 常用客户端命令: 在 zkCli 命令行界面，你可以执行一些命令来操作Zookeeper。 以下是一些常用的命令示例：

   • help: 查看帮助信息，列出所有可用的命令。

   • ls path: 列出指定路径下的子节点。 例如，ls / 列出根节点下的子节点。

   • create path data: 创建一个持久节点，并设置节点数据。 例如，create /my_node my_data 创建一个名为 my_node 的节点，数据为 my_data。

   • get path: 获取指定节点的数据。 例如，get /my_node 获取 /my_node 节点的数据。

   • set path data: 设置指定节点的数据。 例如，set /my_node new_data 将 /my_node 节点的数据更新为 new_data。

   • delete path: 删除指定节点。 例如，delete /my_node 删除 /my_node 节点。

   • quit: 退出 zkCli 客户端。

   你可以尝试执行一些命令来体验Zookeeper的基本操作。 例如：

   [zk: localhost:2181(CONNECTED) 0] ls /
   [zookeeper]
   [zk: localhost:2181(CONNECTED) 0] create /my_node hello_zookeeper
   Created /my_node
   [zk: localhost:2181(CONNECTED) 0] get /my_node
   hello_zookeeper
   cZxid = 0x100000002
   ctime = Tue Oct 24 14:30:00 CST 2023
   mZxid = 0x100000002
   mtime = Tue Oct 24 14:30:00 CST 2023
   pZxid = 0x0
   cversion = 0
   dataVersion = 0
   aclVersion = 0
   ephemeralOwner = 0x0
   dataLength = 15
   numChildren = 0
   [zk: localhost:2181(CONNECTED) 0] quit
   Quitting...
   ​

2.2.8 停止Zookeeper服务

当你不再需要Zookeeper服务时，可以将其停止。

1. 进入 bin 目录: 切换到Zookeeper安装目录的 bin 目录：

   cd /opt/zookeeper/zookeeper/bin
   ​

2. 停止Zookeeper服务: 执行 zkServer.sh 脚本停止Zookeeper服务：

   ./zkServer.sh stop
   ​

   停止过程中，会输出一些日志信息。 当服务成功停止后，你再次执行 status 命令，状态会显示 Error contacting service. It is probably not running.

2.2.9 单机模式架构图

为了更直观地理解Zookeeper单机模式的架构，我们可以使用Mermaid语法绘制一个简单的图表：

图表解释:

• Client: 代表客户端应用程序，例如使用Zookeeper Java客户端API的应用。

• Client Requests: 客户端应用程序向Zookeeper服务器发送请求，例如创建节点、读取数据、监听节点变化等。

• Standalone_Zookeeper_Server: 代表单机模式下运行的Zookeeper服务器实例。 它接收客户端请求，处理请求，并将数据存储在本地磁盘上。

• Disk: 代表服务器的本地磁盘，Zookeeper服务器将数据快照和事务日志存储在磁盘上，通过 zoo.cfg 文件中 dataDir 配置的目录进行指定。

2.2.10 总结

本章节详细介绍了Zookeeper单机模式的安装与配置过程。 通过本章节的学习，你应该能够：

• 理解Zookeeper单机模式的概念和适用场景。

• 掌握Zookeeper单机模式的安装步骤，包括下载、解压和配置。

• 了解 zoo.cfg 配置文件中关键配置项的含义和作用。

• 能够启动、停止和连接Zookeeper单机服务。

• 使用 zkCli.sh 客户端工具进行基本操作。

单机模式是学习Zookeeper的良好开端。 在掌握了单机模式的基础上，后续章节我们将进一步探讨Zookeeper的集群模式安装与配置，以及更深入的功能特性和应用场景。

2.2.11 常见问题与注意事项

• 端口冲突: 如果 clientPort 端口 (默认 2181) 被其他程序占用，Zookeeper服务启动可能会失败。 你可以修改 zoo.cfg 文件中的 clientPort 配置项，更换为其他未被占用的端口。

• dataDir 目录权限: 确保Zookeeper服务进程对 dataDir 配置的目录具有读写权限。 否则，Zookeeper服务可能无法正常启动或存储数据。

• 日志查看: Zookeeper的日志文件默认输出到控制台。 如果需要查看更详细的日志信息，可以配置Zookeeper的日志系统 (log4j)，将日志输出到指定文件。 这部分内容超出本章节范围，可以查阅Zookeeper官方文档了解更多日志配置信息。

• 单机模式局限性: 再次强调，单机模式仅适用于开发、测试和学习环境，不适用于生产环境。 生产环境必须采用集群模式部署，以保证高可用性和数据可靠性。

希望本章节内容能够帮助你成功安装和配置Zookeeper单机模式。 在接下来的学习中，我们将继续深入探索Zookeeper的更多内容。