RabbitMq在CentOs7下的完整安装步骤，带你踩坑

时间：2021-10-22 09:29:42

1、前言

因为公司项目中用的RabbitMq来做消息处理，自己以前没有接触过，所以想自学一下。然额，光安装就花了6、7个小时才搞定，中间还换过一个版本，综合国内外博客才最终将所有安装中遇到的问题解决掉，最终将RabbitMq给运行起来，实属不易啊。说实话，学习一个新的技术，在安装软件时就受阻，对自信心和积极性的打击还是有点的，所以我把我的经历写下来，希望能对别人有帮助。另外，因为我要展示出错的过程，所以建议读者如果参照我的步骤时，先不要急于安装，先读完我的文章，再回过头来整理下安装顺序、及在安装前先安装好依赖软件，然后再进行安装，否则，我踩过的坑你很可能也会再踩。

2、安装前的准备工作

2.1 下载erlang

下载地址：http://www.erlang.org/downloads/19.3

因为RabbitMq的运行依赖erlang，所以先下载erlang（erlang是什么可自行百度）。

erlang的版本会影响到rabbitmq的安装，两者有个版本对照，查看对照的地址：http://www.rabbitmq.com/which-erlang.html

2.2 下载rabbitmq

官网地址：http://www.rabbitmq.com/

具体的安装包的3.7.5：https://github.com/rabbitmq/rabbitmq-server/releases/tag/v3.7.5

3、安装步骤

3.1 将下载的文件上传到linux虚拟机中

otp_src_19.3.tar.gz

rabbitmq-server-generic-unix-3.7.5.tar

3.2 安装erlang

tar -zxvf  otp_src_19.3.tar.gz 解压

mv otp_src_19.3 /opt/modules/  解压完成之后，移动到指定目录（不是必须的，根据习惯，比如习惯建一个目录：/opt/modules，然后把解压的移动到这个文件夹里）

[root@localhost ~]# cd /opt/modules/otp_src_19.3

[root@localhost otp_src_19.3]# ./configure --prefix=/opt/erlang  注意这里，是个巨坑，后面再说

执行上面指令时报错：

checking for perl... no_perl

configure: error: Perl is required to generate v2 to v1 mib converter script

configure: error: /bin/sh '/root/software/otp_src_17.1/lib/snmp/./configure' failed for snmp/.

configure: error: /bin/sh '/root/software/otp_src_17.1/lib/configure' failed for lib

解决方法：

安装Perl，[root@localhost otp_src_17.1]# yum install perl

重新执行指令：./configure --prefix=/opt/erlang，依然报错：

configure: error: No curses library functions found

configure: error: /bin/sh '/opt/modules/otp_src_19.3/erts/configure' failed for erts

解决方法：运行yum -y install ncurses-devel

./configure --prefix=/opt/erlang执行成功，然后运行下面安装指令：

[root@localhost otp_src_19.3] make && install

配置环境变量：

ERLANG_HOME=/opt/erlang
export PATH=$PATH:$ERLANG_HOME/bin
export ERLANG_HOME

source /etc/profile 使其生效

测试是否安装成功：

[root@localhost ~]# erl

RabbitMq在CentOs7下的完整安装步骤，带你踩坑

3.3 安装rabbitmq

[root@localhost ~]#  tar -xvf rabbitmq-server-generic-unix-3.7.5.tar

[root@localhost ~]#  mv rabbitmq_server-3.7.5 /opt/modules

配置环境变量并使其生效

RabbitMq在CentOs7下的完整安装步骤，带你踩坑

测试是否安装成功：

rabbitmq-server -detached

正常情况下，此时应该能够正常启动了，然额：

Warning: PID file not written; -detached was passed.

查看日志：

cat /opt/rabbitmq_server-3.7.5/var/log/rabbitmq/rabbit@linux1.log

19-04-13 20:34:14.431 [info] <0.31.0> Application lager started on node rabbit@linux1

2019-04-13 20:34:14.434 [info] <0.3.0> Log file opened with Lager

2019-04-13 20:34:14.625 [error] <0.3.0>

Error description:

    init:do_boot/3

    init:start_em/1

    rabbit:start_it/1 line 446

    rabbit:broker_start/0 line 320

    rabbit_plugins:prepare_plugins/1 line 289

    rabbit_plugins:ensure_dependencies/1 line 263

