zookeeper可视化WEB工具(zkui)搭建与配置
前提:zookeeper 可视化WEB工具zkui依赖java环境,因此需要安装jdk,同时zkui源码要Maven编译,需要安装apache-maven.
JDK下载地址:https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
Apache-maven下载地址:https://maven.apache.org/download.cgi
1.设置环境变量
[root@localhost App]# vim /etc/profile 在文件末尾添加如下: #set for java export JAVA_HOME=/App/java/jdk1.8.0_102 export PATH=$JAVA_HOME/bin:$PATH export PATH=$M2_HOME/bin:$PATH export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/apr/lib #set for APR export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/apr/lib #set for apache-maven export MAVEN_HOME=/App/apache-maven export PATH=${PATH}:${MAVEN_HOME}/bin
查看环境变量:
[root@localhost App]# java -version java version "1.8.0_102" Java(TM) SE Runtime Environment (build 1.8.0_102-b14) Java HotSpot(TM) 64-Bit Server VM (build 25.102-b14, mixed mode) [root@localhost App]# mvn -v Apache Maven 3.6.0 (97c98ec64a1fdfee7767ce5ffb20918da4f719f3; 2018-10-25T02:41:47+08:00) Maven home: /App/apache-maven Java version: 1.8.0_102, vendor: Oracle Corporation, runtime: /App/java/jdk1.8.0_102/jre Default locale: en_US, platform encoding: UTF-8 OS name: "linux", version: "3.10.0-693.el7.x86_64", arch: "amd64", family: "unix"
2.下载zkui 程序包
[root@localhost /]# cd /App/ [root@localhost App]# yum -y install git [root@localhost App]# git clone https://github.com/DeemOpen/zkui.git Cloning into 'zkui'... remote: Enumerating objects: 1, done. remote: Counting objects: 100% (1/1), done. remote: Total 527 (delta 0), reused 0 (delta 0), pack-reused 526 Receiving objects: 100% (527/527), 480.75 KiB | 24.00 KiB/s, done. Resolving deltas: 100% (217/217), done. [root@localhost App]# ll zkui/ total 44 -rw-r--r--. 1 root root 2357 Apr 15 09:54 config.cfg drwxr-xr-x. 2 root root 61 Apr 15 09:54 docker drwxr-xr-x. 2 root root 114 Apr 15 09:54 images -rw-r--r--. 1 root root 11358 Apr 15 09:54 LICENSE-2.0.txt -rw-r--r--. 1 root root 416 Apr 15 09:54 Makefile -rw-r--r--. 1 root root 1746 Apr 15 09:54 nbactions.xml -rw-r--r--. 1 root root 5294 Apr 15 09:54 pom.xml -rw-r--r--. 1 root root 6216 Apr 15 09:54 README.md -rw-r--r--. 1 root root 43 Apr 15 09:54 run.sh drwxr-xr-x. 4 root root 30 Apr 15 09:54 src
3.编译zkui,生成jar包,zkui源码需要Maven编译
[root@localhost App]# cd zkui/ [root@localhost zkui]# mvn clean install .................................编译过程省略.......................................... [INFO] --- maven-install-plugin:2.4:install (default-install) @ zkui --- [INFO] Installing /App/zkui/target/zkui-2.0-SNAPSHOT.jar to /root/.m2/repository/com/deem/zkui/2.0-SNAPSHOT/zkui-2.0-SNAPSHOT.jar [INFO] Installing /App/zkui/pom.xml to /root/.m2/repository/com/deem/zkui/2.0-SNAPSHOT/zkui-2.0-SNAPSHOT.pom [INFO] Installing /App/zkui/target/zkui-2.0-SNAPSHOT-jar-with-dependencies.jar to /root/.m2/repository/com/deem/zkui/2.0-SNAPSHOT/zkui-2.0-SNAPSHOT-jar-with-dependencies.jar [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 17.670 s [INFO] Finished at: 2019-04-15T09:57:44+08:00 [INFO] ------------------------------------------------------------------------
编译成功,此时生成两个jar包,zkui-2.0-SNAPSHOT.jar和zkui-2.0-SNAPSHOT-jar-with-dependencies.jar,使用的是第二个jar包
[root@localhost zkui]# ll target/ total 8416 drwxr-xr-x. 2 root root 6 Apr 15 09:57 archive-tmp drwxr-xr-x. 5 root root 101 Apr 15 09:57 classes drwxr-xr-x. 4 root root 49 Apr 15 09:57 generated-sources drwxr-xr-x. 2 root root 28 Apr 15 09:57 maven-archiver drwxr-xr-x. 2 root root 89 Apr 15 09:57 surefire-reports drwxr-xr-x. 3 root root 17 Apr 15 09:57 test-classes -rw-r--r--. 1 root root 277170 Apr 15 09:57 zkui-2.0-SNAPSHOT.jar -rw-r--r--. 1 root root 8336864 Apr 15 09:57 zkui-2.0-SNAPSHOT-jar-with-dependencies.jar
4.修改配置文件
zkui运行生成的jar包,可以直接运行,在运行该文件之前,我们还需要修改zkui的配置文件config.cfg,config.cfg 文件中配置了zkui需要连接的zookeeper集群的IP地址和端口,访问UI的用户名和密码,以及zkui监听的端口号
[root@localhost zkui]# vim config.cfg #Server Port serverPort=9090 #Comma seperated list of all the zookeeper servers zkServer=localhost:2181,localhost:2181 #Http path of the repository. Ignore if you dont intent to upload files from repository. scmRepo=192.168.31.43:2181 #Path appended to the repo url. Ignore if you dont intent to upload files from repository. scmRepoPath=//appconfig.txt #if set to true then userSet is used for authentication, else ldap authentication is used. ldapAuth=false ldapDomain=mycompany,mydomain #ldap authentication url. Ignore if using file based authentication. ldapUrl=ldap://<ldap_host>:<ldap_port>/dc=mycom,dc=com #Specific roles for ldap authenticated users. Ignore if using file based authentication. ldapRoleSet={"users": [{ "username":"domain\\user1" , "role": "ADMIN" }]} userSet = {"users": [{ "username":"admin" , "password":"manager","role": "ADMIN" },{ "username":"appconfig" , "password":"appconfig","role": "USER" }]} #Set to prod in production and dev in local. Setting to dev will clear history each time. env=prod jdbcClass=org.h2.Driver jdbcUrl=jdbc:h2:zkui jdbcUser=root jdbcPwd=manager #If you want to use mysql db to store history then comment the h2 db section. #jdbcClass=com.mysql.jdbc.Driver #jdbcUrl=jdbc:mysql://localhost:3306/zkui #jdbcUser=root #jdbcPwd=manager loginMessage=Please login using admin/manager or appconfig/appconfig. #session timeout 5 mins/300 secs. sessionTimeout=300 #Default 5 seconds to keep short lived zk sessions. If you have large data then the read will take more than 30 seconds so increase this accordingly. #A bigger zkSessionTimeout means the connection will be held longer and resource consumption will be high. zkSessionTimeout=5 #Block PWD exposure over rest call. blockPwdOverRest=false #ignore rest of the props below if https=false. https=false keystoreFile=/home/user/keystore.jks keystorePwd=password keystoreManagerPwd=password
关于配置文件的说明:
(1)scmRepo=192.168.31.43:2181,192.168.31.44:2181,192.168.31.45:2181 注意如果是zk集群,此处需填写集群各个成员服务器(即Zookeeper节点)的IP地址加端口号2181,我这里的zookeeper 模式是standalone,因此只填写本机IP地址即可。
若报KeeperErrorCode = ConnectionLoss for / 错误,增大zkSessionTimeout超时时间,设置zkSessionTimeout=20
(2)默认用户信息
用户名:Admin(Admin权限,支持CRUD操作)
密码:manager
用户名:appconfig(Readonly权限,支持读取操作)
密码:appconfig
(3)LDAP的配置
如果你想使用 LDAP 身份验证,则提供 LDAP url。
这将优先于 roleSet property 文件认证。
ldapUrl=ldap://<ldap_host>:<ldap_port>/dc=mycom,dc=com
如果不提供此功能,则将使用默认 roleSet 文件认证。
5.启动zkui
[root@localhost zkui]# nohup java -jar target/zkui-2.0-SNAPSHOT-jar-with-dependencies.jar & [1] 2560 [root@localhost zkui]# nohup: ignoring input and appending output to ‘nohup.out’ [root@localhost zkui]# netstat -tunpl |grep :9090 tcp6 0 0 :::9090 :::* LISTEN 2560/java [root@localhost zkui]#
6.浏览器访问 http://192.168.31.43:9090/login 账号admin 密码manager
以下是个人的一些补充:
7.登录zkui ,选择导航“Host” 出现错误提示:KeeperErrorCode = NoNode for /appconfig/hosts 如下所示:
日志错误信息如下:
查询了该项目的Github https://github.com/DeemOpen/zkui/issues/61 并未找到解决方法;根据提示:根目录下无节点/appconfig/hosts,既然根目录下无/appconfig/hosts节点,那就手动创建;
[root@localhost App]# sh /App/zookeeper/bin/zkCli.sh -server 192.168.31.43:2181 Connecting to 192.168.31.43:2181 2019-04-15 11:04:27,148 [myid:] - INFO [main:Environment@100] - Client environment:zookeeper.version=3.4.14-4c25d480e66aadd371de8bd2fd8da255ac140bcf, built on 03/06/2019 16:18 GMT 2019-04-15 11:04:27,151 [myid:] - INFO [main:Environment@100] - Client environment:host.name=localhost 2019-04-15 11:04:27,151 [myid:] - INFO [main:Environment@100] - Client environment:java.version=1.8.0_102 2019-04-15 11:04:27,153 [myid:] - INFO [main:Environment@100] - Client environment:java.vendor=Oracle Corporation 2019-04-15 11:04:27,153 [myid:] - INFO [main:Environment@100] - Client environment:java.home=/App/java/jdk1.8.0_102/jre 2019-04-15 11:04:27,153 [myid:] - INFO [main:Environment@100] - Client environment:java.class.path=/App/zookeeper/bin/../zookeeper-server/target/classes:/App/zookeeper/bin/../build/classes:/App/zookeeper/bin/../zookeeper-server/target/lib/*.jar:/App/zookeeper/bin/../build/lib/*.jar:/App/zookeeper/bin/../lib/slf4j-log4j12-1.7.25.jar:/App/zookeeper/bin/../lib/slf4j-api-1.7.25.jar:/App/zookeeper/bin/../lib/netty-3.10.6.Final.jar:/App/zookeeper/bin/../lib/log4j-1.2.17.jar:/App/zookeeper/bin/../lib/jline-0.9.94.jar:/App/zookeeper/bin/../lib/audience-annotations-0.5.0.jar:/App/zookeeper/bin/../zookeeper-3.4.14.jar:/App/zookeeper/bin/../zookeeper-server/src/main/resources/lib/*.jar:/App/zookeeper/bin/../conf:.:/App/java/jdk1.8.0_102/lib/dt.jar:/App/java/jdk1.8.0_102/lib/tools.jar 2019-04-15 11:04:27,153 [myid:] - INFO [main:Environment@100] - Client environment:java.library.path=:/usr/local/apr/lib:/usr/local/apr/lib:/usr/java/packages/lib/amd64:/usr/lib64:/lib64:/lib:/usr/lib 2019-04-15 11:04:27,153 [myid:] - INFO [main:Environment@100] - Client environment:java.io.tmpdir=/tmp 2019-04-15 11:04:27,153 [myid:] - INFO [main:Environment@100] - Client environment:java.compiler=<NA> 2019-04-15 11:04:27,153 [myid:] - INFO [main:Environment@100] - Client environment:os.name=Linux 2019-04-15 11:04:27,153 [myid:] - INFO [main:Environment@100] - Client environment:os.arch=amd64 2019-04-15 11:04:27,153 [myid:] - INFO [main:Environment@100] - Client environment:os.version=3.10.0-693.el7.x86_64 2019-04-15 11:04:27,153 [myid:] - INFO [main:Environment@100] - Client environment:user.name=root 2019-04-15 11:04:27,154 [myid:] - INFO [main:Environment@100] - Client environment:user.home=/root 2019-04-15 11:04:27,154 [myid:] - INFO [main:Environment@100] - Client environment:user.dir=/App 2019-04-15 11:04:27,159 [myid:] - INFO [main:ZooKeeper@442] - Initiating client connection, connectString=192.168.31.43:2181 sessionTimeout=30000 watcher=org.apache.zookeeper.ZooKeeperMain$MyWatcher@67424e82 Welcome to ZooKeeper! JLine support is enabled 2019-04-15 11:04:27,220 [myid:] - INFO [main-SendThread(192.168.31.43:2181):ClientCnxn$SendThread@1025] - Opening socket connection to server 192.168.31.43/192.168.31.43:2181. Will not attempt to authenticate using SASL (unknown error) 2019-04-15 11:04:27,300 [myid:] - INFO [main-SendThread(192.168.31.43:2181):ClientCnxn$SendThread@879] - Socket connection established to 192.168.31.43/192.168.31.43:2181, initiating session 2019-04-15 11:04:27,314 [myid:] - INFO [main-SendThread(192.168.31.43:2181):ClientCnxn$SendThread@1299] - Session establishment complete on server 192.168.31.43/192.168.31.43:2181, sessionid = 0x1000001f2a00008, negotiated timeout = 30000 WATCHER:: WatchedEvent state:SyncConnected type:None path:null [zk: 192.168.31.43:2181(CONNECTED) 0] ls / [zookeeper] [zk: 192.168.31.43:2181(CONNECTED) 1] create /appconfig "my appconfig" Created /appconfig [zk: 192.168.31.43:2181(CONNECTED) 2] create /appconfig/hosts 192.168.31.43 Created /appconfig/hosts [zk: 192.168.31.43:2181(CONNECTED) 3] ls / [appconfig, zookeeper]
再次刷新、登录发现正常:
接下来,就体验一下通过zkui 来管理zookeeper集群吧!