Chinaunix首页 | 论坛 | 博客
  • 博客访问: 8077421
  • 博文数量: 594
  • 博客积分: 13065
  • 博客等级: 上将
  • 技术积分: 10324
  • 用 户 组: 普通用户
  • 注册时间: 2008-03-26 16:44
个人简介

推荐: blog.csdn.net/aquester https://github.com/eyjian https://www.cnblogs.com/aquester http://blog.chinaunix.net/uid/20682147.html

文章分类

全部博文(594)

分类: HADOOP

2014-04-22 11:49:33

ZooKeeper-3.4.6分布式安装指南.pdf

目录


1. 前言

介绍ZooKeeper-3.4.6版本的分布式安装,力求细致,提供精确的安装指导。本文的安装环境是64位的SuSE 10.1 Linux,也适用于ZooKeeper-3.4.8

ZooKeeper节点间不需要互登录,因此不用配置免密码登录。

2. 约定

将ZooKeeper安装在/data/hadoop/zookeeper目录,其中/data/hadoop/zookeeper是指向/data/hadoop/zookeeper-3.4.6的软链接。

ZooKeeper的数据目录设置为/data/hadoop/zookeeper/data


本文使用了3台机器部署ZooKeeper集群,IP和主机名对应关系如下:

IP

主机名

10.12.154.77

DEVNET-154-77

10.12.154.78

DEVNET-154-70

10.12.154.79

DEVNET-154-79

3. 安装步骤

Zookeeper机器间不需要设置免密码登录,其它hadoop也可以不设置,只要不使用hadoop-daemons.sh来启动、停止进程,注意不是hadoop-daemon.sh,而是带“s”的那个,带“s”的会读取hadoopsalves文件,远程ssh启动DataNode和备NameNode等。

3.1. 配置/etc/hosts

将3台机器的IP和主机名映射关系,在3台机器上都配置一下,亦即在3台机器的/etc/hosts文件中,均增加以下内容(可以先配置好一台,然后通过scp等命令复制到其它机器上,注意主机名不能包含任何下划线):

10.12.154.77    DEVNET-154-77

10.12.154.78    DEVNET-154-70

10.12.154.79    DEVNET-154-79

3.2. 设置myid

在dataDir指定的数据目录(/data/hadoop/zookeeper/data)下,创建文件myid,文件内容为一个正整数值,用来唯一标识当前机器,因此不同机器的数值不能相同,建议从1开始递增标识,以方便记忆和管理。本文约定如下:

IP

