# zookeeper # 环境（集群）搭建

参考了部分网上资料，真机搭建环境后的总结保证可用

（所需环境：centos7机器大于等于3奇数台+已配置完java环境jdk1.8及以上）

假设有三台机器，ip分别为，并且三台机器上都有用户‘user’

机器	IP地址
机器1	192.168.0.101
机器2	192.168.0.102
机器3	192.168.0.103

一、下载与解压zookeeper

1. 前往官网https://zookeeper.apache.org/或直接进入其镜像网站（我这里选择了华中科技大学镜像地址http://mirrors.hust.edu.cn/apache/zookeeper/）进行下载，下载下来是一个压缩包tar.gz,版本我选择了3.4.13
2. 为了方便操作，把安装包和安装目录包括以后的临时目录都放在了/home/user/（即user用户对应的主目录~/）下,同时后续操作都以user用户身份进行操作
3. 解压压缩包

   • 进入 user主目录

       $ cd ~/
     

   • 解压zookeeper-3.4.13.tar.gz

       $ tar -zxvf zookeeper-3.4.13.tar.gz
     

二、安装与配置

1. 建立zookeeper数据临时目录后面会用到（这里我选择在user主目录下建立一个叫zkTemp的目录）

   • 进入 user主目录

       $ cd ~/
     

   • 建立临时目录

       $ mkdir zkTemp
     

2. 配置zookeeper配置文件

   • 进入解压的目录，即之前的~/zookeeper-3.4.13/,并进入里面的conf目录

       $ cd ~/zookeeper-3.4.13/conf
     

   • 复制并重命名文件zoo_sample.cfg为zoo.cfg

       $ cp zoo_sample.cfg zoo.cfg
     

   • 使用gedit文本编辑工具打开并编辑配置文件zoo.cfg(你也可以选择使用vi或者vim编辑工具)

       $ gedit zoo.cfg
     

   • 配置临时目录地址（就是之前创建的临时目录~/zkTemp）

       修改dataDir后面的值为~/zkTemp或者/home/user/zkTemp(推荐)
     

   • 配置zookeeper对外提供服务的端口（我设置为2181，注意避开机器上已被占用的端口）

       修改clientPort后面的值为2181   
     

   • 配置集群内所有服务器的ip地址和端口(具体什么意义见后面解释)

       添加这些内容
       server.1=192.168.0.101:2888:3888
       server.2=192.168.0.102:2888:3888
       server.3=192.168.0.103:2888:3888
     

3. 解释

   • 为什么要奇数台服务器做集群？

     • zookeeper默认半数以上服务器节点正常，才可以正常运行，即2x台和2x-1台效果是一样的，而后者相当于节约一台机器

   • server.X=A:B:C代表什么意思？（如server.3=192.168.0.103:2888:3888）

   官方解释：
       The entries of the form server.X list the servers that make up the ZooKeeper service.
   When the server starts up, it knows which server it is by looking for the file myid in
   the data directory. That file has the contains the server number, in ASCII.
       Finally, note the two port numbers after each server name: " 2888" and "3888". Peers 
   use the former port to connect to other peers. Such a connection is necessary so that 
   peers can communicate, for example, to agree upon the order of updates. More specifically,
   a ZooKeeper server uses this port to connect followers to the leader. 
       When a new leader arises, a follower opens a TCP connection to the leader using this 
   port. Because the default leader election also uses TCP, we currently require another 
   port for leader election. This is the second port in the server entry.
   

   通俗概括：
       X代表每个服务器节点的命名（以用来节点之间进行标识区分）
       A代表节点的IP地址
       B、C代表端口号，用于节点之间的相互连接通信（注意避免机器上已被占用的端口）
   

三、建立标识文件

- 在zkTemp临时目录中新建文件'myid'并写入标识，即server.X中的X,注意每台机器写对应的标识
    - 进入~/zkTemp
            
            $ cd ~/zkTemp
    - 新建文本文件myid,并写入标识
            
            $ vim myid //使用vim编辑器打开文件myid(若不存在会自动创建)
            点击键盘字母"i"进入编辑模式
            输入标识X
            点击键盘‘esc’退出编辑模式
            输入"：wq"进行保存并退出

四、三台机器上进行相同操作，并在部分地方改成对应机器的内容即可（ip、端口、标识等注意一下）

五、启动zookeeper并检查

• 三台机器都执行启动：

    //进入可执行目录
    $ cd ~/zookeeper-3.4.13/bin
    //启动
    $ ./zkServer.sh start
  

• 检查客户端情况：

    //在某一台机器上执行：
    $ ./zkServer.sh status
    显示using config:................和mode:follower/leader则表示该节点启动成功，
    并且是follower/leader模式（主从节点）
  

• 为什么我打开了一台机器的zookeeper状态显示未开启或者有问题？

    考虑是否是节点开启数量没有超过集群内一半