RabbitMQ安装与初始配置

目录

• Erlang安装
• RabbitMQ安装
• 启动/关闭/状态查看
• 访问端口
  • 参考
• 用户权限管理
  • 用户管理
  • 权限管理
  • 参考
• System Limits
  • 参考
• 日志

本文只讨论linux下的Rabbitmq安装。

Erlang安装

rabbitmq依赖于Erlang，需先安装，推荐安装rabbitmq/erlang-rpm：

#clone源码
git clone https://github.com/rabbitmq/erlang-rpm.git
#make
cd erlang-rpm
make  #需要等待较长时间
cd RPMS/x86_64  #其下有两个rpm包 erlang-19.3.6-1.alios6.x86_64.rpm  erlang-debuginfo-19.3.6-1.alios6.x86_64.rpm, 选择前者安装
#安装
sudo rpm -ivh  erlang-19.3.6-1.alios6.x86_64.rpm

RabbitMQ安装

在官网下载页面找到和系统版本对应的rabbitmq版本：

#安装rabbitmq-server
sudo yum install rabbitmq-server-3.6.10-1.el6.noarch.rpm
#此时可能报：Requires: socat, 以下是解决方法, 参考：http://www.cnblogs.com/ray30th/p/6651800.html
sudo wget --no-cache http://www.convirture.com/repos/definitions/rhel/6.x/convirt.repo -O /etc/yum.repos.d/convirt.repo
sudo yum makecache
sudo yum install socat
#重新安装rabbitmq-server
sudo yum install rabbitmq-server-3.6.10-1.el6.noarch.rpm

启动/关闭/状态查看

#启动/停止 start/stop
$sudo /sbin/service rabbitmq-server start
Starting rabbitmq-server: SUCCESS
rabbitmq-server.

$sudo /sbin/service rabbitmq-server stop
Stopping rabbitmq-server: rabbitmq-server.

#状态查看
sudo rabbitmqctl status

其中状态查看会返回详细的状态信息：

[{pid,2022},
 {running_applications,
     [{rabbit,"RabbitMQ","3.6.10"},
      {os_mon,"CPO  CXC 138 46","2.4.2"},
      {rabbit_common,
          "Modules shared by rabbitmq-server and rabbitmq-erlang-client",
          "3.6.10"},
      {ranch,"Socket acceptor pool for TCP protocols.","1.3.0"},
      {ssl,"Erlang/OTP SSL application","8.1.3"},
      {public_key,"Public key infrastructure","1.4"},
      {crypto,"CRYPTO","3.7.4"},
      {compiler,"ERTS  CXC 138 10","7.0.4"},
      {asn1,"The Erlang ASN1 compiler version 4.0.4","4.0.4"},
      {xmerl,"XML parser","1.3.14"},
      {syntax_tools,"Syntax tools","2.1.1"},
      {mnesia,"MNESIA  CXC 138 12","4.14.3"},
      {sasl,"SASL  CXC 138 11","3.0.3"},
      {stdlib,"ERTS  CXC 138 10","3.3"},
      {kernel,"ERTS  CXC 138 10","5.2"}]},
 {os,{unix,linux}},
 {erlang_version,
     "Erlang/OTP 19 [erts-8.3.5] [source] [64-bit] [smp:2:2] [async-threads:64] [hipe] [kernel-poll:true]
"},
 {memory,
     [{total,53336792},
      {connection_readers,0},
      {connection_writers,0},
      {connection_channels,0},
      {connection_other,0},
      {queue_procs,2832},
      {queue_slave_procs,0},
      {plugins,0},
      {other_proc,20729016},
      {mnesia,60688},
      {metrics,184080},
      {mgmt_db,0},
      {msg_index,42608},
      {other_ets,2138344},
      {binary,116568},
      {code,21389077},
      {atom,891849},
      {other_system,7962978}]},
 {alarms,[]},
 {listeners,[{clustering,25672,"::"},{amqp,5672,"0.0.0.0"}]},
 {vm_memory_high_watermark,0.4},
 {vm_memory_limit,1660447948},
 {disk_free_limit,50000000},
 {disk_free,94489919488},
 {file_descriptors,
     [{total_limit,65435},
      {total_used,2},
      {sockets_limit,58889},
      {sockets_used,0}]},
 {processes,[{limit,1048576},{used,152}]},
 {run_queue,0},
 {uptime,15},
 {kernel,{net_ticktime,60}}]

访问端口

SELinux和与其机制类似的系统可能会阻止RabbtMQ绑定相应端口，所以安装完之后需要确保一下端口可以打开：

• 4369，epmd（Erlang Port Mapper Daemon），是Erlang的端口/结点名称映射程序，用来跟踪节点名称监听地址，在集群中起到一个类似DNS的作用。
• 5672, 5671， AMQP 0-9-1 和 1.0 客户端端口，used by AMQP 0-9-1 and 1.0 clients without and with TLS(Transport Layer Security)
• 25672，Erlang distribution，和4369配合
• 15672，HTTP_API端口，管理员用户才能访问，用于管理RbbitMQ，需要启用management插件，rabbitmq-plugins enable rabbitmq_management，访问http://server-name:15672/
• 61613, 61614，当STOMP插件启用的时候打开，作为STOMP客户端端口（根据是否使用TLS选择）
• 1883, 8883，当MQTT插件启用的时候打开，作为MQTT客户端端口（根据是否使用TLS选择）
• 15674，基于WebSocket的STOMP客户端端口（当插件Web STOMP启用的时候打开）
• 15675，基于WebSocket的MQTT客户端端口（当插件Web MQTT启用的时候打开）

参考

Installing on RPM-based Linux(Port Access)
RabbitMQ~开篇与环境部署

用户权限管理

RabbitMQ有一个默认的用户"guest"，密码也是"guest"，这个用户默认只能通过本机访问，eg:http://localhost:15672/，在通过http访问之前记得启用management插件：

$rabbitmq-plugins enable rabbitmq_management

要让其他机器可以访问，需要创建一个新用户，为其分配权限。用户权限可以通过rabbitmqctl执行相关命令来维护，rabbitmqctl是管理rabbitmq的命令行管理工具，下面介绍相关的命令：

用户管理

• list_users，用户列表
• add_user {username} {password}，添加用户
• delete_user {username}，删除用户
• change_password {username} {newpassword}，修改密码
• clear_password {username}，删除密码，密码删除后就不能访问了。This user now cannot log in with a password (but may be able to through e.g. SASL EXTERNAL if configured)
• authenticate_user {username} {password}，用户认证
• set_user_tags {username} {tag ...}，为用户设置角色，tag可以是0个、一个、或多个，eg：rabbitmqctl set_user_tags chris administrator，设置为管理员；rabbitmqctl set_user_tags chris，清除chris与角色的关联。

#用户列表查看
$sudo rabbitmqctl list_users
Listing users
guest	[administrator]
#添加用户
$sudo rabbitmqctl add_user chris 123
Creating user "chris"
#为用户分配权限
$sudo rabbitmqctl set_user_tags chris administrator
Setting tags for user "chris" to [administrator]
#然后就可以通过http://host:15672 登录management界面管理rabbitmq了，但此时用户chris还没有访问队列资源的权限

权限管理

RabbitMQ客户端连接到一个服务端的时候，在它的操作指令中指定了一个虚拟主机。服务端首先检查是否有访问该虚拟主机的权限，没有权限的会拒绝连接。

对于exchanges和queues等资源，位于某个虚拟主机内；不同虚拟主机内即便名称相同也代表不同的资源。当特定操作在资源上执行时第二级访问控制开始生效。

RabbitMQ在某个资源上区分了配置、写和读操作。配置操作创建或者销毁资源，或者更改资源的行为。写操作将消息注入进资源之中。读操作从资源中获取消息。

要执行特定操作用户必须授予合适的权限。

下面介绍相关命令：

• list_vhosts [vhostinfoitem ...]，获取vhosts列表
• add_vhost {vhost}， eg：rabbitmqctl add_vhost test
• delete_vhost {vhost}
• set_permissions [-p vhost] {user} {conf} {write} {read}，给用户分在对应的vhost上分配相应的权限。eg：rabbitmqctl set_permissions -p /myvhost chris "^chris-.*" ".*" ".*"，这条指令，给用户chris在myvhost分配了权限，权限包括：以"chris-"开头的全部资源的配置权限，和所有资源的读写权限
• clear_permissions [-p vhost] {username}，清除权限
• list_permissions [-p vhost]，vhost权限分配列表
• list_user_permissions {username}，user权限列表

$sudo rabbitmqctl set_permissions -p / chris ".*" ".*" ".*"
Setting permissions for user "chris" in vhost "/"
#此时用户chris才有访问队列资源的权限

参考

rabbitmqctl(1) manual page（User management, Access control）

System Limits

rabbitmq会维持大量的网络连接，所以系统允许同时打开的最大文件数需要调整。推荐的允许同时打开的最大文件数为65535。有两个地方需要设置：

• 系统每个用户允许的最大同时打开文件数，ulimit -n，可以通过ulimit -n size设置
• 系统允许的最大同时打开文件数，fs.file-max

系统级限制查看与设置：

#查看
$ cat /proc/sys/fs/file-max
184289
$ cat /proc/sys/fs/file-nr
1024    0    184289     
#已分配文件句柄的数目    分配了但没有使用的句柄数   文件句柄最大数目

#设置
$echo 284289 > /proc/sys/fs/file-max

ulimit 命令详解

ulimit用于shell启动进程所占用的资源，是shell内建命令。

参数介绍:
-H 设置硬件资源限制.
-S 设置软件资源限制.
-a 显示当前所有的资源限制.
-c size:设置core文件的最大值.单位:blocks
-d size:设置数据段的最大值.单位:kbytes
-f size:设置创建文件的最大值.单位:blocks
-l size:设置在内存中锁定进程的最大值.单位:kbytes
-m size:设置可以使用的常驻内存的最大值.单位:kbytes
-n size:设置内核可以同时打开的文件描述符的最大值.单位:n
-p size:设置管道缓冲区的最大值.单位:kbytes
-s size:设置堆栈的最大值.单位:kbytes
-t size:设置CPU使用时间的最大上限.单位:seconds
-v size:设置虚拟内存的最大值.单位:kbytesLinux

可以通过rabbitmqctl status查看当前的限制状态，status中的file_descriptors描述了当前的限制：

{file_descriptors,
     [{total_limit,65435},
      {total_used,2},
      {sockets_limit,58889},
      {sockets_used,0}]},
 {processes,[{limit,1048576},{used,330}]}

参考

rabbitmqctl(1) manual page （Controlling System Limits on Linux）
linux限制打开文件数量

日志

Rabbitmq默认日志路径：/var/log/rabbitmq/，路径之下有两类日志文件：

• rabbit@{hostname}.log，输出rabbitmq运行相关的信息，如网络流量、用户、交换器、队列等信息
• rabbit@{hostname}-sasl.log，Erlang运行相关信息