Edit

ZooKeeper

Service overview

Software owner	Apache Software Foundation
System requirements	https://zookeeper.apache.org/doc/r3.1.2/zookeeperAdmin.html#sc_systemReq
Management	wfmanager (start | stop | restart | status) zookeeper
Log files	Access logs: <INSTALL_DIR>/supervisord/log/zookeeper.out.log Error logs: <INSTALL_DIR>/supervisord/log/zookeeper.err.log
Startup scripts	<INSTALL_DIR>/supervisord/apps/zookeeper.ini <INSTALL_DIR>/zookeeper/bin/zkServer.sh
Configuration files	Service directory: <INSTALL_DIR>/zookeeper/ General zookeeper configuration: <INSTALL_DIR>/zookeeper/zoo.cfg
Default Ports	tcp 2181

Default parameters

Configuration file	Name	Default value	Description
config.yml	install_dir	/opt/workfusion	Directory to put user files, logs and configs
config.yml	zookeeper_port	2181	Default service port for installation

Troubleshooting

• Check if TCP port 2181 is available.

  netstat command output

  $ netstat -lntp | grep 2181
  tcp6       0      0 :::2181                 :::*                    LISTEN      23870/java 
  

  ss command output

  $ ss -ltn | egrep 2181
  LISTEN     0      50          :::2181                    :::*
  

  lsof command output

  $ lsof -P -n -i :2181 | grep LISTEN
  java      23870 wfuser   23u  IPv6 118055      0t0  TCP *:2181 (LISTEN)
  

• Check the default main log files.

  • Access logs: <INSTALL_DIR>/supervisord/log/zookeeper.out.log
  • Error logs: <INSTALL_DIR>/supervisord/log/zookeeper.err.log

  $ tail -f <INSTALL_DIR>/supervisord/log/zookeeper.err.log <INSTALL_DIR>/supervisord/log/zookeeper.out.log
  

• Check ZooKeeper out (access) log using the Wfmanager util.

wfmanager tail zookeeper

• Enable more detailed debug information.

  Set the appropriate log level to <INSTALL_DIR>/zookeeper/conf/log4j.properties (default is DEBUG) and restart the ZooKeeper service:

  ${install_dir}/zookeeper/conf/log4j.properties

  zookeeper.log.threshold=TRACE
  

  wfmanager restart zookeeper