install.zh_CN

Ady Liu edited this page May 5, 2013 · 11 revisions

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

1.0版本参考 install.zh_CN.1.0

下载服务包

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

jafka-1.2.1
|-- bin
|   |-- admin-console.sh
|   |-- consumer-console.sh
|   |-- dumper.sh
|   |-- env.sh
|   |-- getoffset-console.sh
|   |-- jafka
|   |-- jafka64
|   |-- jafka.conf
|   |-- jafka.exe
|   |-- log4j.properties
|   |-- optional
|   |   |-- libwrapper-linux-x86-32.so
|   |   |-- libwrapper-linux-x86-64.so
|   |   |-- wrapper.jar
|   |   `-- wrapper-windows-x86-32.dll
|   |-- producer-console.sh
|   |-- run.sh
|   |-- server.sh
|   |-- simple-consumer-console.sh
|   `-- zookeeper-server.sh
|-- conf
|   |-- log4j.properties.in
|   |-- server.properties
|   `-- zookeeper.properties
|-- data
|-- lib
|   |-- jackson-core-asl-1.8.5.jar
|   |-- jackson-mapper-asl-1.8.5.jar
|   |-- jafka-1.2.1.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.5.jar
|-- LICENSE
|-- logs
`-- VERSION

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

运行服务

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

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

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

或者

set.JAFKA_HOME=C:\jafka-1.2.1

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.2.1</version>
</dependency>

Maven中央仓库地址: http://repo1.maven.org/maven2/com/sohu/jafka/jafka/

其它用法

客户端依赖包


源码安装

如果是源码安装,可采用下面的步骤。(适用于1.1+ 版本)

###1. 下载源代码

git clone https://adyliu@github.com/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

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.