RabbitMQ

RabbitMQ is the messaging software responsible for exchanging messages between the customer's environment and Senior's cloud.

To carry out its installation, the prerequisite is to have Erlang installed.

Erlang

Erlang is the programming language used by RabbitMQ and OTP is the set of libraries and frameworks responsible for executing Erlang.

1. Download the software for Windows32-bit or64-bit;
2. Store the software in a temporary folder. For example: C:\platform\installation;
3. Run the installer with default settings.

Rabbit Installation

1. Download thesoftware messaging;
2. Store the software in a temporary folder. For example, C:\platform\installation;
3. Run theinstaller with the default settings.

After installation, RabbitMQ creates the C:\Program Files\RabbitMQ Server\rabbitmq_server-3.6.9\ and %APPDATA%\RabbitMQ folders with the configuration and data persistence files.

web manager

The RabbitMQ web manager is disabled by default. To see how RabbitMQ works, you need to activate it:

1. Through the command prompt, inAdministrator mode, access the folder C:\Program Files\RabbitMQ Server\rabbitmq_server-3.6.9\sbin where RabbitMQ is installed, or in the Windows menu, create a shortcut to the RabbitMQ Command Prompt;
2. Run the command that enables the web manager:rabbitmq-plugins enable rabbitmq_management. A configuration message will be displayed at the prompt, with the configuration being applied and carried out successfully.

Administrator user

As a security recommendation, it is important to deactivate the default guest user and create a specific RabbitMQ administration user, as it will be exposed to the internet according to firewall blocks:

1. Using a browser, access the web manager athttp://localhost:15672
   , informi
   • ng the access data:
   • User: guest

   Password: gu

   est

   ObservationPort 15672 is for access via HTTP, after installing the integrator, the port for RabbitMQ administrator access will be 15671 (HTTPS) due to the configuration of the digital certificate in RabbitMQ by the installer.
2. Go to Admin and Add a user:
   • Report a
   Username
   • ;Enter a strong password in the fieldPassword and confirm it. Do not use special characters, for example "@", "/" and/or ":";
   • In the fieldTags, enter administrator, so that this user is the RabbitMQ administrator;
   • click inAdd User.
3. Go to Admin > Users and select the newly created administrator user to assign permissions to him;
4. Click on the buttonSet Permissions and set full permissions to the administrator user;
5. Log off the guest user and test access with the created administrator user;
6. Go to Admin > Users and select the guest user;
7. Access the Permissions section and click on the buttonClear to remove permissions from this default user.
8. In the Update this user section, enter the guest password, remove the administrator tag and click the buttonUpdate user.

Product particularities

eDocs

Manually installing RabbitMQ is not the standard procedure to use in the deployment process. The installation described above is recommended.

This content does not apply in all scenarios, only for users who have the eDocs system and the senior X Platform on the same server:

rabbitmq-env.bat variables:

set ERLANG_HOME=C:\Program Files\erl9.2

set RABBITMQ_BASE=C:\Program Files\RabbitMQ Server\rabbitmq_server-3.6.14

set RABBITMQ_NODE_PORT=6672

set RABBITMQ_NODENAME=SeniorX

set RABBITMQ_SERVICENAME=SeniorXRabbitMQ

set RABBITMQ_CONFIG_FILE=%RABBITMQ_BASE%\etc\rabbitmq

set RABBITMQ_MNESIA_BASE=%RABBITMQ_BASE%\db

set RABBITMQ_MNESIA_DIR=%RABBITMQ_MNESIA_BASE%%RABBITMQ_NODENAME%

set RABBITMQ_LOG_BASE=%RABBITMQ_BASE%\log

set RABBITMQ_LOGS=%RABBITMQ_LOG_BASE%%RABBITMQ_NODENAME%.log

set RABBITMQ_SASL_LOGS=%RABBITMQ_LOG_BASE%%RABBITMQ_NODENAME%-sasl.log

set RABBITMQ_PLUGINS_DIR=%RABBITMQ_BASE%\plugins

set RABBITMQ_ENABLED_PLUGINS_FILE=%RABBITMQ_BASE%\enabled_plugins

Directories may change depending on the installation in the environment.