[RocketMQ]安装配置单节点RocketMQ、rocketmq-console，使用Java简单生产消费

已于 2022-02-28 10:50:03 修改
阅读量1.3k 收藏 3
点赞数 3
CC 4.0 BY-SA版权
分类专栏： 服务器运维部署 实用技术相关 文章标签： java linux rocketmq
于 2021-03-31 20:23:03 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_15028305/article/details/115358752
本文详细介绍了如何在Linux环境下安装配置RocketMQ，包括Java环境的配置、RocketMQ的下载、解压、配置、启动及关闭。同时，讲解了如何安装配置maven并使用它来打包rocketmq-console，以及Java代码如何连接RocketMQ进行消息生产与消费。在过程中，还总结了可能出现的错误及解决方案，如内存不足、端口占用等问题。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

一、安装配置RocketMQ

1.1 安装配置Java环境

RocketMQ是一个纯Java的开源消息中间件，所以运行依赖Java环境。

配置java环境参考
[Linux][阿里服务器]CentOS7离线安装jdk
[Linux][阿里服务器]CentOS7联网安装jdk（yum）

1.2 安装配置RocketMQ

1.2.1 下载与解压

  1. 在/home/data/下创建rocketmq目录并进入该目录
    mkdir -p /home/data/rocketmq && cd /home/data/rocketmq

  2. 在新建的目录下下载压缩包
    wget https://mirrors.bfsu.edu.cn/apache/rocketmq/4.8.0/rocketmq-all-4.8.0-bin-release.zip
    如果找不到包，就去https://mirrors.bfsu.edu.cn/apache/rocketmq 自己看下吧，更新会删除历史的版本

  3. 解压
    unzip rocketmq-all-4.8.0-bin-release.zip

1.2.2 创建软连接与存储、日志目录

  1. 在/usr/local下创建rocketmq软链接
    cd /usr/local && ln -s /home/data/rocketmq/rocketmq-all-4.8.0-bin-release rocketmq

  2. 创建存储的路径和日志路径
    mkdir -p /usr/local/rocketmq/{store/{commitlog,consumequeue,index},logs}

1.2.3 修改配置文件与脚本配置

  1. 更改rocketmq配置文件（主启动文件，主要修改namesrvAddr和brokerIP1）
    vim /usr/local/rocketmq/conf/2m-2s-async/broker-a.properties

    修改内容：

    #所属集群名字
brokerClusterName=rocketmq-cluster
#broker 名字，注意此处不同的配置文件填写的不一样
brokerName=broker-a
#0 表示 Master， >0 表示 Slave
brokerId=0
#nameServer 地址，分号分割
namesrvAddr=124.70.143.9:9876
# 设置对外ip，这样程序才能访问此服务器下的mq
brokerIP1=124.70.143.9
#在发送消息时，自动创建服务器不存在的 topic，默认创建的队列数
defaultTopicQueueNums=4
#是否允许 Broker 自动创建 Topic，建议线下开启，线上关闭
autoCreateTopicEnable=true
#是否允许 Broker 自动创建订阅组，建议线下开启，线上关闭
autoCreateSubscriptionGroup=true
#Broker 对外服务的监听端口
listenPort=10911
#删除文件时间点，默认凌晨 4 点
deleteWhen=04
#文件保留时间，默认 48 小时
fileReservedTime=120
#commitLog 每个文件的大小默认 1G
mapedFileSizeCommitLog=1073741824
#ConsumeQueue 每个文件默认存 30W 条，根据业务情况调整
mapedFileSizeConsumeQueue=300000
#destroyMapedFileIntervalForcibly=120000
#redeleteHangedFileInterval=120000
#检测物理文件磁盘空间
diskMaxUsedSpaceRatio=88
#存储路径
storePathRootDir=/usr/local/rocketmq/store
#commitLog 存储路径
storePathCommitLog=/usr/local/rocketmq/store/commitlog
#消费队列存储路径存储路径
storePathConsumeQueue=/usr/local/rocketmq/store/consumequeue
#消息索引存储路径
storePathIndex=/usr/local/rocketmq/store/index
#checkpoint 文件存储路径
storeCheckpoint=/usr/local/rocketmq/store/checkpoint
#abort 文件存储路径
abortFile=/usr/local/rocketmq/store/abort
#限制的消息大小
maxMessageSize=65536
#flushCommitLogLeastPages=4
#flushConsumeQueueLeastPages=2
#flushCommitLogThoroughInterval=10000
#flushConsumeQueueThoroughInterval=60000
#Broker 的角色
#- ASYNC_MASTER 异步复制 Master
#- SYNC_MASTER 同步双写 Master
#- SLAVE
brokerRole=ASYNC_MASTER
#刷盘方式
#- ASYNC_FLUSH 异步刷盘
#- SYNC_FLUSH 同步刷盘
flushDiskType=ASYNC_FLUSH
#checkTransactionMessageEnable=false
#发消息线程池数量
#sendMessageThreadPoolNums=128
#拉消息线程池数量
#pullMessageThreadPoolNums=128

  2. 修改日志配置文件

    cd /usr/local/rocketmq/conf && sed -i 's#${user.home}#/usr/local/rocketmq#g' \*.xml

  3. 修改启动脚本参数

    vim /usr/local/rocketmq/bin/runbroker.sh

    vim /usr/local/rocketmq/bin/runserver.sh

    # Xms Xmx Xmn都改成1g，我的云服务器内存2g，所以我改成了512m，不然服务器内存占用太满，512m只能做测试用，实际这些内存也是不够用的
