RocketMQ安装部署所踩过最全的坑

时间:2024-03-28 17:34:08

我相信这篇文章应该是所有首次安装RocketMQ的人所踩过最全的坑。

写在前面

今天分享的这篇文章,可以说,绝对有用。因为我今天在安装RocketMQ时被整整搞了一个早上。太浪费时间了。而且网上关于这方面的资料太简单了。根据他们的步骤基本上都是以失败而告终的。
在此,我想说(虽然我还是IT领域的一个小白),无论你是程序员大神还是大牛。我都期待你们在写文章的时候,尤其是一些关键步骤或者技术时,请详细介绍。不要省略中间的步骤,在你看来,可能很简单。但是,你要这样想,看你的文章的人可能就是处于小白级的水平。要站在他们的角度上去考虑(可能是因为今天早上在安装遇到问题查资料时遇到了很多不好的文章,望大家谅解)。
好了,开始今天的正题。

预装环境

系统:windows
环境:JDK1.8以上、Maven、Git

在这里我们不讲RocketMQ是干嘛的。这方面网上的资料太多了。就说明一点,MQ中文含义就是“消息队列”。现在主流的MQ有ActiveMQ,RabbitMQ,Kafka,RocketMQ等。基本就这些了。
我们今天讲的是RocketMQ,它是阿里纯java语言开发的一套MQ。那我们就来看一下基于windows环境的安装步骤:

  • 第一步:下载RocketMQ,点击这里,跳转到RoccketMQ官网下载
    RocketMQ安装部署所踩过最全的坑
    这是RocketMQ的版本
    RocketMQ安装部署所踩过最全的坑
    选择自己合适的版本进行下载。
    下载你成功以后,解压到自己合适的目录(声明一下:他不是一个可执行文件,跟Tomcat一样,只需要解压,配置即可)。
    我放到D盘了。
    RocketMQ安装部署所踩过最全的坑
  • 第二步:配置环境变量 ROCKETMQ_HOME,变量值为:D:\rocketmq\rocketmq-all-4.3.1-bin-release
    RocketMQ安装部署所踩过最全的坑
  • 第三步:重启服务器

启动NAMESERVER

Cmd命令框进入至“MQ解压文件夹\bin”下面,然后执行“start mqnamesrv.cmd”,
启动NAMESERVER。成功后会弹出提示框,此框勿关闭。
RocketMQ安装部署所踩过最全的坑

启动BROKER

cmd命令框执行进入至“MQ解压文件夹\bin”下面,然后执行"start mqbroker.cmd -n 127.0.0.1:9876 autoCreateTopicEnable=true",启动BROKER。成功后会弹出提示框,此框勿关闭。
RocketMQ安装部署所踩过最全的坑
但是,这里我要强调一下,重要的话说三遍,
一定要注意!
一定要注意!
一定要注意!
好了,一般情况下,这里会出错(就是BROKER服务会启动失败),
假如弹出提示框提示‘错误: 找不到或无法加载主类 xxxxxx’,如果是这个错误,我们可能有两个解决办法
方法一:打开runbroker.cmd,然后将‘%CLASSPATH%’加上英文双引号。保存并重新执行start语句。
RocketMQ安装部署所踩过最全的坑
RocketMQ安装部署所踩过最全的坑
如果上面这一步执行完,看到BROKER服务成功启动,那就ok,如果还没有启动成功,那么,接下来我们还需要修改另一个地方。
那就是要修改我们的java 环境变量。大多数人跟我一样,在安装java的时候,都喜欢默认安装,那默认安装在哪里呢,请看下图:
RocketMQ安装部署所踩过最全的坑
默认安装路径就是这个。其注意我上图中红色的部分。
那当然,我们的java环境变量肯定是这样配置的。
RocketMQ安装部署所踩过最全的坑
那好,我现在就来说明一下这个问题。问题就出在我们的java环境的路径中有空格,事实证明,我们的路径中的确也有空格存在,那么,怎么办,就重新配置java的环境就可以了。如下:
RocketMQ安装部署所踩过最全的坑
到这一步,无法加载主类或者找不到哦这个错误基本就解决了(当然,我们RocketMQ 的安装路径最好也不要存在这样的空格)。

  • 第四步:RocketMQ插件安装
    下载地址:https://github.com/apache/rocketmq-externals.git
    RocketMQ安装部署所踩过最全的坑
    如果下载失败 把https://github.com/apache/rocketmq-externals.git 的https换成git 就ok
    这里解释一下:上面的地址是什么意思,就是需要我们提前安装git,前面说过,RocketMQ是纯java开发的。而上面就是从开元网站git上面拉取这个项目,因为我是在C盘根目录下面,所以,拉取下来也会在C盘根目录下面(项目名就是rocketmq-externals)。
    RocketMQ安装部署所踩过最全的坑
    下载完成之后,进入‘rocketmq-externals\rocketmq-console\src\main\resources’文件夹,打开‘application.properties’进行配置。
    RocketMQ安装部署所踩过最全的坑

编译启动

进入‘\rocketmq-externals\rocketmq-console’文件夹,执行‘mvn clean package -Dmaven.test.skip=true’,编译生成。
RocketMQ安装部署所踩过最全的坑
如果这一步执行失败,提示错误信息如下:

RocketMQ安装部署所踩过最全的坑
如果是这个错误,就说明mvn 这个命令他不认识,那么,肯定是我们没有配置maven 的环境变量。
maven的环境变量配置如下:
RocketMQ安装部署所踩过最全的坑
在此运行,问题就解决了。其实,我们在cmd命令框中进行编译,不一定是git中。

编译成功之后,Cmd进入‘target’文件夹,执行‘java -jar rocketmq-console-ng-1.0.0.jar’,启动‘rocketmq-console-ng-1.0.1.jar’。
RocketMQ安装部署所踩过最全的坑
我们可以看到,启动成功了。
备注一下,这里我希望大家最好进入到target目录下面去看一下,不一定是rocketmq-console-ng-1.0.1.jar版本,有时候就是rocketmq-console-ng-1.0.0.jar版本。

  • 测试
    浏览器中输入‘127.0.0.1:配置端口’,成功后即可查看(我配置的端口是8081)

RocketMQ安装部署所踩过最全的坑
这里再给大家说一下:
一般我们在浏览器地址栏中输入127.0.0.1:8081,会弹出如下界面
RocketMQ安装部署所踩过最全的坑
正常应该是一个登录界面。
那问题来了,用户名和密码是啥了,这里我告诉你,RocketMQ默认的用户名和密码是:admin
可以在这里看到:users.properties文件里面配置了用户名和密码
RocketMQ安装部署所踩过最全的坑
RocketMQ安装部署所踩过最全的坑
好了,到这里我们的RocketMQ基本的环境就都部署完成了。
希望对各位有用……