入门

本文档包含帮助您快速开始使用 ZooKeeper 的信息。它主要针对希望尝试它的开发人员，并包含单个 ZooKeeper 服务器的简单安装说明、一些用于验证它是否正在运行的命令以及一个简单的编程示例。最后，为方便起见，还有一些关于更复杂安装的部分，例如运行复制部署和优化事务日志。但是，有关商业部署的完整说明，请参阅ZooKeeper 管理员指南。

请参阅管理员指南中的系统要求。

要获得 ZooKeeper 发行版，请从 Apache 下载镜像之一下载最近的稳定版本。

在独立模式下设置 ZooKeeper 服务器很简单。服务器包含在单个 JAR 文件中，因此安装包括创建配置。

一旦你下载了一个稳定的 ZooKeeper 版本，解压它并 cd 到根目录

要启动 ZooKeeper，您需要一个配置文件。这是一个示例，在conf/zoo.cfg中创建它：

这个文件可以被称为任何东西，但为了讨论起见，称之为conf/zoo.cfg。更改dataDir的值以指定现有（开始时为空）目录。以下是每个字段的含义：

tickTime：ZooKeeper 使用的基本时间单位，以毫秒为单位。它用于做心跳，最小会话超时将是 tickTime 的两倍。

dataDir：存储内存数据库快照的位置，除非另有说明，否则存储数据库更新的事务日志。

clientPort：监听客户端连接的端口

现在您已经创建了配置文件，您可以启动 ZooKeeper：

ZooKeeper 使用logback记录消息——程序员指南的日志部分提供了更多详细信息。根据 logback 配置，您将看到到达控制台（默认）和/或日志文件的日志消息。

此处概述的步骤以独立模式运行 ZooKeeper。没有复制，因此如果 ZooKeeper 进程失败，服务将关闭。这对于大多数开发情况都很好，但是要在复制模式下运行 ZooKeeper，请参阅Running Replicated ZooKeeper。

对于长期运行的生产系统，ZooKeeper 存储必须在外部进行管理（dataDir 和日志）。有关详细信息，请参阅维护部分。

这使您可以执行简单的类似文件的操作。

连接后，您应该会看到如下内容：

在 shell 中，键入help以获取可以从客户端执行的命令列表，如下所示：

从这里，您可以尝试一些简单的命令来感受这个简单的命令行界面。首先，首先发出 list 命令，如 中ls，产生：

接下来，通过运行创建一个新的 znode create /zk_test my_data。这将创建一个新的 znode 并将字符串“my_data”与该节点相关联。你应该看到：

发出另一个ls /命令来查看目录的样子：

请注意，现在已经创建了 zk_test 目录。

get接下来，通过运行命令验证数据是否与 znode 关联，如下所示：

set我们可以通过发出命令来更改与 zk_test 关联的数据，如下所示：

（请注意，我们get在设置数据后做了一个，它确实发生了变化。

最后，让我们delete通过发出：

现在就是这样。要探索更多信息，请参阅Zookeeper CLI。

ZooKeeper 具有 Java 绑定和 C 绑定。它们在功能上是等效的。C 绑定存在两种变体：单线程和多线程。这些仅在消息传递循环的完成方式上有所不同。有关更多信息，请参阅ZooKeeper 程序员指南中的编程示例以获取使用不同 API 的示例代码。

以独立模式运行 ZooKeeper 便于评估、一些开发和测试。但在生产中，您应该以复制模式运行 ZooKeeper。同一应用程序中的一组复制服务器称为仲裁，在复制模式下，仲裁中的所有服务器都具有相同配置文件的副本。

对于复制模式，至少需要三台服务器，强烈建议您使用奇数台服务器。如果您只有两台服务器，那么您的情况是，如果其中一台出现故障，则没有足够的机器来形成多数仲裁。两台服务器本质上不如一台服务器稳定，因为有两个单点故障。

复制模式所需的conf/zoo.cfg文件类似于独立模式中使用的文件，但有一些不同之处。这是一个例子：

新条目initLimit是 ZooKeeper 用来限制法定人数中的 ZooKeeper 服务器必须连接到领导者的时间长度。条目syncLimit限制服务器与领导者之间的过期时间。

对于这两种超时，您可以使用tickTime指定时间单位。在此示例中，initLimit 的超时时间为 5 个滴答声，每滴答声为 2000 毫秒，即 10 秒。

表单server.X的条目列出了组成 ZooKeeper 服务的服务器。当服务器启动时，它通过在数据目录中查找文件myid来知道它是哪个服务器。该文件包含 ASCII 格式的服务器编号。

最后，请注意每个服务器名称后面的两个端口号：“2888”和“3888”。对等点使用前一个端口连接到其他对等点。这样的连接是必要的，以便对等方可以进行通信，例如，就更新顺序达成一致。更具体地说，ZooKeeper 服务器使用此端口将追随者连接到领导者。当一个新的领导者出现时，一个追随者使用这个端口打开一个到领导者的 TCP 连接。因为默认的leader选举也使用TCP，所以我们目前需要另外一个端口来进行leader选举。这是服务器条目中的第二个端口。

如果您想在一台机器上测试多个服务器，请将服务器名称指定为具有唯一仲裁和领导选举端口（即上面示例中的 2888: 3888、2889 :3889、2890:3890）的服务器名称。配置文件。当然，单独的 _dataDir_s 和不同的 _clientPort_s 也是必要的（在上面复制的示例中，在单个localhost上运行，您仍然会有三个配置文件）。

请注意，在一台机器上设置多个服务器不会产生任何冗余。如果发生了导致机器死机的事情，所有的 zookeeper 服务器都将处于脱机状态。完全冗余要求每台服务器都有自己的机器。它必须是完全独立的物理服务器。同一物理主机上的多个虚拟机仍然容易受到该主机完全故障的影响。

如果您的 ZooKeeper 机器中有多个网络接口，您还可以指示 ZooKeeper 绑定您的所有接口，并在网络故障时自动切换到健康的接口。有关详细信息，请参阅配置参数。

还有一些其他配置参数可以大大提高性能：