JAVA_OPT="${JAVA_OPT} -server -Xms512m -Xmx512m -Xmn128m
# JAVA_OPT="${JAVA_OPT} -server -Xms1g -Xmx1g -Xmn1g ..."

    参数解析：
    -Xms JVM初始分配的内存
    -Xmx JVM最大分配的内存，若程序使用内存达到该值，会报错OutOfMemory
    -Xmn 设置年轻代大小

1.2.4 启动MQ、查看结果

  1. 启动mq（先启动NameServer，后启动BrokerServer）

    启动NameServer
    nohup sh /usr/local/rocketmq/bin/mqnamesrv >/dev/null 2>&1 &

    启动BorkerServer
    nohup sh /usr/local/rocketmq/bin/mqbroker -c /usr/local/rocketmq/conf/2m-2s-async/broker-a.properties -n localhost:9876 autoCreateTopicEnable=true >/dev/null 2>&1 &

    参数解析
    -c 指定配置文件
    -n 指定
    autoCreateTopicEnable=true 用户（非broker）能够创建topic

  2. 查看结果（有没有 NamesStartup和BrokerStartup）

    jps

  3. 验证是否成功注册

    sh /usr/local/rocketmq/bin/mqadmin clusterList -n localhost:9876

    出现下方字符，则注册成功；查看Addr列对应的ip，是否为公网ip，若为内网ip，后续java程序无法访问
    #Cluster Name #Broker Name #BID #Addr #Version #InTPS(LOAD) #OutTPS(LOAD) #PCWait(ms) #Hour #SPACE
    rocketmq-cluster broker-a 0 124.70.143.9:10911 V4_8_0 0.00(0,0ms) 0.00(0,0ms) 0 449190.63 0.0037

  4. 关闭mq（先关broker，然后names）

    sh /usr/local/rocketmq/bin/mqshutdown broker
    sh /usr/local/rocketmq/bin/mqshutdown namesrv

二、安装配置rocketmq-console

PS：可以本地编译成jar包放上去的，不用在服务器上进行打包，(╬￣皿￣)=○

2.1 安装配置maven

rocketmq-console 需要 mvn进行 打包。

  1. 创建maven目录

    mkdir -p /home/data/maven && cd /home/data/maven

  2. 下载maven

    wget http://archive.apache.org/dist/maven/maven-3/3.6.0/binaries/apache-maven-3.6.0-bin.zip

  3. 解压

    unzip apache-maven-3.6.0-bin.zip

  4. 创建软链接

    ln -s /home/data/maven/apache-maven-3.6.0 /usr/local/maven

  5. 配置环境变量

    vim /etc/profile

    # set maven enviroment
export MAVEN_HOME=/usr/local/maven
# 注意这个PATH JAVA已经配置了，所以只需要在PATH后边加上 :$MAVEN_HOME/bin即可，而且注意MAVEN_HOME要在PATH引用之前
export PATH=$MAVEN_HOME/bin:$PATH

  6. 更新文件并执行（使配置生效）

    source /etc/profile

  7. 查看结果

    mvn -v

2.2 安装配置rocketmq-console

  1. 下载rocketmq-console

    地址：https://gitee.com/ralph81/rocketmq-console/repository/archive/master.zip

  2. 创建目录上传压缩包

    mkdir -p /home/data/rocketmq-console && cd /home/data/rocketmq-console && rz

  3. 解压

    unzip ralph81-rocketmq-console-master.zip

  4. 修改配置文件

    cd rocketmq-console && vim ./src/main/resources/application.properties

    
