前期准备:
官方地址:https://github.com/apache/rocketmq-mqtt
RocketMQ从4.9.3 版本开始才支持该功能,所以需要先检查 RocketMQ 的版本是否满足。
RocketMQ 部署参考:https://rocketmq.apache.org/zh/docs/4.x/deployment/01deploy
操作系统和jdk环境:
64-bit operating system, Linux/Unix/macOS recommended
64-bit JDK 1.8+
需要在rocketMQ的配置文件中broker.conf中添加下面的命令以开启mqtt支持
enableLmq = true
enableMultiDispatch = true
下面是跟着官网教程走的流程:
git clone https://github.com/apache/rocketmq-mqtt
cd rocketmq-mqtt
mvn -Prelease-all -DskipTests clean install -U
cd distribution/target/
maven编译完成之后找到rocketmq-mqtt\distribution\target\rocketmq-mqtt-1.0.2-SNAPSHOT\rocketmq-mqtt-1.0.2-SNAPSHOT\conf\下的service.conf文件编辑里面的配置
sername=test // Authorization verification account configuration
secretKey=test // Authorization verification account configuration
NAMESRV_ADDR=xxx //namesrv access point
eventNotifyRetryTopic=eventNotifyRetryTopic //notify retry topic, created in advance
clientRetryTopic=clientRetryTopic //Client message retry topic, created in advance
testTopic=testTopic //Client message retry topic, created in advance
metaAddr=192.168.157.129:25000
然后编辑相同目录下面的meta.conf,这个配置文件内容如下
selfAddress=192.168.157.129:25000
membersAddress=192.168.157.129:25000
然后需要提前配置好一级topic如下:
sh mqadmin updateTopic -n 10.22.34.179:9876 -c DefaultCluster -t eventNotifyRetryTopic
sh mqadmin updateTopic -n 10.22.34.179:9876 -c DefaultCluster -t clientRetryTopic
sh mqadmin updateTopic -n 10.22.34.179:9876 -c DefaultCluster -t testTopic
初始化元数据:
配置网关:
mqadmin updateKvConfig -s LMQ -k LMQ_CONNECT_NODES -v 10.22.34.179 -n 10.22.34.179:9876
配置一级 Topic:
mqadmin updateKvConfig -s LMQ -k ALL_FIRST_TOPICS -v eventNotifyRetryTopic,clientRetryTopic,testTopic -n 10.22.34.179:9876
配置每个一级 Topic 的通配符:
mqadmin updateKvConfig -s LMQ -k eventNotifyRetryTopic -v testTopic/# -n 10.22.34.179:9876
mqadmin updateKvConfig -s LMQ -k clientRetryTopic -v testTopic/# -n 10.22.34.179:9876
mqadmin updateKvConfig -s LMQ -k testTopic -v testTopic/# -n 10.22.34.179:9876
下面给出java 11版本 mqtt 中mqtt.sh报错的bug:只需要改下配置文件即可,文件位置位于\rocketmq-mqtt\distribution\target\rocketmq-mqtt-1.0.2-SNAPSHOT\rocketmq-mqtt-1.0.2-SNAPSHOT\bin,runserver.sh配置文件,文件内容如下:
#!/bin/sh
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#===========================================================================================
# Java Environment Setting
#===========================================================================================
error_exit ()
{
echo "ERROR: $1 !!"
exit 1
}
find_java_home()
{
case "`uname`" in
Darwin)
if [ -n "$JAVA_HOME" ]; then
JAVA_HOME=$JAVA_HOME
return
fi
JAVA_HOME=$(/usr/libexec/java_home)
;;
*)
JAVA_HOME=$(dirname $(dirname $(readlink -f $(which javac))))
;;
esac
}
find_java_home
[ ! -e "$JAVA_HOME/bin/java" ] && JAVA_HOME=$HOME/jdk/java
[ ! -e "$JAVA_HOME/bin/java" ] && JAVA_HOME=/usr/java
[ ! -e "$JAVA_HOME/bin/java" ] && error_exit "Please set the JAVA_HOME variable in your environment, We need java(x64)!"
export JAVA_HOME
export JAVA="$JAVA_HOME/bin/java"
export BASE_DIR=$(dirname $0)/..
export CLASSPATH=.:${BASE_DIR}/conf:${BASE_DIR}/lib/*:${CLASSPATH}
#===========================================================================================
# JVM Configuration
#===========================================================================================
# The RAMDisk initializing size in MB on Darwin OS for gc-log
DIR_SIZE_IN_MB=600
choose_gc_log_directory()
{
case "`uname`" in
Darwin)
if [ ! -d "/Volumes/RAMDisk" ]; then
# create ram disk on Darwin systems as gc-log directory
DEV=`hdiutil attach -nomount ram://$((2 * 1024 * DIR_SIZE_IN_MB))` > /dev/null
diskutil eraseVolume HFS+ RAMDisk ${DEV} > /dev/null
echo "Create RAMDisk /Volumes/RAMDisk for gc logging on Darwin OS."
fi
GC_LOG_DIR="/Volumes/RAMDisk"
;;
*)
# check if /dev/shm exists on other systems
if [ -d "/dev/shm" ]; then
GC_LOG_DIR="/dev/shm"
else
GC_LOG_DIR=${BASE_DIR}
fi
;;
esac
}
choose_gc_options()
{
# Example of JAVA_MAJOR_VERSION value : '1', '9', '10', '11', ...
# '1' means releases befor Java 9
JAVA_MAJOR_VERSION=$("$JAVA" -version 2>&1 | sed -r -n 's/.* version "([0-9]*).*$/\1/p')
if [ -z "$JAVA_MAJOR_VERSION" ] || [ "$JAVA_MAJOR_VERSION" -lt "9" ] ; then
JAVA_OPT="${JAVA_OPT} -server -Xms2g -Xmx2g -Xmn2g -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"
JAVA_OPT="${JAVA_OPT} -XX:+UseConcMarkSweepGC -XX:+UseCMSCompactAtFullCollection -XX:CMSInitiatingOccupancyFraction=70 -XX:+CMSParallelRemarkEnabled -XX:SoftRefLRUPolicyMSPerMB=0 -XX:+CMSClassUnloadingEnabled -XX:SurvivorRatio=8 -XX:-UseParNewGC"
JAVA_OPT="${JAVA_OPT} -verbose:gc -Xloggc:${GC_LOG_DIR}/rmq_srv_gc_%p_%t.log -XX:+PrintGCDetails -XX:+PrintGCDateStamps"
JAVA_OPT="${JAVA_OPT} -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=5 -XX:GCLogFileSize=30m"
else
JAVA_OPT="${JAVA_OPT} -server -Xms2g -Xmx2g -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"
JAVA_OPT="${JAVA_OPT} -XX:+UseG1GC -XX:G1HeapRegionSize=16m -XX:G1ReservePercent=25 -XX:InitiatingHeapOccupancyPercent=30 -XX:SoftRefLRUPolicyMSPerMB=0"
JAVA_OPT="${JAVA_OPT} -Xlog:gc*:file=${GC_LOG_DIR}/rmq_srv_gc_%p_%t.log:time,tags:filecount=5,filesize=30M"
fi
}
choose_gc_log_directory
choose_gc_options
JAVA_OPT="${JAVA_OPT} -XX:-OmitStackTraceInFastThrow"
JAVA_OPT="${JAVA_OPT} -XX:-UseLargePages"
#JAVA_OPT="${JAVA_OPT} -Xdebug -Xrunjdwp:transport=dt_socket,address=9555,server=y,suspend=n"
JAVA_OPT="${JAVA_OPT} ${JAVA_OPT_EXT}"
JAVA_OPT="${JAVA_OPT} -cp ${CLASSPATH}"
"$JAVA" ${JAVA_OPT} $@
启动 RocketMQ MQTT:
cd bin
sh meta.sh start
sh mqtt.sh start
可能出现这种情况
meta.sh: 55: Syntax error: "(" unexpected
原因 sh里面的函数function startup() {
去掉function