install.zh_CN.1.0

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

下载服务包

下载地址：https://github.com/downloads/adyliu/jafka/jafka-1.0.tgz 目录结构:

jafka-1.0
├── bin
│   ├── consumer-console.sh
│   ├── env.sh
│   ├── producer-console.sh
│   ├── server.sh
│   ├── simple-consumer-console.sh
│   └── zookeeper-server.sh
├── conf
│   ├── log4j.properties.in
│   ├── producer.properties
│   ├── server2.properties
│   ├── server3.properties
│   ├── server.properties
│   ├── server-single.properties
│   └── zookeeper.properties
├── data
├── lib
│   ├── hamcrest-core-1.1.jar
│   ├── jackson-core-asl-1.8.5.jar
│   ├── jackson-mapper-asl-1.8.5.jar
│   ├── jafka-1.0.jar
│   ├── jopt-simple-4.3.jar
│   ├── log4j-1.2.16.jar
│   ├── optional
│   │   └── mx4j-tools-3.0.1.jar
│   ├── zkclient-1.0.jar
│   └── zookeeper-3.3.3.jar
├── logs
└── VERSION

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

下载扩展包：https://github.com/downloads/adyliu/jafka/jafka-1.0-wrapper.tgz

扩展包是Java Service Wrapper社区版，包含以下版本：

• Linux x86
• Linux x86_64
• Windows x86
• Windows x86_64(由于社区版不提供64位版本，因此使用32位运行）

如果是其他版本的操作系统，下载完整的服务包，只需要替换下面对应版本的jafka/jafka64以及optional/*.so文件即可。

bin
├── jafka
├── jafka64
├── jafka.conf
├── jafka.exe
├── optional
│   ├── libwrapper-linux-x86-32.so
│   ├── libwrapper-linux-x86-64.so
│   ├── wrapper.jar
│   └── wrapper-windows-x86-32.dll
└── run.sh

将扩展包覆盖服务包即可。

运行服务

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

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

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

或者

set.JAFKA_HOME=C:\jafka-1.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>1.0</version>
</dependency>

其它用法

客户端依赖包

• jafka 1.0+
• zkclient 1.0+ https://github.com/adyliu/zkclient
• zookeeper 3.3.0+ 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-all.tar.gz。 安装步骤和上面下载发行版安装包相同。

---

Language: English | Simple Chinese