Skip to content

Rabbitmq deployment guide

1. Prepare Environment

  1. rabbitmq-server-generic-unix-3.6.15.tar.xz
  2. otp_src_19.3.tar.gz

2. Install Erlang

  1. Downlaod Erlang source code(otp_src_19.3.tar.gz), and extract to /data/projects/common
tar -zxvf otp_src_19.3.tar.gz
  1. Configure ERL_TOP
cd  /data/projects/common/otp_src_19.3/
export ERL_TOP=`pwd`
  1. Compile

Use the following command:

./configure --prefix=/data/projects/common/erlang
make
make install

If error **No curses library functions found**raised, please install ncuress; first downlaod ncurses-6.0.tar.gz

tar -zxvf ncurses-6.0.tar.gz
cd ncurses-6.0
./configure --with-shared --without-debug --without-ada --enable-overwrite  
make
make install (If error Permission denied is raised, execute with root priviliges)
  1. Set Environment Variable

After compilation, edit ERL_HOME. Edit file /etc/profile, add the following:

cat >> /etc/profile << EOF
> export ERL_HOME=/data/projects/common/erlang
> export PATH=$PATH:/data/projects/common/erlang/bin
  1. Check

run command: erl

If successfully entering Erlang environemnt, installation is success.

3. Install RabbitMQ

  1. Download RabbitMq Server and extract to /data/projects/common
xz -d rabbitmq-server-generic-unix-3.6.15.tar.xz
tar xvf rabbitmq-server-generic-unix-3.6.15.tar
  1. Start standalone RabbitMQ, generate cookie
cd /data/projects/common/rabbitmq_server-3.6.15 && ./sbin/rabbitmq-server -detached
  1. Change File Permissions

Set cookie file permission to 400:

chmod -R 400 .erlang.cookie

  1. Cluster Deploy

  2. Follow step 1-3 for all hosts

  3. Synchronise cookie:

​ After installation by the above steps, Erlang cookie file should locate at /home/app/.erlang.cookie

​ Copy cookie from any host in the cluster to other hosts to replace original cookies

  1. Cluster Start：

​ Based on mq1

​ (1) Stop Erlang node for mq2, mq3

```bash

​ sbin/rabbitmqctl stop ```

​ (2) Start Erlang node for mq2, mq3

```bash

​ sbin/rabbitmq-server -detached ```

​ (3) Stop the RabbitMQ application on mq2、mq3

 ```bash

​ sbin/rabbitmqctl stop_app ```

​ (4) Join mq2, mq3 to mq1 as a cluster

​ On mq2、mq3 run:

 ```bash
 sbin/rabbitmqctl join_cluster rabbit@mq1
 ```

​ (5) Start the RabbitMQ application mq2, mq3 ​

  1. Commands for rabbitmq

    (1)Check cluster status

    ​rabbitmqctl cluster_status

    (2) Enable management (enable/disable):

    rabbitmq-plugins enable rabbitmq_management
​rabbitmq-plugins enable rabbitmq_federation
​rabbitmq-plugins enable rabbitmq_federation_management

    (3) Add user:

    ​rabbitmqctl add_user username password
    (4) Add role:

    ​rabbitmqctl set_user_tags username administrator

    (5) Set permissions:

    ​rabbitmqctl set_permissions -p / username ".*" ".*" ".*"
Last update: 2021-12-01
Back to top