updated snapshot_history.txt
[platform/upstream/iotivity.git] / cloud / messagequeue / README
1 This project contains the Message Queue(MQ) Broker code.
2
3 Build and Run
4
5 1) Install Apache Maven if you don't have it
6
7     http://maven.apache.org
8
9 2) Install Apache Kafka ver.0.9.0.0 if you don't have it
10
11     http://kafka.apache.org/downloads.html
12
13     Set 'host.name' in Kafka server configuration file('server.properties' file in this folder)
14       to your ip address,
15     Run Zookeeper server and Kafka broker with the configuration file.
16
17 3) Build a CloudStack. If you are building first time, then build the stack.
18
19     go to "stack" folder in root directory
20     $ mvn install -Dmaven.test.skip=true
21
22 4) Build a .jar file
23
24     $ mvn install -Dmaven.test.skip=true
25
26     - The CloudMessageQueue-0.0.1-SNAPSHOT.jar file will be placed in the "target" folder
27
28 5) Run .jar file
29
30     go to "target" folder
31     $ java -jar CloudMessageQueue-0.0.1-SNAPSHOT.jar arg1(MQ CoAP Server Port) 
32       arg2(Zookeeper server address) arg3(Zookeeper server port)
33       arg4(kafka server address) arg5(kafka server port) arg6(TLS mode required)
34
35     e.g java -jar CloudMessageQueue-0.0.1-SNAPSHOT.jar 5686 127.0.0.1 2181 127.0.0.1 9092 0
36
37     - Before running a MQ Broker, you should run Zookeeper server and Kafka broker first.
38     - If you want to operate on TLS mode, "CLOUD_CERT_FILE(iotivitycloud.crt)", "CLOUD_KEY_FILE(iotivitycloud.key)"
39       and ROOT_CERT_FILE(rootca.crt) files should be placed in the "target" folder.