标识数值(取值范围为1~255

10.12.154.77

1

10.12.154.78

2

10.12.154.79

3


可以使用echo命令直接写进去,如:

echo 1 > myidecho 1 > /data/hadoop/zookeeper/data/myid

3.3. 修改conf/zoo.cfg

按下述内容,修改ZooKeeper配置文件(3台机器都需要,可以先配置好一台,然后通过scp等命令复制到其它机器上):

tickTime=2000

dataDir=/data/hadoop/zookeeper/data

dataLogDir=/data/hadoop/zookeeper/datalog

clientPort=2181

initLimit=5

syncLimit=2

autopurge.snapRetainCount=10

autopurge.purgeInterval=1

server.1=DEVNET-154-77:2888:3888

server.2=DEVNET-154-78:2888:3888

server.3=DEVNET-154-79:2888:3888


server.N中的N值必须和myid保持相同。

以上内容的配置,参照了ZooKeeper的官方文档:server.X用来配置ZooKeeper集群中的各节点,并建议X的值和myid保持一致。

端口2181用于监听客户端的连接,端口2888用于Leader监听Follower的连接,而3888则用于Leader选举。

dataDir用来指定快照文件存放目录,dataLogDir用来指定事务日志文件存放目录。如果只指定了dataDir,而没指定dataLogDir,则事务日志文件也存放于dataDir指定的目录。

默认,autopurge的两个参数是被注释的。

“autopurge.purgeInterval”指定自动清理快照文件和事务日志文件的时间,单位为小时,默认为0表示不自动清理,这个时候可以使用脚本zkCleanup.sh手动清理。不清理的结果是占用的磁盘空间越来越大。

“autopurge.snapRetainCount”用于指定保留快照文件和事务日志文件的个数,默认为3

3.4. 修改/bin/zkEnv.sh

设置环境变量ZOO_LOG_DIRzookeeper的日志存放目录,如:

export ZOO_LOG_DIR=/data/hadoop/zookeeper/log

可将这一行放在ZOOKEEPER_PREFIX之后。


再修改下ZOO_LOG4J_PROP,以让日志不是输出到zookeeper.out,而是写入到日志文件,将:ZOO_LOG4J_PROP="INFO,CONSOLE",改成:

ZOO_LOG4J_PROP="INFO,ROLLINGFILE"

3.5. 修改conf/log4j.properties

log4j.appender.ROLLINGFILE.MaxFileSize=100MB

log4j.appender.ROLLINGFILE.MaxBackupIndex=10

设置每个日志文件大小为100M,滚动10个。

3.6. 修改conf/java.env

打开文件bin/zkEnv.sh,可以看到它有引用conf/java.env。可以在java.env中设置JAVA_HOME这个环境变量,如:export JAVA_HOME=/data/jdk

仅在/etc/profile等处设置JAVA_HOME,可能并不管用。如果不管用,查看log/zookeeper.out,可以看到错误“nohup: failed to run command 'java': No such file or directory”。

3.7. 设置PATH

这步不是必须的,但是推荐将zookeeper/bin加入到环境变量PATH,这样操作zookeeper会方便些,如:export PATH=/data/zookeeper/bin:$PATH

如果计划设置,修改当前用户的.profile.bashrc即可,而不是/etc/profile等。

4. 启动ZooKeeper集群

登录所有ZooKeeper节点,使用bin目录下的脚本zkServer.sh用来启动ZooKeeper集群,但需要带一个start参数,如:

cd /data/hadoop/zookeeper/bin&&./zkServer.sh start


停止参数为stop,重启参数为restart,如:./zkServer.sh restart

由于启动时,每个节点都会试图去连接其它节点,因此先启动的刚开始会连接不上其它的,导致日志中会包含错误信息,在未全启动之前,这个属正常现象。

5. 安装验证

脚本zkServer.sh不但可以用来启动ZooKeeper,还可以用来查看状态。使用方式为带一个status参数,如:

./zkServer.sh status


如遇到以下错误,请稍安勿躁,过会再试,可能是因为还未完全起来:

[hadoop@DEVNET-154-77 ~/zookeeper/bin]$ ./zkServer.sh status

JMX enabled by default

Using config: /data/hadoop/zookeeper/bin/../conf/zoo.cfg

Error contacting service. It is probably not running.


集群成功启动后,将有且只会有一个成为leader,其它是follower

[hadoop@DEVNET-154-79 ~/zookeeper/bin]$ ./zkServer.sh status

JMX enabled by default

Using config: /data/hadoop/zookeeper/bin/../conf/zoo.cfg

Mode: leader

 

[hadoop@DEVNET-154-70 ~/zookeeper/bin]$ ./zkServer.sh status

JMX enabled by default

Using config: /data/hadoop/zookeeper/bin/../conf/zoo.cfg

Mode: follower

 

[hadoop@DEVNET-154-77 ~/zookeeper/bin]$ ./zkServer.sh status

JMX enabled by default

Using config: /data/hadoop/zookeeper/bin/../conf/zoo.cfg

Mode: follower

6. 基本命令

进入ZooKeeperbin目录,执行zkCli.sh进入ZooKeeper的命令行操作界面。

./zkCli.sh -server 10.12.154.78:2181


参数“-server”中只含一个“-”,用以指定被连接的ZooKeeper节点,可以为Leader,也可以为Follower,“10.12.154.78”为LeaderFollowerIP或主机名,“2181”为ZooKeerp提供的客户端服务端口。


进入ZooKeeper命令行操作界面后,输入help然后回车,可以看到ZooKeeper支持的命令列表:

[zk: DEVNET-154-79:2181(CONNECTED) 0] help

ZooKeeper -server host:port cmd args

        stat path [watch]

        set path data [version]

        ls path [watch]

        delquota [-n|-b] path

        ls2 path [watch]

        setAcl path acl

        setquota -n|-b val path

        history 

        redo cmdno

        printwatches on|off

        delete path [version]

        sync path

        listquota path

        rmr path

        get path [watch]

        create [-s] [-e] path data acl

        addauth scheme auth

        quit 

        getAcl path

        close 

        connect host:port


ls”有点像HDFS中的“ls”,随便测试下:

[zk: DEVNET-154-79:2181(CONNECTED) 1] ls /

[zookeeper, hbase]


再测试下:

[zk: DEVNET-154-79:2181(CONNECTED) 2] ls /hbase

[replication, meta-region-server, rs, splitWAL, backup-masters, table-lock, region-in-transition, online-snapshot, master, running, recovering-regions, draining, namespace, hbaseid, table]


再测试一下:

[zk: DEVNET-154-79:2181(CONNECTED) 4] ls /hbase/backup-masters

[VM-40-171-sles10-64,60000,1398162436871]


测试创建一个目录:

[zk: DEVNET-154-79:2181(CONNECTED) 2] create /test test

Created /test

 

[zk: DEVNET-154-79:2181(CONNECTED) 2] ls /

[zookeeper, test]


上面可以看到有HBase,是因为基于它部署了一套HBase,若未基于它安装HBase,则不会有这个条目。

7. 只启一台zookeeper会如何?

如果只启动一台,执行zkServer.sh status查看状态时,报如下错误:

$ zkServer.sh status

ZooKeeper JMX enabled by default

Using config: /data/zookeeper/bin/../conf/zoo.cfg

Error contacting service. It is probably not running.


如果再启一台zookeeper,会发现一个成了leader,另一个成了follower(经测试两台zookeeper即能正常工作):

$ zkServer.sh status

ZooKeeper JMX enabled by default

Using config: /data/zookeeper/bin/../conf/zoo.cfg

Mode: follower

 

$ zkServer.sh status

ZooKeeper JMX enabled by default

Using config: /data/zookeeper/bin/../conf/zoo.cfg

Mode: leader

8. 如何扩容zookeeper

只需要将已有的zookeeper打包复制到新的机器上,然后修改myid文件并设置好,然后启动zookeeper即可。

9. 四字命令

用户在客户端可以通过telnetncZooKeeper提交相应的命令。ZooKeeper常用见下表:

命令

说明

conf

输出相关服务配置的详细信息

cons

列出所有连接到服务器的客户端的完全的连接、会话的详细信息,包括接受、发送的包数量、会话ID、操作延迟、最后的操作执行等等信息

dump

列出未经处理的会话和临时节点

envi

输出关于服务环境的详细信息

reqs

列出未经处理的请求

ruok

测试服务是否处于正确状态。如果确实如此,那么服务返回“imok”,否则不做任何相应

stat

输出关于性能和连接的客户端的列表

wchs

列出服务器watch的详细信息

wchc

通过session列出服务器 watch 的详细信息,它的输出是一个与watch相关的会话的列表

wchp

通过路径列出服务器 watch 的详细信息,它输出一个与 session 相关的路径


使用示例:

$ echo ruok|nc 127.0.0.1 2181

$ telnet 127.0.0.1 2181  

Trying 127.0.0.1...

Connected to 127.0.0.1.

Escape character is '^]'.

stat

Zookeeper version: 3.4.8--1, built on 02/06/2016 03:18 GMT

Clients:

  /127.0.0.1:34711[0](queued=0,recved=1,sent=0)

  /10.43.36.23:43303[1](queued=0,recved=225666,sent=225666)

 

Latency min/avg/max: 0/0/19

Received: 313930

Sent: 313929

Connections: 2

Outstanding: 0

Zxid: 0x60000cfe4

Mode: follower

Node count: 183

Connection closed by foreign host.

10. 相关文档

HBase-0.98.0分布式安装指南》

Hive 0.12.0安装指南》

ZooKeeper-3.4.6分布式安装指南》

Hadoop 2.3.0源码反向工程》

《在Linux上编译Hadoop-2.4.0

Accumulo-1.5.1安装指南》

Drill 1.0.0安装指南》

Shark 0.9.1安装指南》


更多,敬请关注技术博客:http://aquester.cublog.cn

11. 结束语

至此,ZooKeeper分布式安装大告成功!更多细节,请浏览官方文档:


阅读(10681) | 评论(2) | 转发(2) |
给主人留下些什么吧!~~

Aquester2016-03-25 15:55:33

ZOO_EXPIRED_SESSION_STATE=-112
ZOO_AUTH_FAILED_STATE=-113
ZOO_CONNECTING_STATE=1
ZOO_ASSOCIATING_STATE=2
ZOO_CONNECTED_STATE=3

Aquester2016-03-25 15:53:36

ZOO_SESSION_EVENT=-1
ZOO_CREATED_EVENT=1
ZOO_CHANGED_EVENT=3
ZOO_CHILD_EVENT=4
ZOO_SESSION_EVENT=-1
ZOO_NOTWATCHING_EVENT=-2