本文采用多master+slave+nameservers的集群配置方式。
一、前提
1. 安装好JDK。JDK版本为1.6+ 64bit
2. 将alibaba-rocketmq-3.2.2.tar.gz上传到linux服务器。（现放到/opt/目录下）
rocketmq下载地址：https://github.com/alibaba/RocketMQ/releases
rocketmq github: https://github.com/alibaba/RocketMQ
1.赋权和解压源文件
>cd /opt/
>chmod
755
alibaba-rocketmq-
3.2
.
2
.tar.gz
>tar -zxvf ./alibaba-rocketmq-
3.2
.
2
.tar.gz
|
2.增加系统环境变量ROCKETMQ_HOME：
>
vi
/etc/profile
|
添加：
ROCKETMQ_HOME=/opt/alibaba-rocketmq
export ROCKETMQ_HOME
|
3.使配置立即生效：
>
source
/etc/profile
##可以将$ROCKETMQ_HOME/bin加入到$PATH中，这样可以直接使用roketmq的bin目录程序
|
4.增加系统启动后自动启动：
>
vi
/etc/rc
##(以下为启动nameserver节点和启动broker节点，视生产环境添加启动规则)
##启动nameserver节点
##/opt/alibaba-rocketmq/local/start_nameserver.sh
##启动broker节点
##/opt/alibaba-rocketmq/local/start_broker.sh
|
二、Rocketmq配置
1.默认没有local目录，在$ROCKETMQ_HOME下新一个local目录用于创建启动nameserver和broker节点管理。
>
mkdir
$ROCKETMQ_HOME
/local
;
cd
$ROCKETMQ_HOME
/local
>
touch
start_nameserver.sh
#!/bin/sh
#ROCKETMQ_HOME最好重新指定，以免出错
#JAVA_HOME重新指定，用于使用不同的jdk
ROCKETMQ_HOME=
/opt/alibaba-rocketmq
export
ROCKETMQ_HOME
#mqnamesrv > ${console日志输出} 2>&1 &
#可以使用mqnamesrc -p >namesrc.p取到默认配置文件，后续使用
#./mqnamesrv -c namesrv.p加载配置（这样可以修改namesrv的端口号，注意所有配置文#件格式为utf8最好。windows shell >出来的有问题）
nohup
$ROCKETMQ_HOME
/bin/mqnamesrv
-c $ROCKETMQ_HOME
/bin/namesrv
.properties >$ROCKETMQ_HOME
/log/mqnamesrv
.log 2>&1 &
|
>
touch
start_borker.sh
#!/bin/sh
#ROCKETMQ_HOME最好重新指定，以免出错
#JAVA_HOME重新指定，用于使用不同的jdk
ROCKETMQ_HOME=
/opt/alibaba-rocketmq
export
ROCKETMQ_HOME
#mqbroker [-n ${nameserver地址}] -c ${broker的配置文件} > ${console日志输出} 2>&1 &
nohup
$ROCKETMQ_HOME
/bin/mqbroker
-c $ROCKETMQ_HOME
/bin/broker
.properties >$ROCKETMQ_HOME
/log/mqbroker
.log 2>&1 &
|
>
touch
stop_nameserver.sh
#!/bin/sh
#注释为杀进程方式关闭服务
#ps -ef |grep '../bin/mqnamesrv' |awk '{if($8!="'grep'") {print $2;exit}}' |while read pid
# do
# kill $pid
# done
$ROCKETMQ_HOME
/bin/mqshutdown
namesrv
|
>
touch
stop_borker.sh
#!/bin/sh
$ROCKETMQ_HOME
/bin/mqshutdown
broker
|
注意ROCKETMQ_HOME地址、nameserver地址更改、broker的配置文件地址
2.修改namesrv和broker的配置：
修改namesrv配置：
>
cd
$$ROCKETMQ_HOME
/bin
>.
/mqnamesrv
-p > namesrv.properties
#可以通过./namesrv.properties修改namesrv的端口号
#启动时按./mqnamesrv -c ./namesrv.properties 启动加载配置
|
修改borker配置：
>
cd
$ROCKETMQ_HOME
/bin
>broker -m broker.properties
# (当没有时可以使用此命令创建；此文件其实是.properties的文件。可以按.properties规则修改文件内容)
|
cat broker.p显示以下内容：
namesrvAddr=192.168.45.214:9876
brokerIP1=192.168.45.214
brokerName=ROCKETMQAH
brokerClusterName=DefaultCluster
brokerId=0
autoCreateTopicEnable=
true
autoCreateSubscriptionGroup=
true
rejectTransactionMessage=
false
fetchNamesrvAddrByAddressServer=
false
storePathRootDir=
/opt/alibaba-rocketmq/store
storePathCommitLog=
/opt/alibaba-rocketmq/store/commitlog
storePathConsumeQueue=
/opt/alibaba-rocketmq/consumequeue
storePathIndex=
/opt/alibaba-rocketmq/index
storeCheckpoint=
/opt/alibaba-rocketmq/checkpoint
abortFile=
/opt/alibaba-rocketmq/abort
flushIntervalCommitLog=1000
flushCommitLogTimed=
false
deleteWhen=04
fileReservedTime=72
maxTransferBytesOnMessageInMemory=262144
maxTransferCountOnMessageInMemory=32
maxTransferBytesOnMessageInDisk=65536
maxTransferCountOnMessageInDisk=8
accessMessageInMemoryMaxRatio=40
messageIndexEnable=
true
messageIndexSafe=
true
haMasterAddress=
brokerRole=ASYNC_MASTER
flushDiskType=SYNC_FLUSH
cleanFileForciblyEnable=
false
|
说明：
1.namesrvAddr的地址，可以使用broker -n xxx.xxx.xxx.xxx方式指定。
2.listenPort=10911（默认为10911）可以指定broker的服务开放地址。
3.几个文件保存的地方需要重新指定，默认保存到use_dir下
4.brokerName表示集群master组名称，同一个master+slave共用相同的brokerName。
5.brokerClusterName 建议配置为同一个名称。
6.brokerId为0时表示的master;大于0时表示slave;
7.brokerRole 有ASYNC_MASTER异步master；SYNC_MASTER表示同步master；SLAVE表示slave
8:flushDiskType表示producer到broker的处理方式：SYNC_FLUSH表示同步到文件后返回成功；ASYNC_FLUSH表示broker接收到后立即返回生产者成功，后续再同步到文件中
9:cleanFileForciblyEnable 表示磁盘满后处理方式：true表示满后删除接收的文件。False表示立即停止服务。
broke.p的详细配置可以参考《RocketMQ Developer Guide.pdf》中的broker使用指南 的说明。
3.修改日志配置：
1.进行入$ROCKETMQ_HOME/conf目录下，将logback_*.xml 的所有xml文件的${user.home}改为${ ROCKETMQ_HOME}。
三、集群配置要修改说明
一、nameserver集群配置说明：
多个nameserver的配置：
在另一台主机启动一个./start_nameserver.sh 这个不用修改
修改所有的borker的启动方式(配置了一个改为两个nameserver情况)，vi ./start_borker.sh 改 -n 192.168.45.214:9876 为-n ‘192.168.45.214:9876;192.168.56.46:9876’
所有的客户端程序（即producer，consumer） xxxx..setNamesrvAddr("192.168.45.214:9876;192.168.56.46:9876");
二、borker节点结群说明：
1.查看并修改nameserver节点配置
完成（一、前提）的情况下，修改$ROCKETMQ_HOME/local 下的start_nameserver.sh 的$ROCKETMQ_HOME内容。
>
cd
$$ROCKETMQ_HOME
/local
>
vi
start_nameserver.sh
#修改$ROCKETMQ_HOME，修改为当前的rocketmq地址，如果没有变化不用做修改
|
管理nameserver节点：启动./start_nameserver.sh 停止./stop_nameserver.sh
2.查看并修改broker_master节点配置：
修改broker.p文件（broker.p使用附件中的broker.p内容为基础）：
修改brokerIP1 为本机IP；
brokerName 为定义的master组名称；
brokerId 填0；
brokerRole 选择MASTER相关选项；
flushDiskType值选择borker回复方式；
启用./start_broker.sh 停止./stop_broker.sh
3.修改和配置broker_slave节点：
1.完成前提的情况下，修改$ROCKETMQ_HOME/local 下的start_broker.sh 的$ROCKETMQ_HOME内容和${nameserver地址}；。
2.修改broker.p文件（broker.p使用附件中的broker.p内容为基础）：
修改brokerIP1 为本机IP,
brokerName 为定义的master组名称
brokerId 填大于0
brokerRole 选择SLAVE
flushDiskType值选择borker回复方式
启用./start_broker.sh 停止./stop_broker.sh
四、客户端开发
Producer，consumer在初始化时配置参考《RocketMQ Developer Guide.pdf》中的客户端 API 形式。
注意consumer返回时:
ConsumeConcurrentlyStatus.CONSUME_SUCCESS;--表示消费成功
ConsumeConcurrentlyStatus.RECONSUME_LATER;--表示处理失败，并后面请broker过一定时间后再次下发。
consumer.setMessageModel(MessageModel.BROADCASTING);--表示广播消费，也就是每个master都要撸一次。默认是MessageModel.CLUSTERING 这个《RocketMQ Developer Guide.pdf》写错了，表集群处理模式，一个请求只被一个master节点处理一次，要以自个测试结果为准。后续最好看下源码。
五、监控程序rocketmq_console和集群验证
监控为一个外置war文件，下载地址为：
https://github.com/rocketmq/rocketmq-console.git
使用MAVEN进行编译（附件中有编好的war包）
下载后，需修改：src/main/resources/config.properties：
Rocketmq.namesrv.addr内容，指向nameserver地址
集群配置完成后，使用rockertmq_console访问和验证：
分别启动一个consumer和producer 处理空业务，并查看rocketmq_console的 http://localhost:8080/rocketmq-console/cluster/list.do 显示情况
以下为只有一个master+slave；多个master组合时，会出现多个这样的表格内容。
1.查看http://localhost:8080/rocketmq-console/cluster/list.do节点情况（主要查看是否以master+slave为组的，一组一组的列表显示；注意#Broker_name是否为borker.p配置的地址和端口号（目前rocketmq在配置失效后，会使用默认的配置，所以需要查下是否配置正确））
六、问题说明
本文档采用的是，多nameserver+master+slave(一个master只有一个slave，没有必要多个slave)。
1.master停掉后不切到slave进行处理。
首先slave只处理consumer的内容，即只负责发内容到consumer。当master停止后，这个master+slave的组合并不能再接收producer的任务。只能将自个没有处理完成的处理掉。这时producter的任务会分配给其它master节点进行处理。
2.$ROCKETMQ_HOME/bin下面的exe不能执行：
bin里面的exe程序，是用64位编译的，exe程序不支持32位的系统；jdk也最好是64位的。
4.为什么broker broker.p 地址不能生效
window shell 执行mqbroker -m > broker.p生成的文件编码有问题。java后面解析不出来。生成的配置文件最好为utf-8文件。
5.后面遇到再说明：
七、附件
RocketMQ Developer Guide.pdf
rocketmq_ext.zip (local目录文件和配置文件及conf修改)
rocketmq-console.war console客户端
八、参考文档
《RocketMQ Developer Guide.pdf》