install.zh_CN - adyliu/jafka GitHub Wiki

#安装指南文档>>安装指南

下载服务包

下载地址：https://github.com/adyliu/jafka/releases

目录结构:

jafka-3.0.6
├── LICENSE
├── VERSION
├── bin
│   ├── admin-console.sh
│   ├── consumer-console.sh
│   ├── dumper.sh
│   ├── env.sh
│   ├── getoffset-console.sh
│   ├── jafka-linux-x86-32
│   ├── jafka-linux-x86-64
│   ├── jafka-macosx-universal-32
│   ├── jafka-macosx-universal-64
│   ├── jafka-windows-x86-32.exe
│   ├── jafka.conf
│   ├── optional
│   │   ├── libwrapper-linux-x86-32.so
│   │   ├── libwrapper-linux-x86-64.so
│   │   ├── libwrapper-macosx-universal-32.jnilib
│   │   ├── libwrapper-macosx-universal-64.jnilib
│   │   ├── wrapper-windows-x86-32.dll
│   │   └── wrapper.jar
│   ├── producer-console.sh
│   ├── run.sh
│   ├── server.sh
│   ├── simple-consumer-console.sh
│   └── zookeeper-server.sh
├── conf
│   ├── log4j.properties.sample
│   ├── server.properties.sample
│   └── zookeeper.properties
├── lib
│   ├── jackson-annotations-2.9.0.jar
│   ├── jackson-core-2.9.8.jar
│   ├── jackson-databind-2.9.8.jar
│   ├── jafka-3.0.6.jar
│   ├── jopt-simple-5.0.4.jar
│   ├── log4j-3.6.07.jar
│   ├── netty-all-4.1.36.Final.jar
│   ├── optional
│   │   └── mx4j-tools-3.0.1.jar
│   ├── slf4j-api-1.7.26.jar
│   ├── slf4j-log4j12-1.7.26.jar
│   ├── zkclient-2.1.2.jar
│   └── zookeeper-3.4.9.jar
└── logs

其中 bin 目录存放启动脚本，conf 目录存放配置文件，data 目录存放数据，lib 目录存放依赖库，logs 目录存放日志，VERSION 文件存放版本信息。

运行服务

扩展包中只包含了以下 Linux/Windows 两种平台，其它平台可以参考Java Service Wrapper,基本类似。

在运行之前，建议将 jafka.conf 中得 JAFKA_HOME 环境变量修改位绝对路径，减少不必要的麻烦。例如：

set.JAFKA_HOME=/opt/apps/jafka-3.6.0

或者

set.JAFKA_HOME=C:\jafka-3.6.0

Linux x86_64

[adyliu@adyliu-pc bin]$ ./run.sh
Usage: ./run.sh [ console | start | stop | restart | condrestart | status | install | remove | dump ]

Commands:
  console      Launch in the current console.
  start        Start in the background as a daemon process.
  stop         Stop if running as a daemon or in another console.
  restart      Stop if running and then start.
  condrestart  Restart only if already running.
  status       Query the current status.
  install      Install to start automatically when system boots.
  remove       Uninstall.
  dump         Request a Java thread dump if running.

以命令行方式运行只需要在任何目录下执行下面命令即可

./run.sh console

以后台服务方式运行，只需要执行

./run.sh start

随时都可以查看服务状态，包括没有运行或者运行异常

./run.sh status

停止正在运行的服务

./run.sh stop

Linux x86_32

32 位的 Linux 需要将 run.sh 中的

#WRAPPER_CMD="./jafka"
WRAPPER_CMD="./jafka64"

替换成

WRAPPER_CMD="./jafka"
#WRAPPER_CMD="./jafka64"

即可。也就是想执行得命令换成 32 位的二进制。

运行命令和 Linux x86_64 相同。

Windows x86_32/x86_64

Windows 直接双击 jafka.exe 即可以命令行方式运行。

完整帮助

jafka -?

安装成服务：

jafka -i jafka.conf

运行服务：

jafka -t

停止服务：

jafka -p

客户端依赖

Maven 依赖

<dependency>
  <groupId>com.sohu.jafka</groupId>
  <artifactId>jafka</artifactId>
  <version>3.6.0</version>
</dependency>

Maven 中央仓库地址: https://repo1.maven.org/maven2/io/jafka/jafka/

其它用法

客户端依赖包

jafka 1.2+
zkclient 1.0+ https://github.com/adyliu/zkclient
zookeeper 3.3.5+ http://zookeeper.apache.org
log4j 1.2+ http://logging.apache.org/log4j/
jackson 1.8.0+ http://jackson.codehaus.org/
mx4j-tools 3.0.1+ [Optional]

源码安装

如果是源码安装，可采用下面的步骤。（适用于 1.1+ 版本）

###1. 下载源代码

git clone https://[email protected]/adyliu/jafka.git

或者

wget -O jafka.zip https://github.com/adyliu/jafka/zipball/master
unzip jafka.zip

###2. 编译

mvn clean package assembly:single -Dmaven.test.skip=true

或者运行下单元测试

mvn clean package assembly:single

###3. 安装

现在在 target/目录下就得到了打包好的安装包 jafka-1.x.x.tgz。安装步骤和上面下载发行版安装包相同。

Language: English | Simple Chinese