安装前的准备
RocketMQ需要64位的JDK,请确保是64位系统并安装的是的64位JDK。本地配置好了Maven环境(非必需)。
下载文件:
下载地址:http://rocketmq.apache.org/dowloading/releases/,选择Binary文件下载:
选择推荐的镜像地址下载:
等下载完成,解压到自己想安装的目录
安装过程
设置环境变量
变量名:ROCKETMQ_HOME
变量值:D:\AppData\rocketmq-all-4.3.2-bin-release
启动NameServer
进入rocketmq的bin文件夹,按着Shift键右击鼠标打开命令窗口,然后执行:start mqnamesrv.cmd
启动完成:
注意:此时弹出的窗口不可以关闭。
启动Broker
在刚才的命令窗口继续执行:start mqbroker.cmd -n 127.0.0.1:9876 autoCreateTopicEnable=true,
启动成功:
注意:此时弹出的窗口也不可以关闭。
安装验证
运行rocketmq-console
下载官方示例项目,地址:https://github.com/apache/rocketmq-externals.git,下载完成并解压。
进入rocketmq-externals\rocketmq-console\src\main\resources文件夹,打开application.properties进行配置:
编译项目:进入\rocketmq-externals\rocketmq-console文件夹,执行mvn clean package -Dmaven.test.skip=true:
等待编译成功后,切换到target文件夹,执行:java -jar rocketmq-console-ng-1.0.0.jar
等项目启动完成:
打开浏览器输入:http://localhost:8080,如图则配置成功:
运行官方示例
通过运行官方示例中的生产者和消费者来验证安装是否正确,步骤:
1:在NameServer 和 Broker 启动后,运行set NAMESRV_ADDR=localhost:9876设置NAMESRV_ADDR:
2:启动生产者:执行命令tools.cmd org.apache.rocketmq.example.quickstart.Producer,如下生产者启动成功:
2:启动消费者:在bin目录内新打开命令窗口,执行命令tools org.apache.rocketmq.example.quickstart.Producer,如下消费者启动成功并消费消息:
至此,验证完毕,说明已经正确安装了。
退出步骤
退出RocketMQ执行的命令和启动时相反,先退出broker,再退出namesrv。
关闭broker
执行命令:mqshutdown.cmd broker
关闭namesrv
执行命令:mqshutdown.cmd namesrv
遇到的问题
启动NameServer时
1:报错
*Error occurred during initialization of VM
Could not reserve enough space for 2097152KB object heap
* 解决办法:
用文本工具打开runserver.cmd文件,修改:set “JAVA_OPT=%JAVA_OPT% -server -Xms2g -Xmx2g -Xmn1g -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m”
为:
set “JAVA_OPT=%JAVA_OPT% -server -Xms512m -Xmx512m -Xmn256m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m”
注意:这里要根据实际需要修改。
启动Broker时
1:报错
Invalid maximum direct memory size: -XX:MaxDirectMemorySize=15g
The specified size exceeds the maximum representable size.
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.
解决办法:
命令需要改为:start mqbroker.cmd -n 127.0.0.1:9876 autoCreateTopicEnable=true
用文本工具打开runbroker.cmd文件,修改:set “JAVA_OPT=%JAVA_OPT% -XX:MaxDirectMemorySize=15g”
为:
set “JAVA_OPT=%JAVA_OPT% -XX:MaxDirectMemorySize=1g”
注意:这里要根据实际需要修改。
2:报错
解决办法:
同上,修改runbroker.cmd文件:
3:报错
错误: 找不到或无法加载主类 Files
解决办法:
修改runbroker.cmd文件: