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

Posted 2021-02-16 无恨之都

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

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-server -detached

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

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

查看日志：

cat /opt/rabbitmq_server-3.7.5/var/log/rabbitmq/[e-mail]

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/[e-mail]
   /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：

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

rabbitmqctl status

4、安装Web管理界面插件

依次执行下列指令：

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

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

查看插件集合：rabbitmq-plugins list

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

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

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

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

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

解决：

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