# 注释这个，不然会报错-端口占用
# server.address=124.70.143.9
# 修改访问上下文
server.contextPath=/rocketmq
# 修改访问端口号，默认8080 这个端口太常见了
server.port=8099

# name server地址
rocketmq.config.namesrvAddr=124.70.143.9:9876

    保存并退出

  5. mvn命令打包

    mvn clean package -Dmaven.test.skip=true

  6. 运行java包

    java -jar target/rocketmq-console-ng-2.0.0.jar

  7. 验证

    浏览器登录http://124.70.143.9:8099/rocketmq

    PS：账号密码在src/main/resources/users.properties中配置，管理员是admin/admin。

三、Java代码生产消费RocketMQ

使用java代码连接RocketMQ，发布消费主题内容；
我使用的SpringBoot，所以通过实现ApplicationRunner，使程序启动时运行方法

pom.xml

<!-- rocketmq 因为我的服务器部署的是4.8.0的RocketMQ-client -->
<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-client</artifactId>
    <version>4.8.0</version>
</dependency>

RocketMQProducer.java

import org.apache.rocketmq.client.producer.DefaultMQProducer;
import org.apache.rocketmq.client.producer.SendResult;
import org.apache.rocketmq.common.message.Message;
import org.apache.rocketmq.remoting.common.RemotingHelper;
import org.springframework.boot.ApplicationArguments;
import org.springframework.boot.ApplicationRunner;
import org.springframework.core.annotation.Order;
import org.springframework.stereotype.Component;

/**
 * @author shuli
 * @create 2021-03-30 13:03
 * @description 生产者生产消息，topic是TopicTest，tags是TagA，key没设置，message是Hello RocketMQ i
 **/

@Component
@Order(1)
public class RocketMQProducer implements ApplicationRunner {

    @Override
    public void run(ApplicationArguments args) throws Exception {
        try{
            DefaultMQProducer producer = new DefaultMQProducer("groupProducer");
            producer.setNamesrvAddr("124.70.143.9:9876");//MQ服务器地址
            producer.setVipChannelEnabled(false);
            producer.start();
            for (int i = 0; i < 2; i++) {
                Message msg = new Message("TopicTest", "TagA" , ("Hello RocketMQ " + i).getBytes(RemotingHelper.DEFAULT_CHARSET));
                SendResult sendResult = producer.send(msg);
                System.out.printf("%s%n", sendResult);
                System.out.println("--");
            }
            // 关闭生产者
            producer.shutdown();
        }catch (Exception e){
            e.printStackTrace();
        }
    }
}

RocketMQConsumer.java

package com.caosli.alltest.connectRocketMQ;

import org.apache.rocketmq.client.consumer.DefaultMQPushConsumer;
import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyContext;
import org.apache.rocketmq.client.consumer.listener.ConsumeConcurrentlyStatus;
import org.apache.rocketmq.client.consumer.listener.MessageListenerConcurrently;
import org.apache.rocketmq.common.message.MessageExt;
import org.springframework.boot.ApplicationArguments;
import org.springframework.boot.ApplicationRunner;
import org.springframework.core.annotation.Order;
import org.springframework.stereotype.Component;

import java.util.List;

/**
 * @author shuli
 * @create 2021-03-31 13:13
 * @description 消费者消费数据
 **/

@Component
@Order(2)
public class RokcetMQCunsumer implements ApplicationRunner {
    @Override
    public void run(ApplicationArguments args) throws Exception {
        DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("FirstConsumerGroup");
        consumer.setNamesrvAddr("124.70.143.9:9876");

        consumer.setInstanceName("Consumber");
        // 订阅，可以订阅多个主题，多写几个
        // 订阅多个标签TagA、TagB、TagC：consumer.subscribe("TopicTest","TagA || TagB || TagC");
        // 订阅所有标签：consumer.subscribe("TopicTest","*");
        consumer.subscribe("TopicTest","TagA");

        consumer.registerMessageListener((List<MessageExt> list, ConsumeConcurrentlyContext consumeConcurrentlyContext)->{
            System.out.println(Thread.currentThread().getName()+ " Receive New Messages: " + list.size());
            MessageExt msg = list.get(0);
            if("TopicTest".equals(msg.getTopic())){
                if("TagA".equals(msg.getTags())){
                    System.out.println(new String(msg.getBody()));
                }
            }
            return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
        });
        // 启动consumer
        consumer.start();
        // 暂时不关闭，消费者可以持续消费数据；后续可以通过rocketmq-console发布消息，测试消费者接收
//        consumer.shutdown();
    }
}

