# RabbitMQ Overview

An installation of RabbitMQ is needed to publish messages from Atlas Copco Data Communication to ToolsTalk 2 (from version 2.17).

After installing RabbitMQ, ensure that the prerequisites are met before starting the Atlas Copco Data Communication service. Refer to RabbitMQ Prerequisites.

When using Atlas Copco Data Communication version 3.7.x or above, specific steps must be followed when upgrading from RabbitMQ v3.11.x to RabbitMQ v4.x.x. Read RabbitMQ v4.2.4 - Upgrade from ACDC 3.7.x for more information.

For a general overview of the RabbitMQ installation, visit https://www.rabbitmq.com/install-windows.html.

Installation
Step | To Do | Check
--- | --- | ---
1 | Installing Erlang runtime Download the Erlang runtime installer: https://github.com/erlang/otp/releases/download/OTP-25.3/otp_win64_25.3.exe. Run the installer and follow the guide. Select the default values proposed by the guide. | ░░
2 | Installing RabbitMQ Download the RabbitMQ installer: https://github.com/rabbitmq/rabbitmq-server/releases/download/v3.11.28/rabbitmq-server-3.11.28.exe. Run the installer and follow the guide. Select the default values proposed by the guide. | ░░
3 | Enabling RabbitMQ Web Management Plugin, to manage RabbitMQ via a web browser On the Windows Start menu, select RabbitMQ Server/RabbitMQ Command Prompt (sbin). In the RabbitMQ Command Prompt (sbin dir), enter rabbitmq-plugins.bat enable rabbitmq_management. | ░░

Before the configuration of RabbitMQ make sure that the Atlas Copco Data Communication has been configured correctly.

Configuration
Step | To Do | Check
--- | --- | ---
4 | Configuring RabbitMQ Open a web browser on the same device where RabbitMQ is installed. Enter http://localhost:15672 as the URL. Sign in using Username: guest and Password: guest. Select the Admin tab and then select Add a user. Enter a Username and a Password. Select Admin and then select Add user. Set the permissions for the added user by selecting the user name from the users list. Select Set permission. | ░░

If you need to install Atlas Copco Data Communication, see Installing Atlas Copco Data Communication.

If Atlas Copco Data Communication is already installed, run the DataCommunication Installation Configurator again to complete the settings, see Working with the DataCommunication Installation Configurator and Configuring the Settings Tab.

Verification
Step | To Do | Check
--- | --- | ---
5 | After Atlas Copco Data Communication is installed, the following entry appears in the Atlas Copco Data Communication log file, [2021-06-11 12:16:03.368 INF RabbitMqBroadcastClient.CreateConnectionAndExchange ] - Created RabbitMQ broadcast exchange: AtlasCopco_ACDC_ToolsTalk_Exchange. The log file is located in C:\ProgramData\Atlas Copco\Logs\DataCommunicationService. | ░░

In this Section

- RabbitMQ Prerequisites
- RabbitMQ Setup