上一个章节对于 RocketMQ 作了一些概念上的介绍，如果你对于 RocketMQ 没有概念，不妨先看RocketMQ系列(一) 基本介绍。

这个章节主要介绍 RocketMQ 的环境搭建与安装。

1、准备工作

1.1、环境要求

• Linux64 位系统
• JDK1.8 64位及以上

1.2、安装 JDK1.8

RocketMQ 我在这里用的是 Linux 服务器安装的，安装之前需要先装好 JDK 。

查询 JDK 可用版本：

yum -y list java*

yum 提供了查找、安装、删除某一个、一组甚至全部软件包的命令

选择安装 JDK1.8：

yum install -y java-1.8.0-openjdk.x86_64

检验安装:

java -version

2、安装 RocketMQ

2.1、下载并解压

下载地址：官网下载地址

首先在 Linux 服务器创建文件夹用于存放即将下载的 RocketMQ

mkdir usr/rocketmq
cd usr/rocketmq

文件夹创建好之后，从官网上复制想要下载的 RocketMQ 版本链接，我下载的版本是4.9.6,使用远程下载命令：

wget https://archive.apache.org/dist/rocketmq/4.9.6/rocketmq-all-4.9.6-bin-release.zip

下载完后解压：

unzip rocketmq-all-4.9.6-bin-release.zip

然后进入 rocketmq-all-4.9.6-bin-release 文件夹：

cd rocketmq-all-4.9.6-bin-release

文件夹包含了以下文件：

• bin：启动脚本，包括 shell 脚本和 CMD 脚本
• conf：实例配置文件 ，包括 broker 配置文件、logback 配置文件等
• lib：依赖 jar 包，包括Netty、commons-lang、FastJSON等

下载解压完成，那么剩下的就是怎么启动的问题了。

2.2、启动 NameServer

RocketMQ 默认的虚拟机内存较大，启动 Broker 或者 NameServer 可能会因为内存不足而导致失败，所以需要编辑这两个地方的配置文件，修改 JVM 内存大小

编辑 runserver.sh

vim bin/runserver.sh

按键盘 i 切换输入模式， 修改地方如下图：

参考 JVM 参数设置

 -server -Xms256m -Xmx256m -Xmn128m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m

按 ESC退回普通模式，输入:wq保存文件并退出 vim 编辑。

:wq

启动 NameServer

nohup sh bin/mqnamesrv &

nohup 英文全称 no hang up（不挂起），用于在系统后台不挂断地运行命令，退出终端不会影响程序的运行。

想知道启动成功与否，那就要看对应的启动日志，查看 NameServer日志：

tail -f ~/logs/rocketmqlogs/namesrv.log

如果能看到以下日志，表示启动成功：

2.3、启动 Broker

同理修改 Broker与NameServer类似，编辑 JVM 参数并启动。

编辑 runbroker.sh

vim bin/runbroker.sh

要修改的就是下图位置：

参考 JVM 参数设置

 -server -Xms256m -Xmx256m -Xmn128m

保存并退出 vim 编辑。

修改 Broker 配置文件

Broker需要向NameServer注册，所以还需要指定NameServer的地址。

因为NameServer 跟Broker 在同一台机器，所以是 localhost，NameServer 端口默认的是 9876。

编辑broker.conf

vim conf/broker.conf

在文件末尾添加以下配置：

namesrvAddr = localhost:9876
brokerIP1 = 192.168.0.17

brokerIP1记得修改成自己的服务器 IP 地址。

启动 Broker

启动时指定读取上面的配置文件：

nohup sh bin/mqbroker -c conf/broker.conf &

• -c：指定配置文件路径
• -n：NameServer 的地址

查看日志：

tail -f ~/logs/rocketmqlogs/broker.log

看到以下信息，说明已经启动成功了。

2.4、测试

启动完NameServer及Broker,可以进行简单的测试。

首先设置环境变量

export NAMESRV_ADDR=localhost:9876

发送消息

sh bin/tools.sh org.apache.rocketmq.example.quickstart.Producer

然后就是接收消息

sh bin/tools.sh org.apache.rocketmq.example.quickstart.Consumer

接收到的消息截图如下：

2.5、关闭 RocketMQ

关闭NameServer及Broker的命令如下：

# 1.关闭NameServer
sh bin/mqshutdown namesrv
# 2.关闭Broker
sh bin/mqshutdown broker

2.6、开放端口

启动完 RocketMQ后，要开放的端口一般有4个：9876，10911，10912，10909

