版本資訊
Windows
- OS : Windows 10 x64
- RocketMQ : 4.2.0
- JDK : 1.8.0_131
- Maven : 3.5.0
Linux
- OS : Ubuntu 16.04LTS x64
- RocketMQ : 4.2.0
- JDK : 1.8.0_151
- Maven : 3.5.2
安裝步驟
Windows
- 若下載原始碼,使用Maven進行編譯
- 配置環境變數(值為RocketMQ的安裝路徑)
ROCKETMQ_HOME=D:\RocketMQ
- 修改runbroker.cmd第40行,新增雙引號
將set "JAVA_OPT=%JAVA_OPT% -cp %CLASSPATH%"
改為set "JAVA_OPT=%JAVA_OPT% -cp "%CLASSPATH%""
Linux
-
若下載原始碼,使用Maven進行編譯
-
配置環境變數(值為RocketMQ的安裝路徑)
export ROCKETMQ_HOME=/usr/local/rocketmq/
export PATH=$ROCKETMQ_HOME/bin:$PATH
-
修改預設配置。由於RocketMQ預設配置要求很高,比如記憶體至少就要4個G,開發除錯環境根本吃不消,所以我們開始啟動前需要先修改這些引數。否則的話,我們很有會遇到記憶體分配或者不夠的問題。
(1). 修改target/apache-rocketmq-all/bin/runserver.sh
JAVA_OPT="${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m -XX:PermSize=128m -XX:MaxPermSize=320m"
(2). 修改target/apache-rocketmq-all/bin/runbroker.sh
JAVA_OPT="${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m
(3). 修改target/apache-rocketmq-all/bin/tools.sh
JAVA_OPT="${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m -XX:PermSize=128m -XX:MaxPermSize=128m"
啟動步驟
- 啟動Name Server。在bin目錄下執行:
nohup sh mqnamesrv & tail -f ~/logs/rocketmqlogs/namesrv.log
- 啟動Broker。在bin目錄下執行:
nohup sh mqbroker -n localhost:9876 & tail -f ~/logs/rocketmqlogs/broker.log
這裡-n後面跟的是Name Server的地址。 - 若要對Broker進行配置。在bin目錄下執行:
sh mqbroker -m > broker1.properties
然後可以對生成的.properties檔案進行修改。 - 根據配置啟動:
sh mqbroker -c broker1.properties
- 關閉Broker:
sh mqshutdown broker
(通用)
sh mqadmin wipeWritePerm -b brokerName -n namerverAddr
(可選)
常見錯誤
- 啟動Name Server的時候報:
Please set the ROCKETMQ_HOME variable in your environment!
配置一下ROCKETMQ_HOME的環境變數。 - 啟動Broker的時候報找不到主類JDK,修改runbroker.cmd第40行
set "JAVA_OPT=%JAVA_OPT% -cp "%CLASSPATH%""
原來的%CLASSPATH%少了雙引號。 - 啟動Producer報錯
org.apache.rocketmq.remoting.exception.RemotingConnectException: connect to <172.17.0.1:10909> failed
多種原因:
- 檢查IP地址,經檢查對應伺服器安裝有其他網橋,將其解除安裝即可
- 在Producer中將VIP通道關閉:
producer.setVipChannelEnabled(false);
- 啟動Producer報錯
org.apache.rocketmq.client.exception.MQClientException: No route info of this topic, TopicTest2
-
Broker沒有正確連線到Name Server 或
-
Producer沒有正確連線到Name Server 或
-
Broker禁止自動建立Topic,且使用者沒有通過手工方式建立Topic
預設配置啟動broker時
autoCreateTopicEnable=true
已設定,所以檢查連線即可