throw:{error,{missing_dependencies,[crypto,ssl],

                                   [amqp10_client,cowboy,cowlib,rabbitmq_aws,

                                    rabbitmq_management,

                                    rabbitmq_management_agent,rabbitmq_shovel,

                                    rabbitmq_trust_store]}}

Log file(s) (may contain more information):

   /opt/rabbitmq_server-3.7.5/var/log/rabbitmq/rabbit@linux1.log

   /opt/rabbitmq_server-3.7.5/var/log/rabbitmq/rabbit@linux1_upgrade.log

网上搜了一圈，说是openssl没有安装，于是按照网上说的步骤安装openssl， 结果都无法解决问题。

网上的方案基本上与以下方案类似：

安装openssl，重新安装erlang，并指定ssl路径为刚刚安装的openssl的安装路径：./configure --prefix=/opt/erlang --with-ssl=/usr/local/openssl   --prefix 指定编译地址   --with-ssl  ssl 地址

按照这个步骤做完之后，我的问题是，安装到最后给了个提示：

make[2]: 进入目录“/opt/modules/otp_src_19.3/erts/start_scripts”

 GEN    /opt/modules/otp_src_19.3/bin/start.script

 GEN    /opt/modules/otp_src_19.3/bin/start_sasl.script

 GEN    /opt/modules/otp_src_19.3/bin/start_clean.script

 GEN    /opt/modules/otp_src_19.3/bin/no_dot_erlang.script

make[2]: 离开目录“/opt/modules/otp_src_19.3/erts/start_scripts”

make[1]: 离开目录“/opt/modules/otp_src_19.3/erts”

install: 缺少了文件操作数

Try 'install --help' for more information.

我测试了一下erl是否支持ssl，看来是没有安装成功：

Eshell V8.3  (abort with ^G)

1> ssl:versions().

** exception error: undefined function ssl:versions/0

2>

此方案宣告失败。。。（也有可能是因为我没有运行make clean，我没有试过，但是我后面重新安装也一直没有运行make clean，最后安装成功了）

最终解决：

yum install openssl

yum install openssl-devel

/configure --prefix=/usr/local/erlang --with-ssl --enable-threads --enable-smp-support --enable-kernel-poll --enable-hipe --without-javac

make && install

按照以上步骤，神奇般地就安装成功了。

再测试erl：

RabbitMq在CentOs7下的完整安装步骤，带你踩坑

一切都正常了。启动mq(/sbin/service rabbitmq-server start)，并查看状态：

rabbitmqctl status

RabbitMq在CentOs7下的完整安装步骤，带你踩坑

4、安装Web管理界面插件

依次执行下列指令：

开启rabbitmq：[root@localhost ~]# rabbitmqctl start_app

开启管理插件：[root@localhost ~]# rabbitmq-plugins enable rabbitmq_management

查看插件集合：rabbitmq-plugins list

RabbitMq在CentOs7下的完整安装步骤，带你踩坑

如果上面都顺利，重启rabbitmq服务，则可以打开web管理界面：

RabbitMq在CentOs7下的完整安装步骤，带你踩坑

4.1 配置web远程登录用户

这里我们以创建个rabbitmq帐号，密码123456为例，创建一个账号并支持远程ip访问。

1.创建账号

  rabbitmqctl add_user rabbitmq 123456

2.设置用户角色

  rabbitmqctl  set_user_tags  rabbitmq administrator

3.设置用户权限

  rabbitmqctl set_permissions -p "/" rabbitmq ".*" ".*" ".*"

4.设置完成后可以查看当前用户和角色(需要开启服务)

  rabbitmqctl list_users

RabbitMq在CentOs7下的完整安装步骤，带你踩坑

5、用创建的用户登录web控制台

RabbitMq在CentOs7下的完整安装步骤，带你踩坑

我后面会在我别一台电脑上按这个步骤进行安装，如果发现问题再及时回来修改这篇博客，如果读者有疑问，可互相交流。

可能还会遇到Mq启动很慢、控制台刷新很慢、JAVA连接mq经常超时的问题。

解决：

在/etc/hosts中加上，本机ip   hostname，如我的：

RabbitMq在CentOs7下的完整安装步骤，带你踩坑

相关文章