ELMA365 On-Premises > Prepare infrastructure > Prepare external databases / RabbitMQ

RabbitMQ

This article describes how to install RabbitMQ for Ubuntu Linux 20.04. You can also find a short user guide in the official documentation.

начало внимание

In this article, we show an example with elma365 as the virtual host name, elma365user as the user, and SecretPassword as the password.
When setting up RabbitMQ, follow your company’s security policies.

конец внимание

Install RabbitMQ

For correct operation of the ELMA365 application, you need to install RabbitMQ version 3.9.15 or above.

To install RabbitMQ, add the official repository:

  1. Install the required packages:

sudo apt-get install curl gnupg apt-transport-https -y

  1. Import all required keys:

curl -1sLf "https://keys.openpgp.org/vks/v1/by-fingerprint/0A9AF2115F4687BD29803A206B73A36E6026DFCA" | sudo gpg --dearmor | sudo tee /usr/share/keyrings/com.rabbitmq.team.gpg > /dev/null
curl -1sLf "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0xf77f1eda57ebb1cc" | sudo gpg --dearmor | sudo tee /usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg > /dev/null
curl -1sLf "https://packagecloud.io/rabbitmq/rabbitmq-server/gpgkey" | sudo gpg --dearmor | sudo tee /usr/share/keyrings/io.packagecloud.rabbitmq.gpg > /dev/null

  1. Add the RabbitMQ repositories:

sudo tee /etc/apt/sources.list.d/rabbitmq.list <<EOF
deb [signed-by=/usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg] http://ppa.launchpad.net/rabbitmq/rabbitmq-erlang/ubuntu bionic main
deb-src [signed-by=/usr/share/keyrings/net.launchpad.ppa.rabbitmq.erlang.gpg] http://ppa.launchpad.net/rabbitmq/rabbitmq-erlang/ubuntu bionic main
 
deb [signed-by=/usr/share/keyrings/io.packagecloud.rabbitmq.gpg] https://packagecloud.io/rabbitmq/rabbitmq-server/ubuntu/ bionic main
deb-src [signed-by=/usr/share/keyrings/io.packagecloud.rabbitmq.gpg] https://packagecloud.io/rabbitmq/rabbitmq-server/ubuntu/ bionic main
EOF

  1. Update the packages’ cache:

sudo apt-get update -y

  1. Install the Erlang packages:

sudo apt-get install -y erlang-base erlang-asn1 erlang-crypto erlang-eldap erlang-ftp erlang-inets erlang-mnesia erlang-os-mon erlang-parsetools erlang-public-key erlang-runtime-tools erlang-snmp erlang-ssl erlang-syntax-tools erlang-tftp erlang-tools erlang-xmerl

  1. Install rabbitmq-server and its dependencies:

sudo apt-get install rabbitmq-server -y --fix-missing

  1. Start rabbitmq-server:

sudo systemctl enable --now rabbitmq-server

Configure RabbitMQ

начало внимание

You can use the following characters in a password:

  • Capital Latin letters (A to Z)
  • Lowercase Latin letters (a to z)
  • Digits (0 to 9)
  • Symbols: !()-_+=$

конец внимание

To configure RabbitMQ, do the following:

  1. Enable the required plugins:

sudo rabbitmq-plugins enable \
rabbitmq_management

  1. It is required that you add a vhost and give the user access to it. For example:

sudo rabbitmqctl add_vhost elma365vhost
sudo rabbitmqctl add_user elma365user SecretPassword
sudo rabbitmqctl set_permissions -p elma365vhost elma365user ".*" ".*" ".*"
sudo rabbitmqctl set_user_tags elma365user administrator

Connect to RabbitMQ

Connection string for RabbitMQ:

amqp://elma365user:SecretPassword@<rabbitmq-server-address>:5672/elma365vhost

Found a typo? Highlight the text, press ctrl + enter and notify us