四、过程中出现的错误总结

4.1 报错：内存不足

Java HotSpot(TM) 64-Bit Server VM warning: INFO: os::commit_memory(0x00000000c0000000, 268435456, 0) failed; error='Cannot allocate memory' (errno=12)

原因在nameserver和brokerserver中设置的堆内存参数过大，改为512m

4.2 报错：No route info of this topic

org.apache.rocketmq.client.exception.MQClientException: No route info of this topic

原因pom.xml的rocketmq-client（4.3.0）和服务器上（4.8.0）版本不一致，修改pom.xml为 4.8.0

4.3 报错：sendDefaultImpl call timeout

org.apache.rocketmq.remoting.exception.RemotingTooMuchRequestException: sendDefaultImpl call timeout

解决 修改启动命令中的ip为localhost，配置文件中的地址为公网地址。原因不清

第二天又出现这问题了

诊断结果是内存分配太少(以前设置的太少了，512还行)，导致OOM，发布消息出现问题。解决办法：关闭rocketmq，然后再启动。

4.4 报错：端口占用

Identify and stop the process that's listening on port 8099 or configure this application to listen on another port.

注释掉 application.properties 中的 server.address

RocketMQ最佳实践（四）可视化管理控制台rocketmq-console-ng
jayjjb的专栏
05-24 6万+
RocketMQ有一个对其扩展的开源项目incubator-rocketmq-externals，这个项目中有一个子模块叫“rocketmq-console”，这个便是管理控制台项目了。 先将incubator-rocketmq-externals拉到本地，因为我们需要自己对rocketmq-console进行编译打包运行。 通过命令行进入到rocketmq-console子目
20241130 RocketMQ本机安装与SpringBoot整合
m0_74824517的博客
02-08 1195
NameServer 是一个非常简单的 Topic 路由注册中心，其角色类似 Dubbo 中的zookeeper，支持 Broker 的动态注册与发现。**Consumer：**消息消费的角色，支持分布式集群方式部署。**Producer：**消息发布的角色，支持分布式集群方式部署。rocketmq.config.namesrvAddr= ，这个是指定 nameServer 地址和端口，我们暂时先搞成localhost:9876，等后面搞集群的话，要再修改；Broker的路由的信息。
rocketMQ学习笔记二：RocketMQ-Console安装、使用详解
热门推荐
麦田里的码农
05-12 10万+
一、rocketmq-console介绍   RocketMQ-Console是RocketMQ项目的扩展插件，是一个图形化管理控制台，提供Broker集群状态查看，Topic管理，Producer、Consumer状态展示，消息查询等常用功能，这个功能在安装好RocketMQ后需要额外单独安装、运行。 二、rocketmq-console下载、部署   进入rocketmq-externals项...
RocketMQ代理的8080端口修改
最新发布
enjoy.day
05-20 318
修改proxy端口
使用rocketmq-console管理RocketMQ
asoklove的专栏
05-13 4544
环境：RocketMQ4.8.0 + rocketmq-console2.0.0 简介 rocketmq-console是RocketMQ项目的扩展插件，是一个图形化管理控制台，提供Broker集群状态查看，Topic管理，Producer、Consumer状态展示，消息查询等常用功能，这个功能在安装好RocketMQ后需要额外单独安装、运行。 下载并安装 通过如下地址下载 修改相关配置 进入src\main\resources修改application.properties文件，修改端口.
windows 设置 rocketmq环境变量_跟我学RocketMQ[1-2]之安装RocketMQ-Console管理平台
weixin_39664995的博客
10-21 465
博客地址:朝·闻·道​www.wuwenliang.net上文中我们初步了解了RocketMQ的基础结构，并在linux环境下部署了单节点模式的消息服务。官方提供了命令行模式下的管理工具，脚本路径位于：[安装路径]/bin/mqadmin支持对topic、订阅组、broker等的统计及管理。对于开发者，我们更愿意使用图形化的可视界面来进行管理，这种方式对于运维也是极为友好的。官方早已给我们考虑到了...
RocketMQ单节点搭建
woaiwojialanxi的专栏
03-02 969
RocketMQ服务搭建　　 下载RocketMQ源码 ：Apache Download Mirrors 解压 ：rocketmq-all-4.9.2-bin-release.zip unziprocketmq-all-4.9.2-bin-release.zip 如果没有 unzip 命令 安装 yum install unzip 修改 bin/runserver.sh 因为RocketMQ JAVA_OPT 设置的默认参数较大，需要根据实际情况修改 JAVA_O...
rocketmq-console后台管理jar包
10-26
RocketMQ Console提供了一个友好的图形用户界面，用户可以通过它来查看和管理RocketMQ的主题、队列、消费者和生产者等。主要功能包括发布和订阅主题、查看消息轨迹、监控消费者状态以及进行性能调优等。 2. **应用...
rocketmq-all-5.2.0-bin-release.7z
03-07
6. 强大的管理工具：RocketMQ提供了Web Console，方便用户监控、管理消息队列，进行主题创建、消费者管理等操作。 7. 丰富的API支持：RocketMQ提供了Java、Python、Go等多种语言的SDK，便于开发者集成到各种系统中...
linux、windows环境下 RocketMQ 安装配置
tian830937的专栏
04-02 1603
RocketMQ默认的内存配置较高，可以按照以下的配置方式，对内存、namesrv、broker等进行配置(生产环境下，内存配置不用修改，使用默认配置即可，本地测试环境根据内存情况配置)下载需要的版本的二进制安装包，本文档以RocketMQ4.9.5版本为例（rocketmq-all-4.9.5-bin-release.zip）在安装RocketMQ前，需要在目标服务器上安装jdk1.8，并配置java环境变量，可参考以下示例。RocketMQ启动时，应按照顺序先启动namesrv，再启动broker。
rocketmq安装部署
05-19
在Linux环境下进行RocketMQ的安装部署是一项重要的系统管理工作，本文将详细介绍如何在Linux系统上完成RocketMQ的4.8.0版本的安装和配置。 首先，我们需要了解RocketMQ的基本架构。RocketMQ主要包括NameServer、...
rocketmq-console
08-03
想要设置为免费的，谁知道不能设置，注意将包用压缩工具打开，修改BOOT-INF中的application.properties中的rocketmq.config.namesrvAddr为自己的rocketMQ的地址。
rocketmq-console RocketMQ 控制台
12-27
rocketMq控制台jar包内含脚本启动脚本。
rocketmq-console-ng-2.0.0.jar
01-19
rocketmq-console的源码打出来的jar包，可直接运行，默认端口为8080，如果要指定端口，将jar包里面的application.properties拿出来放在当前路径即可，如果配置文件没有填写Name Server的话，可以在启动项目时指定namesrvAddr $ java -jar target/rocketmq-console-ng-2.0.0.jar --rocketmq.config.namesrvAddr='localhost:9876'
Centos下RocketMQ单节点安装
u014010342的博客
01-11 654
环境：Centos7.2 8G 4核 ;JDK1.8 ;Maven:3.6.0 ;RocketMQ:4.3.2 1、java安装 jdk-8u191-linux-x64.tar.gz 2、maven安装 apache-maven-3.6.0-bin.tar.gz [root@RocketMQmaster ~]# mkdir /usr/local/mvn [root@RocketMQmaste...
springboot rocketmq rocketmq-console
BusyMonkey
08-19 702
1、部署rocketmq namesrv、broker a、rocketmq下载地址：http://rocketmq.apache.org/release_notes/release-notes-4.2.0/ b、配置JAVA_HOME、ROCKETMQ_HOME c、cmd下运行mqnamesrv d、再开cmd下运行mqbroker -n 127.0.0.1:9876 或者直接运行p...
安装rocketmq单节点
sly1311220942的博客
10-27 469
安装rocketmq 下载 去官网下载 设置环境变量 export rocketmq=/root/rocketmq export PATH=PATH:PATH:PATH:rocketmq/bin export NAMESRV_ADDR=127.0.0.1:9876 启动nameserver nohup bin/mqnamesrv > /root/rocketmq/logs/mqnamesrv.log 2>&1 & 启动broker nohup bin/mqbroker -n lo
搭建单节点rocketmq
08-02
要搭建单节点的RocketMQ，你可以按照以下步骤进行操作： 1. 首先，你需要下载RocketMQ的源码包。你可以从Apache官网的下载源码...以上是搭建单节点RocketMQ的基本步骤。你可以根据需要进行相应的配置和调整。[1][2]
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值