端口说明

• 9876：Nameserver 的端口

• 10911: listenPort, 是 Broker的监听端口，是 RemotingServer 服务组件使用，作为对 Producer 和 Consumer 提供服务的端口号，默认为10911，可以通过 broker.conf 配置文件修改。

  #Broker 对外服务的监听端口
  listenPort=10911

• 10909：fastListenPort, 是 fastRemotingServer 服务组件使用，默认为 listenPort - 2，可以通过 broker.conf 配置文件修改。

  #主要用于slave同步master
  fastListenPort=10909

• 10912：haListenPort， 是HAService服务组件使用，用于Broker的主从同步，默认为listenPort + 1，可以通过配置文件修改。

  #haService中使用
  haListenPort=10912

防火墙开放端口

查看防火墙状态：

systemctl status firewalld

开放上述四个端口：

firewall-cmd --zone=public --add-port=9876/tcp --permanent
firewall-cmd --zone=public --add-port=10911/tcp --permanent
firewall-cmd --zone=public --add-port=10909/tcp --permanent
firewall-cmd --zone=public --add-port=10912/tcp --permanent

重启防火墙：

firewall-cmd --reload

查看防火墙所有开放的端口

firewall-cmd --list-port

服务器安全组开放端口

除了防火墙开放端口之外，服务器安全组也要设置上述四个端口对外开放，我用的是华为的云服务器，在安全组里添加入方向规则，规则填写上述四个端口。

3、搭建可视化控制台

前面 NameServer 和 Broker 搭建完成之后，就可以用来收发消息了，但是为了更加直观，可以搭建对应的服务控制台。

3.1、下载

下载地址：https://github.com/apache/rocketmq-dashboard/releases/tag/rocketmq-dashboard-1.0.0

Github 界面如下,点击下载压缩包或直接 clone :

3.2、修改配置文件

IDEA 打开刚解压的资源，修改配置文件：

修改 localhost 为自己的 Linux 服务器公网 IP 地址。

3.3、运行 jar 包

完善 pom.xml 下 node 资源下载：

<configuration>
    <nodeDownloadRoot>https://cdn.npmmirror.com/binaries/node/</nodeDownloadRoot>
    <nodeVersion>v16.2.0</nodeVersion>
    <yarnVersion>v1.22.10</yarnVersion>
</configuration>

删掉 frontend-maven-plugin 相关插件：

执行 maven 打包命令：

mvn clean package -Dmaven.test.skip=true

打包完成后执行 jar 包，命令如下：

java -jar target/rocketmq-dashboard-1.0.0.jar

我的 jar 包是在本地运行的，所以直接访问 localhost:8080,而如果把 jar 包部署在 Linux 服务器上的，就访问http://Linux服务器ip:8080。

访问界面如下：

3.4、Chrome topic 查询踩坑

原本我是非常信任 chrome 浏览器的，但是在使用控制台的 topic 查询时出现了组件的兼容性问题，导致无法触发查询，所以这次我要给它个差评。

chrome 踩坑版本如下：

在消息的查询页面，选择 TOPIC 选项，下拉选择主题及选择时间，然后点击搜索按钮，F12 打开调试窗口，可以发现没有办法进行接口调用。

这个坑非常的隐蔽，因为 MESSAGE KEY 和 MESSAGE ID 两种查询的搜索组件是能正常使用的，所以没有第一时间想到是组件兼容性问题。

我试过采用旧版本的 dashboard(2017版本)，也试过下调 RocketMQ 版本(4.9.6 -> 4.7.1)，又翻遍了 github 的 issue, 都没能解决这个查询问题，最后实在没办法 F12 打开调试窗口想要排查具体调用的接口，万万没想到根本就没有进行调用，顿时一阵心累。

然后我用 Edge 浏览器执行同样的 topic 查询，搜索组件能正常调用接口：

所以这里不建议用 Chrome 访问控制台了。

到这里基本的 RocketMQ 环境搭建完毕。关于如何搭配 SpringBoot 使用下个章节进行演示。

参考资料：

• https://zhuanlan.zhihu.com/p/343227137
• https://juejin.cn/post/7134227366481494046?searchId=202308141456143A780CB39001D4154695
• https://rocketmq.apache.org/zh/docs/4.x/introduction/02quickstart/
• https://blog.csdn.net/changqing5818/article/details/113973803
• https://github.com/apache/rocketmq-dashboard
• https://developer.aliyun.com/article/788183
• https://blog.csdn.net/qq_29116427/article/details/130889508